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

eth_getTransactionReceipt

eth_getTransactionReceipt JSON-RPC reference for MegaETH.

Summary

Returns a transaction receipt by 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

transactionHash Hash32 REQUIRED

Hash of the target transaction.

Result

Receipt | nullnull when the transaction is unknown or not yet mined.

  • 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 null until a receipt is visible. Receipts produced from a real-time mini-block may temporarily use the all-ff block-hash placeholder until the EVM block seals.

MegaETH Public Gateway

The gateway first checks its receipt cache, forwards misses upstream, and caches non-null receipts for 30 minutes. A null result is not cached.

Errors

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

Code
Scope
Message
When it happens

-32602

Request

Invalid params

Transaction hash is missing or malformed

-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

The captured response below is abridged. Receipts also include the other fields documented in Result, including transactionIndex, cumulativeGasUsed, logs, and logsBloom.

Sources

  • Spec: [email protected]:ethereum/execution-apis.git @ d24f58b56dcd16ab0f0c70ec609bcc1c42750b51: src/eth/transaction.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/tx-receipt-processor.ts

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

Last updated