wallet-cli delete¶

Delete a wallet/account and clean orphan labels.

Synopsis¶

wallet-cli delete <account> [--yes] [options]

Arguments¶

account — account or wallet to delete, by accountId, label, or address

Options¶

Option	Description
`--yes`	skip the interactive confirmation; required for non-TTY deletion

Plus global options.

Notes¶

Deleting an HD wallet cascades from the seed root — all derived accounts go with it. On-chain assets are untouched; re-import the mnemonic to regain access. Back up first. Metadata-only — no master password needed.

Examples¶

Without --yes, deletion prompts for confirmation — you must type the account label exactly:

wallet-cli delete solo

? Delete solo? Type the exact label "solo" to confirm: solo
✅ Deleted wallet wlt_p7cg790g
  Secret removed  yes

Deleting an HD root cascades to the whole wallet (all derived accounts + keys):

wallet-cli delete main --yes

✅ Deleted wallet wlt_teh9fafq
  Secret removed  yes

Deleting a single HD sub-account removes only that account, keeping the seed key (you can derive again); the JSON shows the deletion scope, whether the key was removed too, and the account active afterwards:

wallet-cli delete main-1 --yes -o json

{"schema":"wallet-cli.result.v1","success":true,"command":"delete","data":{"accountId":"wlt_teh9fafq.1","scope":"account","secretRemoved":false,"newActive":"wlt_teh9fafq.0"},"meta":{"durationMs":14,"warnings":[]}}

Output¶

data describes the deletion result. Local command — no chain block.

Field	Type	Meaning
`accountId`	string	Id of the deleted account/wallet (`wlt_….N` for a sub-account, the wallet id `wlt_…` for a wallet)
`scope`	string	`account` (only that account) or `wallet` (cascaded whole wallet)
`secretRemoved`	boolean	Whether encrypted secret material was removed. Deleting an HD sub-account keeps the seed, so `false`. Deleting a wallet reports whether that wallet held a secret at all: `true` for seed and private-key wallets, `false` for Ledger and watch-only ones, which never stored one
`newActive`	string \| null	New active account id after deletion; `null` if none remain

Exit status¶

0 success · 1 execution failure · 2 usage error. See machine-interface.