TriportRPC
DashboardDocs

eth_getUncleByBlockHashAndIndex

Last updated:

`eth_getUncleByBlockHashAndIndex` looks up an uncle block (also called an *ommer*) by the hash of the block that references it and the uncle's position in that block's `uncles` array. It returns a block header object describing the uncle, or `null` when the index is out of range or the referencing block is unknown to the node.

Uncles only exist on the pre-Merge, proof-of-work chain. Before the Merge, two miners could produce a valid block at the same height; the canonical chain included one and could reward the other as an uncle. **After the Merge (September 2022), Ethereum's proof-of-stake consensus produces exactly one block per slot, so post-Merge blocks have no uncles.** For any block at or after the Merge this method returns `null`, and the `uncles` array on such blocks is always empty.

The returned object is a block *header* — it carries the uncle's own hash, number, miner, and roots, but it does **not** include the uncle's transactions (uncle transactions are never executed or rewarded).

Parameters

This method takes no parameters.

Returns

eth_getUncleByBlockHashAndIndex return value
FieldType
resultobject

Examples

curl https://<your-endpoint>/ \
  -X POST -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_getUncleByBlockHashAndIndex","params":[]}'
const res = await fetch("https://<your-endpoint>/", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
  "id": 1,
  "method": "eth_getUncleByBlockHashAndIndex",
  "params": [],
  "jsonrpc": "2.0"
}),
});
const data = await res.json();
import requests
resp = requests.post("https://<your-endpoint>/", json={"id":1,"method":"eth_getUncleByBlockHashAndIndex","params":[],"jsonrpc":"2.0"})
print(resp.json())

Usage

  1. Transport: HTTP (JSON-RPC).
  2. Networks: mainnet.
  3. Credit cost: 1 per call.

FAQ

What does eth_getUncleByBlockHashAndIndex do?
Returns the uncle (ommer) block at a given index within a block addressed by its 32-byte hash, or `null` if there is no uncle at that position.
How many credits does eth_getUncleByBlockHashAndIndex cost?
eth_getUncleByBlockHashAndIndex costs 1 credit(s) per call on Triport by default.
Is eth_getUncleByBlockHashAndIndex available over WebSocket?
eth_getUncleByBlockHashAndIndex is an HTTP JSON-RPC method.