25.9.2

This is a hotfix release targeting an issue with 25.9.1. If you are a node operator running 25.9.1, it is highly recommended to upgrade. For all other operators, it is an optional upgrade.

Key Changes

• bug fix resolving a potential deadlock introduced with 25.9.1, causing the node to stall.

Downloads

• Available as 25.9.2 on Dockerhub
• Download the binary distribution:
  • tar.gz (sha256: 6af63091336c524d0a4773463d1d5e98ef6d77af341461f95768c4c2e0a87145)
  • zip (sha256: 5abd86581bb06c029fd76971ad6a221b2bdd04505b2ab17aeeb60c3e47bb4bbe)

Breaking Changes

N/A

Additions and Improvements

N/A

Bug Fixes

• bug fix resolving a potential deadlock introduced with 25.9.1, causing the node to stall.

Upcoming Breaking Changes

• GOSSIP_MAX_SIZE, MAX_CHUNK_SIZE, TTFB_TIMEOUT, and RESP_TIMEOUT configuration variables will NOT be supported after the Fusaka Mainnet release. These variables should be removed from any custom network configs.

25.9.1

This is a hotfix release targeting an issue with 25.9.0.

We have identified an issue where Teku isn't able to follow the network after upgrading to 25.9.0. Further information is available at https://hackmd.io/@teku/B1lVi-Scxg. If you are on a Debian/Ubuntu system with Grafana installed, this is likely to affect you and you should upgrade to 25.9.1.

Key Changes

• Reverted snappy-java to the previous version to avoid incompatibility with some systems.

Downloads

• Available as 25.9.1 on Dockerhub
• Download the binary distribution:
  • tar.gz (sha256: 2991d9b528c2dc19a3c4ef92142b43ca9f397398c49bdfc2820c3475b3d967e2)
  • zip (sha256: b6a08a9f65772bd1ae23629130d559ab2cbd3b1495df100dd6ddbd9883eb5178)

Breaking Changes

N/A

Additions and Improvements

N/A

Bug Fixes

• Downgraded snappy library because of musl issue on some nodes.

Upcoming Breaking Changes

• GOSSIP_MAX_SIZE, MAX_CHUNK_SIZE, TTFB_TIMEOUT, and RESP_TIMEOUT configuration variables will NOT be supported after the Fusaka Mainnet release. These variables should be removed from any custom network configs.

Read the changelog for 25.9.0 to see all new features and bug fixes added on 25.90: https://github.com/Consensys/teku/releases/tag/25.9.0

25.9.0

This is an optional update containing bug fixes and improvements.

KNOWN ISSUE

We have identified an issue where Teku isn't able to follow the network after upgrading to 25.9.0. Further information is available at https://hackmd.io/@teku/B1lVi-Scxg . If you are on a debian/ubuntu system with grafana installed, this is likely to affect you. Consider deferring installing until 25.9.1 is available.
If this issue does affect you, you should downgrade to 25.7.1 until 25.9.1 is available.

Downloads

• Available as 25.9.0 on Dockerhub
• Download the binary distribution:
  • tar.gz (sha256: c2b7b7f1e2d2129bed4b2419486469668eb9da67c56f0ba8c71563ed81e5363e)
  • zip (sha256: 4ef823835343abfda7cc5f6c517607b7cf485a4b084970ffd59aaa34adee666c )

Breaking Changes

N/A

Additions and Improvements

• Enabled, by default, a new attestation pool implementation that improves the attestation packing during block and aggregation production. It can still be disabled by setting --Xaggregating-attestation-pool-v2-enabled=false if needed
• Added --p2p-discovery-bootnodes-url CLI option.
• Updated LUKSO configuration with Electra fork scheduled for epoch 190800 (September 17th, 2025, 16:20:00 UTC)
• Avoid builder validator registration calls, potentially delaying block production builder calls.
• Removed TTFB_TIMEOUT and RESP_TIMEOUT from the default network configurations in line with ethereum/consensus-specs#4532

Bug Fixes

• Limited the allowed time to wait for fork choice before proceeding with attestation duties, and added a development flag to adjust the timing if required.
• Allowed voluntary exits to be periodically re-broadcast if they have been submitted locally and they have been in the queue for a long time (2 hours).

Upcoming Breaking Changes

• GOSSIP_MAX_SIZE, MAX_CHUNK_SIZE, TTFB_TIMEOUT, and RESP_TIMEOUT configuration variables will NOT be supported after the Fusaka Mainnet release. These variables should be removed from any custom network configs.

