eth_getBlockByHash - Optimism RPC Method
Retrieve complete block data by block hash on Optimism. Essential for L2 builders, DeFi developers, and teams launching Superchain-compatible apps building on the heart of the Superchain powering 60%+ of Ethereum L2 transactions with $6B+ TVL.
Returns information about a block by hash on Optimism.
Why Optimism? Build on the heart of the Superchain powering 60%+ of Ethereum L2 transactions with $6B+ TVL with OP Stack modularity, Superchain interoperability, 17M+ daily transactions across 33 chains, and 20% of tokens for public goods.
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 cross-chain DeFi, Superchain-interoperable dApps, and public goods funding recipients
- Deterministic queries - Get consistent block data regardless of chain state
Code Examples
Error Handling
| Error Code | Message | Description |
|---|---|---|
| -32602 | Invalid params | Invalid block hash format |
| -32000 | Block not found | Block with this hash does not exist |
Related Methods
eth_getBlockByNumber- Get block by numbereth_blockNumber- Get latest block number
eth_getBlockByNumber
Retrieve complete block data by block number on Optimism. Perfect for L2 builders, DeFi developers, and teams launching Superchain-compatible apps building on the heart of the Superchain powering 60%+ of Ethereum L2 transactions with $6B+ TVL.
eth_getBlockReceipts
Return every transaction receipt in a block on Optimism. Useful for indexers, analytics pipelines, and event backfills across cross-chain DeFi, Superchain-interoperable dApps, and public goods funding recipients.