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 ChainsLineaJSON-RPC APITxpool Methods

txpool_status - Linea RPC Method

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

Linea RPC endpoint: endpoint URLs, plans and pricing.

Returns transaction pool counters for the connected Linea 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 Linea? Build on Consensys-backed zkEVM L2 with $1B+ TVL and 807% growth in 2025 with 15-30x lower fees than Ethereum mainnet, 6,200 TPS throughput, SWIFT integration with 12+ institutions, and $725M Consensys backing.

When to Use This Method

txpool_status is valuable for enterprise developers, DeFi builders, and teams seeking Consensys ecosystem integration:

  • 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

rpc_modules

Inspect which JSON-RPC namespaces are enabled on your Linea endpoint. Useful for capability checks, client diagnostics, and RPC feature discovery.

txpool_content

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

On this page

When to Use This MethodBest PracticesCode ExamplesError HandlingRelated Methods