Using the Kwil admin tool
kwil-admin
provides several functions for node setup and administration that
are accessible through sub-commands.
To show kwil-admin
usage and all of the available top level commands, provide
the -h
or --help
flag:
$ kwil-admin -h
The Kwil node admin tool.
Usage:
kwil-admin [command]
Available Commands:
completion Generate the autocompletion script for the specified shell
help Help about any command
key The `key` command provides subcommands for private key generation and inspection.
migrate The `migrate` command provides functions for managing migration proposals.
node The `node` command is used to get information about a running Kwil node.
peers manages the node's peers
setup The `setup` command provides functions for creating and managing node configuration and data.
snapshot The `snapshot` command is used to create and manage snapshots.
utils The `utils` command is used to get information about a running Kwil node.
validators The `validators` command provides functions for creating and broadcasting validator-related transactions.
version Displays the cli version information.
Flags:
-h, --help help for kwil-admin
--output string the format for command output - either 'text' or 'json' (default "text")
-S, --silence Silence logs
Use "kwil-admin [command] --help" for more information about a command.
With the exception of help
and version
, each of the commands must be used
with a sub-command. For example, to list the key
sub-commands:
$ kwil-admin key
The `key` command provides subcommands for private key generation and inspection. These are the private keys that identify the node on the network and provide validator transaction signing capability.
Usage:
kwil-admin key [command]
Available Commands:
gen Generate ed25519 keys for usage in validators.
info Display information about a private key.
Flags:
-h, --help help for key
Global Flags:
--output string the format for command output - either 'text' or 'json' (default "text")
-S, --silence Silence logs
Use "kwil-admin key [command] --help" for more information about a command.
To see usage of the key info
sub command:
$ kwil-admin key info -h
Display information about a private key.
The private key can either be passed as a key file path, or as a hex-encoded string.
Usage:
kwil-admin key info [flags]
Examples:
# Using a key file
kwil-admin key info --key-file ~/.kwild/private_key
# Using a hex-encoded string
kwil-admin key info 381d28cf348c9efbf7d26ea54b647e2cb646d3b98cdeec0f1053a5ff599a036a0aa381bd4aad1670a39977d5416bfac7bd060765adc58a4bb16bbbafeefbae34
Flags:
-h, --help help for info
-o, --key-file string file containing the private key to display
Global Flags:
--output string the format for command output - either 'text' or 'json' (default "text")
-S, --silence Silence logs
The following sections will describe each of the commands provided by
kwil-admin
, but always reference the syntax and full set of options shown by
appending the -h
(or --help
) flag to the full command in question.