unlock

Decrypts the on-disk wallet seed and starts the wallet subsystem, making the wallet RPCs usable. Like create, the password is never accepted on the command line and stdin is never consumed implicitly: it is read, in priority order, from the WAVED_WALLET_PASSWORD environment variable, --wallet-password-file, an explicit --password-stdin, or an interactive terminal prompt. When none of those sources is available the command exits 2 with instructions instead of hanging.

Terminal
printf '%s\n' 'hunter2hunter2' | wavecli unlock --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.

Example

Terminal
printf '%s\n' 'hunter2hunter2' | wavecli --no-tls unlock --password-stdin
{
  "identity_pubkey": "02a1b2c3d4e5f60718293a4b5c6d7e8f90a1b2c3d4e5f60718293a4b5c6d7e8f90"
}

A wrong password exits with code 2 and an INVALID_ARGUMENT error envelope on stderr. Other wallet commands run against a still-locked wallet return a WALLET_LOCKED envelope and exit 3 (auth failure).

Underlying RPC

Calls WalletService.Unlock.