25.7.1

This is an optional update containing bug fixes and improvements.

Downloads

• Available as 25.7.1 on Dockerhub
• Download the binary distribution:
  • tar.gz (sha256: f89ed70b9723015dc0a223ff901ac594a4a22a95181ffda729843943db2c323e)
  • zip (sha256: c31c8595a647d0fe705360b467d2bd24fc1211ff8f65e573a63b97dc4ea844af)

Breaking Changes

• Removed --validators-proposer-blinded-blocks-enabled unused option. This option is not used anymore and should be removed from any config

Additions and Improvements

• Increase the default gas limit (--validators-builder-registration-default-gas-limit) to 45 million

Bug Fixes

• Fix a regression introduced in the previous release causing a validator client configured with sentry nodes to not work properly

Upcoming Breaking Changes

N/A

25.6.0

This release introduced a regression on validator clients using a sentry configuration (sentry-config-file).
Roll back to 25.5.0 if you are affected.

This is a recommended update containing bug fixes and performance improvements.

Downloads

• Available as 25.6.0 on Dockerhub
• Download the binary distribution:
  • tar.gz (sha256: 89830d89e1ea7056d9dd522751c781f843465b35d181374ddb8072d75908e069)
  • zip (sha256: c26606801ab6dffbdefbe401a06e953e38de9c48fa3508928fe0759b280d9e80)

Breaking Changes

• Previous versions of Teku will not be able to read the configuration from this version of Teku (including VC) due to the defaulting of BPO configuration to an empty list.

Additions and Improvements

• Added /eth/v1/beacon/states/{state_id}/validator_identities endpoint to allow querying of validator identities.
• Several improvements on how validator client handles multiple beacon nodes:
  • reduced timeout for beacon node API calls down to 10 seconds
  • improved handling of unresponsive\unreachable beacon nodes.
  • dedicated thread pools for beacon node API calls

Bug Fixes

• Fixed validator client missing duties when secondary beacon nodes are not responsive. Happens only for validator clients configured with multiple --beacon-node-api-endpoints.

Upcoming Breaking Changes

• The --validators-proposer-blinded-blocks-enabled is deprecated and will be removed. It's not used anymore and should be removed from any configs.

25.5.0

This is a recommended update containing bug fixes and performance improvements.

Downloads

• Available as 25.5.0 on Dockerhub
• Download the binary distribution:
  • tar.gz (sha256: 56ee3d111473e35434f4f1f8d8bb4f43d2859b1b54682b024412faaa33fcfe9d)
  • zip (sha256: a097c1fe19e47fadcdfcb3f87ebef5508fba594f57d95fd56553afe4502bba08)

Breaking Changes

• Previous versions of Teku will not be able to read the configuration from this version of Teku (including VC) due to the addition of BPO configuration.

Additions and Improvements

• Added --p2p-static-peers-url option to read static peers from a URL or file
• Added node epoch and computed slot to the sync committee duties failure message for more context about the failure condition.
• Updated third-party libraries.
• Added an info message on startup for the highest supported milestone and associated epoch.
• Added JDK 24 docker image build.
• Reduced block building time at the first slot of an epoch when a large number of validators are configured.
• Improved configuration loading to utilise built-in configurations and default any necessary fields that were missing from a passed-in configuration.
• Added /teku/v1/admin/add_peer endpoint to allow adding static peers via the REST API.

Bug Fixes

• Added an error if the genesis state has invalid data in its latest block header.

Upcoming Breaking Changes

N/A

25.4.1

This is a required update for Mainnet, Gnosis, and all electra enabled networks.

Mainnet Electra activation will happen at epoch 364032 (May 7, 2025, 10:05:11am UTC).

Gnosis Electra activation will happen at epoch 1337856 (April 30, 2025, 14:03:40 UTC).

Downloads

• Available as 25.4.1 on Dockerhub
• Download the binary distribution:
  • tar.gz (sha256: fb6720317a2408e80971fa8caa94f1f29a3af89aa05af02337579d8a0acd93e4)
  • zip (sha256: 1f1093a89a171fdcdccf5c6331d18a32fd13eb83f354570731a30cdcb8b7da6e)

Breaking Changes

• It is no longer possible to set both --checkpoint-sync-url and --initial-state. If your node fails to start after upgrade, ensure that only one of these is set.

Additions and Improvements

• Updated Teku bootnode ENR on Sepolia and Mainnet
• Scheduled Electra for Mainnet at epoch 364032 (May 7, 2025, 10:05:11am UTC)
• Scheduled Electra for Gnosis at epoch 1337856 (April 30, 2025, 14:03:40 UTC)
• Third party library updates.

