Docs

eth_getBlockByHash - MegaETH RPC Method

Retrieve complete block data by block hash on MegaETH. Essential for high-frequency DeFi developers, gaming studios, and teams building real-time applications building on the first real-time blockchain with sub-millisecond latency and 100,000+ TPS.

Returns information about a block by hash on MegaETH.

Why MegaETH? Build on the first real-time blockchain with sub-millisecond latency and 100,000+ TPS with sub-millisecond transaction streaming with 100,000+ sustained TPS and full EVM compatibility.

Use Cases

The eth_getBlockByHash method is essential for:

  • Block verification - Verify block data using its unique hash
  • Chain reorganization handling - Track blocks during reorgs
  • Cross-chain bridges - Verify block finality for high-frequency trading, real-time gaming, instant payments, and latency-sensitive applications
  • Deterministic queries - Get consistent block data regardless of chain state

Full Block Restriction

Full Block Queries Disabled

On MegaETH, the fullTransactionObjects parameter is disabled for performance optimization. The method always returns transaction hashes instead of full transaction objects.

To get full transaction details, fetch them individually:

JavaScript
// Get block with transaction hashes
const block = await provider.getBlock(blockHash, false);

// Fetch full transaction details as needed
for (const txHash of block.transactions) {
  const tx = await provider.getTransaction(txHash);
  console.log('Transaction:', tx);
}

Code Examples

Error Handling

Error CodeMessageDescription
-32602Invalid paramsInvalid block hash format
-32000Block not foundBlock with this hash does not exist