besu-eth · daniellehrner · Apr 21, 2026 · Apr 16, 2026 · Apr 16, 2026 · Apr 16, 2026
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,26 @@
 # Changelog
 
+## Unreleased
+
+### Breaking Changes
+
+### Upcoming Breaking Changes
+- RPC changes to enhance compatibility with other ELs
+  - Block number parameter in RPCs will only support hex values. Support for non-hex (decimal) block number parameters is deprecated.
+  - This affects several RPCs, including `admin_logsRemoveCache`, `debug_getRawHeader`, `eth_call`, `eth_simulateV1`, `trace_call` and more.
+- Sunsetting features - for more context on the reasoning behind the deprecation of these features, including alternative options, read [this blog post](https://www.lfdecentralizedtrust.org/blog/sunsetting-tessera-and-simplifying-hyperledger-besu)
+  - Proof of Work consensus (PoW)
+- `--min-block-occupancy-ratio` is deprecated and will be removed in a future release
+- Plugin API
+  - `PluginTransactionSelectorFactory.create(final SelectorsStateManager selectorsStateManager)` is deprecated for removal
+- `--Xmax-tracked-seen-txs-per-peer` renamed to `--Xmax-tracked-seen-txs` (old name kept as deprecated alias will be removed in a future release)
+- Besu will require Java JDK 25 to build and run in a future release.
+
+### Bug fixes
+
+### Additions and Improvements
+
+
 ## 26.4.0
 
 ### Repository Migration
@@ -53,6 +74,7 @@ are provided with different values, using input as per the execution-apis spec i
 - Limit pooled tx requests by size and remove pre-eth/68 transaction announcement support [#9990](https://github.com/besu-eth/besu/pull/9990)
 - Reduce tx p2p broadcast bandwidth and memory used [#9937](https://github.com/besu-eth/besu/pull/9937) 
 - Improve syncing time of the experimental Bonsai Archive storage by migrating after a Bonsai full sync [#9979](https://github.com/besu-eth/besu/pull/9997)
+- Layered txpool: enable balance check by default [#10175](https://github.com/besu-eth/besu/pull/10175)
 
 ### Plugin API
 - Plugin API: Allow the registration of multiple PluginTransactionPoolValidatorFactory [#9964](https://github.com/hyperledger/besu/pull/9964)

diff --git a/acceptance-tests/detached-outdated-test-plugins/build.gradle b/acceptance-tests/detached-outdated-test-plugins/build.gradle
@@ -1,5 +1,5 @@
 plugins {
-    id 'net.consensys.besu-plugin-distribution' version '0.1.4'
+    id 'net.consensys.besu-plugin-distribution' version '0.2.0'
 }
 
 group = 'org.hyperledger.besu.tests'

diff --git a/acceptance-tests/detached-test-plugins/build.gradle b/acceptance-tests/detached-test-plugins/build.gradle
@@ -1,5 +1,5 @@
 plugins {
-  id 'net.consensys.besu-plugin-distribution' version '0.1.5'
+  id 'net.consensys.besu-plugin-distribution' version '0.2.0'
   id 'com.diffplug.spotless' version '7.0.3'
 }
 

diff --git a/acceptance-tests/detached-test-plugins/dependency-conflict-1/build.gradle b/acceptance-tests/detached-test-plugins/dependency-conflict-1/build.gradle
@@ -1,9 +1,12 @@
 plugins {
-    id 'net.consensys.besu-plugin-distribution' version '0.1.5'
+    id 'net.consensys.besu-plugin-distribution' version '0.2.0'
 }
 
 group = 'org.hyperledger.besu.tests'
 version = besuVersion
+besuPlugin {
+    besuVersion = version
+}
 
 java {
     sourceCompatibility = JavaVersion.VERSION_21

diff --git a/acceptance-tests/detached-test-plugins/dependency-conflict-2/build.gradle b/acceptance-tests/detached-test-plugins/dependency-conflict-2/build.gradle
@@ -1,9 +1,12 @@
 plugins {
-    id 'net.consensys.besu-plugin-distribution' version '0.1.5'
+    id 'net.consensys.besu-plugin-distribution' version '0.2.0'
 }
 
 group = 'org.hyperledger.besu.tests'
 version = besuVersion
+besuPlugin {
+    besuVersion = version
+}
 
 java {
     sourceCompatibility = JavaVersion.VERSION_21

diff --git a/acceptance-tests/detached-test-plugins/settings.gradle b/acceptance-tests/detached-test-plugins/settings.gradle
@@ -2,6 +2,7 @@
 pluginManagement {
   repositories {
     gradlePluginPortal()
+    mavenLocal()
   }
 }
 

diff --git a/...src/acceptanceTest/resources/jsonrpc/debug/replayBlock/test-cases/01_prepare_payload.json b/...src/acceptanceTest/resources/jsonrpc/debug/replayBlock/test-cases/01_prepare_payload.json
@@ -25,7 +25,7 @@
         "latestValidHash": "0x3b8fb240d288781d4aac94d3fd16809ee413bc99294a085798a589dae51ddd4a",
         "validationError": null
       },
-      "payloadId": "0x0065bd195a9b3bfb"
+      "payloadId": "0x0055a77e86e45505"
     }
   },
   "statusCode" : 200

diff --git a/...sts/src/acceptanceTest/resources/jsonrpc/debug/setHead/test-cases/01_prepare_payload.json b/...sts/src/acceptanceTest/resources/jsonrpc/debug/setHead/test-cases/01_prepare_payload.json
@@ -25,7 +25,7 @@
         "latestValidHash": "0x3b8fb240d288781d4aac94d3fd16809ee413bc99294a085798a589dae51ddd4a",
         "validationError": null
       },
-      "payloadId": "0x0065bd195a9b3bfb"
+      "payloadId": "0x0055a77e86e45505"
     }
   },
   "statusCode" : 200

diff --git a/...sources/jsonrpc/engine/cancun/test-cases/block-production/10_cancun_build_on_genesis.json b/...sources/jsonrpc/engine/cancun/test-cases/block-production/10_cancun_build_on_genesis.json
@@ -1,5 +1,95 @@
 {
-  "request" : {"jsonrpc":"2.0","id":5,"method":"engine_forkchoiceUpdatedV3","params":[{"headBlockHash":"0x33235e7b7a78302cdb54e5ddba66c7ae49b01c1f5498bb00cd0c8ed5206784bf","safeBlockHash":"0x0000000000000000000000000000000000000000000000000000000000000000","finalizedBlockHash":"0x0000000000000000000000000000000000000000000000000000000000000000"},{"timestamp":"0x1236","prevRandao":"0xc13da06dc53836ca0766057413b9683eb9a8773bbb8fcc5691e41c25b56dda1d","suggestedFeeRecipient":"0x0000000000000000000000000000000000000000","withdrawals":[{"index":"0xb","validatorIndex":"0x0","address":"0x0000000000000000000000000000000000000000","amount":"0x64"},{"index":"0xc","validatorIndex":"0x1","address":"0x0100000000000000000000000000000000000000","amount":"0x64"},{"index":"0xd","validatorIndex":"0x2","address":"0x0200000000000000000000000000000000000000","amount":"0x64"},{"index":"0xe","validatorIndex":"0x3","address":"0x0300000000000000000000000000000000000000","amount":"0x64"},{"index":"0xf","validatorIndex":"0x4","address":"0x0400000000000000000000000000000000000000","amount":"0x64"},{"index":"0x10","validatorIndex":"0x5","address":"0x0500000000000000000000000000000000000000","amount":"0x64"},{"index":"0x11","validatorIndex":"0x6","address":"0x0600000000000000000000000000000000000000","amount":"0x64"},{"index":"0x12","validatorIndex":"0x7","address":"0x0700000000000000000000000000000000000000","amount":"0x64"},{"index":"0x13","validatorIndex":"0x8","address":"0x0800000000000000000000000000000000000000","amount":"0x64"},{"index":"0x14","validatorIndex":"0x9","address":"0x0900000000000000000000000000000000000000","amount":"0x64"}],"parentBeaconBlockRoot":"0x062367f0b23e2d49ad5e770d9ad17b83c0c1c625c3f9a290cd9572b3fc6cfc9e"}]},
-  "response" : {"jsonrpc":"2.0","id":5,"result":{"payloadStatus":{"status":"VALID","latestValidHash":"0x33235e7b7a78302cdb54e5ddba66c7ae49b01c1f5498bb00cd0c8ed5206784bf","validationError":null},"payloadId":"0x29e12df730769ab6"}},
-  "statusCode" : 200
+  "request": {
+    "jsonrpc": "2.0",
+    "id": 5,
+    "method": "engine_forkchoiceUpdatedV3",
+    "params": [
+      {
+        "headBlockHash": "0x33235e7b7a78302cdb54e5ddba66c7ae49b01c1f5498bb00cd0c8ed5206784bf",
+        "safeBlockHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
+        "finalizedBlockHash": "0x0000000000000000000000000000000000000000000000000000000000000000"
+      },
+      {
+        "timestamp": "0x1236",
+        "prevRandao": "0xc13da06dc53836ca0766057413b9683eb9a8773bbb8fcc5691e41c25b56dda1d",
+        "suggestedFeeRecipient": "0x0000000000000000000000000000000000000000",
+        "withdrawals": [
+          {
+            "index": "0xb",
+            "validatorIndex": "0x0",
+            "address": "0x0000000000000000000000000000000000000000",
+            "amount": "0x64"
+          },
+          {
+            "index": "0xc",
+            "validatorIndex": "0x1",
+            "address": "0x0100000000000000000000000000000000000000",
+            "amount": "0x64"
+          },
+          {
+            "index": "0xd",
+            "validatorIndex": "0x2",
+            "address": "0x0200000000000000000000000000000000000000",
+            "amount": "0x64"
+          },
+          {
+            "index": "0xe",
+            "validatorIndex": "0x3",
+            "address": "0x0300000000000000000000000000000000000000",
+            "amount": "0x64"
+          },
+          {
+            "index": "0xf",
+            "validatorIndex": "0x4",
+            "address": "0x0400000000000000000000000000000000000000",
+            "amount": "0x64"
+          },
+          {
+            "index": "0x10",
+            "validatorIndex": "0x5",
+            "address": "0x0500000000000000000000000000000000000000",
+            "amount": "0x64"
+          },
+          {
+            "index": "0x11",
+            "validatorIndex": "0x6",
+            "address": "0x0600000000000000000000000000000000000000",
+            "amount": "0x64"
+          },
+          {
+            "index": "0x12",
+            "validatorIndex": "0x7",
+            "address": "0x0700000000000000000000000000000000000000",
+            "amount": "0x64"
+          },
+          {
+            "index": "0x13",
+            "validatorIndex": "0x8",
+            "address": "0x0800000000000000000000000000000000000000",
+            "amount": "0x64"
+          },
+          {
+            "index": "0x14",
+            "validatorIndex": "0x9",
+            "address": "0x0900000000000000000000000000000000000000",
+            "amount": "0x64"
+          }
+        ],
+        "parentBeaconBlockRoot": "0x062367f0b23e2d49ad5e770d9ad17b83c0c1c625c3f9a290cd9572b3fc6cfc9e"
+      }
+    ]
+  },
+  "response": {
+    "jsonrpc": "2.0",
+    "id": 5,
+    "result": {
+      "payloadStatus": {
+        "status": "VALID",
+        "latestValidHash": "0x33235e7b7a78302cdb54e5ddba66c7ae49b01c1f5498bb00cd0c8ed5206784bf",
+        "validationError": null
+      },
+      "payloadId": "0x3d9d95a10fd37239"
+    }
+  },
+  "statusCode": 200
 }
diff --git a/...esources/jsonrpc/engine/cancun/test-cases/block-production/12_cancun_get_built_block.json b/...esources/jsonrpc/engine/cancun/test-cases/block-production/12_cancun_get_built_block.json
diff --git a/...ceptanceTest/resources/jsonrpc/engine/osaka/test-cases/06_prague_forkchoiceUpdatedV3.json b/...ceptanceTest/resources/jsonrpc/engine/osaka/test-cases/06_prague_forkchoiceUpdatedV3.json
@@ -27,7 +27,7 @@
         "latestValidHash": "0x0d16454be2446b1f8e013562833b84da2e76536bef3d529cf2f8976ac1eb5905",
         "validationError": null
       },
-      "payloadId": "0x282643d69a019d11"
+      "payloadId": "0x7d82e49c521b3b11"
     }
   },
   "statusCode": 200

