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

25.1.0

This is an optional update containing upgrades to metrics and other improvements.

Downloads

• Available as 25.1.0 on Dockerhub
• Download the binary distribution:
  • tar.gz (sha256: 6673e01571c9853beef9f98b445dd83307caaefac21a49e93707349df24408c3)
  • zip (sha256: c4462aa066187c87e372360c83dde7e854ee91436c7b828e9584c9901f7f3d61)

Breaking Changes

• --Xvalidators-builder-registration-default-gas-limit CLI option has been replaced by --validators-builder-registration-default-gas-limit
• --Xp2p-sync-rate-limit CLI option has been replaced by --Xp2p-sync-blocks-rate-limit and --Xp2p-sync-blob-sidecars-rate-limit
• --Xpeer-rate-limit CLI options has been replaced by --Xpeer-blocks-rate-limit and --Xpeer-blob-sidecars-rate-limit

With the upgrade of the Prometheus java metrics library, there are the following changes:
Gauge names are not allowed to end with total, therefore metrics as beacon_proposers_data_total and beacon_eth1_current_period_votes_total are dropping the _total suffix.

The _created timestamps are not returned by default.

Some JVM metrics have changed name to adhere to the OTEL standard (see the table below), Teku Detailed Dashboard is updated to support both names.

Old Name	New Name
jvm_memory_bytes_committed	jvm_memory_committed_bytes
jvm_memory_bytes_init	jvm_memory_init_bytes
jvm_memory_bytes_max	jvm_memory_max_bytes
jvm_memory_bytes_used	jvm_memory_used_bytes
jvm_memory_pool_bytes_committed	jvm_memory_pool_committed_bytes
jvm_memory_pool_bytes_init	jvm_memory_pool_init_bytes
jvm_memory_pool_bytes_max	jvm_memory_pool_max_bytes
jvm_memory_pool_bytes_used	jvm_memory_pool_used_bytes

The Teku - Detailed grafana dashboard has been updated to use the new metrics.

Additions and Improvements

• Default the gas limit to 36 million for externally produced blocks
• Optimized blobs validation pipeline
• Remove delay when fetching blobs from the local EL on block arrival
• New validator metric validator_next_attestation_slot to highlight the next slot that a validator is expected to publish an attestation
• Added support for SSZ format in builder API (mev-boost)
• Added the expected gas limit to the 'not honouring the validator gas limit preference' warning message.
• Implemented the ability to have fork based ascii art.

Bug Fixes

• Fixed --version command output
• Fixed issue introduced in 24.12.1 with peer stability when the upper bound is set to a high number

24.12.1

This is a recommended update containing bug fixes

Downloads

• Available as 24.12.1 on Dockerhub
• Download the binary distribution:
  • tar.gz (sha256: 4e65622127ba85dd6589e593970be9516cd42d97fd6194fe4a6e5535eccbbb99)
  • zip (sha256: 1505e8fb2feb053d3f9f32e4611985fb7f5f4b2394e2fd65b1f74d75b84d5f99)

Breaking Changes

N/A

Additions and Improvements

N/A

Bug Fixes

• Updated the gas change check for block building so that warnings only get raised if the change is off spec.
• Fixed an issue with the /eth/v1/config/spec API not returning all previously included configuration parameters.
• Increase the maximum size of a compressed message for libp2p to ensure uncompressed blocks can grow to max size.

Upcoming Breaking Changes

• Some metric names will change in our 25.1.0 release. Keep an eye for a detailed docs page with the affected metrics and a new version of Teku Detailed grafana dashboard.

24.12.0

This is a recommended update containing bug fixes and security updates.

Downloads

• Available as 24.12.0 on Dockerhub
• Download the binary distribution:
  • tar.gz (sha256: a220130a5a1124b14b046412bb8ec582959344c162e931c9023982b9743d79a3)
  • zip (sha256: 45de55d8bd6ee6659970d24e9ebecaf6d0a761bbf64502c47f82831509625d59)

Breaking Changes

N/A

Additions and Improvements

• Improved block publishing performance, especially relevant with locally produced blocks
• Delayed blob publishing until the block is published to at least 1 peer, especially relevant with locally produced blocks with low upload bandwidth connections. Can be disabled via --Xp2p-gossip-blobs-after-block-enabled=false

Bug Fixes

• Added a startup script for unix systems to ensure that when jemalloc is installed the script sets the LD_PRELOAD environment variable to the use the jemalloc library
• Set is_syncing to false instead of true for the /eth/v1/node/syncing API endpoint when the head is optimistic and the sync distance is 0
• Fix libp2p direct peers handling
• Added check for gossip message maximum uncompressed size

Upcoming Breaking Changes

• Some metric names will change in our 25.1.0 release. Keep an eye for a detailed docs page with the affected metrics and a new version of Teku Detailed grafana dashboard.

24.10.3

This is a recommended update with bug fixes and networking improvements.

