368 KiB
Changelog
[Unreleased]
Upcoming Breaking Changes
Breaking Changes
- Receipt compaction is enabled by default. It will no longer be possible to downgrade Besu to versions prior to 24.5.1.
Additions and Improvements
- Add 'inbound' field to admin_peers JSON-RPC Call #7461
- Add pending block header to
TransactionEvaluationContext
plugin API #7483 - Add bootnode to holesky config #7500
- Implement engine_getClientVersionV1 #7512
- Performance optimzation for ECMUL (1 of 2) #7509
- Performance optimzation for ECMUL (2 of 2) #7543
Bug fixes
- Fix tracing in precompiled contracts when halting for out of gas #7318
- Correctly release txpool save and restore lock in case of exceptions #7473
- Fix for
eth_gasPrice
could not retrieve block error #7482 - Correctly drops messages that exceeds local message size limit #5455
- DebugMetrics: Fixed a
ClassCastException
occurring inDebugMetrics
when handling nested metric structures. Previously,Double
values within these structures were incorrectly cast toMap
objects, leading to errors. This update allows for proper handling of both direct values and nested structures at the same level. Issue# #7383 evmtool
was not respecting the--genesis
setting, resulting in unexpected trace results. #7433
24.8.0
Upcoming Breaking Changes
- Receipt compaction will be enabled by default in a future version of Besu. After this change it will not be possible to downgrade to the previous Besu version.
- --Xbonsai-limit-trie-logs-enabled is deprecated, use --bonsai-limit-trie-logs-enabled instead
- --Xbonsai-trie-logs-pruning-window-size is deprecated, use --bonsai-trie-logs-pruning-window-size instead
besu storage x-trie-log
subcommand is deprecated, usebesu storage trie-log
instead- Allow configuration of Withdrawal Request Contract Address via genesis configuration #7356
Breaking Changes
- Remove long-deprecated
perm*whitelist*
methods #7401
Additions and Improvements
- Expose set finalized/safe block in plugin api BlockchainService. These method can be used by plugins to set finalized/safe block for a PoA network (such as QBFT, IBFT and Clique).#7382
- In process RPC service #7395
- Added support for tracing private transactions using
priv_traceTransaction
API. #6161 - Wrap WorldUpdater into EVMWorldupdater #7434
- Bump besu-native to 0.9.4 #7456=
Bug fixes
- Correct entrypoint in Docker evmtool #7430
- Fix protocol schedule check for devnets #7429
- Fix behaviour when starting in a pre-merge network #7431
- Fix Null pointer from DNS daemon #7505
Download Links
https://github.com/hyperledger/besu/releases/tag/24.8.0 https://github.com/hyperledger/besu/releases/download/24.8.0/besu-24.8.0.tar.gz / sha256 9671157a623fb94005357bc409d1697a0d62bb6fd434b1733441bb301a9534a4 https://github.com/hyperledger/besu/releases/download/24.8.0/besu-24.8.0.zip / sha256 9ee217d2188e8da89002c3f42e4f85f89aab782e9512bd03520296f0a4dcdd90
24.7.1
Breaking Changes
- Remove deprecated sync modes (X_SNAP and X_CHECKPOINT). Use SNAP and CHECKPOINT instead #7309
- Remove PKI-backed QBFT (deprecated in 24.5.1) Other forms of QBFT remain unchanged. #7293
- Do not maintain connections to PoA bootnodes #7358. See #7314 for recommended alternative behaviour.
Upcoming Breaking Changes
- Receipt compaction will be enabled by default in a future version of Besu. After this change it will not be possible to downgrade to the previous Besu version.
- --Xbonsai-limit-trie-logs-enabled is deprecated, use --bonsai-limit-trie-logs-enabled instead
- --Xbonsai-trie-logs-pruning-window-size is deprecated, use --bonsai-trie-logs-pruning-window-size instead
besu storage x-trie-log
subcommand is deprecated, usebesu storage trie-log
instead
Additions and Improvements
--Xsnapsync-bft-enabled
option enables experimental support for snap sync with IBFT/QBFT permissioned Bonsai-DB chains #7140- Add support to load external profiles using
--profile
#7265 privacy-nonce-always-increments
option enables private transactions to always increment the nonce, even if the transaction is invalid #6593- Added
block-test
subcommand to the evmtool which runs blockchain reference tests #7293 - removed PKI backed QBFT #7310
- Implement gnark-crypto for eip-2537 #7316
- Improve blob size transaction selector #7312
- Added EIP-7702 #7237
- Implement gnark-crypto for eip-196 #7262
- Add trie log pruner metrics #7352
- Force bonsai-limit-trie-logs-enabled=false when sync-mode=FULL instead of startup error #7357
--Xbonsai-parallel-tx-processing-enabled
option enables executing transactions in parallel during block processing for Bonsai nodes- Reduce default trie log pruning window size from 30,000 to 5,000 #7365
- Add option
--poa-discovery-retry-bootnodes
for PoA networks to always use bootnodes during peer refresh, not just on first start #7314
Bug fixes
- Fix
eth_call
deserialization to correctly ignore unknown fields in the transaction object. #7323 - Prevent Besu from starting up with sync-mode=FULL and bonsai-limit-trie-logs-enabled=true for private networks #7357
- Add 30 second timeout to trie log pruner preload #7365
- Avoid executing pruner preload during trie log subcommands #7366
Download Links
https://github.com/hyperledger/besu/releases/tag/24.7.1 https://github.com/hyperledger/besu/releases/download/24.7.1/besu-24.7.1.tar.gz / sha256 59ac352a86fd887225737a5fe4dad1742347edd3c3fbed98b079177e4ea8d544 https://github.com/hyperledger/besu/releases/download/24.7.1/besu-24.7.1.zip / sha256 e616f8100f026a71a146a33847b40257c279b38085b17bb991df045cccb6f832
24.7.0
Upcoming Breaking Changes
- Receipt compaction will be enabled by default in a future version of Besu. After this change it will not be possible to downgrade to the previous Besu version.
- PKI-backed QBFT will be removed in a future version of Besu. Other forms of QBFT will remain unchanged.
- --Xbonsai-limit-trie-logs-enabled is deprecated, use --bonsai-limit-trie-logs-enabled instead
- --Xbonsai-trie-logs-pruning-window-size is deprecated, use --bonsai-trie-logs-pruning-window-size instead
besu storage x-trie-log
subcommand is deprecated, usebesu storage trie-log
instead
Breaking Changes
Xp2p-peer-lower-bound
has been removed. #7247
Additions and Improvements
- Support for eth_maxPriorityFeePerGas #5658
- Improve genesis state performance at startup #6977
- Enable continuous profiling with default setting #7006
- A full and up to date implementation of EOF for Prague #7169
- Add Subnet-Based Peer Permissions. #7168
- Reduce lock contention on transaction pool when building a block #7180
- Update Docker base image to Ubuntu 24.04 #7251
- Add LUKSO as predefined network name #7223
- Refactored how code, initcode, and max stack size are configured in forks. #7245
- Nodes in a permissioned chain maintain (and retry) connections to bootnodes #7257
- Promote experimental
besu storage x-trie-log
subcommand to production-ready #7278 - Enhanced BFT round-change diagnostics #7271
Bug fixes
- Validation errors ignored in accounts-allowlist and empty list #7138
- Fix "Invalid block detected" for BFT chains using Bonsai DB #7204
- Fix "Could not confirm best peer had pivot block" #7109
- Fix "Chain Download Halt" #6884
Download Links
https://github.com/hyperledger/besu/releases/tag/24.7.0 https://github.com/hyperledger/besu/releases/download/24.7.0/besu-24.7.0.tar.gz / sha256 96cf47defd1d8c10bfc22634e53e3d640eaa81ef58cb0808e5f4265998979530 https://github.com/hyperledger/besu/releases/download/24.7.0/besu-24.7.0.zip / sha256 7e92e2eb469be197af8c8ca7ac494e7a2e7ee91cbdb02d99ff87fb5209e0c2a0
24.6.0
Breaking Changes
- Java 21 has been enforced as minimum version to build and run Besu.
- With --Xbonsai-limit-trie-logs-enabled by default in this release, historic trie log data will be removed from the database unless sync-mode=FULL. It respects the --bonsai-historical-block-limit setting so shouldn't break any RPCs, but may be breaking if you are accessing this data from the database directly. Can be disabled with --bonsai-limit-trie-logs-enabled=false
- In profile=ENTERPRISE, use sync-mode=FULL (instead of FAST) and data-storage-format=FOREST (instead of BONSAI) #7186
- If this breaks your node, you can reset sync-mode=FAST and data-storage-format=BONSAI
Upcoming Breaking Changes
- Receipt compaction will be enabled by default in a future version of Besu. After this change it will not be possible to downgrade to the previous Besu version.
- PKI-backed QBFT will be removed in a future version of Besu. Other forms of QBFT will remain unchanged.
- --Xbonsai-limit-trie-logs-enabled is deprecated, use --bonsai-limit-trie-logs-enabled instead
- --Xbonsai-trie-logs-pruning-window-size is deprecated, use --bonsai-trie-logs-pruning-window-size instead
Additions and Improvements
- Add two counters to DefaultBlockchain in order to be able to calculate TPS and Mgas/s #7105
- Enable --Xbonsai-limit-trie-logs-enabled by default, unless sync-mode=FULL #7181
- Promote experimental --Xbonsai-limit-trie-logs-enabled to production-ready, --bonsai-limit-trie-logs-enabled #7192
- Promote experimental --Xbonsai-trie-logs-pruning-window-size to production-ready, --bonsai-trie-logs-pruning-window-size #7192
admin_nodeInfo
JSON/RPC call returns the currently active EVM version #7127- Improve the selection of the most profitable built block #7174
Bug fixes
- Make
eth_gasPrice
aware of the base fee market #7102
Download Links
https://github.com/hyperledger/besu/releases/tag/24.6.0 https://github.com/hyperledger/besu/releases/download/24.6.0/besu-24.6.0.tar.gz / sha256 fa86e5c6873718cd568e3326151ce06957a5e7546b52df79a831ea9e39b857ab https://github.com/hyperledger/besu/releases/download/24.6.0/besu-24.6.0.zip / sha256 8b2d3a674cd7ead68b9ca68fea21e46d5ec9b278bbadc73f8c13c6a1e1bc0e4d
24.5.2
Upcoming Breaking Changes
- Version 24.5.x will be the last series to support Java 17. Next release after versions 24.5.x will require Java 21 to build and run.
- Receipt compaction will be enabled by default in a future version of Besu. After this change it will not be possible to downgrade to the previous Besu version.
- PKI-backed QBFT will be removed in a future version of Besu. Other forms of QBFT will remain unchanged.
Additions and Improvements
- Remove deprecated Goerli testnet #7049
- Default bonsai to use full-flat db and code-storage-by-code-hash #6984
- New RPC methods miner_setExtraData and miner_getExtraData #7078
- Disconnect peers that have multiple discovery ports since they give us bad neighbours #7089
- Port Tuweni dns-discovery into Besu. #7129
Known Issues
- [Frequency: occasional < 10%] Chain download halt. Only affects new syncs (new nodes syncing from scratch). Symptom: Block import halts, despite having a full set of peers and world state downloading finishing. Generally restarting besu will resolve the issue. We are tracking this in #6884
Bug fixes
- Fix parsing
gasLimit
parameter when its value is >Long.MAX_VALUE
#7116 - Skip validation of withdrawals when importing BFT blocks since withdrawals don't apply to BFT chains #7115
- Make
v
abdyParity
match in type 1 and 2 transactions in JSON-RPC and GraphQL #7139
Download Links
https://github.com/hyperledger/besu/releases/tag/24.5.2 https://github.com/hyperledger/besu/releases/download/24.5.2/besu-24.5.2.tar.gz / sha256 4049bf48022ae073065b46e27088399dfb22035e9134ed4ac2c86dd8c5b5fbe9 https://github.com/hyperledger/besu/releases/download/24.5.2/besu-24.5.2.zip / sha256 23966b501a69e320e8f8f46a3d103ccca45b53f8fee35a6543bd9a260b5784ee
24.5.1
Breaking Changes
- RocksDB database metadata format has changed to be more expressive, the migration of an existing metadata file to the new format is automatic at startup. Before performing a downgrade to a previous version it is mandatory to revert to the original format using the subcommand
besu --data-path=/path/to/besu/datadir storage revert-metadata v2-to-v1
. - BFT networks won't start with SNAP or CHECKPOINT sync (previously Besu would start with this config but quietly fail to sync, so it's now more obvious that it won't work) #6625, #6667
- Forest pruning has been removed, it was deprecated since 24.1.0. In case you are still using it you must now remove any of the following options:
pruning-enabled
,pruning-blocks-retained
andpruning-block-confirmations
, from your configuration, and you may want to consider switching to Bonsai. - Deprecated Goerli testnet has been removed.
Upcoming Breaking Changes
- Version 24.5.x will be the last series to support Java 17. Next release after versions 24.5.x will require Java 21 to build and run.
- Receipt compaction will be enabled by default in a future version of Besu. After this change it will not be possible to downgrade to the previous Besu version.
- PKI-backed QBFT will be removed in a future version of Besu. Other forms of QBFT will remain unchanged.
Known Issues
- [Frequency: occasional < 10%] Chain download halt. Only affects new syncs (new nodes syncing from scratch). Symptom: Block import halts, despite having a full set of peers and world state downloading finishing. Generally restarting besu will resolve the issue. We are tracking this in #6884
- [Frequency: occasional < 10%] Low peer numbers. More likely to occur on testnets (holesky and sepolia) but also can occur on mainnet. Symptom: peer count stays at 0 for an hour or more. Generally restarting besu will resolve the issue. We are tracking this in #6805
Additions and Improvements
- Update "host allow list" logic to transition from deprecated
host()
method to suggestedauthority()
method.#6878 txpool_besuPendingTransactions
change parameternumResults
to optional parameter #6708- Extend
Blockchain
service #6592 - Add bft-style
blockperiodseconds
transitions to Clique #6596 - Add
createemptyblocks
transitions to Clique #6608 - RocksDB database metadata refactoring #6555
- Make layered txpool aware of
minGasPrice
andminPriorityFeePerGas
dynamic options #6611 - Update commons-compress to 1.26.0 #6648
- Update Vert.x to 4.5.4 #6666
- Refactor and extend
TransactionPoolValidatorService
#6636 - Introduce
TransactionSimulationService
#6686 - Transaction call object to accept both
input
anddata
field simultaneously if they are set to equal values #6702 eth_call
for blob tx allows for emptymaxFeePerBlobGas
#6731- Extend error handling of plugin RPC methods #6759
- Added engine_newPayloadV4 and engine_getPayloadV4 methods #6783
- Reduce storage size of receipts #6602
- Dedicated log marker for invalid txs removed from the txpool #6826
- Prevent startup with BONSAI and privacy enabled #6809
- Remove deprecated Forest pruning #6810
- Experimental Snap Sync Server #6640
- Upgrade Reference Tests to 13.2 #6854
- Update Web3j dependencies #6811
- Add
tx-pool-blob-price-bump
option to configure the price bump percentage required to replace blob transactions (by default 100%) #6874 - Log detailed timing of block creation steps #6880
- Expose transaction count by type metrics for the layered txpool #6903
- Expose bad block events via the BesuEvents plugin API #6848
- Add RPC errors metric #6919
- Add
rlp decode
subcommand to decode IBFT/QBFT extraData to validator list #6895 - Allow users to specify which plugins are registered #6700
- Layered txpool tuning for blob transactions #6940
Bug fixes
- Fix txpool dump/restore race condition #6665
- Make block transaction selection max time aware of PoA transitions #6676
- Don't enable the BFT mining coordinator when running sub commands such as
blocks export
#6675 - In JSON-RPC return optional
v
fields for type 1 and type 2 transactions #6762 - Fix Shanghai/QBFT block import bug when syncing new nodes #6765
- Fix to avoid broadcasting full blob txs, instead of only the tx announcement, to a subset of nodes #6835
- Snap client fixes discovered during snap server testing #6847
- Correctly initialize the txpool as disabled on creation #6890
- Fix worldstate download halt when using snap sync during initial sync #6981
- Fix chain halt due to peers only partially responding with headers. And worldstate halts caused by a halt in the chain sync #7027
Download Links
https://github.com/hyperledger/besu/releases/tag/24.5.1 https://github.com/hyperledger/besu/releases/download/24.5.1/besu-24.5.1.tar.gz / sha256 77e39b21dbd4186136193fc6e832ddc1225eb5078a5ac980fb754b33ad35d554 https://github.com/hyperledger/besu/releases/download/24.5.1/besu-24.5.1.zip / sha256 13d75b6b22e1303f39fd3eaddf736b24ca150b2bafa7b98fce7c7782e54b213f
24.3.0
Breaking Changes
- SNAP - Snap sync is now the default for named networks #6530
- if you want to use the previous default behavior, you'll need to specify
--sync-mode=FAST
- if you want to use the previous default behavior, you'll need to specify
- BONSAI - Default data storage format is now Bonsai #6536
- if you had previously used the default (FOREST), at startup you will get an error indicating the mismatch
Mismatch: DB at '/your-path' is FOREST (Version 1) but config expects BONSAI (Version 2). Please check your config.
- to fix this mismatch, specify the format explicitly using
--data-storage-format=FOREST
- if you had previously used the default (FOREST), at startup you will get an error indicating the mismatch
- Following the OpenMetrics convention, the updated Prometheus client adds the
_total
suffix to every metrics of type counter, with the effect that some existing metrics have been renamed to have this suffix. If you are using the official Besu Grafana dashboard (available here), just update it to the latest revision, that accepts the old and the new name of the affected metrics. If you have a custom dashboard or use the metrics in other ways, then you need to manually update it to support the new naming. - The
trace-filter
method in JSON-RPC API now has a default block range limit of 1000, adjustable with--rpc-max-trace-filter-range
(thanks @alyokaz) #6446 - Requesting the Ethereum Node Record (ENR) to acquire the fork id from bonded peers is now enabled by default, so the following change has been made #5628:
--Xfilter-on-enr-fork-id
has been removed. To disable the feature use--filter-on-enr-fork-id=false
.--engine-jwt-enabled
has been removed. Use--engine-jwt-disabled
instead. #6491- Release docker images now provided at ghcr.io instead of dockerhub
Deprecations
- X_SNAP and X_CHECKPOINT are marked for deprecation and will be removed in 24.6.0 in favor of SNAP and CHECKPOINT #6405
--Xp2p-peer-lower-bound
is deprecated. #6501
Upcoming Breaking Changes
--Xbonsai-limit-trie-logs-enabled
will be removed. You will need to use--bonsai-limit-trie-logs-enabled
instead. Additionally, this limit will change to be enabled by default.- If you do not want the limit enabled (eg you have
--bonsai-historical-block-limit
set < 512), you need to explicitly disable it using--bonsai-limit-trie-logs-enabled=false
or increase the limit. #6561
- If you do not want the limit enabled (eg you have
Additions and Improvements
- Upgrade Prometheus and Opentelemetry dependencies #6422
- Add
OperationTracer.tracePrepareTransaction
, where the sender account has not yet been altered#6453 - Improve the high spec flag by limiting it to a few column families #6354
- Log blob count when importing a block via Engine API #6466
- Introduce
--Xbonsai-limit-trie-logs-enabled
experimental feature which by default will only retain the latest 512 trie logs, saving about 3GB per week in database growth #5390 - Introduce
besu storage x-trie-log prune
experimental offline subcommand which will prune all redundant trie logs except the latest 512 #6303 - Improve flat trace generation performance #6472
- SNAP and CHECKPOINT sync - early access flag removed so now simply SNAP and CHECKPOINT #6405
- X_SNAP and X_CHECKPOINT are marked for deprecation and will be removed in 24.4.0
- Github Actions based build.
- Introduce caching mechanism to optimize Keccak hash calculations for account storage slots during block processing #6452
- Added configuration options for
pragueTime
to genesis file for Prague fork development #6473 - Moving trielog storage to RocksDB's blobdb to improve write amplications #6289
- Support for
shanghaiTime
fork and Shanghai EVM smart contracts in QBFT/IBFT chains #6353 - Change ExecutionHaltReason for contract creation collision case to return ILLEGAL_STATE_CHANGE #6518
- Experimental feature
--Xbonsai-code-using-code-hash-enabled
for storing Bonsai code storage by code hash #6505 - More accurate column size
storage rocksdb usage
subcommand #6540 - Adds
storage rocksdb x-stats
subcommand #6540 - New
eth_blobBaseFee
JSON-RPC method #6581 - Add blob transaction support to
eth_call
#6661 - Add blobs to
eth_feeHistory
#6679 - Upgrade reference tests to version 13.1 #6574
- Extend
BesuConfiguration
service #6584 - Add
ethereum_min_gas_price
andethereum_min_priority_fee
metrics to track runtime values ofmin-gas-price
andmin-priority-fee
#6587 - Option to perform version incompatibility checks when starting Besu. In this first release of the feature, if
--version-compatibility-protection
is set to true it checks that the version of Besu being started is the same or higher than the previous version. 6307 - Moved account frame warming from GasCalculator into the Call operations #6557
Bug fixes
- Fix the way an advertised host configured with
--p2p-host
is treated when communicating with the originator of a PING packet #6225 - Fix
poa-block-txs-selection-max-time
option that was inadvertently reset to its default after being configured #6444 - Fix for tx incorrectly discarded when there is a timeout during block creation #6563
- Fix traces so that call gas costing in traces matches other clients traces #6525
Download Links
https://github.com/hyperledger/besu/releases/tag/24.3.0 https://github.com/hyperledger/besu/releases/download/24.3.0/besu-24.3.0.tar.gz / sha256 8037ce51bb5bb396d29717a812ea7ff577b0d6aa341d67d1e5b77cbc55b15f84 https://github.com/hyperledger/besu/releases/download/24.3.0/besu-24.3.0.zip / sha256 41ea2ca734a3b377f43ee178166b5b809827084789378dbbe4e5b52bbd8e0674
24.1.2
Bug fixes
- Fix ETC Spiral upgrade breach of consensus #6524
Additions and Improvements
Download Links
https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/24.1.2/besu-24.1.2.zip / sha256 9033f300edd81c770d3aff27a29f59dd4b6142a113936886a8f170718e412971 https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/24.1.2/besu-24.1.2.tar.gz / sha256 082db8cf4fb67527aa0dd757e5d254b3b497f5027c23287f9c0a74a6a743bf08
24.1.1
Breaking Changes
- New
EXECUTION_HALTED
error returned if there is an error executing or simulating a transaction, with the reason for execution being halted. Replaces the genericINTERNAL_ERROR
return code in certain cases which some applications may be checking for #6343 - The Besu Docker images with
openjdk-latest
tags since 23.10.3 were incorrectly using UID 1001 instead of 1000 for the container'sbesu
user. The user now uses 1000 again. Containers created from or migrated to images using UID 1001 will need to chown their persistent database files to UID 1000 (thanks @h4l) #6360 - The deprecated
--privacy-onchain-groups-enabled
option has now been removed. Use the--privacy-flexible-groups-enabled
option instead. #6411 - The time that can be spent selecting transactions during block creation is not capped at 5 seconds for PoS and PoW networks, and for PoA networks, at 75% of the block period specified in the genesis. This is to prevent possible DoS attacks in case a single transaction is taking too long to execute, and to have a stable block production rate. This could be a breaking change if an existing network needs to accept transactions that take more time to execute than the newly introduced limit. If it is mandatory for these networks to keep processing these long processing transaction, then the default value of
block-txs-selection-max-time
orpoa-block-txs-selection-max-time
needs to be tuned accordingly. #6423
Deprecations
Additions and Improvements
- Optimize RocksDB WAL files, allows for faster restart and a more linear disk space utilization #6328
- Disable transaction handling when the node is not in sync, to avoid unnecessary transaction validation work #6302
- Introduce TransactionEvaluationContext to pass data between transaction selectors and plugin, during block creation #6381
- Upgrade dependencies #6377
- Upgrade
com.fasterxml.jackson
dependencies #6378 - Upgrade Guava dependency #6396
- Upgrade Mockito #6397
- Upgrade
tech.pegasys.discovery:discovery
#6414 - Options to tune the max allowed time that can be spent selecting transactions during block creation are now stable #6423
- Support for "pending" in
qbft_getValidatorsByBlockNumber
#6436
Bug fixes
- INTERNAL_ERROR from
eth_estimateGas
JSON/RPC calls #6344 - Fix Besu Docker images with
openjdk-latest
tags since 23.10.3 using UID 1001 instead of 1000 for thebesu
user #6360 - Fluent EVM API definition for Tangerine Whistle had incorrect code size validation configured #6382
- Correct mining beneficiary for Clique networks in TraceServiceImpl #6390
- Fix to gas limit delta calculations used in block production. Besu should now increment or decrement the block gas limit towards its target correctly (thanks @arbora) #6425
- Ensure Backward Sync waits for initial sync before starting a session #6455
- Silence the noisy DNS query errors #6458
Download Links
https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/24.1.1/besu-24.1.1.zip / sha256 e23c5b790180756964a70dcdd575ee2ed2c2efa79af00bce956d23bd2f7dc67c https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/24.1.1/besu-24.1.1.tar.gz / sha256 4b0ddd5a25be2df5d2324bff935785eb63e4e3a5f421614ea690bacb5b9cb344
Errata
Note, due to a CI race with the release job, the initial published version of 24.1.1 were overwritten by artifacts generated from the same sources, but differ in their embedded timestamps. The initial SHAs are noted here but are deprecated:
https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/24.1.1/besu-24.1.1.zip / sha256 b6b64f939e0bb4937ce90fc647e0a7073ce3e359c10352b502059955070a60c6
https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/24.1.1/besu-24.1.1.tar.gz / sha256 cfcae04c30769bf338b0740ac65870f9346d3469931bb46cdba3b2f65d311e7a
24.1.0
Breaking Changes
Deprecations
- Forest pruning (
pruning-enabled
option) is deprecated and will be removed soon. To save disk space consider switching to Bonsai data storage format #6230
Additions and Improvements
- Add error messages on authentication failures with username and password #6212
- New
Sequenced
transaction pool. The pool is an evolution of thelegacy
pool and is likely to be more suitable to enterprise or permissioned chains than thelayered
transaction pool. Select to use this pool with--tx-pool=sequenced
. Supports the same options as thelegacy
pool #6274 - Set Ethereum Classic mainnet activation block for Spiral network upgrade #6267
- Add custom genesis file name to config overview if specified #6297
- Update Gradle plugins and replace unmaintained License Gradle Plugin with the actively maintained Gradle License Report #6275
- Optimize RocksDB WAL files, allows for faster restart and a more linear disk space utilization #6328
- Add a cache on senders by transaction hash #6375
Bug fixes
- Hotfix for selfdestruct preimages on bonsai [#6359]((https://github.com/hyperledger/besu/pull/6359)
- Fix trielog shipping issue during self destruct [#6340]((https://github.com/hyperledger/besu/pull/6340)
- mitigation for trielog failure [#6315]((https://github.com/hyperledger/besu/pull/6315)
Download Links
https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/24.1.0/besu-24.1.0.zip / sha256 d36c8aeef70f0a516d4c26d3bc696c3e2a671e515c9e6e9475a31fe759e39f64 https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/24.1.0/besu-24.1.0.tar.gz / sha256 602b04c0729a7b17361d1f0b39f4ce6a2ebe47932165add666560fe594d9ca99
23.10.3-hotfix
This is a hotfix for a selfdestruct defect that occurred on mainnet at block 18947893
Bug fixes
- Hotfix for selfdestruct preimages on bonsai [#6359]((https://github.com/hyperledger/besu/pull/6359)
- mitigation for trielog failure [#6315]((https://github.com/hyperledger/besu/pull/6315)
Download Links
https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/23.10.3-hotfix/besu-23.10.3-hotfix.zip / sha256 1c37762909858a40eca749fb85b77fb4d1e918f247aff56d518144828bd85378 https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/23.10.3-hotfix/besu-23.10.3-hotfix.tar.gz / sha256 8e38e9fd0c16e049aa324effc96f9ec31dc06e82ea4995e9dd75d571394667af
23.10.3
Additions and Improvements
- Implement debug_traceCall #5885
- Transactions that takes too long to evaluate, during block creation, are dropped from the txpool #6163
- New option
tx-pool-min-gas-price
to set a lower bound when accepting txs to the pool #6098 - Update OpenJDK latest Docker image to use Java 21 #6189
- Allow a transaction selection plugin to specify custom selection results #6190
- Add
rpc-gas-cap
to allow users to set gas limit to the RPC methods used to simulate transactions#6156 - Fix the unavailability of
address
field when returning anAccount
entity on GraphQL in case of unreachable world state #6198 - Update OpenJ9 Docker image to latest version #6226
- Add error messages on authentication failures with username and password #6212
- Add
rocksdb usage
to thestorage
subcommand to allow users and dev to check columns families usage #6185 - Ethereum Classic Spiral network upgrade #6078
- Fix self destruct collision #6205
- Mark deleted storage on cleared #6305
Bug fixes
- Fix Docker image name clash between Besu and evmtool #6194
- Fix
logIndex
ineth_getTransactionReceipt
JSON RPC method #6206
Download Links
https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/23.10.3/besu-23.10.3.zip / sha256 da7ef8a6ceb88d3e327cacddcdb32218d1750b464c14165a74068f6dc6e0871a https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/23.10.3/besu-23.10.3.tar.gz / sha256 73c834cf32c7bbe255d7d8cc7ca5d1eb0df8430b9114935c8dcf3a675b2acbc2
23.10.2
Breaking Changes
- TX pool eviction in the legacy TX pool now favours keeping oldest transactions (more likely to evict higher nonces, less likely to introduce nonce gaps) #6106 and #6146
Deprecations
Additions and Improvements
- Ethereum Classic Spiral network upgrade #6078
- Add a method to read from a
Memory
instance without altering its inner state #6073 - Accept
input
anddata
field for the payload of transaction-related RPC methods #6094 - Add APIs to set and get the min gas price a transaction must pay for being selected during block creation #6097
- TraceService: return results for transactions in block #6086
- New option
--min-priority-fee
that sets the minimum priority fee a transaction must meet to be selected for a block. #6080 #6083 - Implement new
miner_setMinPriorityFee
andminer_getMinPriorityFee
RPC methods #6080 - Clique config option
createemptyblocks
to not create empty blocks #6082 - Upgrade EVM Reference Tests to v13 (Cancun) #6114
- Add
yParity
to GraphQL and JSON-RPC for relevant querise. 6119 - Force tx replacement price bump to zero when zero base fee market is configured or
--min-gas-price
is set to 0. This allows for easier tx replacement in networks where there is not gas price. #6079 - Introduce the possibility to limit the time spent selecting pending transactions during block creation, using the new experimental option
Xblock-txs-selection-max-time
on PoS and PoW networks (by default set to 5000ms) orXpoa-block-txs-selection-max-time
on PoA networks (by default 75% of the min block time) #6044 - Remove LowestInvalidNonceCache from
legacy
transaction pool to make it more private networks friendly #6148 - Optimization: Delete leftPad when capturing the stack before and after a frame execution #6102
Bug fixes
- Upgrade netty to address CVE-2023-44487, CVE-2023-34462 #6100
- Upgrade grpc to address CVE-2023-32731, CVE-2023-33953, CVE-2023-44487, CVE-2023-4785 #6100
- Fix blob gas calculation in reference tests #6107
- Limit memory used in handling invalid blocks #6138
Download Links
https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/23.10.2/besu-23.10.2.zip / sha256: 597ab71898d379180106baf24878239ed49acefea5772344fd359b0ff13fe19f
https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/23.10.2/besu-23.10.2.tar.gz / sha256: 255818a5c6067a38aa8b565d8f32a49a172a7536a1d370673bbb75f548263c2c
23.10.1
Additions and Improvements
- New option
--tx-pool-priority-senders
to specify a list of senders, that has the effect to prioritize any transactions sent by these senders from any source #5959 - Cache last n blocks by using a new Besu flag
--cache-last-blocks=n
#6009 - Optimize performances of RPC method
eth_feeHistory
#6011 #6035 - Logging summary of plugins at Info as part of the config overview #5964 #6049
- Layered tx pool memory improvements #5985 #5974
- Update Bouncy Castle to 1.76, and force the use of the
jdk18on
variant #5748 - Add GraphQL support for new fields in Cancun #5923 #5975
- Add new configuration options to the EVM Fluent APIs #5930
Deprecations
--tx-pool-disable-locals
has been deprecated for removal in favor of--tx-pool-no-local-priority
, no semantic change, only a renaming #5959
Bug Fixes
- Fix regression with t8n tool filling #5979
- Fix EOF and EIP-4788 regressions in reference tests #6060
Download Links
https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/23.10.1/besu-23.10.1.tar.gz / sha256: e27645f345583f3ee447e5418302382c6f8335d2da8707bdd20033aabd86ce4c
https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/23.10.1/besu-23.10.1.zip / sha256: fb173acb93c72fbb74a6542051691ca2d3d5f54ea2f51026467a512f3a22106b
23.10.0
Layered Transaction Pool: the new default transaction pool implementation
With this release the previously experimental Layered txpool is marked stable and enabled by default, so please read the following instructions if you used to tune txpool behaviour, otherwise you can simply go with the default and enjoy the improved performance of the new txpool.
Upgrading to Layered Transaction Pool
If you do not specify any txpool option, then you can skip this section.
If you have tuned the txpool using one of these options: tx-pool-retention-hours
, tx-pool-limit-by-account-percentage
or tx-pool-max-size
,
then you need to update your configuration as described below:
tx-pool-retention-hours
: simply remove it, since it is not applicable in the Layered txpool, old transactions will eventually expire when the memory cache is full.tx-pool-limit-by-account-percentage
: replace it withtx-pool-max-future-by-sender
, which specify the max number of sequential transactions of single sender are kept in the txpool, by default it is 200.tx-pool-max-size
: the Layered txpool is not limited by a max number of transactions, but by the estimated memory size the transactions occupy, so you need to remove this option, and to tune the max amount of memory* use the new optiontx-pool-layer-max-capacity
as described below.
You can still opt-out of the Layered txpool, setting tx-pool=legacy
in config file or via cli argument, but be warned that the Legacy implementation will be deprecated for removal soon, so start testing the new implementation.
Configuring the Layered Transaction Pool
By default, the txpool is tuned for mainnet usage, but if you are using private networks or want to otherwise tune it, these are the new options:
tx-pool-max-future-by-sender
: specify the max number of sequential transactions of a single sender are kept in the txpool, by default it is 200, increase it to allow a single sender to fit more transactions in a single block. For private networks, this can safely be set in the hundreds or thousands if you want to ensure future transactions (with large nonce gaps) remain in the pool.tx-pool-layer-max-capacity
: set the max amount of memory* in bytes, a single memory limited layer can occupy, by default is 12.5MB, keep in mind that there are 2 memory limited layers, so the expected memory consumption is twice the value specified by this option, so 25MB by default. Increase this value if you have spare RAM and the eviction rate is high for your network.tx-pool-max-prioritized
: set the max number of transactions allowed in the first layer, that only contains transactions that are candidate for inclusion in the next block creation task. It makes sense to limit the value to the max number of transactions that fit in a block in your network, by default is 2000.
*: the memory used by the txpool is an estimation, we are working to make it always more accurate.
Breaking Changes
- Removed support for Kotti network (ETC) #5816
- Layered transaction pool implementation is now stable and enabled by default, so the following changes to experimental options have been done #5772:
--Xlayered-tx-pool
is gone, to select the implementation use the new--tx-pool
option with valueslayered
(default) orlegacy
--Xlayered-tx-pool-layer-max-capacity
,--Xlayered-tx-pool-max-prioritized
and--Xlayered-tx-pool-max-future-by-sender
just drop theXlayered-
and keep the same behavior
Additions and Improvements
- Add access to an immutable world view to start/end transaction hooks in the tracing API#5836
- Layered transaction pool implementation is now stable and enabled by default. If you want still to use the legacy implementation, use
--tx-pool=legacy
. By default, the new transaction pool is capped at using 25MB of memory, this limit can be raised using--layered-tx-pool-layer-max-capacity
options #5772 - Tune G1GC to reduce Besu memory footprint, and new
besu-untuned
start scripts to run without any specific G1GC flags #5879 - Reduce
engine_forkchoiceUpdatedV?
response time by asynchronously process block added events in the transaction pool #5909
Bug Fixes
- do not create ignorable storage on revert storage-variables subcommand #5830
- fix duplicate key errors in EthScheduler-Transactions #5857
- Don't put control characters, escaped or otherwise, in t8n stacktraces #5910
Download Links
https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/23.10.0/besu-23.10.0.tar.gz / sha256: 3c75f3792bfdb0892705b378f0b8bfc14ef6cecf1d8afe711d8d8687ed6687cf https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/23.10.0/besu-23.10.0.zip / sha256: d5dafff4c3cbf104bf75b34a9f108dcdd7b08d2759de75ec65cd997f38f52866
23.7.3
Additions and Improvements
- Update Holešky config for re-launch #5890
Download Links
https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/23.7.3/besu-23.7.3.tar.gz / sha256: c12ca6a9861557e0bf8f27076f8c8afcce6f1564687e5f02bfdc96c2b18846ff https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/23.7.3/besu-23.7.3.zip / sha256: 136596454f647c706130e3e2983bdbb4a1cbfaf2bbf6e999466754f9213c11f6
23.7.2
Additions and Improvements
- Add new methods to
OperationTracer
to capture contexts enter/exit #5756 - Add Holešky as predefined network name #5797
Breaking Changes
- Add ABI-decoded revert reason to
eth_call
andeth_estimateGas
responses #5705
Additions and Improvements
- Add missing methods to the
Transaction
interface #5732 - Add
benchmark
subcommand toevmtool
#5754 - JSON output is now compact by default. This can be overridden by the new
--json-pretty-print-enabled
CLI option. #5766 - New
eth_getBlockReceipts
JSON-RPC method to retrieve all transaction receipts for a block in a single call #5771 - Add new methods to
OperationTracer
to capture contexts enter/exit #5756
Bug Fixes
- Make smart contract permissioning features work with london fork #5727
- Add type to PendingTransactionDetail, fix eth_subscribe #5729
- EvmTool "run" mode did not reflect contracts created within the transaction. #5755
- Fixing snapsync issue with forest during the heal step #5776
Download Links
https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/23.7.2/besu-23.7.2.tar.gz / sha256: f74b32c1a343cbad90a88aa59276b4c5eefea4643ee542aba2bbf898f85ae242 https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/23.7.2/besu-23.7.2.zip / sha256: a233c83591fc277e3d1530c84bb5ea896abad717d796b5e3b856c79199132b75
23.7.1
Breaking Changes
- Removed deprecated GoQuorum permissioning interop #5607
- Removed support for version 0 of the database as it is no longer used by any active node. #5698
Additions and Improvements
evmtool
launcher binaries now ship as part of the standard distribution. #5701- EvmTool now executes the
execution-spec-tests
via thet8n
andb11r
. See the README in EvmTool for more instructions. - Improve lifecycle management of the transaction pool #5634
- Add extension points in AbstractCreateOperation for EVM libraries to react to contract creations #5656
- Update to Tuweni 2.4.2. #5684
- Decouple data field from Enum JsonRpcError by creating new enum holder RpcErrorType#5629
- Update to bouncycastle 1.75 #5675
- Extend OperationTracer with new methods #5662
- Eip 6780 selfdestruct #5430
- Add new debug_getRawTransaction to the DEBUG engine #5635
Bug Fixes
- Use the node's configuration to determine if DNS enode URLs are allowed in calls to
admin_addPeer
andadmin_removePeer
#5584 - Align the implementation of Eth/68
NewPooledTransactionHashes
to other clients, using unsigned int for encoding size. #5640 - Failure at startup when enabling layered txpool before initial sync done #5636
- Remove miner-related option warnings if the change isn't using Ethash consensus algorithm #5669
- Fix for pending transactions reference leak #5693
- Address a performance regression observed in import testing #5734
- Update native libraries that have JPMS friendly module names #5749
Download Links
https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/23.7.1/besu-23.7.1.tar.gz / sha256: 85dce66c2dbd21b4e5d3310770434dd373018a046b78d5037f6d4955256793cd https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/23.7.1/besu-23.7.1.zip / sha256: dfac11b2d6d9e8076ab2f86324d48d563badf76fd2a4aadc4469a97aef374ef5
23.7.0
- Was not released (failed burn-in test)
23.4.4
Breaking Changes
- Move blockchain related variables in a dedicated storage, to pave the way to future optimizations #5471. The migration is performed automatically at startup,
and in case a rollback is needed, before installing a previous version, the migration can be reverted, using the subcommand
storage revert-variables
with the same configuration use to run Besu. - Remove deprecated Rinkeby named network. #5540
- Use BlobDB for blockchain storage to reduce initial sync time and write amplification (PR #5475). This PR reduces sync time by 14 hours on m6a.xlarge VM (1 day 8 hours 27 minutes instead of 1 day 22 hours 4 minutes).
Additions and Improvements
- Allow Ethstats connection url to specify ws:// or wss:// scheme. #5494
- Add support for Shanghai changes to the GraphQL service #5496
- Unite the tx-pool CLI options under the same Tx Pool Options group in UX. #5466
- Tidy DEBUG logs by moving engine API full logging to TRACE #5529
- Remove PoW validation if merge is enabled as it is not needed any more #5538
- Use BlobDB for blockchain storage to reduce initial sync time and write amplification #5475
- Add healing flat db mechanism with early access CLI options
--Xsnapsync-synchronizer-flat-db-healing-enabled=true
#5319 - Add debug_getRawTransaction method to the DEBUG suite #5635
Bug Fixes
- Fix backwards sync bug where chain is rolled back too far, especially when restarting Nimbus #5497
- Check to ensure storage and transactions are not closed prior to reading/writing #5527
- Fix the unavailability of account code and storage on GraphQL/Bonsai #5548
Download Links
https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/23.4.4/besu-23.4.4.tar.gz / sha256: bd476d235b6fe1f236a62bc709f41c87deb68b72c47bb5b58e56b9d9283af2c4 https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/23.4.4/besu-23.4.4.zip / sha256: 4575000f4fd21d318e7b77340c9281d496bc800bee5b45a13684319e6f28bf27
23.4.3
-
Was not released (failed burn-in test)
-
23.4.2
-
Was not released (failed burn-in test)
23.4.1
Breaking Changes
- Add request content length limit for the JSON-RPC API (5MB) #5467
min-block-occupancy-ratio
options is now ignored on PoS networks #5491
Additions and Improvements
- Set the retention policy for RocksDB log files to maintain only the logs from the last week #5428
- "Big-EOF" (the EOF version initially slotted for Shanghai) has been moved from Cancun to FutureEIPs #5429
- EIP-4844: Zero blob transactions are invalid #5425
- Transaction pool flag to disable specific behaviors for locally submitted transactions #5418
- Added In-Protocol Deposit prototype (EIP-6110) in the experimental eip. #5005 #5295
- New optional feature to save the txpool content to file on shutdown and reloading it on startup #5434
- New option to send SNI header in TLS ClientHello message #5439
- Early access - layered transaction pool implementation #5290
- New RPC method
debug_getRawReceipts
#5476 - Add TrieLogFactory plugin support #5440
- Ignore
min-block-occupancy-ratio
option when on PoS networks, since in some cases, it prevents to have full blocks even if enough transactions are present #5491
Bug Fixes
- Fix eth_feeHistory response for the case in which blockCount is higher than highestBlock requested. #5397
- Fix Besu Docker image failing to start due to NoClassDefFoundError with org.xerial.snappy.Snappy library. #5462
Download Links
https://hyperledger.jfrog.io/hyperledger/besu-binaries/besu/23.4.1/besu-23.4.1.tar.gz / sha256: 49d3a7a069cae307497093d834f873ce7804a46dd59207d5e8321459532d318e https://hyperledger.jfrog.io/hyperledger/besu-binaries/besu/23.4.1/besu-23.4.1.zip / sha256: 1d82ed83a816968aa9366d9310b275ca6438100f5d3eb1ec03d3474b2a5f5e76
23.4.0
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 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
- Besu now requires glibc 2.32 or later to run. Ubuntu 20.04 users will need to update to a newer version of Ubuntu, 22.04 or later to run Besu
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 inethereum/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.
- 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
- Re-implement trace_block, trace_filter and trace_replayBlockTransactions RPC endpoints to fix memory issues and improve performance #5131
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 - 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
This update is a mainnet-compatible Shanghai/Capella upgrade and is recommended for all Mainnet users.
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
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 https://github.com/hyperledger/besu/pull/5088
- Add implementation for engine_getPayloadBodiesByRangeV1 and engine_getPayloadBodiesByHashV1 https://github.com/hyperledger/besu/pull/4980
- If a PoS block creation repetition takes less than a configurable duration, then waits before next repetition https://github.com/hyperledger/besu/pull/5048
- Allow other users to read the /opt/besu dir when using docker https://github.com/hyperledger/besu/pull/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 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 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 https://github.com/hyperledger/besu/pull/5088
- Add implementation for engine_getPayloadBodiesByRangeV1 and engine_getPayloadBodiesByHashV1 https://github.com/hyperledger/besu/pull/4980
- If a PoS block creation repetition takes less than a configurable duration, then waits before next repetition https://github.com/hyperledger/besu/pull/5048
- Allow other users to read the /opt/besu dir when using docker https://github.com/hyperledger/besu/pull/5092
- Invalid params - add some error detail #5066
Bug fixes
- Fix engine_getPayloadV2 block value calculation https://github.com/hyperledger/besu/issues/5040
- Moves check for init code length before balance check https://github.com/hyperledger/besu/pull/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
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
andfinalized
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 versi on 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
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
andfinalized
strings for the RPC methods using defaultBlock parameter #4902
Bug Fixes
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
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
- 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
- Fix for segmentation faults on worldstate truncation, snap-sync starts #4786
- Fix for worldstate mismatch on failed forkchoiceUpdate #4862
Download Links
22.10.3
Breaking Changes
- Added
--rpc-max-logs-range
CLI option to allow limiting the number of blocks queried byeth_getLogs
RPC API. Default value: 1000 #4597 - The
graalvm
docker variant no longer meets the performance requirements for Ethereum Mainnet. Theopenjdk-11
andopenjdk-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
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
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
Breaking Changes
- Fields
publicKey
andraw
removed from RPC APITransaction
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
Breaking Changes
- Internal and interface APIs relating to storage have migrated from
UInt256
toBytes32
#4562 - 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
- Before this change, the
--tx-pool-hashes-max-size
option removed (deprecated in 22.1.3)--Xmerge-support
option removed (deprecated in 22.4.2) #4518- Breaking API changes in the
OperationTracer
interface to enable performance work.- The
traceExecution
method has been replaced withtracePreExecution
andtracePostExecution
methods, called just before and just after operation execution. - See
DebugOperationTracer
andStandardJsonTracer
for migration examples.
- The
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
22.10.0-RC2
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
- Before this change, the
--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 withtracePreExecution
andtracePostExecution
methods, called just before and just after operation execution. - See
DebugOperationTracer
andStandardJsonTracer
for migration examples.
- The
Additions and Improvements
- 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 experimental 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
Bug Fixes
- 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
22.10.0-RC1
Additions and Improvements
- 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
Download Links
https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/22.10.0-RC1/besu-22.10.0-RC1.zip / sha256: 16fd47533aa2986491143e5f4a052c0aa4866ebfa415abbf3ca868e4fbeac6ce https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/22.10.0-RC1/besu-22.10.0-RC1.tar.gz / sha256: 48fd3480e4380580ed9187302be987e9eca2b445935ec6a509e7269898d8a4a8
22.7.7
Additions and Improvements
- Tune EthScheduler thread pools to avoid recreating too many threads #4529
- Reduce the number of runtime exceptions (SecurityModuleException) and unnecessary executions during ECIES handshake, by trying to decrypt EIP-8 formatted messages first #4508.
- The block variable was keeping too much memory while waiting for future to finish #4489
Bug Fixes
- Corrects treating a block as bad on internal error #4512
- update appache-commons-text to 1.10.0 to address CVE-2022-42889 #4542
- In GraphQL update scalar parsing to be variable friendly #4522
Download Links
https://hyperledger.jfrog.io/hyperledger/besu-binaries/besu/22.7.7/besu-22.7.7.zip / sha256: 79b2b1518605603d8268f873f2576617ca8340d89c045e0eda6896f40defea0d https://hyperledger.jfrog.io/hyperledger/besu-binaries/besu/22.7.7/besu-22.7.7.tar.gz / sha256: 161c52ba9be8508767e80dbce796b4ad2cc5b649f7ed15387c6359d1e15753f6
22.7.6
Hotfix release of the 22.7.x series to address #4495 which could result in failed block proposals on merge networks.
Additions and Improvements
- Bring GraphQL into compliance with execution-api specs #4112
Bug Fixes
- Corrects emission of blockadded events when rewinding during a re-org. #4497
Download Links
https://hyperledger.jfrog.io/hyperledger/besu-binaries/besu/22.7.6/besu-22.7.6.zip / sha256: ae05040027b96ba458a08cfee8577dafe1d85a3afce793f00f798cedb3ab547d https://hyperledger.jfrog.io/hyperledger/besu-binaries/besu/22.7.6/besu-22.7.6.tar.gz / sha256: 9e538852f16fd39b884c4c342beaad813e33ab24890634c01eee3d37dc1da893
22.7.5
Additions and Improvements
- Avoid sending added block events to transaction pool, and processing incoming transactions during initial sync #4457
- When building a new proposal, keep the best block built until now instead of the last one #4455
- Add Mainnet to merged networks #4463
Bug Fixes
- Fixed logIndex value returned by eth_getLogs RPC call #4355
Download Links
https://hyperledger.jfrog.io/hyperledger/besu-binaries/besu/22.7.5/besu-22.7.5.zip / sha256: b5d7b255b249beea0f46ec397122823c75f2373083a71a9f7b4c98b2b0f94997 https://hyperledger.jfrog.io/hyperledger/besu-binaries/besu/22.7.5/besu-22.7.5.tar.gz / sha256: 91e3cbc16c46c53f7bf55bdd968553d0fb4087bff1e244cb03ac175ac54cf718
22.7.4
Bug Fixes
- Remove records that track transactions by sender when they are empty to same memory in the transaction pool #4415
- Add Toml configuration file support for --Xplugin-rocksdb-high-spec-enabled flag #4438
Download Links
- https://hyperledger.jfrog.io/hyperledger/besu-binaries/besu/22.7.4/besu-22.7.4.zip / sha256: 4f2a0c20bee7f266ec1dcb45fa90ae1ca42f4b22e9b21a601b7705357259aea9
- https://hyperledger.jfrog.io/hyperledger/besu-binaries/besu/22.7.4/besu-22.7.4.tar.gz / sha256: a60efc4d515ac94710bbc6d61a24f409b03fcfc02323bee2a2d75c883fc99dce
22.7.3
Additions and Improvements
- Allow free gas networks in the London fee market #4061
- Upgrade besu-native to 0.6.0 and use Blake2bf native implementation if available by default #4264
- Resets engine QoS timer with every call to the engine API instead of only when ExchangeTransitionConfiguration is called #4411
- ExchangeTransitionConfiguration mismatch will only submit a debug log not a warning anymore #4411
- Upgrade besu-native to 0.6.1 and include linux arm64 build of bls12-381 #4416
- Create a new flag on RocksDB (--Xplugin-rocksdb-high-spec-enabled) for high spec hardware to boost performance
- Transaction pool improvements to avoid filling the pool with not executable transactions, that could result in empty or semi-empty block proposals #4425
- Limit Transaction pool consumption by sender to a configurable percentage of the pool size #4417
Bug Fixes
- Retry block creation if there is a transient error and we still have time, to mitigate empty block issue #4407
- Fix StacklessClosedChannelException in Besu and resulted timeout errors in CL clients (#4398, #4400)
- Return JSON-RPC error code instead of INVALID in engine api when certain storage exceptions are encountered (#4349)
Download links
- https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/22.7.3/besu-22.7.3.tar.gz / sha256:
b0863fe2406cab57caf8a02f2bf02632cc5198622ac48b69bc63c128703bbd79
- https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/22.7.3/besu-22.7.3.zip / sha256:
368c6cb86119f8fe30bb12ab8c63b4d95a0fd8baf9c9414307a0a4033756b709
22.7.2
Besu 22.7.2 is a recommended release for the Merge and Mainnet users. 22.7.1 remains Merge-ready. This release provides additional robustness before the Merge with some fixes and improvements in sync, peering, and logging.
Additions and Improvements
- Better management of jemalloc presence/absence in startup script #4237
- Retry mechanism when getting a broadcasted block fail on all peers #4271
- Filter out disconnected peers when fetching available peers #4269
- Updated the default value of fast-sync-min-peers post merge #4298
- Log imported block info post merge #4310
- Transaction pool eviction by sender from tail of transaction list #4327
- Transaction pool sender future nonce limits #4336
- Pandas! Pandas now appear in 3 phases: The black bear and polar bear that are preparing? Those will appear when your client has TTD configured (which is setup by default for mainnet), is in sync, and processing Proof of Work blocks. In the second phase you will see them powering up when the Terminal Total Difficulty block is added to the blockchain. The final form of the Ethereum Panda will appear when the first finalized block is received from the Consensus Layer.
Bug Fixes
- Accept wit/80 from Nethermind #4279
- Properly shutdown the miner executor, to avoid waiting 30 seconds when stopping #4353
Download links
- https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/22.7.2/besu-22.7.2.tar.gz / sha256:
8030a48f824c7bbc138b38a9e84e5531950bc16f6d21cda8b215232cce334214
- https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/22.7.2/besu-22.7.2.zip / sha256:
72653171b1ddd910e705fc6f616d7f1f4c120ef0d91718f0376f3ee5f2982c11
22.7.1
Merge Ready Release. Required update for The Merge on ethereum mainnet!
Additions and Improvements
- Introduce a cap to reputation score increase #4230
- Add experimental CLI option for
--Xp2p-peer-lower-bound
#4200 - Improve pending blocks retrieval mechanism #4227
- Set mainnet terminal total difficulty #4260
Bug Fixes
- Fixes off-by-one error for mainnet TTD fallback #4223
- Fix off-by-one error in AbstractRetryingPeerTask #4254
- Refactor and fix retrying get block switching peer #4256
- Fix encoding of key (short hex) in eth_getProof #4261
- Fix for post-merge networks fast-sync #4224, #4276
Download links
- https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/22.7.1/besu-22.7.1.tar.gz / sha256:
7cca4c11e1d7525c172f2af9fbf456d134ada60e970d8b6abcfcd6c623b5dd36
- https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/22.7.1/besu-22.7.1.zip / sha256:
ba6e0b9b65ac36d041a5072392f119ff76e8e9f53a3d7b1e1a658ef1e4705d7a
22.7.0
Additions and Improvements
- Deprecation warning for Ropsten, Rinkeby, Kiln #4173
Bug Fixes
- Fixes previous known issue #3890from RC3 requiring a restart post-merge to continue correct transaction handling.
- Stop producing stack traces when a get headers response only contains the range start header #4189
- Upgrade Spotless to 6.8.0 #4195
- Upgrade Gradle to 7.5 #4196
Download links
- https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/22.7.0/besu-22.7.0.tar.gz / sha256:
af21104a880c37706b660aa816e1c38b2b3f603a97420ddcbc889324b71aa50e
- https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/22.7.0/besu-22.7.0.zip / sha256:
5b1586362e6e739c206c25224bb753a372bad70c0b22dbe091f9253024ebdc45
22.7.0-RC3
Known/Outstanding issues:
- Besu requires a restart post-merge to re-enable remote transaction processing #3890
Additions and Improvements
- Engine API: Change expiration time for JWT tokens to 60s #4168
- Sepolia mergeNetSplit block #4158
- Goerli TTD #4160
- Several logging improvements
Bug Fixes
- Allow to set any value for baseFeePerGas in the genesis file #4177
- Fix for stack overflow when searching for TTD block #4169
- Fix for chain stuck issue #4175
Download links
- https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/22.7.0-RC3/besu-22.7.0-RC3.tar.gz / sha256:
6a1ee89c82db9fa782d34733d8a8c726670378bcb71befe013da48d7928490a6
- https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/22.7.0-RC3/besu-22.7.0-RC3.zip / sha256:
5de22445ab2a270cf33e1850cd28f1946442b7104738f0d1ac253a009c53414e
22.7.0-RC2
Additions and Improvements
- Add a block to the bad blocks if it did not descend from the terminal block #4080
- Backward sync exception improvements #4092
- Remove block header checks during backward sync, since they will be always performed during block import phase #4098
- Optimize the backward sync retry strategy #4095
- Add support for jemalloc library to better handle rocksdb memory consumption #4126
- RocksDB configuration changes to improve performance. #4132
Bug Fixes
- Changed max message size in the p2p layer to 16.7MB from 10MB to improve peering performance #4120
- Fixes for parent stateroot mismatch when using Bonsai storage mode (please report if you encounter this bug on this version) #4094
- Above Bonsai related fixes have addressed situations where the event log was not indexed properly #3921
- Fixes related to backward sync and reorgs #4097
- Checkpoint sync with more merge friendly checkpoint blocks #4085
- Fixes around RocksDB performance and memory usage #4128
- Fix for RPC performance parallelization to improve RPC performance under heavy load #3959
- Fix for post-Merge peering after PoW is removed in our logic for weighting peers #4116
- Various logging changes to improve UX- Return the correct latest valid hash in case of bad block when calling engine methods #4056
- Add a PoS block header rule to check that the current block is more recent than its parent #4066
- Fixed a trie log layer issue on bonsai during reorg #4069
- Fix transition protocol schedule to return the pre Merge schedule when reorg pre TTD #4078
- Remove hash to sync from the queue only if the sync step succeeds #4105
- The build process runs successfully even though the system language is not English #4102
- Avoid starting or stopping the BlockPropagationManager more than once #4122
Download links
- https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/22.7.0-RC2/besu-22.7.0-RC2.tar.gz / sha256:
befe15b893820c9c6451a74fd87b41f555ff28561494b3bebadd5da5c7ce25d3
- https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/22.7.0-RC2/besu-22.7.0-RC2.zip / sha256:
d56c340f5982b882fbecca2697ca72a5bbefe0e978d2d4504211f012e2242a81
22.7.0-RC1
Additions and Improvements
- Do not require a minimum block height when downloading headers or blocks #3911
- When on PoS the head can be only be updated by ForkchoiceUpdate #3994
- Version information available in metrics #3997
- Add TTD and DNS to Sepolia config #4024
- Return
type
with value0x0
when serializing legacy transactions #4027 - Ignore
ForkchoiceUpdate
ifnewHead
is an ancestor of the chain head #4055
Bug Fixes
- Fixed a snapsync issue that can sometimes block the healing step #3920
- Support free gas networks in the London fee market #4003
- Limit the size of outgoing eth subprotocol messages. #4034
- Fixed a state root mismatch issue on bonsai that may appear occasionally #4041
Download links
- https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/22.7.0-RC1/besu-22.7.0-RC1.tar.gz / sha256:
60ad8b53402beb62c24ad791799d9cfe444623a58f6f6cf1d0728459cb641e63
- https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/22.7.0-RC1/besu-22.7.0-RC1.zip / sha256:
7acfb3a73382bf70f6337e83cb7e9e472b4e5a9da88c5ed2fbd9e82fcf2046dc
22.4.3
Additions and Improvements
- [EXPERIMENTAL] Add checkpoint sync
--sync-mode="X_CHECKPOINT"
#3849 - Support
finalized
andsafe
as tags for the block parameter in RPC APIs #3950 - Added verification of payload attributes in ForkchoiceUpdated #3837
- Add support for Gray Glacier hardfork #3961
Bug Fixes
- alias engine-rpc-port parameter with the former rpc param name #3958
22.4.2
Additions and Improvements
- Engine API Update: Replace deprecated INVALID_TERMINAL_BLOCK with INVALID last valid hash 0x0 #3882
- Deprecate experimental merge flag and engine-rpc-enabled flag #3875
- Update besu-native dependencies to 0.5.0 for linux arm64 support
- Update ropsten TTD to 100000000000000000000000
Bug Fixes
- Stop backward sync if genesis block has been reached #3869
- Allow to backward sync to request headers back to last finalized block if present or genesis #3888
Download link
- https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/22.4.2/besu-22.4.2.zip / sha256:
e8e9eb7e3f544ecefeec863712fb8d3f6a569c9d70825a4ed2581c596db8fd45
- https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/22.4.2/besu-22.4.2.tar.gz / sha256:
9db0c37440cb56bcf671b8de13e0ecb6235171a497bdad91020b8c4a9dac2a27
22.4.1
Additions and Improvements
- GraphQL - allow null log topics in queries which match any topic #3662
- multi-arch docker builds for amd64 and arm64 #2954
- Filter Netty native lib errors likewise the pure Java implementation #3807
- Add ropsten terminal total difficulty config #3871
Bug Fixes
- Stop the BlockPropagationManager when it receives the TTD reached event #3809
- Correct getMixHashOrPrevRandao to return the value present in the block header #3839
22.4.0
Breaking Changes
- Version 22.4.x will be the last series to support Java 11. Version 22.7.0 will require Java 17 to build and run.
- In the Besu EVM Library all references to SHA3 have been renamed to the more accurate name Keccak256, including class names and comment. #3749
- Removed the Gas object and replaced it with a primitive long #3674
- Column family added for backward sync #3638
- Note that this added column family makes this a one-way upgrade. That is, once you upgrade your db to this version, you cannot roll back to a previous version of Besu.
Bug Fixes
- Fix nullpointer on snapsync #3773
- Introduce RocksDbSegmentIdentifier to avoid changing the storage plugin #3755
Download Links
- https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/22.4.0/besu-22.4.0.zip / SHA256 d89e102a1941e70be31c176a6dd65cd5f3d69c4c
- https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/22.4.0/besu-22.4.0.tar.gz / SHA256 868e38749dd40debe028624f8267f1fce7587010
22.4.0-RC2
Breaking Changes
- In the Besu EVM Library all references to SHA3 have been renamed to the more accurate name Kecack256, including class names and comment. #3749
Additions and Improvements
- Onchain node permissioning
- [EXPERIMENTAL] Add snapsync
--sync-mode="X_SNAP"
(only as client) #3710 - Adapt Fast sync, and Snap sync, to use finalized block, from consensus layer, as pivot after the Merge #3506
- Add IPC JSON-RPC interface (BSD/MacOS and Linux only) #3695
- Column family added for backward sync #3638
- Note that this added column family makes this a one-way upgrade. That is, once you upgrade your db to this version, you cannot roll back to a previous version of Besu.
Download Links
- https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/22.4.0-RC2/besu-22.4.0-RC2.zip / SHA256 5fa7f927c6717ebf503291c058815cd0c5fcfab13245d3b6beb66eb20cf7ac24
- https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/22.4.0-RC2/besu-22.4.0-RC2.tar.gz / SHA256 1c4ecd17552cf5ebf120fc35dad753f45cb951ea0f817381feb2477ec0fff9c9
22.4.0-RC1
Additions and Improvements
- Unit tests are now executed with JUnit5 #3620
- Removed the Gas object and replaced it with a primitive long [#3674]
Bug Fixes
- Flexible Privacy Precompile handles null payload ID #3664
- Subcommand blocks import throws exception #3646
Download Links
- https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/22.4.0-RC1/besu-22.4.0-RC1.zip / SHA256 0779082acc20a98eb810eb08778e0c0e1431046c07bc89019a2761fd1baa4c25
- https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/22.4.0-RC1/besu-22.4.0-RC1.tar.gz / SHA256 15d8b0e335f962f95da46864109db9f28ed4f7bc351995b2b8db477c12b94860
22.1.3
Breaking Changes
- Remove the experimental flag for bonsai tries CLI options
--data-storage-format
and--bonsai-maximum-back-layers-to-load
#3578 - Column family added for backward sync #3532
- Note that this added column family makes this a one-way upgrade. That is, once you upgrade your db to this version, you cannot roll back to a previous version of Besu.
Deprecations
--tx-pool-hashes-max-size
is now deprecated and has no more effect, and it will be removed in a future release.
Additions and Improvements
- Tune transaction synchronization parameter to adapt to mainnet traffic #3610
- Improve eth/66 support #3616
- Avoid reprocessing remote transactions already seen #3626
- Upgraded jackson-databind dependency version #3647
Download Links
- https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/22.1.3/besu-22.1.3.zip / SHA256 9dafb80f2ec9ce8d732fd9e9894ca2455dd02418971c89cd6ccee94c53354d5d
- https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/22.1.3/besu-22.1.3.tar.gz / SHA256 f9f8d37353aa4b5d12e87c08dd86328c1cffc591c6fc9e076c0f85a1d4663dfe
22.1.2
Additions and Improvements
- Execution layer (The Merge):
- Execution specific RPC endpoint #3378
- Adds JWT authentication to Engine APIs
- Supports kiln V2.1 spec
- Tracing APIs
- new API methods: trace_rawTransaction, trace_get, trace_callMany
- added revertReason to trace APIs including: trace_transaction, trace_get, trace_call, trace_callMany, and trace_rawTransaction
- Allow mining beneficiary to transition at specific blocks for ibft2 and qbft consensus mechanisms. #3115
- Return richer information from the PrecompiledContract interface. #3546
Bug Fixes
- Reject locally-sourced transactions below the minimum gas price when not mining. #3397
- Fixed bug with contract address supplied to
debug_accountAt
#3518
Download Links
- https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/22.1.2/besu-22.1.2.zip / SHA256 1b26e3f8982c3a9dbabc72171f83f1cfe89eef84ead45b184ee9101f411c1251
- https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/22.1.2/besu-22.1.2.tar.gz / SHA256 1eca9abddf351eaaf4e6eaa1b9536b8b4fd7d30a81d39f9d44ffeb198627ee7a
22.1.1
Additions and Improvements
- Allow optional RPC methods that bypass authentication #3382
- Execution layer (The Merge):
- Extend block creation and mining to support The Merge #3412
- Backward sync #3410
- Extend validateAndProcessBlock to return an error message in case of failure, so it can be returned to the caller of ExecutePayload API #3411
- Persist latest finalized block #2913
- Add PostMergeContext, and stop syncing after the switch to PoS #3453
- Add header validation rules needed to validate The Merge blocks #3454
- Add core components: controller builder, protocol scheduler, coordinator, block creator and processor. #3461
- Execution specific RPC endpoint #2914, #3350
- QBFT consensus algorithm is production ready
Download Links
- https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/22.1.1/besu-22.1.1.zip / SHA256 cfff79e19e5f9a184d0b62886990698b77d019a0745ea63b5f9373870518173e
- https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/22.1.1/besu-22.1.1.tar.gz / SHA256 51cc9d35215f977ac7338e5c611c60f225fd6a8c1c26f188e661624a039e83f3
22.1.0
Breaking Changes
- Plugin API: BlockHeader.getBaseFee() method now returns an optional Wei instead of an optional Long #3065
- Removed deprecated hash variable
protected volatile Hash hash;
which was used for private transactions #3110
Additions and Improvements
- Add support for additional JWT authentication algorithms #3017
- Represent baseFee as Wei instead of long accordingly to the spec #2785
- Implements EIP-4399 to repurpose DIFFICULTY opcode after the merge as a source of entropy from the Beacon chain. #3081
- Re-order external services (e.g JsonRpcHttpService) to start before blocks start processing #3118
- Stream JSON RPC responses to avoid creating big JSON strings in memory #3076
- Ethereum Classic Mystique Hard Fork #3256
- Genesis file parameter
blockperiodseconds
is validated as a positive integer on startup to prevent unexpected runtime behaviour #3186 - Add option to require replay protection for locally submitted transactions #1975
- Update to block header validation for IBFT and QBFT to support London fork EIP-1559 #3251
- Move into SLF4J as logging facade #3285
- Changing the order in which we traverse the word state tree during fast sync. This should improve fast sync during subsequent pivot changes.#3202
- Updated besu-native to version 0.4.3 #3331
- Refactor synchronizer to asynchronously retrieve blocks from peers, and to change peer when retrying to get a block. #3326
- Disable RocksDB TTL compactions #3356
- add a websocket frame size configuration CLI parameter #3386
- Add
--ec-curve
parameter to export/export-address public-key subcommands #3333
Bug Fixes
- Change the base docker image from Debian Buster to Ubuntu 20.04 #3171 fixes #3045
- Make 'to' field optional in eth_call method according to the spec #3177
- Update to log4j 2.17.1. Resolves potential vulnerability only exploitable when using custom log4j configurations that are writable by untrusted users.
- Fix regression on cors-origin star value
- Fix for ethFeeHistory accepting hex values for blockCount
- Fix a sync issue, when the chain downloader incorrectly shutdown when a task in the pipeline is cancelled. #3319
- add a websocket frame size configuration CLI parameter [3368][https://github.com/hyperledger/besu/pull/3379]
- Prevent node from peering to itself #3342
- Fix an
IndexOutOfBoundsException
exception when getting block from peers. #3304 - Handle legacy eth64 without throwing null pointer exceptions #3343
Download Links
- https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/22.1.0/besu-22.1.0.tar.gz \ SHA256 232bd7f274691ca14c26289fdc289d3fcdf69426dd96e2fa1601f4d079645c2f
- https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/22.1.0/besu-22.1.0.zip \ SHA256 1b701ff5b647b64aff3d73d6f1fe3fdf73f14adbe31504011eff1660ab56ad2b
21.10.9
Bug Fixes
- Fix regression on cors-origin star value
- Fix for ethFeeHistory accepting hex values for blockCount
Full Changelog: https://github.com/hyperledger/besu/compare/21.10.8...21.10.9
besu-21.10.9.tar.gz a4b85ba72ee73017303e4b2f0fdde84a87d376c2c17fdcebfa4e34680f52fc71 besu-21.10.9.zip c3ba3f07340fa80064ba7c06f2c0ec081184e000f9a925d132084352d0665ef9
21.10.8
Additions and Improvements
- Ethereum Classic Mystique Hard Fork #3256
Download Links
https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/21.10.8/besu-21.10.8.tar.gz \ SHA256 d325e2e36bc38a707a9eebf92068f5021606a8c6b6464bb4b4d59008ef8014fc https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/21.10.8/besu-21.10.8.zip \ SHA256 a91da1e82fb378e16437327bba56dd299aafdb0614ba528167a1dae85440c5af
21.10.7
Bug Fixes
- Update dependencies (including vert.x, kubernetes client-java, okhttp, commons-codec)
Additions and Improvements
- Add support for additional JWT authentication algorithms #3017
- Remove Orion ATs
Download Links
https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/21.10.7/besu-21.10.7.tar.gz \ SHA256 94cee804fcaea366c9575380ef0e30ed04bf2fc7451190a94887f14c07f301ff https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/21.10.7/besu-21.10.7.zip \ SHA256 faf1ebfb20aa6171aa6ea98d7653339272567c318711d11e350471b5bba62c00
21.10.6
Bug Fixes
- Update log4j to 2.17.1
Download Links
https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/21.10.6/besu-21.10.6.tar.gz \ SHA256 ef579490031dd4eb3704b4041e352cfb2e7e787fcff7506b69ef88843d4e1220 https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/21.10.6/besu-21.10.6.zip \ SHA256 0fdda65bc993905daa14824840724d0b74e3f16f771f5726f5307f6d9575a719
21.10.5
Bug Fixes
- Update log4j to 2.17.0
Download Links
https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/21.10.5/besu-21.10.5.tar.gz \ SHA256 0d1b6ed8f3e1325ad0d4acabad63c192385e6dcbefe40dc6b647e8ad106445a8 https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/21.10.5/besu-21.10.5.zip \ SHA256 a1689a8a65c4c6f633b686983a6a1653e7ac86e742ad2ec6351176482d6e0c57
21.10.4
Bug Fixes
- Update log4j to 2.16.0.
- Change the base docker image from Debian Buster to Ubuntu 20.04 #3171 fixes #3045
Download links
This release is not recommended for production use.
21.10.3
Additions and Improvements
- Updated log4j to 2.15.0 and disabled JNDI message format lookups to improve security.
- Represent baseFee as Wei instead of long accordingly to the spec #2785
- Adding support of the NO_COLOR environment variable as described in the NO_COLOR standard #3085
- Add
privx_findFlexiblePrivacyGroup
RPC Method,privx_findOnchainPrivacyGroup
will be removed in a future release #3075 - The invalid value is now shown when
--bootnodes
cannot parse an item to make it easier to identify which option is invalid. - Adding two new options to be able to specify desired TLS protocol version and Java cipher suites #3105
- Implements EIP-4399 to repurpose DIFFICULTY opcode after the merge as a source of entropy from the Beacon chain. #3081
Bug Fixes
Download Link
This release is not recommended for production use.
21.10.2
Additions and Improvements
- Add discovery options to genesis file #2944
- Add validate-config subcommand to perform basic syntax validation of TOML config #2994
- Updated Sepolia Nodes #3034 #3035
Bug Fixes
- Reduce shift calculations to shifts that may have an actual result. #3039
- DNS Discovery daemon wasn't started #3033
Download Link
This release is not recommended for production use.
21.10.1
Additions and Improvements
- Add CLI autocomplete scripts. #2854
- Add support for PKCS11 keystore on PKI Block Creation. #2865
- Optimize EVM Memory for MLOAD Operations #2917
- Upgrade CircleCI OpenJDK docker image to version 11.0.12. #2928
- Update JDK 11 to latest version in Besu Docker images. #2925
- Add Sepolia proof-of-work testnet configurations #2920
- Allow block period to be configured for IBFT2 and QBFT using transitions #2902
- Add support for binary messages (0x02) for websocket. #2980
Bug Fixes
- Do not change the sender balance, but set gas fee to zero, when simulating a transaction without enforcing balance checks. #2454
- Ensure genesis block has the default base fee if london is at block 0 #2920
- Fixes the exit condition for loading a BonsaiPersistedWorldState for a sibling block of the last one persisted #2967
Early Access Features
- Enable plugins to expose custom JSON-RPC / WebSocket methods #1317
Download Link
This release is not recommended for production use.
21.10.0
Additions and Improvements
- The EVM has been factored out into a standalone module, suitable for inclusion as a library. #2790
- Low level performance improvements changes to cut worst-case EVM performance in half. #2796
- Migrate
ExceptionalHaltReason
from an enum to an interface to allow downstream users of the EVM to add new exceptional halt reasons. #2810 - reduces need for JUMPDEST analysis via caching #2607
- Add support for custom private key file for public-key export and public-key export-address commands #2801
- Add CLI autocomplete scripts. #2854
- Added support for PKCS11 keystore on PKI Block Creation. #2865
- add support for ArrowGlacier hardfork #2943
Bug Fixes
- Allow BESU_CONFIG_FILE environment to specify TOML file #2455
- Fix bug with private contracts not able to call public contracts that call public contracts #2816
- Fixes the exit condition for loading a BonsaiPersistedWorldState for a sibling block of the last one persisted #2967
- Fixes bonsai getMutable regression affecting fast-sync #2934
- Regression in RC1 involving LogOperation and frame memory overwrites #2908
- Allow
eth_call
andeth_estimateGas
to accept contract address as sender. #2891
Early Access Features
- Enable plugins to expose custom JSON-RPC / WebSocket methods #1317
Download Link
This release is not recommended for production use.
SHA256: 71374454753c2ee595f4f34dc6913f731818d50150accbc98088aace313c6935
21.10.0-RC4
Additions and Improvements
Bug Fixes
- Fixes the exit condition for loading a BonsaiPersistedWorldState for a sibling block of the last one persisted #2967
- Fixes bonsai getMutable regression affecting fast-sync #2934
Early Access Features
Download Link
This release is not recommended for production use.
SHA256: b16e15764b8bc06c5c3f9f19bc8b99fa48e7894aa5a6ccdad65da49bbf564793
21.10.0-RC3
Bug Fixes
- Regression in RC1 involving LogOperation and frame memory overwrites #2908
- Allow
eth_call
andeth_estimateGas
to accept contract address as sender. #2891 - Fix Concurrency issues in Ethpeers. #2896
Download
This release is not recommended for production use.
SHA256: 3d4857589336717bf5e4e5ef711b9a7f3bc46b49e1cf5b3b6574a00ccc6eda94
21.10.0-RC1/RC2
Additions and Improvements
- The EVM has been factored out into a standalone module, suitable for inclusion as a library. #2790
- Low level performance improvements changes to cut worst-case EVM performance in half. #2796
- Migrate
ExceptionalHaltReason
from an enum to an interface to allow downstream users of the EVM to add new exceptional halt reasons. #2810 - reduces need for JUMPDEST analysis via caching #2607
- Add support for custom private key file for public-key export and public-key export-address commands #2801
Bug Fixes
- Allow BESU_CONFIG_FILE environment to specify TOML file #2455
- Fix bug with private contracts not able to call public contracts that call public contracts #2816
Early Access Features
Download
This release is not recommended for production use.
SHA256: 536612e5e4d7a5e7a582f729f01ba591ba68cc389e8379fea3571ed85322ff51
21.7.4
Additions and Improvements
- Upgrade Gradle to 7.2, which supports building with Java 17 #2761
Bug Fixes
- Set an idle timeout for metrics connections, to clean up ports when no longer used #2748
- Onchain privacy groups can be unlocked after being locked without having to add a participant #2693
- Update Gas Schedule for Ethereum Classic #2746
Early Access Features
- [EXPERIMENTAL] Added support for QBFT with PKI-backed Block Creation. #2647
- [EXPERIMENTAL] Added support for QBFT to use retrieve validators from a smart contract #2574
Download Link
https://hyperledger.jfrog.io/native/besu-binaries/besu/21.7.4/besu-21.7.4.zip
SHA256: 778d3c42851db11fec9171f77b22662f2baeb9b2ce913d7cfaaf1042ec19b7f9
21.7.3
Additions and Improvements
- Migration to Apache Tuweni 2.0 #2376
- [EXPERIMENTAL] Added support for DevP2P-over-TLS #2536
eth_getWork
,eth_submitWork
support over the Stratum port #2581- Stratum metrics #2583
- Support for mining ommers #2576
- Updated onchain permissioning to validate permissions on transaction submission #2595
- Removed deprecated CLI option
--privacy-precompiled-address
#2605 - Removed code supporting EIP-1702. #2657
- A native library was added for the alternative signature algorithm secp256r1, which will be used by default #2630
- The command line option --Xsecp-native-enabled was added as an alias for --Xsecp256k1-native-enabled #2630
- Added Labelled gauges for metrics #2646
- support for
eth/66
networking protocol #2365 - update RPC methods for post london 1559 transaction #2535
- [EXPERIMENTAL] Added support for using DNS host name in place of IP address in onchain node permissioning rules #2667
- Implement EIP-3607 Reject transactions from senders with deployed code. #2676
- Ignore all unknown fields when supplied to eth_estimateGas or eth_call. #2690
Bug Fixes
- Consider effective price and effective priority fee in transaction replacement rules #2529
- GetTransactionCount should return the latest transaction count if it is greater than the transaction pool #2633
Early Access Features
21.7.2
Additions and Improvements
This release contains improvements and bugfixes for optimum compatibility with other London client versions.
Bug Fixes
- hotfix for private transaction identification for mainnet transactions #2609
Download Link
https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/21.7.2/besu-21.7.2.zip
db47fd9ba33b36436ed6798d2474f7621c733353fd04f49d6defffd12e3b6e14
21.7.1
Additions and Improvements
priv_call
now uses NO_TRACING OperationTracer implementation which improves memory usage #2482- Ping and Pong messages now support ENR encoding as scalars or bytes #2512
Download Link
https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/21.7.1/besu-21.7.1.zip
sha256sum 83fc44e39a710a95d8b6cbbbf04010dea76122bafcc633a993cd15304905a402
21.7.0
Additions and Improvements
This release contains the activation blocks for London across all supported testnets. They are:
- Ropsten 10_499_401 (24 Jun 2021)
- Goerli 5_062_605 (30 Jun 2021)
- Rinkeby 8_897_988 (7 Jul 2021)
- Mainnet 12_965_000 (4 Aug 2021)
- eip-1559 changes: accept transactions which have maxFeePerGas below current baseFee #2374
- Introduced transitions for IBFT2 block rewards #1977
- Change Ethstats's status from experimental feature to stable. #2405
- Fixed disabling of native libraries for secp256k1 and altBn128. #2163
- eth_feeHistory API for wallet providers #2466
Bug Fixes
- Ibft2 could create invalid RoundChange messages in some circumstances containing duplicate prepares #2449
- Updated
eth_sendRawTransaction
to return an error when maxPriorityFeePerGas exceeds maxFeePerGas #2424 - Fixed NoSuchElementException with EIP1559 transaction receipts when using eth_getTransactionReceipt #2477
Early Access Features
- QBFT is a Byzantine Fault Tolerant consensus algorithm, building on the capabilities of IBFT and IBFT 2.0. It aims to provide performance improvements in cases of excess round change, and provides interoperability with other EEA compliant clients, such as GoQuorum.
- Note: QBFT currently only supports new networks. Existing networks using IBFT2.0 cannot migrate to QBFT. This will become available in a future release.
- Note: QBFT is an early access feature pending community feedback. Please make use of QBFT in new development networks and reach out in case of issues or concerns
- GoQuorum-compatible privacy. This mode uses Tessera and is interoperable with GoQuorum.
- Note: GoQuorum-compatible privacy is an early access feature pending community feedback.
Download Link
https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/21.7.0/besu-21.7.0.zip sha256sum 389465fdcc2cc5e5007a02dc2b8a2c43d577198867316bc5cc4392803ed71034
21.7.0-RC2
Additions and Improvements
- eth_feeHistory API for wallet providers #2466
Bug Fixes
- Ibft2 could create invalid RoundChange messages in some circumstances containing duplicate prepares #2449
Download Link
https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/21.7.0-RC2/besu-21.7.0-RC2.zip sha256sum 7bc97c359386cad84d449f786dc0a8ed8728616b6704ce473c63f1d94af3a9ef
21.7.0-RC1
Additions and Improvements
- eip-1559 changes: accept transactions which have maxFeePerGas below current baseFee #2374
- Introduced transitions for IBFT2 block rewards #1977
- Change Ethstats's status from experimental feature to stable. #2405
- Fixed disabling of native libraries for secp256k1 and altBn128. #2163
Bug Fixes
- Updated
eth_sendRawTransaction
to return an error when maxPriorityFeePerGas exceeds maxFeePerGas #2424
Early Access Features
This release contains the activation blocks for London across all supported testnets. They are:
- Ropsten 10_499_401 (24 Jun 2021)
- Goerli 5_062_605 (30 Jun 2021)
- Rinkeby 8_897_988 (7 Jul 2021)
Download Link
https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/21.7.0-RC1/besu-21.7.0-RC1.zip sha256sum fc959646af65a0e267fc4d695e0af7e87331d774e6e8e890f5cc391549ed175a
21.1.7
Privacy users - Orion Project Deprecation
Tessera is now the recommended Private Transaction Manager for Hyperledger Besu.
Now that all primary Orion functionality has been merged into Tessera, Orion is being deprecated. We encourage all users with active projects to use the provided migration instructions, documented here.
We will continue to support Orion users until 30th November 2021. If you have any questions or concerns, please reach out to the ConsenSys protocol engineering team in the #orion channel on Discord or by email.
Additions and Improvements
-
Upgrade OpenTelemetry to 1.2.0. #2313
-
Ethereum Classic Magneto Hard Fork #2315
-
Added support for the upcoming CALAVERAS ephemeral testnet and removed the configuration for the deprecated BAIKAL ephemeral testnet. #2343
Bug Fixes
- Fix invalid transfer values with the tracing API specifically for CALL operation #2319
Early Access Features
Previously identified known issues
- Fixed issue in discv5 where nonce was incorrectly reused. #2075
- Fixed issues in debug_standardTraceBadBlockToFile and debug_standardTraceBlockToFile. #2120
- Fixed invalid error code in several JSON RPC methods when the requested block is not in the range. #2138
Download Link
https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/21.1.7/besu-21.1.7.zip
sha256: f415c9b67d26819caeb9940324b2b1b9ce6e872c9181052739438545e84e2531
21.1.6
Additions and Improvements
- Added support for the upcoming BAIKAL ephemeral testnet and removed the configuration for the deprecated YOLOv3 ephemeral testnet. #2237
- Implemented EIP-3541: Reject new contracts starting with the 0xEF byte #2243
- Implemented EIP-3529: Reduction in refunds #2238
- Implemented EIP-3554: Difficulty Bomb Delay #2289
- [EXPERIMENTAL] Added support for secp256r1 keys. #2008
Bug Fixes
- Added ACCESS_LIST transactions to the list of transactions using legacy gas pricing for 1559 #2239
- Reduced logging level of public key decoding failure of malformed packets. #2143
- Add 1559 parameters to json-rpc responses. #2222
Early Access Features
Previously identified known issues
- Fixed issue in discv5 where nonce was incorrectly reused. #2075
- Fixed issues in debug_standardTraceBadBlockToFile and debug_standardTraceBlockToFile. #2120
- Fixed invalid error code in several JSON RPC methods when the requested block is not in the range. #2138
Download Link
https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/21.1.6/besu-21.1.6.zip
sha256: 3952c69a32bb390ec84ccf4c2c3eb600ea3696af9a05914985d10e1632ef8488
21.1.5
Additions and Improvements
- Ignore
nonce
when supplied to eth_estimateGas or eth_call. #2133 - Ignore
privateFor
for tx estimation. #2160
Bug Fixes
- Fixed
NullPointerException
when crossing network upgrade blocks when peer discovery is disabled. #2140
Early Access Features
Previously identified known issues
- Fixed issue in discv5 where nonce was incorrectly reused. #2075
- Fixed issues in debug_standardTraceBadBlockToFile and debug_standardTraceBlockToFile. #2120
Download Link
https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/21.1.5/besu-21.1.5.zip
sha256: edd78fcc772cfa97d11d8ee7b5766e6fac4b31b582f940838a292f2aeb204777
21.1.4
Additions and Improvements
- Adds
--discovery-dns-url
CLI command #2088
Bug Fixes
- Fixed issue in discv5 where nonce was incorrectly reused. #2075
- Fixed issues in debug_standardTraceBadBlockToFile and debug_standardTraceBlockToFile. #2120
Early Access Features
Previously identified known issues
- Fast sync when running Besu on cloud providers
- Privacy users with private transactions created using v1.3.4 or earlier
Download Link
https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/21.1.4/besu-21.1.4.zip 58ae55b492680d92aeccfbed477e8b9c25ccc1a97cca71895e27448d754a7d8b
21.1.3
Additions and Improvements
- Increase node diversity when downloading blocks #2033
Bug Fixes
- Ethereum Node Records are now dynamically recalculated when we pass network upgrade blocks. This allows for better peering through transitions without needing to restart the node. #1998
Early Access Features
Previously identified known issues
- Fast sync when running Besu on cloud providers
- Privacy users with private transactions created using v1.3.4 or earlier
Download link
https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/21.1.3/besu-21.1.3.zip 38893cae225e5c53036d06adbeccc30aeb86ef08c543fb742941a8c618485c8a
21.1.2
Berlin Network Upgrade
Important note: the 21.1.1 release contains an outdated version of the Berlin network upgrade. If you are using Besu on public Ethereum networks, you must upgrade to 21.1.2.
This release contains the activation blocks for Berlin across all supported testnets and the Ethereum mainnet. They are:
- Ropsten 9_812_189 (10 Mar 2021)
- Goerli 4_460_644 (17 Mar 2021)
- Rinkeby 8_290_928 (24 Mar 2021)
- Ethereum 12_244_000 (14 Apr 2021)
Additions and Improvements
- Added option to set a limit for JSON-RPC connections
- Added ASTOR testnet ETC support #2017
Bug Fixes
- Don't Register BLS12 precompiles for Berlin #2015
Previously identified known issues
- Fast sync when running Besu on cloud providers
- Privacy users with private transactions created using v1.3.4 or earlier
Download link
https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/21.1.2/besu-21.1.2.zip 02f4b6622756b77fed814d8c1bbf986c6178d8f5adb9d61076e061124c3d12aa
21.1.1
Berlin Network Upgrade
Important note: this release contains an outdated version of the Berlin network upgrade. If you are using Besu on public Ethereum networks, you must upgrade to 21.1.2.
This release contains the activation blocks for Berlin across all supported testnets and the Ethereum mainnet. They are:
- Ropsten 9_812_189 (10 Mar 2021)
- Goerli 4_460_644 (17 Mar 2021)
- Rinkeby 8_290_928 (24 Mar 2021)
- Ethereum 12_244_000 (14 Apr 2021)
Additions and Improvements
- Removed EIP-2315 from the Berlin network upgrade #1983
- Added
besu_transaction_pool_transactions
to the reported metrics, counting the mempool size #1869 - Distributions and maven artifacts have been moved off of bintray #1886
- admin_peers json RPC response now includes the remote nodes enode URL
- add support for keccak mining and a ecip1049_dev network #1882
Bug Fixes
- Fixed incorrect
groupId
in published maven pom files. - Fixed GraphQL response for missing account, return empty account instead #1946
Early Access Features
Previously identified known issues
- Fast sync when running Besu on cloud providers
- Privacy users with private transactions created using v1.3.4 or earlier
Download link
sha256: c22a80a54e9fed864734b9fbd69a0a46840fd27ca5211648a3eaf8a955417218
21.1.0
Important note: this release contains an outdated version of the Berlin network upgrade, which was changed on March 5, 2021 (link). If you are using Besu on public Ethereum networks, you must upgrade to 21.1.2.
21.1.0 Features
Features added between 20.10.0 to 21.1.0 include:
- Berlin Network Upgrade: this release contains the activation blocks for Berlin across all supported testnets and the Ethereum mainnet. They are:
- Ropsten 9_812_189 (10 Mar 2021)
- Goerli 4_460_644 (17 Mar 2021)
- Rinkeby 8_290_928 (24 Mar 2021)
- Ethereum 12_244_000 (14 Apr 2021)
- Besu Launcher: Besu now has support for the Quorum Mainnet Launcher which makes it easy for users to configure and launch Besu on the Ethereum mainnet.
- Bonsai Tries: A new database format which reduces storage requirements and improves performance for access to recent state. Note: only full sync is currently supported.
- Miner Data JSON-RPC: The
eth_getMinerDataByBlockHash
andeth_getMinerDataByBlockNumber
endpoints return miner rewards and coinbase address for a given block. - EIP-1898 support: The EIP adds
blockHash
to JSON-RPC methods which accept a default block parameter.
Early Access Features
- Bonsai Tries: A new database format which reduces storage requirements and improves performance for access to recent state. Note: only full sync is currently supported.
- QBFT: A new consensus algorithm to support interoperability with other Enterprise Ethereum Alliance compatible clients.
21.1.0 Breaking Changes
--skip-pow-validation-enabled
is now an error withblock import --format JSON
. This is because the JSON format doesn't include the nonce so the proof of work must be calculated.eth_call
will not return a JSON-RPC result if the call fails, but will return an error instead. If it was for a revert the revert reason will be included.eth_call
will not fail for account balance issues by default. An parameter"strict": true
can be added to the call parameters (withto
andfrom
) to enforce balance checks.
Additions and Improvements
- Added
besu_transaction_pool_transactions
to the reported metrics, counting the mempool size #1869 - Added activation blocks for Berlin Network Upgrade #1929
Bug Fixes
- Fixed representation of access list for access list transactions in JSON-RPC results.
Previously identified known issues
- Fast sync when running Besu on cloud providers
- Privacy users with private transactions created using v1.3.4 or earlier
Download link
sha256: e4c8fe4007e3e5f7f2528cbf1eeb5457caf06536c974a6ff4305035ff5724476
21.1.0-RC2
Additions and Improvements
- Support for the Berlin Network Upgrade, although the block number must be set manually with
--override-genesis-config=berlinBlock=<blocknumber>
. This is because the block numbers haven't been determined yet. The next release will include the number in the genesis file so it will support Berlin with no intervention. #1898
21.1.0-RC1
21.1.0 Breaking Changes
--skip-pow-validation-enabled
is now an error withblock import --format JSON
. This is because the JSON format doesn't include the nonce so the proof of work must be calculated.eth_call
will not return a JSON-RPC result if the call fails, but will return an error instead. If it was for a revert the revert reason will be included.eth_call
will not fail for account balance issues by default. An parameter"strict": true
can be added to the call parameters (withto
andfrom
) to enforce balance checks.
Additions and Improvements
- Removed unused flags in default genesis configs #1812
--skip-pow-validation-enabled
is now an error withblock import --format JSON
. This is because the JSON format doesn't include the nonce so the proof of work must be calculated. #1815- Added a new CLI option
--Xlauncher
to start a mainnet launcher. It will help to configure Besu easily. - Return the revert reason from
eth_call
JSON-RPC api calls when the contract causes a revert. #1829 - Added
chainId
,publicKey
, andraw
to JSON-RPC api calls returning detailed transaction results. #1835
Bug Fixes
- Ethereum classic heights will no longer be reported in mainnet metrics. Issue #1751 Fix #1820
- Don't enforce balance checks in
eth_call
unless explicitly requested. Issue #502 Fix #1834
Early Access Features
Previously identified known issues
- Fast sync when running Besu on cloud providers
- Privacy users with private transactions created using v1.3.4 or earlier
Download link
Link removed because this release contains an outdated version of the Berlin network upgrade, which was changed on March 5, 2021 (link). If you are using Besu on public Ethereum networks, you must upgrade to 21.1.1. sha256 hash left for reference.
sha256: b0fe3942052b8fd43fc3025a298a6c701f9edae2e100f0c563a1c5a4ceef71f1
20.10.4
Additions and Improvements
- Implemented EIP-778: Ethereum Node Records (ENR) #1680
- Implemented EIP-868: Node Discovery v4 ENR Extension #1721
- Added revert reason to eth_estimateGas RPC call. #1730
- Added command line option --static-nodes-file. #1644
- Implemented EIP-1898: Add
blockHash
to JSON-RPC methods which accept a default block parameter #1757
Bug Fixes
Previously identified known issues
- Fast sync when running Besu on cloud providers
- Privacy users with private transactions created using v1.3.4 or earlier
Download link
https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/20.10.4/besu-20.10.4.zip sha256: f15cd5243b809659bba1706c1745aecafc012d3fc44a91419522da925493537c
20.10.3
Additions and Improvements
- Added
memory
as an option to--key-value-storage
. This ephemeral storage is intended for sync testing and debugging. #1617 - Fixed gasPrice parameter not always respected when passed to
eth_estimateGas
endpoint #1636 - Enabled eth65 by default #1682
- Warn that bootnodes will be ignored if specified with discovery disabled #1717
Bug Fixes
- Accept to use default port values if not in use. #1673
- Block Validation Errors should be at least INFO level not DEBUG or TRACE. Bug #1568 PR #1706
- Fixed invalid and wrong trace data, especially when calling a precompiled contract #1710
Previously identified known issues
- Fast sync when running Besu on cloud providers
- Privacy users with private transactions created using v1.3.4 or earlier
Download link
https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/20.10.3/besu-20.10.3.zip
sha256: b5f46d945754dedcbbb1e5dd96bf2bfd13272ff09c6a66c0150b979a578f4389
20.10.2
Additions and Improvements
- Added support for batched requests in WebSockets. #1583
- Added protocols section to
admin_peers
to provide info about peer health. #1582 - Added CLI option
--goquorum-compatibility-enabled
to enable GoQuorum compatibility mode. #1598. Note that this mode is incompatible with Mainnet.
Bug Fixes
- Ibft2 will discard any received messages targeting a chain height <= current head - this resolves some corner cases in system correctness directly following block import. #1575
- EvmTool now throws
UnsupportedForkException
when there is an unknown fork and is YOLOv2 compatible #1584 eth_newFilter
now supportsblockHash
parameter as per the spec #1548. (blockhash
is also still supported.)- Fixed an issue that caused loss of peers and desynchronization when eth65 was enabled #1601
Previously identified known issues
- Fast sync when running Besu on cloud providers
- Privacy users with private transactions created using v1.3.4 or earlier
Download Link
https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/20.10.2/besu-20.10.2.zip
sha256: 710aed228dcbe9b8103aef39e4431b0c63e73c3a708ce88bcd1ecfa1722ad307
20.10.1
Additions and Improvements
--random-peer-priority-enabled
flag added. Allows for incoming connections to be prioritized randomly. This will prevent (typically small, stable) networks from forming impenetrable peer cliques. #1440miner_changeTargetGasLimit
RPC added. If a target gas limit is set, allows the node operator to change it at runtime.- Hide deprecated
--host-whitelist
option. #1444 - Prioritize high gas prices during mining. Previously we ordered only by the order in which the transactions were received. This will increase expected profit when mining. #1449
- Added support for the updated smart contract-based node permissioning EEA interface. #1435 and #1496
- Added EvmTool binary to the distribution. EvmTool is a CLI that can execute EVM bytecode and execute ethereum state tests. #1465
- Updated the libraries for secp256k1 and AltBN series precompiles. These updates provide significant performance improvements to those areas. #1499
- Provide MegaGas/second measurements in the log when doing a full block import, such as the catch up phase of a fast sync. #1512
- Added new endpoints to get miner data,
eth_getMinerDataByBlockHash
andeth_getMinerDataByBlockNumber
. #1538 - Added direct support for OpenTelemetry metrics #1492
- Added support for
qip714block
config parameter in genesis file, paving the way towards permissioning interoperability between Besu and GoQuorum. #1545 - Added new CLI option
--compatibility-eth64-forkid-enabled
. #1542
Bug Fixes
- Fix a bug on
eth_estimateGas
which returnedInternal error
instead ofExecution reverted
in case of reverted transaction. #1478 - Fixed a bug where Local Account Permissioning was being incorrectly enforced on block import/validation. #1510
- Fixed invalid enode URL when discovery is disabled #1521
- Removed duplicate files from zip and tar.gz distributions. #1566
- Add a more rational value to eth_gasPrice, based on a configurable percentile of prior block's transactions (default: median of last 100 blocks). #1563
Deprecated
--privacy-precompiled-address (Scheduled for removal in Next Release)
Deprecated in 1.5.1
- CLI option
--privacy-precompiled-address
option removed. This address is now derived, based on--privacy-onchain-groups-enabled
. #1222
Besu Sample Network repository
The Besu Sample Networks repository has been replaced by the Quorum Developer Quickstart.
Previously identified known issues
- Eth/65 loses peers
- Fast sync when running Besu on cloud providers
- Privacy users with private transactions created using v1.3.4 or earlier
Download Link
https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/20.10.1/besu-20.10.1.zip
sha256: ac4fae310957c176564396f73c0f03c60c41129d43d078560d0dab533a69fd2a
20.10.0
Release format
Hyperledger Besu is moving its versioning scheme to CalVer starting with the 20.10.0 (formerly 1.6.0) release. More information about the specific version of CalVer Besu is using can be found on the wiki.
20.10 Breaking Changes
When upgrading to 20.10, ensure you've taken into account the following breaking changes.
JSON-RPC HTTP Error Codes For Valid Calls (#1426)
Prior versions of Besu would set the HTTP Status 400 Bad Request for JSON-RPC requests that completed in an error, regardless of the kind of error. These responses could include a complete JSON-RPC response with an error field.
In Besu version 20.10, properly formatted requests that have valid parameters (count and content) will return a HTTP Status 200 OK, with an error field if an error occurred. For example, requesting an account that does not exist in the chain, or a block by hash that Besu does not have, will now return HTTP 200 OK responses. Unparsable requests, improperly formatted requests, or requests with invalid parameters will continue to return HTTP 400 Bad Request.
Users of Web3J should note that many calls will now return a result with the error field containing the message whereas before a call would throw an exception with the error message as the exception message.
20.10.0 Additions and Improvements
- Added support for ECIP-1099 / Classic Thanos Fork: Calibrate Epoch Duration. #1421 #1441 #1462
- Added the Open Telemetry Java agent to report traces to a remote backend. Added an example to showcase the trace reporting capabilities.
- Added EvmTool binary to the distribution. EvmTool is a CLI that can execute EVM bytecode and execute ethereum state tests. Documentation for it is available here. #1465
- Added support for the upcoming YOLOv2 ephemeral testnet and removed the flag for the deprecated YOLOv1 ephemeral testnet. #1386
- Added
debug_standardTraceBlockToFile
JSON-RPC API. This API accepts a block hash and will replay the block. It returns a list of files containing the result of the trace (one file per transaction). #1392 - Added
debug_standardTraceBadBlockToFile
JSON-RPC API. This API is similar todebug_standardTraceBlockToFile
, but can be used to obtain info about a block which has been rejected as invalid. #1403 - Added support for EIP-2929 to YOLOv2. #1387
- Added
--start-block
and--end-block
to theblocks import
subcommand #1399 - Added support for multi-tenancy when using the early access feature of onchain privacy group management
- [Reverted] Fixed memory leak in eth/65 subprotocol behavior. It is now enabled by default. #1420, #1348, #1321
Bug Fixes
- Log block import rejection reasons at "INFO" level. Bug #1412
- Fixed NPE when executing
eth_estimateGas
with privacy enabled. Bug #1404
Previously identified known issues
- Eth/65 loses peers
- Fast sync when running Besu on cloud providers
- Privacy users with private transactions created using v1.3.4 or earlier
Deprecated and Scheduled for removal in Next Release
--privacy-precompiled-address
Deprecated in 1.5.1
- CLI option
--privacy-precompiled-address
option removed. This address is now derived, based on--privacy-onchain-groups-enabled
. #1222
Download link
https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/20.10.0/besu-20.10.0.zip
sha256sum: 2b50a375aae64b838a2cd9d43747006492cae573f1be11745b7f643646fd5a01
1.5.5
Additions and Improvements
- The new version of the web3js-eea library (v0.10) supports the onchain privacy group management changes made in Besu v1.5.3.
Bug Fixes
- Added
debug_getBadBlocks
JSON-RPC API to analyze and detect consensus flaws. Even if a block is rejected it will be returned by this method #1378 - Fix logs queries missing results against chain head #1351 and #1381
Previously identified known issues
- Eth/65 loses peers
- Fast sync when running Besu on cloud providers
- Privacy users with private transactions created using v1.3.4 or earlier
- Changes not saved to database correctly causing inconsistent private states
Download link
https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/1.5.5/besu-1.5.5.zip
sha256sum: e67b0a899dc4421054eaa9a8112cb89e1e5f6a56f0d8aa1b0c5111c53dfad2ad
1.5.4
Additions and Improvements
- Added
priv_debugGetStateRoot
JSON-RPC API to retrieve the state root of a specified privacy group. #1326 - Added reorg logging and
--reorg-logging-threshold
to configure the same. Besu now logs any reorgs where the old or new chain head is more than the threshold away from their common ancestors. The default is 6. - Added
debug_batchSendRawTransaction
JSON-RPC API to submit multiple signed transactions with a single call. #1350
Bug Fixes
- The metrics HTTP server no longer rejects requests containing
Accept
header that doesn't precisely match the prometheus text format #1345 - JSON-RPC method
net_version
should return network ID instead of chain ID #1355
Previously identified known issues
- Logs queries missing results against chain head
- Eth/65 loses peers
- Fast sync when running Besu on cloud providers
- Privacy users with private transactions created using v1.3.4 or earlier
- Changes not saved to database correctly causing inconsistent private states
Download link
https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/1.5.4/besu-1.5.4.zip
sha256sum: 1f4df8e1c5e3b5b3abf6289ccfe70f302aa7c29a652b2eb713ffbdc507670420
1.5.3
Additions and Improvements
- The EvmTool now processes State Tests from the Ethereum Reference Tests. #1311
- Early access DNS support added via the
--Xdns-enabled
and--Xdns-update-enabled
CLI options. #1247 - Add genesis config option
ecip1017EraRounds
for Ethereum Classic chains. #1329
Bug Fixes
- K8S Permissioning to use of Service IP's rather than pod IP's which can fail #1190
Previously identified known issues
- Logs queries missing results against chain head
- Eth/65 loses peers
- Fast sync when running Besu on cloud providers
- Privacy users with private transactions created using v1.3.4 or earlier
- Changes not saved to database correctly causing inconsistent private states
Breaking Change to Onchain Privacy Group Management
This early access feature was changed in a way that makes onchain privacy groups created with previous versions no longer usable.
To enhance control over permissions on the privacy group management contract:
- The enclave key was removed as the first parameter for
addParticipant
andremoveParticipant
. - The owner of the privacy group management contract is the signer of the private transaction that creates the privacy group. In the default onchain privacy group management contract implementation, only the owner can add and remove participants, and upgrade the management contract.
The onchain privacy support in the current version of the web3js-eea library (v0.9) will not be compatible with Besu v1.5.3. We are actively working on an upgrade to webj3-eea that will support these changes.
Download link
https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/1.5.3/besu-1.5.3.zip
sha256sum: 735cd511e1dae1590f2829d9535cb383aa8c526f059b3451859e5fcfccc48985
1.5.2
Additions and Improvements
- Experimental offline backup and restore has been added via the
operator x-backup-state
andoperator x-restore-state
CLI commands. Data formats will be fluid for as long as thex-
prefix is present in the CLI so it is advised not to rely on these backups for disaster recovery. #1235 - Experimental ethstats support added via the
Xethstats
andXethstats-contact
CLI commands. #1239 - Peers added via the JSON-RPC
admin_addPeer
andadmin_removePeer
will be shared or no longer shared via discovery respectively. Previously they were not shared. #1177 contributed by br0tchain. - New Docker Images (see below). #1277
- Reworked static peer discovery handling. #1292
New Java VMs in Docker Image
- New docker images are being generated to use the latest version of OpenJDK (currently 14.0.1) with the tag suffix of
-openjdk-latest
, for example1.5.2-openjdk-latest
. - New docker images are being generated to use GraalVM with the tag suffix of
-graalvm
, for example1.5.2-graalvm
. - The existing images based on Java 11 are also being tagged with the suffix
-openjdk-11
, for example1.5.2-openjdk-11
, as well as1.5.2
.
The intent is that the major Java VM version or Java VM type shipped with the default docker images (latest
, 1.5.x
, etc.) may be changed during future quarterly releases but will remain consistent within quarterly releases.
Bug Fixes
-
Offchain permissioning - fixed bug where sync status check prevented peering if static nodes configured. #1252
-
GraphQL queries of
miner
in IBFT networks will no longer return an error. PR #1282 issue #1272.
Previously identified known issues
- Logs queries missing results against chain head
- Eth/65 loses peers
- Fast sync when running Besu on cloud providers
- Privacy users with private transactions created using v1.3.4 or earlier
- Permissioning issues on Kubernetes
- Restarts caused by insufficient memory can cause inconsistent private state
New and Old Maintainer
- David Mechler has been added as a new maintainer.
- Edward Evans voluntarily moved to emeritus status.
Download link
https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/1.5.2/besu-1.5.2.zip
sha256sum: 629f44e230a635b09f8d82f2196d70d31193233718118a46412f11c50772dc85
1.5.1
Deprecated
- CLI option
--privacy-precompiled-address
option is deprecated. This address is now derived, based on--privacy-onchain-groups-enabled
. #1222
Additions and Improvements
- In an IBFT2 network, a fixed block reward value and recipient address can be defined in genesis file #1132
- JSON-RPC HTTP API Authorization: exit early when checking user permissions. #1144
- HTTP/2 is enabled for JSON-RPC HTTP API over TLS. #1145
- Color output in consoles. It can be disabled with
--color-enabled=false
#1257 - Add compatibility with ClusterIP services for the Kubernetes Nat Manager #1156
- In an IBFT2 network; a fixed block reward value and recipient address can be defined in genesis file #1132
- Add fee cap for transactions submitted via RPC. #1137
Bug fixes
- When the default sync mode was changed to fast sync for named networks, there was one caveat we didn't address. The
dev
network should've been full sync by default. This has now been fixed. #1257 - Fix synchronization timeout issue when the blocks were too large #1149
- Fix missing results from eth_getLogs request. #1154
- Fix issue allowing Besu to be used for DDoS amplification. #1146
Known Issues
Known issues are open issues categorized as Very High or High impact.
Previously identified known issues
- Scope of logs query causing Besu to hang
- Eth/65 loses peers
- Fast sync when running Besu on cloud providers
- Privacy users with private transactions created using v1.3.4 or earlier
- Permissioning issues on Kubernetes
- Restarts caused by insufficient memory can cause inconsistent private state
Download link
https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/1.5.1/besu-1.5.1.zip
sha256sum: c17f49b6b8686822417184952487fc135772f0be03514085926a6984fd955b88
1.5 Breaking changes
When upgrading to 1.5, ensure you've taken into account the following breaking changes.
Docker users with volume mounts
To maintain best security practices, we're changing the user:group
on the Docker container to besu
.
What this means for you:
- If you are running Besu as a binary, there is no impact.
- If you are running Besu as a Docker container and have a volume mount for data, ensure that the
permissions on the directory allow other users and groups to r/w. Ideally this should be set to
besu:besu
as the owner.
Note that the besu
user only exists within the container not outside it. The same user ID may match
a different user outside the image.
If you’re mounting local folders, it is best to set the user via the Docker —user
argument. Use the
UID because the username may not exist inside the docker container. Ensure the directory being mounted
is owned by that user.
Remove Manual NAT method
The NAT manager MANUAL
method has been removed.
If you have been using the MANUAL
method, use the NONE
method instead. The behavior of the
NONE
method is the same as the previously supported MANUAL
methods.
Privacy users
Besu minor version upgrades require upgrading Orion to the latest minor version. That is, for Besu <> Orion node pairs, when upgrading Besu to v1.5, it is required that Orion is upgraded to v1.6. Older versions of Orion will no longer work with Besu v1.5.
1.5 Features
Features added between from 1.4 to 1.5 include:
- Mining Support
Besu supports
eth_hashrate
andeth_submitHashrate
to obtain the hashrate when we mine with a GPU mining worker. - Tracing
The Tracing API is no longer an Early Access feature and now has full support for
trace_replayBlockTransactions
,trace_Block
andtrace_transaction
. - Plugin API Block Events
BlockAdded
andBlockReorg
are now exposed via the Plugin API. - Filters and subscriptions for private contracts.
- SecurityModule Plugin API This allows use of a different security module as a plugin to provide cryptographic function that can be used by NodeKey (such as sign, ECDHKeyAgreement etc.).
- Onchain privacy groups with add and remove members. This is an early access feature. Early access features are not recommended for production networks and may have unstable interfaces.
1.5 Additions and Improvements
- Public Networks Default to Fast Sync: The default sync mode for named permissionless networks, such as the Ethereum mainnet and testnets, is now
FAST
.- The default is unchanged for private networks. That is, the sync mode defaults to
FULL
for private networks. - Use the
--sync-mode
command line option to change the sync mode. #384
- The default is unchanged for private networks. That is, the sync mode defaults to
- Proper Mining Support: Added full support for
eth_hashrate
andeth_submitHashrate
. It is now possible to have the hashrate when we mine with a GPU mining worker #1063 - Performance Improvements: The addition of native libraries (#775) and changes to data structures in the EVM (#1089) have improved Besu sync and EVM execution times.
- Tracing API Improvements: The Tracing API is no longer an Early Access feature and now has full support for
trace_replayBlockTransactions
,trace_Block
andtrace_transaction
. - New Plugin API Block Events:
BlockAdded
andBlockReorg
are now exposed via the Plugin API #637. - Added experimental CLI option
--Xnat-kube-pod-name
to specify the name of the loadbalancer used by the Kubernetes nat manager #1078
- Local permissioning TOML config now supports additional keys (
nodes-allowlist
andaccounts-allowlist
). Support fornodes-whitelist
andaccounts-whitelist
will be removed in a future release. - Add missing
mixHash
field foreth_getBlockBy*
JSON RPC endpoints. #1098
- Besu now has a strict check on private transactions to ensure the privateFrom in the transaction matches the sender Orion key that has distributed the payload. Besu 1.5+ requires Orion 1.6+ to work. #357
Bug fixes
No bug fixes with user impact in this release.
Known Issues
Known issues are open issues categorized as Very High or High impact.
New known issues
-
K8S permissioning uses of Service IPs rather than pod IPs which can fail. #1190 Workaround - Do not use permissioning on K8S.
-
Restart caused by insufficient memory can cause inconsistent private state. #1110 Workaround - Ensure you allocate enough memory for the Java Runtime Environment that the node does not run out of memory.
Previously identified known issues
- Scope of logs query causing Besu to hang
- Eth/65 loses peers
- Fast sync when running Besu on cloud providers
- Privacy users with private transactions created using v1.3.4 or earlier
Download link
https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/1.5.0/besu-1.5.0.zip
sha256sum: 56929d6a71cc681688351041c919e9630ab6df7de37dd0c4ae9e19a4f44460b2
For download links of releases prior to 1.5.0, please visit https://hyperledger.jfrog.io/artifactory/besu-binaries/besu/
1.4.6
Additions and Improvements
- Print node address on startup. #938
- Transaction pool: price bump replacement mechanism configurable through CLI. #928 #930
Bug Fixes
- Added timeout to queries. #986
- Fixed issue where networks using onchain permissioning could stall when the bootnodes were not validators. #969
- Update getForks method to ignore ClassicForkBlock chain parameter to fix issue with ETC syncing. #1014
Known Issues
Known issues are open issues categorized as Very High or High impact.
Previously identified known issues
- Scope of logs query causing Besu to hang
- Eth/65 loses peers
- Fast sync when running Besu on cloud providers
- Privacy users with private transactions created using v1.3.4 or earlier
1.4.5
Additions and Improvements
- Implemented WebSocket logs subscription for private contracts (
priv_subscribe
/priv_unsubscribe
) #762 - Introduced SecurityModule plugin API. This allows use of a different security module as a plugin to
provide cryptographic function that can be used by NodeKey (such as sign, ECDHKeyAgreement etc.). KeyPairSecurityModule
is registered and used by default. The CLI option
--security-module=<name> (defaults to localfile)
can be used to identify the security module plugin name to use instead. #713 - Several testing related changes to improve compatibility with Hive and Retesteth. #806 and #845
- Native libraries for secp256k1 and Altbn128 encryption are enabled by default. To disable these libraries use
--Xsecp256k1-native-enabled=false
and--Xaltbn128-native-enabled=false
. #775
Bug Fixes
- Fixed
eth_estimateGas
JSON RPC so it no longer returns gas estimates that are too low. #842 - Full help not displayed unless explicitly requested. #437
- Compatibility with undocumented Geth
eth_subscribe
fields. #654 - Current block number included as part of
eth_getWork
response. #849
Known Issues
Known issues are open issues categorized as Very High or High impact.
New known issues
- Scope of logs query causing Besu to crash. #944
Workaround - Limit the number of blocks queried by each eth_getLogs
call.
Previously identified known issues
Intrinsic gas exceeds gas limit
returned when callingdelete mapping[addr]
ormapping[addr] = 0
- Eth/65 not backwards compatible
- Error full syncing with pruning
- Fast sync when running Besu on cloud providers
- Bootnodes must be validators when using onchain permissioning
- Privacy users with private transactions created using v1.3.4 or earlier
1.4.4
Additions and Improvements
- Implemented
priv_getLogs
. #686 - Implemented private contract log filters including JSON-RPC methods to interact with private filters. #735
- Implemented EIP-2315: Simple Subroutines for the EVM #717
- Implemented Splunk logging. #725
- Implemented optional native library encryption. #675. To enable add
--Xsecp256k1-native-enabled
(for transaction signatures) and/or--Xaltbn128-native-enabled
(for altbn128 precomiled contracts) as command line options.
Bug Fixes
- Flag added to toggle
eth/65
off by default.eth/65
will remain toggled off by default until a fix is completed for the eth/65 known issue. #741 - Resolve crashing NAT detectors on GKE. #731 fixes #507. Besu-Kubernetes Readme updated to reflect changes.
- Deal with quick service start failures #714 fixes #662
Known Issues
Known issues are open issues categorized as Very High or High impact.
New known issues
Intrinsic gas exceeds gas limit
returned when callingdelete mapping[addr]
ormapping[addr] = 0
#696
Calling delete and set to 0 Solidity mapping in Solidity fail.
Previously identified known issues
- Eth/65 not backwards compatible
- Error full syncing with pruning
- Fast sync when running Besu on cloud providers
- Bootnodes must be validators when using onchain permissioning
- Privacy users with private transactions created using v1.3.4 or earlier
1.4.3
Issues identified with 1.4.3 release
The eth/65
change is not backwards compatible.
This has the following impact:
- In a private network, nodes using the 1.4.3 client cannot interact with nodes using 1.4.2 or earlier clients.
- On mainnet, synchronizing eventually stalls.
Workaround -> revert to v1.4.2.
A fix is currently being tested.
Critical Issue for Privacy Users
A critical issue for privacy users with private transactions created using Hyperledger Besu v1.3.4 or earlier has been identified. If you have a network with private transaction created using v1.3.4 or earlier, please read the following and take the appropriate steps: https://wiki.hyperledger.org/display/BESU/Critical+Issue+for+Privacy+Users
Additions and Improvements
- Added
eth/65
support. #608 - Added block added and block reorg events. Added revert reason to block added transactions. #637
Deprecated
- Private Transaction
hash
field andgetHash()
method have been deprecated. They will be removed in 1.5.0 release. #639
Known Issues
Fast sync when running Besu on cloud providers
A known RocksDB issue causes fast sync to fail when running Besu on certain cloud providers. The following error is displayed repeatedly:
...
EthScheduler-Services-1 (importBlock) | ERROR | PipelineChainDownloader | Chain download failed. Restarting after short delay.
java.util.concurrent.CompletionException: org.hyperledger.besu.plugin.services.exception.StorageException: org.rocksdb.RocksDBException: block checksum mismatch:
....
This behaviour has been seen on AWS and Digital Ocean.
Workaround -> On AWS, a full restart of the AWS VM is required to restart the fast sync.
Fast sync is not currently supported on Digital Ocean. We are investigating options to add support for fast sync on Digital Ocean.
Error full syncing with pruning
- Error syncing with mainnet on Besu 1.3.7 node - MerkleTrieException #580
The associated error is
Unable to load trie node value for hash
and is caused by the combination of full sync and pruning.
Workarounds:
- Explicitly disable pruning using
--pruning-enabled=false
when using fast sync. - If the
MerkleTrieException
occurs, delete the database and resync.
A fix for this issue is being actively worked on.
Fast sync reverting to full sync
In some cases of FastSyncException, fast sync reverts back to a full sync before having reached the pivot block. #683
Workaround -> To re-attempt fast syncing rather than continue full syncing, stop Besu, delete your database, and start again.
Bootnodes must be validators when using onchain permissioning
- Onchain permissioning nodes can't peer when using a non-validator bootnode #528
Workaround -> When using onchain permissioning, ensure bootnodes are also validators.
1.4.2
Additions and Improvements
- Added
trace_block
JSON RPC API #449 - Added
pulledStates
andknownStates
to the EthQLsyncing
query andeth_syncing
JSON-RPC api #565
Bug Fixes
- Fixed file parsing behaviour for privacy enclave keystore password file #554 (thanks to magooster)
- Fixed known issue with being unable to re-add members to onchain privacy groups #471
Updated Early Access Features
- Onchain privacy groups with add and remove members. Known issue resolved (see above).
- TRACE API now includes
trace_block
,trace_replayBlockTransactions
, andtrace_transaction
. Fixed some issues on the trace replay block transactions API #522.
Known Issues
Fast sync defaulting to full sync
- When fast sync cannot find enough valid peers rapidly enough, Besu defaults to full sync.
Workarounds:
- To re-attempt fast syncing rather than continue full syncing, stop Besu, delete your database, and start again.
- When fast syncing, explicitly disable pruning using
--pruning-enabled=false
to reduce the likelihood of encountering the pruning bug.
A fix to remove the default to full sync is in progress is being actively worked on.
Error full syncing with pruning
- Error syncing with mainnet on Besu 1.3.7 node - MerkleTrieException #BESU-160
The associated error is
Unable to load trie node value for hash
and is caused by the combination of full sync and pruning.
Workarounds:
- Explicitly disable pruning using
--pruning-enabled=false
when using fast sync. - If the
MerkleTrieException
occurs, delete the database and resync.
A fix for this issue is being actively worked on.
Bootnodes must be validators when using onchain permissioning
- Onchain permissioning nodes can't peer when using a non-validator bootnode #BESU-181
Workaround -> When using onchain permissioning, ensure bootnodes are also validators.
1.4.1
Additions and Improvements
- Added priv_getCode #250. Gets the bytecode associated with a private address.
- Added
trace_transaction
JSON RPC API #441 - Removed -X unstable prefix for pruning options (
--pruning-blocks-retained
,--pruning-block-confirmations
) #440 - Implemented ECIP-1088: Phoenix EVM and Protocol upgrades. #434
Bug Fixes
- BESU-25 Use v5 Devp2p when pinging #392
- Fixed a bug to manage concurrent access to cache files #438
- Fixed configuration file bug:
pruning-blocks-retained
now accepts an integer in the config #440 - Specifying RPC credentials file should not force RPC Authentication to be enabled #454
- Enhanced estimateGas messages #436. When a estimateGas request fails a validation check, an improved error message is returned in the response.
Early Access Features
Early access features are available features that are not recommended for production networks and may have unstable interfaces.
- Onchain privacy groups with add and remove members. Not being able to re-add a member to an onchain privacy group is a known issue with the add and remove functionality.
Known Issues
Fast sync defaulting to full sync
- When fast sync cannot find enough valid peers rapidly enough, Besu defaults to full sync.
Workarounds:
- To re-attempt fast syncing rather than continue full syncing, stop Besu, delete your database, and start again.
- When fast syncing, explicitly disable pruning using
--pruning-enabled=false
to reduce the likelihood of encountering the pruning bug.
A fix to remove the default to full sync is in progress and is planned for inclusion in v1.4.1.
Error full syncing with pruning
- Error syncing with mainnet on Besu 1.3.7 node - MerkleTrieException #BESU-160
The associated error is
Unable to load trie node value for hash
and is caused by the combination of full sync and pruning.
Workarounds:
- Explicitly disable pruning using
--pruning-enabled=false
when using fast sync. - If the
MerkleTrieException
occurs, delete the database and resync.
Investigation of this issue is in progress and a fix is targeted for v1.4.1.
Bootnodes must be validators when using onchain permissioning
- Onchain permissioning nodes can't peer when using a non-validator bootnode #BESU-181
Workaround -> When using onchain permissioning, ensure bootnodes are also validators.
1.4.0
Private State Migration
Hyperledger Besu v1.4 implements a new data structure for private state storage that is not backwards compatible. A migration will be performed when starting v1.4 for the first time to reprocess existing private transactions and re-create the private state data in the v1.4 format.
If you have existing private transactions, see migration details.
Additions and Improvements
-
TLS support to secure client and server communication.
-
Multi-tenancy to enable multiple participants to use the same Besu and Orion node.
-
Plugin APIs to enable building of Java plugins to extend Hyperledger Besu.
-
Support for additional NAT methods.
-
Added
priv_call
which invokes a private contract function locally and does not change the private state. -
Besu has moved from an internal Bytes library to the Apache Tuweni Bytes library. This includes using the library in the Plugins API interfaces. #295 and #215
Early Access Features
Early access features are available features that are not recommended for production networks and may have unstable interfaces.
-
Reorg compatible privacy to enable private transactions on networks using consensus mechanisms that fork.
-
Tracing API to obtain detailed information about transaction processing.
Bug Fixes
See RC and Beta sections below.
Known Issues
Fast sync defaulting to full sync
- When fast sync cannot find enough valid peers rapidly enough, Besu defaults to full sync.
Workarounds:
- To re-attempt fast syncing rather than continue full syncing, stop Besu, delete your database, and start again.
- When fast syncing, explicitly disable pruning using
--pruning-enabled=false
to reduce the likelihood of encountering the pruning bug.
A fix to remove the default to full sync is in progress and is planned for inclusion in v1.4.1.
Error full syncing with pruning
- Error syncing with mainnet on Besu 1.3.7 node - MerkleTrieException #BESU-160
The associated error is
Unable to load trie node value for hash
and is caused by the combination of full sync and pruning.
Workarounds:
- Explicitly disable pruning using
--pruning-enabled=false
when using fast sync. - If the
MerkleTrieException
occurs, delete the database and resync.
Investigation of this issue is in progress and a fix is targeted for v1.4.1.
Bootnodes must be validators when using onchain permissioning
- Onchain permissioning nodes can't peer when using a non-validator bootnode #BESU-181
Workaround -> When using onchain permissioning, ensure bootnodes are also validators.
1.4.0 RC-2
Private State Migration
Hyperledger Besu v1.4 implements a new data structure for private state storage that is not backwards compatible. A migration will be performed when starting v1.4 for the first time to reprocess existing private transactions and re-create the private state data in the v1.4 format. If you have existing private transactions, see migration details.
1.4.0 RC-1
Additions and Improvements
- New
trace_replayBlockTransactions
JSON-RPC API
This can be enabled using the --rpc-http-api TRACE
CLI flag. There are some philosophical differences between Besu and other implementations that are outlined in trace_rpc_apis.
- Ability to automatically detect Docker NAT settings from inside the container.
The default NAT method (AUTO) can detect this so no user intervention is required to enable this.
-
Added Multi-tenancy support which allows multiple participants to use the same Besu node for private transactions.
-
Added TLS support for communication with privacy enclave
Bug Fixes
- Private transactions are now validated before sent to the enclave #356
Known Bugs
- Error syncing with mainnet on Besu 1.3.7 node - MerkleTrieException #BESU-160
Workaround -> Don't enable pruning when syncing to mainnet.
- Onchain permissioning nodes can't peer when using a non-validator bootnode #BESU-181
Workaround -> When using onchain permissioning, ensure bootnodes are also validators.
1.4 Beta 3
Additions and Improvements
- CLI option to enable TLS client auth for JSON-RPC HTTP #340
Added CLI options to enable TLS client authentication and trusting client certificates:
--rpc-http-tls-client-auth-enabled - Enable TLS client authentication for the JSON-RPC HTTP service (default: false)
--rpc-http-tls-known-clients-file - Path to file containing client's certificate common name and fingerprint for client authentication.
--rpc-http-tls-ca-clients-enabled - Enable to accept clients certificate signed by a valid CA for client authentication (default: false)
If client-auth is enabled, user must either enable CA signed clients OR provide a known-clients file. An error is reported if both CA signed clients is disabled and known-clients file is not specified.
- Stable Plugins APIs #346
The BesuEvents
service and related data
package have been marked as a stable plugin API.
Bug Fixes
- Return missing signers from getSignerMetrics #343
Experimental Features
- Experimental support for
trace_replayBlockTransactions
- multiple PRs
Added support for the trace_replayBlockTransactions
JSON-RPC call. To enable this API add
TRACE
to the rpc-http-api
options (for example, --rpc-http-api TRACE
on the command line).
This is not a production ready API. There are known bugs relating to traced memory from calls and returns, and the gas calculation reported in the flat traces does not always match up with the correct gas calculated for consensus.
1.4 Beta 2
Additions and Improvements
- Enable TLS for JSON-RPC HTTP Service #253
Exposes new command line parameters to enable TLS on Ethereum JSON-RPC HTTP interface to allow clients like EthSigner to connect via TLS:
--rpc-http-tls-enabled=true
(Optional - Only required if --rpc-http-enabled
is set to true) Set to true
to enable TLS. False by default.
--rpc-http-tls-keystore-file="/path/to/cert.pfx"
(Must be specified if TLS is enabled) Path to PKCS12 format key store which contains server's certificate and it's private key
--rpc-http-tls-keystore-password-file="/path/to/cert.passwd"
(Must be specified if TLS is enabled) Path to the text file containing password for unlocking key store.
--rpc-http-tls-known-clients-file="/path/to/rpc_tls_clients.txt"
(Optional) Path to a plain text file containing space separated client’s certificate’s common name and its sha-256 fingerprints when
they are not signed by a known CA. The presence of this file (even empty) enables TLS client authentication. That is, the client
presents the certificate to server on TLS handshake and server establishes that the client certificate is either signed by a
proper/known CA. Otherwise, server trusts client certificate by reading the sha-256 fingerprint from known clients file specified above.
The format of the file is (as an example):
localhost DF:65:B8:02:08:5E:91:82:0F:91:F5:1C:96:56:92:C4:1A:F6:C6:27:FD:6C:FC:31:F2:BB:90:17:22:59:5B:50
Bug Fixes
- TotalDifficulty is a BigInteger #253. Don't try and cast total difficulty down to a long because it will overflow long in a reasonable timeframe.
1.4 Beta 1
Additions and Improvements
- Besu has moved from an internal Bytes library to the Apache Tuweni Bytes library. This includes using the library in the Plugins API interfaces. #295 and #215
- Besu stops processing blocks if Orion is unavailable #253
- Added priv_call #250. Invokes a private contract function locally and does not change the private state.
- Support for EIP-2124, which results in faster peer discovery #156
1.3.8
Additions and Improvements
admin_generateLogBloomCache
JSON-RPC API to generate a cache of the block bloombits that improves performance for log queries #262
Critical Fix in 1.3.7
1.3.7 includes a critical fix for Ethereum MainNet users and the Muir Glacier upgrade. We recommend users of Ethereum public networks (MainNet, Ropsten, Rinkeby, and Goerli) upgrade immediately. This upgrade is also strongly recommended for users of private networks.
For more details, see Hyperledger Besu Wiki.
Muir Glacier Compatibility
For compatibility with Ethereum Muir Glacier upgrade, use v1.3.7 or later.
ETC Agharta Compatibility
For compatibility with ETC Agharta upgrade, use 1.3.7 or later.
1.3.7
Additions and Improvements
- Hard Fork Support: Configures the Agharta activation block for the ETC MainNet configuration #251 (thanks to soc1c)
operator generate-log-bloom-cache
command line option to generate a cache of the block bloombits that improves performance for log queries #245
Bug Fixes
- Resolves a Mainnet consensus issue #254
New Maintainer
Edward Mack added as a new maintainer.
1.3.6
Additions and Improvements
- Performance improvements:
- EIP2384 - Ice Age Adustment around Istanbul #211
- Documentation updates include:
- Hard Fork Support:
- MuirGlacier for Ethereum Mainnet and Ropsten Testnet
- Agharta for Kotti and Mordor Testnets
Bug Fixes
- #210 fixes WebSocket frames handling User impact: PING/PONG frames handling in Websocket services was not implemented
1.3.5
Additions and Improvements
- Log Event Streaming for Plugin API #186
- Allow use a external JWT public key in authenticated APIs #183
- ETC Configuration, classic fork peer validator #176 (thanks to edwardmack)
- Allow IBFT validators to be changed at a given block #173
- Support external mining using Stratum #140 (thanks to atoulme)
- Add more fields to private transaction receipt #85 (thanks to josh-richardson)
- Pruning documentation
Technical Improvements
- ETC - Cleanup #201 (thanks to GregTheGreek)
- User specific enclave public key configuration in auth file #196
- Change CustomForks -> Transitions #193
- Pass identity information into RpcMethod from Http Service #189
- Remove the use of JsonRpcParameters from RpcMethods #188
- Repaired Metrics name collision between Privacy and RocksDB #187
- Multi-Tenancy: Do not specify a public key anymore when requesting a … #185
- Updates to circle building acceptance tests #184
- Move Apache Tuweni dependency to official release #181 (thanks to atoulme)
- Update Gradle to 6.0, support Java 13 #180
- ETC Atlantis fork #179 (thanks to edwardmack)
- ETC Gotham Fork #178 (thanks to edwardmack)
- ETC DieHard fork support #177 (thanks to edwardmack)
- Remove 'parentHash', 'number' and 'gasUsed' fields from the genesis d… #175 (thanks to SweeXordious)
- Enable pruning by default for fast sync and validate conflicts with privacy #172
- Update RocksDB #170
- Vpdate ver to 1.3.5-snapshot #169
- Added PoaQueryService method that returns local node signer… #163
- Add versioning to privacy storage #149
- Update reference tests #139
1.3.4
1.3.3
Technical Improvements
- Add --identity flag for client identification in node browsers #150
- Istanbul Mainnet Block #145
- Add priv_getEeaTransactionCount #110
Additions and Improvements
- Redesign of how JsonRpcMethods are created #159
- Moving JsonRpcMethods classes into the same package, prior to refactor #154
- Reflect default logging in CLI help #148
- Handle zero port better in NAT #147
- Rework how filter and log query parameters are created/used #146
- Don't generate shutdown tasks in controller #141
- Ibft queries #138
- Enable pruning by default for fast sync #135
- Ensure spotless runs in CI #132
- Add more logging around peer disconnects #131
- Repair EthGetLogs returning incorrect results #128
- Use Bloombits for Logs queries #127
- Improve message when extraData missing #121
- Fix miner startup logic #104
- Support log reordring from reorgs in
LogSubscriptionService
#86
1.3.2
Additions and Improvements
- besu -v to print plugin versions#123
Technical Improvements
- Update Governance and Code of Conduct verbiage #120
- Fix private transaction root mismatch #118
- Programmatically enforce plugin CLI variable names #117
- Additional unit test for selecting replaced pending transactions #116
- Only set sync targets that have an estimated height value #115
- Fix rlpx startup #114
- Expose getPayload in Transaction plugin-api interface. #113
- Dependency Version Upgrades #112
- Add hash field in Transaction plugin interface. #111
- Rework sync status events #106
1.3.1
Additions and Improvements
- Added GraphQL query/logs support #94
Technical Improvements
- Add totalDiffculty to BlockPropagated events. #97
- Merge BlockchainQueries classes #101
- Fixed casing of dynamic MetricCategorys #99
- Fix private transactions breaking evm #96
- Make SyncState variables thread-safe #95
- Fix transaction tracking by sender #93
- Make logic in PersistBlockTask more explicit to fix a LGTM warning #92
- Removed Unused methods in the transaction simulator. #91
- Fix ThreadBesuNodeRunner BesuConfiguration setup #90
- JsonRpc method disabled error condition rewrite and unit test #80
- Round trip testing of state trie account values #31
1.3
Breaking Change
- Disallow comments in Genesis JSON file. #49
Additions and Improvements
- Add
--required-block
command line option to deal with chain splits #79 - Store db metadata file in the root data directory. #46
- Add
--target-gas-limit
command line option. #24(thanks to new contributor cfelde) - Allow private contracts to access public state. #9
- Documentation updates include:
- Added sample load balancer configurations
- Added
retesteth
subcommand - Added
debug_accountRange
JSON-RPC API method - Clarified purpose of static nodes
- Added links Kubernetes reference implementations
- Added content about access between private and public states
- Added restriction that account permissioning cannot be used with random key signing.
- Added high availability requirement for private transaction manager (ie, Orion)
- Added genesis file reference
Technical Improvements
- Less verbose syncing subscriptions #59
- Return enclave key instead of private transaction hash #53
- Fix mark sweep pruner bugs where nodes that should be kept were being swept #50
- Clean up BesuConfiguration construction #51
- Private tx nonce errors return same msg as any tx #48
- Fix default logging #47
- Introduce virtual operation. #45
- Downgrade RocksDBPlugin Logging Levels #44
- Infrastructure for exposing PoA metrics for plugins. #37
- Refactor privacy storage. #7
1.2.4
Additions and Improvements
- Add Istanbul block (5435345) for Rinkeby #35
- Add Istanbul block (1561651) for Goerli #27
- Add Istanbul block (6485846) for Ropsten #26
- Add privDistributeRawTransaction endpoint #23 (thanks to josh-richardson)
Technical Improvements
- Refactors pantheon private key to signing private key #34 (thanks to josh-richardson)
- Support both BESU_ and PANTHEON_ env var prefixes #32
- Use only fully validated peers for fast sync pivot selection #21
- Support Version Rollbacks for RocksDB (#6) #19
- Update Cava library to Tuweni Library #18
- StateTrieAccountValue:Version should be written as an int, not a long #17
- Handle discovery peers with updated endpoints #12
- Change retesteth port #11
- Renames eea_getTransactionReceipt to priv_getTransactionReceipt #10 (thanks to josh-richardson)
- Support Version Rollbacks for RocksDB #6
- Moving AT DSL into its own module #3
1.2.3
Additions and Improvements
- Added an override facility for genesis configs #1915
- Finer grained logging configuration #1895 (thanks to matkt)
Technical Improvements
- Add archiving of docker test reports #1921
- Events API: Transaction dropped, sync status, and renames #1919
- Remove metrics from plugin registration #1918
- Replace uses of Instant.now from within the IBFT module #1911
- Update plugins-api build script #1908
- Ignore flaky tracing tests #1907
- Ensure plugin-api module gets published at the correct maven path #1905
- Return the plugin-apis to this repo #1900
- Stop autogenerating BesuInfo.java #1899
- Extracted Metrics interfaces to plugins-api. #1898
- Fix key value storage clear so it removes all values #1894
- Ethsigner test #1892 (thanks to iikirilov)
- Return null private transaction receipt instead of error #1872 (thanks to iikirilov)
- Implement trace replay block transactions trace option #1886
- Use object parameter instead of list of parameters for priv_createPrivacyGroup #1868 (thanks to iikirilov)
- Refactor privacy acceptance tests #1864 (thanks to iikirilov)
1.2.2
Additions and Improvements
- Support large numbers for the
--network-id
option #1891 - Added eea_getTransactionCount Json Rpc #1861
- PrivacyMarkerTransaction to be signed with a randomly generated key #1844
- Implement eth_getproof JSON RPC API #1824 (thanks to matkt)
- Documentation updates include:
Technical Improvements
- Update the
pantheon blocks export
command usage #1887 (thanks to matkt) - Stop Returning null for 'pending' RPC calls #1883
- Blake validation errors are hard errors #1882
- Add test cases for trace_replayBlockTransactions #1881
- Simplify json rpc spec test setup #1880
- Tweak JSON import format #1878
- Transactions listeners should use the subscriber pattern #1877
- Maven spotless #1876
- Don't cache for localbalance #1875
- EIP-1108 - Reprice alt_bn128 #1874
- Create stub trace_replayBlockTransactions json-rpc method #1873
- Improve trace log #1870
- Pruning Command Line Flags #1869
- Re-enable istanbul #1865
- Fix logic to disconnect from peers on fork #1863
- Blake 2b tweaks #1862
- Sweep state roots before child nodes #1854
- Update export subcommand to export blocks in rlp format #1852
- Updating docker tests to make it easier to follow & ensure it listens on the right interface on docker #1851
- Disable Istanbul block #1849
- Add read-only blockchain factory method #1845
- Removing the release plugin in favour of the new process with branches #1843
- Update Görli bootnodes #1842
- Upgrade graphql library to version 13.0 #1834
- Database versioning and enable multi-column database #1830
- Fixes invalid JsonGetter, comment #1811 (thanks to josh-richardson)
- Add EthSigner acceptance test #1655 (thanks to iikirilov)
- Support plugin Richdata APIs via implementation #1581
1.2.1
Additions and Improvements
- Removed the release plugin in favour of the new process with branches #1841 #1843 #1848 #1855
- Updated Görli bootnodes #1842
- Removed unnecessary test dependency #1839
- Added warning when comments are used in genesis file #1838
- Added an experimental flag for disabling timers #1837
- Fixed FlatFileTaskCollection tests #1833
- Added chain json import utility #1832
- Added tests to AllNodesVisitor trie traversal #1831
- Updated privateFrom to be required #1829 (thanks to iikirilov)
- Made explicit that streamed accounts may be missing their address #1828
- Refactored normalizeKeys method #1826
- Removed dead parameters #1825
- Added a nicer name for Corretto #1819
- Changed core JSON-RPC method to support ReTestEth #1815 #1818
- Added rewind to block functionality #1814
- Added support for NoReward and NoProof seal engines #1813
- Added strict short hex strings for retesteth #1812
- Cleaned up genesis parsing #1809
- Updating Orion to v1.3.2 #1805
- Updaated newHeads subscription to emit events only for canonical blocks #1798
- Repricing for trie-size-dependent opcodes #1795
- Revised Istanbul Versioning assignments #1794
- Updated RevertReason to return BytesValue #1793
- Updated way priv_getPrivacyPrecompileAddress source #1786 (thanks to iikirilov)
- Updated Chain ID opcode to return 0 as default #1785
- Allowed fixedDifficulty=1 #1784
- Updated Docker image defaults host interfaces #1782
- Added tracking of world state account key preimages #1780
- Modified PrivGetPrivateTransaction to take public tx hash #1778 (thanks to josh-richardson)
- Removed enclave public key from parameter #1789 #1777 (thanks to iikirilov)
- Added storage key preimage tracking #1772
- Updated priv_getPrivacyPrecompileAddress method return #1766 (thanks to iikirilov)
- Added tests for permissioning with static nodes behaviour #1764
- Added integration test for contract creation with privacyGroupId #1762 (thanks to josh-richardson)
- Added report node local address as the coinbase in Clique and IBFT #1758 #1760
- Fixed private tx signature validation #1753
- Updated CI configuration #1751 #1835
- Added CLI flag for setting WorldStateDownloader task cache size #1749 (thanks to matkt)
- Updated vertx to 2.8.0 #1748
- changed RevertReason to BytesValue #1746
- Added static nodes acceptance test #1745
- Added report 0 hashrate when the mining coordinator doesn't support mining #1744 #1757
- Implemented EIP-2200 - Net Gas Metering Revised #1743
- Added chainId validation to PrivateTransactionValidator #1741
- Reduced intrinsic gas cost #1739
- De-duplicated test blocks data files #1737
- Renamed various EEA methods to priv methods #1736 (thanks to josh-richardson)
- Permissioning Acceptance Test #1735 #1759
- Add nonce handling to GenesisState #1728
- Added 100-continue to HTTP #1727
- Fixed get_signerMetrics #1725 (thanks to matkt)
- Reworked "in-sync" checks #1720
- Added Accounts Permissioning Acceptance Tests #1719
- Added PrivateTransactionValidator to unify logic #1713
- Added JSON-RPC API to report validator block production information #1687 (thanks to matkt)
- Added Mark Sweep Pruner #1638
- Added the Blake2b F compression function as a precompile in Besu #1614 (thanks to iikirilov)
- Documentation updates include:
- Added CPU requirements #1734
- Added reference to Ansible role #1733
- Updated revert reason example #1754
- Added content on deploying for production #1774
- Updated docker docs for location of data path #1790
- Updated permissiong documentation #1792 #1652
- Added permissioning webinar in the resources #1717
- Add web3.js-eea reference doc #1617
- Updated privacy documentation #1650 #1721 #1722 #1724 #1729 #1730 #1731 #1732 #1740 #1750 #1761 #1765 #1769 #1770 #1771 #1773 #1787 #1788 #1796 #1803 #1810 #1817
- Added documentation for getSignerMetrics #1723 (thanks to matkt)
- Added Java 11+ as a prerequisite for installing Besu using Homebrew. #1755
- Fixed documentation formatting and typos #1718 #1742 #1763 #1779 #1781 #1827 #1767 (thanks to helderjnpinto)
- Moved the docs to a new doc repos #1822
- Explicitly configure some maven artifactIds #1853
- Update export subcommand to export blocks in rlp format #1852
- Implement
eth_getproof
JSON RPC API #1824 - Database versioning and enable multi-column database #1830
- Disable smoke tests on windows #1847
- Add read-only blockchain factory method #1845
1.2
Additions and Improvements
- Add UPnP Support #1334 (thanks to notlesh)
- Limit the fraction of wire connections initiated by peers #1665
- EIP-1706 - Disable SSTORE with gasleft lt call stipend #1706
- EIP-1108 - Reprice alt_bn128 #1704
- EIP-1344 ChainID Opcode #1690
- New release docker image #1664
- Support changing log level at runtime #1656 (thanks to matkt)
- Implement dump command to dump a specific block from storage #1641 (thanks to matkt)
- Add eea_findPrivacyGroup endpoint to Besu #1635 (thanks to Puneetha17)
- Updated eea send raw transaction with privacy group ID #1611 (thanks to iikirilov)
- Added Revert Reason #1603
- Documentation updates include:
- Added UPnP content
- Added load balancer image
- Added revert reason
- Added admin_changeLogLevel JSON RPC API (thanks to matkt)
- Updated for new Docker image
- Added Docker image migration content
- Added transaction validation content
- Updated permissioning overview for onchain account permissioning
- Updated quickstart to include Prometheus and Grafana
- Added remote connections limits options
- Updated web3.js-eea reference to include privacy group methods
- Updated onchain permissioning to include account permissioning and Permissioning Management Dapp
- Added deployment procedure for Permissioning Management Dapp
- Added privacy content for EEA-compliant and Besu-extended privacy
- Added content on creating and managing privacy groups
- Added content on accessing private and privacy marker transactions
- Added content on system requirements
- Added reference to Besu role on Galaxy to deploy using Ansible.
Technical Improvements
- Remove enclave public key from parameter #1789
- Update defaults host interfaces #1782
- Modifies PrivGetPrivateTransaction to take public tx hash #1778
- Remove enclave public key from parameter #1777
- Return the ethereum address of the privacy precompile from priv_getPrivacyPrecompileAddress #1766
- Report node local address as the coinbase in Clique and IBFT #1760
- Additional integration test for contract creation with privacyGroupId #1762
- Report 0 hashrate when the mining coordinator doesn't support mining #1757
- Fix private tx signature validation #1753
- RevertReason changed to BytesValue #1746
- Renames various eea methods to priv methods #1736
- Update Orion version #1716
- Rename CLI flag for better ordering of options #1715
- Routine dependency updates #1712
- Fix spelling error in getApplicationPrefix method name #1711
- Wait and retry if best peer's chain is too short for fast sync #1708
- Eea get private transaction fix #1707 (thanks to iikirilov)
- Rework remote connection limit flag defaults #1705
- Report invalid options from config file #1703
- Add ERROR to list of CLI log level options #1699
- Enable onchain account permissioning CLI option #1686
- Exempt static nodes from all connection limits #1685
- Enclave refactoring #1684
- Add opcode and precompiled support for versioning #1683
- Use a percentage instead of fraction for the remote connections percentage CLI option. #1682
- Added error msg for calling eth_sendTransaction #1681
- Remove instructions for installing with Chocolatey #1680
- remove zulu-jdk8 from smoke tests #1679
- Add new MainNet bootnodes #1678
- updating smoke tests to use >= jdk11 #1677
- Fix handling of remote connection limit #1676
- Add accountVersion to MessageFrame #1675
- Change getChildren return type #1674
- Use Log4J message template instead of String.format #1673
- Return hashrate of 0 when not mining. #1672
- Add hooks for validation #1671
- Upgrade to pantheon-build:0.0.6-jdk11 which really does include jdk11 #1670
- Onchain permissioning startup check #1669
- Update BesuCommand to accept minTransactionGasPriceWei as an integer #1668 (thanks to matkt)
- Privacy group id consistent #1667 (thanks to iikirilov)
- Change eea_getPrivateTransaction endpoint to accept hex #1666 (thanks to Puneetha17)
- Factorise metrics code for KeyValueStorage database #1663)
- Create a metric tracking DB size #1662
- AT- Removing unused methods on KeyValueStorage #1661
- Add Prerequisites and Quick-Start #1660 (thanks to lazaridiscom)
- Java 11 updates #1658
- Make test generated keys deterministic w/in block generator #1657
- Rename privacyGroupId to createPrivacyGroupId #1654 (thanks to Puneetha17)
- Intermittent Test Failures in TransactionsMessageSenderTest #1653
- Sanity check the generated distribution files before upload #1648
- Use JDK 11 for release builds #1647
- Support multiple private marker transactions in a block #1646
- Display World State Sync Progress in Logs #1645
- Remove the docker gradle plugin, handle building docker with shell now #1644
- Switch to using metric names from EIP-2159 #1634
- Account versioning #1612
1.1.4
Additions and Improvements
- [PAN-2832] Support setting config options via environment variables #1597
- Print Besu version when starting #1593
- [PAN-2746] Add eea_createPrivacyGroup & eea_deletePrivacyGroup endpoint #1560 (thanks to Puneetha17)
Documentation updates include:
- Added readiness and liveness endpoints
- Added high availability content
- Added web3js-eea client library
- Added content on setting CLI options using environment variables
Technical Improvements
- Read config from env vars when no config file specified #1639
- Upgrade jackson-databind to 2.9.9.1 #1636
- Update Reference Tests #1633
- Ignore discport during static node permissioning check #1631
- Check connections more frequently during acceptance tests #1630
- Refactor experimental CLI options #1629
- JSON-RPC api net_services should display the actual ports #1628
- Refactor CLI #1627
- Simplify BesuCommand
run
andparse
methods. #1626 - PAN-2860: Ignore discport during startup whitelist validation #1625
- Freeze plugin api version #1624
- Implement incoming transaction messages CLI option as an unstable command. #1622
- Update smoke tests docker images for zulu and openjdk to private ones #1620
- Remove duplication between EeaTransactionCountRpc & PrivateTransactionHandler #1619
- [PAN-2709] - nonce too low error #1618
- Cache TransactionValidationParams instead of creating new object for each call #1616
- [PAN-2850] Create a transaction pool configuration object #1615
- Add TransactionValidationParam to TxProcessor #1613
- Expose a CLI option to configure the life time of transaction messages. #1610
- Implement Prometheus metric counter for skipped expired transaction messages. #1609
- Upload jars to bintray as part of releases #1608
- Avoid publishing docker-pantheon directory to bintray during a release #1606
- [PAN-2756] Istanbul scaffolding #1605
- Implement a timeout in TransactionMessageProcessor #1604
- Reject transactions with gas price below the configured minimum #1602
- Always build the k8s image, only push to dockerhub for master branch #1601
- Properly validate AltBN128 pairing precompile input #1600
- [PAN-2871] Columnar rocksdb #1599
- Reverting change to dockerfile #1594
- Update dependency versions #1592
- [PAN-2797] Clean up failed connections #1591
- Cleaning up the build process for docker #1590
- [PAN-2786] Stop Transaction Pool Queue from Growing Unbounded #1586
1.1.3
Additions and Improvements
- [PAN-2811] Be more lenient with discovery message deserialization. Completes our support for EIP-8 and enables Besu to work on Rinkeby again. #1580
- Added liveness and readiness probe stub endpoints #1553
- Implemented operator tool. (blockchain network configuration for permissioned networks) #1511
- [PAN-2754] Added eea_getPrivacyPrecompileAddress #1579 (thanks to Puneetha17)
- Publish the chain head gas used, gas limit, transaction count and ommer metrics #1551
- Add subscribe and unsubscribe count metrics #1541
- Add pivot block metrics #1537
Documentation updates include:
- Updated IBFT 2.0 tutorial to use network configuration tool
- Added debug_traceBlock* methods
- Reorganised monitoring documentation
- Added link to sample Grafana dashboard
- Added note about replacing transactions in transaction pool
- Updated example transaction scripts
- Updated Alethio Ethstats and Explorer documentation
Technical Improvements
- PAN-2816: Hiding experimental account permissioning cli options #1584
- [PAN-2630] Synchronizer should disconnect the sync target peer on invalid block data #1578
- Rename MetricCategory to BesuMetricCategory #1574
- Convert MetricsConfigiguration to use a builder #1572
- PAN-2794: Including flag for onchain permissioning check on tx processor #1571
- Fix behaviour for absent account permissiong smart contract #1569
- Expand readiness check to check peer count and sync state #1568
- [PAN-2798] Reorganize p2p classes #1567
- PAN-2729: Account Smart Contract Permissioning ATs #1565
- Timeout build after 1 hour to prevent it hanging forever. #1564
- [PAN-2791] Make permissions checks for ongoing connections more granular #1563
- [PAN-2721] Fix TopicParameter deserialization #1562
- [PAN-2779] Allow signing private transaction with any key #1561 (thanks to iikirilov)
- [PAN-2783] Invert dependency between permissioning and p2p #1557
- Removing account filter from TransactionPool #1556
- [PAN-1952] - Remove ignored pending transaction event publish acceptance test #1552
- Make MetricCategories more flexible #1550
- Fix encoding for account permissioning check call #1549
- Discard known remote transactions prior to validation #1548
- [PAN-2009] - Fix cluster clean start after stop in Acceptance tests #1546
- FilterIdGenerator fixes #1544
- Only increment the added transaction counter if we actually added the transaction #1543
- When retrieving transactions by hash, check the pending transactions first #1542
- Fix thread safety in SubscriptionManager #1540
- [PAN-2731] Extract connection management from P2PNetwork #1538
- [PAN-2010] format filter id as quantity #1534
- PAN-2445: Onchain account permissioning #1507
- [PAN-2672] Return specific and useful error for enclave issues #1455 (thanks to Puneetha17)
1.1.2
Additions and Improvements
Documentation updates include:
- Added GraphQL options
- Added troubleshooting point about illegal reflective access error
- Added trusted bootnode behaviour for permissioning
- Added how to obtain a WS authentication token
- Updated example scripts and added package.json file for creating signed transactions
Technical Improvements
- Replaced Void datatype with void #1530
- Fix estimate gas RPC failing for clique when no blocks have been created #1528
- Avoid auto-boxing for gauge metrics #1526
- Add AT to ensure 0-miner Clique/IBFT are valid #1525
- AT DSL - renaming to suffix of Conditions and co-locating with Conditions #1524
- Set disconnect flag immediately when disconnecting a peer #1521
- [PAN-2547] Modified JSON-RPC subscription processing to avoid blocking #1519
- Dependency Version Updates #1517
- AT DSL - renaming ibft to ibft2 #1516
- [PIE-1578] Added local transaction permissioning metrics #1515
- [PIE-1577] Added node local metrics #1514
- AT DSL - Removing WaitCondition, consistently applying Condition instead #1513
- Remove usage of deprecated ConcurrentSet #1512
- Log error if clique or ibft have 0 validators in genesis #1509
- GraphQL library upgrade changes. #1508
- Add metrics to assist monitoring and alerting #1506
- Use external pantheon-plugin-api library #1505
- Tilde #1504
- Dependency version updates #1503
- Simplify text #1501 (thanks to bgravenorst)
- [PAN-1625] Clique AT mining continues if validator offline #1500
- Acceptance Test DSL Node refactoring #1498
- Updated an incorrect command #1497 (thanks to bgravenorst)
- Acceptance Test and DSL rename for IBFT2 #1493
- [PIE-1580] Metrics for smart contract permissioning actions #1492
- Handle RLPException when processing incoming DevP2P messages #1491
- Limit spotless checks to java classes in expected java dirs #1490
- [PAN-2560] Add LocalNode class #1489
- Changed Enode length error String implementation. #1486
- PAN-2715 - return block not found reasons in error #1485
- [PAN-2652] Refactor Privacy acceptance test and add Privacy Ibft test #1483 (thanks to iikirilov)
- [PAN-2603] Onchain account permissioning support #1475
- Make CLI options names with hyphen-minus searchable and reduce index size #1476
- Added warning banner when using latest version #1454
- Add RTD config file to fix Python version issue #1453
- [PAN-2647] Validate Private Transaction nonce before submitting to Transaction Pool #1449 (thanks to iikirilov)
- Add placeholders system to have global variables in markdown #1425
1.1.1
Additions and Improvements
- GraphQL #1311 (thanks to zyfrank)
- Added
--tx-pool-retention-hours
#1333 - Added Genesis file support for specifying the maximum stack size. #1431
- Included transaction details when subscribed to Pending transactions #1410
- Documentation updates include:
Technical Improvements
- Create MaintainedPeers class #1484
- Fix for permissioned network with single bootnode #1479
- Have ThreadBesuNodeRunner support plugin tests #1477
- Less pointless plugins errors #1473
- Rename GraphQLRPC to just GraphQL #1472
- eth_protocolVersion is a Quantity, not an Integer #1470
- Don't require 'to' in 'blocks' queries #1464
- Events Plugin - Add initial "NewBlock" event message #1463
- Make restriction field in Private Transaction an enum #1462 (thanks to iikirilov)
- Helpful graphql error when an account doesn't exist #1460
- Acceptance Test Cleanup #1458
- Large chain id support for private transactions #1452
- Optimise TransactionPool.addRemoteTransaction #1448
- Reduce synchronization in PendingTransactions #1447
- Add simple PeerPermissions interface #1446
- Make sure ThreadBesuNodeRunner is exercised by automation #1442
- Decode devp2p packets off the event thread #1439
- Allow config files to specify no bootnodes #1438
- Capture all logs and errors in the Besu log output #1437
- Ensure failed Txns are deleted when detected during mining #1436
- Plugin Framework #1435
- Equals cleanup #1434
- Transaction smart contract permissioning controller #1433
- Renamed AccountPermissioningProver to TransactionPermissio… #1432
- Refactorings and additions to add Account based Smart Contract permissioning #1430
- Fix p2p PeerInfo handling #1428
- IbftProcessor logs when a throwable terminates mining #1427
- Renamed AccountWhitelistController #1424
- Unwrap DelegatingBytes32 and prevent Hash from wrapping other Hash instances #1423
- If nonce is invalid, do not delete during mining #1422
- Deleting unused windows jenkinsfile #1421
- Get all our smoke tests for all platforms in 1 jenkins job #1420
- Add pending object to GraphQL queries #1419
- Start listening for p2p connections after start() is invoked #1418
- Improved JSON-RPC responses when EnodeURI parameter has invalid EnodeId #1417
- Use port 0 when starting a websocket server in tests #1416
- Windows jdk smoke tests #1413
- Change AT discard RPC tests to be more reliable by checking discard using proposals #1411
- Simple account permissioning #1409
- Fix clique miner to respect changes to vanity data made via JSON-RPC #1408
- Avoid recomputing the logs bloom filter when reading receipts #1407
- Remove NodePermissioningLocalConfig external references #1406
- Add constantinople fix block for Rinkeby #1404
- Update EnodeURL to support enodes with listening disabled #1403
- Integration Integration test(s) on p2p of 'net_services' #1402
- Reference tests fail on Windows #1401
- Fix non-deterministic test caused by variable size of generated transactions #1399
- Start BlockPropagationManager immediately - don't wait for full sync #1398
- Added error message for RPC method disabled #1396
- Fix intermittency in FullSyncChainDownloaderTest #1394
- Add explanatory comment about default port #1392
- Handle case where peers advertise a listening port of 0 #1391
- Cache extra data #1389
- Update Log message in IBFT Controller #1387
- Remove unnecessary field #1384
- Add getPeer method to PeerConnection #1383
- Removing smart quotes #1381 (thanks to jmcnevin)
- Use streams and avoid iterating child nodes multiple times #1380
- Use execute instead of submit so unhandled exceptions get logged #1379
- Prefer EnodeURL over Endpoint #1378
- Add flat file based task collection #1377
- Consolidate local enode representation #1376
- Rename rocksdDbConfiguration to rocksDbConfiguration #1375
- Remove EthTaskChainDownloader and supporting code #1373
- Handle the pipeline being aborted while finalizing an async operation #1372
- Rename methods that create and return streams away from getX() #1368
- eea_getTransactionCount fails if account has not interacted with private state #1367 (thanks to iikirilov)
- Increase RocksDB settings #1364 (ajsutton)
- Don't abort in-progress master builds when a new commit is added. #1358
- Request open ended headers from sync target #1355
- Enable the pipeline chain downloader by default #1344
- Create P2PNetwork Builder #1343
- Include static nodes in permissioning logic #1339
- JsonRpcError decoding to include message #1336
- Cache current chain head info #1335
- Queue pending requests when all peers are busy #1331
- Fix failed tests on Windows #1332
- Provide error message when invalid key specified in key file #1328
- Allow whitespace in file paths loaded from resources directory #1329
- Allow whitespace in path #1327
- Require block numbers for debug_traceBlockByNumber to be in hex #1326
- Improve logging of chain download errors in the pipeline chain downloader #1325
- Ensure eth scheduler is stopped in tests #1324
- Normalize account permissioning addresses in whitelist #1321
- Allow private contract invocations in multiple privacy groups #1318 (thanks to iikirilov)
- Fix account permissioning check case matching #1315
- Use header validation mode for ommers #1313
- Configure RocksDb max background compaction and thread count #1312
- Missing p2p info when queried live #1310
- Tx limit size send peers follow up #1308
- Remove remnants of the old dev mode #1307
- Remove duplicate init code from BesuController instances #1305
- Stop synchronizer prior to stopping the network #1302
- Evict old transactions #1299
- Send local transactions to new peers #1253
1.1
Additions and Improvements
- Privacy
- Onchain Permissioning
- Fastsync
- Documentation updates include:
Technical Improvements
- priv_getTransactionCount fails if account has not interacted with private state #1369
- Updating Orion to 0.9.0 #1360
- Allow use of large chain IDs #1357
- Allow private contract invocations in multiple privacy groups #1340
- Missing p2p info when queried live #1338
- Fix expose transaction statistics #1337
- Normalize account permissioning addresses in whitelist #1321
- Update Enclave executePost method #1319
- Fix account permissioning check case matching #1315
- Removing 'all' from the help wording for host-whitelist #1304
1.1 RC
Technical Improvements
- Better errors for when permissioning contract is set up wrong #1296
- Consolidate p2p node info methods #1288
- Update permissioning smart contract interface to match updated EEA proposal #1287
- Switch to new sync target if it exceeds the td threshold #1286
- Fix running ATs with in-process node runner #1285
- Simplify enode construction #1283
- Cleanup PeerConnection interface #1282
- Undo changes to PendingTransactions method visibility #1281
- Use default enclave public key to generate eea_getTransactionReceipt #1280 (thanks to Puneetha17)
- Rollback to rocksdb 5.15.10 #1279
- Log error when a JSON decode problem is encountered #1278
- Create EnodeURL builder #1275
- Keep enode nodeId stored as a BytesValue #1274
- Feature/move subclass in pantheon command #1272
- Expose sync mode option #1270
- Refactor RocksDBStats #1266
- Normalize EnodeURLs #1264
- Build broken in Java 12 #1263
- Make PeerDiscovertAgentTest less flakey #1262
- Ignore extra json rpc params #1261
- Fetch local transactions in isolation #1259
- Update to debug trace transaction #1258
- Use labelled timer to differentiate between rocks db metrics #1254 (thanks to Puneetha17)
- Migrate TransactionPool (& affiliated test) from 'core' to 'eth' #1251
- Use single instance of Rocksdb for privacy #1247 (thanks to Puneetha17)
- Subscribing to sync events should receive false when in sync #1240
- Ignore transactions from the network while behind chain head #1228
- RocksDB Statistics in Metrics #1169
- Add block trace RPC methods #1088 (thanks to kziemianek)
1.0.3
Additions and Improvements
- Notify of dropped messages #1156
- Documentation updates include:
- Added Permissioning Overview
- Added content on Network vs Node Configuration
- Updated RAM requirements
- Added Privacy Overview and Processing Private Transactions
- Renaming of Ethstats Lite Explorer to Ethereum Lite Explorer (thanks to tzapu)
- Added content on using Truffle with Besu
- Added
droppedPendingTransactions
RPC Pub/Sub subscription - Added
eea_*
JSON-RPC API methods - Added architecture diagram
- Updated permissioning CLI options and permissioned network tutorial
Technical Improvements
- Choose sync target based on td rather than height #1256
- CLI ewp options #1246
- Update BesuCommand.java #1245
- Reduce memory usage in import #1239
- Improve eea_sendRawTransaction error messages #1238 (thanks to Puneetha17)
- Single topic filter #1235
- Enable pipeline chain downloader for fast sync #1232
- Make contract size limit configurable #1227
- Refactor PrivacyParameters config to use builder pattern #1226 (thanks to antonydenyer)
- Different request limits for different request types #1224
- Finish off fast sync pipeline download #1222
- Enable fast-sync options on command line #1218
- Replace filtering headers after the fact with calculating number to request up-front #1216
- Support async processing while maintaining output order #1215
- Add Unstable Options to the CLI #1213
- Add private cluster acceptance tests #1211 (thanks to Puneetha17)
- Re-aligned smart contract interface to EEA client spec 477 #1209
- Count the number of items discarded when a pipe is aborted #1208
- Pipeline chain download - fetch and import data #1207
- Permission provider that allows bootnodes if you have no other connections #1206
- Cancel in-progress async operations when the pipeline is aborted #1205
- Pipeline chain download - Checkpoints #1203
- Push development images to public dockerhub #1202
- Push builds of master as docker development images #1200
- Doc CI pipeline for build and tests #1199
- Replace the use of a disconnect listener with EthPeer.isDisconnected #1197
- Prep chain downloader for branch by abstraction #1194
- Maintain the state of MessageFrame in private Tx #1193 (thanks to Puneetha17)
- Persist private world state only if we are mining #1191 (thanks to Puneetha17)
- Remove SyncState from SyncTargetManager #1188
- Acceptance tests base for smart contract node permissioning #1186
- Fix metrics breakages #1185
- Typo #1184 (thanks to araskachoi)
- StaticNodesParserTest to pass on Windows #1183
- Don't mark world state as stalled until a minimum time without progress is reached #1179
- Use header validation policy in DownloadHeaderSequenceTask #1172
- Bond with bootnodes #1160
1.0.2
Additions and Improvements
- Removed DB init when using
public-key
subcommand #1049 - Output enode URL on startup #1137
- Added Remove Peer JSON-RPC #1129
- Added
net_enode
JSON-RPC #1119 (thanks to mbergstrand) - Maintain a
staticnodes.json
#1106 - Added
tx-pool-max-size
command line parameter #1078 - Added PendingTransactions JSON-RPC #1043 (thanks to EdwinLeeGreene)
- Added
admin_nodeInfo
JSON-RPC #1012 - Added
--metrics-category
CLI to only enable select metrics #969 - Documentation updates include:
- Updated endpoints in Private Network Quickstart (thanks to laubai)
- Updated documentation contribution guidelines
- Added
admin_removePeer
- Updated tutorials for printing of enode on startup
- Added
txpool_pantheonTransactions
- Added Transaction Pool content
- Added
tx-pool-max-size
CLI option - Updated developer build instructions to use installDist
- Added Azure quickstart tutorial
- Enabled copy button in code blocks
- Added IBFT 1.0
- Added section on using Geth attach with Besu
- Enabled the edit link doc site to ease external doc contributions
- Added EthStats docs (thanks to baxy)
- Updated Postman collection
- Added
metrics-category
CLI option - Added information on block time and timeout settings for IBFT 2.0
- Added
admin_nodeInfo
- Added permissions images
- Added permissioning blog to Resources
- Updated Create Permissioned Network tutorial to use
export-address
- Updated Clique and IBFT 2.0 docs to include complete genesis file
- Updated Clique tutorial to use
export-address
subcommand - Added IBFT 2.0 future message configuration options
Technical Improvements
- Fixed so self persists to the whitelist #1176
- Fixed to add self to permissioning whitelist #1175
- Fixed permissioning issues #1174
- AdminAddPeer returns custom Json RPC error code #1171
- Periodically connect to peers from table #1170
- Improved bootnodes option error message #1092
- Automatically restrict trailing peers while syncing #1167
- Avoid bonding to ourselves #1166
- Fix Push Metrics #1164
- Synchroniser waits for new peer if best is up to date #1161
- Don't attempt to download checkpoint headers if the number of headers is negative #1158
- Capture metrics on Vertx event loop and worker thread queues #1155
- Simplify node permissioning ATs #1153
- Add metrics around discovery process #1152
- Prevent connecting to self #1150
- Refactoring permissioning ATs #1148
- Added two extra Ropsten bootnodes #1147
- Fixed TCP port handling #1144
- Better error on bad header #1143
- Refresh peer table while we have fewer than maxPeers connected #1142
- Refactor jsonrpc consumption of local node permissioning controller #1140
- Disconnect peers before the pivot block while fast syncing #1139
- Reduce the default transaction pool size from 30,000 to 4096 #1136
- Fail at load if static nodes not whitelisted #1135
- Fix private transaction acceptance test #1134 (thanks to Puneetha17)
- Quieter exceptions when network is unreachable #1133
- nodepermissioningcontroller used for devp2p connection filtering #1132
- Remove duplicates from apis specified via CLI #1131
- Synchronizer returns false if it is in sync #1130
- Added fromHexStringStrict to check for exactly 20 byte addresses #1128
- Fix deadlock scenario in AsyncOperationProcessor and re-enable WorldStateDownloaderTest #1126
- Ignore WorldStateDownloaderTest #1125
- Updated local config permissioning flags #1118
- Pipeline Improvements #1117
- Permissioning cli smart contract #1116
- Adding default pending transactions value in BesuControllerBuilder #1114
- Fix intermittency in WorldStateDownloaderTest #1113
- Reduce number of seen blocks and transactions Besu tracks #1112
- Timeout long test #1111
- Errorprone 2.3.3 upgrades #1110
- Add metric to capture memory used by RocksDB table readers #1108
- Don't allow creation of multiple gauges with the same name #1107
- Update Peer Discovery to use NodePermissioningController #1105
- Move starting world state download process inside WorldDownloadState #1104
- Enable private Tx capability to Clique #1102 (thanks to Puneetha17)
- Enable private Tx capability to IBFT #1101 (thanks to Puneetha17)
- Version Upgrades #1100
- Don't delete completed tasks from RocksDbTaskQueue #1099
- Support flat mapping with multiple threads #1098
- Add pipe stage name to thread while executing #1097
- Use pipeline for world state download #1096
- TXPool JSON RPC tweaks #1095
- Add in-memory cache over world state download queue #1087
- Trim default metrics #1086
- Improve imported block log line #1085
- Smart contract permission controller #1083
- Add timeout when waiting for JSON-RPC, WebSocket RPC and Metrics services to stop #1082
- Add pipeline framework to make parallel processing simpler #1077
- Node permissioning controller #1075
- Smart contract permission controller stub #1074
- Expose a synchronous start method in Runner #1072
- Changes in chain head should trigger new permissioning check for active peers #1071
- Fix exceptions fetching metrics after world state download completes #1066
- Accept transactions in the pool with nonce above account sender nonce #1065
- Repair Istanbul to handle Eth/62 & Eth/63 #1063
- Close Private Storage Provider #1059 (thanks to Puneetha17)
- Add labels to Pipelined tasks metrics #1057
- Re-enable Quorum Synchronisation #1056
- Don't log expected failures as errors #1054
- Make findSuitablePeer abstract #1053
- Track added at in txpool #1048
- Fix ImportBlocksTask to only request from peers that claim to have the blocks #1047
- Don't run the dao block validator if dao block is 0 #1044
- Don't make unnecessary copies of data in RocksDbKeyValueStorage #1040
- Update discovery logic to trust bootnodes only when out of sync #1039
- Fix IndexOutOfBoundsException in DetermineCommonAncestorTask #1038
- Add
rpc_modules
JSON-RPC #1036 - Simple permissioning smart contract #1035
- Refactor enodeurl to use inetaddr #1032
- Update CLI options in mismatched genesis file message #1031
- Remove dependence of eth.core on eth.permissioning #1030
- Make alloc optional and provide nicer error messages when genesis config is invalid #1029
- Handle metrics request closing before response is generated #1028
- Change EthNetworkConfig bootnodes to always be URIs #1027
- Avoid port conflicts in acceptance tests #1025
- Include reference tests in jacoco #1024
- Acceptance test - configurable gas price #1023
- Get Internal logs and output #1022 (thanks to Puneetha17)
- Fix race condition in WebSocketService #1021
- Ensure devp2p ports are written to ports file correctly #1020
- Report the correct tcp port in PING packets when it differs from the UDP port #1019
- Refactor transient transaction processor #1017
- Resume world state download from existing queue #1016
- IBFT Acceptance tests updated with longer timeout on first block #1015
- Update IBFT acceptances tests to await first block #1013
- Remove full hashimoto implementation as its never used #1011
- Created SyncStatus notifications #1010
- Address acceptance test intermittency #1008
- Consider a world state download stalled after 100 requests with no progress #1007
- Reduce log level when block miner is interrupted #1006
- RunnerTest fail on Windows due to network startup timing issue #1005
- Generate Private Contract Address #1004 (thanks to vinistevam)
- Delete the legacy pipelined import code #1003
- Fix race condition in WebSocket AT #1002
- Cleanup IBFT logging levels #995
- Integration Test implementation dependency for non-IntelliJ IDE #992
- Ignore fast sync and full sync tests to avoid race condition #991
- Make acceptance tests use the process based runner again #990
- RoundChangeCertificateValidator requires unique authors #989
- Make Rinkeby the benchmark chain. #986
- Add metrics to Parallel Download pipeline #985
- Change ExpectBlockNumber to require at least the specified block number #981
- Fix benchmark compilation #980
- RPC tests can use 127.0.0.1 loopback rather than localhost #974 thanks to glethuillier for raising)
- Disable picocli ansi when testing #973
- Add a jmh benchmark for WorldStateDownloader #972
- Gradle dependency for JMH annotation, for IDEs that aren't IntelliJ (… #971
- Separate download state tracking from WorldStateDownloader #967
- Gradle dependency for JMH annotation, for IDEs that aren't IntelliJ #966
- Truffle HDwallet Web3 1.0 #964
- Add missing JavaDoc tags in JSONToRLP #963
- Only import block if it isn't already on the block chain #962
- CLI stack traces when debugging #960
- Create peer discovery packets on a worker thread #955
- Remove start functionality from IbftController and IbftBlockHeightMan… #952
- Cleanup IBFT executors #951
- Single threaded world state persistence #950
- Fix version number on master #946
- Change automatic benchmark #945
- Eliminate redundant header validation #943
- RocksDbQueue Threading Tweaks #940
- Validate DAO block #939
- Complete Private Transaction Processor #938 (thanks to iikirilov)
- Add metrics for netty queue length #932
- Update GetNodeDataFromPeerTask to return a map #931
1.0.1
Public key address export subcommand was missing in 1.0 release.
Additions and Improvements
- Added
public-key export-address
subcommand #888 - Documentation update for the
public-key export-address
subcommand. - Updated IBFT 2.0 overview to include use of
rlp encode
command and information on setting IBFT 2.0 properties to achieve your desired block time.
1.0
Additions and Improvements
- IBFT 2.0
- Permissioning
- JSON-RPC Authentication
- Added
rlp encode
subcommand #965 - Method to reload permissions file #834
- Added rebind mitigation for Websockets. #905
- Support genesis contract code #749 (thanks to kziemianek).
- Documentation updates include:
- Added details on port configuration
- Added Resources page linking to Besu blog posts and webinars
- Added JSON-RPC Authentication
- Added tutorial to create permissioned network
- Added Permissioning content
- Added Permissioning API methods
- Added tutorial to create Clique private network
- Added tutorial to create IBFT 2.0 private network
Technical Improvements
- RoundChangeCertificateValidator requires unique authors #997
- RPC tests can use 127.0.0.1 loopback rather than localhost #979
- Integration Test implementation dependency for non-IntelliJ IDE #978
- Only import block if it isn't already on the block chain #977
- Disable picocli ansi when testing #975
- Create peer discovery packets on a worker thread #961
- Removed Orion snapshot dependency #933
- Use network ID instead of chain ID in MainnetBesuController. #929
- Propagate new block messages to other clients in a worker thread #928
- Parallel downloader should stop on puts if requested. #927
- Permission config file location and option under docker #925
- Fixed potential stall in world state download #922
- Refactoring to introduce deleteOnExit() for temp files #920
- Reduce "Received transactions message" log from debug to trace #919
- Handle PeerNotConnected exceptions when sending wire keep alives #918
- admin_addpeers: error if node not whitelisted #917
- Expose the Ibft MiningCoordinator #916
- Check perm api against perm cli #915
- Update metrics when completing a world state request with existing data #914
- Improve RocksDBQueue dequeue performance #913
- Error when removing bootnodes from nodes whitelist #912
- Incremental Optimization(s) on BlockBroadcaster #911
- Check permissions CLI dependencies #909
- Limit the number of times we retry peer discovery interactions #908
- IBFT to use VoteTallyCache #907
- Add metric to expose number of inflight world state requests #906
- Bootnodes not on whitelist - improve errors #904
- Make chain download cancellable #901
- Enforce accounts must start with 0x #900
- When picking fast sync pivot block, use the peer with the best total difficulty #899
- Process world state download data on a worker thread #898
- CLI mixin help #895 (macfarla)
- Use absolute datapath instead of relative. #894.
- Fix task queue so that the updated failure count for requests is stored #893
- Fix authentication header #891
- Reorganize eth tasks #890
- Unit tests of BlockBroadcaster #887
- Fix authentication file validation errors #886
- Fixing file locations under docker #885
- Handle exceptions properly in EthScheduler #884
- More bootnodes for goerli #880
- Rename password hash command #879
- Add metrics for EthScheduler executors #878
- Disconnect peer removed from node whitelist #877
- Reduce logging noise from invalid peer discovery packets and handshaking #876
- Detect stalled world state downloads #875
- Limit size of Ibft future message buffer #873
- Ibft2: Replace NewRound with extended Proposal #872
- Fixed admin_addPeer to periodically check maintained connections #871
- WebSocket method permissions #870
- Select new pivot block when world state becomes unavailable #869
- Introduce FutureUtils to reduce duplicated code around CompletableFuture #868
- Implement world state cancel #867
- Renaming authentication configuration file CLI command #865
- Break out RoundChangeCertificate validation #864
- Disconnect peers where the common ancestor is before our fast sync pivot #862
- Initial scaffolding for block propagation #860
- Fix NullPointerException when determining fast sync pivot #859
- Check for invalid token #856
- Moving NodeWhitelistController to permissioning package #855
- Fix state download race condition by creating a TaskQueue API #853
- Changed separator in JSON RPC permissions #852
- WebSocket acceptance tests now can use WebSockets #851
- IBFT notifies EthPeer when remote node has a better block #849
- Support resuming fast-sync downloads #848
- Tweak Fast Sync Config #847
- RPC authentication configuration validation + tests. #846
- Tidy-up FastSyncState persistence #845
- Do parallel extract signatures in the parallel block importer. #844
- Fix 'the Input Is Too Long' Error on Windows #843 (thanks to glethuillier).
- Remove unnecessary sleep #842
- Shutdown improvements #841
- Speed up shutdown time #838
- Add metrics to world state downloader #837
- Store pivot block header #836
- Clique should use beneficiary of zero on epoch blocks #833
- Clique should ignore proposals for address 0 #831
- Fix intermittency in FullSyncDownloaderTest #830
- Added the authentication service to the WebSocket service #829
- Extract creation and init of ProtocolContext into a re-usable class #828
- Prevent duplicate commit seals in ibft header #827
- Validate Ibft vanity data length #826
- Refactored json rpc authentication to be provided as a service #825
- Handle unavailable world states #824
- Password in JWT payload #823
- Homogenize error messages when required parameters are set #822 (glethuillier).
- Set remote peer chain head to parent of block received in NEW_BLOCK_MESSAGE #819
- Peer disconnects should not result in stack traces #818
- Abort previous builds #817
- Parallel build stages #816
- JWT authentication for JSON-RPC #815
- Log errors that occur while finding a common ancestor #814
- Shuffled log levels #813
- Prevent duplicate IBFT messages being processed by state machine #811
- Fix Orion startup ports #810
- Commit world state continuously #809
- Improve block propagation time #808
- JSON-RPC authentication cli options & acceptance tests #807
- Remove privacy not supported warning #806 (thanks to vinistevam)
- Wire up Private Transaction Processor #805 (thanks to Puneetha17)
- Apply a limit to the number of responses in RespondingEthPeer.respondWhile #803
- Avoid requesting empty block bodies from the network. #802
- Handle partial responses to get receipts requests #801
- Rename functions in Ibft MessageValidator #800
- Upgrade GoogleJavaFormat to 1.7 #795
- Minor refactorings of IntegrationTest infrastructure #786
- Rework Ibft MessageValidatorFactory #785
- Rework IbftRoundFactory #784
- Rename artefacts to artifacts within IBFT #782
- Rename TerminatedRoundArtefacts to PreparedRoundArtefacts #781
- Rename Ibft MessageFactory methods #779
- Update WorldStateDownloader to only filter out known code requests #777
- Multiple name options only search for the longest one #776
- Move ethTaskTimer to abstract root #775
- Parallel Block importer #774
- Wait for a peer with an estimated chain height before selecting a pivot block #772
- Randomly perform full validation when fast syncing blocks #770
- IBFT Message rework, piggybacking blocks on msgs. #769
- EthScheduler additions #767
- Fixing node whitelist isPermitted check #766
- Eth/63 labels #764
- Permissioning whitelist persistence. #763
- Created message validators for NewRound and RoundChange #760
- Add tests for FastSyncChainDownloader as a whole #758
- Flatten IBFT Message API #757
- Added TerminatedRoundArtefacts #756
- Fix thread names in EthScheduler to include the thread number #755
- Separate round change reception from RoundChangeCertificate #754
- JSON-RPC authentication login #753
- Spilt Ibft MessageValidator into components #752
- Ensure first checkpoint headers is always in local blockchain for FastSyncCheckpointHeaderManager #750
- Refactored permissioning components to be Optional. #747
- Integrate rocksdb-based queue into WorldStateDownloader #746
- Generify orion to enclave #745 (thanks to vinistevam)
- Moved IBFT Message factory to use wrapped message types #744
- Handle timeouts when requesting checkpoint headers correctly #743
- Update RoundChangeManager to use flattened message #742
- Handle validation failures when fast importing blocks #741
- Updated IbftRound and RoundState APIs to use wrapped messages #740
- Exception handling #739
- Upgrade dependency versions and build cleanup #738
- Update IbftBlockHeigntManager to accept new message types. #737
- Error response handling for permissions APIs #736
- IPV6 bootnodes don't work #735
- Updated to use tags of pantheon build rather than another repo #734
- Log milestones at startup and other minor logging improvements #733
- Create wrapper types for Ibft Signed messages #731
- Ibft to uniquely ID messages by their hash #730
- Rename ibftrevised to ibft2 #722
- Limit ibft msg queues #704
- Implement privacy precompiled contract #696 (thanks to Puneetha17)
- Integration of RecursivePeerRefreshState and PeerDiscoveryController #420
0.9.1
Built and compatible with with JDK8.
0.9
Breaking Changes to Command Line
Breaking changes have been made to the command line options in v0.9 to improve usability. Many v0.8 command line options no longer work.
The documentation has been updated throughout to use the changed command line options and the command line reference documents the changed options.
Previous Option | New Option | Change |
---|---|---|
--config |
--config-file |
Renamed |
--datadir |
--data-path |
Renamed |
--dev-mode |
--network=dev |
Replaced by --network option |
--genesis |
--genesis-file |
Renamed |
--goerli |
--network=goerli |
Replaced by --network option |
--metrics-listen=<HOST:PORT> |
--metrics-host=<HOST> and --metrics-port=<PORT> |
Split into host and port options |
--miner-extraData |
--miner-extra-data |
Renamed |
--miner-minTransactionGasPriceWei |
--min-gas-price |
Renamed |
--no-discovery |
--discovery-enabled |
Replaced |
--node-private-key |
--node-private-key-file |
Renamed |
--ottoman |
N/A | Removed |
--p2p-listen=<HOST:PORT> |
--p2p-host=<HOST> and --p2p-port=<PORT> |
Split into host and port options |
--rinkeby |
--network=rinkeby |
Replaced by --network option |
--ropsten |
--network=ropsten |
Replaced by --network option |
--rpc-enabled |
--rpc-http-enabled |
Renamed |
--rpc-listen=<HOST:PORT> |
--rpc-http-host=<HOST> and --rpc-http-port=<PORT> |
Split into host and port options |
--rpc-api |
--rpc-http-api |
Renamed |
--rpc-cors-origins |
--rpc-http-cors-origins |
Renamed |
--ws-enabled |
--rpc-ws-enabled |
Renamed |
--ws-api |
--rpc-ws-api |
Renamed |
--ws-listen=<HOST:PORT> |
--rpc-ws-host=<HOST> and --rpc-ws-port=<PORT> |
Split into host and port options |
--ws-refresh-delay |
--rpc-ws-refresh-delay |
Renamed |
Previous Subcommand | New Subcommand | Change |
---|---|---|
pantheon import <block-file> |
pantheon blocks import --from=<block-file> |
Renamed |
pantheon export-pub-key <key-file> |
pantheon public-key export --to=<key-file> |
Renamed |
Private Network Quickstart
The Private Network Quickstart has been moved from the pantheon
repository to the pantheon-quickstart
repository. The Private Network Quickstart tutorial
has been updated to use the moved quickstart.
Additions and Improvements
--network=goerli
supports relaunch of Görli testnet #717- TOML authentication provider #689
- Metrics Push Gateway Options #678
- Additional logging details for IBFT 2.0 #650
- Permissioning config TOML file #643
- Added metrics Prometheus Push Gateway Support #638
- Clique and IBFT not enabled by default in RPC APIs #635
- Added
admin_addPeer
JSON-RPC API method #622 - Implemented
--p2p-enabled
configuration item #619 - Command options and commands renaming #618
- Added IBFT get pending votes #603
- Implement Petersburg hardfork #601
- Added private transaction abstraction #592 (thanks to iikirilov)
- Added privacy command line commands #584 (thanks to Puneetha17)
- Documentation updates include:
- Updated Private Network Quickstart tutorial
to use quickstart in
pantheon-quickstart
repository and indicate that the quickstart is not supported on Windows. - Added IBFT 2.0 content and JSON RPC API methods.
- Added consensus protocols content.
- Added content on events and logs, and using filters.
- Added content on integrating with Prometheus Push Gateway
- Updated Private Network Quickstart tutorial
to use quickstart in
Technical Improvements
- Download receipts during fast sync and import without processing transactions #701
- Removed CLI options for
--nodes-whitelist
and--accounts-whitelist
#694 - Delegate
getRootCause
through to Guava's implementation #692 - Benchmark update #691
- Implement chain download for fast sync #690
- Allow missing accounts to create zero-cost transactions #685
- Node private key location should be fixed under docker #684
- Parallel Processing File Import Performance #683
- Integrate actual
WorldStateDownloader
with the fast sync work flow #682 - Removed
--max-trailing-peers
option #680 - Enabled warning on CLI dependent options #679
- Update WorldStateDownloader run() interface to accept header #677
- Fixed Difficulty calculator #663
discovery-enabled
option refactoring #661- Update orion default port approach #660
- Extract out generic parts of Downloader #659
- Start world downloader #658
- Create a simple
WorldStateDownloader
#657 - Added handling for when p2p is disabled #655
- Enabled command line configuration for privacy precompiled contract address #653 (thanks to Puneetha17)
- IBFT transmitted packets are logged by gossiper #652
admin_addPeer
acceptance test #651- Added
p2pEnabled
configuration toProcessBesuNodeRunner
#649 - Added description to automatic benchmarks #646
- Added
network
option #645 - Remove OrionConfiguration #644 (thanks to Puneetha17)
- IBFT Json Acceptance tests #634
- Upgraded build image to one that contains libsodium #632
- Command line fixes #630
- Consider peer count insufficient until minimum peers for fast sync are connected #629
- Build tweaks #628
- IBFT ensure non-validator does not partake in consensus #627
- Added ability in acceptance tests to set up a node with
--no-discovery
#624 - Gossip integration test #623
- Removed quickstart code and CI pipeline #616
- IBFT Integration Tests - Spurious Behaviour #615
- Refactoring for more readable IBFT IT #614
- Start of fast sync downloader #613
- Split
IbftProcessor
into looping and event processing #612 - IBFT Int Test - changed
TestContextFactory
to a builder #611 - Discard prior round change msgs #610
IbftGetValidatorsByBlockHash
added to json factory #607- IBFT Validator RPCs to return list of strings #606
- Update Benchmark #605
- Remove db package and move classes to more appropriate locations #599
- Added
GetReceiptsFromPeerTask
#598 - Added
GetNodeDataFromPeerTask
#597 - Fixed deprecation warnings #596
- IBFT Integration Tests - Future Height #591
- Added
getNodeData
toEthPeer
to enable requesting node data #589 Blockcreator
to useparentblock
specified at construction #588- Support responding to
GetNodeData
requests #587 - IBFT validates block on proposal reception #583
- Rework
NewRoundValidator
tests #582 - IBFT split extra data validation rule into components #581
- Allow attached rules to be flagged
light
#580 - Split Block Validation from Importing #579
- Refactor
RoundChangeManager
creation #578 - Add
-SNAPSHOT
postfix to version #577 - IBFT - prevent proposed block being imported twice #576
- Version upgrades #571
- Tests that CLI options are disabled under docker #566
- Renamed IBFT networking classes #555
- Removed dead code from the consensus package #554
- Prepared private transaction support #538 (thanks to iikirilov)
0.8.5
Indefinitely delays the roll-out of Constantinople on Ethereum Mainnet due to a potential security issue detected.
Additions and Improvements
- Remove Constantinople fork block #574
Technical Improvements
- Rename IBFT message packages #568
0.8.4
Docker Image
If you have been running a node using the v0.8.3 Docker image, the node was not saving data to the specified data directory, or referring to the custom configuration file or genesis file.
To recover the node key and data directory from the Docker container:
docker cp <container>:/opt/pantheon/key <destination_file>
docker cp <container>:/opt/pantheon/database <destination_directory>
Where container
is the name or ID of the Docker container containing the Besu node.
The container can be running or stopped when you copy the key and data directory. If your node was fully synchronized to MainNet, the data directory will be ~2TB.
When restarting your node with the v0.8.4 Docker image:
- Save the node key in the
key
file in the data directory or specify the location using the--node-private-key
option. - Specify the
<destination_directory
as a volume for the data directory.
Bug Fixes
- Fixing default resource locations inside docker #529
- NewRoundMessageValidator ignores Round Number when comparing blocks #523
- Fix Array Configurable command line options #514
Additions and Improvements
- RocksDB Metrics #531
- Added
ibft_getValidatorsByBlockHash
JSON RPC #519 - Expose metrics to Prometheus #506
- Added
ibft_getValidatorsByBlockNumber
#499 - Added
Roadmap.md
file. #494 - Added JSON RPC
eth hashrate
method. #488 - Account whitelist API #487
- Added nodes whitelist JSON-RPC APIs #476
- Added account whitelisting #460
- Added configurable refresh delay for SyncingSubscriptionService on start up #383
- Added the Command Line Style Guide #530
- Documentation updates include:
- Migrated to new documentation site
- Added configuration file content
- Added tutorial to create private network
- Added content on enabling non-default APIs
Technical Improvements
- Updated
--bootnodes
command option to take zero arguments #548 - IBFT Integration Testing - Local Node is proposer #527
- Remove vertx from discovery tests #539
- IBFT Integration testing - Round Change #537
- NewRoundMessageValidator creates RoundChangeValidator with correct value #518
- Remove time dependency from BlockTimer tests #513
- Gradle 5.1 #512
- Metrics measurement adjustment #511
- Metrics export for import command. #509
- IBFT Integration test framework #502
- IBFT message gossiping #501
- Remove non-transactional mutation from KeyValueStore #500
- Ensured that the blockchain queries class handles optionals better. #486
- IBFT mining acceptance test #483
- Set base directory name to be lowercase in building.md #474 (Thanks to Matthalp)
- Moved admin_peers to Admin API group #473
- Nodes whitelist acceptance test #472
- Rework RoundChangeManagerTest to not reuse validators #469
- Ignore node files to support truffle. #467
- IBFT pantheon controller #461
- IBFT Round to update internal state on reception of NewRound Message #451
- Update RoundChangeManager correctly create its message validator #450
- Use seconds for block timer time unit #445
- IBFT controller and future msgs handling #431
- Allow IBFT Round to be created using PreparedCert #429
- Added MessageValidatorFactory #425
- Inround payload #423
- Updated IbftConfig Fields #422
- Repair IbftBlockCreator and add tests #421
- Make Besu behave as a submodule #419
- Ibft Height Manager #418
- Ensure bootnodes are a subset of node whitelist #414
- IBFT Consensus Round Classes #405
- IBFT message payload tests #404
- Validate enodeurl syntax from command line #403
- Update errorprone #401
- IBFT round change manager #393
- IBFT RoundState #392
- Move Block data generator test helper to test support package #391
- IBFT message tests #367
0.8.3
Breaking Change to JSON RPC-API
From v0.8.3, incoming HTTP requests are only accepted from hostnames specified using the --host-whitelist
command-line option. If not specified, the default value for --host-whitelist
is localhost
.
If using the URL http://127.0.0.1
to make JSON-RPC calls, use --host-whitelist
to specify the hostname 127.0.0.1
or update the hostname to localhost
.
If your application publishes RPC ports, specify the hostnames when starting Besu. For example:
pantheon --host-whitelist=example.com
Specify *
or all
for --host-whitelist
to effectively disable host protection and replicate pre-v0.8.3 behavior. This is not recommended for production code.
Bug Fixes
- Repair Clique Proposer Selection #339
- High TX volume swamps block processing #337
- Check if the connectFuture has completed successfully #293
- Switch back to Xerial Snappy Library #284
- ShortHex of 0 should be '0x0', not '0x' #272
- Fix pantheon CLI default values infinite loop #266
Additions and Improvements
- Added
--nodes-whitelist
parameter to CLI and NodeWhitelistController #346 - Discovery wiring for
--node-whitelist
#365 - Plumb in three more metrics #344
ProposerSelection
to support multiple IBFT implementations #307- Configuration to support IBFT original and revised #306
- Added host whitelist for JSON-RPC. Breaking Change #295
- Reduce
Block creation processed cancelled
log message to debug #294 - Implement iterative peer search #268
- Added RLP enc/dec for PrePrepare, Commit and NewRound messages #200
- IBFT block mining #169
- Added
--goerli
CLI option #370 (Thanks to @Nashatyrev) - Begin capturing metrics to better understand Besu's behaviour #326
- Documentation updates include:
- Added Coding Conventions #342
- Reorganised Installation documentation and added Chocolatey installation for Windows
- Reorganised JSON-RPC API documentation
- Updated RPC Pub/Sub API documentation
Technical Improvements
- Extracted non-Docker CLI parameters to picoCLI mixin. #323
- IBFT preprepare to validate round matches block #329
- Fix acceptance test #324
- Added the
IbftFinalState
#385 - Constantinople Fork Block #382
- Fix
pantheon.cli.BesuCommandTest
test on Windows #380 - JDK smoke testing is being configured differently now #374
- Re-enable clique AT #373
- Ignoring acceptance test #372
- Changes to support Gradle 5.0 #371
- Clique: Prevent out of turn blocks interrupt in-turn mining #364
- Time all tasks #361
- Rework
VoteTallyCache
to better represent purpose #360 - Add an
UNKNOWN
DisconnectReason
#359 - New round validation #353
- Update get validators for block hash test to start from block 1 #352
- Idiomatic Builder Pattern #345
- Revert
Repair Clique Proposer Selection
#339 - Breaks Görli testnet #343 - No fixed ports in tests #340
- Update clique acceptance test genesis file to use correct clique property names #338
- Supporting list of addresses in logs subscription #336
- Render handler exception to
System.err
instead of.out
#334 - Renamed IBFT message classes #333
- Add additional RLP tests #332
- Downgrading spotless to 3.13.0 to fix threading issues #325
eth_getTransactionReceipt
acceptance test #322- Upgrade vertx to 3.5.4 #316
- Round change validation #315
- Basic IBFT message validators #314
- Minor repairs to clique block scheduling #308
- Dependencies Version upgrade #303
- Build multiple JVM #301
- Smart contract acceptance test #296
- Fixing WebSocket error response #292
- Reword error messages following exceptions during mining #291
- Clique acceptance tests #290
- Delegate creation of additional JSON-RPC methods to the BesuController #289
- Remove unnecessary
RlpInput
andRlpOutput
classes #287 - Remove
RlpUtils
#285 - Enabling previously ignored acceptance tests #282
- IPv6 peers #281
- IPv6 Bootnode #280
- Acceptance test for
getTransactionReceipt
JSON-RPC method #278 - Inject
StorageProvider
intoBesuController
instances #259
0.8.2
Removed
- Removed
import-blockchain
command because nothing exports to the required format yet (PR #223)
Bug Fixes
io.netty.util.internal.OutOfDirectMemoryError
errors by removing reference counting from network messages.- Log spam: endless loop in
nioEventLoopGroup
thanks to @5chdn for reporting) (PR #261) - Rinkeby import can stall with too many fragments thanks to @steffenkux and @5chdn for reporting) (PR #255)
- Clique incorrectly used the chain ID instead of the network ID in ETH status messages (PR #209)
- Gradle deprecation warnings (PR #246 with thanks to @jvirtanen)
- Consensus issue on Ropsten:
- File name too long error while building from source thanks to @5chdn for reporting) (PR #221)
- Loop syntax in
runBesuPrivateNetwork.sh
(PR #237 thanks to @matt9ucci) - Fix
CompressionException: Snappy decompression failed
errors thanks to @5chdn for reporting) (PR #274)
Additions and Improvements
- Added
--ropsten
command line argument to make syncing to Ropsten easier (PR #197 with thanks to @jvirtanen) - Enabled constantinople in
--dev-mode
(PR #256) - Supported Constantinople with Clique thanks to @5chdn for reporting) (PR #250, PR #247)
- Implemented
eth_chainId
JSON-RPC method (PR #219) - Updated client version to be ethstats friendly (PR #258)
- Added
--node-private-key
option to allow nodekey file to be specified separately to data directory thanks to @peterbroadhurst for requesting) (PR #234) - Added
--banned-nodeids
option to prevent connection to specific nodes (PR #254) - Send client quitting disconnect message to peers on shutdown (PR #253)
- Improved error message for port conflict error (PR #232)
- Improved documentation by adding the following pages:
Technical Improvements
- Upgraded Ethereum reference tests to 6.0 beta 2. (thanks to @jvirtanen for the initial upgrade to beta 1)
- Set Java compiler default encoding to UTF-8 (PR #238 thanks to @matt9ucci)
- Removed duplicate code defining default JSON-RPC APIs (PR #218 thanks to @matt9ucci)
- Improved code for parsing config (PRs #208, #209)
- Use
java.time.Clock
in favour of a custom Clock interface (PR #220) - Improve modularity of storage systems (PR #211, #207)
- Treat JavaDoc warnings as errors (PR #171)
- Add benchmark for
BlockHashOperation
as a template for benchmarking other EVM operations (PR #203) - Added unit tests for
EthBlockNumber
(PR #195 thanks to @jvirtanen) - Code style improvements (PR #196 thanks to @jvirtanen)
- Added unit tests for
Web3ClientVersion
(PR #194 with thanks to @jvirtanen) - Removed RLPUtils from
RawBlockIterator
(PR #179) - Replace the JNI based snappy library with a pure-Java version (PR #257)