Tron SQD Network API

https://v2.archive.subsquid.io/network/tron-mainnet

1. Retrieve the dataset height from the router with GET /height and make sure it’s above firstBlock.
2. Save the value of firstBlock to some variable, say currentBlock.
3. Query the router for an URL of a worker that has the data for currentBlock with GET /${currentBlock}/worker.
4. Retrieve the data from the worker by posting the query (POST /), setting the "fromBlock" query field to ${currentBlock}.
5. Parse the retrieved data to get a batch of query data plus the height of the last block available from the current worker. Take the header.number field of the last element of the retrieved JSON array - it is the height you want. Even if your query returns no data, you’ll still get the block data for the last block in the range, so this procedure is safe.
6. Set currentBlock to the height from the previous step plus one.
7. Repeat steps 3-6 until all the required data is retrieved.

def get_text(url: str) -> str:
    res = requests.get(url)
    res.raise_for_status()
    return res.text

def dump(
    dataset_url: str,
    query: Query,
    first_block: int,
    last_block: int
) -> None:
    assert 0 <= first_block <= last_block
    query = dict(query)  # copy query to mess with it later

    dataset_height = int(get_text(f'{dataset_url}/height'))
    next_block = first_block
    last_block = min(last_block, dataset_height)

    while next_block <= last_block:
        worker_url = get_text(f'{dataset_url}/{next_block}/worker')

        query['fromBlock'] = next_block
        query['toBlock'] = last_block
        res = requests.post(worker_url, json=query)
        res.raise_for_status()
        blocks = res.json()

        last_processed_block = blocks[-1]['header']['number']
        next_block = last_processed_block + 1
        for block in blocks:
            print(json.dumps(block))

​

Router API

​

Worker API

{
  "logs": [
    {
      "address": [
        "a614f803b6fd780986a42c78ec9c7f77e6ded13c"
      ],
      "topic0": [
        "ddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"
      ],
      "transaction": true
    }
  ],
  "fields": {
    "block": {
      "timestamp": true
    },
    "log": {
      "topics": true,
      "data": true
    },
    "transaction": {
      "hash": true
    }
  },
  "fromBlock": 64000000,
  "toBlock": 64000000
}

[
  {
    "header": { "number": 64000000, "hash": "...", "parentHash": "...", "timestamp": ... },
    "transactions": [ { "transactionIndex": ..., "hash": "..." } ],
    "logs": [
      {
        "logIndex": ...,
        "transactionIndex": ...,
        "topics": [ "ddf252ad...", "..." ],
        "data": "..."
      }
    ]
  }
]

​

Data requests

a614f803b6fd780986a42c78ec9c7f77e6ded13c

​

Logs

{
  // data requests
  address: string[],
  topic0: string[],
  topic1: string[],
  topic2: string[],
  topic3: string[],

  // related data retrieval
  transaction: boolean
}

• address: the set of addresses of contracts emitting the logs. Omit to subscribe to events from all contracts in the network.
• topicN: the set of values of topicN.

​

Transactions

​

General

{
  // data requests
  type: string[],

  // related data retrieval
  logs: boolean,
  internalTransactions: boolean
}

• type: the set of acceptable transaction types.

​

“transfer”

{
  // data requests
  owner: string[],
  to: string[],

  // related data retrieval
  logs: boolean,
  internalTransactions: boolean
}

• owner: the set of owner addresses for which the transfer transactions should be retrieved.
• to: the set of destination addresses.

​

“transfer asset”

{
  // data requests
  owner: string[],
  to: string[],
  asset: string[],

  // related data retrieval
  logs: boolean,
  internalTransactions: boolean
}

• owner: the set of owner addresses for which the transfer transactions should be retrieved.
• to: the set of destination addresses.
• asset: the set of asset contract addresses.

​

“trigger smart contract”

{
  // data requests
  owner: string[],
  contract: string[],
  sighash: string[],

  // related data retrieval
  logs: boolean,
  internalTransactions: boolean
}

• owner: the set of addresses of call owners.
• contract: the set of addresses of contracts being called.
• sighash: the set of 4-byte signature hashes of the called functions, hex-encoded without a 0x prefix.

​

Internal transactions

{
  // data requests
  caller: string[],
  transferTo: string[],

  // related data retrieval
  transaction: boolean
}

• caller: the set of addresses of caller contracts.
• transferTo: the set of addresses of receivers of TRX or TRC10 tokens.

​

Data fields selector

{
  block:               // field selector for blocks
  log:                 // field selector for logs
  transaction:         // field selector for transactions
  internalTransaction: // field selector for internal transactions
}

​

Block fields

{
  timestamp
  txTrieRoot
  version
  witnessAddress
  witnessSignature
}

​

Log fields

{
  address
  data
  topics
}

​

Transaction fields

{
  hash
  ret
  signature
  type
  parameter
  permissionId
  refBlockBytes
  refBlockHash
  feeLimit
  expiration
  timestamp
  rawDataHex
  fee
  contractResult
  contractAddress
  resMessage
  withdrawAmount
  unfreezeAmount
  withdrawExpireAmount
  cancelUnfreezeV2Amount
  result
  energyFee
  energyUsage
  energyUsageTotal
  netUsage
  netFee
  originEnergyUsage
  energyPenaltyTotal
}

​

Internal transaction fields

{
  hash
  callerAddress
  transferToAddress
  callValueInfo
  note
  rejected
  extra
}