Docs
Supported ChainsLineaJSON-RPC APIBlock Methods

eth_getBlockByHash - Linea RPC Method

Retrieve complete block data by block hash on Linea. Essential for enterprise developers, DeFi builders, and teams seeking Consensys ecosystem integration building on Consensys-backed zkEVM L2 with $1B+ TVL and 807% growth in 2025.

Returns information about a block by hash on Linea.

Why Linea? Build on Consensys-backed zkEVM L2 with $1B+ TVL and 807% growth in 2025 with 15-30x lower fees than Ethereum mainnet, 6,200 TPS throughput, SWIFT integration with 12+ institutions, and $725M Consensys backing.

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 enterprise DeFi (Aave, Renzo), institutional cross-border payments via SWIFT pilots, and zkEVM-native applications
  • Deterministic queries - Get consistent block data regardless of chain state

Request Parameters

Request
blockHashDATA

32-byte block hash

fullTransactionsBoolean

If true, returns full transaction objects; if false, returns transaction hashes

Response Body

Response
numberQUANTITY

Block number

hashDATA

32-byte block hash

parentHashDATA

32-byte parent block hash

timestampQUANTITY

Unix timestamp

gasUsedQUANTITY

Total gas used

transactionsArray

Transaction objects or hashes

Code Examples

Bash
curl -X POST https://api-linea-mainnet-archive.n.dwellir.com/YOUR_API_KEY \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getBlockByHash",
    "params": [
      "0xa5de967d7d780c598c5568e1489bdf66613aa11f7acbd7de75725ee4382c027b",
      false
    ],
    "id": 1
  }'

Error Handling

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