1. Installation
2. CLI usage
   2.1 Init
   2.2 Validator commands
   2.3 Holder commands
   2.4 Metrics commands
   2.5 Wallet commands
   2.6 Self-recharging wallet commands
3. Exit codes
4. Development

• Linux x86_64 machine

• Download executable

VERSION_NUM={put the version number here} && sudo -E bash -c "curl -L https://github.com/skalenetwork/validator-cli/releases/download/$VERSION_NUM/sk-val-$VERSION_NUM-`uname -s`-`uname -m` >  /usr/local/bin/sk-val"

• Apply executable permissions to the binary:

sudo chmod +x /usr/local/bin/sk-val

All validator-cli version numbers are available here: https://github.com/skalenetwork/validator-cli/releases

Download SKALE Manager contracts info and set the endpoint.

sk-val init

Required arguments:

• --endpoint/-e - RPC endpoint of the node in the network where SKALE manager is deployed (http or https)
• --contracts-url/-c - - URL to SKALE Manager contracts ABI and addresses
• -w/--wallet - Type of the wallet that will be used for signing transactions (software, sgx or hardware)

If you want to use sgx wallet you need to initialize it first (see SGX commands)

Usage example:

sk-val init -e ws://geth.test.com:8546 -c https://test.com/manager.json --wallet software

Initialize sgx wallet

sk-val sgx init [SGX_SERVER_URL]

Optional arguments:

• --force/-f - Rewrite current sgx wallet data
• --ssl-port - Port that is used by sgx server to establish tls connection

Print sgx wallet information

sk-val sgx info 

Optional arguments:

• --raw - Print info in plain json

Register as a new SKALE validator

sk-val validator register

Required arguments:

• --name/-n - Validator name
• --description/-d - Validator description
• --commission-rate/-c - Commission rate (percentage)
• --min-delegation - Validator minimum delegation amount

Optional arguments:

• --pk-file - Path to file with private key (only for software wallet type)
• --gas-price - Gas price value in Gwei for transaction (if not specified doubled average network value will be used)
• --yes - Confirmation flag

Usage example:

sk-val validator register -n test -d "test description" -c 20 --min-delegation 1000 --pk-file ./pk.txt

List of available validators

sk-val validator ls

Options:

• --wei/-w - Show tokens amount in wei

List of delegations for validator ID

sk-val validator delegations [VALIDATOR_ID]

Required params:

1. VALIDATOR_ID - ID of the validator

Accept pending delegation request by delegation ID

sk-val validator accept-delegation --pk-file ./pk.txt

Required arguments:

• --delegation-id - ID of the delegation request to accept

Optional arguments:

• --pk-file - Path to file with private key (only for software wallet type)
• --gas-price - Gas price value in Gwei for transaction (if not specified doubled average network value will be used)
• --yes - Confirmation flag

Accept ALL pending delegations request for the address.
List with all pending delegations to be accepted will be shown. After this user should confirm the operation.

sk-val validator accept-all-delegations --pk-file ./pk.txt

Optional arguments:

• --pk-file - Path to file with private key (only for software wallet type)
• --gas-price - Gas price value in Gwei for transaction (if not specified doubled average network value will be used)

List of the linked addresses for validator address

sk-val validator linked-addresses [ADDRESS]

Required params:

1. Address - Ethereum address of the validator

Link node address to the validator account

sk-val validator link-address [ADDRESS] [NODE_SIGNATURE] --pk-file ./pk.txt

Required params:

1. Address - Ethereum address that will be linked
2. Node signature - Signature of the node that you can get using skale node signature command from skale-node-cli

Optional arguments:

• --pk-file - Path to file with private key (only for software wallet type)
• --gas-price - Gas price value in Gwei for transaction (if not specified doubled average network value will be used)
• --yes - Confirmation flag

Unlink node address from the validator account

sk-val validator unlink-address [ADDRESS] --pk-file ./pk.txt

Required params:

1. Address - Ethereum address that will be unlinked

Optional arguments:

• --pk-file - Path to file with private key (only for software wallet type)
• --gas-price - Gas price value in Gwei for transaction (if not specified doubled average network value will be used)
• --yes - Confirmation flag

Info about the validator

sk-val validator info [VALIDATOR_ID]

Required params:

1. Address - Ethereum address of the validator

Output info:

1. Validator ID
2. Name
3. Address
4. Fee rate (percent - %)
5. Minimum delegation amount (SKL)
6. Accepting new delegation requests

Withdraw earned fee to specified address

sk-val validator withdraw-fee [RECIPIENT_ADDRESS] --pk-file ./pk.txt

Required params:

1. RECIPIENT_ADDRESS - Address to transfer bounty

Optional arguments:

• --pk-file - Path to file with private key (only for software wallet type)
• --gas-price - Gas price value in Gwei for transaction (if not specified doubled average network value will be used)
• --yes - Confirmation flag

Set a new minimum delegation amount for the validator

sk-val validator set-mda [NEW_MDA] --pk-file ./pk.txt

Required params:

1. NEW_MDA - New MDA value

Optional arguments:

• --pk-file - Path to file with private key (only for software wallet type)
• --gas-price - Gas price value in Gwei for transaction (if not specified doubled average network value will be used)
• --yes - Confirmation flag

Request address change for the validator

sk-val validator change-address [ADDRESS] --pk-file ./pk.txt

Required params:

1. ADDRESS - New validator address

Optional arguments:

• --pk-file - Path to file with private key (only for software wallet type)
• --gas-price - Gas price value in Gwei for transaction (if not specified doubled average network value will be used)
• --yes - Confirmation flag

Confirm address change for the validator. Should be executed using new validator key.

sk-val validator confirm-address [VALIDATOR_ID] --pk-file ./pk.txt

Required params:

1. VALIDATOR_ID - ID of the validator

Optional arguments:

• --pk-file - Path to file with private key (only for software wallet type)
• --gas-price - Gas price value in Gwei for transaction (if not specified doubled average network value will be used)
• --yes - Confirmation flag

Get earned fee amount for the validator address

sk-val validator earned-fees [ADDRESS]

Required params:

1. ADDRESS - Validator address

Optional arguments:

• --wei - Show amount in wei

Delegate tokens to validator

sk-val holder delegate

Required arguments:

• --validator-id - ID of the validator to delegate
• --amount - Amount of SKALE tokens to delegate
• --delegation-period - Delegation period (in months - only 2 avaliable now)
• --info - Delegation request info

Optional arguments:

• --pk-file - Path to file with private key (only for software wallet type)
• --gas-price - Gas price value in Gwei for transaction (if not specified doubled average network value will be used)

List of delegations for address

sk-val holder delegations [ADDRESS]

Required arguments:

1. ADDRESS - Ethereum address of the token holder

Options:

• --wei/-w - Show tokens amount in wei

Cancel pending delegation request

sk-val holder cancel-delegation [DELEGATION_ID]

Required params:

1. Delegation ID - ID of the delegation to cancel

Optional arguments:

• --pk-file - Path to file with private key (only for software wallet type)
• --gas-price - Gas price value in Gwei for transaction (if not specified doubled average network value will be used)

Request undelegation in the end of delegation period

sk-val holder undelegate [DELEGATION_ID]

Required params:

1. Delegation ID - ID of the delegation

Optional arguments:

• --pk-file - Path to file with private key (only for software wallet type)
• --gas-price - Gas price value in Gwei for transaction (if not specified doubled average network value will be used)

Withdraw earned bounty to specified address

sk-val holder withdraw-bounty [VALIDATOR_ID] [RECIPIENT_ADDRESS] --pk-file ./pk.txt

Required params:

1. VALIDATOR_ID - ID of the validator
2. RECIPIENT_ADDRESS - Address to transfer bounty

Optional arguments:

• --pk-file - Path to file with private key (only for software wallet type)
• --gas-price - Gas price value in Gwei for transaction (if not specified doubled average network value will be used)
• --yes - Confirmation flag

