Skip to main content

​
Installation

Ensure that the following packages are installed:
  • docker
  • docker-compose (1.27.4+)

​
Top Level Commands

​
Info

Prints build info.

​
Version

Prints version number.
Optional Arguments
  • --short prints the version only without additional text.

​
Node Commands

​
Node Information

Retrieves the base info about SKALE node.
Optional Arguments
  • -f/--format accepts either json or text as valid input which formats the output accordingly

​
Node Initialization

Initialize a SKALE node on current machine.
Please avoid re-initialization: First run skale node info to confirm current state of initialization.
Required Parameters
  1. ENV_FILEPATH is a path to the .env file (required parameters are listed in the skale init command)

​
Node Initialization from Backup

Restores a SKALE node on another machine.
Required Parameters
  1. BACKUP_PATH is the path to the archive with backup data generated by skale node backup command
  2. ENV_FILEPATH is the path to .env file (required parameters are listed in the skale init command)

​
Node Backup

Generates a backup file to restore SKALE node on another machine.
Required Parameters
  1. BACKUP_FOLDER_PATH is the path to the folder where the backup tarball will be saved

​
Node Signature

Generates a node signature that is used to link node to a specific validator.
Required Parameters
  1. VALIDATOR_ID - id of the validator

​
Node Registration

Required Arguments
  • --ip is the public IP for RPC connections and consensus
  • --domain/-d is the SKALE node domain name
  • --name is the SKALE node name
Optional Arguments
  • --port is a public port, the beginning of the port range for node SKALE Chains (default: 10000)

​
Node Update

Updates a SKALE node on the current machine.
Required Arguments
  • ENV_FILEPATH is the path to env file where parameters are defined
Optional Arguments
  • --yes executes without additional confirmation
You can also specify a file with environment variables which will update parameters in env file used during skale node init.

​
Node Turn-off

Turns off the SKALE node on current machine and optionally sets it to maintenance mode.
Optional Arguments
  • --maintenance-on sets the SKALE node into maintenance mode before turning off
  • --yes executes without additional confirmation

​
Node Turn-on

Turns on SKALE node on current machine and optionally disables maintenance mode.
Optional Arguments Required Parameters
  1. ENV_FILEPATH is the path to env file where parameters are defined
Optional Arguments
  • --maintenance-off turns off maintenance mode after turning on the node
  • --yes executes without additional confirmation
You can also specify a file with environment variables which will update parameters in env file used during skale node init.

​
Enable Maintenance Mode

Enables maintenance mode on the node.
Optional Arguments
  • --yes executes without additional confirmation

​
Disable Maintenance Mode

​
Domain name

Set SKALE node domain name
Optional Arguments
  • --domain/-d the SKALE node domain name
  • --yes executes without additional confirmation

​
Wallet commands

Commands related to Ethereum wallet associated with SKALE node

​
Wallet information

Optional Arguments
  • -f/--format formats the output. Valid inputs are json and text

​
Send ETH tokens

Sends ETH tokens from the SKALE node wallet to a specific address.
Required Parameters
  1. ADDRESS is the Ethereum receiver address
  2. AMOUNT is the Amount of ETH tokens to send
Optional Arguments
  • --yes executes without additional confirmation

​
SKALE Chain commands

​
List SKALE Chains on Node

Lists the SKALE Chains served by the connected node.

​
Get SKALE Chain Config

​
Get SKALE Chain DKG Status

Lists the DKG status for each SKALE Chain on the node.

​
Get SKALE Chain Info

Shows information about a specified SKALE Chain on the node.
Required Parameters
  1. SCHAIN_NAME is a valid SKALE Chain on the node
Optional Arguments
  • --json shows info in JSON format

​
Repair SKALE Chain

Turn on repair mode for SKALE Chain
Required Parameters
  1. SCHAIN_NAME is a valid SKALE Chain on the node
Optional Arguments
  • --yes executes repair without additional confirmation

​
Health commands

​
List Containers

Lists all SKALE containers running on the connected node.
Optional Arguments
  • -a/--all lists all containers (by default - only running)

​
Healthcheck for SKALE Chains

Shows health check results for all SKALE Chains on the node.
Optional Arguments
  • --json shows info in JSON format

​
SGX Commands

Checks status of the SGX server. Returns the SGX server URL and connection status.

​
Example Output

​
SSL Commands

​
SSL Status

Retrieves the status of the SSL certificates on the node.

​
Upload Certificates

Uploads new SSL certificates.
Required Arguments
  • -c/--cert-path is the path to the certificate file
  • -k/--key-path is the path to the key file
Optional Arguments
  • -f/--force overwrites the existing certificates

​
Logs Commands

​
CLI Logs

Fetch Node CLI logs.
Optional Arguments
  • --debug shows debug logs with a more verbose output

​
Dump Logs

Dumps all logs from the connected node.
Required Parameters
  1. PATH is the required path to dump the logs to
Optional Arguments
  • --container, -c - Dump logs only from specified container

​
Resources Allocation Commands

​
Show Allocation File

Show the resources allocation file.

​
Generate/Update

Generate (or updates if already exists) the allocation file.
Required Parameters
  1. ENV_FILEPATH is the path to .env file (required parameters are listed in the skale init command)
Optional Arguments
  • --yes generates without additional confirmation
  • -f/--force rewrites allocation file if it exists

​
Validate commands

​
Validate ABI

Checks whether ABI files contain valid JSON data.
Optional Argument
  • --json shows the validation result in json format

​
Exit codes

Exit codes conventions for SKALE CLI tools.