diff --git a/.../src/acceptanceTest/resources/jsonrpc/engine/osaka/test-cases/07_prague_getPayloadV4.json b/.../src/acceptanceTest/resources/jsonrpc/engine/osaka/test-cases/07_prague_getPayloadV4.json
@@ -3,7 +3,7 @@
     "jsonrpc": "2.0",
     "method": "engine_getPayloadV4",
     "params": [
-      "0x282643d69a019d11"
+      "0x7d82e49c521b3b11"
     ],
     "id": 67
   },

diff --git a/.../src/acceptanceTest/resources/jsonrpc/engine/osaka/test-cases/08_prague_getPayloadV5.json b/.../src/acceptanceTest/resources/jsonrpc/engine/osaka/test-cases/08_prague_getPayloadV5.json
@@ -3,7 +3,7 @@
     "jsonrpc": "2.0",
     "method": "engine_getPayloadV5",
     "params": [
-      "0x282643d69a019d11"
+      "0x7d82e49c521b3b11"
     ],
     "id": 67
   },

diff --git a/...ceptanceTest/resources/jsonrpc/engine/osaka/test-cases/09_prague_forkchoiceUpdatedV3.json b/...ceptanceTest/resources/jsonrpc/engine/osaka/test-cases/09_prague_forkchoiceUpdatedV3.json
@@ -27,7 +27,7 @@
         "latestValidHash": "0x0d16454be2446b1f8e013562833b84da2e76536bef3d529cf2f8976ac1eb5905",
         "validationError": null
       },
