Docs
Supported ChainsGnosisJSON-RPC APITxpool Methods

txpool_status - Gnosis RPC Method

Inspect pending and queued transaction counts in the Gnosis transaction pool. Useful for mempool monitoring, congestion analysis, and node health checks.

Returns transaction pool counters for the connected Gnosis 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_status is 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 Gnosis? Build on the prediction market pioneer with $260M+ TVL and xDAI stablecoin-based gas fees with stablecoin gas fees for predictable costs, Shutter MEV protection, 150K+ Safe wallets, and Circles decentralized UBI protocol.

When to Use This Method

txpool_status is valuable for prediction market builders, DAO tooling developers, and teams building MEV-protected applications:

  • 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

Request

This method accepts no parameters.

Response Body

Response
pendingQUANTITY

Number of processable transactions currently in the pool

queuedQUANTITY

Number of transactions waiting on an earlier prerequisite such as nonce order

Error Responses

Errors
Error Response-32601

Code Examples

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

Error Handling

Error CodeMessageDescription
-32601Method not foundThe endpoint does not expose txpool methods
-32603Internal errorThe node rejected or failed to process the request