eth_getBlockByHash

The eth_getBlockByHash method returns comprehensive information about a specific block identified by its unique 32-byte hash. This powerful method provides access to all block properties including transactions, gas metrics, miner information, timestamps, and more, making it essential for blockchain explorers and data analysis.

Use Cases

Block explorers and blockchain analytics platforms
Transaction verification and historical analysis
Network monitoring and performance metrics
Smart contract deployments confirmation and tracking
Historical data analysis and time-series research
Consensus verification and chain reorganization detection
Forensic blockchain analysis
Cross-chain block verification

Method Details

This method retrieves detailed data about a specific block using its hash as the identifier, with options to include either complete transaction details or just transaction hashes.

Response Example

1{
2	"jsonrpc": "2.0",
3	"id": 1,
4	"result": {
5		"baseFeePerGas": "0x41a2b3591",
6		"difficulty": "0x0",
7		"extraData": "0x556e697377617020426c6f636b20231242353045",
8		"gasLimit": "0x1c9c380",
9		"gasUsed": "0x189b1f1",
10		"hash": "0x4f32106f6ac5b44248aeda10c3e718f1048ddc274629cd1897a0ff1f7926c41e",
11		"logsBloom": "0xe54b0921498ad482b83...[truncated]",
12		"miner": "0x690B9A9E9aa1C9dB991C7721a92d351Db4FaC990",
13		"mixHash": "0x51c1b337d7ec2023e7bfd47907a1ee256668e46fb9feb0007c62f9bc2a8a19a7",
14		"nonce": "0x0000000000000000",
15		"number": "0x112a880",
16		"parentHash": "0xeea8dce30e2d7c2a7ffe35b6fc2c60782f59a123ff2812e85bf4a49839c6d5a2",
17		"receiptsRoot": "0x14a87619e588c1ef9f8c69fd8e3dff2a49b2c73f19871a74a7e1d97d67d00416",
18		"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
19		"size": "0x1284d",
20		"stateRoot": "0xb87823a3aea0dd94ffe84481962c8f988e3c2ffac98a9af2b81c1c3e4fcc6dc0",
21		"timestamp": "0x65f0d46e",
22		"totalDifficulty": "0xc70d815d562d3cfa955",
23		"transactions": [
24			"0x5a8b22ab3e70ee6ee4b15b48b1c88d8c01806a677ab8938c68dc4323cf51ae7a",
25			"0x8d2fcaa1aef4f4f19aa35bf9d91b34e24902efcaf670953a0bf7e0a6dc585e53"
26			// ... additional transaction hashes
27		],
28		"transactionsRoot": "0x39f9c7a211b008becd35bfbceaf186d564fcb737a9c026f8af7b5d89a8989143",
29		"uncles": [],
30		"withdrawals": [
31			{
32				"index": "0x57ca86",
33				"validatorIndex": "0x17384",
34				"address": "0xb9d7934878b5fb9610b3fe8a5e441e8fad7e293f",
35				"amount": "0x12a05f200"
36			}
37			// ... additional withdrawals
38		],
39		"withdrawalsRoot": "0x36a75a6993b676f8196354ed14e3c77167b9ae823211706b30aa125c3a5dac28"
40	}
41}

Key Block Properties Explained

number: The block number in the chain (height)
timestamp: Unix timestamp when the block was created (in seconds since epoch)
transactions: List of transactions included in this block
gasUsed/gasLimit: Actual gas consumed vs. maximum allowed
baseFeePerGas: Base fee per gas unit introduced in EIP-1559
miner: Address that received the block reward (validator in PoS)
difficulty: Mining difficulty (always 0 after The Merge)
totalDifficulty: Cumulative difficulty up to this block
withdrawals: Validator withdrawals available post-Shanghai upgrade

Transaction Detail Flag

The second parameter determines how transaction data is returned:

false: Only transaction hashes are returned (more efficient for block scanning)
true: Complete transaction objects are returned (useful when you need transaction details)

Practical Example

1// Example of retrieving and processing a significant block
2const significantBlocks = {
3	'The Merge Block': '0x4f32106f6ac5b44248aeda10c3e718f1048ddc274629cd1897a0ff1f7926c41e',
4	'First EIP-1559 Block': '0x9b83c12c569ba25654ce34563540e58a0f8acee4645178544a2a35ccfbdba6cc',
5};
6 
7async function getHistoricalBlock(label) {
8	const blockHash = significantBlocks[label];
9	const blockInfo = await provider.send('eth_getBlockByHash', [blockHash, false]);
10 
11	// Analysis
12	const timestamp = new Date(parseInt(blockInfo.timestamp, 16) * 1000);
13	const gasUsedPercent = (parseInt(blockInfo.gasUsed, 16) / parseInt(blockInfo.gasLimit, 16)) * 100;
14 
15	console.log(`${label} mined on ${timestamp.toUTCString()}`);
16	console.log(`Gas utilization: ${gasUsedPercent.toFixed(2)}%`);
17	console.log(`Transactions: ${blockInfo.transactions.length}`);
18}