GET
/
tryLocateSourceTx
tryLocateSourceTx
curl --request GET \
  --url https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v2/tryLocateSourceTx
{
  "block": {
    "workchain": 123,
    "shard": "<string>",
    "seqno": 123,
    "root_hash": "<string>",
    "file_hash": "<string>"
  },
  "transaction_id": {
    "lt": "<string>",
    "hash": "<string>"
  }
}
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 todayStart 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, v3There’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

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": "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.

Query Parameters

​
source
string
default:UQAX2d4C2d48JeA-0y2_peGabRVumnKY22xPvkuEayC3zTI1
required

The source address of the result transaction

​
destination
string
default:UQBP4mzpDIywL1SV-Wp9ZuBBlzprR9eXQgSYGEXiUEHm73vA
required

The destination address of the result transaction

​
created_lt
string
default:47597573000002
required

The logical time when the result transaction was created

Response

200 - application/json

Information about the located source transaction

The response is of type object.