Bug Fixes

• It is no longer possible to set both --checkpoint-sync-url and --initial-state.
• Aggregating attestations using DVT does not cause missed aggregations when multiple validators are
  scheduled for the same slot #9347.

Upcoming Breaking Changes

N/A

25.4.0

This is an optional update for Mainnet users.

It is a recommended update containing bug fixes and performance improvements for all Testnets (already running on Electra).

Downloads

• Available as 25.4.0 on Dockerhub
• Download the binary distribution:
  • tar.gz (sha256: b77d16d0c3078d4c55c133c2c2e0b654a8aec4f292c6ace9a0fa29c6d7572287)
  • zip (sha256: ba0887059434e65c9b89278be47cd8c1b094a66daa1dbb4dbe13b769110ac1c1)

Breaking Changes

N/A

Additions and Improvements

• Increased the attestation queue size limits.
• updated graffiti watermarking to put the EL first and shrink the max size.
• Increased the minimum thread count for batch signature verification to 4. If you are on less than a 4 cpu instance, you can override this back to default by using --Xp2p-batch-verify-signatures-max-threads=2
• Increased the queue size limit for batch signature verification to 30000.
• Introduced new metric validator_teku_version_total which tracks the Teku version in use when running a standalone VC
• Added bootnode-only mode
• Validator duty metrics now are enabled by default

Bug Fixes

• Fix for post-Electra attestation aggregation

Upcoming Breaking Changes

N/A

25.3.0

This is a required update to run Hoodi testnet. Optional for other networks.

Downloads

• Available as 25.3.0 on Dockerhub
• Download the binary distribution:
  • tar.gz (sha256: 83b253bf44e32e13f095a826aa57b2e22ba4c626200d0188032581bf944db7fc)
  • zip (sha256: 5f256638d47be41be0fd6ac09c97970bbc70071e214e2075e1438a4807637d92)

Breaking Changes

• --logging CLI option has been modified to specify only the logging level of Teku classes and
  related dependencies (discovery, lipb2p). Logging level of other 3rd party dependencies can still be
  changed either via log4j configuration file
  or via API at runtime.

Additions and Improvements

• Added beacon-api /eth/v1/beacon/states/{state_id}/pending_partial_withdrawals endpoint for use post-electra.
• Added beacon-api /eth/v1/beacon/states/{state_id}/pending_deposits endpoint for use post-electra.
• Added beacon-api /eth/v1/beacon/states/{state_id}/pending_consolidations endpoint for use post-electra.
• Added Chiado Electra configuration due at Mar-06-2025 09:43:40 GMT+0000
• Removed stack trace by default from duty failure messages.
• Holesky pectra bad block ignored to aid syncing
• Added a development flag to increase the maximum pending queue for attestations.
• Added support for Hoodi testnet.

Bug Fixes

• Added 415 response code for beacon-api /eth/v1/validator/register_validator.
• Accept HTTP headers in a case-insensitive manner (RFC 7230)
• Increased the attestation queue size limits.

Upcoming Breaking Changes

N/A

25.2.0

This is an optional update for Mainnet nodes, containing improvements to the client.

This is a required update for nodes running on Holesky or Sepolia network as it contains the configuration for the Electra hard fork.

Downloads

• Available as 25.2.0 on Dockerhub
• Download the binary distribution:
  • tar.gz (sha256: 71c8c02a277162d178259b60ae7d7d44927256a3c035c7d448c0b823caec7b4e)
  • zip (sha256: 7ef4998d874b9f0118ef5b43f79ba42fef54ee328549cf87e38911ed4dc9f70f)

Breaking Changes

• Removed MAX_CHUNK_SIZE from network global configurations, which will mean older clients will not get it from newer versions of Teku.

Additions and Improvements

• Applied spec change to alter GOSSIP_MAX_SIZE to MAX_PAYLOAD_SIZE.
• MAX_PAYLOAD_SIZE is now used instead of MAX_CHUNK_SIZE.
• Updated 3rd party products to latest versions.
• Add SSZ support to validator registration via Builder API.
• Deprecated beacon-api /eth/v1/config/deposit_contract - will be removed after electra, in the fulu timeframe.
• Deprecated beacon-api /teku/v1/beacon/pool/deposits - will be removed after electra, in the fulu timeframe.

Bug Fixes

N/A

Upcoming Breaking Changes

N/A