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

22.10.1

22.10.1

Note: Do NOT use v22.10.1, there is a known SEGFAULT causing Besu to be unable to start. This issue is resolved in 22.10.2.

Breaking Changes

• Fields publicKey and raw removed from RPC API Transaction result object #4575

Additions and Improvements

• Explain and improve price validation for London and local transactions during block proposal selection #4602
• Support for ephemeral testnet Shandong, for EOF testing. #4599
• Improve performance of block processing by parallelizing some parts during the "commit" step #4635
• Upgrade RocksDB version from 7.6.0 to 7.7.3
• Added new RPC endpoints debug_setHead & debug_replayBlock 4580
• Upgrade OpenTelemetry to version 1.19.0 #3675
• Implement Eth/67 sub-protocol #4596
• Backward sync log UX improvements #4655
• Enable RocksDB Bloom filters to improve read performance #4682
• Backward sync: use retry switching peer when fetching data from peers #4656
• Shanghai implementation of EIP-3651 Warm coinbase #4620
• Shanghai implementation of EIP-3855 Push0 #4660
• Shanghai implementation of EIP-3540 and EIP-3670 Ethereum Object Format and Code Validation #4644
• Remove some log statements that are keeping some objects live in heap for a long time, to reduce the amount of memory required during initial sync #4705
• Add field type to Transaction receipt object (eth_getTransactionReceipt) #4505
• Print an overview of configuration and system information at startup #4451
• Do not send new payloads to backward sync if initial sync is in progress #4720
• Improve the way transaction fee cap validation is done on London fee market to not depend on transient network conditions #4598
• Preload and cache account and storage data from RocksDB to improve performance #4737

Bug Fixes

• Restore updating chain head and finalized block during backward sync #4718

Download Links

https://hyperledger.jfrog.io/hyperledger/besu-binaries/besu/22.10.1/besu-22.10.1.tar.gz / sha256: b6757b9fc69b782cdabb95b1e784d31b1effcc2e25c6b198b2f9d6b3786c7a8a
https://hyperledger.jfrog.io/hyperledger/besu-binaries/besu/22.10.1/besu-22.10.1.zip / sha256: 0dbee534620c7cc0fac0596e6df0c7f8a74be9df9cecd9d4f1407016f30fb9a1

22.10.0

22.10.0

Breaking Changes

• Flexible Privacy Groups (early access) support to Tessera's EC encryptor (contracts modified) #4282
  • Before this change, the bytes32 type was used for the enclave public keys, just supporting encryptors with public keys of that length (like the default NaCl)
  • For the EC encryptor, the encoded public key length is 91
• --tx-pool-hashes-max-size option removed (deprecated in 22.1.3)
• --Xmerge-support option remove (deprecated in 22.4.2) #4518
• Breaking API changes in the OperationTracer interface to enable performance work.
  • The traceExecution method has been replaced with tracePreExecution and tracePostExecution methods, called just before and just after operation execution.
  • See DebugOperationTracer and StandardJsonTracer for migration examples.
  • RocksDB will not be able to downgrade after updating to 22.10.0 if you are looking to return to 22.7.x without a resync. Will will be changing this behavior in a future update.

Additions and Improvements

• Updated jackson-databind library to version 2.13.4.2 addressing CVE-2022-42003
• Update snapsync feature to avoid restarting the download of the world state from scratch when restarting Besu #4381
• Added worldstate snapshot isolation to improve the stability of bonsai (--Xbonsai-use-snapshots=true) #4351
• Reduce the number of runtime exceptions (SecurityModuleException) and unnecessary executions during ECIES handshake, by trying to decrypt EIP-8 formatted messages first #4508.
• Improved RLP processing of zero-length string as 0x80 #4283 #4388
• Increased level of detail in JSON-RPC parameter error log messages #4510
• New unstable configuration options to set the maximum time, in milliseconds, a PoS block creation jobs is allowed to run #4519
• Tune EthScheduler thread pools to avoid recreating too many threads #4529
• RocksDB snapshot based worldstate and plugin-api addition of Snapshot interfaces #4409
• Continuously try to build better block proposals until timeout or GetPayload is called #4516
• Upgrade RocksDB database version from 6.29.5 to 7.6.0 #4517
• Avoid connecting to self when using static-nodes #4521
• EVM performance has increased 20%-100% depending on the particulars of the contract. #4540
• Improve calculateRootHash method performance during Block processing #4568
• Bring GraphQL into compliance with execution-api specs #4112
• Refactor unverified forkchoice event #4487
• Improve UX of initial sync logs, pushing not relevant logs to debug level #4486
• Optimize pivot block selector on PoS networks #4488
• Optimize Snap sync on PoS networks #4462

Bug Fixes

• Fixed default fromBlock value and improved parameter interpretation in eth_getLogs RPC handler #4513
• Fix for NoSuchElementException for missing invalid reason when rejecting a local sent transaction #4569
• Corrects treating a block as bad on internal error during either validation or processing #4512
• Corrects emission of blockadded events when rewinding during a re-org. Fix for #4495
• Always return a transaction type for pending transactions #4364
• Avoid a cyclic reference while printing EngineExchangeTransitionConfigurationParameter #4357
• Corrects treating a block as bad on internal error #4512
• In GraphQL update scalar parsing to be variable friendly #4522
• Initiate connection to maintained peers soon after startup. #4469
• Update apache-commons-text to 1.10.0 to address CVE-2022-42889 #4542

Download Links

https://hyperledger.jfrog.io/hyperledger/besu-binaries/besu/22.10.0/besu-22.10.0.tar.gz / sha256: 88fb5df567e4ec3547d7d2970cfef00debbd020c0da66b19166d43779b3b2b85
https://hyperledger.jfrog.io/hyperledger/besu-binaries/besu/22.10.0/besu-22.10.0.zip / sha256: c8e39f7c879409cb9b47f4d3de5e9c521249083830a8c9a45e8a14a319fe195d