eth_getBlockReceipts

The eth_getBlockReceipts method returns all transaction receipts for a given block in a single call. This highly efficient method is significantly more performant than requesting individual receipts when you need data for multiple transactions in the same block, making it essential for blockchain indexers and analytics platforms.

Use Cases

Gas usage analysis and optimization
Transaction success/failure monitoring
Bulk transaction verification and processing
Log and event collection for indexing
Smart contract execution analysis and debugging
Block explorers and analytics platforms
Token transfer tracking and wallet updates
MEV (Maximal Extractable Value) analysis
Historical data aggregation
Batch event processing

Method Details

This method retrieves comprehensive transaction results including status, gas usage, logs, and events for all transactions in a specified block.

Response Example

1{
2	"jsonrpc": "2.0",
3	"id": 1,
4	"result": [
5		{
6			"blockHash": "0xb5876cd604e2234f800817ef7d744b55e3de0750679923ad3c8f3a3439f8095c",
7			"blockNumber": "0x112bde2",
8			"contractAddress": null,
9			"cumulativeGasUsed": "0x21880",
10			"effectiveGasPrice": "0x4940d0306",
11			"from": "0x95222290DD7278Aa3Ddd389Cc1E1d165CC4BAfe5",
12			"gasUsed": "0x21880",
13			"logs": [
14				{
15					"address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
16					"topics": [
17						"0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
18						"0x00000000000000000000000095222290dd7278aa3ddd389cc1e1d165cc4bafe5",
19						"0x000000000000000000000000333cb957ceaab5a7d2fd1f046f6a4481a52d7378"
20					],
21					"data": "0x000000000000000000000000000000000000000000000000000000000513cafb",
22					"blockNumber": "0x112bde2",
23					"transactionHash": "0x4e7c53bec74550e8c4bb3642c21708134f434994b122a3d6321ec718e743281d",
24					"transactionIndex": "0x0",
25					"blockHash": "0xb5876cd604e2234f800817ef7d744b55e3de0750679923ad3c8f3a3439f8095c",
26					"logIndex": "0x0",
27					"removed": false
28				}
29			],
30			"logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000020000000000000000000800000000000000000000000010000000000000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000000000000042000000000000000000000000000000000000000000000000000020000000004000000000000000000000000000000000000000000000000000000000",
31			"status": "0x1",
32			"to": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
33			"transactionHash": "0x4e7c53bec74550e8c4bb3642c21708134f434994b122a3d6321ec718e743281d",
34			"transactionIndex": "0x0",
35			"type": "0x2"
36		},
37		{
38			"blockHash": "0xb5876cd604e2234f800817ef7d744b55e3de0750679923ad3c8f3a3439f8095c",
39			"blockNumber": "0x112bde2",
40			"contractAddress": null,
41			"cumulativeGasUsed": "0x36f10",
42			"effectiveGasPrice": "0x484c172f0",
43			"from": "0xE4395bc3d18B93D5F22e75bA15704e7a5B0ca77f",
44			"gasUsed": "0x15690",
45			"logs": [
46				{
47					"address": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
48					"topics": [
49						"0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
50						"0x000000000000000000000000e4395bc3d18b93d5f22e75ba15704e7a5b0ca77f",
51						"0x00000000000000000000000001d1d3b37d6a73adcbe2d6c4a330b6b244f48d5a"
52					],
53					"data": "0x0000000000000000000000000000000000000000000000000000000016be7dbf",
54					"blockNumber": "0x112bde2",
55					"transactionHash": "0x87c3f77d7c2755c9a3b94985c17b97cedd96b2afb2a916e50e4357e2188a46ec",
56					"transactionIndex": "0x1",
57					"blockHash": "0xb5876cd604e2234f800817ef7d744b55e3de0750679923ad3c8f3a3439f8095c",
58					"logIndex": "0x1",
59					"removed": false
60				}
61			],
62			"logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000020000000000000000000800000000000000000000000010000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000042000000000000000000000000000000000000000000000000000020000010000000000000000000000000000000000000000000000000000000000000",
63			"status": "0x1",
64			"to": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
65			"transactionHash": "0x87c3f77d7c2755c9a3b94985c17b97cedd96b2afb2a916e50e4357e2188a46ec",
66			"transactionIndex": "0x1",
67			"type": "0x2"
68		}
69		// Additional receipts...
70	]
71}

Key Receipt Fields Explained

status: 0x1 for successful transactions, 0x0 for failed transactions
logs: Contains all emitted events (crucial for tracking token transfers and state changes)
gasUsed: Actual gas consumed by this transaction (important for cost analysis)
cumulativeGasUsed: Running total of gas used in the block up to this transaction
effectiveGasPrice: Actual price paid per gas unit (particularly important for EIP-1559 transactions)
contractAddress: Only populated for contract creation transactions
type: Indicates the transaction type (legacy, access list, or EIP-1559)

Common Event Signatures

The most common event signatures you'll encounter in logs:

ERC-20 Transfer: 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef
ERC-20 Approval: 0x8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925
ERC-721 Transfer: 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef (same as ERC-20)
ERC-1155 TransferSingle: 0xc3d58168c5ae7397731d063d5bbf3d657854427343f4c083240f7aacaa2d0f62
ERC-1155 TransferBatch: 0x4a39dc06d4c0dbc64b70af90fd698a233a518aa5d07e595d983b8c0526c8f7fb

Performance Advantages

This method offers significant performance benefits over individual receipt requests:

Reduced Network Overhead: One request instead of many separate API calls
Lower Latency: Minimized round-trip delays between client and node
Decreased Resource Usage: Less processing required by both client and node
Better Cache Utilization: Data can be returned from a single cache lookup
Simplified Error Handling: Single request means simplified retry logic

Practical Example

1// Example: Analyze token transfers in a block
2async function analyzeTokenTransfers(blockNumber) {
3	const receipts = await provider.send('eth_getBlockReceipts', [blockNumber]);
4 
5	// Common ERC-20 Transfer event signature
6	const transferTopic = '0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef';
7 
8	// Track all token transfers
9	const tokenTransfers = {};
10 
11	receipts.forEach((receipt) => {
12		// Skip failed transactions
13		if (receipt.status !== '0x1') return;
14 
15		receipt.logs.forEach((log) => {
16			if (log.topics[0] === transferTopic) {
17				const token = log.address;
18				const from = '0x' + log.topics[1].slice(26);
19				const to = '0x' + log.topics[2].slice(26);
20				const value = BigInt(log.data);
21 
22				if (!tokenTransfers[token]) {
23					tokenTransfers[token] = [];
24				}
25 
26				tokenTransfers[token].push({ from, to, value });
27			}
28		});
29	});
30 
31	return tokenTransfers;
32}
33 
34// Usage
35const transfers = await analyzeTokenTransfers('0x112BDE2');
36console.log(`Found transfers for ${Object.keys(transfers).length} different tokens`);