txpool_status - Celo RPC Method
Inspect pending and queued transaction counts in the Celo transaction pool. Useful for mempool monitoring, congestion analysis, and node health checks.
Returns transaction pool counters for the connected Celo endpoint. The result separates transactions that are immediately processable (pending) from those waiting on an earlier nonce or other prerequisite (queued).
Non-standard method.
txpool_statusis a Geth-style mempool inspection method. It is not part of the core Ethereum Execution API method set, and many shared RPC endpoints disable it.
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
txpool_status is valuable for mobile payment developers, fintech builders, and teams targeting emerging markets:
- Mempool Monitoring — Watch pending versus queued pressure on a node
- Congestion Signals — Detect bursts of transaction backlog before they show up in block-level metrics
- Node Health Checks — Confirm a node is accepting and classifying new transactions as expected
- Operational Dashboards — Surface lightweight txpool counters without pulling full transaction content
Request Parameters
This method accepts no parameters.
Response Body
Number of processable transactions currently in the pool
Number of transactions waiting on an earlier prerequisite such as nonce order
Error Responses
Code Examples
curl -X POST https://api-celo-mainnet-archive.n.dwellir.com/YOUR_API_KEY \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"method": "txpool_status",
"params": [],
"id": 1
}'Error Handling
| Error Code | Message | Description |
|---|---|---|
| -32601 | Method not found | The endpoint does not expose txpool methods |
| -32603 | Internal error | The node rejected or failed to process the request |
Related Methods
txpool_content- Inspect the full pending and queued transaction mapseth_blockNumber- Track block production alongside mempool pressureeth_gasPrice- Compare congestion signals with fee estimates
rpc_modules
Inspect which JSON-RPC namespaces are enabled on your Celo endpoint. Useful for capability checks, client diagnostics, and RPC feature discovery.
txpool_content
Inspect the full pending and queued transaction pool on Celo. Useful for mempool analytics, transaction replacement debugging, and operational monitoring.