All Available CLI Commands

Available Commands

help

You might be used to tab completion, which the ARK CLI does support. Using this command ARK CLI but does show you instructions.

Usage

1ark help

config:cli

Configure the CLI

Usage

1ark config:cli

Flags

Name Description Required
--token the name of the token that should be used
--channel the npm registry channel that should be used

Examples

Use the “mine” token for configuration

1ark config:cli --token="mine"

Switch to the Next Channel

1ark config:cli --channel="next"

config:database

Configure the database

Usage

1ark config:database

Omitting all flags will start the configuration in an interactive mode.

Flags

Name Description Required
--host the host of the database
--port the port of the database
--database the name of the database that should be used
--username the name of the database user
--password the password for the database that should be used
--network the name of the network that should be used
--token the name of the token that should be used

Examples

1ark config:database --host=localhost --port=5432 --database=ark_mainnet --username=ark --password=password

config:forger

Configure the forging delegate

Usage

1ark config:forger

Omitting all flags will start the configuration in an interactive mode.

Flags

Name Description Required
--bip39 the plain text bip39 passphrase
--password the password for the encrypted bip38
--method the configuration method to use (bip38 or bip39)
--skipValidation skip bip39 mnemonic validation
--network the name of the network that should be used
--token the name of the token that should be used

Examples

Configure a Delegate Using an Encrypted BIP38

1ark config:forger --method=bip38 --bip39="..." --password="..."

Configure a Delegate Using a BIP39 Passphrase

1ark config:forger --method=bip39 --bip39="..."

config:forger:bip38

Configure a delegate using an encrypted BIP38

Usage

1ark config:forger:bip38

Flags

Name Description Required
--bip39 the plain text bip39 passphrase
--password the password for the encrypted bip38
--skipValidation skip bip39 mnemonic validation
--network the name of the network that should be used
--token the name of the token that should be used

Examples

1ark config:forger:bip38 --bip38="..." --password="..."

config:forger:bip39

Configure a delegate using a BIP39 passphrase

Usage

1ark config:forger:bip39

Flags

Name Description Required
--bip39 the plain text bip39 passphrase
--skipValidation skip bip39 mnemonic validation
--network the name of the network that should be used
--token the name of the token that should be used

Examples

1ark config:forger:bip39 --bip39="..."

config:publish

Publish the configuration

Usage

1ark config:publish

Flags

Name Description Required
--bip39 the plain text bip39 passphrase
--skipValidation skip bip39 mnemonic validation
--network the name of the network that should be used
--token the name of the token that should be used

Examples

Publish the Configuration

1ark config:publish

Flags

Name Description Required
--reset overwrite existing configuration
--network the name of the network that should be used
--token the name of the token that should be used

Examples

Reset the Configuration for the Mainnet Network

1ark config:publish --network=mainnet --reset

core:log

Show the core log

Usage

1ark core:log

Flags

Name Description Required
--error only show error output
--lines number of lines to output
--network the name of the network that should be used
--token the name of the token that should be used

Examples

1ark core:log

core:restart

Restart the core

Usage

1ark core:restart

Flags

Name Description Required
--network the name of the network that should be used
--token the name of the token that should be used

Examples

Restart the Core

1ark core:restart

core:start

Start the core

Usage

1ark core:start

Flags

Name Description Required
--bip39 the plain text bip39 passphrase
--bip38 the encrypted bip38
--password the password for the encrypted bip38
--[no-]daemon start the process as a pm2 daemon
--disableDiscovery permanently disable any peer discovery
--ignoreMinimumNetworkReach ignore the minimum network reach on start
--launchMode the mode the relay will be launched in (seed only at the moment)
--networkStart indicate that this is the first start of seeds
--skipDiscovery skip the initial peer discovery
--network the name of the network that should be used
--token the name of the token that should be used

Examples

Run Core With a Daemon

1ark core:start

Run Core as Genesis

1ark core:start --networkStart

Disable Any Discovery by Other Peers

1ark core:start --disableDiscovery

Skip the Initial Discovery

1ark core:start --skipDiscovery

Ignore the Minimum Network Reach

1ark core:start --ignoreMinimumNetworkReach

Start a Seed

1ark core:start --launchMode=seed

Run Core Without a Daemon

1ark core:start --no-daemon

or use the following command, which supports the same set of flags.:

1ark core:run

core:status

Display core status

Usage

1ark core:status

Flags

Name Description Required
--token the name of the token that should be used

core:stop

Stop the core

Usage

1ark core:stop

Flags

Name Description Required
--daemon stop the process or pm2 daemon
--network the name of the network that should be used
--token the name of the token that should be used

Examples

Stop the Core

1ark core:stop

Stop the Core Daemon

1ark core:stop --daemon

env:get

Get the value of an environment variable

Usage

1ark env:get --key=KEY

Flags

Name Description Required
--network the name of the network that should be used
--token the name of the token that should be used
--key the key of which the value should be retrieved :white_checkmark:

Examples

Get the Log Level

1ark env:get --key=CORE_LOG_LEVEL

env:list

List all environment variables

Usage

1ark env:list

Flags

Name Description Required
--network the name of the network that should be used
--token the name of the token that should be used

Examples

List All Environment Variables

1ark env:list

env:paths

Get all of the environment paths

Usage

1ark env:paths

Flags

Name Description Required
--network the name of the network that should be used
--token the name of the token that should be used

Examples

List All Environment Paths

1ark env:paths

env:set

Set the value of an environment variable

Usage

1ark env:set --key=KEY --value=VALUE

Flags

Name Description Required
--network the name of the network that should be used
--token the name of the token that should be used
--key the key of the value that should be updated :white_checkmark:
--value the new value of the key that should be updated :white_checkmark:

