eth_getBlockReceipts
The eth_getBlockReceipts method returns all transaction receipts for a given block on the Kaia network in a single RPC call. This highly efficient method retrieves receipts for every transaction in a block at once, rather than requiring individual eth_getTransactionReceipt calls for each transaction.
This method is extremely valuable for block indexers, analytics platforms, event processors, and any application that needs to examine all transaction outcomes and events from an entire block. Instead of making potentially hundreds of individual receipt requests per block, you can fetch everything in one call, dramatically reducing RPC overhead and indexing time. The method is particularly useful for tracking contract events across a block, analyzing gas consumption patterns, monitoring transaction success rates, building block explorers, and maintaining synchronized databases of blockchain state changes.
Parameters
parameter | type | description |
|---|---|---|
blockParameter | string (required) | Block number in hex or tag (latest, earliest, pending) |
Return Object
The method returns an array of transaction receipt objects for all transactions in the block, ordered by transaction index. Each receipt object contains the following fields:
field | type | description |
|---|---|---|
transactionHash | string | Hash of the transaction (32 bytes) |
transactionIndex | string | Integer of the transaction's index position in the block (hex) |
blockHash | string | Hash of the block containing this transaction (32 bytes) |
blockNumber | string | Block number containing this transaction (hex) |
from | string | Address of the sender (20 bytes) |
to | string | Address of the receiver (20 bytes), null for contract creation transactions |
cumulativeGasUsed | string | Total amount of gas used in the block up to and including this transaction (hex) |
gasUsed | string | Amount of gas used by this specific transaction (hex) |
contractAddress | string | Contract address created if the transaction was a contract creation, otherwise null |
logs | array | Array of log objects generated by this transaction. Each log includes address, topics, data, blockNumber, transactionHash, logIndex, and removed fields |
logsBloom | string | Bloom filter for light clients to quickly retrieve related logs (256 bytes) |
status | string | 0x1 (success) or 0x0 (failure) |
effectiveGasPrice | string | The actual gas price used for this transaction (hex, in wei) |
type | string | Transaction type: 0x0 for legacy, 0x1 for EIP-2930, 0x2 for EIP-1559 |
Returns an empty array if the block contains no transactions. Returns null if the block doesn't exist.
Request Example
Response Example