Cardano Node CLI Reference
The Shelley command line interface (CLI) provides a collection of tools for key generation, transaction construction, certificate creation and other important tasks. It is organized in a hierarchy of subcommands, and each level comes with its own built-in documentation of command syntax and options.
This section provides a reference of the core
cardano-cli shelley
commands and their associated sub commands:cardano-cli shelley The set of
cardano-cli shelley
commands include:address
: Shelley payment address commandsstake-address
: Shelley stake address commandstransaction
: Shelley transaction commandsnode
: Shelley node operation commandsstake-pool
: Shelley stake pool commandsquery
: Shelley node query commands. This queries the local node whose Unix domain socket is obtained from the CARDNAO_NODE_SOCKET-PATH environment variable.block
: Shelley block commandssystem
: Shelley system commandsgenesis
: Shelley genesis block commandstext-view
: commands for dealing with Shelley text view files that are stored on disk such as transactions or addressesgovernance
: Shelley governance commands
cardano-cli shelley address The
address
command contains the following sub commands:key-gen
: creates a single address key pairkey-hash
: prints the hash of an address to stdoutbuild
: builds a Shelley payment address, with optional delegation to a stake addressbuild-multisig
: builds a Shelley payment multi-sig address.info
: prints details about the address
cardano-cli shelley stake-address The
stake-address
command contains the following sub commands:key-gen
: creates a single address key pairbuild
: builds a stake addressregister
: registers a stake addressdelegate
: delegates from a stake address to a stake poolde-register
: de-registers a stake addressregistration-certificate
: creates a registration certificatedelegation-certificate
: creates a stake address delegation certificatederegistration-certificate
: creates a de-registration certificate
cardano-cli shelley transaction The
transaction
command contains the following sub commands:build-raw
: builds a low-level transactionsign
: signs the transactionwitness
: witnesses a transactionsign-witness
: signs and witnesses a transactioncheck
: checks the transactionsubmit
: submits the transaction to the local node whose Unix domain socket is obtained from the CARANO_NODE_SOCKET_PATH environment variable.calculate-min-fee
: calculates the minimum fee for the transactioninfo
: prints information about the transaction
cardano-cli shelley node The
node
command contains the following sub commands:key-gen
: creates a key pair for a node operator’s offline key and a new certificate issue counterkey-gen-KES
: creates a key pair for a node KES operational keykey-gen-VRF
: creates a key pair for a node VRF operational keyissue-op-cert
: issues a node operational certificate
cardano-cli shelley stake-pool The
stake-pool
command contains the following sub commands:register
: registers a stake poolre-register
: re-registers a stake poolretire
: retires a stake poolregistration-certificate
: creates a stake pool registration certificatede-registration-certificate
: creates a stake pool de-registration certificateid
: builds pool id from the offline key
cardano-cli shelley query The
query
command contains the following sub commands:pool-id
: retrieves the node’s pool IDprotocol-parameters
: retrieves the node’s current pool parameterstip
: gets the node’s current tip (slot number, hash, and block number)utxo
: retrieves the node’s current UTxO, filtered by addressversion
: retrieves the node’s version detailsstatus
: retrieves the current status of the nodeledger-state
: dumps the current state of the nodestake-address-info
: get the current delegations and reward accounts filtered by stake address.stake-distribution
: get the node's current aggregated stake distribution
cardano-cli shelley block The
block
command contains the following sub command:info
: retrieves the pool ID that produced a particular block.
cardano-cli shelley system The
system
command contains the following sub commands:start
: starts the systemstop
: stops the system
cardano-cli shelley governance The
governance
command contains the following sub commands:create-mir-certificate
: creates an MIR (move instantaneous rewards) certificatecreate-update-proposal
: creates an update proposalprotocol-update
: performs a protocol updatecold-keys
: retrieves the cold keys
cardano-cli shelley genesis The
genesis
command contains the following sub commands:key-gen-genesis
: creates a Shelley genesis key pairkey-gen-delegate
: creates a Shelley genesis delegate key pairkey-gen-utxo
: creates a Shelley genesis UTxO key pairkey-hash
: prints the identifier, or hash, of a public keyget-ver-key
: derives verification key from a signing keyinitial-addr
: gets the address for an initial UTxO based on the verification keyinitial-txin
: gets the transaction ID for an initial UTxO based on the verification key.create
: creates a Shelley genesis file from a genesis template, as well as genesis keys, delegation keys, and spending keys.
cardano-cli shelley text-view The
text-view
command contains the following sub command:decode-cbor
: prints a text view file, as decoded CBOR.
Last modified 2yr ago