Creating a new validator

Note: Instead of creating a validator key pair and then distribute that into Key Shares, you can run a Distributed Key Generation ceremony, thanks to the SSV DKG Client.

This guide shows how to create a new set of validator keys for the Holesky testnet. For Ethereum mainnet, simply change Launchpad configuration from the page's dropdown menu, and refer to this Deposit Contract on mainnet, instead.

The official Staking Launchpad (follow this link for mainnet) allows developers to create a new validator via the web interface, but the procedure on the Web UI can be hardly integrated in an automated process.

What's more important, the Launchpad procedure includes steps related to the Execution client and Consensus client. These are not unnecessary and the steps should be skipped.

When joining the SSV network, you will not need to run the validator yourself, as Node Operators of the SSV networks will be running the clients on your behalf.

The essential steps to create a new validator are only these two:

  1. Generate validator keys

  2. Activate previously generated keys

For this reason, an alternative and shorter route to the Launchpad is to use the Staking Deposit CLI and the Staking Deposit Contract.

Prerequisites

  • Confidence using the command line, and command line interfaces

  • ETH (or Goerli/Holesky ETH): 32 + ~0.1 for gas fees to activate the validator keys

Generate validator keys

Head over to the official Staking Deposit CLI project page of the Ethereum organization on GitHub. The README contains instructions to use the software, but the quickest (and suggested) way remains to use the pre-built binaries.

  1. Browse to the Releases page, then download and extract the correct binary for your Operating System.

  2. Inside the folder there should be a deposit binary. This should be executed from a terminal and has 2 commands, depending on your configuration:

    1. Run the ./deposit new-mnemonic if you need to create keys from a new mnemonic phrase.

    2. Run the ./deposit existing-mnemonic if you want to generate keys from an existing mnemonic phrase

There are additional arguments to be provided to change language, reference chain, create multiple validator keys at once, or provide an address for withdrawing staking rewards.

Here’s the command used to create one set of validator keys for the holesky testnet, providing the address to withdraw staking rewards (you must have ownership of such address):

./deposit new-mnemonic --num_validators 1  --chain holesky  --eth1_withdrawal_address [YOUR_ETHEREUM_WALLET_ADDRESS]

At this point you should open the terminal of your Operating System, type the command above, with the correct values and parameters, according to your configuration.

The procedure is interactive and it will ask you to store the mnemonic phrase, as well as to provide a password for the validator keys. At the end of it, the CLI will tell you where the keys have been stored (usually under a validator_keys subfolder of the current folder).

Make sure to store and preserve the mnemonic phrase and the key passphrase in a secure environment, as they contain sensitive data that cannot be recovered otherwise.

Take note of the keys location, you’ll need the file named deposit_data-[TIMESTAMP].json in the next step.

Activate validator keys

To activate the validator keys you must deposit the 32 ETH (or testETH) to the Deposit Contract on chain. There are two options to do so:

  1. Directly interacting with the Staking Deposit Contract

  2. Using the official Staking Launchpad, and GUI

Activate via Staking Deposit Smart Contract

A quick way to send transactions to the Staking Deposit Contract is to visit the Staking Deposit Contract page on Etherscan, and browse the Contract tab, then select the Write Contract option.

This page lists all the smart contract’s functions, and offers a form, where each field represents one of the arguments of the contract’s method in question.

In order to activate the validator keys, you need to call the deposit function via a transaction, providing:

  • deposit

  • pubkey

  • withdrawal_credentials

  • signature

  • deposit_data_root

All the necessary information can be found in the deposit_data-[TIMESTAMP].json file, resulting from the Generate validator keys step. Just copy the value related to the correct key (e.g.: 32000000000 from the amount key in the deposit field) from the JSON file to the web page and fill the form.

Here's an example:

[
  {
    "pubkey": "b0210e4333812d669b178443b77e1674329e2eeeae17e6b9d7ef6cb8723c8b269de7e152b42445d5ea8d5f582ca45cd7",
    "withdrawal_credentials": "010000000000000000000000f0179dec45a37423ead4fad5fcb136197872ead9",
    "amount": 32000000000,
    "signature": "96b504aec4ced4d680a01a2cde40632809744f967657f4aa31d4bc77701dbeb68e86441999b3559c505e5644eed9c350091af39e3e319befe4a76e796856095912938046ce567ed39a56df13b8f31e9e83b93ca774a9f983b9c0eb673c7f7a4a",
    "deposit_message_root": "d09880f5dab2c46c7d4e6d7148c54eebd4b33db44b2cd194dff3a8aaff6ad9eb",
    "deposit_data_root": "aa9bb085dc0410d2013cff51e98ae2a41a81512a0676fbe0397c3cd997f1fb87",
    "fork_version": "01017000",
    "network_name": "holesky",
    "deposit_cli_version": "2.7.0"
  }
]

To perform the transaction via the UI, it’s necessary to connect your Web3 wallet, by clicking on the Connect to Web3 button, sign in with the wallet of your choice (e.g. Metamask), and finally click on the Write button and accept the transaction from the wallet to make it go through.

Alternatively, the smart contract transaction can be generated via SDKs such as ethers.js and web.js. This should be how you would want to integrate SSV in the DApp you’ll be building, for example.

Activate via official Staking Launchpad

If you don’t trust performing the transaction via Etherscan's Beta functionality, or simply prefer a more official route, you can visit the Staking Launchpad and access the full procedure to create a new validator, by clicking Become a Validator.

This is a summary of the procedure itself:

  1. Accept Advisories

  2. Select an Execution Client

  3. Select a Consensus Client

  4. Generate Keys

  5. Upload deposit data

  6. Connect wallet

  7. Deposit transaction

As mentioned at the start, the launchpad has a rigid procedure, and some steps are not relevant in this context. Nonetheless, in order to get to the “Deposit transaction” step needed to activate the validator keys, it is necessary to go through each one of them.

Just know that:

  • you will not need to choose or run neither an Execution nor a Consensus client, because the operators SSV network will do that for you, ensuring active-active redundancy, redundancy and client diversity

  • you already have generated your validator keys (in the previous step)

For this reason, you’ll have to choose something to advance, but the choices made in steps 1–4 are essentially irrelevant for the purpose of this guide.

Once you get to this screen:

Upload the deposit_data-[TIMESTAMP].json file, select Continue on this page and on the next one and accept the transaction on your wallet when requested.

Last updated