Non-deterministic wallet
Background
A Non-HD wallet provides the ability to create simple, encrypted validators accounts stored directly-on disk. Validator private keys are generated non-deterministically, meaning there is no seed phrase (mnemonic) which can be used to recover an entire wallet. If you created a deposit using the official Medalla testnet launchpad and want to run Prysm using it, see our dedicated instructions here.
Pro-Tip
This is one of the safest ways of running Prysm, because you can generate your wallet using any other software you prefer such as the official eth2.0-deposit-cli and simply import the validating keys you need. You can then keep your mnemonic and all other sensitive information secure and away from your validator.
Validator private keys are encrypted with a password using the EIP-2335 keystore.json standard for storing BLS12-381 private keys.
Validating keys are stored in the wallet's directory under a single all-accounts.keystore.json file which is encrypted with a strong wallet password.
Your password to unlock this file is not stored on disk. You will need to provide it anytime you run the validator or provide it via your own file using the --wallet-password-file flag.
Usage
Wallet creation
A non-HD wallet is the most basic sort of wallet, storing all information on-disk. This approach makes it trivial to import, export and list all associated accounts within the wallet. To start using the non-HD wallet, you can create a new wallet using
and selecting non-HD wallet when prompted during an interactive process. You can also create a wallet non-interactively by using the following command line flags, which are also viewable by typing `./prysm.sh validator wallet-v2 create --help.
info
You'll need to set a strong password for your new validator account, containing at least 1 uppercase letter, 1 number, a special character, and be at least 8 characters long. Any unicode characters can be used for your account passwords.
| Flag | Usage |
|---|---|
--wallet-dir | Path to a wallet directory (default: "$HOME/Eth2Validators/prysm-wallet-v2") |
--wallet-password-file | Path to a file containing your wallet's password for automatic unlocking |
--keymanager-kind | Type of wallet to create, either "direct", "derived, or "remote" (default "derived") |
Here's a full example on how to create a non-HD wallet at $HOME/mynonhdwallet.
New validator account
You can create a new validator account for your non-HD wallet using the following command
Soon after, the command will complete and you will see two important pieces of information you'll need for your validator.
Copy your withdrawal key somewhere safe and offline, as it is your only means of withdrawing your validator rewards from participating in eth2. You can then copy the deposit data text and use it when sending 32ETH to the Validator Deposit Contract for eth2.
You can also create a new validator account non-interactively by using the following command line flags, which are also viewable by typing `./prysm.sh validator accounts-v2 create --help.
| Flag | Usage |
|---|---|
--wallet-dir | Path to a wallet directory (default: "$HOME/Eth2Validators/prysm-wallet-v2") |
--wallet-password-file | Path to a plain-text, password.txt file containing your wallet password |
Here's a full example on how to create a new validator account for your non-HD wallet stored at $HOME/mynonhdwallet with account passwords stored at $HOME/myaccountpasswords.
List validator accounts
You can list all validator accounts in your non-HD wallet using the following command
Where you'll see the following output
You can also run the accounts-v2 list command non-interactively by using the following command line flags, which are also viewable by typing `./prysm.sh validator accounts-v2 list --help.
| Flag | Usage |
|---|---|
--wallet-dir | Path to a wallet directory (default: "$HOME/Eth2Validators/prysm-wallet-v2") |
--wallet-password-file | Path to a plain-text file containing your wallet password |
Import validator accounts
You can import validator keystores from a separate folder into your wallet with the following command
This will import all files that are valid EIP-2335 keystores, such as those generated by the official eth2 deposit launchpad's command-line tool. For more information on how to run Prysm when coming from launchpad, read our Medalla testnet onboarding documentation. The files you are importing must have the prefix keystore-.
Export validator accounts
You can export validator accounts from your non-HD wallet using the following command
TODO: Work-in-progress.