账户与 HD 钱包¶

wallet-cli 如何组织你在 list 中看到的内容。

种子与账户¶

一个种子钱包对应一条 BIP39 助记词；它可以派生出多个账户。id 正体现了这一点：

wlt_z259a1hq        ← seedId (one mnemonic)
wlt_z259a1hq.0      ← accountId = seedId.index (one account, one address per family)
wlt_z259a1hq.1

create 创建一个新种子以及 0 号账户；derive --seed-id wlt_… 从同一条助记词追加下一个账户（或显式指定 --index）。在其他环境中恢复同一助记词会重新派生出相同的地址，因此助记词才是钱包的恢复凭据；master password 仅用于保护本地存储。注意，create 不会打印助记词；执行 backup 可以把它导出到离线文件。

一个账户，每个链家族一个地址¶

密钥本身并不绑定某一条链，因此一个账户在每个链家族下各有一个地址——一个 TRON base58 地址和一个 EVM 0x 地址——它们由同一份种子在不同的 BIP44 币种类型下派生而来：

m/44'/195'/<index>'/0/0   TRON
m/44'/60'/0'/0/<index>    EVM

两者都是真实且相互独立的地址，各自持有余额；向其中一个地址转账不会改变另一个地址的余额。list -o json 和 current -o json 会同时返回这两个地址，将它们放在以家族为键的 addresses 下，并通过 derivationPath 标明各自使用的派生路径模板：

{"accountId":"wlt_z259a1hq.0","label":"main","type":"seed","index":0,
 "addresses":{"tron":"TE9kPMtaMjfZN95CuPRsCHUQGWwx9EcJW8","evm":"0x7B28FE10FBccE88c3967ff0Fd64f1ffB46b46C9C"},
 "seedId":"wlt_z259a1hq",
 "derivationPath":{"tron":"m/44'/195'/0'/0/0","evm":"m/44'/60'/0'/0/0"}}

一条命令以哪个地址的身份执行，取决于所选网络，而不是账户上的某个设置：--network nile 用的是 TRON 地址，--network sepolia 用的是 EVM 地址。文本列表一次只显示一个家族，并会说明略去了多少个账户；JSON 则始终带上全部家族。

并非每个账户都同时拥有两个地址。watch 或 ledger 账户只记录一个地址，即导入时提供的地址或设备应用派生的地址。因此，这类账户带有 family 字段，并且只能在对应家族的网络上使用；用于其他家族时会返回 family_mismatch。

账户类型¶

类型	创建方式	本地是否保存密钥材料？	能否签名？	链家族
`seed`	`create`、`import mnemonic`、`derive`	加密的种子	能	TRON + EVM
private-key	`import private-key`、`import keystore`	加密的私钥；无法派生	能	TRON + EVM
ledger	`import ledger`	无（仅观察条目）	在设备上签名	由 `--app` 决定
watch	`import watch`	无	不能——只能查询	由地址本身决定

当前账户¶

大多数与钱包绑定的命令都需要一个账户。解析顺序：

命令上的 --account <accountId|label|address>；
否则使用当前账户——用 use <account> 设置，由 current 显示，并在 list 中以 (active) 标记。

标签唯一、1–64 个字符、可重命名（rename）——稳定的句柄始终是 accountId。

生命周期¶

backup <account> 把密钥材料和元数据导出到一个以 0600 权限创建、且不会覆盖的文件（默认位于当前工作目录）。请按照密钥文件的安全等级保护该文件，并注意命令的执行目录，因为 CLI 不会检查该目录是否是共享目录或纳入了版本控制。原生格式携带的是种子或密钥本身，因此一次性覆盖全部家族；而 backup --keystore 携带的是单个私钥，因此由 --network 决定它装的是哪个家族的密钥。
delete 删除账户；删除 HD 钱包会从种子根开始级联——该种子派生出的全部账户都会一并删除。链上资产不受影响：重新导入助记词即可恢复访问。
丢失 master password 在本地无法恢复；退路始终是助记词 → import mnemonic。

另请参见¶

list · create · import · 安全模型