wallet-cli stake cancel-unfreeze

Cancel all pending unstakes (roll back to frozen).

Synopsis

wallet-cli stake cancel-unfreeze [--dry-run | (--sign-only | --build-only) [--expiration <ms>] | --wait [--wait-timeout <ms>]]
                                 [--permission-id <n>] [options]

Description

Cancels every unstake still in its waiting period and rolls those amounts back to staked — resource allowance and voting power return accordingly. It is all-or-nothing: TRON has no per-entry cancel. Any entries that have already expired are withdrawn to balance as part of the same transaction.

By default the command returns at submission; --wait blocks until confirmed. Requires an account. The master password (via --password-stdin) is needed only by the modes that sign — --dry-run and --build-only do not unlock the wallet and run without it. Watch-only accounts fail with watch_only_no_signer in a signing mode.

The Ledger TRON app cannot sign CancelAllUnfreezeV2. Ledger accounts may dry-run or build, but signing modes fail with ledger_unsupported before device interaction.

Options

Option	Description
--dry-run	Estimate only, no signature/broadcast; excludes --sign-only / --build-only
--sign-only	Sign without broadcasting, output the signed hex; excludes --dry-run / --build-only; pairs with --expiration
--build-only	Build and estimate, output the unsigned hex; excludes --dry-run / --sign-only; pairs with --expiration
--expiration <ms>	Transaction expiration in ms, up to 86400000 (24h); only with --sign-only or --build-only; omitted = node default (~60s)
--permission-id <n>	Permission group to sign with (0=owner, 1=witness, 2-9=active); default 0
--wait / --wait-timeout <ms>	Poll after broadcast until confirmed/failed (cap default: config waitTimeoutMs, built-in 60000)
--password-stdin	Master password from stdin

Plus the global options.

Examples

In the examples, $PW is your master password (from an environment variable, password manager, etc.), fed on stdin via --password-stdin.

Default — returns the submitted receipt:

echo "$PW" | wallet-cli stake cancel-unfreeze --network tron:3448148188 --password-stdin

⏳ Cancelled pending unstakes
  TxID    9ec...
  Status  pending — not yet on-chain
! Track it: wallet-cli tx info --network tron:3448148188 --txid 9ec...

echo "$PW" | wallet-cli stake cancel-unfreeze --network tron:3448148188 --password-stdin -o json

{"schema":"wallet-cli.result.v1","success":true,"command":"stake.cancel-unfreeze","data":{"kind":"stake-cancel","stage":"submitted","txId":"9ec..."},"meta":{"durationMs":15,"warnings":[]},"chain":{"family":"tron","network":"tron:3448148188","chainId":"3448148188"}}

Add --wait to block until confirmed:

echo "$PW" | wallet-cli stake cancel-unfreeze --network tron:3448148188 --wait --password-stdin

✅ Cancelled pending unstakes
  TxID    d3b...
  Block   #68,762,990
  Fee     0.25 TRX
  Status  success

Output

data varies by stage:

Stage	Fields
default (submit)	kind: "stake-cancel", stage: "submitted", txId
--wait (confirmed)	above, plus confirmed, blockNumber, feeSun, failed

Exit status

0 submitted (or built/signed in early-exit modes) · 1 execution failure (watch_only_no_signer, ledger_unsupported, auth_failed, rpc_error, timeout) · 2 usage error.

See also

stake unfreeze · stake info

---