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
Response Example