eth_getBlockByNumber - Linea RPC Method
Retrieve complete block data by block number on Linea. Perfect 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 block number 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_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 enterprise DeFi (Aave, Renzo), institutional cross-border payments via SWIFT pilots, and zkEVM-native applications
- Timestamp verification - Get block timestamps for time-based logic
Request Parameters
Block number in hex, or "latest", "earliest", "pending", "safe", "finalized"
If true, returns full transaction objects; if false, returns transaction hashes
Response Body
Block number
32-byte block hash
32-byte parent block hash
Unix timestamp
Total gas used by all transactions
Maximum gas allowed in block
Array of transaction objects or hashes
Base fee per gas (EIP-1559)
Code Examples
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_getBlockByNumber",
"params": ["latest", false],
"id": 1
}'Error Handling
| Error Code | Message | Description |
|---|---|---|
| -32602 | Invalid params | Invalid block number or parameter format |
| -32000 | Block not found | Block does not exist |
Related Methods
eth_blockNumber- Get latest block numbereth_getBlockByHash- Get block by hasheth_getTransactionByHash- Get transaction details
eth_blockNumber
Get the current block height on Linea. Essential for syncing dApps, monitoring transaction confirmations, and blockchain state tracking.
eth_getBlockByHash
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.