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.


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

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