wallet-cli tx¶
构建、发送、广播、联署以及查看交易。
用法¶
wallet-cli tx COMMAND
子命令¶
| 命令 | 说明 | 适用网络 |
|---|---|---|
tx send |
用人类可读的 --amount 发送原生币或某个 token |
TRON、EVM |
tx broadcast |
广播一笔预先签名的交易 | TRON、EVM |
tx status |
查看交易的确认状态 | TRON、EVM |
tx info |
查看交易的完整详情和交易回执 | TRON、EVM |
tx sign |
对在别处构建好的交易签名 | TRON、EVM |
tx approvals |
查看一笔多签交易上已收集的签名 | 仅 TRON |
tx multisig |
通过 TronLink 服务进行多签协作(列出 / 创建 / 联署 / 监听) | 仅 TRON |
这些命令之间传递的交易 hex,在 TRON 上是 protocol.Transaction protobuf,在 EVM 上是 RLP(0x02…)。费用参数也因家族而异——TRON 上是 --fee-limit / --permission-id / --expiration,EVM 上是 --gas-limit / --max-fee / --priority-fee / --nonce——两组参数用在另一个家族上都会以 invalid_option 被拒绝。
交易生命周期¶
build ──sign──> submit ──receipt──> confirmed
│ │ │
└ --dry-run └ default return └ tx status: confirmed/failed
stops here point ("submitted") (pending/not_found while in flight)
tx send 一步完成构建+签名+提交(用 --dry-run / --sign-only 可以提前停下);tx broadcast 提交在别处签好名的交易;tx status / tx info 用于观察结果。confirmed 表示已入块并取得回执,不表示已最终确定。提交不等于确认——脚本必须遵循机器接口 → 脚本安全。
多签联署¶
仅限 TRON。 EVM 交易只带一个签名,因此既没有阈值可达,也没有联署流程;在 EVM 上 tx sign 只是单纯签名,而 tx approvals / tx multisig 根本不绑定到 EVM。
对于需要多个签名的 TRON 账户,有两条联署路径:
- 链上方式——
tx sign/tx approvals/tx broadcast:发起方用--sign-only生成一段部分签名的 hex,每位签名者依次传递该 hex,并用tx sign追加自己的签名;达到阈值后,任何人都可以广播。整个流程无需借助外部服务。 - 服务方式——
tx multisig:由 TronLink 多签服务保管交易、累计签名并推送通知。开启一次签名收集就是发起方自己的第一个签名,达到阈值后由服务负责广播。这是可选的便利层,需要凭据。
无论采用哪条路径,都可以用 tx approvals 检查签名是否达到阈值。tx broadcast 会拒绝提交签名权重不足的交易,因此这类交易不会到达节点。
联署所依赖的账户权限结构,参见 permission。
另请参见¶
account history · 网络与费用 · 脚本编写指南