eth_getBlockReceipts - Immutable RPC Method
Return every transaction receipt in a block on Immutable. Useful for indexers, analytics pipelines, and event backfills across Web3 gaming (Gods Unchained, RavenQuest), gaming NFTs with enforced royalties, and cross-chain game assets.
Returns all transaction receipts for a block on Immutable. This is more efficient than calling eth_getTransactionReceipt once per transaction when you already know the target block.
Why Immutable? Build on the gaming-optimized zkEVM with 660+ games, 5.5M+ Passport signups, and $40M TVL with first EVM chain with enforceable royalties, Polygon zkEVM technology, $2B+ ecosystem funding, and Agglayer cross-chain liquidity.
When to Use This Method
eth_getBlockReceipts is useful for AAA game studios, indie game developers, and NFT gaming teams seeking enforceable royalties:
- 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 Web3 gaming (Gods Unchained, RavenQuest), gaming NFTs with enforced royalties, and cross-chain game assets
- 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-immutable-zkevm-mainnet.n.dwellir.com/YOUR_API_KEY \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"method": "eth_getBlockReceipts",
"params": ["0xdc3499901b5e089b0f67baeb512939f2949bf62cf1158e69bb458e7e43397136"],
"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 Immutable. Essential for AAA game studios, indie game developers, and NFT gaming teams seeking enforceable royalties building on the gaming-optimized zkEVM with 660+ games, 5.5M+ Passport signups, and $40M TVL.
eth_getBalance
Query account balance on Immutable. Essential for wallet applications and Web3 gaming (Gods Unchained, RavenQuest), gaming NFTs with enforced royalties, and cross-chain game assets on the gaming-optimized zkEVM with 660+ games, 5.5M+ Passport signups, and $40M TVL.