-      "payloadId": "0x282643d69a019d21"
+      "payloadId": "0x7d82e49c521b3b21"
     }
   },
   "statusCode": 200

diff --git a/...s/src/acceptanceTest/resources/jsonrpc/engine/osaka/test-cases/10_osaka_getPayloadV4.json b/...s/src/acceptanceTest/resources/jsonrpc/engine/osaka/test-cases/10_osaka_getPayloadV4.json
@@ -3,7 +3,7 @@
     "jsonrpc": "2.0",
     "method": "engine_getPayloadV4",
     "params": [
-      "0x282643d69a019d21"
+      "0x7d82e49c521b3b21"
     ],
     "id": 67
   },

diff --git a/...s/src/acceptanceTest/resources/jsonrpc/engine/osaka/test-cases/11_osaka_getPayloadV5.json b/...s/src/acceptanceTest/resources/jsonrpc/engine/osaka/test-cases/11_osaka_getPayloadV5.json
@@ -3,7 +3,7 @@
     "jsonrpc": "2.0",
     "method": "engine_getPayloadV5",
     "params": [
-      "0x282643d69a019d21"
+      "0x7d82e49c521b3b21"
     ],
     "id": 67
   },

diff --git a/...cceptanceTest/resources/jsonrpc/engine/osaka/test-cases/14_osaka_forkchoiceUpdatedV3.json b/...cceptanceTest/resources/jsonrpc/engine/osaka/test-cases/14_osaka_forkchoiceUpdatedV3.json
@@ -27,7 +27,7 @@
         "latestValidHash": "0xdb6d76ff4c50498f8c701172dbabbbd31650177de40d761caf5fb60a08bd013d",
         "validationError": null
       },
