Skip to main content
EVM

eth_getBlockByHash

Summary: Get block by block hash

This request returns block data for the given block hash. You can use this method to view the transactions in a block, or the transaction hashes.

Parameters

blockHash
string
required

A string representing the hash (32 bytes) of a block.

Pattern: ^0x[0-9a-f]{64}$


hydratedTransactions
boolean
required

For hashes pass false, for detailed transaction objects, pass true.

Returns

getBlockByHashResponse
oneOf

null

Not Found (null).

object
required

hash
string

Block hash, 32 byte hex identifier for the block derived from the block header; null when block is pending.

Pattern: ^0x[0-9a-f]{64}$

parentHash
string

32 byte hex value of the hash of the parent block.

Pattern: ^0x[0-9a-f]{64}$

sha3Uncles
string

SHA3 of the uncle's data in the block.

Pattern: ^0x[0-9a-f]{64}$

miner
string

Not relevant to Proof of Stake/Linea. Applied to Proof of Work. Address to pay mining rewards to the coinbase transaction that rewarded the miner for their work.

Pattern: ^0x[0-9a-fA-F]{40}$

stateRoot
string

Root of the final state trie for the block as 32 byte hex value.

Pattern: ^0x[0-9a-f]{64}$

transactionsRoot
string

Root of the transaction trie for the block.

Pattern: ^0x[0-9a-f]{64}$

receiptsRoot
string

Root of the receipts trie for the block.

Pattern: ^0x[0-9a-f]{64}$

logsBloom
string

Bloom filter for the block logs; null when block is pending.

Pattern: ^0x[0-9a-f]{512}$

difficulty
string

Not relevant to Proof of Stake/Linea. Difficulty for this block.

Pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$

number
string

Block number; null when block is pending.

Pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$

gasLimit
string

Maximum gas allowed in this block.

Pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$

gasUsed
string

Total gas used by all transactions in this block.

Pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$

timestamp
string

Unix timestamp (milliseconds) for block assembly.

Pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$

extraData
string

Extra data field for this block.

Pattern: ^0x[0-9a-f]*$

mixHash
string

Not relevant to Proof of Stake/Linea. Hash used in the Proof of Work process.

Pattern: ^0x[0-9a-f]{64}$

nonce
string

Proof of Work nonce; not relevant to Proof of Stake/Linea. Hash of the generated Proof of Work.

Pattern: ^0x[0-9a-f]{16}$

totalDifficulty
string

Not relevant to Proof of Stake/Linea. Total difficulty of the chain until this block. This value will always be 0 for an uncle block.

Pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$

baseFeePerGas
string

The block's base fee per gas; empty for blocks created before EIP-1559.

Pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$

withdrawalsRoot
string

Root of the trie containing withdrawal receipts in the block.

Pattern: ^0x[0-9a-f]{64}$

parentBeaconBlockRoot
string

Root of the parent Beacon Chain block. This ties the execution layer to the consensus layer in Proof of Stake.

Pattern: ^0x[0-9a-f]{64}$

size
string

Size of block in bytes.

Pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$

transactions
anyOf

Array of transaction objects, or 32 byte transaction hashes depending on the specified parameter.

Transaction hashes
array

Transaction hashes

string

32 byte hex value.

Pattern: ^0x[0-9a-f]{64}$

Full transactions
array

Full transactions

Contextual information
object
required

Transaction information.

blockHash
string

Block hash, 32 byte hex identifier for the block derived from the block header.

Pattern: ^0x[0-9a-f]{64}$

blockNumber
string

Block number.

Pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$

from
string

Sender's address.

Pattern: ^0x[0-9a-fA-F]{40}$

hash
string

32 byte hex identifier for the transaction hash.

Pattern: ^0x[0-9a-f]{64}$

transactionIndex
string

Transaction index.

Pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$

withdrawals
array

object
required

Validator withdrawal.

index
string

Index of withdrawal.

Pattern: ^0x([1-9a-f]+[0-9a-f]{0,15})|0$

validatorIndex
string

Index of validator that generated withdrawal.

Pattern: ^0x([1-9a-f]+[0-9a-f]{0,15})|0$

address
string

Recipient address for withdrawal value.

Pattern: ^0x[0-9a-fA-F]{40}$

amount
string

Value contained in withdrawal.

Pattern: ^0x([1-9a-f]+[0-9a-f]{0,31})|0$

uncles
array

Array of uncle hashes.

string

32 byte hex value.

Pattern: ^0x[0-9a-f]{64}$

Customize request

Request

curl https://linea-mainnet.infura.io/v3/<YOUR-API-KEY> \
-X POST \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"method": "eth_getBlockByHash",
"params": [],
"id": 1
}'