Nunchuk Wallet Management

If auth or network setup is the blocker, use nunchuk-setup.

If the user asks about Platform key inspection or policy updates on an existing wallet, use nunchuk-platform-key.

Inspect

List wallets:

nunchuk wallet list

List wallets without balance lookup (faster, does not require internet):

nunchuk wallet list --no-balance

Get wallet details:

nunchuk wallet get <wallet-id>
nunchuk wallet get <wallet-id> --no-balance

Get a fresh receive address:

nunchuk wallet address get <wallet-id>

Export and Recover

Export backup material:

nunchuk wallet export <wallet-id>

Export descriptor only:

nunchuk wallet export <wallet-id> --type descriptor

Export descriptor in all format:

nunchuk wallet export <wallet-id> --type descriptor --format all

Export BSMS only:

nunchuk wallet export <wallet-id> --type bsms

Save export output to a file:

nunchuk wallet export <wallet-id> > wallet-backup.txt
nunchuk wallet export <wallet-id> --type bsms > wallet-backup.bsms

Recover from a backup file:

nunchuk wallet recover --file wallet-backup.bsms

Recover from a descriptor with a custom name:

nunchuk wallet recover --file descriptor.txt --name "Recovered Wallet"

Rename and Delete

Rename a wallet:

nunchuk wallet rename <wallet-id> --name "My Wallet"

Delete a wallet:

nunchuk wallet delete <wallet-id>

Dummy Transactions

Currently dummy transactions are used to approve Platform key policy changes.

They are built as dummy PSBTs that use a dummy input and send back to the same wallet. They are only for collecting the required wallet signatures for approval, and they cannot be broadcast to the blockchain.

List pending dummy transactions:

nunchuk wallet dummy-tx list <wallet-id>

Get one dummy transaction:

nunchuk wallet dummy-tx get <wallet-id> --dummy-tx-id <id>

Sign a dummy transaction:

nunchuk wallet dummy-tx sign <wallet-id> --dummy-tx-id <id>

Cancel a dummy transaction:

nunchuk wallet dummy-tx cancel <wallet-id> --dummy-tx-id <id>

Defaults

• Prefer wallet export <wallet-id> with default options unless the user asked for a specific backup format.
• Use --json when the user needs exact machine-readable output.
• Use --no-balance for faster local wallet lookup without Electrum balance fetch.
• Treat wallet delete as destructive and only run it when the user clearly asked for removal.

Gotchas

• wallet export defaults to descriptor export.
• wallet export supports --type descriptor and --type bsms.
• --format only applies to descriptor export.
• Export output is raw content, so redirect it to a file when the user wants a backup file.
• wallet recover accepts a descriptor file or a BSMS 1.0 backup file.
• wallet dummy-tx get shows the request type, old state, new state, and signature progress.
• wallet dummy-tx sign can use auto-detected stored keys, --fingerprint, or --xprv.
• If the recovered wallet already exists locally, the command returns already_exists instead of overwriting it.
• wallet delete deletes the wallet from the server and removes the local copy.