wallet-cli rename

Rename an account label.

Synopsis

wallet-cli rename <account> --label <new> [options]

Arguments

• account — accountId, current label, or address to rename

Options

Option	Description
--label <string>	new unique label, 1-64 chars [required]

Plus global options.

Notes

The stable handle is always the accountId; only the label changes. Metadata-only — no master password needed.

Examples

wallet-cli rename main --label primary

✅ Renamed account
  Old label  main
  New label  primary

wallet-cli rename main-1 --label hot-hd -o json

{"schema":"wallet-cli.result.v1","success":true,"command":"rename","data":{"previousLabel":"main-1","accountId":"wlt_0y2z0gvr.1","label":"hot-hd","type":"seed","index":1,"active":true,"addresses":{"tron":"TRzaAZWRvPCcmqNETTWvmMLDi6cKwM3gbR","evm":"0x94f2e5cbb4BcA39A3F6c252217a0F30A0D23660b"},"seedId":"wlt_0y2z0gvr","derivationPath":{"tron":"m/44'/195'/1'/0/0","evm":"m/44'/60'/0'/0/1"}},"meta":{"durationMs":14,"warnings":[]}}

Output

data is the renamed account, plus previousLabel. Local command — no chain block.

Field	Type	Meaning
previousLabel	string	The old label before renaming
accountId	string	Stable account id (unchanged by rename)
label	string	The new label
type	string	seed / privateKey / watch / ledger
index	number | null	HD derivation index; null for non-HD accounts
active	boolean	Whether it is the active account
addresses	object	One entry per family the account can produce: tron (base58) and/or evm (0x, EIP-55 checksummed)
derivationPath	object | null	Per-family BIP44 path for derived accounts; null for watch / privateKey, which were never derived
seedId	string	Owning seed wallet id (seed accounts only)
family	string	Chain family this account is bound to — single-family accounts (watch, ledger) only

Exit status

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

See also

list · use

---