Releases: Consensys/teku
23.4.0
This is a recommended update for mainnet, containing a fix for the slow processing of blocks with multiple voluntary exit operations.
Due to some issues with Docker Hub signing service, 23.4.0 docker images have not been signed.
Downloads
- Available as
23.4.0
on Dockerhub - Download the binary distribution:
Breaking Changes
- The
--p2p-discovery-site-local-addresses-enabled
option is set tofalse
by default. If you use the client's discovery inside the local network, update its launch command to toggle the option.
Additions and Improvements
- Added the ability for the CL client to negotiate engine capabilities with the connected EL client. This can be disabled by setting
--exchange-capabilities-enabled=false
if Shanghai is not supported on your EL client. - Enabled peer scoring by default. Can be disabled explicitly using
--Xp2p-gossip-scoring-enabled=false
- When failovers are configured, the validator client will perform a readiness check on startup to avoid retrieving validator statuses from a node which is not ready.
- Enabled deposit tree snapshot bundles for major networks and persists it after finalization to decrease EL pressure and speed up node startup. Use
--deposit-snapshot-enabled=false
to disable. - Optimized validator exit processing during state transition, to speed up block import containing multiple validator exits.
- Locally submitted exits and bls changes will now periodically broadcast if they are not actioned, to address operations being lost in remote pools.
Bug Fixes
- Included All forks in fork schedule if they're defined in configuration.
-
- Operation pool not removing some Voluntary Exit messages after block inclusion.
- Slow processing of blocks with multiple voluntary exit operations.
Upcoming Breaking Changes
- The
/eth/v1/debug/beacon/states/:state_id
endpoint has been deprecated in favor of the v2 Altair endpoint/eth/v2/debug/beacon/states/:state_id
- The
/eth/v1/beacon/blocks/:block_id
endpoint has been deprecated in favor of the v2 Altair endpoint/eth/v2/beacon/blocks/:block_id
- The
/eth/v1/validator/blocks/:slot
endpoint has been deprecated in favor of the v2 Altair endpoint/eth/v2/validator/blocks/:slot
- The
/eth/v1/debug/beacon/heads
endpoint has been deprecated in favor of the v2 Bellatrix endpoint/eth/v2/debug/beacon/heads
- The command argument
--Xexchange-capabilities-enabled
will be removed, update to use--exchange-capabilities-enabled
if you are using this option. - The command argument
--Xdeposit-snapshot-enabled
will be removed, just remove it from commandline/configuration if you use it, updated argument--deposit-snapshot-enabled
defaults to true now.
23.3.1
This is a required update containing mainnet 🦉CAPELLA🦉 fork configuration. All users should upgrade as soon as possible.
NOTE: Upgrade your EL client to the latest version first! This update could be incompatible with old versions.
Known Issues
- CVE-2022-1471 security alert related to
snakeyaml-1.33.jar
could be ignored because Teku doesn't make use of the affected functionalities. Future dependency updates will fix this security alert.
Downloads
- Available as
23.3.1
on Dockerhub - Download the binary distribution:
Breaking Changes
--Xbeacon-liveness-tracking-enabled
has been removed in favour of--beacon-liveness-tracking-enabled
Additions and Improvements
- The commandline option
--network
of thevalidator-client
subcommand has been undeprecated for values other thanauto
. - Send validator registrations to the Beacon node when the Validator client has reconnected to the event stream
- Added optional query parameters
require_prepared_proposers
andrequire_validator_registrations
to theteku/v1/admin/readiness
endpoint - Added mainnet configuration for the CAPELLA network fork due at epoch 194048, April 12, 2023; 10:27:35pm UTC
- Added experimental feature
--Xdeposit-snapshot-enabled
to use bundled deposit contract tree snapshot and persist it after finalization to decrease EL pressure when syncing and speed up node startup - Added
--p2p-discovery-site-local-addresses-enabled
option to allow discovery connections to local (RFC1918) addresses. - Added
--builder-bid-compare-factor
to be applied to the builder bid value when comparing it with locally produced payload. - Improved
Completed regeneration
info message so that is more technically accurate.
Bug Fixes
- Fixed a bug in signature verification on fork boundaries when first blocks of the new fork are missing.
Upcoming Breaking Changes
- The
/eth/v1/debug/beacon/states/:state_id
endpoint has been deprecated in favor of the v2 Altair endpoint/eth/v2/debug/beacon/states/:state_id
- The
/eth/v1/beacon/blocks/:block_id
endpoint has been deprecated in favor of the v2 Altair endpoint/eth/v2/beacon/blocks/:block_id
- The
/eth/v1/validator/blocks/:slot
endpoint has been deprecated in favor of the v2 Altair endpoint/eth/v2/validator/blocks/:slot
- The
/eth/v1/debug/beacon/heads
endpoint has been deprecated in favor of the v2 Bellatrix endpoint/eth/v2/debug/beacon/heads
- The
--p2p-discovery-site-local-addresses-enabled
option will be set tofalse
by default. If you use the client's discovery inside the local network, update its launch command to toggle the option.
23.3.0
This is an optional update that primarily updates dependent libraries. It is a required update for Goerli network nodes.
Downloads
- Available as
23.3.0
on Dockerhub - Download the binary distribution:
Additions and Improvements
- Trigger the beacon nodes fallback mechanism when the execution layer is offline
--beacon-liveness-tracking-enabled
option (disabled by default) can be used instead of--Xbeacon-liveness-tracking-enabled
- Added an optional query parameter
locally_submitted
to/eth/v1/beacon/pool/bls_to_execution_changes
to allow users to query only bls changes submitted to the current node. - Added
/eth/v1/builder/states/{state_id}/expected_withdrawals
rest api endpoint. - Added
/eth/v1/beacon/rewards/sync_committee/{block_id}
rest api endpoint. - Added Capella fork information for Goerli network configuration.
- Added
validator_scheduled_sync_committee_duties_current
metric - the number of validators that you have active with current sync committee duties - Added
validator_current_sync_committee_last_epoch
metric - the last epoch of the current sync committee.
Bug Fixes
- Included All forks in fork schedule if they're defined in configuration.
Upcoming Breaking Changes
- The
/eth/v1/debug/beacon/states/:state_id
endpoint has been deprecated in favor of the v2 Altair endpoint/eth/v2/debug/beacon/states/:state_id
- The
/eth/v1/beacon/blocks/:block_id
endpoint has been deprecated in favor of the v2 Altair endpoint/eth/v2/beacon/blocks/:block_id
- The
/eth/v1/validator/blocks/:slot
endpoint has been deprecated in favor of the v2 Altair endpoint/eth/v2/validator/blocks/:slot
- The
/eth/v1/debug/beacon/heads
endpoint has been deprecated in favor of the v2 Bellatrix endpoint/eth/v2/debug/beacon/heads
- The commandline option
--network
of thevalidator-client
subcommand has been undeprecated and can be used to select a network for standalone validator clients. When set toauto
, it automatically
fetches network configuration information from the configured beacon node endpoint. --Xbeacon-liveness-tracking-enabled
option will be removed. The--beacon-liveness-tracking-enabled
option should be used instead (disabled by default)
23.2.0
This is an optional update that primarily updates dependent libraries. It is a required update for Sepolia network nodes.
Downloads
- Available as
23.2.0
on Dockerhub - Download the binary distribution:
Breaking Changes
--Xmetrics-block-timing-tracking-enabled
option has been removed. The--metrics-block-timing-tracking-enabled
option should be used instead (enabled by default).
Additions and Improvements
- Introduced Doppelganger Detection feature
- Changed color of block production duty to cyan, rather than dark blue.
- Introduced a configuration overview printed during start up.
- Introduced a new field
el_offline
in theGetSyncingStatusResponse
which is set totrue
when the execution layer is offline: Syncing API update - Added Capella fork information for Sepolia network configuration.
- Removed references to beacon block methods
/eth2/beacon_chain/req/beacon_blocks_by_root
and/eth2/beacon_chain/req/beacon_blocks_by_range
.
Bug Fixes
- Fixed issue which was causing validator keys to be loaded twice, which, in some cases, was causing beacon node to initialize slower.
23.1.1
This is an optional update containing a permissions fix to docker containers. Users not experiencing permissions issues with their docker containers do not need to upgrade to this patch.
Downloads
- Available as
23.1.1
on Dockerhub - Download the binary distribution:
Bug Fixes
- Docker container permissions have been updated #6741
23.1.0
This is a recommended update containing bug fixes, optimisations and new features.
Downloads
- Available as
23.1.0
on Dockerhub - Download the binary distribution:
Breaking Changes
- The
validator_beacon_node_published_attestation_total
,validator_beacon_node_published_aggregate_total
,
validator_beacon_node_send_sync_committee_messages_total
,validator_beacon_node_send_sync_committee_contributions_total
andvalidator_beacon_node_published_block_total
metrics have been replaced by the newvalidator_beacon_node_requests_total
metric. An update to the Teku Dashboard that uses the new metric is available.
Additions and Improvements
- Introduces the
MINIMAL
option for--data-storage-mode
which prunes both finalized states and blocks prior to the retention period required by the beacon chain spec (~5 months of blocks). - Support for the
/eth/v1/beacon/blinded_blocks/{block_id}
REST API - Support for the
/eth/v1/debug/fork_choice
REST API - Support for the
/eth/v1/beacon/deposit_snapshot
REST API - Added
finalized
metadata field to applicable REST API responses - Use SSZ encoding for external validator client block creation requests by default. Can be disabled with
--beacon-node-ssz-blocks-enabled=false
. - Added a timeout (2 minutes) when attempting to load the initial state from a URL
- Improved logging when sync committee messages fail to publish to the gossip network
- Updated bootnodes for the Gnosis chain
- Updated jblst library to version 0.3.10
- Updated docker images to Ubuntu version 22.04
Bug Fixes
- Fixed issue which could cause command line options to be parsed incorrectly
- Fixed issue where the voluntary-exit subcommand did not exit immediately after completion
- Fixed reported security issue on Netty, updating to version 4.1.87.Final (addressing CVE-2022-41881)
22.12.0
This is an optional update that primarily updates dependent libraries.
Downloads
- Available as
22.12.0
on Dockerhub - Download the binary distribution:
Breaking Changes
- Dropped support for custom network configurations that do not use the current preset format. Presets have been in use since before the MainNet beaconchain launch so this is not expected to affect any users.
Additions and Improvements
- Updated third party libraries
- Early access: Support for additional DoS protection by using a separate sentry beacon node to publish blocks and attestations.
- Tightened validation of the fork for gossip messages
22.11.0
This is a recommended update containing security updates. It is a required update for Gnosis chain nodes.
Downloads
- Available as
22.11.0
on Dockerhub - Download the binary distribution:
Breaking Changes
- The logic with which the default configuration is applied when using
validators-proposer-config
has been updated.
The logic is now more intuitive but a given proposer config file may result in a different configuration compared with the previous Teku version.
(Refer to #6325 (comment) for more information).
Additions and Improvements
- Updated protobuf used by libp2p library to resolve a potential DoS vector
- Added merge configuration for Gnosis chain. Note that all Gnosis nodes will need to be made merge-ready
- Improved discv5 compliance
- Changed the builder
is online\is offline
logs tois available\is not available
- Added
/eth/v1/beacon/states/{state_id}/randao
to beacon-api - Block timing tracking is now enabled by default. The
--Xmetrics-block-timing-tracking-enabled
option has been renamed to--metrics-block-timing-tracking-enabled
.
Bug Fixes
- Fixed missing status filters (active, pending, exited, withdrawal) for the
/eth/v1/beacon/states/{state_id}/validators
endpoint - Fixed issue which could lead to duplicate processing of some events after gossip is stopped and restarted.
- Fixed issue which could cause sync committee duties to be calculated too early, potentially causing duties to be missed if the scheduling was changed by a reorg.
22.10.2
Downloads
- Available as 22.10.2 on Dockerhub
- Download the binary distribution:
Breaking Changes
There are no breaking changes in this release.
Additions and Improvements
- Enabled new framework for REST API with better performance and less memory usage. The new framework does not cause any breaking changes, however if needed the old version can be restored with
--Xrest-api-migrated-enabled=false
- Updated jackson-databind library to version 2.13.4.2 addressing CVE-2022-42003
Bug Fixes
- Fix issue where /readiness endpoint returned 200 when Execution Client was not available.
Upcoming Breaking Changes
- The
validator_beacon_node_published_attestation_total
,validator_beacon_node_published_aggregate_total
,
validator_beacon_node_send_sync_committee_messages_total
,validator_beacon_node_send_sync_committee_contributions_total
andvalidator_beacon_node_published_block_total
metrics have been deprecated in favour of the newvalidator_beacon_node_requests_total
metric.
The old metrics will be removed in a future release. An update to the Teku Dashboard that uses the new metric is available. - The
/eth/v1/debug/beacon/states/:state_id
endpoint has been deprecated in favor of the v2 Altair endpoint/eth/v2/debug/beacon/states/:state_id
- The
/eth/v1/beacon/blocks/:block_id
endpoint has been deprecated in favor of the v2 Altair endpoint/eth/v2/beacon/blocks/:block_id
- The
/eth/v1/validator/blocks/:slot
endpoint has been deprecated in favor of the v2 Altair endpoint/eth/v2/validator/blocks/:slot
- The
/eth/v1/debug/beacon/heads
endpoint has been deprecated in favor of the v2 Bellatrix endpoint/eth/v2/debug/beacon/heads
- The commandline option
--network
of thevalidator-client
subcommand has been undeprecated and can be used to select a network for standalone validator clients. When set toauto
, it automatically
fetches network configuration information from the configured beacon node endpoint.
22.10.1
This is a recommended upgrade containing bug fixes, optimisations and voluntary-exit command improvements
Downloads
- Available as
22.10.1
on Dockerhub - Download the binary distribution:
Additions and Improvements
- Improve Execution Layer error logging
- Add new validator client metric
validator_remote_beacon_nodes_requests_total
which tracks the requests made to remote beacon nodes (useful when there are failovers configured) - The
voluntary-exit
subcommand can restrict the exit to a specific list of validators public keys using the option--validator-public-keys
.
Example:teku voluntary-exit --beacon-node-api-endpoint=<ENDPOINT>[,<ENDPOINT>...]... --data-validator-path=<PATH> --include-keymanager-keys=<BOOLEAN> --validator-keys=<KEY_DIR>:<PASS_DIR> | <KEY_FILE>:<PASS_FILE> --validator-public-keys=<PUBKEY>[,<PUBKEY>...]...
To include validator keys managed via keymanager APIs, the option--include-keymanager-keys
could be set totrue
(The default value is set tofalse
) - Throttle signing of validator registrations when using an external signer
Bug Fixes
- Filter out unknown validators when sending validator registrations to the builder network
- Fix issue which could cause locally produced aggregates to not be gossiped
- Fix issue where the sync module could cause
Unexpected rejected execution due to full task queue in nioEventLoopGroup
log messages and high CPU usage
Upcoming Breaking Changes
- The
validator_beacon_node_published_attestation_total
,validator_beacon_node_published_aggregate_total
,
validator_beacon_node_send_sync_committee_messages_total
,validator_beacon_node_send_sync_committee_contributions_total
andvalidator_beacon_node_published_block_total
metrics have been deprecated in favour of the newvalidator_beacon_node_requests_total
metric.
The old metrics will be removed in a future release. An update to the Teku Dashboard that uses the new metric is available. - The
/eth/v1/debug/beacon/states/:state_id
endpoint has been deprecated in favor of the v2 Altair endpoint/eth/v2/debug/beacon/states/:state_id
- The
/eth/v1/beacon/blocks/:block_id
endpoint has been deprecated in favor of the v2 Altair endpoint/eth/v2/beacon/blocks/:block_id
- The
/eth/v1/validator/blocks/:slot
endpoint has been deprecated in favor of the v2 Altair endpoint/eth/v2/validator/blocks/:slot
- The
/eth/v1/debug/beacon/heads
endpoint has been deprecated in favor of the v2 Bellatrix endpoint/eth/v2/debug/beacon/heads
- The commandline option
--network
of thevalidator-client
subcommand has been undeprecated and can be used to select a network for standalone validator clients. When set toauto
, it automatically
fetches network configuration information from the configured beacon node endpoint.