Recover a validator from the mnemonic
Regenerating Keystore file using the 24 words
Guide for Linux
Open a terminal and go to the home directory.
Download the tool you used to generate the 24 words, you can obtain it from Releases · ethereum/eth2.0-deposit-cli · GitHub
In this case we are going to use the eth2deposit-cli-ed5a6d3-linux-amd64.tar.gz, where
ed5a6d3 should be changed for the latest version.
You can download it click on it or writing the next command:
(again, check the latest version here, in future commands we assume you will change it should there be a new version)
Decompress the downloaded file with:
tar -xvf eth2deposit-cli-ed5a6d3-linux-amd64.tar.gz
Access the directory we’ve just created when decompressing:
To execute the tool to regenerate our keystore from the mnemonic or 24 words:
(If we are restoring a testnet keystore we must indicate on the flag --chain)
./deposit existing-mnemonic --chain pyrmont
(If we are restoring a mainnet keystore we must indicate on the flag --chain with the work mainnet)
./deposit existing-mnemonic --chain mainnet
Now, the console will ask you for the words:
Type your 24 words, for example:
chaos jewel security draw embody project route funny impact brief decorate palace sky figure blue eleven crop ocean fly bear wasp bird arrest arrow
The next question will be:
Enter the index (key number) you wish to start generating more keys from. For example, if you've generated 4 keys in the past, you'd enter 4 here, :
Depends on how many keys you have generated in the past. In my case I generated 1, so I would write:
Repeat the confirmation.
You will be asked for Please choose how many validators you wish to run:
Depends on your preferences, I am running only 1, then I type:
Now the tool will generate new keystores for the derivated keys. It will ask us for a password to secure this new keystores. It doesn’t need to be the same as the original keystore, but it’s very important that you secure it properly: you will need it.
Prompt asks to Type the password that secures your validator keystore(s):
After writing it down, confirm.
After this process, we should have a directory called
validator_keys, where the keystores will be.
To check if you have restored correctly your validator, you can check it comparing the pubkey from:
(testnet) https://pyrmont.beaconcha.in/validator/: the pubkey has the format 0x99d2fae0915872ce3d…
(mainnet) https://beaconcha.in/: the pubkey has the format 0x99d2fae0915872ce3d…
If you know your validator in Beaconchain or Beaconscan, compare the string above with the string in the field called ‘pubkey’ on the file keystore-m…
If it is the same, you have regenerated the keystore of that validator correctly.