runSmcMethod — TON JSON-RPC

Status: Available

Executes a read-only liteserver smart-contract method with an explicit mode.

TON RPC node endpoint · Best TON RPC providers compared

POSThttps://triport.io/rpc/ton

Network: TON mainnet
Scope: ton:rpc
Auth: x-token: $TRIPORT_API_KEY
Rate limit: free+; ton_read_rpc_heavy: 15 / 20 / 100 / 250 RPS sustained · short burst 30 / 40 / 200 / 500 (free / basic / pro / business; default, unmeasured); Burst capacity

Request

cURLJavaScriptPython

curl https://triport.io/rpc/ton \
  -H "x-token: $TRIPORT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "runSmcMethod",
    "params": {
      "address": "EQCxE6mUtQJKFnGfaROTKOt1lZbDiiX1kCixRv7Nw2Id_sDs",
      "method": "seqno",
      "stack": [],
      "mode": 4
    }
  }'

const res = await fetch("https://triport.io/rpc/ton", {
  method: "POST",
  headers: {
    "x-token": process.env.TRIPORT_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "jsonrpc": "2.0",
    "id": 1,
    "method": "runSmcMethod",
    "params": {
      "address": "EQCxE6mUtQJKFnGfaROTKOt1lZbDiiX1kCixRv7Nw2Id_sDs",
      "method": "seqno",
      "stack": [],
      "mode": 4
    }
  }),
});
const data = await res.json();
console.log(data);

import os


import requests


resp = requests.post(
    "https://triport.io/rpc/ton",
    headers={
        "x-token": os.environ["TRIPORT_API_KEY"],
        "Content-Type": "application/json",
    },
    json={
        "jsonrpc": "2.0",
        "id": 1,
        "method": "runSmcMethod",
        "params": {
            "address": "EQCxE6mUtQJKFnGfaROTKOt1lZbDiiX1kCixRv7Nw2Id_sDs",
            "method": "seqno",
            "stack": [],
            "mode": 4,
        },
    },
)
data = resp.json()
print(data)

Response

JSON

Example

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "block_id": {
      "file_hash": "+DeG/GYcRlYkY9wtKpiT9CW7sAPt6c6Ios3wvjwChLA=",
      "root_hash": "dq8stoamKy1Wx5Hu9Mw02WpPAHJUEDYvRVyNbMk6aMs=",
      "seqno": 90110438,
      "shard": "-9223372036854775808",
      "workchain": -1
    },
    "exit_code": 11,
    "stack": []
  }
}

Liteserver call over ADNL: liteServer.runSmcMethod. See lite_api.tl (checked 2026-10-25).

runSmcMethod executes a getter with an optional response-field mode. Address, method, stack, and historical sequence retain the TON Center v2 JSON conventions and are converted into TL and BoC values by the facade.

The result requires a VM exit_code and output stack. Depending on the selected response mode and liteserver response, it can also include the block ID, gas used, and last transaction ID.

Use this method when explicit mode control is necessary. For the ordinary compatibility path without an exposed mode bitmask, use runGetMethod. Both methods are read-only; no message is sent to the chain.

Parameters

JSON-RPC params is a by-name object.

Params: object (by-name).

addressstringrequired

TON contract address in raw or user-friendly form.

methodstring or integerrequired

Getter name or signed 64-bit numeric method ID.

stackarrayrequired

Legacy stack entries represented as two-item pairs.

seqnointegeroptional

Non-negative masterchain sequence for historical state.

modeintegeroptional

Non-negative response-field mode; default 4.

Response

Response fields

Field	Type	Description
`jsonrpc`	string	JSON-RPC protocol version.
`id`	number or string	Correlates the response with the request.
`result`	object	Smart-contract execution result.
`result.exit_code`	integer	VM exit code returned by the liteserver.
`result.stack`	array	Method output in legacy stack representation.
`result.block_id`	object	Optional block used for execution.
`result.gas_used`	integer	Optional gas-used value.
`result.last_transaction_id`	object	Optional last transaction logical time and hash.

The response is copied from the accepted live fixture. The captured exit_code is shown as observed rather than interpreted.

Errors

See TON errors for the shared envelope and retention handling.

Code	Meaning	When it happens
`-32602`	Invalid params	Address, method, stack, sequence, or mode is missing or malformed.
`beyond_retention`	State unavailable	The requested historical contract state is outside the selected server's window.
`-32601`	Method not found	The JSON-RPC method is outside the published read-only catalog.
`401`	Unauthorized	The API key is missing or invalid.
`429`	Rate limited	The `ton_read_rpc_heavy` budget is exceeded.

Examples

JavaScript

const params = {
  address: "EQCxE6mUtQJKFnGfaROTKOt1lZbDiiX1kCixRv7Nw2Id_sDs",
  method: "seqno",
  stack: [],
  mode: 4,
};
const response = await fetch("https://triport.io/rpc/ton", {
  method: "POST",
  headers: { "x-token": process.env.TRIPORT_API_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({ jsonrpc: "2.0", id: "smc", method: "runSmcMethod", params }),
});
const { result } = await response.json();

Notes

mode controls liteserver response fields; it does not authorize a write.
Historical execution is retention-sensitive. Pruned servers had a measured floor of 86 860 000, and one measured server had a measured gap despite genesis access.
Named params and batch correlation by id are required.
sendBoc, all other writes, REST gateways, and WebSocket subscriptions are unavailable for TON.
Related method: runGetMethod.
TON RPC endpoint and plans.