For the complete documentation index, see llms.txt. This page is also available as Markdown.

eth_getBlockReceipts

eth_getBlockReceipts JSON-RPC reference for MegaETH.

Summary

Returns all transaction receipts for a block.

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

Parameters

block string | object REQUIRED

Block number, tag (earliest, latest, safe, finalized, pending), block hash, or {"blockHash":"0x…"} selector object.

Result

Receipt[] | null — receipts for every transaction in the block. The method returns null when the block is not found. It returns [] when the block exists but contains no transactions.

Each array element contains:

  • transactionHash Hash32

    Transaction hash.

  • status Quantity

    A nonzero status indicates success; zero indicates that execution reverted.

  • blockHash Hash32

    Containing block hash.

  • blockNumber Quantity

    Containing block number.

  • from Address

    Sender.

  • to Address | null

    Recipient; null for contract creation.

  • gasUsed Quantity

    Gas consumed by this transaction.

  • effectiveGasPrice Quantity

    Effective gas price.

  • contractAddress Address | null

    Created contract address when applicable.

  • logs Log[]

    Emitted log entries.

Additional fields include cumulativeGasUsed, logsBloom, type, and L1 fee fields (l1Fee, l1GasPrice, l1GasUsed, etc.).

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 all receipts for the selected block. The response can be large because MegaETH blocks can contain many transactions.

MegaETH Public Gateway

The gateway returns null immediately for pending, streams large responses, and caches successful results for up to 30 minutes. The method is in the IO-heavy read tier.

Errors

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

Code
Scope
Message
When it happens

-32602

Request

Invalid params

Malformed or unsupported block selector

4444

Method

Pruned history unavailable

Historical block data unavailable on this endpoint

-32005

Transport/policy

Rate limit exceeded

The caller exceeds the public gateway's IO-heavy 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

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/simple-cache-processor.ts

  • Probe: MegaETH Mainnet public endpoint, July 24, 2026

Last updated