TRON Protobuf Streams

You can find the schema here.

TRON produces blocks approximately every 3 seconds, offering high throughput for transactions and smart contracts.

Structure of On-Chain Data

The TRON Protobuf Streams provide three main message types for different use cases:

• BlockMessage: Full blocks with detailed transaction information
• TokenBlockMessage: Focused on token transfers
• DexBlockMessage: Specialized for DEX (Decentralized Exchange) trading activity

Block-Level Data

Each block in the stream includes a BlockHeader with fields such as:

• Number: Block height in the chain
• Hash: The unique identifier of the block
• Timestamp: When the block was produced
• ParentHash: Hash of the previous block
• TxTrieRoot: Merkle root of transactions
• AccountStateRoot: State root hash
• TransactionsCount: Number of transactions in this block

The BlockMessage also includes:

• Chain: Information about the blockchain
• Witness: Details about the block producer (Super Representative)
  • Address: The witness account address
  • Id: Witness identifier
  • Signature: Block signature

Transaction-Level Data

Transactions include:

• TransactionHeader: Core transaction data

  • Hash: Transaction hash
  • Fee: Transaction fee
  • Index: Position in the block
  • Expiration: When the transaction expires
  • FeeLimit: Maximum fee allowed
  • Signatures: Transaction signatures
  • FeePayer: Account that pays the fee

• Result: Execution outcome

  • Status: Transaction status
  • Success: Whether transaction succeeded
  • Message: Error message if failed

• Receipt: Resource consumption details

  • EnergyUsageTotal: Total energy consumed
  • EnergyFee: Fee paid for energy
  • NetUsage: Bandwidth used
  • NetFee: Fee paid for bandwidth

Contract Data

The Contract section contains detailed information about smart contract interactions:

• Address: Contract address

• Type: Contract type (e.g., "TransferContract", "TriggerSmartContract")

• TypeUrl: Protocol buffer type URL

• Arguments: Contract-specific arguments

• InternalTransactions: Sub-transactions created during execution

  • CallerAddress: Initiator address
  • TransferToAddress: Recipient address
  • CallValues: Assets transferred
  • Note: Additional information

• Logs: Event logs emitted by the contract

• Trace: Detailed execution trace (similar to EVM)

• RewardWithdraw: Information about reward distribution

Token Data

The TokenBlockMessage stream provides information about token transfers:

• TokenTransfer: Records token movements with:
  • Sender: Address sending tokens
  • Receiver: Address receiving tokens
  • Amount: Amount of tokens transferred
  • Currency: Detailed token information
  • Success: Whether the transfer succeeded

TRON supports multiple token standards:

• TRC10: Native TRON tokens identified by TokenId
• TRC20: Similar to ERC20 on Ethereum
• TRC721/TRC1155: Non-fungible tokens

DEX (Decentralized Exchange) Data

The DexBlockMessage stream is specialized for DEX trading activity:

• DexTrade: Records of trades executed on DEXs
  • Buy/Sell: Both sides of the trade
  • Dex: Information about the exchange
  • Success: Whether the trade succeeded
  • Fees: Trading fees paid

TRON-Specific Features

TRON has several unique features compared to other blockchain protocols:

• Energy and Bandwidth Model: Instead of a simple gas model, TRON uses Energy for smart contract execution and Bandwidth (Net) for transaction size
• Witness System: Block producers are called Witnesses or Super Representatives
• Contract Types: TRON has predefined contract types for common operations
• TRC10 Tokens: Native token support without smart contracts, referenced by TokenId
• Resource Delegation: Users can delegate resources to each other

Using This Stream in Python, JavaScript, and Go

Python, JavaScript, and Go code samples can be used with these streams by changing the topic to one of:

• tron.raw.proto (for raw block data)
• tron.transactions.proto
• tron.tokens.proto
• tron.dextrades.proto
• tron.broadcasted.raw.proto (for raw broadcasted block data)
• tron.broadcasted.transactions.proto (for broadcasted transactions)
• tron.broadcasted.tokens.proto (for broadcasted token transfers)
• tron.broadcasted.dextrades.proto (for broadcasted DEX trades)

The Python package bitquery-pb2-kafka-package includes all schema and is up to date so you don't have to manually install schema files.