23.4.0

23.4.0

This quarterly update is a recommended update for stakers, but should be carefully reviewed by private network users before upgrading. This quarterly release contains a lot of new improvements but many breaking changes. We have deprecated GoQuorum-compatible privacy modes in this release, as well as IBFT1.0. If you require these, please consider migrating to new consensus algorithms or waiting for future releases.

Highlights in this release include:

• RocksDB 8 upgrade that improves the performance of the underlying database.
• Many logging and metrics improvements across the client.
• EVM performance improvements.
• An improved gas estimation algorithm.
• Fixes for QBFT and IBFT using zeroBaseFee
• RPC fixes
• Many more.

Lastly, this release formalizes a deprecation notice for GoQuorum -compatible permissioning modes in Besu. These will be removed in the 23.7 series, unless otherwise stated.

Breaking Changes

• In evmtool (an offline EVM executor tool principally used for reference tests), the --prestate and --genesis options no longer parse genesis files containing IBFT, QBFT, and Clique network definitions. The same genesis files will work with those json entries removed. #5192
• In --ethstats, if the port is not specified in the URI, it will default to 443 and 80 for ssl and non-ssl connections respectively instead of 3000. #5301
• Remove IBFT 1.0 feature #5302
• Remove GoQuorum-compatible privacy feature #5303
• Remove non-maintained launcher command line utility #5355
• Remove deprecated tx-pool-future-max-by-account option, see instead: tx-pool-limit-by-account-percentage #5361
• Default configuration for the deprecated ECIP-1049 network has been removed from the CLI network list #5371
• GoQuorum-compatible permissioning is deprecated and will be removed in 23.7

Additions and Improvements

• An alternate build target for the EVM using GraalVM AOT compilation was added. #5192
• To generate the binary install and use GraalVM 23.3.r17 or higher and run ./gradlew nativeCompile. The binary will be located in ethereum/evmtool/build/native/nativeCompile
• Upgrade RocksDB version from 7.7.3 to 8.0.0. Besu Team contributed to this release to make disabling checksum verification work. #5262
• Log an error with stacktrace when RPC responds with internal error #5288
• --ethstats-cacert to specify root CA of ethstats server (useful for non-production environments). #5301
• Update most dependencies to latest version #5269
• If jemalloc is used, print its version in the configuration overview #4738
• Add metrics for accounts and storage reads (Flat database vs Merkle Patricia Trie) #5315
• Offload LogBloom cache generation to computation executor, to avoid interfere with other scheduled tasks #4530
• Reference tests are upgraded to use v12.1 of the ethereum tests #5343
• Add new sepolia bootnodes, which should improve peering in the testnet. #5352
• Renamed --bonsai-maximum-back-layers-to-load option to --bonsai-historical-block-limit for clarity. Removed --Xbonsai-use-snapshots option as it is no longer functional #5337
• Change Forest to use TransactionDB instead of OptimisticTransactionDB #5328
• Performance: Reduced usage of UInt256 in EVM operations #5331
• Changed wrong error message "Invalid params" when private tx is reverted to "Execution reverted" with correct revert reason in data. #5369
• Changes to the way gas is estimated to provide an exact gas estimate #5142
• Add zero reads to Bonsai TrieLogs #5317
• Bonsai TrieLog serialization interface and default implementation #5372

Bug Fixes

• Fix eth_getBlockByNumber cache error for latest block when called during syncing #5292
• Fix QBFT and IBFT unable to propose blocks on London when zeroBaseFee is used #5276
• Make QBFT validator smart contract mode work with london fork #5249
• Try to connect to EthStats server by default with ssl followed by non-ssl. #5301
• Allow --miner-extra-data to be used in Proof-of-Stake block production #5291
• Add withdrawals to payloadId calculation to avoid collisions #5321

Download Links

https://hyperledger.jfrog.io/hyperledger/besu-binaries/besu/23.4.0/besu-23.4.0.zip / sha256: 023a267ee07ed6e069cb15020c1c0262efc5ea0a3e32adc6596068cff7fd0be5
https://hyperledger.jfrog.io/hyperledger/besu-binaries/besu/23.4.0/besu-23.4.0.tar.gz / sha256: 821695b3255c9f646f4d527e374219c96416f498231520f2eec2bebedc53f5a0

23.1.3

23.1.3 - Nimbus Hotfix

This update is strongly recommended for anyone running Nimbus with Besu. Due to the way Nimbus send request data, this can lead to a missed block proposal in certain circumstances.

Bug Fixes

• Add withdrawals to payloadId calculation to avoid collisions #5321

Download Links

