From 4fe77a6cd923619713811cd200e1ba19e5fea574 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Fri, 10 Apr 2026 19:23:40 +0000 Subject: [PATCH 1/4] Initial plan From 821a8d4ef6f6925d67c078d483b55c41e06f132f Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Fri, 10 Apr 2026 19:26:11 +0000 Subject: [PATCH 2/4] Document txpool_contentFrom JSON-RPC method Agent-Logs-Url: https://github.com/besu-eth/besu-docs/sessions/f41ab5ba-7102-4f18-9ba9-05f29ade182a Co-authored-by: alexandratran <12214231+alexandratran@users.noreply.github.com> --- .../concepts/transactions/pool.md | 1 + docs/public-networks/reference/api/index.md | 97 +++++++++++++++++++ 2 files changed, 98 insertions(+) diff --git a/docs/public-networks/concepts/transactions/pool.md b/docs/public-networks/concepts/transactions/pool.md index 509c4e32456..07d6dc9d8c1 100644 --- a/docs/public-networks/concepts/transactions/pool.md +++ b/docs/public-networks/concepts/transactions/pool.md @@ -124,6 +124,7 @@ You can configure and monitor the transaction pool using the following methods, | Method | [`txpool_besuTransactions`](../../reference/api/index.md#txpool_besutransactions) | API method to list transactions in the transaction pool. | | Method | [`txpool_besuStatistics`](../../reference/api/index.md#txpool_besustatistics) | API method to list statistics of the transaction pool. | | Method | [`txpool_besuPendingTransactions`](../../reference/api/index.md#txpool_besupendingtransactions) | API method to list pending transactions in the transaction pool. | +| Method | [`txpool_contentFrom`](../../reference/api/index.md#txpool_contentfrom) | API method to list pending and queued transactions for a given sender address. | | Subscription | [`newPendingTransactions`](../../how-to/use-besu-api/rpc-pubsub.md#pending-transactions) | RPC subscription to notify of transactions added to the transaction pool. | | Subscription | [`droppedPendingTransactions`](../../how-to/use-besu-api/rpc-pubsub.md#dropped-transactions) | RPC subscription to notify of transactions dropped from the transaction pool. | | Option | [`--tx-pool`](../../reference/cli/options.md#tx-pool) | Option to specify the type of transaction pool to use. | diff --git a/docs/public-networks/reference/api/index.md b/docs/public-networks/reference/api/index.md index c719ef1828b..fc37c2de6aa 100644 --- a/docs/public-networks/reference/api/index.md +++ b/docs/public-networks/reference/api/index.md @@ -8020,6 +8020,103 @@ curl -X POST --data '{"jsonrpc":"2.0","method":"txpool_besuTransactions","params +### `txpool_contentFrom` + +Returns the pending (executable) and queued (non-executable) transactions for a given sender address. + +Pending transactions have consecutive nonces starting from the account's current on-chain nonce. +Queued transactions have nonce gaps and cannot yet be executed. + +#### Parameters + +`address`: _string_ - 20-byte account address + +#### Returns + +`result`: _object_ - transaction pool content for the given address: + + - `pending`: _object_ - map of transaction nonce (as decimal string) to [transaction object](objects.md#transaction-object) for executable transactions + + - `queued`: _object_ - map of transaction nonce (as decimal string) to [transaction object](objects.md#transaction-object) for non-executable transactions + + + + + +```bash +curl -X POST --data '{"jsonrpc":"2.0","method":"txpool_contentFrom","params":["0xfe3b557e8fb62b89f4916b721be55ceb828dbd73"],"id":1}' http://127.0.0.1:8545/ -H "Content-Type: application/json" +``` + + + + +```json +{ + "jsonrpc": "2.0", + "method": "txpool_contentFrom", + "params": ["0xfe3b557e8fb62b89f4916b721be55ceb828dbd73"], + "id": 1 +} +``` + + + + +```json +{ + "jsonrpc": "2.0", + "id": 1, + "result": { + "pending": { + "0": { + "from": "0xfe3b557e8fb62b89f4916b721be55ceb828dbd73", + "gas": "0x5208", + "gasPrice": "0xab5d04c00", + "hash": "0xb7b2f4306c1c228ec94043da73b582594007091a7dfe024b1f8d6d772284e54b", + "input": "0x", + "nonce": "0x0", + "to": "0xf8be4ebda7f62d79a665294ec1263bfdb59aabf2", + "value": "0x0", + "v": "0xfe8", + "r": "0x5beb711e652c6cf0a589d3cea904eefc4f45ce4372652288701d08cc4412086d", + "s": "0x3af14a56e63aa5fb7dcb444a89708363a9d2c1eba1f777c67690288415080ded" + }, + "1": { + "from": "0xfe3b557e8fb62b89f4916b721be55ceb828dbd73", + "gas": "0x5208", + "gasPrice": "0xab5d04c00", + "hash": "0x1234abcd5678ef901234abcd5678ef901234abcd5678ef901234abcd5678ef90", + "input": "0x", + "nonce": "0x1", + "to": "0xf8be4ebda7f62d79a665294ec1263bfdb59aabf2", + "value": "0x0", + "v": "0xfe8", + "r": "0x1aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", + "s": "0x2bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb" + } + }, + "queued": { + "3": { + "from": "0xfe3b557e8fb62b89f4916b721be55ceb828dbd73", + "gas": "0x5208", + "gasPrice": "0xab5d04c00", + "hash": "0xdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef", + "input": "0x", + "nonce": "0x3", + "to": "0xf8be4ebda7f62d79a665294ec1263bfdb59aabf2", + "value": "0x0", + "v": "0xfe8", + "r": "0x3ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc", + "s": "0x4ddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd" + } + } + } +} +``` + + + + ### `txpool_status` Returns the number of pending and queued transactions in the pool. From ee5ed1016e4896a04d1fb74f9c1d5c60e26d29e8 Mon Sep 17 00:00:00 2001 From: Alexandra Carrillo <12214231+alexandratran@users.noreply.github.com> Date: Fri, 10 Apr 2026 13:10:59 -0700 Subject: [PATCH 3/4] Apply suggestions from code review Co-authored-by: Alexandra Carrillo <12214231+alexandratran@users.noreply.github.com> Signed-off-by: Alexandra Carrillo <12214231+alexandratran@users.noreply.github.com> --- docs/public-networks/reference/api/index.md | 11 ++++------- 1 file changed, 4 insertions(+), 7 deletions(-) diff --git a/docs/public-networks/reference/api/index.md b/docs/public-networks/reference/api/index.md index fc37c2de6aa..1a7926d1e54 100644 --- a/docs/public-networks/reference/api/index.md +++ b/docs/public-networks/reference/api/index.md @@ -8022,22 +8022,19 @@ curl -X POST --data '{"jsonrpc":"2.0","method":"txpool_besuTransactions","params ### `txpool_contentFrom` -Returns the pending (executable) and queued (non-executable) transactions for a given sender address. - -Pending transactions have consecutive nonces starting from the account's current on-chain nonce. -Queued transactions have nonce gaps and cannot yet be executed. +Returns the pending and queued transactions for a given sender address. #### Parameters -`address`: _string_ - 20-byte account address +`address`: _string_ - sender address #### Returns `result`: _object_ - transaction pool content for the given address: - - `pending`: _object_ - map of transaction nonce (as decimal string) to [transaction object](objects.md#transaction-object) for executable transactions + - `pending`: _object_ - map of nonces to [transaction objects](objects.md#transaction-object), for pending transactions from the specified address - - `queued`: _object_ - map of transaction nonce (as decimal string) to [transaction object](objects.md#transaction-object) for non-executable transactions + - `queued`: _object_ - map of nonces to [transaction objects](objects.md#transaction-object) for queued transactions from the specified address From 6dc799b04b55666400884daee6366a845983eec8 Mon Sep 17 00:00:00 2001 From: Alexandra Carrillo <12214231+alexandratran@users.noreply.github.com> Date: Mon, 13 Apr 2026 14:38:55 -0700 Subject: [PATCH 4/4] Apply suggestion from @alexandratran Signed-off-by: Alexandra Carrillo <12214231+alexandratran@users.noreply.github.com> --- docs/public-networks/reference/api/index.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/public-networks/reference/api/index.md b/docs/public-networks/reference/api/index.md index f1138d90f4b..23ed7e0e2dd 100644 --- a/docs/public-networks/reference/api/index.md +++ b/docs/public-networks/reference/api/index.md @@ -8122,9 +8122,9 @@ Returns the pending and queued transactions for a given sender address. `result`: _object_ - transaction pool content for the given address: - - `pending`: _object_ - map of nonces to [transaction objects](objects.md#transaction-object), for pending transactions from the specified address + - `pending`: _object_ - map of nonces to [transaction objects](objects.md#transaction-object), for pending transactions from the given address - - `queued`: _object_ - map of nonces to [transaction objects](objects.md#transaction-object) for queued transactions from the specified address + - `queued`: _object_ - map of nonces to [transaction objects](objects.md#transaction-object) for queued transactions from the given address