Mekong Testnet
Note: this is the only version of Teku that supports the Mekong testnet (https://mekong.ethpandaops.io/).
Due to a bug this version does NOT support Mekong anymore, please use the mekong branch (https://github.com/Consensys/teku/tree/mekong) building it from source (more info can be found here)

Downloads

• Available as 24.10.3 on Dockerhub
• Download the binary distribution:
  • tar.gz (sha256: ca9111ba2a47261b71892e1e5f50789211c7e5dfd1b612c6d7f0f5802f99d767)
  • zip (sha256: 90f870d7b35acd2393b20d30346f2593cc1688849334bb0ec626ef260497eb43)

Breaking Changes

N/A

Additions and Improvements

• Clean up old beacon states when switching from ARCHIVE to PRUNE or MINIMAL data storage mode
• Upgrade to jvm-libp2p 1.2.1 which brings:
  • message publishing over gossipsub improvements (addresses Failed to publish * because no peers were available on the required gossip topic)
  • IDONTWANT control message usage improvements
• Improved block production API compatibility with DVT software (i.e. SSV)

Bug Fixes

• Fixed a block production issue for Validator Client (24.10.0 to 24.10.2 Teku VC), where required headers were not provided for JSON payloads. Default SSZ block production was unaffected.
• Block production now uses json data (more like 24.8.0 did than 24.10) if the Eth-Consensus-version header is absent.

Upcoming Breaking Changes

N/A

24.10.2

This release is a hotfix to address an issue affecting Windows users using versions 24.10.0 and 24.10.1 that was preventing Teku from starting up.

Downloads

• Available as 24.10.2 on Dockerhub
• Download the binary distribution:
  • tar.gz (sha256: 1cc76913f3b85987e2a60c9b94c6918d31773ebd3237c5fdf33de366fa259202)
  • zip (sha256: 18aafa3e0b862b05dc4e1f14aa1f2527a2dc6352d9e985470da9d7b15438a597)

Breaking Changes

• Renamed metrics validator_attestation_publication_delay,validator_block_publication_delay and beacon_block_import_delay_counter to include the suffix _total added by the current version of prometheus.

Additions and Improvements

N/A

Bug Fixes

• Windows startup issue.

Upcoming Breaking Changes

N/A

24.10.1

KNOWN ISSUE

This release is not compatible with Windows. Teku will fail to start on Windows.
Workaround: manually delete the file jc-kzg-4844-1.0.0.jar located under the teku/lib directory and restart Teku.

This release is a hotfix to address an issue introduced in version 24.10.0 that was preventing Teku from starting up when using the --validators-proposer-config configuration option.

Downloads

• Available as 24.10.1 on Dockerhub
• Download the binary distribution:
  • tar.gz (sha256: dca08124d8f6d5127505760f4e332d16536e1d16fed63e1df7bfe4d08273e6be)
  • zip (sha256: 88629729c0795374cf058d91c02b886be53b9f82710e6fc1d1346c5395b4227b)

Breaking Changes

• Renamed metrics validator_attestation_publication_delay,validator_block_publication_delay and beacon_block_import_delay_counter to include the suffix _total added by the current version of prometheus.

Additions and Improvements

N/A

Bug Fixes

• Fix startup issue when using --validators-proposer-config configuration option.

Upcoming Breaking Changes

N/A

24.10.0

KNOWN ISSUE

This release has an issue for users that have --validators-proposer-config loading their proposer configuration file. Users with a configured proposer config file should not install this release.

This release is also not compatible with Windows. Teku will fail to start on Windows.

This issue is resolved in 24.10.1

Summary

This is a recommended update containing blobs handling and networking improvements.

Downloads

• Available as 24.10.0 on Dockerhub
• Download the binary distribution:
  • tar.gz (sha256: f48a1255553be04830396149c48ef660034e50baa454c9cacb310ace2c8ca66f)
  • zip (sha256: 67ef7e1aa4dc138c526d8ac7230c965157032a579a98767b22aba8e8db1662ff)

Breaking Changes

• Renamed metrics validator_attestation_publication_delay,validator_block_publication_delay and beacon_block_import_delay_counter to include the suffix _total added by the current version of prometheus.

Additions and Improvements

• Removed the deprecated GetBlindedBlock
• Removed the deprecated GetBlockV2
• Implemented PostAggregateAndProofsV2 (adding support for Electra)
• Added support for Ephemery Testnet --network=ephemery
• Updated bootnodes for Holesky network
• Disabled flood publish behaviour on all p2p subnets. --Xp2p-flood-publish-enabled experimental parameter can be used to re-enable it, restoring previous behaviour.
• Add a fix for CVE-2024-7254
• Updated LUKSO configuration with Deneb fork scheduled for epoch 123075 (November 20, 2024, 16:20:00 UTC)
• Support for IDONTWANT libp2p protocol messages
• /eth/v1/node/peers endpoint now populates enr field of the peer whenever is possible
• Support for engine_getBlobsV1 to retrieve blobs using local execution layer. This will improve block import time when blobs are published late.

Bug Fixes

• Removed a warning from logs about non blinded blocks being requested (#8562)
• Fixed blockImportCompleted log message timing #8653

Upcoming Breaking Changes

N/A