create

Initializes a new wallet. The daemon generates a 24-word aezeed mnemonic, prints it to stderr so you can record it offline, and encrypts the seed with the supplied password. Pass --recover with a --mnemonic-file to import an existing mnemonic and rebuild Ark wallet state instead.

The wallet password is never read from the command line, and stdin is never consumed implicitly. It comes, in priority order, from the WAVED_WALLET_PASSWORD environment variable, --wallet-password-file, an explicit --password-stdin, or an interactive terminal prompt that asks for confirmation. When none of those sources is available (non-interactive stdin without --password-stdin, or input disabled via --no-input / CI=true) the command exits 2 with instructions instead of hanging. The optional aezeed seed passphrase comes from WAVED_SEED_PASSPHRASE or --seed-passphrase-file.

Terminal
printf '%s\n' 'hunter2hunter2' | wavecli create --password-stdin

Flags

Flag Default Description
--wallet-password-file (none) Path to a file containing the wallet password.
--password-stdin false Read one wallet password line from stdin.
--seed-passphrase-file (none) Path to a file containing the optional aezeed passphrase.
--print-mnemonic-json false Include the mnemonic in the JSON response on stdout (default: stderr only).
--recover false Import an existing mnemonic and recover Ark wallet state.
--mnemonic-file (none) Path to a file containing an existing 24-word aezeed mnemonic. Requires --recover.
--recovery-window 0 Number of key indexes to scan per recovery family. Requires --recover; 0 uses the daemon default.

Example

Terminal
printf '%s\n' 'hunter2hunter2' | wavecli --no-tls create --password-stdin

The mnemonic goes to stderr; stdout carries the identity and recovery summary:

{
  "identity_pubkey": "02a1b2c3d4e5f60718293a4b5c6d7e8f90a1b2c3d4e5f60718293a4b5c6d7e8f90",
  "recovery_ran": false,
  "recovered_boarding_addresses": 0,
  "recovered_boarding_utxos": 0,
  "recovered_vtxos": 0,
  "recovered_oor_receive_scripts": 0,
  "recovered_oor_events": 0
}

Underlying RPC

Calls WalletService.Create, which proxies the daemon’s seed generation and wallet initialization.