Docs
Supported ChainsTempoJSON-RPC APIBlock Methods

eth_getBlockByHash - Tempo RPC Method

Retrieve complete block data by block hash on Tempo. Essential for payment application developers, wallet teams, stablecoin issuers, and treasury automation builders building on a payments-first EVM chain with deterministic settlement and stablecoin-native fees.

Returns information about a block by hash on Tempo.

Why Tempo? Build on a payments-first EVM chain with deterministic settlement and stablecoin-native fees with no native gas token, fees denominated in supported USD stablecoins, and full EVM RPC 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 merchant settlement, treasury operations, payout automation, and stablecoin-native financial 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-tempo-mainnet.n.dwellir.com/YOUR_API_KEY \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getBlockByHash",
    "params": [
      "0x0ee8240b9393d92d059f1a87f4845ca5fd75f70aca8b1a97d98e1ea2560edf34",
      false
    ],
    "id": 1
  }'

Error Handling

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