Docs
Docs
Home
Getting Started
Agent Tooling
CLI
Supported Chains
Acala
Aptos
Arbitrum
Arc
Asset Hub
Astar
Avalanche
Base
Berachain
Bifrost
Binance Smart Chain
Bittensor
Blast
Boba Network
Bridge Hub
Celo
Centrifuge
Chiliz
Cronos
Enjin
Ethereum
Etherlink
Flow EVM Gateway
Gnosis
Hydration
Hyperliquid
Immutable
Ink
IoTeX
Kusama
Linea
LISK
Manta Atlantic
Manta Pacific
Mantle
MegaETH
Monad
Movement
Neuroweb
opBNB
Optimism
Plasma
Polkadot
Polygon
Pulsechain
Robinhood
Ronin
Scroll
Sonic
Starknet
Taiko
Tempo
Sui
TRON
Unichain
Viction
World Chain
XDC Network
XX Network
Zetachain
zkSync Era
Zora
Supported ChainsPlasmaJSON-RPC APITxpool Methods

txpool_status - Plasma RPC Method

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

Plasma RPC endpoint: endpoint URLs, plans and pricing.

Returns transaction pool counters for the connected Plasma 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 Plasma? Build on an EVM Layer 1 for stablecoin payments with PlasmaBFT consensus and Reth execution with 1 second blocks, XPL gas, full EVM JSON-RPC, and debug plus txpool on Dwellir.

When to Use This Method

txpool_status is valuable for payment app developers, wallet teams, and teams shipping Solidity contracts for dollar transfers:

  • 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
JSON-RPC request
{
  "jsonrpc": "2.0",
  "method": "txpool_status",
  "params": [],
  "id": 1
}

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

Related Methods

  • txpool_content - Inspect the full pending and queued transaction maps
  • eth_blockNumber - Track block production alongside mempool pressure
  • eth_gasPrice - Compare congestion signals with fee estimates

eth_protocolVersion

Get the current Ethereum protocol version on Plasma. Useful for client compatibility checks and identifying version-gated features.

txpool_content

Inspect the full pending and queued transaction pool on Plasma. Useful for mempool analytics, transaction replacement debugging, and operational monitoring.

On this page

When to Use This MethodBest PracticesCode ExamplesError HandlingRelated Methods