eth_getBlockReceipts - Unichain RPC Method
Return every transaction receipt in a block on Unichain. Useful for indexers, analytics pipelines, and event backfills across decentralized exchanges, liquidity protocols, and MEV-protected DeFi applications.
Returns all transaction receipts for a block on Unichain. This is more efficient than calling eth_getTransactionReceipt once per transaction when you already know the target block.
Why Unichain? Build on Uniswap's DeFi-optimized Superchain L2 with 250ms sub-blocks and 95% lower costs than Ethereum with 250ms sub-blocks (fastest L2), TEE-secured block building, native Superchain interoperability, and 65% revenue to validators.
When to Use This Method
eth_getBlockReceipts is useful for DeFi developers, liquidity protocol builders, and teams building on the Optimism Superchain:
- 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 decentralized exchanges, liquidity protocols, and MEV-protected DeFi applications
- 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-unichain-mainnet.n.dwellir.com/YOUR_API_KEY \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"method": "eth_getBlockReceipts",
"params": ["0x480c43fe03129d5842659d3456eb1ca895e77a2f607de2195ad4b2ee02743e06"],
"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 Unichain. Essential for DeFi developers, liquidity protocol builders, and teams building on the Optimism Superchain building on Uniswap's DeFi-optimized Superchain L2 with 250ms sub-blocks and 95% lower costs than Ethereum.
eth_getBalance
Query account balance on Unichain. Essential for wallet applications and decentralized exchanges, liquidity protocols, and MEV-protected DeFi applications on Uniswap's DeFi-optimized Superchain L2 with 250ms sub-blocks and 95% lower costs than Ethereum.