Docs

eth_getBlockByNumber - MegaETH RPC Method

Retrieve complete block data by block number on MegaETH. Perfect 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 block number 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_getBlockByNumber method is essential for:

  • Block explorers - Display complete block information
  • Transaction indexers - Process all transactions in a block
  • Analytics platforms - Analyze blockchain data for high-frequency trading, real-time gaming, instant payments, and latency-sensitive applications
  • Timestamp verification - Get block timestamps for time-based logic

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('latest', 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 number or parameter format
-32000Block not foundBlock does not exist