GET
/
tryLocateResultTx
curl --request GET \
  --url https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v2/tryLocateResultTx
{
  "block": {
    "workchain": 123,
    "shard": "<string>",
    "seqno": 123,
    "root_hash": "<string>",
    "file_hash": "<string>"
  },
  "transaction_id": {
    "lt": "<string>",
    "hash": "<string>"
  }
}

The tryLocateResultTx method attempts to locate the result transaction in the TON blockchain based on the source address, destination address, and the logical time of the original transaction. This method is useful for finding the outcome or response to a specific transaction.

Get you own node endpoint today

Start for free and get your app to production levels immediately. No credit card required.

You can sign up with your GitHub, X, Google, or Microsoft account.

TON pricing is the same for full, archive, v2, v3

There’s no difference between a full node an archive node in data availability or pricing.
All data is always available and all node requests are consumed as 1 request unit.

Parameters

  • source (string, required) — The source address of the original transaction. Example: UQAX2d4C2d48JeA-0y2_peGabRVumnKY22xPvkuEayC3zTI1.
  • destination (string, required) — The destination address of the original transaction. Example: UQBP4mzpDIywL1SV-Wp9ZuBBlzprR9eXQgSYGEXiUEHm73vA.
  • created_lt (string, required) — The logical time when the original transaction was created. Example: 47597573000002.

JSON-RPC example

Shell
curl -X POST \

  'https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v2/jsonRPC' \

  -H 'Content-Type: application/json' \

  -d '{

    "jsonrpc": "2.0",

    "id": 1,

    "method": "tryLocateResultTx",

    "params": {

      "source": "UQAX2d4C2d48JeA-0y2_peGabRVumnKY22xPvkuEayC3zTI1",

      "destination": "UQBP4mzpDIywL1SV-Wp9ZuBBlzprR9eXQgSYGEXiUEHm73vA",

      "created_lt": "47597573000002"

    }

  }'

Response

  • block (object) — Information about the block containing the result transaction:
    • workchain (integer) — The workchain ID of the block.
    • shard (string) — The shard ID of the block.
    • seqno (integer) — The sequence number of the block.
    • root_hash (string) — The root hash of the block.
    • file_hash (string) — The file hash of the block.
  • transaction_id (object) — The identifier of the result transaction:
    • lt (string) — The logical time of the result transaction.
    • hash (string) — The hash of the result transaction.

Use case

A possible use case for the tryLocateResultTx method in TON is for applications or services that need to track the outcomes of transactions. This method can be used to:

  1. Verify the completion and result of a smart contract execution.
  2. Track the flow of funds in complex multi-step transactions.
  3. Implement transaction status tracking in wallet applications.
  4. Analyze the effects of transactions in blockchain analytics tools.

Query Parameters

source
string
default:UQAX2d4C2d48JeA-0y2_peGabRVumnKY22xPvkuEayC3zTI1
required

The source address of the original transaction

destination
string
default:UQBP4mzpDIywL1SV-Wp9ZuBBlzprR9eXQgSYGEXiUEHm73vA
required

The destination address of the original transaction

created_lt
string
default:47597573000002
required

The logical time when the original transaction was created

Response

200 - application/json
Information about the located result transaction
block
object
transaction_id
object