Show amount of locked tokens for address

sk-val holder locked [ADDRESS]

Required arguments:

1. ADDRESS - Ethereum address of the token holder

Options:

• --wei/-w - Show tokens amount in wei

Get earned bounties amount by token holder for the validator ID

sk-val holder earned-bounties [VALIDATOR_ID] [ADDRESS]

Required params:

1. VALIDATOR_ID - ID of the validator
2. ADDRESS - Token holder address

Optional arguments:

• --wei - Show amount in wei

This command works only if you're using the Ledger wallet

sk-val wallet setup-ledger

Required params:

• --address-index - Index of the address to use (starting from 0)
• --keys-type - Type of the Ledger keys (live or legacy)

Send ETH tokens to specific address

sk-val wallet send-eth [ADDRESS] [AMOUNT]

Required arguments:

1. ADDRESS - Ethereum receiver address
2. AMOUNT - Amount of ETH tokens to send

Optional arguments:

• --pk-file - Path to file with private key (only for software wallet type)
• --yes - Confirmation flag

Usage example:

sk-val wallet send-eth 0x01C19c5d3Ad1C3014145fC82263Fbae09e23924A 0.01 --pk-file ./pk.txt --yes

Send SKL tokens to specific address

sk-val wallet send-skl [ADDRESS] [AMOUNT]

Required arguments:

1. ADDRESS - Ethereum receiver address
2. AMOUNT - Amount of SKL tokens to send

Optional arguments:

• --pk-file - Path to file with private key (only for software wallet type)
• --yes - Confirmation flag

Usage example:

sk-val wallet send-skl 0x01C19c5d3Ad1C3014145fC82263Fbae09e23924A 0.01 --pk-file ./pk.txt --yes

Show balance of the validator self-recharging wallet

sk-val srw balance [VALIDATOR_ID]

Required arguments:

1. VALIDATOR_ID - ID if the validator

Optional arguments:

• --wei/-w - Show amount in wei

Usage example:

sk-val srw balance 1 --wei

Recharge validator SRW wallet (amount in ETH)

sk-val srw recharge [AMOUNT]

Required arguments:

1. AMOUNT - Amount of ETH to recharge

Optional arguments:

• --pk-file - Path to file with private key (only for software wallet type)
• --gas-price - Gas price value in Gwei for transaction (if not specified doubled average network value will be used)

Usage example:

sk-val srw recharge 0.1 --pk-file ./tests/test-pk.txt

Withdraw ETH from validator SRW wallet (amount in ETH)

sk-val srw withdraw [AMOUNT]

Required arguments:

1. AMOUNT - Amount of ETH to withdraw

Optional arguments:

• --pk-file - Path to file with private key (only for software wallet type)
• --gas-price - Gas price value in Gwei for transaction (if not specified doubled average network value will be used)

Usage example:

sk-val srw withdraw 0.1 --pk-file ./tests/test-pk.txt

Exit codes conventions for SKALE CLI tools

• 0 - Everything is OK
• 1 - General error exit code
• 3 - Bad API response
• 4 - Script execution error
• 5 - Transaction error
• 6 - Revert error

pip install -e .[dev]

In file .git/hooks/pre-commit add:

#!/bin/sh
flake8 .

Run commands in dev mode:

python main.py YOUR_COMMAND

Required environment variables:

• ACCESS_KEY_ID - DO Spaces/AWS S3 API Key ID
• SECRET_ACCESS_KEY - DO Spaces/AWS S3 Secret access key
• GITHUB_EMAIL - Email of GitHub user
• GITHUB_OAUTH_TOKEN - GitHub auth token
• ETH_PRIVATE_KEY - Ethereum private key for tests (without 0x prefix)
• MANAGER_BRANCH - Branch of the skale-manager to pull from DockerHub ($MANAGER_BRANCH-latest tag will be used)

All contributions are made under the GNU Affero General Public License v3. See LICENSE.