CLI commands

Help

ironfish help displays all the commands and topics you can use with the Iron Fish CLI. To get additional info about a specific command or a specific topic, type ironfish [topic/command] help.

E.g. for a topic:

ironfish accounts help

E.g. for a command:

ironfish ironfish accounts:pay help

Node

start

Starts the full node

ironfish start

To start a full node with a different port and a different data directory

ironfish start --port=9034 --datadir=~/.ironfish2/

stop

Stops the full node

ironfish stop

status

Prints out:

  • the status of your node (started / stopped)
  • the syncing status of your node and syncing stats
  • the networking status of your node (and networking stats)
ironfish status

To see live updates:

ironfish status -f

reset

Deletes your chain and wallet state, but preserves your accounts. It will import your accounts afterwards into a fresh node state.

ironfish reset

Config

config:show

Prints out the content of your config file

ironfish config:show

config:edit

Opens the config file with your default code editor

ironfish config:edit

Note: you need to set the editor config or the default editor environment variable for this command to work. E.g. for Vscode at the config level: ironfish config:set editor "/Applications/Visual Studio Code.app/Contents/MacOS/Electron" E.g. for Vscode at the environment level: export EDITOR="/Applications/Visual Studio Code.app/Contents/MacOS/Electron"

config:set

Sets the config value for the key.

E.g.

config:set enableMiningDirector "true"

Note: the list of configuration options is available here

config:get

Displays the configuration value for your node

E.g.

config:get enableMiningDirector

Miners

miners:start

Starts a miner and subscribe to new blocks for the node. The node has to be synced with the network for the miner to start mining.

ironfish miners:start

Networking

peers:list

Displays the list of peers connected to the node.

ironfish peers:list

Displays the list of peers with live update.

ironfish peers:list -f

Account / Wallet

accounts:create

Creating a new account with interactive mode

ironfish accounts:create

Creating a new account in command line

ironfish accounts:create MyNewAccount

accounts:publickey

Gets the current account's public key

ironfish accounts:publickey

Gets a specific account's public key

ironfish accounts:publickey -a MyNewAccount

accounts:balance

Gets the current account's balance

ironfish accounts:balance

Gets a specific account's public key

ironfish accounts:balance -a MyNewAccount

accounts:pay

Creating a new transaction with interactive mode

ironfish accounts:pay

Creating a new transaction in command line

ironfish accounts:pay -a 2 -t 997c5...c52ed

Faucet

faucet:giveme

Connects to the Iron Fish faucet to get test funds

ironfish faucet:giveme

Chain

chain:show

Shows the heaviest head and tail of the node's chain. Includes the last ten blocks in the chain.

ironfish chain:show