@arkade-os/sdk Documentation - v0.4.21
    Preparing search index...

    Interface VirtualStatus

    Virtual output status

    interface VirtualStatus {
        batchExpiry?: number;
        commitmentTxIds?: string[];
        state: "preconfirmed" | "settled" | "swept" | "spent";
    }
    Index

    Properties

    batchExpiry?: number

    The earliest point at which this virtual output stops being safely preconfirmed.

    The value is stored in milliseconds in the wallet model and is used by expiry and recovery logic to decide when a virtual output can be swept or renewed.

    commitmentTxIds?: string[]

    Which batch commitment transaction(s) this virtual output depends on.

    The history builder uses these ids to group received batch transactions and relate refreshed or forfeited virtual outputs back to the same batch.

    state: "preconfirmed" | "settled" | "swept" | "spent"

    Extended output status.

    • preconfirmed: not yet finalized in a batch
    • settled: finalized in a batch
    • swept: expired/swept and recoverable in a new batch
    • spent: destroyed by a later transaction

    state is the high-level lifecycle summary used throughout wallet balance, recovery, and transaction history logic.