eth_getBlockReceipts - TRON RPC Method
Return every transaction receipt in a block on TRON. Useful for indexers, analytics pipelines, and event backfills across TRC-20 transfers, wallet operations, and EVM-compatible smart contract integrations.
Returns all transaction receipts for a block on TRON. This is more efficient than calling eth_getTransactionReceipt once per transaction when you already know the target block.
Why TRON? Build on the TVM-compatible Layer 1 for TRC-20 payments, wallet APIs, and low-cost smart contract execution with TVM compatibility paired with native TRON wallet APIs, DPoS block production, and low-cost transaction flows.
When to Use This Method
eth_getBlockReceipts is useful for TRON developers building payment rails, exchanges, and consumer crypto applications:
- Indexer Backfills — Pull every receipt in a block with one request instead of looping over transaction hashes
- Event Collection — Scan all logs emitted by a block when building analytics or data pipelines
- Settlement Auditing — Verify every transaction outcome in a target block for TRC-20 transfers, wallet operations, and EVM-compatible smart contract integrations
- Operational Debugging — Compare receipt-level gas usage, status, and logs across multiple transactions at once
Request Parameters
Block number, block tag such as latest, or 32-byte block hash
Response Body
Array of receipt objects for the block, or null if the block is not found
Transaction hash
0x1 on success, 0x0 on failure
Gas used by this transaction
Total gas used in the block up to this transaction
Logs emitted by the transaction
Created contract address for deployment transactions
Effective gas price paid by the sender
Code Examples
curl -X POST https://api-tron-mainnet.n.dwellir.com/YOUR_API_KEY/jsonrpc \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"method": "eth_getBlockReceipts",
"params": ["0x0000000004d4dd2a62243e06966cb322aefec631e1ec0ce68ed3f2482cecccb9"],
"id": 1
}'Error Handling
| Error Code | Message | Description |
|---|---|---|
| -32602 | Invalid params | The block identifier is malformed |
| -32000 | Header not found | The referenced block does not exist on the node |
Related Methods
eth_getTransactionReceipt- Retrieve a single transaction receipteth_getBlockByHash- Retrieve the block object itselfeth_getBlockByNumber- Retrieve a block by number or tag
eth_getBlockByHash
Retrieve complete block data by block hash on TRON. Essential for TRON developers building payment rails, exchanges, and consumer crypto applications building on the TVM-compatible Layer 1 for TRC-20 payments, wallet APIs, and low-cost smart contract execution.
eth_getBalance
Query account balance on TRON. Essential for wallet applications and TRC-20 transfers, wallet operations, and EVM-compatible smart contract integrations on the TVM-compatible Layer 1 for TRC-20 payments, wallet APIs, and low-cost smart contract execution.