txpool_inspect

The txpool_inspect method returns a summary of the transaction pool in a human-readable textual format. Unlike txpool_content which returns full transaction objects with all fields, this method provides a compact, easy-to-read summary showing key transaction information like recipient addresses, ether values, and gas parameters.

This method strikes a balance between txpool_status (which only shows counts) and txpool_content (which shows complete transaction data). It's particularly useful for quickly inspecting the mempool state during debugging, getting a readable overview of what transactions are waiting, monitoring specific addresses or transaction patterns, and understanding transaction fee levels without parsing complex transaction objects. The human-readable format makes it excellent for command-line tools and quick manual inspection.

This method is only available on nodes with txpool enabled.

Parameters

This method does not require any parameters.

Return Object
field
type
description
pending
object
Transactions ready for inclusion, organized by sender address. Each address maps to nonces with human-readable summaries in format: '<to_address>: <value> ether + <gas> gas × <gasPrice> gwei' (or 'contract creation: ...' for contract deployments)
queued
object
Transactions with nonce gaps (not yet eligible for inclusion), organized in the same structure and format as pending transactions

Values are displayed in ether (not wei) and gas prices in gwei (not wei), making the output immediately readable without unit conversion. For EIP-1559 transactions, both priority fee and max fee are shown.

Request Example
Request
Response Example
Response

Share on
Share on FacebookShare on XShare on LinkedIn
Did you find this page useful?