Skip to main content
Ready to settle? See the onchain settlement workflow in Server & API.
Preconfirmed VTXOs are instant but trust-dependent. A VTXO reaches Bitcoin finality when it is anchored onchain through a batch swap, backed by a confirmed Bitcoin transaction with full L1 security guarantees. Applications can move between these levels at any time, choosing the right security posture for each operation.

Batch Swaps

Batch swaps are the mechanism that transitions VTXOs from preconfirmed state to Bitcoin finality. Three reasons to settle:
  1. Trust surface. Preconfirmed VTXOs rely on operator integrity. Settlement removes that dependency.
  2. Exit cost management. Deeply chained VTXOs accumulate higher unilateral exit costs. Settlement resets the chain depth.
  3. VTXO renewal. VTXOs must be renewed before batch expiry. Settlement refreshes the expiry timer.
The process is atomic: users keep custody throughout.

How It Works

1

Signal participation

Users submit an intent to the operator containing the VTXOs they want to swap, the desired parameters for their new VTXOs (scripts, amounts), and cosigner keys for the new batch’s transaction tree.
2

Build the commitment transaction

The operator constructs a new commitment transaction with two outputs: a batch output (encapsulating all participants’ new VTXOs) and a connector output (enabling atomic coordination).
3

Construct the virtual transaction tree

The operator builds the presigned transaction tree for the batch output, defining unilateral exit paths, collaborative spending conditions, timelocks, and anchor outputs for each participant.
4

Create forfeit transactions

Each user’s old VTXO is linked to the new batch through a forfeit transaction. This transaction spends the old VTXO and consumes a connector output, ensuring the operator can only claim old VTXOs if the new commitment transaction confirms onchain.
5

Sign

Users sign their forfeit transactions after verifying the virtual tree. The Arkade Signer signs the commitment transaction and new virtual paths. Neither party can finalize without the other’s cooperation.
6

Broadcast

The operator broadcasts the commitment transaction. On confirmation, new VTXOs become valid and enforceable. Old VTXOs are invalidated through the forfeit mechanism.

Batch Anatomy

Each batch swap produces a single onchain commitment transaction with two outputs:
  • Batch output. Encapsulates all participants’ new VTXOs in a virtual transaction tree, compressing thousands of ownership claims into a single onchain output.
  • Connector output. A dust-amount output owned by the operator, structured as a tree that maps one leaf to each VTXO requiring forfeit protection.
Connector outputs are also used when users exit Arkade, enabling VTXOs to be swapped for an onchain UTXO. Atomicity comes from forfeit transactions. Each user signs a forfeit transaction that relinquishes their old VTXO to the operator, but only if the new commitment transaction confirms onchain. The forfeit requires both the old VTXO and a connector output as inputs, so the operator cannot claim forfeited funds without the new batch existing on Bitcoin.
ComponentRole
Input: VTXOThe position being swapped
Input: Connector outputLinks to the new commitment transaction
Output: Forfeit outputTransfers value to operator for liquidity rotation
Output: Anchor outputZero-value output for fee management via CPFP
This two-sided protection means users can safely give up old VTXOs knowing replacements are guaranteed, while the operator is protected against double-spend attempts on forfeited funds.

Intents

Users participate in batch swaps by submitting an intent to the operator. An intent is a signed declaration containing the VTXOs to be swapped and the exact outputs the user expects to receive. Intents provide cryptographic ownership proof via BIP322 for any inputs a user wishes to redeem, whether offchain VTXOs, onchain UTXOs, or expired coins. This design separates control from coordination: users maintain complete control of their keys while the operator handles batch logistics and the Arkade Signer provides necessary cosignatures.
Find the detailed intent system description and onchain settlement mechanics in the Server & API section.

Previous: Transactions & Execution

Transaction structure, chaining, and the Virtual Mempool.

Next: VTXO Lifecycle & Liveness

Expiration, renewal, and delegation.