staking-deposit-cli/README.md

eth2.0-deposit-cli

Table of Contents generated with DocToc

• Tutorial for users
  • Requirements
  • For Linux or MacOS users
    • Step 1. Install deposit-cli dependencies
    • Step 2. Create your keys and deposit data
    • Arguments
  • For Windows users
    • Step 1. Install deposit-cli dependencies
    • Step 2. Create your keys and deposit data
    • Arguments
  • For venv users
• Development
  • Install basic requirements
  • Install testing requirements
  • Run tests

Tutorial for users

Requirements

• Python 3.7+
• pip3

For Linux or MacOS users

Step 1. Install deposit-cli dependencies

If it's your first time to use this tool, you need to install the Python library dependencies:

./deposit.sh install

Step 2. Create your keys and deposit data

Run the following command to enter the interactive CLI:

./deposit.sh

You can also run the tool with optional arguments:

./deposit.sh --num_validators=<NUM_VALIDATORS> --mnemonic_language=english --folder=<YOUR_FOLDER_PATH>

Arguments

Argument	Type	Description
--num_validators	Non-negative integer	The number of signing keys you want to generate. Note that the child key(s) are generated via the same master key.
--mnemonic_language	String. Options: czech, chinese_traditional, chinese_simplified, english, spanish, italian, korean. Default to english	The mnemonic language
--folder	String. Pointing to ./validator_keys by default	The folder path for the keystore(s) and deposit(s)

For Windows users

Step 1. Install deposit-cli dependencies

If it's your first time to use this tool, you need to install the Python library dependencies:

sh deposit.sh install

Step 2. Create your keys and deposit data

Run the following command to enter the interactive CLI:

sh deposit.sh

You can also run the tool with optional arguments:

sh deposit.sh --num_validators=<NUM_VALIDATORS> --mnemonic_language=english --folder=<YOUR_FOLDER_PATH>

You will see the following messages after successfully generated the keystore(s) and the deposit(s):

Arguments

See here

Creating your keys.
Saving your keystore(s).
Creating your deposit(s).
Verifying your keystore(s).
Verifying your deposit(s).

Success!
Your keys can be found at: <YOUR_FOLDER_PATH>

For venv users

If you want to use Python venv, just run:

make venv_deposit

Development

Install basic requirements

python3 -m pip install -r requirements.txt
python3 setup.py install

Install testing requirements

python3 -m pip install -r requirements_test.txt

Run tests

python3 -m pytest .