eth_getBlockReceipts

The eth_getBlockReceipts method returns all transaction receipts for a given block 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 after EIP-1559 (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

Request

Response Example

Response