tryLocateSourceTx | TON v2

The tryLocateSourceTx method attempts to locate the source transaction in the TON blockchain based on the source address, destination address, and the logical time of a result transaction. This method is useful for tracing back the origin of a 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 result transaction. Example: UQAX2d4C2d48JeA-0y2_peGabRVumnKY22xPvkuEayC3zTI1.
• destination (string, required) — The destination address of the result transaction. Example: UQBP4mzpDIywL1SV-Wp9ZuBBlzprR9eXQgSYGEXiUEHm73vA.
• created_lt (string, required) — The logical time when the result 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": "tryLocateSourceTx",
    "params": {
      "source": "UQAX2d4C2d48JeA-0y2_peGabRVumnKY22xPvkuEayC3zTI1",
      "destination": "UQBP4mzpDIywL1SV-Wp9ZuBBlzprR9eXQgSYGEXiUEHm73vA",
      "created_lt": "47597573000002"
    }
  }'

Response

• block (object) — Information about the block containing the source 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 source transaction:
  • lt (string) — The logical time of the source transaction.
  • hash (string) — The hash of the source transaction.

Use case

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

1. Implement transaction history tracing in blockchain explorers.
2. Analyze the chain of events leading to a specific transaction.
3. Verify the authenticity of a transaction by tracing it back to its source.
4. Debug smart contract interactions by identifying the initiating transaction.

Try the tryLocateSourceTx RPC method yourself