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-1 --label hot-hd

✅ Renamed account
  Old label  main-1
  New label  hot-hd

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_kwyjcwdh.1","label":"hot-hd","type":"seed","index":1,"active":true,"addresses":{"tron":"TVz38F2QmQf53g7QVATBbsZ6JkHKccJFAQ","evm":"0xEA4A61822322c695F5A9eB7920b843054CbDaA83"},"seedId":"wlt_kwyjcwdh","derivationPath":null},"meta":{"durationMs":26,"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)
`seedId`	string	Owning seed wallet id (`seed` accounts only)
`derivationPath`	null	Always `null`, deliberately — `rename` takes no master password, so it cannot tell an old TRON path from a current one without opening the seed; `derive` and `backup` report verified paths
`family`	string	Chain family this account is bound to — single-family accounts (`watch`, `ledger`) only
`path`	string	The account's derivation path on the device (`ledger` accounts only)

Exit status¶

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