Docs
Supported ChainsCeloJSON-RPC APIBlock Methods

eth_getBlockReceipts - Celo RPC Method

Return every transaction receipt in a block on Celo. Useful for indexers, analytics pipelines, and event backfills across mobile stablecoin payments (MiniPay 10M+ wallets), remittances, humanitarian aid, and local currency stablecoins (cUSD, cNGN, cEUR).

Returns all transaction receipts for a block on Celo. This is more efficient than calling eth_getTransactionReceipt once per transaction when you already know the target block.

Why Celo? Build on the mobile-first L2 powering 500K+ daily active users and $2B+ monthly stablecoin volume with phone number-based addressing, sub-cent fees, 150+ country adoption, Nightfall privacy layer, and Opera browser integration.

When to Use This Method

eth_getBlockReceipts is useful for mobile payment developers, fintech builders, and teams targeting emerging markets:

  • Indexer Backfills — Pull every receipt in a block with one request instead of looping over transaction hashes
  • Event Collection — Scan all logs emitted by a block when building analytics or data pipelines
  • Settlement Auditing — Verify every transaction outcome in a target block for mobile stablecoin payments (MiniPay 10M+ wallets), remittances, humanitarian aid, and local currency stablecoins (cUSD, cNGN, cEUR)
  • Operational Debugging — Compare receipt-level gas usage, status, and logs across multiple transactions at once

Request Parameters

Request
blockQUANTITY | TAG | DATA

Block number, block tag such as latest, or 32-byte block hash

Response Body

Response
resultArray<Object> | null

Array of receipt objects for the block, or null if the block is not found

transactionHashDATA

Transaction hash

statusQUANTITY

0x1 on success, 0x0 on failure

gasUsedQUANTITY

Gas used by this transaction

cumulativeGasUsedQUANTITY

Total gas used in the block up to this transaction

logsArray<Object>

Logs emitted by the transaction

contractAddressDATA | null

Created contract address for deployment transactions

effectiveGasPriceQUANTITY

Effective gas price paid by the sender

Code Examples

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

Error Handling

Error CodeMessageDescription
-32602Invalid paramsThe block identifier is malformed
-32000Header not foundThe referenced block does not exist on the node