tryLocateResultTx | TON v2

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.

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

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.

Try the tryLocateResultTx RPC method yourself

Language
Click Try It! to start a request and see the response here!