Skip to content

Nibiru Command-Line Interface (CLI)

An introduction to the using the Nibiru Command-Line Interface (CLI) along with a brief description of its commands and flags. After installation, you can use the nibid command to send transactions and query the Nibiru blockchain.

Nibiru CLI Guides

  1. Nibiru CLI - How to Install the Nibiru CLI
  2. Nibiru CLI - Creating Fungible Tokens

Working Directory

The default working directory for the nibid is $HOME/.nibid, which is mainly used to store configuration files and blockchain data. The Nibiru key data is saved in the working directory of nibid. You can also specify the nibid working directory by using the --home flag when executing nibid.

Connecting to a Full-Node

By default, nibid uses tcp://localhost:26657 as the RPC address to connect to the Nibiru network. This default configuration assumes that the machine executing nibid is running as a full-node.

The RPC address can be specified to connect to any full-node with an exposed RPC port by adding the --node flag when executing nibid

Global Flags

GET Commands

All GET commands have the following global flags:

Name, shorthandtypeDefault ValueDescription
--chain-idstringThe network Chain ID
--homestring$HOME/.nibidDirectory for config and data
--tracestringPrint out full stack trace on errors
--log_formatstringplainLogging format (json | plain)

POST Commands

All POST commands have the following global flags:

Name, shorthandtypeDefaultDescription
--account-numberint0AccountNumber to sign the tx
--broadcast-modestringsyncTransaction broadcasting mode (sync | async | block)
--dry-runboolfalseIgnore the --gas flag and perform a simulation of a transaction, but don't broadcast it
--feesstringFees to pay along with transaction
--fromstringName of private key with which to sign
--gasstring200000Gas limit to set per-transaction; set to "simulate" to calculate required gas automatically
--gas-adjustmentfloat1Adjustment factor to be multiplied against the estimate returned by the tx simulation; if the gas limit is set
--gas-pricesstringGas prices in decimal format to determine the transaction fee
--generate-onlyboolfalseBuild an unsigned transaction and write it to STDOUT
--help, -hstringPrint help message
--keyring-backendstringosSelect keyring's backend
--ledgerboolfalseUse a connected Ledger device
--memostringMemo to send along with transaction
--nodestringtcp://localhost:26657specifies <host>:<port> for the Tendermint RPC interface endpoint for this chain
--offlinestringOffline mode (does not allow any online functionality)
--sequenceint0Sequence number to sign the tx
--sign-modestringChoose sign mode (direct | amino-json), this is an advanced feature
--trust-nodebooltrueDon't verify proofs for responses
--yesbooltrueSkip tx broadcasting prompt confirmation
--chain-idstringThe network Chain ID
--homestring$HOME/.nibidDirectory for config and data
--tracestringPrint out full stack trace on errors

Module Commands

SubcommandDescription
devgasDevgas subcommands for smart contract usage.
bankBank subcommands for managing assets.
keysKeys subcommands for managing local tendermint keystore.