Skip to navigation
JSON-RPC Reference

eth_getUncleByBlockHashAndIndex

Returns information about an uncle block by block hash and uncle index position. Post-Merge note: Ethereum no longer produces uncle blocks since the Merge (September 2022). This method will always return null on Conduit chains and is retained for backwards compatibility only.

⚡ Compute Units: 10 CU

Request

This endpoint expects an object.
blockHashstringRequiredformat: "^0x[0-9a-fA-F]{64}$"

32-byte hash of the block

uncleIndexstringRequiredformat: "^0x(0|[1-9a-fA-F][0-9a-fA-F]*)$"
Integer of the uncle index position

Response

Uncle block object, or null if the uncle doesn't exist
parentHashstringformat: "^0x[0-9a-fA-F]{64}$"

32-byte hash of the parent block

noncestringformat: "^0x[0-9a-fA-F]*$"

8-byte value used in proof-of-work mining. On post-Merge chains (all Conduit rollups) this is always "0x0000000000000000" — the field is retained for header-shape backwards compatibility.

sha3Unclesstringformat: "^0x[0-9a-fA-F]{64}$"
SHA3 of the uncles data in the block
logsBloomstringformat: "^0x[0-9a-fA-F]{512}$"
Bloom filter for the logs of the block
transactionsRootstringformat: "^0x[0-9a-fA-F]{64}$"
Root of the transaction trie
stateRootstringformat: "^0x[0-9a-fA-F]{64}$"
Root of the final state trie
receiptsRootstringformat: "^0x[0-9a-fA-F]{64}$"
Root of the receipts trie
mixHashstringformat: "^0x[0-9a-fA-F]{64}$"

32-byte hash. Post-Merge this field carries the prevRandao value (the beacon chain randomness) rather than a proof-of-work mix hash.

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

20-byte address of the beneficiary

difficultystringformat: "^0x(0|[1-9a-fA-F][0-9a-fA-F]*)$"
Integer of the difficulty for this block
extraDatastringformat: "^0x[0-9a-fA-F]*$"
Extra data field of this block
sizestringformat: "^0x(0|[1-9a-fA-F][0-9a-fA-F]*)$"
Integer the size of this block in bytes
gasLimitstringformat: "^0x(0|[1-9a-fA-F][0-9a-fA-F]*)$"
Maximum gas allowed in this block
gasUsedstringformat: "^0x(0|[1-9a-fA-F][0-9a-fA-F]*)$"
Total gas used by all transactions in this block
timestampstringformat: "^0x(0|[1-9a-fA-F][0-9a-fA-F]*)$"
Unix timestamp for when the block was collated
transactionslist of strings or list of objects
Array of transaction objects or hashes
uncleslist of strings

Array of uncle hashes. Always empty on post-Merge chains (including all Conduit rollups), which no longer produce uncle blocks.

numberstringOptionalformat: "^0x(0|[1-9a-fA-F][0-9a-fA-F]*)$"

The block number, hex-encoded

hashstringOptionalformat: "^0x[0-9a-fA-F]{64}$"

32-byte block hash

totalDifficultystringOptionalformat: "^0x(0|[1-9a-fA-F][0-9a-fA-F]*)$"
Integer of the total difficulty of the chain until this block
baseFeePerGasstringOptionalformat: "^0x(0|[1-9a-fA-F][0-9a-fA-F]*)$"

Base fee per gas in wei, hex-encoded. Introduced by EIP-1559 (London). Absent on pre-London blocks.

withdrawalslist of objectsOptional

Array of validator withdrawal objects. Introduced by EIP-4895 (Shanghai). Absent on pre-Shanghai blocks.

withdrawalsRootstringOptionalformat: "^0x[0-9a-fA-F]{64}$"

Root of the withdrawals trie. Introduced by EIP-4895 (Shanghai). Absent on pre-Shanghai blocks.

blobGasUsedstringOptionalformat: "^0x(0|[1-9a-fA-F][0-9a-fA-F]*)$"

Total blob gas used by the transactions in this block, hex-encoded. Introduced by EIP-4844 (Cancun). Absent on pre-Cancun blocks.

excessBlobGasstringOptionalformat: "^0x(0|[1-9a-fA-F][0-9a-fA-F]*)$"

Running total of blob gas consumed in excess of the target, used to compute the blob gas price, hex-encoded. Introduced by EIP-4844 (Cancun). Absent on pre-Cancun blocks.

parentBeaconBlockRootstringOptionalformat: "^0x[0-9a-fA-F]{64}$"

Parent beacon block root hash. Introduced by EIP-4788 (Cancun). Absent on pre-Cancun blocks.