Documentation

Kanari Documentation

Keytool Operations

Create, import, select, inspect, and list Kanari wallets.

Last updated

Keytool Operations

keytool manages local encrypted wallets used by the CLI.

kanari keytool <COMMAND>

Commands

create

Create a new encrypted wallet.

kanari keytool create --password <PASSWORD>

Options:

  • -p, --password <PASSWORD>: wallet encryption password.
  • -c, --curve <CURVE>: key type. Supported values include ed25519, k256, p256, ed25519+dilithium3, and k256+dilithium3.
  • -w, --words <WORDS>: mnemonic word count for classical curves; 12 or 24, default 12.
  • --path <DERIVATION_PATH>: BIP32 path, default m/44'/637'/0'/0/0.

Classical curves derive from a mnemonic. Hybrid/PQ-style wallets are generated directly and do not use a mnemonic seed phrase.

load

Select an existing wallet as the active wallet.

kanari keytool load --address <ADDRESS> --password <PASSWORD>

list

List local wallets.

kanari keytool list

info

Show detailed wallet information.

kanari keytool info --address <ADDRESS> --password <PASSWORD>

Options:

  • --show-secrets: print private key and seed phrase. Use only in a trusted local terminal.

import

Import an existing wallet from a private key or seed phrase.

kanari keytool import --private-key <PRIVATE_KEY> --password <PASSWORD>
kanari keytool import --seed "<SEED_PHRASE>" --password <PASSWORD>

Options:

  • --private-key <PRIVATE_KEY>: raw private key, with or without the Kanari prefix.
  • --seed <SEED>: BIP39 seed phrase. Seed import is supported only for classical curves.
  • -p, --password <PASSWORD>: wallet encryption password.
  • -c, --curve <CURVE>: key type; default is ed25519.
  • --path <DERIVATION_PATH>: BIP32 path for seed import.