ReferenceTestnet: yesMainnet: Not availableSoftware: Core bad4a06ea · protocol pqwerai-v8-testnet/1Updated 2026-11-08

txpool namespace

Transaction-pool inspection (node-local view of pending and queued transactions).

4 public methods. Operator, disabled and unsupported methods of this namespace are listed in Operator interfaces. $RPC is your node URL (see quickstart).

Method	Access	Summary
txpool_content	Public · read-only	Returns the transactions contained within the transaction pool.
txpool_contentFrom	Public · read-only	Returns the transactions contained within the transaction pool.
txpool_inspect	Public · read-only	Retrieves the content of the transaction pool and flattens it into an easily inspectable list.
txpool_status	Public · read-only	Returns the number of pending and queued transaction in the pool.

txpool_content

Returns the transactions contained within the transaction pool.

Access	Public · read-only
Network	private testnet 77240 (local node or approved endpoint); mainnet not available
Authentication	none on loopback; bearer token when the node binds a non-loopback address; public proxies rate-limit per IP
Minimum software	protocol pqwerai-v8-testnet/1
Verified	source core/source/internal/ethapi/api.go:176 at Core bad4a06ea; registered on live CoreGeth/linux-amd64/go1.26.8
Returns	map[string]map[string]map[string]*RPCTransaction

Behaviour on PQWERAI

Read-only but describes this node's local configuration or mempool; results differ per node.

Parameters: none

JSON-RPC requestcurlRecorded response

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "txpool_content",
  "params": []
}

curl -s -H 'content-type: application/json' \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "txpool_content", "params": []}' \
  "$RPC"

Recorded 2026-11-07T18:41:00+00:00 at head 4325 on a disposable local testnet, chain 77240. Long arrays are truncated.

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "pending": {},
    "queued": {}
  }
}

Errors and edge cases

• -32602 invalid or missing parameter (e.g. missing value for required argument 0).
• -32000 execution or validation error with a message from the node.

---

txpool_contentFrom

Returns the transactions contained within the transaction pool.

Access	Public · read-only
Network	private testnet 77240 (local node or approved endpoint); mainnet not available
Authentication	none on loopback; bearer token when the node binds a non-loopback address; public proxies rate-limit per IP
Minimum software	protocol pqwerai-v8-testnet/1
Verified	source core/source/internal/ethapi/api.go:203 at Core bad4a06ea; registered on live CoreGeth/linux-amd64/go1.26.8
Returns	map[string]map[string]*RPCTransaction

Behaviour on PQWERAI

Read-only but describes this node's local configuration or mempool; results differ per node.

Parameters

#	Name	Type	Required	Description
0	addr	address	yes	20-byte hex address, 0x-prefixed

JSON-RPC requestcurlRecorded response

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "txpool_contentFrom",
  "params": [
    "0xfedcd2b6768f15ed5eaf4da44d80467096ea6743"
  ]
}

curl -s -H 'content-type: application/json' \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "txpool_contentFrom", "params": ["0xfedcd2b6768f15ed5eaf4da44d80467096ea6743"]}' \
  "$RPC"

Recorded 2026-11-07T18:41:00+00:00 at head 4325 on a disposable local testnet, chain 77240. Long arrays are truncated.

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "pending": {},
    "queued": {}
  }
}

Errors and edge cases

• -32602 invalid or missing parameter (e.g. missing value for required argument 0).
• -32000 execution or validation error with a message from the node.

---

txpool_inspect

Retrieves the content of the transaction pool and flattens it into an easily inspectable list.

Access	Public · read-only
Network	private testnet 77240 (local node or approved endpoint); mainnet not available
Authentication	none on loopback; bearer token when the node binds a non-loopback address; public proxies rate-limit per IP
Minimum software	protocol pqwerai-v8-testnet/1
Verified	source core/source/internal/ethapi/api.go:236 at Core bad4a06ea; registered on live CoreGeth/linux-amd64/go1.26.8
Returns	map[string]map[string]map[string]string

Behaviour on PQWERAI

Read-only but describes this node's local configuration or mempool; results differ per node.

Parameters: none

JSON-RPC requestcurlRecorded response

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "txpool_inspect",
  "params": []
}

curl -s -H 'content-type: application/json' \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "txpool_inspect", "params": []}' \
  "$RPC"

Recorded 2026-11-07T18:41:00+00:00 at head 4325 on a disposable local testnet, chain 77240. Long arrays are truncated.

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "pending": {},
    "queued": {}
  }
}

Errors and edge cases

• -32602 invalid or missing parameter (e.g. missing value for required argument 0).
• -32000 execution or validation error with a message from the node.

---

txpool_status

Returns the number of pending and queued transaction in the pool.

Access	Public · read-only
Network	private testnet 77240 (local node or approved endpoint); mainnet not available
Authentication	none on loopback; bearer token when the node binds a non-loopback address; public proxies rate-limit per IP
Minimum software	protocol pqwerai-v8-testnet/1
Verified	source core/source/internal/ethapi/api.go:226 at Core bad4a06ea; registered on live CoreGeth/linux-amd64/go1.26.8
Returns	map[string]hexutil.Uint

Behaviour on PQWERAI

Read-only but describes this node's local configuration or mempool; results differ per node.

Parameters: none

JSON-RPC requestcurlRecorded response

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "txpool_status",
  "params": []
}

curl -s -H 'content-type: application/json' \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "txpool_status", "params": []}' \
  "$RPC"

Recorded 2026-11-07T18:41:00+00:00 at head 4325 on a disposable local testnet, chain 77240. Long arrays are truncated.

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "pending": "0x0",
    "queued": "0x0"
  }
}

Errors and edge cases

• -32602 invalid or missing parameter (e.g. missing value for required argument 0).
• -32000 execution or validation error with a message from the node.

---

---

Sources at 72057fe3ec: core/source/internal/ethapi/api.go

Found a problem? Report a documentation issue · Build testnet-rc1+72057fe3ec