快速上手

创建钱包、在 Nile 测试网上充值、查看余额、发送第一笔交易——整个流程大约 10 分钟。这里的所有操作都在 Nile 上运行（测试 TRX，没有真实价值）。

前置条件：已安装 wallet-cli——wallet-cli --version 能打印出版本号。如果不能，请见安装。

1. 创建钱包

wallet-cli create --label main

命令会提示设置 master password，用于加密本地保存的所有密钥材料。该密码无法找回，必须至少包含 8 个字符，并同时包含大写字母、小写字母、数字和特殊字符。

建议使用密码管理器。 它可以生成高强度的唯一密码，并避免密码出现在 shell 历史、进程列表或明文文件中。任何提供命令行工具的密码管理器都可以；以下仅以 1Password 的 op 为例（请先安装并登录，参见文档）。将 master password 保存为一个条目，然后读取它来创建钱包：

op read "op://Private/wallet-cli/password" | wallet-cli create --label main --password-stdin

create 不会显示助记词，种子会以加密形式保存在本地。要创建恢复备份，请运行 backup。该命令会生成一个权限为 0600、包含明文 BIP39 助记词的文件； 请将其离线保存。需要在其他机器上恢复钱包时，必须使用这份助记词备份。

已经有助记词或私钥了？改用 import mnemonic 或 import private-key。

确认新账户已经存在：

wallet-cli list

HD  wlt_4473p34m
└─ [0] main        TMSgJxtPw29AFEHMXsjGo4kWV7UwbCToHJ  (active)

那串 T… 就是你的 TRON 地址，在所有 TRON 网络上都相同。该账户还有一个 EVM 的 0x 地址，由同一份种子派生——wallet-cli current 会把两个都打印出来，而 list 显示的是 --network 所选家族的那个。(active) 标记的是各命令默认作用的账户；用 wallet-cli use <label> 切换。

2. 领取测试 TRX

打开 Nile 水龙头 nileex.io/join/getJoinPage，找到 "Get 2000 test coins" 一节，粘贴你的 T… 地址，通过验证码并提交（每天一次；一分钟内到账）。然后确认已经到账：

wallet-cli account balance --network nile

Label    main
Balance  1,976.489 TRX

提示：把 Nile 设为默认网络，学习阶段就可以省略 --network：

wallet-cli config defaultNetwork tron:3448148188

3. 发送第一笔交易

发送交易需要通过 --password-stdin 从 stdin 传入 master password：

printf '%s' "$MY_PASSWORD" | wallet-cli tx send --to TSx72ViULFepRGCS4PM5dP4FqD1d8qggCc --amount 1 --network nile --password-stdin

提示——更推荐使用密码管理器（第 1 步中已配置）。直接把密码从它管道传入：

op read "op://Private/wallet-cli/password" | wallet-cli tx send --to TSx72ViULFepRGCS4PM5dP4FqD1d8qggCc --amount 1 --network nile --password-stdin

交易会被签名并提交。提交不等于确认，请继续查询交易状态：

wallet-cli tx status --txid <the txid you got back> --network nile

TxID           1789b6e3d420d84f21013fa4e18ecd2c60df1accb7101fd71c2511b75835c0cd
Status         confirmed ✅
Block          #70,604,611
Confirmations  19

pending 表示交易仍在处理中，应稍后再次查询；failed 表示交易已经入块，但链上执行失败（见故障排查）。想让 tx send 等待交易结果，请加上 --wait。

对某笔交易没把握？先演练一次——--dry-run 只构建交易并估算费用，不签名也不广播：

wallet-cli tx send --to TSx72ViULFepRGCS4PM5dP4FqD1d8qggCc --amount 1 --network nile --dry-run

4. 接下来看什么

• 发送 TRC20/TRC10 token（例如 USDT）：发送 token
• 不再为手续费燃烧 TRX：质押与资源
• 质押之后为超级代表投票并领取投票奖励：vote、reward
• 硬件钱包签名：Ledger 指南
• 完整的交易详情与回执：tx info
• 你的历史与持仓：account history、account portfolio
• 把上述任何一项自动化：脚本化指南
• tron:3448148188 / tron:728126428 到底是什么：网络

主网操作提示：主网 TRX 具有真实价值。请仔细核对收款地址，并优先执行 --dry-run；交易一旦 广播，发送方无法主动撤销，是否达到最终性仍取决于链上固化状态。

---