跳转至

发送原生币和 token

一条命令即可发送多种资产，包括网络原生币、TRC20/ERC20 合约 token 和 TRC10 资产；具体类型由选择器参数决定。示例均在 Nile 上运行；对于支持 EVM 的操作，只需更换 --network 即可用于 EVM 网络。

密码：使用软件账户签名时，需要从 stdin 传入 master password，签名过程不会再次提示。为突出 token 相关参数，以下示例省略了密码输入。请在命令前加上 printf '%s' "$PW" |，并在末尾添加 --password-stdin；也可以从密码管理器通过管道传入。--dry-run、--build-only 和 Ledger 签名均不使用 master password。

原生币

wallet-cli tx send --to TSx72ViULFepRGCS4PM5dP4FqD1d8qggCc --amount 1 --network tron:3448148188
wallet-cli tx send --to 0x742d35Cc6634C0532925a3b844Bc454e4438f44e --amount 0.01 --network eip155:11155111

--amount 使用原生币的常用单位：在 TRON 上，1 = 1 TRX = 1,000,000 SUN；在 Sepolia 上，0.01 = 0.01 ETH = 10^16 wei。如需直接指定基础单位，请使用 --raw-amount 1000000。两个参数只能选择其一，不能同时使用。

合约 token（TRC20 / ERC20）

合约类 token 由它的合约地址标识。你可以直接传入该地址，也可以传入一个简短的符号，由 wallet-cli 帮你解析成对应合约：

# 用合约地址——总是可用
wallet-cli tx send --to T... --contract TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t --amount 5 --network tron:3448148188
wallet-cli tx send --to 0x... --contract 0xdAC17F958D2ee523a2206206994597C13D831ec7 --amount 5 --network eip155:1

# 用符号——需要该 token 已在地址簿中（见下文）
wallet-cli tx send --to T... --token USDT --amount 5 --network tron:3448148188

token 转账会执行合约代码，而费用相关的参数因家族而异：

  • TRON——它消耗能量；--fee-limit 限制为此最多可燃烧多少 TRX（默认 100000000 SUN = 100 TRX）。如果一次转账因触及费用上限而失败，先弄清原因再考虑调高它——见能量与带宽。
  • EVM——它消耗 gas，由节点估算得出。可用 --gas-limit、--max-fee、--priority-fee、--nonce 覆盖——见网络 → evm-gas 模型。

把其中一组用在另一个家族上会以 invalid_option 被拒绝。

token 地址簿（符号 → token）

--token USDT 的工作方式是在按网络划分的 token 地址簿中查找该符号：这是一张本地表，把符号映射到链上的 token——可以是一个 TRC20/ERC20 合约，也可以是一个 TRC10 资产 id。条目有两个来源，显示在 token list 的 Source 列中：

  • official——内置条目，按网络分别甄选。tron:728126428 内置 USDT / USDC / USDD，tron:3448148188 内置 USDT / USDD，eip155:1 内置 USDT / USDC。其余网络不附带任何官方条目。
  • user——你自己添加的 token。
wallet-cli token list --network tron:728126428

| Symbol | Name            | Source   | Contract / ID                      |
| ------ | --------------- | -------- | ---------------------------------- |
| USDT   | Tether USD      | official | TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t |
| USDC   | USD Coin        | official | TEkxiTehnzSmSe2XqrBj4w32RUN966rdz8 |
| USDD   | Usdd Stablecoin | official | TXDk8mbtRbXeYuMNS83CfKPaYYT8XWv9Hz |

该表按网络隔离，官方条目不会跨链复制。同一个符号在不同网络上可能对应不同的地址和精度，例如 USDT 在以太坊上为 6 位精度，在 BNB Smart Chain 上为 18 位。若当前网络没有官方条目，需要先添加 token，之后 --token 才能解析它。token add 会读取 token 的符号和精度，并保存为仅对当前网络生效的 user 条目：两个链家族的合约 token 都使用 --contract，TRC10 则使用 --asset-id。

wallet-cli token add --contract T... --network tron:3448148188         # TRC20，按合约地址
wallet-cli token add --contract 0x... --network eip155:11155111     # ERC20，按合约地址
wallet-cli token add --asset-id 1000001 --network tron:3448148188      # TRC10，仅限 TRON

其余管理操作都在同一个命令组里：token list 查看全部条目，token remove 删除一条 user 条目，token balance / token info 在不添加 token 的前提下直接查询它。

TRC10 token——仅限 TRON

TRC10 资产用的是数字 id，而不是合约：

wallet-cli tx send --to T... --asset-id 1002000 --raw-amount 1000000 --network tron:3448148188

--asset-id 是仅限 TRON 的参数；在 EVM 网络上它会以 invalid_option 失败。

--token、--contract 和 --asset-id 三者互斥；一个都不给就表示发送该网络的原生币。

先演练，再发送

--dry-run 会通过所选网络构建交易并估算费用，然后直接返回，不签名也不广播：

wallet-cli tx send --to T... --token USDT --amount 5 --network tron:3448148188 --dry-run -o json

检查输出中的 fee 字段，然后去掉 --dry-run 再次执行。交易已提交并不代表执行成功；之后应使用 tx status 查询结果，或为 tx send 添加 --wait，等待交易确认或失败。

主网：同样的命令换成 --network tron:728126428、--network eip155:1 或 --network eip155:56 就会转移真实资产，且不可逆。请反复核对 --to——转错地址的转账一旦固化就再也拿不回来了——并先做 dry run。

另请参见

tx send 参考——每个参数和输出字段 · token 命令——token 地址簿 · 快速上手 · 脚本编写——安全地自动化发送