wallet-cli import mnemonic

导入一段 BIP39 助记词。仅交互式。

注意：这里没有 --mnemonic-stdin / --password-stdin 选项。助记词和 master password 只能通过隐藏的 TTY 提示输入——一段助记词足以取走全部资金，而走 stdin 太容易泄漏到管道、shell 历史和进程列表里。导入本身并不频繁，强制人工输入的代价很小。

用法

wallet-cli import mnemonic [--label <name>]

说明

从已有的 BIP39 助记词恢复一个 HD 钱包：派生出 #0 号账户，并用你的 master password 加密保存 seed。导入的钱包会成为当前账户。

交互流程（所有密钥均隐藏输入，绝不回显，也绝不出现在 argv 中）：

1. master password——首次使用时设置（需确认输入），或输入以解锁。
2. 标签——可选的显示名称；提示处会给出一个随机的默认值（wallet_ad8f21），直接回车即可采用。
3. 助记词——隐藏粘贴输入；驱动本 CLI 的 AI 或脚本永远看不到它。
4. 校验并保存——词数或校验和不对会报 invalid_mnemonic 并重新提示；成功后派生出各地址，seed 以加密形式写入，绝不以明文存储。

没有 TTY 时，命令会以 tty_required 失败——本命令没有非交互式的路径。

选项

选项	说明
--label <string>	便于识别的唯一账户标签，1–64 个字符；省略则自动生成

此外还有全局选项。

示例

wallet-cli import mnemonic --label restored

? Set master password (hidden):
? Confirm master password:
? Paste recovery phrase (hidden):
✅ Imported wallet "restored"
  Account ID    wlt_d66fvems.0
  Type          HD
  TRON address  TUEZSdKsoDHQMeZwihtdoBiN46zxhGWYdH
  EVM address   0xd41F7a6C39e05B28fA1c7D930e64b8517cA2F069
  Active        yes

⚠️ Recovery phrase was read from hidden input and was not printed.

wallet-cli import mnemonic --label restored -o json

? Set master password (hidden):
? Confirm master password:
? Paste recovery phrase (hidden):
{"schema":"wallet-cli.result.v1","success":true,"command":"import.mnemonic","data":{"status":"created","accountId":"wlt_d66fvems.0","label":"restored","type":"seed","index":0,"active":true,"addresses":{"tron":"TUEZSdKsoDHQMeZwihtdoBiN46zxhGWYdH","evm":"0xd41F7a6C39e05B28fA1c7D930e64b8517cA2F069"},"seedId":"wlt_d66fvems","derivationPath":{"tron":"m/44'/195'/0'/0/0","evm":"m/44'/60'/0'/0/0"}},"meta":{"durationMs":38,"warnings":[]}}

输出

data 携带导入的账户——只有地址，绝不含任何密钥。本地命令——没有 chain 块。

字段	类型	含义
status	string	"created"；若该助记词的 0 号账户已经存在，则为 "existing"（此时选中的是已有的那个账户）
accountId	string	稳定 id <seedId>.<index>
label	string	账户标签
type	string	"seed"（HD 派生）
index	number	HD 派生索引（首个账户为 0）
active	boolean	是否成为当前账户
addresses	object	派生出的两个地址：tron（base58）和 evm（EIP-55）
seedId	string	所属种子钱包 id
derivationPath	object	0 号账户索引下各家族的 BIP44 路径

退出码

0 导入成功 · 1 执行失败（auth_failed——输入的 master password 与已有 keystore 不匹配；invalid_mnemonic——存储层校验拒绝了该助记词；io_error） · 2 用法错误（tty_required——没有可用于隐藏输入的 TTY；invalid_value——标签非法或重复）。在 TTY 提示处输入的非法助记词或强度不足的新密码，会当场被拒绝并重新提示，而不会作为终止性错误返回。

另请参见

import private-key · create · change-password · 故障排查

---