rungetmethodstd - TON

Example code for the rungetmethodstd JSON-RPC method. Сomplete guide on how to use rungetmethodstd JSON-RPC in GetBlock.io Web3 documentation.

This method is a standardized version of runGetMethod that returns a normalised TVM stack shape. Use it when you want a stable schema for parsing returned values.

Parameters

Parameter

Type

Required

Description

address

string

Yes

Address of the smart contract

method

string or integer

Yes

Method name or numeric method-id

stack

array

Yes

Input arguments as TVM stack entries

Request Example

JSON-RPC (POST):

curl --location --request POST 'https://go.getblock.io/<ACCESS-TOKEN>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "jsonrpc": "2.0",
    "method": "runGetMethodStd",
    "params": {
        "address": "EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2",
        "method": "get_wallet_data",
        "stack": []
    },
    "id": "getblock.io"
}'

import axios from 'axios';

const data = JSON.stringify({
    "jsonrpc": "2.0",
    "method": "runGetMethodStd",
    "params": {
        "address": "EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2",
        "method": "get_wallet_data",
        "stack": []
    },
    "id": "getblock.io"
});

const config = {
    method: 'post',
    url: 'https://go.getblock.io/<ACCESS-TOKEN>',
    headers: {
        'Content-Type': 'application/json'
    },
    data: data
};

axios(config)
    .then(response => console.log(JSON.stringify(response.data, null, 2)))
    .catch(error => console.log(error));

import requests
import json

url = "https://go.getblock.io/<ACCESS-TOKEN>"

payload = json.dumps({
    "jsonrpc": "2.0",
    "method": "runGetMethodStd",
    "params": {
        "address": "EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2",
        "method": "get_wallet_data",
        "stack": []
    },
    "id": "getblock.io"
})

headers = {
    'Content-Type': 'application/json'
}

response = requests.post(url, headers=headers, data=payload)
print(response.text)

use reqwest::Client;
use serde_json::json;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = Client::new();

    let payload = json!({
        "jsonrpc": "2.0",
        "method": "runGetMethodStd",
        "params": {
                "address": "EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2",
                "method": "get_wallet_data",
                "stack": []
        },
        "id": "getblock.io"
});

    let response = client
        .post("https://go.getblock.io/<ACCESS-TOKEN>")
        .header("Content-Type", "application/json")
        .json(&payload)
        .send()
        .await?;

    let result: serde_json::Value = response.json().await?;
    println!("{:#?}", result);

    Ok(())
}

Response Example

{
    "ok": true,
    "result": {
        "gas_used": 1500,
        "stack": [
            {
                "type": "num",
                "value": "0x174876E800"
            }
        ],
        "exit_code": 0
    },
    "id": "getblock.io",
    "jsonrpc": "2.0"
}

Response Parameters

Field

Type

Description

result.gas_used

integer

Gas units consumed

result.stack

array

Stack entries as {type, value} objects

result.exit_code

integer

TVM exit code

Use Cases

Schema-stable readers for get-method results
Tooling that prefers object-shaped stack entries over tuple-shaped

Error Handling

Status Code

Error Message

Cause

403

Forbidden

Missing or invalid <ACCESS-TOKEN>

422

Validation Error

Request parameters are missing or malformed

429

Too Many Requests

Rate limit exceeded for your plan

504

Lite Server Timeout

Upstream TON liteserver timed out

422

Validation Error

Method or stack types are malformed

500

TVM execution error

Get-method returned a non-zero exit code

SDK Integration

import { TonClient } from '@ton/ton';

const client = new TonClient({
    endpoint: 'https://go.getblock.io/<ACCESS-TOKEN>/'
});

// The @ton/ton client wraps the same JSON-RPC methods.
// For low-level access, use client.callGetMethod or client.provider.

Previousrungetmethod - TON Nextsendboc - TON

Last updated 1 month ago

Was this helpful?