-      "payloadId": "0x282643cebe091b31"
+      "payloadId": "0x7d82e48feb503731"
     }
   },
   "statusCode": 200

diff --git a/...cceptanceTest/resources/jsonrpc/engine/osaka/test-cases/19_osaka_forkchoiceUpdatedV3.json b/...cceptanceTest/resources/jsonrpc/engine/osaka/test-cases/19_osaka_forkchoiceUpdatedV3.json
@@ -27,7 +27,7 @@
         "latestValidHash": "0xdb6d76ff4c50498f8c701172dbabbbd31650177de40d761caf5fb60a08bd013d",
         "validationError": null
       },
-      "payloadId": "0x282643cebe091b31"
+      "payloadId": "0x7d82e48feb503731"
     }
   },
   "statusCode": 200

diff --git a/...s/src/acceptanceTest/resources/jsonrpc/engine/osaka/test-cases/20_osaka_getPayloadV5.json b/...s/src/acceptanceTest/resources/jsonrpc/engine/osaka/test-cases/20_osaka_getPayloadV5.json
@@ -3,7 +3,7 @@
     "jsonrpc": "2.0",
     "method": "engine_getPayloadV5",
     "params": [
-      "0x282643cebe091b31"
+      "0x7d82e48feb503731"
     ],
     "id": 67
   },

diff --git a/...ests/src/acceptanceTest/resources/jsonrpc/engine/paris/test-cases/01_prepare_payload.json b/...ests/src/acceptanceTest/resources/jsonrpc/engine/paris/test-cases/01_prepare_payload.json
@@ -25,7 +25,7 @@
         "latestValidHash": "0x3b8fb240d288781d4aac94d3fd16809ee413bc99294a085798a589dae51ddd4a",
         "validationError": null
       },
-      "payloadId": "0x0065bd195a9b3bfb"
+      "payloadId": "0x0055a77e86e45505"
     }
   },
   "statusCode" : 200

diff --git a/...ts/tests/src/acceptanceTest/resources/jsonrpc/engine/paris/test-cases/02_get_payload.json b/...ts/tests/src/acceptanceTest/resources/jsonrpc/engine/paris/test-cases/02_get_payload.json
@@ -3,7 +3,7 @@
     "jsonrpc": "2.0",
     "method": "engine_getPayloadV1",
     "params": [
-      "0x0065bd195a9b3bfb"
+      "0x0055a77e86e45505"
     ],
     "id": 67
   },

diff --git a/.../acceptanceTest/resources/jsonrpc/engine/prague/test-cases/01_cancun_prepare_payload.json b/.../acceptanceTest/resources/jsonrpc/engine/prague/test-cases/01_cancun_prepare_payload.json
@@ -27,7 +27,7 @@
         "latestValidHash": "0x01f5cbf33268c161f1526d704268db760bf82c9772a8f8ca412e0c6ce5684896",
         "validationError": null
       },
-      "payloadId": "0x282643b677b85211"
+      "payloadId": "0x7d82e4f624bd49ef"
     }
   },
   "statusCode": 200

diff --git a/...src/acceptanceTest/resources/jsonrpc/engine/prague/test-cases/02_cancun_getPayloadV3.json b/...src/acceptanceTest/resources/jsonrpc/engine/prague/test-cases/02_cancun_getPayloadV3.json
@@ -3,7 +3,7 @@
     "jsonrpc": "2.0",
     "method": "engine_getPayloadV3",
     "params": [
-      "0x282643b677b85211"
+      "0x7d82e4f624bd49ef"
     ],
     "id": 67
   },

diff --git a/...eptanceTest/resources/jsonrpc/engine/prague/test-cases/05_prague_forkchoiceUpdatedV3.json b/...eptanceTest/resources/jsonrpc/engine/prague/test-cases/05_prague_forkchoiceUpdatedV3.json
@@ -27,7 +27,7 @@
         "latestValidHash": "0x7cccf6d9ce3e5acaeac9058959c27ace53af3a30b15763e1703bab2d0ae9438e",
         "validationError": null
       },
-      "payloadId": "0x282643fdcbcb1ddf"
+      "payloadId": "0x7d82e496e060bedf"
     }
   },
   "statusCode": 200

diff --git a/...src/acceptanceTest/resources/jsonrpc/engine/prague/test-cases/06_prague_getPayloadV4.json b/...src/acceptanceTest/resources/jsonrpc/engine/prague/test-cases/06_prague_getPayloadV4.json
@@ -3,7 +3,7 @@
     "jsonrpc": "2.0",
     "method": "engine_getPayloadV4",
     "params": [
-      "0x282643fdcbcb1ddf"
+      "0x7d82e496e060bedf"
     ],
     "id": 67
   },

diff --git a/...eptanceTest/resources/jsonrpc/engine/prague/test-cases/10_prague_forkchoiceUpdatedV3.json b/...eptanceTest/resources/jsonrpc/engine/prague/test-cases/10_prague_forkchoiceUpdatedV3.json
@@ -27,7 +27,7 @@
         "latestValidHash": "0x9c93ae6e647584baeedfd4b53a1b17870797e9a7bd221f8e126a0cf11105064c",
         "validationError": null
       },
-      "payloadId": "0x282643eeb0ecd631"
+      "payloadId": "0x7d82e4a13c84bb31"
     }
   },
   "statusCode": 200

diff --git a/...src/acceptanceTest/resources/jsonrpc/engine/prague/test-cases/11_prague_getPayloadV4.json b/...src/acceptanceTest/resources/jsonrpc/engine/prague/test-cases/11_prague_getPayloadV4.json
@@ -3,7 +3,7 @@
     "jsonrpc": "2.0",
     "method": "engine_getPayloadV4",
     "params": [
-      "0x282643eeb0ecd631"
+      "0x7d82e4a13c84bb31"
     ],
     "id": 67
   },

diff --git a/...eptanceTest/resources/jsonrpc/engine/prague/test-cases/15_prague_forkchoiceUpdatedV3.json b/...eptanceTest/resources/jsonrpc/engine/prague/test-cases/15_prague_forkchoiceUpdatedV3.json
@@ -27,7 +27,7 @@
         "latestValidHash": "0x92166cdc0fead978bcdc54ae9d9f2b803c65beb50350aa54baab12bb248b87cc",
         "validationError": null
       },
-      "payloadId": "0x282643ec34a0cb41"
+      "payloadId": "0x7d82e4b8c3dea2bf"
     }
   },
   "statusCode": 200

diff --git a/...src/acceptanceTest/resources/jsonrpc/engine/prague/test-cases/16_prague_getPayloadV4.json b/...src/acceptanceTest/resources/jsonrpc/engine/prague/test-cases/16_prague_getPayloadV4.json
@@ -3,7 +3,7 @@
     "jsonrpc": "2.0",
     "method": "engine_getPayloadV4",
     "params": [
-      "0x282643ec34a0cb41"
+      "0x7d82e4b8c3dea2bf"
     ],
     "id": 67
   },

diff --git a/...acceptanceTest/resources/jsonrpc/engine/shanghai/test-cases/01_paris_prepare_payload.json b/...acceptanceTest/resources/jsonrpc/engine/shanghai/test-cases/01_paris_prepare_payload.json
@@ -25,7 +25,7 @@
         "latestValidHash": "0x274b386b1b268ebb5ca1f717c1279a536faf1f74dda959143dd8a779f8d8a908",
         "validationError": null
       },
-      "payloadId": "0x0065bd3490dd4505"
+      "payloadId": "0x0055a742b1397c05"
     }
   },
   "statusCode" : 200

diff --git a/...rc/acceptanceTest/resources/jsonrpc/engine/shanghai/test-cases/02_paris_getPayloadV1.json b/...rc/acceptanceTest/resources/jsonrpc/engine/shanghai/test-cases/02_paris_getPayloadV1.json
@@ -3,7 +3,7 @@
     "jsonrpc": "2.0",
     "method": "engine_getPayloadV1",
     "params": [
-      "0x0065bd3490dd4505"
+      "0x0055a742b1397c05"
     ],
     "id": 67
   },