Docs

txpool_status - Ink RPC Method

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

Returns transaction pool counters for the connected Ink 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 Ink? Build on Kraken's DeFi-focused Ethereum L2 built on the OP Stack and connected to the Optimism Superchain with 1s block times, ETH gas, Kraken-backed infrastructure, OP Stack compatibility, and Superchain interoperability.

When to Use This Method

txpool_status is valuable for Ink developers, DeFi builders, and teams deploying Solidity applications on the Superchain:

  • 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

Best Practices

  • Returns pending and queued transaction counts; high pending counts suggest network congestion
  • Combine with eth_gasPrice for informed transaction submission timing decisions
  • This is a non-standard method; many shared endpoints disable txpool access
  • Use as a lightweight alternative to txpool_content when you only need aggregate counts

Code Examples

Error Handling

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