Open-source Ethereum consensus client written in Java
This is a recommended update containing performance improvements.
24.4.0 on Dockerhub
--network=goerli.peers_direction_current libp2p metric to track the number of peers by direction (inbound and outbound).--Xdeposit-contract-logs-syncing-enabled to allow disabling the syncing of the deposit contract logs from the EL. This is useful when running a non-validating node. It is advisable to be used alongside with --Xeth1-missing-deposits-event-logging-enabled=false to avoid unnecessary logging of missing deposits.--Xp2p-dumps-to-file-enabled to enable saving p2p dumps to file.This is a recommended update for mainnet nodes with improvements to CPU and bandwidth issues observed since Deneb upgrade.
Key changes:
24.3.1 on Dockerhub
--Xvalidator-is-local-slashing-protection-synchronized-enabled has become a supported and documented argument --validator-is-local-slashing-protection-synchronized-enabled.engine_getClientVersionV1 Engine API method, the default graffiti (when no graffiti has been configured by the validator) will include EL as well as CL version information. For more details, please see https://github.com/ethereum/execution-apis/pull/517.--p2p-private-key-file command line option supports reading a binary private key file.--builder-bid-compare-factor to 90. This makes it necessary for external block builders to give at least 10% additional profit compared to a local build before being taken into consideration. If you would like to go back to the previous default, set --builder-bid-compare-factor to 100.--p2p-direct-peers command line option to configure explicit peers as per Explicit Peering Agreements libp2p spec.This is an optional update containing improvements and bug fixes.
24.3.0 on Dockerhub
/eth/v3/validator/blocks/{slot} block production beacon node API.This is a required update for Mainnet users containing the configuration for the Deneb upgrade on March 13th. This update is required for Gnosis Deneb network upgrade on March 11th. For all other networks, this update is optional.
Attention: Teku will require around 50 GB of extra storage for blobs for Mainnet (35 GB for Gnosis), but theoretically blob storage requirements can go up to ~100 GB (200 GB for Gnosis). This extra storage space WILL NOT grow above this limit over time.
For more information about blobs, please have a look at the following page: https://docs.teku.consensys.io/concepts/proto-danksharding
24.2.0 on Dockerhub
--beacon-events-block-notify-when-validated-enabled and
--beacon-events-block-notify-when-imported-enabled have been removed. This change was made due
to redundancy, as the functionality of these options is now covered by the new block_gossip and
the existing block SSE events./eth/v3/validator/blocks/{slot} experimental beacon API for block production. It can now respond with blinded and unblinded content based on the block production flow. It also supports the builder_boost_factor parameter.block_gossip SSE event as per https://github.com/ethereum/beacon-APIs/pull/405
This is a required update for Sepolia, Holesky and Chiado. Optional for other networks.
Attention: Teku will require around 50 GB (35 GB for Chiado) of extra storage for blobs, but theoretically blob storage requirements can go up to 103 GB (200 GB for Chiado). This extra storage space WILL NOT grow above this limit over time.
24.1.1 on Dockerhub
--Xfork-choice-update-head-on-block-import-enabled and --Xbls-to-execution-changes-subnet-enabled
--Xfork-choice-updated-always-send-payload-attributes which would cause payload attributes to be calculated and sent with every fcU. This could be useful for builders consuming the payload_attributes SSE events.—p2p-private-key-file path if specified file doesn't exist.This is a required update for anyone running Goerli nodes as it contains the configuration required for the Deneb upgrade in Goerli. It is an optional update for anyone else. This version also has some bug fixes.
The Goerli upgrade is scheduled on 2024-01-17 06:32:00 UTC (timestamp 1705473120).
Attention: Teku will require around 50 GB of extra storage for blobs, but theoretically blob storage requirements can go up to 103 GB. This extra storage space WILL NOT grow above this limit over time.
24.1.0 on Dockerhub
N/A
proposer_slashing, attester_slasing and payload_attibutes (only when a loaded validator will be producing a block) events to the /eth/v1/events SSE stream #7837
202 status code could be returned but block hasn't been broadcast #7850
N/A
This is an optional update containing a few fixes of bugs found on 23.12.0. It is only a recommended upgrade for users running 23.12.0.
Note: The validator client in this release is not compatible with Lighthouse beacon nodes. If using this combination, please use release 23.11.0 of the validator client.
23.12.1 on Dockerhub
23.12.0 or 23.12.1 #7842.N/A
--ee-jwt-claim-id command line option to provide id to the execution engine JWT claims--checkpoint-sync-url as an option. #7823
--exit-when-no-validator-keys-enabled even with keys present. #7829
This is an optional update with bug fixes and performance improvements.
Note: The new --checkpoint-sync-url option is missing from the CLI help. The documentation for that flag can be found in our documentation page. The validator client in this release is not compatible with Lighthouse beacon nodes. If using this combination, please use release 23.11.0 of the validator client.
23.12.0 on Dockerhub
--checkpoint-sync-url as an option. #7823
--exit-when-no-validator-keys-enabled even with keys present. #7829
23.12.0 or 23.12.1 #7842.--checkpoint-sync-url when starting a new node. It is possible to revert back to the previous behaviour using the flag --ignore-weak-subjectivity-period-enabled.publishBlindedBlockV2 and publishBlockV2 which introduce broadcast validation parameter.REORG_HEAD_WEIGHT_THRESHOLD, REORG_PARENT_WEIGHT_THRESHOLD, and REORG_MAX_EPOCHS_SINCE_FINALIZATION to phase 0 configurations. Mainnet values have been added as defaults for configurations that have not explicitly listed them./eth/v1/beacon/states/{state_id}/validators beacon API./eth/v1/beacon/states/{state_id}/validator_balances beacon API.--exit-when-no-validator-keys-enabled command line option.--checkpoint-sync-url option, the deposit tree snapshot will also be downloaded, rather than relying on older data packaged in the release.This is an optional update containing bug fixes, performance improments and security fixes.
23.11.0 on Dockerhub
N/A
validator_duty_timer metrics recording the time to perform block_production, attestation_production and attestation_aggregation duties. Please note that this metric is not available by default and needs to be enabled using the --metrics-categories CLI option./eth/v3/validator/blocks/{slot} experimental beacon API for block production--checkpoint-sync-url CLI option.This is an optional update containing bug fixes and performance improvements.
inactivity and inclusion_delay) into the total_rewards and ideal_rewards objects.
This should be considered a breaking change only if you are strictly
checking the structure of the json in the response.23.9.1 release that included an updated LevelDB
native library not compatible with older Linux distributions. LevelDB native library has
been updated to support older GLIBC versions (ie Ubuntu 20.04 and Debian 11).N/A