https://hyperledger.jfrog.io/hyperledger/besu-binaries/besu/23.1.3/besu-23.1.3.tar.gz / sha256: 36898932a7535c4d126c1980443b33c9a4971f9354112992a18ee134c1777aa3
https://hyperledger.jfrog.io/hyperledger/besu-binaries/besu/23.1.3/besu-23.1.3.zip / sha256: adb3b17e45217f86a56f07f09faba2e5d8a0eb8a585ad5307696d6cc58ee2f73

23.1.2

23.1.2

This update is a mainnet-compatible Shanghai/Capella upgrade and is recommended for all Mainnet users. This update contains a small number of overall improvements and fixes but a large refactor of Bonsai. We have heard your issues loud and clear with the storage format and have taken the time to craft a new architecture that keeps the benefits (low storage, lightweight nodes) without the tradeoffs (worldstate issues, exceptions processing transactions, broken databases). Expect more details on this in a forthcoming blog post. We have also continued our cleanup of backwards sync and RPC.

Breaking Changes

Additions and Improvements

• Schedule Shanghai (Shapella) fork for Mainnet #5230
• Increase default from 1000 to 5000 for --rpc-max-logs-range #5209
• Bonsai-safe refactor #5123
• Safe tracing #5197

Bug Fixes

• Persist backward sync status to support resuming across restarts #5182

Download Links

https://hyperledger.jfrog.io/hyperledger/besu-binaries/besu/23.1.2/besu-23.1.2.tar.gz / sha256: 3d3a709a3aab993a0801b412a4719d74e319f942ddc13fb0f30b3c4a54d12538
https://hyperledger.jfrog.io/hyperledger/besu-binaries/besu/23.1.2/besu-23.1.2.zip / sha256: 2a9ff091cb4349fc23625a52089400bb6529a831eb22d15d0221cb27039ab203

23.1.1

23.1.1 Goerli Shanghai/Capella Release

This update is required for the Goerli Shanghai/Capella upgrade and recommended for all Mainnet users. If you use Besu on Goerli, update to 23.1.1. If you previously used 23.1.1-RC1, update to test 23.1.1 on Goerli.

Breaking Changes

Additions and Improvements

• Add support for Shanghai in Sepolia #5088
• Add implementation for engine_getPayloadBodiesByRangeV1 and engine_getPayloadBodiesByHashV1 #4980
• If a PoS block creation repetition takes less than a configurable duration, then waits before next repetition #5048
• Allow other users to read the /opt/besu dir when using docker #5092
• Invalid params - add some error detail #5066
• Added the option --kzg-trusted-setup to pass a custom setup file for custom networks or to override the default one for named networks #5084
• Gas accounting for EIP-4844 #4992
• Goerli configs for shapella #5151

Bug Fixes

• Fix engine_getPayloadV2 block value calculation #5040
• Moves check for init code length before balance check #5077
• Address post-shanghai sync issue #5714
• Address concurrency problems with eth_call #5179

Download Links

https://hyperledger.jfrog.io/hyperledger/besu-binaries/besu/23.1.1/besu-23.1.1.tar.gz / sha256: 11c3e5cdbc06df16a690e7ee9f98eefa46848f9fa280824b6e4c896d88f6b975
https://hyperledger.jfrog.io/hyperledger/besu-binaries/besu/23.1.1/besu-23.1.1.zip / sha256: afcf852f193adb8e82d187aa4f02e4669f12cc680270624d37101b94cf37adec

23.1.1-RC1 - Sepolia Shanghai Release

Sepolia Shanghai Release aka Sepolia Shapella aka Shapolia

This update is not recommended for mainnet users.

Besu 23.1.1-RC1 is a required update for Sepolia users

Sepolia Shanghai hardfork scheduled for: Tue Feb 28 2023 04:04:48 UTC

---

This release has everything from 23.1.0 and in addition the following:

Additions and Improvements

• Add support for Shanghai in Sepolia #5088
• Add implementation for engine_getPayloadBodiesByRangeV1 and engine_getPayloadBodiesByHashV1 #4980
• If a PoS block creation repetition takes less than a configurable duration, then waits before next repetition #5048
• Allow other users to read the /opt/besu dir when using docker #5092
• Invalid params - add some error detail #5066

Bug fixes

• Fix engine_getPayloadV2 block value calculation #5040
• Moves check for init code length before balance check #5077

Download Links

https://hyperledger.jfrog.io/hyperledger/besu-binaries/besu/23.1.1-RC1/besu-23.1.1-RC1.tar.gz / sha256: 82cff41f3eace02006b0e670605848e0e77e045892f8fa9aad66cbd84a88221e

