StakeWise
Search…
How to:
Internals
Generate Deposit Data
The deposit data is used for registering new validators. StakeWise oracles are responsible for choosing the operator for the new validator based on different metrics (number of keys, performance, etc.). Once operator is selected, its deposit data is used to register the validator in beacon chain.
1. Installation
Navigate to the releases page to download and decompress the latest version of
operator-cli for your operating system.2. Generate deposit data
NB! You must use a new mnemonic for every staking setup. If you use the same mnemonic, you can accidentally run same validator in multiple places and get slashed.
New mnemonic
Run the following command to generate deposit data with the new mnemonic:
1
./stakewise-cli create-deposit-data
Copied!
Choose the network you would like to generate the deposit data for:
1
Enter the network name (mainnet, goerli, gnosis) [mainnet]: mainnet
Copied!
Choose the language for your mnemonic:
1
Choose your mnemonic language (chinese_simplified, chinese_traditional, czech, english, italian, korean, portuguese, spanish) [english]:
Copied!
NB! You must store the generated mnemonic in secure cold storage. You won't be able to restore the keys in case it will be lost.
Existing mnemonic
Run the following command to generate deposit data using existing mnemonic:
1
./stakewise-cli create-deposit-data --existing-mnemonic
Copied!
Choose the network you would like to generate the deposit data for:
1
Enter the network name (mainnet, goerli, gnosis) [mainnet]: mainnet
Copied!
Enter your existing mnemonic:
1
Enter your mnemonic separated by spaces (" "):
Copied!
Deposit Data
Choose the number of validators you would like to run. If you're a new operator, start with a smaller amount of validator keys (e.g. 10 for the Mainnet, 100 for Gnosis Chain). Once they run smoothly, you can extend to a larger number. Also, it's better to not run too many keys in the same staking setup (e.g. up to 1000 keys in Mainnet and up to 10000 in Gnosis).
1
Enter the number of new validator keys you would like to generate: 10
2
Creating validator keys: [####################################] 10/10
3
Creating deposit data: [####################################] 10/10
Copied!
Choose the destination address for the rewards and the percent of protocol fee shares per every validator:
1
Enter the wallet address that will receive rewards. If you already run StakeWise validators, please re-use the same wallet address: 0x...
2
Enter the % of the rewards you would like to receive from the protocol fees [50.0]:
Copied!
3. Submit specification
The command from the previous step will generate the specification. For example,
1
## Specification
2
3
- DAO calls `addOperator` function of `PoolValidators` contract with the following parameters:
4
* operator: `0x...`
5
* depositDataMerkleRoot: `0x606c5a3638078206f54177ac70a71702a6e52f046a3811efa1b389f9485cbf18`
6
* depositDataMerkleProofs: `/ipfs/QmSAvPukDjU2f7w1C4b5SKKuLpwaZZeC8dsG4vV6pRjTF6`
7
8
9
- DAO calls `setOperator` function of `Roles` contract with the following parameters:
10
* account: `0x...`
11
* revenueShare: `5000`
12
13
14
- If the proposal will be approved, the operator must perform the following steps:
15
* Call `operator-cli sync-vault` or `operator-cli sync-local` with the same mnemonic as used for generating the proposal
16
* Create or update validators and make sure the new keys are added
17
* Call `commitOperator` from the `0x...` address
Copied!
You should share that specification in a StakeWise Forum post about your operator or include it in the proposal about adding/extending validator keys.
4. Send encrypted key shares
The command from the deposit data step will generate the encrypted key shares that you must share with the committee. For example,
- @username1:
/cli/committee/username1-1867c966-1.shard - @username2:
/cli/committee/username2-1867c966-1.shard - @username3:
/cli/committee/username3-1867c966-1.shard - @username4:
/cli/committee/username4-1867c966-1.shard - @username5:
/cli/committee/username5-1867c966-1.shard
These key shares can only be decrypted by the respective committee members and will be used in case something unexpected happens with the operator, e.g. it loses access to the validators, refuses to sign validators exit on the DAO request, etc.
You should use the usernames specified above to send files to respective committee members through Telegram. Once the committee members receive and confirm the correctness of these files, your deposit data generation is completed.
🎉