This is v1.2.0 of Hyperdrive.

This introduces support for the new StakeWise v3 vaults, which dramatically improve the operator experience for NodeSet node operators.

⚠️ This also updates all clients to versions that are ready for Pectra on Mainnet (epoch 364032, May 7 2025 - 10:05:11 AM UTC).
It is required for all Mainnet users before that time.

For all node operators, please read our documentation on what's new with the new StakeWise module and how to use it. Essentially, it comes down to a few simple commands:

• Make sure your wallet has enough funds to cover depositing gas costs.
• Run hyperdrive stakewise wallet generate-keys to generate new validator keys that can be used for new deposits. This is the only step that needs to be done manually.
• The rest of the process (depositing when assets are available) is all done automatically on a first-come-first-served basis. There's no more queue and no more blacklisting!
• To view which keys have been used for deposits and which are still available, take a look at the guide.

Patch Notes (Including Beta Notes)

Deprecations

• The Holesky network is now deprecated and will be removed in a future release. If you're still using Holesky, please migrate to the new Hoodi testnet.

Clients

• Updated Besu to v25.4.1.

• Updated Geth to v1.15.9.

  • The supermajority warning has been removed from Geth, as it is now at 41% of the network.

• Updated Reth to v1.3.12.

  • Reth has been modified to preserve all event logs for all contracts (starting from the deposit contract deployment block).
  • If you previously used Reth without manually specifying this behavior, you will need to resync it to regenerate the events that StakeWise needs.

• Updated Nethermind to v1.13.9.

• Updated Lighthouse to v7.0.0.

• Updated Lodestar to v1.29.0.

• Updated Nimbus to v25.4.0.

• Updated Prysm to v6.0.0.

• Updated Teku to v25.4.1.

• Updated MEV-Boost to v1.9.

• Updated the Node Exporter to v1.9.1.

Services

Core

• MEV Boost is now supported on Hoodi.
• Manual installation via the install script now updates the service containers again (unless the --no-restart flag is specified).

StakeWise

Please read our documentation on what's new with the new StakeWise module and how to use it.

• Support for StakeWise v1 vaults has been removed.
• The daemon no longer generates deposit data in advance and uploads it to nodeset.io.
• The StakeWise operator no longer requires a complete deposit data file for all node operators in a vault, so this is no longer retrieved from nodeset.io.
• The daemon now provides a relay service for the StakeWise operator to interact with. This coordinates between your generated keys, nodeset.io, and the operator to provide deposit data to the operator when it wants to make new validators for StakeWise v3 vaults.
• Prepared the backend for multiple vault support.

CLI

• The stakewise command has had some changes:
  • nodeset has been removed.
  • status has been removed.
  • wallet claim-rewards has been removed, since rewards claiming is done via nodeset.io and not via Hyperdrive.
  • New command: network status can be used to retrieve the status of all StakeWise vaults, including how much ETH they have available to deposit, how many validators each user is able to run, and how many you currently have.
  • New command: validator status will show the status of all of your registered validators, including which vault they belong to and their Beacon chain information (state, balance, etc.).
  • New command: wallet get-available-keys shows which keys you have generated that haven't been used for deposits yet.
  • New command: wallet recover-keys can be used to regenerate your validator keys during disaster recovery. It retrieves the list of registered validator keys from nodeset.io in order to determine what to recover.

Config

• New parameter for Reth: State Prune Distance controls the number of blocks Reth keeps in its state cache (from the chain head). This is needed to query the chain using previous states.
• New parameter: StakeWise / Relay Port is used to control the internal port used by the StakeWise daemon container for the StakeWise HTTP relay service. Since this is internal to the Docker network, this isn't exposed on your host system or to outside traffic.

Misc

• Updated to Go v1.24.
• The GPG key used to sign release artifacts has been updated to v2.