https://hyperledger.jfrog.io/hyperledger/besu-binaries/besu/23.1.1-RC1/besu-23.1.1-RC1.zip / sha256: 469c8d6a8ca9d78ee111ff1128d00bf3bcddacbf5b800ef6047717a2da0cc21d

23.1.0

23.1.0

Besu 23.1.0 is a recommended update for Mainnet users. Thank you all for your patience as we crafted this quarterly release.

This is a rather large release with some breaking changes, so please be sure to read these notes carefully before you upgrade any Besu instances. We are including a move to Java 17 LTS. To build and run Besu, please make sure you have Java 17 on the host machine. Additionally, there are a host of spec compliance changes that change existing formats, so please check the specific RPC updates. Lastly, this release formalizes a deprecation notice for GoQuorum privacy modes and IBFT1.0 in Besu. These will be removed in the 23.4 series, unless otherwise stated.

From the improvements and fixes side, we have a host of execution performance improvements and fixes for defects with bonsai storage. We have also included an error detection and auto-heal capability for nodes that encounter state issues. This should keep nodes online and validating that may have previously required a resync.

One final note. 23.1.0 is not a Shanghai ready release. If you intend to test Besu on the long-lived testnets like Zhejiang, please follow the instructions here. We will have more to share on our official Shanghai releases soon.

Breaking Changes

• Change JsonRpc http service to return the error -32602 (Invalid params) with a 200 http status code
• Besu requires minimum Java 17 and up to build and run #3320
• PKCS11 with nss module (PKCS11 based HSM can be used in DevP2P TLS and QBFT PKI) does not work with RSA keys
  in Java 17. SoftHSM is tested manually and working. (Other PKCS11 HSM are not tested). The relevant unit and acceptance
  tests are updated to use EC private keys instead of RSA keys.
• Change eth_feeHistory parameter blockCount to accept hexadecimal string (was accepting plain integer) #5047
• Default configurations for the deprecated Ropsten, Kiln, Shandong, and Astor networks have been removed from the CLI network list. These networks can currently be accessed but will require a user-provided genesis configuration. #4869
• GoQuorum-compatible privacy is deprecated and will be removed in 23.4
• IBFT 1.0 is deprecated and will be removed in 23.4
• Optimize SSTORE Operation execution time (memoize current and original value) #4836

Additions and Improvements

• Default rpc batch request to 1024 #5104 #5108
• Add a new CLI option to limit the number of requests in a single RPC batch request. #4965
• Support for new DATAHASH opcode as part of EIP-4844 #4823
• Send only hash announcement for blob transaction type #4940
• Add excess_data_gas field to block header #4958
• Add max_fee_per_data_gas field to transaction #4970
• Added option to evm CLI tool to allow code execution at specific forks #4913
• Improve get account performance by using the world state updater cache #4897
• Add new KZG precompile and option to override the trusted setup being used #4822
• Add implementation for eth_createAccessList RPC method #4942
• Updated reference tests to v11.3 #4996
• Add DebugGetRawBlock and DebugGetRawHeader RPC methods #5011
• Besu requires minimum Java 17 and up to build and run #3320
• Add worldstate auto-heal mechanism #5059
• Support for EIP-4895 - Withdrawals for Shanghai fork
• Improve SLOAD and SSTORE performance by caching empty slots #4874
• RPC methods that lookup block by hash will now return an error response if no block found #4582
• Added support for safe and finalized strings for the RPC methods using defaultBlock parameter #4902
• Added post-execution state logging option to EVM Tool #4709
• Add access list to Transaction Call Object #4802
• Add timestamp fork support, including shanghaiTime and cancunTime forks #4743
• Optimization: Memoize transaction size and hash at the same time #4812
• Add chain data pruning feature with three experimental CLI options: --Xchain-pruning-enabled, --Xchain-pruning-blocks-retained and --Xchain-pruning-frequency #4686
  • Note that chain pruning is hidden and disabled by default. Once you choose to enable chain pruning, a new column family will be added to the db and you cannot roll back to a previous version of Besu.

Bug Fixes

• Mitigation fix for stale bonsai code storage leading to log rolling issues on contract recreates #4906
• Ensure latest cached layered worldstate is subscribed to storage, fix problem with RPC calls using 'latest' #5076
• Fix for segmentation faults on worldstate truncation, snap-sync starts #4786
• Fix for worldstate mismatch on failed forkchoiceUpdate #4862

Download Links
https://hyperledger.jfrog.io/hyperledger/besu-binaries/besu/23.1.0/besu-23.1.0.tar.gz / sha256: 9081da04d47c3ff0a6ecc2256d353c7a02212f9b46f2c867a9365e18026c3a6e
https://hyperledger.jfrog.io/hyperledger/besu-binaries/besu/23.1.0/besu-23.1.0.zip / sha256: e037f5c8f976150af40403311d1c81018f4c3dfbef0ad33324d8c3e708d1fdca

