Wallet command line interface

The CLI is a proxy to the wallet server, which is required for most commands. Commands are turned into corresponding API calls, and submitted to an up-and-running server. Some commands do not require an active server and can be run "offline". (e.g. 'mnemonic generate')

Usage: cardano-wallet COMMAND
  Cardano Wallet Command-Line Interface (CLI)

Available OPTIONS:
  -h | --help

Available COMMANDS:
  launch              Launch and monitor a wallet server and its chain producers.
  serve               Serve an HTTP API that listens for commands/actions.
  mnemonic                            
    generate          Generate BIP-39 mnemonic words
  wallet
    list              List all known wallets
    create            Create & restore a wallet from a BIP-39 mnemonic sentence
    get               Fetch a particular wallet
    utxo              Get a wallet's UTxO distribution 
    update
      passphrase      Update a wallet's master passphrase
      name            Update a wallet's name 
    delete            Forget a wallet and its metadata
  transaction
    create            Create a transaction from a known wallet
    fees              Estimate fees for a transaction
    list              List the transactions associated with a wallet
    submit            Submit an externally-signed transaction
  address
    list              List all known addresses of a wallet
  version             Show the program's current version

ℹ️ The CLI commands for wallet, transaction and address only output valid JSON on stdout. So you may redirect the output to a file with > or pipe it into utility softwares like jq!

💝 For bash/zsh auto-completion, put the following script in your /etc/bash_completion.d:

cardano-wallet.sh

_cardano-wallet()
{
   local CMDLINE
   local IFS=$'\n'
   CMDLINE=(--bash-completion-index $COMP_CWORD)

   for arg in ${COMP_WORDS[@]}; do
       CMDLINE=(${CMDLINE[@]} --bash-completion-word $arg)
   done

   COMPREPLY=( $(cardano-wallet "${CMDLINE[@]}") )
}

complete -o filenames -F _cardano-wallet cardano-wallet

Commands

launch

Launches and manages two sub-processes:

A wallet server (using cardano-wallet serve)
A target chain producer (e.g. cardano-http-bridge, Jörmungandr)

This is a shortcut command for those looking into an out-of-the-box solution for running the software.

via Jörmungandr

cardano-wallet launch 
  ([--random-port] | [--port INT])
  [--node-port INT]
  [--state-dir DIR]
  ([--quiet] | [--verbose])
  --genesis-block FILE
  --bft-leaders FILE

ℹ️ Please note that launch will generate a configuration for Jörmungandr in a folder specified by '--state-dir'.
ℹ️ The wallet backend only works with Jörmungandr in BFT mode with a test discrimination.

--genesis-block

The genesis block file can be obtained using Jörmungandr's tool command-line jcli as follows:

$ jcli genesis encode --input genesis.yaml > block0.bin

Here below is an example of genesis file that can be used for testing:

genesis.yaml

# The Blockchain Configuration defines the different settings
# of the blockchain that cannot be changed once the blockchain
# is started.
blockchain_configuration:
  # The block0-date defines the date the blockchain starts
  # expected value in seconds since UNIX_EPOCH
  block0_date: 1556202057

  # This is the type of dicrimination of the blockchain
  # of this blockchain is meant for production then
  # use 'production' instead.
  #
  # otherwise leave as this
  discrimination: test

  # The initial consensus version:
  #
  # * BFT consensus: bft
  # * Genesis Praos consensus: genesis
  block0_consensus: bft

  # Number of slots in each epoch
  slots_per_epoch: 500

  # The slot duration, in seconds, is the time between the creation
  # of 2 blocks
  slot_duration: 10

  # The number of blocks (*10) per epoch
  epoch_stability_depth: 10

  # A list of Ed25519 Extended PublicKey that represents the
  # BFT leaders encoded as bech32. The order in the list matters.
  consensus_leader_ids:
    - ed25519_pk1haythczarvl75wt6y6fmq0gjz7j9xcyfatwchj523wdawechkd8qp735w5

  # Genesis praos parameter D
  bft_slots_ratio: 0.220

  # Genesis praos active slot coefficient
  # Determines minimum stake required to try becoming slot leader, must be in range (0,1]
  consensus_genesis_praos_active_slot_coeff: 0.22

  # This is the max number of messages allowed in a given Block
  max_number_of_transactions_per_block: 255

  # The fee calculations settings
  #
  # fee(num_bytes, has_certificate) = constant + num_bytes * coefficient + has_certificate * certificate
  linear_fees:
    constant: 42
    coefficient: 0
    certificate: 0

  # The speed to update the KES Key in seconds
  kes_update_speed: 43200 # 12hours

# The initial deposits present in the blockchain.
initial:
  - fund:
      address: ta1swk7svu8avn5jysl83vja72lp0sqfczanqee6q08a4j7q27a77kpg4p254a
      value: 100000000000
  # And so forth...

--bft-leaders

The BFT leaders is a yaml file listing the private keys of the BFT leaders defined in the genesis file. For example:

secret.yaml

bft:
  signing_key: ed25519_sk1ga6n6fdsrruumg6nh0epdrqswrsdxhq4q7g5enun8v2jnk4u2gls08wfu3

example

$ cardano-wallet launch --genesis-file block0.bin --bft-leaders secret.yaml

Wallet command line interface

Commands

launch

via Jörmungandr

--genesis-block

--bft-leaders

example

via cardano-http-bridge

example

serve

via Jörmungandr

--genesis-hash

example

via cardano-http-bridge

example

mnemonic generate

wallet list

wallet create

wallet get

wallet utxo

wallet update name

wallet update passphrase

wallet delete

transaction create

transaction fees

transaction list

transaction submit

address list

version

Clone this wiki locally