From a7628b46ddbad88f728955f398b239282f9bc5bb Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Fri, 10 Apr 2026 16:32:54 +0000 Subject: [PATCH 1/7] Initial plan From a96ee5e92805d906c6043e10f57ea6eaa518b9f4 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Fri, 10 Apr 2026 16:35:33 +0000 Subject: [PATCH 2/7] docs: add txpool_inspect method to public networks API reference Agent-Logs-Url: https://github.com/besu-eth/besu-docs/sessions/d6c823e1-2fb0-4ec7-a880-7f934cdb94a7 Co-authored-by: alexandratran <12214231+alexandratran@users.noreply.github.com> --- docs/public-networks/reference/api/index.md | 60 +++++++++++++++++++++ 1 file changed, 60 insertions(+) diff --git a/docs/public-networks/reference/api/index.md b/docs/public-networks/reference/api/index.md index c719ef1828b..0310e9a54f4 100644 --- a/docs/public-networks/reference/api/index.md +++ b/docs/public-networks/reference/api/index.md @@ -8020,6 +8020,66 @@ curl -X POST --data '{"jsonrpc":"2.0","method":"txpool_besuTransactions","params +### `txpool_inspect` + +Returns a textual summary of all pending and queued transactions in the pool, grouped by sender +address and nonce. + +#### Parameters + +None + +#### Returns + +`result`: _object_ - transaction pool inspect object with the following fields: + +- `pending`: _object_ - map of sender addresses to a map of nonce to human-readable transaction + summary strings for transactions pending inclusion in the next block + +- `queued`: _object_ - map of sender addresses to a map of nonce to human-readable transaction + summary strings for transactions scheduled for future execution (transactions with nonce gaps) + + + + + +```bash +curl -X POST --data '{"jsonrpc":"2.0","method":"txpool_inspect","params":[],"id":1}' http://127.0.0.1:8545/ -H "Content-Type: application/json" +``` + + + + +```json +{ "jsonrpc": "2.0", "method": "txpool_inspect", "params": [], "id": 1 } +``` + + + + +```json +{ + "jsonrpc": "2.0", + "id": 1, + "result": { + "pending": { + "0x1923f626bb8dc025849e00f99c25fe2b2f7fb0db": { + "21": "0x8b3a350cf5c34c9194ca85829a2df0ec3153be0318b5e2d3348e872092edffba: 0 wei + 21000 gas × 0 wei" + } + }, + "queued": { + "0x9b11bf0459b0c4b2f87f8cebca4cfc26f294b63a": { + "2": "0x3a3c0698552eec2455ed3190eac3996feccc806970a4a056106deaf6ceb1e5e3: 0 wei + 21000 gas × 0 wei", + "6": "0xbbcd1e45eae3b859203a04be7d6e1d7b03b222ec1d66dfcc8011dd39794b147e: 0 wei + 21000 gas × 0 wei" + } + } + } +} +``` + + + + ### `txpool_status` Returns the number of pending and queued transactions in the pool. From 74bf749093dec0abfa433d521b1857505a8de494 Mon Sep 17 00:00:00 2001 From: Alexandra Carrillo <12214231+alexandratran@users.noreply.github.com> Date: Fri, 10 Apr 2026 12:46:09 -0700 Subject: [PATCH 3/7] 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 | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/public-networks/reference/api/index.md b/docs/public-networks/reference/api/index.md index 0310e9a54f4..32b618dbf77 100644 --- a/docs/public-networks/reference/api/index.md +++ b/docs/public-networks/reference/api/index.md @@ -8023,7 +8023,7 @@ curl -X POST --data '{"jsonrpc":"2.0","method":"txpool_besuTransactions","params ### `txpool_inspect` Returns a textual summary of all pending and queued transactions in the pool, grouped by sender -address and nonce. +address and sorted by nonce. #### Parameters @@ -8034,10 +8034,10 @@ None `result`: _object_ - transaction pool inspect object with the following fields: - `pending`: _object_ - map of sender addresses to a map of nonce to human-readable transaction - summary strings for transactions pending inclusion in the next block + summary strings, for transactions pending inclusion in the next block - `queued`: _object_ - map of sender addresses to a map of nonce to human-readable transaction - summary strings for transactions scheduled for future execution (transactions with nonce gaps) + summary strings, for transactions scheduled for future execution From 86ea9edadecde304971473ffaa1b89be0a8c98ae Mon Sep 17 00:00:00 2001 From: Alexandra Carrillo <12214231+alexandratran@users.noreply.github.com> Date: Fri, 10 Apr 2026 12:49:25 -0700 Subject: [PATCH 4/7] 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 32b618dbf77..6c914c43aba 100644 --- a/docs/public-networks/reference/api/index.md +++ b/docs/public-networks/reference/api/index.md @@ -8033,10 +8033,10 @@ None `result`: _object_ - transaction pool inspect object with the following fields: -- `pending`: _object_ - map of sender addresses to a map of nonce to human-readable transaction +- `pending`: _object_ - map of sender addresses to maps of nonce to human-readable transaction summary strings, for transactions pending inclusion in the next block -- `queued`: _object_ - map of sender addresses to a map of nonce to human-readable transaction +- `queued`: _object_ - map of sender addresses to maps of nonce to human-readable transaction summary strings, for transactions scheduled for future execution From 873880e15130bad7505a1eb6a63549edd3d9e4e6 Mon Sep 17 00:00:00 2001 From: Alexandra Carrillo <12214231+alexandratran@users.noreply.github.com> Date: Fri, 10 Apr 2026 12:56:38 -0700 Subject: [PATCH 5/7] 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 6c914c43aba..69280cb2cfc 100644 --- a/docs/public-networks/reference/api/index.md +++ b/docs/public-networks/reference/api/index.md @@ -8033,10 +8033,10 @@ None `result`: _object_ - transaction pool inspect object with the following fields: -- `pending`: _object_ - map of sender addresses to maps of nonce to human-readable transaction +- `pending`: _object_ - map of sender addresses to maps of nonces to human-readable transaction summary strings, for transactions pending inclusion in the next block -- `queued`: _object_ - map of sender addresses to maps of nonce to human-readable transaction +- `queued`: _object_ - map of sender addresses to maps of nonces to human-readable transaction summary strings, for transactions scheduled for future execution From c6742ea298480ad7ade006a5199b12a984c3122b Mon Sep 17 00:00:00 2001 From: Alexandra Carrillo <12214231+alexandratran@users.noreply.github.com> Date: Mon, 13 Apr 2026 09:32:41 -0700 Subject: [PATCH 6/7] Apply suggestions from code review Co-authored-by: Fabio Di Fabio 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 | 15 ++++++++++----- 1 file changed, 10 insertions(+), 5 deletions(-) diff --git a/docs/public-networks/reference/api/index.md b/docs/public-networks/reference/api/index.md index 69280cb2cfc..d6dccdce3e2 100644 --- a/docs/public-networks/reference/api/index.md +++ b/docs/public-networks/reference/api/index.md @@ -8025,6 +8025,10 @@ curl -X POST --data '{"jsonrpc":"2.0","method":"txpool_besuTransactions","params Returns a textual summary of all pending and queued transactions in the pool, grouped by sender address and sorted by nonce. +The summary is free form, implementation-dependent, and meant to be consumed by humans. +For programmatic access to the transaction pool, use [`txpool_content`](#txpool_content). + + #### Parameters None @@ -8063,14 +8067,15 @@ curl -X POST --data '{"jsonrpc":"2.0","method":"txpool_inspect","params":[],"id" "id": 1, "result": { "pending": { - "0x1923f626bb8dc025849e00f99c25fe2b2f7fb0db": { - "21": "0x8b3a350cf5c34c9194ca85829a2df0ec3153be0318b5e2d3348e872092edffba: 0 wei + 21000 gas × 0 wei" + "0x67ee9a8c19f7873125a875f61add461b4a505d8c": { + "5": "{sequence: 68178, addedAt: 1775837774160, isLocal=false, hasPriority=false, score=127, 0xfbee0231c6140f9db3bbcef774b3626556f6f5528a6a49dcd38e1f7f86c79368={MessageCall, 5, 0x67ee9a8c19f7873125a875f61add461b4a505d8c, EIP1559, mf: 300.00 kwei, pf: 300.00 kwei, gl: 70926, v: 0 wei, to: 0xe9f8133e47d42bc9962e469721faaf75e385af31}}", + "6": "{sequence: 68179, addedAt: 1775837774160, isLocal=false, hasPriority=false, score=127, 0x3474c0582722ed751dba809363f58c8d1acea415831b81bc0b0b9f29afb19c19={MessageCall, 6, 0x67ee9a8c19f7873125a875f61add461b4a505d8c, EIP1559, mf: 2.00 mwei, pf: 2.00 mwei, gl: 90617, v: 0 wei, to: 0x1eb4a2620b909a8838e0e24a8e912bd32f4a47a3}}" } }, "queued": { - "0x9b11bf0459b0c4b2f87f8cebca4cfc26f294b63a": { - "2": "0x3a3c0698552eec2455ed3190eac3996feccc806970a4a056106deaf6ceb1e5e3: 0 wei + 21000 gas × 0 wei", - "6": "0xbbcd1e45eae3b859203a04be7d6e1d7b03b222ec1d66dfcc8011dd39794b147e: 0 wei + 21000 gas × 0 wei" + "0x5fa84846743cc07ab16106ceabad8e4e0ec1c1b6": { + "29": "{sequence: 2208499, addedAt: 1775952461706, isLocal=false, hasPriority=false, score=127, 0x2bb5f69f2b9737a99a3674018cd2aac5035b907a753a0c797051bc9df0b2a152={MessageCall, 29, 0x5fa84846743cc07ab16106ceabad8e4e0ec1c1b6, EIP1559, mf: 1.40 gwei, pf: 417.90 mwei, gl: 63209, v: 0 wei, to: 0xdac17f958d2ee523a2206206994597c13d831ec7}}", + "31": "{sequence: 1766002, addedAt: 1775931135467, isLocal=false, hasPriority=false, score=127, 0xdd250f166c086412fae187ef52dfbe1c4ff9405818781ac50f89d67a77a2d432={MessageCall, 31, 0x5fa84846743cc07ab16106ceabad8e4e0ec1c1b6, EIP1559, mf: 47.74 gwei, pf: 9.28 gwei, gl: 21000, v: 0 wei, to: 0x5fa84846743cc07ab16106ceabad8e4e0ec1c1b6}}" } } } From bdc6196e3fb24189f8a8a02ce0af864fc1420258 Mon Sep 17 00:00:00 2001 From: Alexandra Carrillo <12214231+alexandratran@users.noreply.github.com> Date: Mon, 13 Apr 2026 11:01:52 -0700 Subject: [PATCH 7/7] Apply suggestion from @alexandratran Signed-off-by: Alexandra Carrillo <12214231+alexandratran@users.noreply.github.com> --- docs/public-networks/reference/api/index.md | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/public-networks/reference/api/index.md b/docs/public-networks/reference/api/index.md index 9e8539d7392..a70d9bbcf9c 100644 --- a/docs/public-networks/reference/api/index.md +++ b/docs/public-networks/reference/api/index.md @@ -8029,7 +8029,6 @@ address and sorted by nonce. The summary is free form, implementation-dependent, and meant to be consumed by humans. For programmatic access to the transaction pool, use [`txpool_content`](#txpool_content). - #### Parameters None