Examples

Set the Log Level

1ark env:set --key=CORE_LOG_LEVEL --value=info

forger:log

Show the forger log

Usage

1ark forger:log

Flags

Name Description Required
--error only show error output
--lines number of lines to output
--network the name of the network that should be used
--token the name of the token that should be used

Examples

1ark forger:log

forger:restart

Restart the forger

Usage

1ark forger:restart

Flags

Name Description Required
--network the name of the network that should be used
--token the name of the token that should be used

Examples

Restart the Forger

1ark forger:restart

forger:start

Start the forger

Usage

1ark forger:start

or the equivalent, without invoking pm2:

1ark forger:run

Flags

Name Description Required
--bip39 the plain text bip39 passphrase
--bip38 the encrypted bip38
--password the password for the encrypted bip38
--[no-]daemon start the process as a pm2 daemon
--network the name of the network that should be used
--token the name of the token that should be used

Examples

Run a Forger With a bip39 Passphrase

1ark forger:start --bip39="..."

Run a Forger With an Encrypted bip38

1ark forger:start --bip38="..." --password="..."

Run a Forger Without a Daemon

1ark forger:start --no-daemon

forger:status

Display forger status

Usage

1ark forger:status

Flags

Name Description Required
--token the name of the token that should be used

forger:stop

Stop the forger

Usage

1ark forger:stop

Flags

Name Description Required
--daemon stop the process or pm2 daemon
--network the name of the network that should be used
--token the name of the token that should be used

Examples

Stop the Forger

1ark forger:stop

Stop the Forger Daemon

1ark forger:stop --daemon

forger:status

Show the forger status.

Usage

1ark forger:status

Flags

Name Description Required
--network the name of the network that should be used
--token the name of the token that should be used

Example

1ark forger:status

relay:log

Show the relay log

Usage

1ark relay:log

Flags

Name Description Required
--error only show error output
--lines number of lines to output
--network the name of the network that should be used
--token the name of the token that should be used

Examples

1ark relay:log

relay:restart

Restart the relay

Usage

1ark relay:restart

Flags

Name Description Required
--network the name of the network that should be used
--token the name of the token that should be used

Examples

Restart the Relay

1ark relay:restart

relay:start

Start the relay

Usage

1ark relay:start

or the equivalent without using pm2:

1ark relay:run

Flags

Name Description Required
--[no-]daemon start the process as a pm2 daemon
--disableDiscovery permanently disable any peer discovery
--ignoreMinimumNetworkReach ignore the minimum network reach on start
--launchMode=launchMode the mode the relay will be launched in (seed only at the moment)
--networkStart indicate that this is the first start of seeds
--skipDiscovery skip the initial peer discovery
--network the name of the network that should be used
--token the name of the token that should be used

Examples

Run a Relay With a pm2 Daemon

1ark relay:start --network=mainnet

Run a Genesis Relay

1ark relay:start --networkStart

Disable Any Discovery by Other Peers

1ark relay:start --disableDiscovery

Skip the Initial Discovery

1ark relay:start --skipDiscovery

Ignore the Minimum Network Reach

1ark relay:start --ignoreMinimumNetworkReach

Start a Seed

1ark relay:start --launchMode=seed

Run a Relay Without a Daemon

1ark relay:start --no-daemon

relay:status

Display relay status

Usage

1ark relay:status

Flags

Name Description Required
--token the name of the token that should be used

relay:stop

Stop the relay

Usage

1ark relay:stop

Flags

Name Description Required
--daemon stop the process or pm2 daemon
--network the name of the network that should be used
--token the name of the token that should be used

Examples

Stop the Relay

1ark relay:stop

Stop the Relay Daemon

1ark relay:stop --daemon

top

List all core daemons

Usage

1ark top

Examples

List All Core Daemons

1ark top

snapshot:dump

Create a dump of the database

Usage

1ark snapshot:dump

Flags

Name Description Required
--start [default: -1] start network height to export
--end [default: -1] end network height to export
--skipCompression skip gzip compression
--codec codec name
--network the name of the network that should be used
--token the name of the token that should be used

snapshot:restore

Restore the database from a dump

Usage

1ark snapshot:restore

Flags

Name Description Required
--verify signature verification
--truncate truncate database before rollback
--blocks blocks to append to, correlates to folder name
--network the name of the network that should be used
--token the name of the token that should be used

snapshot:rollback

Roll back the database to a specific height or by a specified number of blocks

Usage

1ark snapshot:rollback

Flags

Warning

Either height or number has to be provided.

Name Description Required
--height block network height number to roll back to
--number number of blocks to roll back
--network the name of the network that should be used
--token the name of the token that should be used

snapshot:truncate

Truncate the database

Usage

1ark snapshot:truncate
Name Description Required
--network the name of the network that should be used
--token the name of the token that should be used

snapshot:verify

Verify snapshot

Usage

1ark snapshot:verify

Flags

Name Description Required
--blocks snapshot folder name
--network the name of the network that should be used
--token the name of the token that should be used

plugin:install

Install a plugin from an npm package name, git repository url or local file.

Usage

1ark plugin:install {npm|git|file}
NPM
1ark plugin:install @vendor/pkg
Git
1ark plugin:install [email protected]:vendor/pkg.git
Usage
1ark plugin:install /path/to/some/vendor/pkg.tar.gz

plugin:update

Update a plugin based on its name. If the name contains a scope like @arkecosystem than this scope needs to be included.

Usage

1ark plugin:update {package}

plugin:remove

Remove a plugin based on its name. If the name contains a scope like @arkecosystem than this scope needs to be included.

Usage

1ark plugin:remove {package}
Last updated 3 years ago
Edit Page
Share: