CLI Setup

Alternative installations

Install via Homebrew Install via Docker Install via Source Install via Standalone Executable

CLI Basics

Set up an account Send a transaction Manage account keys

CLI Advanced

Health of your node Local mining Run your own local network Configure your node Offline transaction signing Bootstrap nodes

Multisig

Trusted Dealer Key Generation Distributed Key Generation (DKG)Sign a transaction with a multisig account

CLI Commands

help start stop status browse faucet reset

wallet

wallet:account wallet:accounts wallet:address wallet:assets wallet:balance wallet:balances wallet:burn wallet:create wallet:decrypt wallet:delete wallet:encrypt wallet:export wallet:import wallet:lock wallet:mint wallet:notes:combine wallet:notes wallet:post wallet:prune wallet:repair wallet:rescan wallet:reset wallet:send wallet:sign wallet:status wallet:transactions wallet:transaction wallet:transaction:add wallet:transaction:watch wallet:transaction:view wallet:unlock wallet:use wallet:which

chainport

wallet:chainport:send

multisig

wallet:multisig:participant:create wallet:multisig:participant wallet:multisig:dealer:create wallet:multisig:commitment:create wallet:multisig:commitment:aggregate wallet:multisig:sign wallet:multisig:signature:create wallet:multisig:signature:aggregate wallet:multisig:account:participants wallet:multisig:participants

dkg

wallet:multisig:dkg:create wallet:multisig:dkg:round1 wallet:multisig:dkg:round2 wallet:multisig:dkg:round3

config

config config:edit config:get config:set

peers

peers peers:show

chain

chain:show chain:repair chain:asset chain:export chain:forks chain:download

blocks

blocks:show

workers

workers:status

miners

miners:start miners:pools:start

Recipes

Creating Transactions Validating Deposits Combining Notes Maximizing Transaction Size Splitting Notes

Multisig

Creating Multisig Accounts Creating Multisig Accounts With DKG Signing Transactions with Multisig Accounts

RPC

Usage Protocol

Routes

Response Objects

RpcAccountAssetBalanceDelta RpcAccountStatus RpcAsset RpcBlock RpcBlockHeader RpcBurn RpcEncryptedNote RpcMint RpcPeerResponse RpcSpend RpcTransaction RpcWalletNote RpcWalletTransaction

Chain

broadcastTransaction estimateFeeRate estimateFeeRates exportChainStream followChainStream getAsset getBlock getChainInfo getConsensusParameters getDifficulty getNetworkHashPower getNetworkInfo getNoteWitness getTransaction getTransactionStream showChain

Config

getConfig setConfig unsetConfig uploadConfig

Event

onGossip onReorganizeChain onTransactionGossip

Faucet

getFunds

Mempool

acceptTransaction getStatus getTransactions

Miner

blockTemplateStream submitBlock

Node

getLogStream getStatus stopNode

Peer

addPeer getBannedPeers getPeer getPeers getPeerMessages

RPC

getStatus

Wallet

Multisig

getParticipant getParticipants createParticipant createTrustedDealerKeyPackage createSiginingCommitment createSigningPackage createSignatureShare aggregateSignatureShares

DKG

round1 round2 round3

addTransaction buildTransaction burnAsset create [DEPRECATED]createAccount createTransaction decrypt encrypt estimateFeeRates exportAccount getAccounts getAccountNotesStream getAccountsStatus getAccountStatus getAccountTransaction getAccountTransactions getAsset getAssets getBalance getBalances getDefaultAccount getNodeStatus getUnsignedTransactionNotes getNotes getPublicKey importAccount lock mintAsset postTransaction remove [DEPRECATED]removeAccount rename [DEPRECATED]renameAccount rescan resetAccount sendTransaction setAccountHead setScanning signTransaction unlock useAccount

Worker

getStatus

Contribute To Iron Fish

Lint and Format Release Versioning Hardfork Update Process

chain/exportChainStream

Exports the chain as a stream of blocks.

If the start and stop sequences are provided, only the blocks between the start and stop will be returned.

Request

{
  start?: number | null
  stop?: number | null
} | undefined

Response

{
  start: number
  stop: number
  block?: RpcBlockHeader & {
    main: boolean
    head: boolean
    latest: boolean
    /**
     * @deprecated Please use sequence instead
     */
    seq: number
    /**
     * @deprecated Please use previousBlockHash instead
     */
    prev: string
  }
}

RPC Objects:

RpcBlockHeader

chain/exportChainStream

Request

Response

View on Github