Keys allows you to manage your local tendermint keystore (wallets) for iris.

Available Commands

addAdd an encrypted private key (either newly generated or recovered), encrypt it, and save to disk
deleteDelete the given key
exportExport private keys
importImport private keys into the local keybase
listList all keys
migrateMigrate keys from the legacy (db-based) Keybase
mnemonicCompute the bip39 mnemonic for some input entropy
parseParse address from hex to bech32 and vice versa
showRetrieve key information by name or address

iris keys add

Derive a new private key and encrypt to disk.

iris keys add <key-name> [flags]


Name, shorthandDefaultDescriptionRequired
--multisigConstruct and store a multisig public key
--multisig-threshold1K out of N required signatures
--nosortfalseKeys passed to --multisig are taken in the order they're supplied
--pubkeyParse a public key in bech32 format and save it to disk
--interactivefalseInteractively prompt user for BIP39 passphrase and mnemonic
--ledgerfalseStore a local reference to a private key on a Ledger device
--recoverfalseProvide seed phrase to recover existing key instead of creating
--no-backupfalseDon't print out seed phrase (if others are watching the terminal)
--dry-runfalsePerform action, but don't add key to local keystore
--hd-pathManual HD Path derivation (overrides BIP44 config)
--coin-type118coin type number for HD derivation
--account0Account number for HD derivation
--index0Address index number for HD derivation
--algosecp256kKey signing algorithm to generate keys for

Create a new key

iris keys add MyKey

Enter and repeat the password, at least 8 characters, then you will get a new key.



write the seed phrase in a safe place! It is the only way to recover your account if you ever forget your password.

Recover an existing key from seed phrase

If you forget your password or lose your key, or you wanna use your key in another place, you can recover your key by your seed phrase.

iris keys add MyKey --recover

You'll be asked to enter and repeat the new password for your key, and enter the seed phrase. Then you get your key back.

Enter a passphrase for your key:
Repeat the passphrase:
Enter your recovery seed phrase:

Create a multisig key

The following example creates a multisig key with 3 sub-keys, and specify the minimum number of signatures as 2. The tx could be broadcast only when the number of signatures is greater than or equal to 2.

iris keys add <multisig-keyname> --multisig-threshold=2 --multisig=<signer-keyname-1>,<signer-keyname-2>,<signer-keyname-3>


<signer-keyname> can be the type of "local/offline/ledger", but not "multi" type.

If you don't have all the permission of sub-keys, you can ask for the pubkeys to create the offline keys first, then you will be able to create the multisig key.

Offline key can be created by "iris keys add --pubkey".

How to use multisig key to sign and broadcast a transaction, please refer to multisign

iris keys delete

Delete a local key by the given name.

iris keys delete <key-name> [flags]


Name, shorthandDefaultDescriptionRequired
--force, -ffalseRemove the key unconditionally without asking for the passphrase
--yes, -yfalseSkip confirmation prompt when deleting offline or ledger key references

Delete a local key

iris keys delete MyKey

iris keys export

Export the keystore of a key to a json file

iris keys export <key-name> [flags]

Export keystore

iris keys export Mykey --output-file=<path-to-keystore>

iris keys import

Import a ASCII armored private key into the local keybase.

Import a ASCII armored private key

iris keys import <name> <keyfile> [flags]

iris keys list

List all the keys stored by this key manager along with their associated name, type, address and pubkey.


Name, shorthandDefaultDescriptionRequired
--list-nameList names only

List all keys

iris keys list

iris keys migrate

Migrate key information from the legacy (db-based) Keybase to the new keyring-based Keybase.


Name, shorthandDefaultDescriptionRequired
--dry-runRun migration without actually persisting any changes to the new Keybase

Migrate key information

iris keys migrate [flags]

iris keys mnemonic

Create a bip39 mnemonic, sometimes called a seed phrase, by reading from the system entropy. To pass your own entropy, use unsafe-entropy mode.

iris keys mnemonic [flags]


Name, shorthandDefaultDescriptionRequired
--unsafe-entropyPrompt the user to supply their own entropy, instead of relying on the system

Create a bip39 mnemonic

iris keys mnemonic

You'll get a bip39 mnemonic with 24 words, e.g.:

beauty entire blue tape ordinary fix rotate learn smart tiger dolphin cycle cigar dish alcohol slab bachelor vital design consider paper panther mad eternal

iris keys parse

Convert and print to stdout key addresses and fingerprints from hexadecimal into bech32 cosmos prefixed format and vice versa.

Convert and print to stdout key addresses and fingerprints

iris keys parse <hex-or-bech32-address> [flags]

iris keys show

Get details of a local key.

iris keys show <key-name> [flags]


Name, shorthandDefaultDescriptionRequired
--addressfalseOutput the address only (overrides --output)
--bechaccThe Bech32 prefix encoding for a key (acc/val/cons)
--devicefalseOutput the address in a ledger device
--multisig-threshold1K out of N required signatures
--pubkeyfalseOutput the public key only (overrides --output)

Get details of a local key

iris keys show MyKey

The following infos will be shown:

- name: Mykey
  type: local
  address: iaa1tulwx2hwz4dv8te6cflhda64dn0984harlzegw
  pubkey: iap1addwnpepq24rufap6u0sysqcpgsfzqhw3x8nfkhqhtmpgqt0369rlyqcg0vkgwzc4k0
  mnemonic: ""
  threshold: 0
  pubkeys: []

Get validator operator address

If an address has been bonded to be a validator operator (which the address you used to create a validator), then you can use --bech val to get the operator's address prefixed by iva and the pubkey prefixed by ivp:

iris keys show MyKey --bech val

Example Output:

- name: Mykey
  type: local
  address: iva1tulwx2hwz4dv8te6cflhda64dn0984hakwgk4f
  pubkey: ivp1addwnpepq24rufap6u0sysqcpgsfzqhw3x8nfkhqhtmpgqt0369rlyqcg0vkgd8e6zy
  mnemonic: ""
  threshold: 0
  pubkeys: []