exit

Queues the specified VTXO outpoint for cooperative leave. If --onchain-address is omitted the daemon generates a fresh backing-wallet destination. Unilateral unroll is only started when --force-unroll-ack is exactly I_KNOW_WHAT_I_AM_DOING.

wavecli exit --outpoint TXID:VOUT
wavecli exit --outpoint TXID:VOUT --onchain-address bcrt1...

Flags

Flag	Default	Description
`--outpoint`	(none)	Required. VTXO outpoint to exit, as `txid:vout`.
`--onchain-address`	(none)	Cooperative leave destination. Omitted means a fresh wallet-owned address. Cannot be combined with `--force-unroll-ack`.
`--force-unroll-ack`	(none)	Exact acknowledgement (`I_KNOW_WHAT_I_AM_DOING`) required to force unilateral unroll.
`--dry-run`	`false`	Validate inputs locally and print the preview without dispatching to the daemon.

Example

wavecli --no-tls exit --outpoint 4b2e9f1a7c3d5e6f...:0

{
  "created": false,
  "actor_id": "",
  "mode": "EXIT_MODE_COOPERATIVE",
  "queued_outpoints": [
    "4b2e9f1a7c3d5e6f8091a2b3c4d5e6f70819a2b3c4d5e6f708192a3b4c5d6e7f:0"
  ],
  "onchain_address": "bcrt1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh"
}

Subcommands

`exit status`

Returns the status of a forced unroll job for one outpoint. By default the response includes recovery-tree progress (layer and transaction counts), the CSV maturity countdown, a best-case block estimate to full exit, and the on-chain fee breakdown, alongside the job phase, sweep txid, and any errors. The endpoint stays queryable after the exit completes.

Flag	Default	Description
`--outpoint`	(none)	Required. VTXO outpoint to check, as `txid:vout`.
`--detailed`	`true`	Include tree/CSV progress, the best-case block countdown, and the fee breakdown. Pass `--detailed=false` for a coarse, cheaper phase-only status.

Calls WalletService.ExitStatus.

wavecli exit status --outpoint TXID:VOUT
wavecli exit status --outpoint TXID:VOUT --detailed=false

`exit summary`

Lists every in-progress unilateral exit and the aggregate totals across them: the amount still being recovered, the estimated on-chain fees, and the estimated net recoverable. Completed and failed exits are omitted; they have no amount left to recover. Takes no flags.

Calls WalletService.ExitSummary.

wavecli exit summary

`exit plan`

Previews the backing-wallet funding readiness for one or more outpoints, without dispatching an exit.

Flag	Default	Description
`--outpoint`	(none)	Required. VTXO outpoint to preview, as `txid:vout`; repeatable.

Calls WalletService.GetExitPlan.

wavecli exit plan --outpoint TXID:VOUT

Exit codes

With --dry-run the command validates the request locally and prints the preview without dispatching; a valid preview exits 10 (DRY_RUN_OK), a validation failure exits non-zero.

Underlying RPC

The default cooperative path calls WalletService.Exit. The subcommands call WalletService.ExitStatus, WalletService.ExitSummary, and WalletService.GetExitPlan.