eth_getBlockByHash

eth_getBlockByHash JSON-RPC reference for MegaETH.

Summary

Returns a block by its hash.

The public MegaETH endpoint supports this method. The standard, node, and gateway layers below identify behavior that differs from a generic Ethereum endpoint.

Parameters

blockHash Hash32 REQUIRED

Target block hash.

---

fullTransactions boolean REQUIRED

false returns transaction hashes; true returns full transaction objects.

Result

Block | null — null when the hash is well-formed but does not match any block.

• number Quantity

  Block number.
• hash Hash32

  Block hash.
• parentHash Hash32

  Parent block hash.
• timestamp Quantity

  Block timestamp.
• miner Address

  Fee recipient / coinbase.
• gasLimit Quantity

  Block gas limit.
• gasUsed Quantity

  Gas consumed by the block.
• transactions Hash32[] | Transaction[]

  Hashes when fullTransactions = false; full objects when true.

Additional standard fields (stateRoot, logsBloom, transactionsRoot, receiptsRoot, baseFeePerGas, …) are also included.

Comparison with Ethereum Standard JSON-RPC

Ethereum Standard

The canonical Ethereum method uses the parameter and result contract documented above, including the stated null, false, or zero-value semantics where applicable.

MegaETH Node Behavior

The node returns the canonical block matching the hash, or null if the hash is unknown. It honors the fullTransactions response-shape flag.

MegaETH Public Gateway

The gateway streams and caches successful block responses for 30 minutes, using a hash-to-number mapping to deduplicate entries. A null lookup is not cached.

Errors

The | Scope | column distinguishes method failures from gateway policy errors.

Code	Scope	Message	When it happens
-32602	Request	Invalid params	Block hash is malformed or fullTransactions is not a boolean
4444	Method	Pruned history unavailable	Requested historical block is not available on this endpoint
-32005	Transport/policy	Rate limit exceeded	The caller exceeds the public gateway's simple read budget.
-32099	Transport/policy	Payload too large	The request body exceeds the 128 KiB public endpoint limit.

See also Error Codes.

Examples

Endpoint: https://mainnet.megaeth.com/rpc

Capture date: July 24, 2026

Outcome: success

{
  "jsonrpc": "2.0",
  "id": 74,
  "method": "eth_getBlockByHash",
  "params": [
    "0xe0b5b2b8222c00dcbe9f359fc917a9190127bd1b958e11b6caa2035dd03952f1",
    false
  ]
}

{
  "jsonrpc": "2.0",
  "id": 74,
  "result": {
    "hash": "0xe0b5b2b8222c00dcbe9f359fc917a9190127bd1b958e11b6caa2035dd03952f1",
    "number": "0x100000",
    "timestamp": "0x692225d3",
    "transactions": [
      "0x243d39c7f6cd74a9a081a6fe4bdfce37ac6136b9454691aeeb9ed77998450cbc"
    ]
  }
}

Sources

• Spec: [email protected]:ethereum/execution-apis.git @ d24f58b56dcd16ab0f0c70ec609bcc1c42750b51: src/eth/block.yaml
• Code: [email protected]:megaeth-labs/mega-reth.git @ ab60376631228edab3a6df180f295280bad26e93: crates/rpc/rpc-eth-api/src/core.rs
• Code: [email protected]:megaeth-labs/mega-rpc.git @ 06aa35aa95d569c227cc25d2aa12834eb0458aa0: workers/src/processors/get-block-by-hash-processor.ts
• Probe: MegaETH Mainnet public endpoint, July 24, 2026