跳转至

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 显示某段交易 hex 的签名权重与已批准签名者列表 仅 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 并不适用。

对于需要多个签名的 TRON 账户,有两条联署路径:

  • 链上方式——tx sign / tx approvals / tx broadcast:发起方用 --sign-only 生成一段部分签名的 hex,每位签名者依次传递该 hex,并用 tx sign 追加自己的签名;达到阈值后,任何人都可以广播。整个流程无需借助外部服务。
  • 服务方式——tx multisig:由 TronLink 多签服务保管交易、累计签名并推送通知。开启一次签名收集就是发起方自己的第一个签名,达到阈值后由服务负责广播。这是可选的便利层,需要凭据。

无论采用哪条路径,都可以用 tx approvals 检查签名是否达到阈值。tx broadcast 会拒绝提交签名权重不足的交易,因此这类交易不会到达节点。

联署所依赖的账户权限结构,参见 permission。

另请参见

account history · 网络与费用 · 脚本编写指南