The txpool_inspect
method returns a textual summary of all pending and queued transactions in the transaction pool. This method is primarily supported by Geth clients and provides a human-readable overview of transactions waiting to be included in blocks, without the full transaction details.
This method requires no parameters and returns a structured summary of the transaction pool.
curl --request POST \
--url "https://ethereum.therpc.io" \
--header 'Content-Type: application/json' \
--data '{
"method": "txpool_inspect",
"id": 1,
"jsonrpc": "2.0",
"params": []
}'
Object containing pending and queued transaction summaries
Map of pending transactions grouped by sender address and nonce
Map of queued transactions grouped by sender address and nonce
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"pending": {
"0x0216d5032f356960cd3749c31ab34eeff21b3395": {
"806": "0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984: 0 wei + 21000 gas × 8000000000 wei"
},
"0x0239769a1adf4def9f1b1e5e2ab4d89c3cc5ba59": {
"4": "0x6B3595068778DD592e39A122f4f5a5cF09C90fE2: 0 wei + 400000 gas × 10000000000 wei"
}
},
"queued": {
"0x00e4d0b50e4294f9b9eb2381b0ef33745f5a0a69": {
"7": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2: 0 wei + 21000 gas × 24200000000 wei"
},
"0x0216d5032f356960cd3749c31ab34eeff21b3395": {
"807": "0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D: 0 wei + 189000 gas × 3000000000 wei"
}
}
}
}
The response is structured as follows:
recipientAddress: value + gasLimit × gasPrice
Pending: Transactions eligible for inclusion in the next block
Have valid nonces (equal to the sender's current nonce)
Meet all other validity criteria
Queued: Transactions not yet eligible for execution
May have future nonces (higher than sender's current nonce + pending count)
May be waiting for other transactions from the same sender
May have other constraints preventing immediate execution
txpool_content
instead