Welcome to ARK Core v3
Technology Stack
Directory Structure
Data Models
Cryptography
Architecture
Application Lifecycle
Service Container
Service Provider
Managers and Drivers
Contracts
Services
Attributes
Cache
Events
Filesystem
Logging
Mixins
Pipeline
Queue
Schedule
Triggers
Validation
Understanding the Lifecycle
Understanding the Nonce
Transaction Types
Overview
Transfer
2nd Signature Registration
Delegate Registration
Vote / Unvote
Multisignature Registration
Ipfs
Multipayment
Delegate Resignation
HTLC
Entity
Introduction
Requirements
Configuring Core
Environment Variables
Using the Install Script
Installing from Source
Docker on Linux/macOS
Docker on Windows
Security Through Obscurity
Using SSH
Staying Up-to-Date
Applying iptables
Installing Fail2Ban
Setting Up Port Knocking
Cloudflare DDoS Protection
Core Run Modes
Core CLI Commands
Starting a Relay
Starting a Forger
Using Snapshots
Creating Factories
Launching a Testnet
Launching a Block Explorer
Using the Core-Tester-CLI
Creating Event Emitters
Creating API Servers
Implementing Milestones
Using Docker
Core CLI
Available Commands
Creating Commands
dApps
Authoring Core dApps
Modeling the Structure
Creating a Module
Plugins
Authoring Plugins
Managing Plugins
Custom Transactions
Authoring Transaction Types
Defining the Structure
Implementing the Builder
Implementing the Handler
Loading the dApp
Running the Example
Introduction
Using the Sandbox
Testing Plugins
Testing Transactions
2.0
2.0 Release Guide
2.0 Upgrade Guide
2.1
2.1 Release Guide
2.1 Upgrade Guide
2.2
2.2 Release Guide
2.2 Upgrade Guide
2.3
2.3 Release Guide
2.3 Upgrade Guide
2.4
2.4 Release Guide
2.4 Upgrade Guide
2.5
2.5 Release Guide
2.5 Upgrade Guide
2.6
2.6 Release Guide
2.6 Upgrade Guide
3.0
3.0 Release Guide
3.0 Upgrade Guide
3.0 Upgrade Guide (Docker)
3.8.2
3.8.2 Release Guide
3.8.2 Upgrade Guide
4.0 (Development)
4.0 Upgrade Guide - Devnet
Troubleshooting
Security Vulnerabilities
Contact Us

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}
Previous
Next
Last updated 2 years ago
Edit Page
Share: