Get StartedInstallation
Run a nodeHealth of your nodeSet up an accountTransactionsMining

Health of your node


Run the status command to display the status of your node.

> ironfish status

Version 1.8.0 @ src Node STARTED Node Name Peer ID f5uI8nrLATmehVD/Efg3ADimWv6fSO0EubeTdnaG2kM= Block Graffiti Network Mainnet Memory Heap: 69.48 MiB -> 116.65 MiB / 3.99 GiB (1.7%), RSS: 516.59 MiB (3.2%), Free: 421.37 MiB (97.4%) CPU Cores: 10, Current: 296.8% P2P Network CONNECTED - In: 406.37 KB/s, Out: 3.91 KB/s, peers 31 Mining STARTED - 0 miners, 0 mined Mem Pool Count: 0 tx, Bytes: 0 B / 57.22 MiB (0.00%), Evictions: 0 Syncer SYNCING - 35.79 blocks synced/sec, 69.69 blocks downloaded/sec, 89.53 blocks added/sec, progress: 94.41% Blockchain 000000000000005913624fa8a48383ad1893f5a46744c1878cc9c877099574c3 (164432), Since HEAD: 161h 25m (NOT SYNCED) Accounts SCANNING - 12381 / 159633 Telemetry STARTED - 0 <- 1 pending Workers STARTED - 0 -> 1 / 6 - 0 jobs Δ, 498.85 jobs/s


The node can have the following status:

STARTEDNode is running
STOPPEDNode is not running. Start it with ironfish start
ERRORAn error occured while running the node. Run ironfish logs -v to see the latest error messages

Node Name 

This is the publically visible node name that your peers will see when you connect to them.

By default, no node name is set. You can set a node name by using

ironfish config:set nodeName "My Node"

Peer ID 

This is your P2P network ID. It's consistent between network runs, and is used to identify you among your peers. It's primary function is to also help route messages to you through the network.

If you want to generate a new Peer ID you can pass --generateNewIdentity to start

ironfish start --generateNewIdentity

Block Graffiti 

This is your personal message that you attach to every block that you mine.

ironfish config:set blockGraffiti "Hello World"


This is the network you are connected to.


This represents the memory usage of your node.

  • Heap: Node memory used by Javascript
  • RSS: Resident Set
  • Free: How much free memory there is left on your computer


Information about the CPU the node is running on including cores and current CPU usage.


Information about mining on your node. If you have no miners connected to your node, it will show 0 miners.

Mem Pool 

This this information about your pending transactioins and it's total size. Evictions are how many invalid transactions have been evicted and will not be mined.


The block syncer is the system decides to download chains from peers on the network.

The syncer can have the following status:

IDLEThe syncer is paused - your chain is synced with the network
REQUESTINGThe syncer is requesting blocks from the network
SYNCINGThe syncer is currently adding blocks to your local chain
STOPPEDThe syncer is stopped - either because you are not connected to the network, or your node is not running


Workers show information about the worker pool which are light processes that can execut asynchronous jobs for the node.


Blockchain head indicates the head of your chain on your local node. It changes every 60 seconds.

Chain information 

Run the following command to display your chain status. Heaviest head is the latest block synced to the genesis block in your chain. Latest head is the latest block received from a peer in the Iron Fish network.

> ironfish chain:show

Getting the chain blocks... ====== TAIL f6801b559c46aaee1bc94398c353f6b2bdabe50a44664a703b165cb0be6a7d26 HEAVIEST 0000278c762f231f326b981b517b0b34320ba8011945220e4da1e43101a99a57 LATEST 0000278c762f231f326b981b517b0b34320ba8011945220e4da1e43101a99a57 TREES OKAY? TRUE +- Block f6801...a7d26 (1 seq, work: 131072) TAIL GENESIS +- Block 00003...a62ca (2 seq, work: 262144) +- Block 00005...863b9 (3 seq, work: 393280) +- Block 00004...efa6e (4 seq, work: 524480) +- Block 00004...3554b (5 seq, work: 655744) +- Block 00006...3d053 (6 seq, work: 787072) +- Block 00002...9ec82 (7 seq, work: 918464) +- Block 00004...cfd82 (8 seq, work: 1049920) +- Block 00005...96c9c (9 seq, work: 1181440) +- Block 00000...fa3a7 (10 seq, work: 1313024) +- Block 00005...c3b97 (11 seq, work: 1444672) +- Block 00007...b49a9 (12 seq, work: 1576384) +- Block 00007...53332 (13 seq, work: 1708160) +- Block 00005...7535a (13 seq, work: 1708160) +- Block 00003...6d423 (14 seq, work: 1840000) | +- Block 00003...21e8e (15 seq, work: 1971904) +- Block 00003...af531 (14 seq, work: 1840000) +- Block 00002...f8b86 (15 seq, work: 1971904) +- Block 00006...7457e (16 seq, work: 2103872) | +- Block 00000...cf403 (17 seq, work: 2235904) | +- Block 00007...9321c (18 seq, work: 2368000) | +- Block 00002...42725 (19 seq, work: 2500160) | +- Block 00006...4b38a (20 seq, work: 2632384) | +- Block 00007...92895 (21 seq, work: 2764672) | +- Block 00006...4f07d (22 seq, work: 2897024) | +- Block 00001...f2fa4 (23 seq, work: 3029440) | | +- Block 00001...3177a (24 seq, work: 3161920) | | +- Block 00002...99a57 (25 seq, work: 3294464) LATEST HEAVY | +- Block 00005...f594e (23 seq, work: 3029440) +- Block 00007...b3f27 (16 seq, work: 2103872)

P2P Network 

P2P Network can have the following status:

CONNECTEDYour node is connected to the network. Stats about your network traffic is displayed on the right side
WAITINGYour node is attempting to connect to the Iron Fish network

Peers information 

To see how is your node connected to the network you can run the following command

> ironfish peers


A peer can have the following status:

CONNECTINGYour node is attempting to connect to a new peer
CONNECTEDYour node is connected to the peer
CONNECTED(!)Your node is connected to the peer. But an error occurred previously
DISCONNECTED(!)Your node is disconnected from the peer

Next steps 

Setup an account

Join our newsletter and stay up to date with privacy and crypto.

Discover our impactful presence — read our blog.


  • FAQ
  • Whitepaper
  • Tokenomics


  • Get Started
  • Node App
  • Mine
  • Block Explorer
  • Ecosystem


  • Documentation
  • Github


  • Foundation
  • Governance
  • Grants
  • Our Community


  • About Us
  • Media Kit
  • Contact Us
Privacy Policy


Copyright 2024 Iron Fish.