23.1.0-RC1

23.1.0-RC1

Breaking Changes

• Default configurations for the deprecated Ropsten, Kiln, Shandong, and Astor networks have been removed from the CLI network list. These networks can currently be accessed but will require a user-provided genesis configuration. #4869

Additions and Improvements

• Improve SLOAD and SSTORE performance by caching empty slots #4874
• RPC methods that lookup block by hash will now return an error response if no block found #4582
• Added support for safe and finalized strings for the RPC methods using defaultBlock parameter #4902

Download Links

https://hyperledger.jfrog.io/hyperledger/besu-binaries/besu/23.1.0-RC1/besu-23.1.0-RC1.tar.gz / sha256: 30906891e528b3b4e3ce8e2313550a1da066b31ea10b05456dd0ad026792b46d
https://hyperledger.jfrog.io/hyperledger/besu-binaries/besu/23.1.0-RC1/besu-23.1.0-RC1.zip / sha256: 9067d1929079ae4a7c165e6f1e2bae08834939ed191f976d26544dc93352c306

23.1.0-beta

23.1.0-beta

Breaking Changes

• GoQuorum-compatible privacy is deprecated and will be removed in 23.4
• IBFT 1.0 is deprecated and will be removed in 23.4
• Optimize SSTORE Operation execution time (memoize current and original value) #4836

Additions and Improvements

• Added post-execution state logging option to EVM Tool #4709
• Add access list to Transaction Call Object #4802
• Add timestamp fork support, including shanghaiTime and cancunTime forks #4743
• Optimization: Memoize transaction size and hash at the same time #4812

Bug Fixes

• Fix for segmentation faults on worldstate truncation, snap-sync starts #4786
• Fix for worldstate mismatch on failed forkchoiceUpdate #4862

Download Links

https://hyperledger.jfrog.io/hyperledger/besu-binaries/besu/23.1.0-beta/besu-23.1.0-beta.tar.gz / sha256: ab25ee41d9464216fa2a8bbf5a788b0963e383b505c5d664c63ac96efe5ef657
https://hyperledger.jfrog.io/hyperledger/besu-binaries/besu/23.1.0-beta/besu-23.1.0-beta.zip / sha256: 250d87736ae09408394e584f99f1e15b5e30769d87a4eec777eca2bbb81882df

22.10.3

22.10.3

Breaking Changes

• Added --rpc-max-logs-range CLI option to allow limiting the number of blocks queried by eth_getLogs RPC API. Default value: 1000 #4597
• The graalvm docker variant no longer meets the performance requirements for Ethereum Mainnet. The openjdk-11 and openjdk-latest variants are recommended in its place.

Additions and Improvements

• Implement Eth/68 sub-protocol #4715
• Increase the speed of modexp gas execution and execution. #4780
• Added experimental CLI options --Xeth-capability-max and --Xeth-capability-min to specify a range of capabilities to be supported by the Eth protocol. #4752
• Set the default curve in the EVMTool, like is done in production operations #4790

Bug Fixes

• Fix storage key format for eth_getProof so that it follows the EIP-1474 spec #4564

Download Links

https://hyperledger.jfrog.io/hyperledger/besu-binaries/besu/22.10.3/besu-22.10.3.tar.gz / sha256: 7213f9445a84a196e94ae1877c6fdb1e51d37bfb19615da02ef5121d4f40e38c
https://hyperledger.jfrog.io/hyperledger/besu-binaries/besu/22.10.3/besu-22.10.3.zip / sha256: 0bf6bc98e01b0c1045f1b7d841a390c575bc5203c2a4e543d922fbc1ea0d3d5d

22.10.2

22.10.2

This is a hotfix release to resolve a race condition that results in segfaults, introduced in 22.10.1 release.

Bug Fixes

• bugfix for async operations on Snapshot worldstates #4767

NOTE

• If you are using the experimental flag --Xbonsai-use-snapshots we recommend removing it from your config for now. We have ported some of its behavior into the default Bonsai code, and using this flag can cause issues/conflicts.

Download Links

https://hyperledger.jfrog.io/hyperledger/besu-binaries/besu/22.10.2/besu-22.10.2.tar.gz / sha256: cdb36141e3cba6379d35016e0a2de2edba579d4786124b5f7257b1e4a68867a2
https://hyperledger.jfrog.io/hyperledger/besu-binaries/besu/22.10.2/besu-22.10.2.zip / sha256: 4c9208f684762670cb4f2c6ebfb6930e05e339a7c3c586fe8caa9f26462830aa