tryLocateTx | TON v2

The tryLocateTx method attempts to locate a specific transaction in the TON blockchain based on the source address, destination address, and the logical time when the transaction was created. This method is useful for finding detailed information about a transaction when you have partial information about it.

👍

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 transaction. Example: UQAX2d4C2d48JeA-0y2_peGabRVumnKY22xPvkuEayC3zTI1.
• destination (string, required) — The destination address of the transaction. Example: UQBP4mzpDIywL1SV-Wp9ZuBBlzprR9eXQgSYGEXiUEHm73vA.
• created_lt (string, required) — The logical time when the 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": "tryLocateTx",
    "params": {
      "source": "UQAX2d4C2d48JeA-0y2_peGabRVumnKY22xPvkuEayC3zTI1",
      "destination": "UQBP4mzpDIywL1SV-Wp9ZuBBlzprR9eXQgSYGEXiUEHm73vA",
      "created_lt": "47597573000002"
    }
  }'

Response

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

Use case

A possible use case for the tryLocateTx method in TON is for blockchain explorers, wallet applications, or any service that needs to locate a specific transaction with partial information. This method can be used to:

1. Find the full details of a transaction when only the source, destination, and approximate time are known.
2. Verify the existence and details of a transaction in dispute resolution scenarios.
3. Implement advanced search functionality in blockchain explorers.
4. Cross-reference transactions across different data sources or systems.

Try the tryLocateTx RPC method yourself