wallet-cli tx

August 5, 2026 · View on GitHub

Build, send, broadcast, co-sign, and inspect transactions.

Synopsis

wallet-cli tx COMMAND

Subcommands

CommandDescription
tx sendSend native TRX or TRC20/TRC10 tokens with human --amount
tx broadcastBroadcast a presigned transaction
tx statusShow confirmation status of a transaction
tx infoShow full transaction detail + receipt
tx signAdd your signature to a transaction hex (multi-sig co-signing)
tx approvalsShow sign-weight and the approved-signer list of a transaction hex
tx multisigMulti-sig collaboration via the TronLink service (list / create / co-sign / watch)

The transaction lifecycle

build ──sign──> submit ──solidify──> confirmed
  │                │                     │
  └ --dry-run      └ default return      └ tx status: confirmed/failed
    stops here       point ("submitted")   (pending/not_found while in flight)

tx send covers build+sign+submit in one step (with --dry-run / --sign-only stopping earlier); tx broadcast submits what was signed elsewhere; tx status / tx info observe the outcome. Submission is not confirmation — scripts must follow machine-interface → Script safety.

Multi-sig co-signing

For accounts that require more than one signature, there are two co-signing paths:

  • On-chaintx sign / tx approvals / tx broadcast: the initiator produces a partially signed hex with --sign-only, each signer appends theirs with tx sign (passing the hex along), and once the threshold is reached anyone broadcasts it. Self-sufficient, no service needed.
  • Servicetx multisig: the TronLink multi-sig service holds the transaction, accumulates signatures, and pushes notifications. Opening a collection is the initiator's own first signature, and the service broadcasts once the threshold is met. Optional convenience layer; needs credentials.

Either way, tx approvals answers "is it ready yet?", and tx broadcast refuses to submit a transaction that has not reached its threshold — an incomplete collection never reaches the node.

See permission for the account permission structure that co-signing is built on.

See also

account history · Networks & fees · Scripting guide