@arkade-os/sdk 0.4.43 → 0.4.45

package/README.md

@@ -797,6 +797,106 @@ await Unroll.completeUnroll(
 - The `completeUnroll` method can only be called after all virtual outputs are fully unrolled and the timelock has expired
 - You need sufficient onchain funds in the `OnchainWallet` to pay for P2A transaction fees
 
+### Unilateral Exit Packages (pre-signed)
+
+`Unroll.Session` requires the wallet (keys + indexer access) to stay online for the whole
+multi-day exit. `UnilateralExit` removes that requirement: it pre-signs **every** transaction
+needed to unroll a VTXO's offchain transaction chain onchain **and** sweep each matured output
+to an address you solely control, then emits a versioned JSON package that anything with an
+Esplora-compatible endpoint can execute — no keys, no Arkade infrastructure.
+
+> **Note:** Unilateral exit handles **BTC value only** and does not represent any assets a
+> VTXO carries — do not pass asset-bearing VTXOs (those with a non-empty `assets` field).
+
+The flow is **quote → fund → prepare → execute**:
+
+```typescript
+import { UnilateralExit, OnchainWallet, serializeExitPackage } from '@arkade-os/sdk'
+
+const onchainWallet = await OnchainWallet.create(identity, 'mainnet')
+
+// 1. Quote: how many txs, how many sats (no funds needed, nothing signed)
+const quote = await UnilateralExit.estimate({
+  wallet,
+  onchainWallet,
+  sweepAddress: 'bc1p...',      // where the exited funds land
+  // feeRate: 2,                // sat/vB — defaults to the provider estimate
+})
+console.log(quote.totals.txCount, quote.totals.fundingRequiredSats, quote.shortfallSats)
+
+// 2. Deposit quote.shortfallSats to quote.fundingAddress, wait for confirmation
+
+// 3. Prepare: signs everything and broadcasts the fee-funding splitter,
+//    reserving the fee budget onchain
+const pkg = await UnilateralExit.prepare({ wallet, onchainWallet, sweepAddress: 'bc1p...' })
+const json = serializeExitPackage(pkg) // hand this to any executor
+
+// 4. Execute anywhere — here, or on a machine that has only an Esplora URL
+const executor = new UnilateralExit.Executor(pkg, wallet.onchainProvider)
+for await (const event of executor) {
+  console.log(event.stepIndex, event.kind, event.status)
+}
+```
+
+Every exit terminates in a **sweep**. Unrolling only lands a VTXO back onchain still encumbered
+by its Arkade script; the funds become yours unilaterally only once a sweep spends that output
+through the CSV-timelocked exit path to `sweepAddress`. So the package always pairs each exited
+VTXO with a pre-signed sweep, and `totals.recoveredSats` is what arrives at `sweepAddress` after
+the timelocks mature. A VTXO whose sweep cannot be signed — e.g. a contract path that needs
+another party — is dropped from the package rather than left half-exited onchain.
+
+Key properties:
+
+- **Contract-aware**: exit paths are resolved through the contract handler registry, so
+  contract VTXOs (e.g. a VHTLC whose preimage is in the contract params) are pre-signable
+  too — paths needing other parties' signatures are skipped with a reason.
+- **Shared ancestors are paid once**: VTXOs under the same commitment share tree
+  transactions; the package contains one step (and one fee) per unique transaction.
+- **Idempotent execution**: the executor re-checks the chain before every action, so it can
+  be killed, moved, and re-run at any point; already-confirmed steps are skipped.
+- **Per-VTXO isolation**: one sweep per VTXO plus fan-out fee funding means one failed
+  branch never blocks the others.
+- **Confidentiality**: packages contain no key material, but sweeps of condition paths embed
+  the condition witness (e.g. a VHTLC preimage) — treat the file as confidential until
+  broadcast.
+- `validUntil` carries the earliest batch expiry: execute before it, or the operator may
+  sweep the expired batch first.
+
+### Exit data available offline
+
+The exit above resolves a VTXO's transaction chain from the Ark **indexer** at
+exit time. To make a unilateral exit work even when the indexer is unreachable,
+configure a `virtualTxRepository` (SQLite / Realm / IndexedDB / InMemory): the
+wallet then captures each received VTXO's exit branch locally and prunes it on
+spend, and `estimate` / `prepare` read that data **local-first**, falling back to
+the indexer only on a miss.
+
+```typescript
+import { Wallet, InMemoryVirtualTxRepository } from '@arkade-os/sdk'
+
+const wallet = await Wallet.create({
+  identity,
+  storage: {
+    walletRepository,
+    contractRepository,
+    virtualTxRepository: new InMemoryVirtualTxRepository(),
+    // Optional. `mode` defaults to "lite" (structure only, cheap — most VTXOs
+    // never exit). Use "full" to also store the pre-signed PSBTs, so an exit
+    // needs no Ark indexer (only an Esplora endpoint to broadcast).
+    exitDataCapture: { mode: 'full' },
+  },
+})
+```
+
+- **Lite (default)** stores only the chain structure; an exit still fetches PSBTs
+  from the indexer. **Full** stores the PSBTs too, so the exit is fully
+  indexer-independent. `minExitWorthSats` (default 1000) skips dust VTXOs.
+- Capture and prune are best-effort — a persistence failure never blocks sync or
+  the exit. Pruning is ref-counted, so tree ancestors shared by other VTXOs survive.
+- **Provider tier:** pass extra sources via `exitDataCapture.sources` to resolve
+  exit data from your own service before the indexer — implement the
+  `ExitDataSource` interface (`getVtxoChain` / `getVirtualTxs`).
+
 ### Running the wallet in a service worker
 
 The SDK provides a `MessageBus` orchestrator that runs inside a service worker

package/dist/adapters/expo.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
-var chunkPLJZRIFZ_cjs = require('../chunk-PLJZRIFZ.cjs');
-require('../chunk-3AQNLQPM.cjs');
+var chunkHZ7VIN7P_cjs = require('../chunk-HZ7VIN7P.cjs');
+require('../chunk-UHOHLN3C.cjs');
 require('../chunk-HXDZ2QTW.cjs');
 require('../chunk-5BLDMQED.cjs');
 
@@ -9,11 +9,11 @@ require('../chunk-5BLDMQED.cjs');
 
 Object.defineProperty(exports, "ExpoArkProvider", {
   enumerable: true,
-  get: function () { return chunkPLJZRIFZ_cjs.ExpoArkProvider; }
+  get: function () { return chunkHZ7VIN7P_cjs.ExpoArkProvider; }
 });
 Object.defineProperty(exports, "ExpoIndexerProvider", {
   enumerable: true,
-  get: function () { return chunkPLJZRIFZ_cjs.ExpoIndexerProvider; }
+  get: function () { return chunkHZ7VIN7P_cjs.ExpoIndexerProvider; }
 });
 //# sourceMappingURL=expo.cjs.map
 //# sourceMappingURL=expo.cjs.map

package/dist/adapters/expo.d.cts

@@ -1,5 +1,5 @@
-import { l as RestArkProvider, j as SettlementEvent, T as TxNotification, m as RestIndexerProvider, n as SubscriptionResponse } from '../ark-I8jfe5VE.cjs';
-export { o as ArkProvider, p as IndexerProvider } from '../ark-I8jfe5VE.cjs';
+import { l as RestArkProvider, j as SettlementEvent, T as TxNotification, m as RestIndexerProvider, n as SubscriptionResponse } from '../ark-C-PjOngm.cjs';
+export { o as ArkProvider, p as IndexerProvider } from '../ark-C-PjOngm.cjs';
 import '@scure/btc-signer/transaction.js';
 import '@scure/btc-signer/utils.js';
 import '@scure/btc-signer/psbt.js';

package/dist/adapters/expo.d.ts

@@ -1,5 +1,5 @@
-import { l as RestArkProvider, j as SettlementEvent, T as TxNotification, m as RestIndexerProvider, n as SubscriptionResponse } from '../ark-I8jfe5VE.js';
-export { o as ArkProvider, p as IndexerProvider } from '../ark-I8jfe5VE.js';
+import { l as RestArkProvider, j as SettlementEvent, T as TxNotification, m as RestIndexerProvider, n as SubscriptionResponse } from '../ark-C-PjOngm.js';
+export { o as ArkProvider, p as IndexerProvider } from '../ark-C-PjOngm.js';
 import '@scure/btc-signer/transaction.js';
 import '@scure/btc-signer/utils.js';
 import '@scure/btc-signer/psbt.js';

package/dist/adapters/expo.js

@@ -1,5 +1,5 @@
-export { ExpoArkProvider, ExpoIndexerProvider } from '../chunk-VKKLOT2E.js';
-import '../chunk-763XHDAJ.js';
+export { ExpoArkProvider, ExpoIndexerProvider } from '../chunk-BOA4SHCD.js';
+import '../chunk-YBQV7XBC.js';
 import '../chunk-BE5MUB7T.js';
 import '../chunk-NSBPE2FW.js';
 //# sourceMappingURL=expo.js.map

package/dist/adapters/indexedDB.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
-var chunkQGNTDGMN_cjs = require('../chunk-QGNTDGMN.cjs');
-require('../chunk-3AQNLQPM.cjs');
+var chunkSRCWBFSZ_cjs = require('../chunk-SRCWBFSZ.cjs');
+require('../chunk-UHOHLN3C.cjs');
 require('../chunk-32YKLQPS.cjs');
 require('../chunk-HXDZ2QTW.cjs');
 require('../chunk-5BLDMQED.cjs');
@@ -11,7 +11,7 @@ var IndexedDBStorageAdapter = class {
   dbName;
   version;
   db = null;
-  constructor(dbName, version = chunkQGNTDGMN_cjs.DB_VERSION) {
+  constructor(dbName, version = chunkSRCWBFSZ_cjs.DB_VERSION) {
     this.dbName = dbName;
     this.version = version;
   }

package/dist/adapters/indexedDB.js

@@ -1,5 +1,5 @@
-import { DB_VERSION } from '../chunk-B4R36PRN.js';
-import '../chunk-763XHDAJ.js';
+import { DB_VERSION } from '../chunk-TGRJ5WAX.js';
+import '../chunk-YBQV7XBC.js';
 import '../chunk-YNEDJTX2.js';
 import '../chunk-BE5MUB7T.js';
 import '../chunk-NSBPE2FW.js';

package/dist/{ark-I8jfe5VE.d.cts → ark-C-PjOngm.d.cts}

@@ -1836,6 +1836,21 @@ interface ScanContractsOptions {
     /** Read-only context injected into every `discoverAt` call. */
     deps: DiscoveryDeps;
 }
+/**
+ * Freshness of the ContractManager's provider-backed sync. `degraded` means the
+ * most recent sync (boot, best-effort read, or contract hydration) hit a
+ * retryable indexer/operator failure and the manager is serving repository
+ * state; it returns to `online` on the next successful sync. This only
+ * describes sync freshness — never wallet data itself.
+ */
+type ContractSyncState = {
+    mode: "online";
+    lastSyncedAt?: number;
+} | {
+    mode: "degraded";
+    reason: string;
+    lastSyncedAt?: number;
+};
 interface IContractManager extends Disposable {
     /**
      * Create and register a new contract.
@@ -1863,6 +1878,11 @@ interface IContractManager extends Disposable {
      * If no filter is provided, returns all contracts with their virtual outputs.
      */
     getContractsWithVtxos(filter?: GetContractsFilter): Promise<ContractWithVtxos[]>;
+    /**
+     * Latest provider-sync health (online vs. degraded to repository data).
+     * See {@link ContractSyncState}.
+     */
+    getSyncState(): ContractSyncState;
     /**
      * Stamp raw virtual outputs with the correct per-contract tapscripts
      * (forfeit, intent, tap tree).
@@ -2003,6 +2023,18 @@ interface ContractManagerConfig {
      * {@link reconcileIntents}. Absent ⇒ no-op.
      */
     intentRepository?: IntentRepository;
+    /**
+     * Optional exit-data capture hook. Fired best-effort after VTXOs are
+     * persisted so a configured virtualTxRepository can store each one's
+     * unilateral-exit branch. Absent ⇒ no-op.
+     */
+    onVtxosPersisted?: (contract: Contract, vtxos: ExtendedVirtualCoin[]) => Promise<void>;
+    /**
+     * Optional exit-data prune hook. Fired best-effort with the spent outpoints
+     * on `vtxo_spent` so a configured virtualTxRepository can drop their branch.
+     * Absent ⇒ no-op.
+     */
+    onVtxosSpent?: (vtxos: Outpoint[]) => Promise<void>;
     /** Watcher configuration */
     watcherConfig?: Partial<ContractWatcherConfig>;
 }
@@ -2066,6 +2098,10 @@ declare class ContractManager implements IContractManager {
     private initialized;
     private eventCallbacks;
     private stopWatcherFn?;
+    /** `undefined` while online; the failure reason once a sync degrades. */
+    private syncDegradedReason?;
+    /** Epoch-ms of the last successful provider sync, if any. */
+    private lastSyncedAt?;
     private constructor();
     /**
      * Static factory method for creating a new ContractManager.
@@ -2077,6 +2113,15 @@ declare class ContractManager implements IContractManager {
      * @param config ContractManagerConfig
      */
     static create(config: ContractManagerConfig): Promise<ContractManager>;
+    /**
+     * Latest provider-sync health. See {@link ContractSyncState}. Degradation is
+     * recorded by {@link initialize}, {@link getContractsWithVtxos}, and
+     * {@link createContract}; it flips back to `online` on the next successful
+     * sync. Purely a freshness signal — not a source of truth for wallet data.
+     */
+    getSyncState(): ContractSyncState;
+    private markSyncOnline;
+    private markSyncDegraded;
     private initialize;
     /**
      * Delta-sync the full watched set and reconcile the pending frontier.
@@ -3134,6 +3179,36 @@ declare function boardingResolver(): ActivityResolver;
 /** Default registry with SDK built-ins. */
 declare function createDefaultActivityRegistry(): ActivityRegistry;
 
+/**
+ * A source of unilateral-exit chain data for a set of VTXOs. Sources are tried
+ * in order by the resolver; a source returns `null` (chain) or omits keys (psbts)
+ * for data it cannot supply — a "miss" — and the resolver falls through.
+ */
+interface ExitDataSource {
+    readonly name: string;
+    /** Full ancestry chain for a vtxo (all pages merged), or null on a miss. */
+    getVtxoChain(vtxo: Outpoint): Promise<ChainTx[] | null>;
+    /** Base64 PSBTs this source has, keyed by (unsigned) txid. Absent key = miss. */
+    getVirtualTxs(txids: string[]): Promise<Map<string, string>>;
+}
+/** Reads exit chain data through an ordered chain of sources. */
+interface ExitChainResolver {
+    getVtxoChain(vtxo: Outpoint): Promise<ChainTx[]>;
+    getVirtualTxs(txids: string[]): Promise<string[]>;
+}
+/**
+ * Assemble the standard exit-data resolver: local repo (if configured) → any
+ * extra sources (e.g. a future provider) → indexer. Read-through persists to the
+ * repository. With no repository this is exactly the indexer path (a no-op seam).
+ */
+declare function createExitChainResolver(params: {
+    indexer: IndexerProvider;
+    repository?: VirtualTxRepository;
+    extraSources?: ExitDataSource[];
+}): ExitChainResolver;
+
+type ExitCaptureMode = "lite" | "full";
+
 /**
  * Wallet receive-address strategy.
  *
@@ -3346,6 +3421,19 @@ type StorageConfig = {
      * option as experimental until those paths land. Absent ⇒ no-op.
      */
     virtualTxRepository?: VirtualTxRepository;
+    /**
+     * Optional exit-data capture settings (only in effect when
+     * `virtualTxRepository` is set). `mode` "lite" (default) stores structure
+     * only; "full" stores PSBTs so a unilateral exit needs no Ark indexer.
+     * `minExitWorthSats` (default 1000) skips dust. `sources` are extra
+     * `ExitDataSource`s (e.g. a wallet-provider) tried before the indexer for
+     * both capture and exit reads.
+     */
+    exitDataCapture?: {
+        mode?: ExitCaptureMode;
+        minExitWorthSats?: number;
+        sources?: ExitDataSource[];
+    };
 };
 /**
  * Provider class constructor interface for dependency injection.
@@ -4694,4 +4782,4 @@ declare namespace ProtoTypes {
     export {  };
 }
 
-export { ContractManager as $, type ArkTransaction as A, type BatchStartedEvent as B, type ContractRepository as C, type TreeTxEvent as D, type ExtendedVirtualCoin as E, type TreeSignatureEvent as F, type GetVtxosFilter as G, type DescriptorProvider as H, type IWallet as I, type IReadonlyWallet as J, type ReadonlyIdentity as K, type DelegateProvider as L, type ReadonlyWalletConfig as M, type Network as N, type OnchainProvider as O, type IntentRepository as P, type VirtualTxRepository as Q, type Recipient as R, type SendBitcoinParams as S, type TxNotification as T, type IReadonlyAssetManager as U, VtxoScript as V, type WalletRepository as W, type NetworkName as X, type ArkInfo as Y, ArkAddress as Z, type Coin as _, type Identity as a, type ContractEventCallback as a$, CSVMultisigTapscript as a0, type SettlementConfig as a1, VtxoManager as a2, type SignerSession as a3, type SignedIntent as a4, Intent as a5, type VtxoRepositoryKey as a6, type WalletState as a7, type ContractFilter as a8, type ArkIntent as a9, type IssuanceResult as aA, type DelegateInfo as aB, type MigrationGlobalSkipReason as aC, type MigrationLegSkipReason as aD, type SignerStatus as aE, type StorageConfig as aF, type IVtxoManager as aG, type ExplorerTransaction as aH, type EncodedVtxoScript as aI, type Status as aJ, type ChainTx as aK, type PathContext as aL, type ActivityIntent as aM, type ActivityResolver as aN, type ArkIntentState as aO, type ArkTapscript as aP, type Asset as aQ, type AssetMetadata as aR, type BaseWalletConfig as aS, type BatchInfo as aT, type BatchSignableIdentity as aU, CLTVMultisigTapscript as aV, ChainTxType as aW, type CommitmentTx as aX, ConditionCSVMultisigTapscript as aY, ConditionMultisigTapscript as aZ, type ContractBalance as a_, type IntentFilter as aa, type Outpoint as ab, type VirtualTx as ac, type VtxoBranch as ad, ChainedTxType as ae, type DescriptorSigningRequest as af, Transaction as ag, type IntentFeeConfig as ah, type OffchainInput as ai, FeeAmount as aj, type OnchainInput as ak, type FeeOutput as al, type ContractWatcherConfig as am, type FeeInfo as an, type CreateContractParams as ao, type GetContractsFilter as ap, type GetSpendablePathsOptions as aq, type GetAllSpendingPathsOptions as ar, type IssuanceParams as as, type ReissuanceParams as at, type BurnParams as au, type RenewVtxosOptions as av, type ContractWithVtxos as aw, type PathSelection as ax, type ContractEvent as ay, type AssetDetails as az, type WalletConfig as b, createDefaultActivityRegistry as b$, type ContractHandler as b0, type ContractManagerConfig as b1, type ContractState as b2, type ContractVtxo as b3, ContractWatcher as b4, DelegateManagerImpl as b5, type DelegateOptions as b6, DelegatorManagerImpl as b7, type DelegatorProvider as b8, type DeprecatedSignerMigrationReport as b9, type ScanContractsOptions as bA, type ScanResult as bB, type ScheduledSession as bC, SettlementEventType as bD, type SignRequest as bE, type SignerClassification as bF, type SignerSet as bG, type SubscriptionEvent as bH, type SubscriptionHeartbeat as bI, type TapLeaves as bJ, TapTreeCoder as bK, TapscriptType as bL, type TreeNonces as bM, type TreePartialSigs as bN, type Tx as bO, type TxHistoryRecord as bP, type TxKey as bQ, type TxTreeNode as bR, TxType as bS, type VirtualStatus as bT, type Vtxo as bU, type VtxoChain as bV, type VtxoType as bW, type WalletMode as bX, boardingResolver as bY, classifyAgainstSignerSet as bZ, classifyContractSigner as b_, type DeprecatedSignerReport as ba, DigestMismatchError as bb, type Discoverable as bc, type DiscoveredContract as bd, type DiscoveryDeps as be, ESPLORA_URL as bf, EsploraProvider as bg, type ExtendedContractVtxo as bh, type GroupMembership as bi, type HandlerError as bj, type IDelegatorManager as bk, INTENT_TERMINAL_STATES as bl, IndexerTxType as bm, type KnownMetadata as bn, type MigrateDeprecatedSignerOptions as bo, type MigrationLegReport as bp, type MigrationVtxoRef as bq, MultisigTapscript as br, type Nonces as bs, type Output as bt, type PageResponse as bu, type PaginationOptions as bv, PartialSig as bw, type ProviderClass as bx, RestDelegateProvider as by, RestDelegatorProvider as bz, type WalletBalance as c, decodeTapscript as c0, getNetwork as c1, getSequence as c2, isBatchSignable as c3, isCooperativelyMigratable as c4, isDiscoverable as c5, isExpired as c6, isRecoverable as c7, isSpendable as c8, isSubdust as c9, isTerminalIntentState as ca, isVtxoExpiringSoon as cb, networks as cc, signerSetFromInfo as cd, toXOnlySignerHex as ce, type ExtendedCoin as d, ActivityRegistry as e, type Activity as f, type IContractManager as g, type IDelegateManager as h, type SettleParams as i, type SettlementEvent as j, type IAssetManager as k, RestArkProvider as l, RestIndexerProvider as m, type SubscriptionResponse as n, type ArkProvider as o, type IndexerProvider as p, type RelativeTimelock as q, type TapLeafScript as r, type VirtualCoin as s, type Contract as t, type TreeSigningStartedEvent as u, TxTree as v, type TreeNoncesEvent as w, type BatchFinalizationEvent as x, type BatchFinalizedEvent as y, type BatchFailedEvent as z };
+export { type ArkInfo as $, type ArkTransaction as A, type BatchStartedEvent as B, type ContractRepository as C, type TreeTxEvent as D, type ExtendedVirtualCoin as E, type TreeSignatureEvent as F, type GetVtxosFilter as G, type DescriptorProvider as H, type IWallet as I, type IReadonlyWallet as J, type ReadonlyIdentity as K, type DelegateProvider as L, type ReadonlyWalletConfig as M, type Network as N, type OnchainProvider as O, type IntentRepository as P, type VirtualTxRepository as Q, type Recipient as R, type SendBitcoinParams as S, type TxNotification as T, type ExitCaptureMode as U, VtxoScript as V, type WalletRepository as W, type ExitDataSource as X, type IReadonlyAssetManager as Y, type ContractSyncState as Z, type NetworkName as _, type Identity as a, ConditionCSVMultisigTapscript as a$, ArkAddress as a0, type Coin as a1, ContractManager as a2, CSVMultisigTapscript as a3, type SettlementConfig as a4, VtxoManager as a5, type SignerSession as a6, type SignedIntent as a7, Intent as a8, type VtxoRepositoryKey as a9, type PathSelection as aA, type ContractEvent as aB, type AssetDetails as aC, type IssuanceResult as aD, type DelegateInfo as aE, type MigrationGlobalSkipReason as aF, type MigrationLegSkipReason as aG, type SignerStatus as aH, type StorageConfig as aI, type IVtxoManager as aJ, type ExplorerTransaction as aK, type EncodedVtxoScript as aL, type Status as aM, type ChainTx as aN, type PathContext as aO, type ActivityIntent as aP, type ActivityResolver as aQ, type ArkIntentState as aR, type ArkTapscript as aS, type Asset as aT, type AssetMetadata as aU, type BaseWalletConfig as aV, type BatchInfo as aW, type BatchSignableIdentity as aX, CLTVMultisigTapscript as aY, ChainTxType as aZ, type CommitmentTx as a_, type WalletState as aa, type ContractFilter as ab, type ArkIntent as ac, type IntentFilter as ad, type Outpoint as ae, type VirtualTx as af, type VtxoBranch as ag, ChainedTxType as ah, type DescriptorSigningRequest as ai, Transaction as aj, type IntentFeeConfig as ak, type OffchainInput as al, FeeAmount as am, type OnchainInput as an, type FeeOutput as ao, type ContractWatcherConfig as ap, type FeeInfo as aq, type CreateContractParams as ar, type GetContractsFilter as as, type GetSpendablePathsOptions as at, type GetAllSpendingPathsOptions as au, type IssuanceParams as av, type ReissuanceParams as aw, type BurnParams as ax, type RenewVtxosOptions as ay, type ContractWithVtxos as az, type WalletConfig as b, type WalletMode as b$, ConditionMultisigTapscript as b0, type ContractBalance as b1, type ContractEventCallback as b2, type ContractHandler as b3, type ContractManagerConfig as b4, type ContractState as b5, type ContractVtxo as b6, ContractWatcher as b7, DelegateManagerImpl as b8, type DelegateOptions as b9, PartialSig as bA, type ProviderClass as bB, RestDelegateProvider as bC, RestDelegatorProvider as bD, type ScanContractsOptions as bE, type ScanResult as bF, type ScheduledSession as bG, SettlementEventType as bH, type SignRequest as bI, type SignerClassification as bJ, type SignerSet as bK, type SubscriptionEvent as bL, type SubscriptionHeartbeat as bM, type TapLeaves as bN, TapTreeCoder as bO, TapscriptType as bP, type TreeNonces as bQ, type TreePartialSigs as bR, type Tx as bS, type TxHistoryRecord as bT, type TxKey as bU, type TxTreeNode as bV, TxType as bW, type VirtualStatus as bX, type Vtxo as bY, type VtxoChain as bZ, type VtxoType as b_, DelegatorManagerImpl as ba, type DelegatorProvider as bb, type DeprecatedSignerMigrationReport as bc, type DeprecatedSignerReport as bd, DigestMismatchError as be, type Discoverable as bf, type DiscoveredContract as bg, type DiscoveryDeps as bh, ESPLORA_URL as bi, EsploraProvider as bj, type ExitChainResolver as bk, type ExtendedContractVtxo as bl, type GroupMembership as bm, type HandlerError as bn, type IDelegatorManager as bo, INTENT_TERMINAL_STATES as bp, IndexerTxType as bq, type KnownMetadata as br, type MigrateDeprecatedSignerOptions as bs, type MigrationLegReport as bt, type MigrationVtxoRef as bu, MultisigTapscript as bv, type Nonces as bw, type Output as bx, type PageResponse as by, type PaginationOptions as bz, type WalletBalance as c, boardingResolver as c0, classifyAgainstSignerSet as c1, classifyContractSigner as c2, createDefaultActivityRegistry as c3, createExitChainResolver as c4, decodeTapscript as c5, getNetwork as c6, getSequence as c7, isBatchSignable as c8, isCooperativelyMigratable as c9, isDiscoverable as ca, isExpired as cb, isRecoverable as cc, isSpendable as cd, isSubdust as ce, isTerminalIntentState as cf, isVtxoExpiringSoon as cg, networks as ch, signerSetFromInfo as ci, toXOnlySignerHex as cj, type ExtendedCoin as d, ActivityRegistry as e, type Activity as f, type IContractManager as g, type IDelegateManager as h, type SettleParams as i, type SettlementEvent as j, type IAssetManager as k, RestArkProvider as l, RestIndexerProvider as m, type SubscriptionResponse as n, type ArkProvider as o, type IndexerProvider as p, type RelativeTimelock as q, type TapLeafScript as r, type VirtualCoin as s, type Contract as t, type TreeSigningStartedEvent as u, TxTree as v, type TreeNoncesEvent as w, type BatchFinalizationEvent as x, type BatchFinalizedEvent as y, type BatchFailedEvent as z };

package/dist/{ark-I8jfe5VE.d.ts → ark-C-PjOngm.d.ts}

@@ -1836,6 +1836,21 @@ interface ScanContractsOptions {
     /** Read-only context injected into every `discoverAt` call. */
     deps: DiscoveryDeps;
 }
+/**
+ * Freshness of the ContractManager's provider-backed sync. `degraded` means the
+ * most recent sync (boot, best-effort read, or contract hydration) hit a
+ * retryable indexer/operator failure and the manager is serving repository
+ * state; it returns to `online` on the next successful sync. This only
+ * describes sync freshness — never wallet data itself.
+ */
+type ContractSyncState = {
+    mode: "online";
+    lastSyncedAt?: number;
+} | {
+    mode: "degraded";
+    reason: string;
+    lastSyncedAt?: number;
+};
 interface IContractManager extends Disposable {
     /**
      * Create and register a new contract.
@@ -1863,6 +1878,11 @@ interface IContractManager extends Disposable {
      * If no filter is provided, returns all contracts with their virtual outputs.
      */
     getContractsWithVtxos(filter?: GetContractsFilter): Promise<ContractWithVtxos[]>;
+    /**
+     * Latest provider-sync health (online vs. degraded to repository data).
+     * See {@link ContractSyncState}.
+     */
+    getSyncState(): ContractSyncState;
     /**
      * Stamp raw virtual outputs with the correct per-contract tapscripts
      * (forfeit, intent, tap tree).
@@ -2003,6 +2023,18 @@ interface ContractManagerConfig {
      * {@link reconcileIntents}. Absent ⇒ no-op.
      */
     intentRepository?: IntentRepository;
+    /**
+     * Optional exit-data capture hook. Fired best-effort after VTXOs are
+     * persisted so a configured virtualTxRepository can store each one's
+     * unilateral-exit branch. Absent ⇒ no-op.
+     */
+    onVtxosPersisted?: (contract: Contract, vtxos: ExtendedVirtualCoin[]) => Promise<void>;
+    /**
+     * Optional exit-data prune hook. Fired best-effort with the spent outpoints
+     * on `vtxo_spent` so a configured virtualTxRepository can drop their branch.
+     * Absent ⇒ no-op.
+     */
+    onVtxosSpent?: (vtxos: Outpoint[]) => Promise<void>;
     /** Watcher configuration */
     watcherConfig?: Partial<ContractWatcherConfig>;
 }
@@ -2066,6 +2098,10 @@ declare class ContractManager implements IContractManager {
     private initialized;
     private eventCallbacks;
     private stopWatcherFn?;
+    /** `undefined` while online; the failure reason once a sync degrades. */
+    private syncDegradedReason?;
+    /** Epoch-ms of the last successful provider sync, if any. */
+    private lastSyncedAt?;
     private constructor();
     /**
      * Static factory method for creating a new ContractManager.
@@ -2077,6 +2113,15 @@ declare class ContractManager implements IContractManager {
      * @param config ContractManagerConfig
      */
     static create(config: ContractManagerConfig): Promise<ContractManager>;
+    /**
+     * Latest provider-sync health. See {@link ContractSyncState}. Degradation is
+     * recorded by {@link initialize}, {@link getContractsWithVtxos}, and
+     * {@link createContract}; it flips back to `online` on the next successful
+     * sync. Purely a freshness signal — not a source of truth for wallet data.
+     */
+    getSyncState(): ContractSyncState;
+    private markSyncOnline;
+    private markSyncDegraded;
     private initialize;
     /**
      * Delta-sync the full watched set and reconcile the pending frontier.
@@ -3134,6 +3179,36 @@ declare function boardingResolver(): ActivityResolver;
 /** Default registry with SDK built-ins. */
 declare function createDefaultActivityRegistry(): ActivityRegistry;
 
+/**
+ * A source of unilateral-exit chain data for a set of VTXOs. Sources are tried
+ * in order by the resolver; a source returns `null` (chain) or omits keys (psbts)
+ * for data it cannot supply — a "miss" — and the resolver falls through.
+ */
+interface ExitDataSource {
+    readonly name: string;
+    /** Full ancestry chain for a vtxo (all pages merged), or null on a miss. */
+    getVtxoChain(vtxo: Outpoint): Promise<ChainTx[] | null>;
+    /** Base64 PSBTs this source has, keyed by (unsigned) txid. Absent key = miss. */
+    getVirtualTxs(txids: string[]): Promise<Map<string, string>>;
+}
+/** Reads exit chain data through an ordered chain of sources. */
+interface ExitChainResolver {
+    getVtxoChain(vtxo: Outpoint): Promise<ChainTx[]>;
+    getVirtualTxs(txids: string[]): Promise<string[]>;
+}
+/**
+ * Assemble the standard exit-data resolver: local repo (if configured) → any
+ * extra sources (e.g. a future provider) → indexer. Read-through persists to the
+ * repository. With no repository this is exactly the indexer path (a no-op seam).
+ */
+declare function createExitChainResolver(params: {
+    indexer: IndexerProvider;
+    repository?: VirtualTxRepository;
+    extraSources?: ExitDataSource[];
+}): ExitChainResolver;
+
+type ExitCaptureMode = "lite" | "full";
+
 /**
  * Wallet receive-address strategy.
  *
@@ -3346,6 +3421,19 @@ type StorageConfig = {
      * option as experimental until those paths land. Absent ⇒ no-op.
      */
     virtualTxRepository?: VirtualTxRepository;
+    /**
+     * Optional exit-data capture settings (only in effect when
+     * `virtualTxRepository` is set). `mode` "lite" (default) stores structure
+     * only; "full" stores PSBTs so a unilateral exit needs no Ark indexer.
+     * `minExitWorthSats` (default 1000) skips dust. `sources` are extra
+     * `ExitDataSource`s (e.g. a wallet-provider) tried before the indexer for
+     * both capture and exit reads.
+     */
+    exitDataCapture?: {
+        mode?: ExitCaptureMode;
+        minExitWorthSats?: number;
+        sources?: ExitDataSource[];
+    };
 };
 /**
  * Provider class constructor interface for dependency injection.
@@ -4694,4 +4782,4 @@ declare namespace ProtoTypes {
     export {  };
 }
 
-export { ContractManager as $, type ArkTransaction as A, type BatchStartedEvent as B, type ContractRepository as C, type TreeTxEvent as D, type ExtendedVirtualCoin as E, type TreeSignatureEvent as F, type GetVtxosFilter as G, type DescriptorProvider as H, type IWallet as I, type IReadonlyWallet as J, type ReadonlyIdentity as K, type DelegateProvider as L, type ReadonlyWalletConfig as M, type Network as N, type OnchainProvider as O, type IntentRepository as P, type VirtualTxRepository as Q, type Recipient as R, type SendBitcoinParams as S, type TxNotification as T, type IReadonlyAssetManager as U, VtxoScript as V, type WalletRepository as W, type NetworkName as X, type ArkInfo as Y, ArkAddress as Z, type Coin as _, type Identity as a, type ContractEventCallback as a$, CSVMultisigTapscript as a0, type SettlementConfig as a1, VtxoManager as a2, type SignerSession as a3, type SignedIntent as a4, Intent as a5, type VtxoRepositoryKey as a6, type WalletState as a7, type ContractFilter as a8, type ArkIntent as a9, type IssuanceResult as aA, type DelegateInfo as aB, type MigrationGlobalSkipReason as aC, type MigrationLegSkipReason as aD, type SignerStatus as aE, type StorageConfig as aF, type IVtxoManager as aG, type ExplorerTransaction as aH, type EncodedVtxoScript as aI, type Status as aJ, type ChainTx as aK, type PathContext as aL, type ActivityIntent as aM, type ActivityResolver as aN, type ArkIntentState as aO, type ArkTapscript as aP, type Asset as aQ, type AssetMetadata as aR, type BaseWalletConfig as aS, type BatchInfo as aT, type BatchSignableIdentity as aU, CLTVMultisigTapscript as aV, ChainTxType as aW, type CommitmentTx as aX, ConditionCSVMultisigTapscript as aY, ConditionMultisigTapscript as aZ, type ContractBalance as a_, type IntentFilter as aa, type Outpoint as ab, type VirtualTx as ac, type VtxoBranch as ad, ChainedTxType as ae, type DescriptorSigningRequest as af, Transaction as ag, type IntentFeeConfig as ah, type OffchainInput as ai, FeeAmount as aj, type OnchainInput as ak, type FeeOutput as al, type ContractWatcherConfig as am, type FeeInfo as an, type CreateContractParams as ao, type GetContractsFilter as ap, type GetSpendablePathsOptions as aq, type GetAllSpendingPathsOptions as ar, type IssuanceParams as as, type ReissuanceParams as at, type BurnParams as au, type RenewVtxosOptions as av, type ContractWithVtxos as aw, type PathSelection as ax, type ContractEvent as ay, type AssetDetails as az, type WalletConfig as b, createDefaultActivityRegistry as b$, type ContractHandler as b0, type ContractManagerConfig as b1, type ContractState as b2, type ContractVtxo as b3, ContractWatcher as b4, DelegateManagerImpl as b5, type DelegateOptions as b6, DelegatorManagerImpl as b7, type DelegatorProvider as b8, type DeprecatedSignerMigrationReport as b9, type ScanContractsOptions as bA, type ScanResult as bB, type ScheduledSession as bC, SettlementEventType as bD, type SignRequest as bE, type SignerClassification as bF, type SignerSet as bG, type SubscriptionEvent as bH, type SubscriptionHeartbeat as bI, type TapLeaves as bJ, TapTreeCoder as bK, TapscriptType as bL, type TreeNonces as bM, type TreePartialSigs as bN, type Tx as bO, type TxHistoryRecord as bP, type TxKey as bQ, type TxTreeNode as bR, TxType as bS, type VirtualStatus as bT, type Vtxo as bU, type VtxoChain as bV, type VtxoType as bW, type WalletMode as bX, boardingResolver as bY, classifyAgainstSignerSet as bZ, classifyContractSigner as b_, type DeprecatedSignerReport as ba, DigestMismatchError as bb, type Discoverable as bc, type DiscoveredContract as bd, type DiscoveryDeps as be, ESPLORA_URL as bf, EsploraProvider as bg, type ExtendedContractVtxo as bh, type GroupMembership as bi, type HandlerError as bj, type IDelegatorManager as bk, INTENT_TERMINAL_STATES as bl, IndexerTxType as bm, type KnownMetadata as bn, type MigrateDeprecatedSignerOptions as bo, type MigrationLegReport as bp, type MigrationVtxoRef as bq, MultisigTapscript as br, type Nonces as bs, type Output as bt, type PageResponse as bu, type PaginationOptions as bv, PartialSig as bw, type ProviderClass as bx, RestDelegateProvider as by, RestDelegatorProvider as bz, type WalletBalance as c, decodeTapscript as c0, getNetwork as c1, getSequence as c2, isBatchSignable as c3, isCooperativelyMigratable as c4, isDiscoverable as c5, isExpired as c6, isRecoverable as c7, isSpendable as c8, isSubdust as c9, isTerminalIntentState as ca, isVtxoExpiringSoon as cb, networks as cc, signerSetFromInfo as cd, toXOnlySignerHex as ce, type ExtendedCoin as d, ActivityRegistry as e, type Activity as f, type IContractManager as g, type IDelegateManager as h, type SettleParams as i, type SettlementEvent as j, type IAssetManager as k, RestArkProvider as l, RestIndexerProvider as m, type SubscriptionResponse as n, type ArkProvider as o, type IndexerProvider as p, type RelativeTimelock as q, type TapLeafScript as r, type VirtualCoin as s, type Contract as t, type TreeSigningStartedEvent as u, TxTree as v, type TreeNoncesEvent as w, type BatchFinalizationEvent as x, type BatchFinalizedEvent as y, type BatchFailedEvent as z };
+export { type ArkInfo as $, type ArkTransaction as A, type BatchStartedEvent as B, type ContractRepository as C, type TreeTxEvent as D, type ExtendedVirtualCoin as E, type TreeSignatureEvent as F, type GetVtxosFilter as G, type DescriptorProvider as H, type IWallet as I, type IReadonlyWallet as J, type ReadonlyIdentity as K, type DelegateProvider as L, type ReadonlyWalletConfig as M, type Network as N, type OnchainProvider as O, type IntentRepository as P, type VirtualTxRepository as Q, type Recipient as R, type SendBitcoinParams as S, type TxNotification as T, type ExitCaptureMode as U, VtxoScript as V, type WalletRepository as W, type ExitDataSource as X, type IReadonlyAssetManager as Y, type ContractSyncState as Z, type NetworkName as _, type Identity as a, ConditionCSVMultisigTapscript as a$, ArkAddress as a0, type Coin as a1, ContractManager as a2, CSVMultisigTapscript as a3, type SettlementConfig as a4, VtxoManager as a5, type SignerSession as a6, type SignedIntent as a7, Intent as a8, type VtxoRepositoryKey as a9, type PathSelection as aA, type ContractEvent as aB, type AssetDetails as aC, type IssuanceResult as aD, type DelegateInfo as aE, type MigrationGlobalSkipReason as aF, type MigrationLegSkipReason as aG, type SignerStatus as aH, type StorageConfig as aI, type IVtxoManager as aJ, type ExplorerTransaction as aK, type EncodedVtxoScript as aL, type Status as aM, type ChainTx as aN, type PathContext as aO, type ActivityIntent as aP, type ActivityResolver as aQ, type ArkIntentState as aR, type ArkTapscript as aS, type Asset as aT, type AssetMetadata as aU, type BaseWalletConfig as aV, type BatchInfo as aW, type BatchSignableIdentity as aX, CLTVMultisigTapscript as aY, ChainTxType as aZ, type CommitmentTx as a_, type WalletState as aa, type ContractFilter as ab, type ArkIntent as ac, type IntentFilter as ad, type Outpoint as ae, type VirtualTx as af, type VtxoBranch as ag, ChainedTxType as ah, type DescriptorSigningRequest as ai, Transaction as aj, type IntentFeeConfig as ak, type OffchainInput as al, FeeAmount as am, type OnchainInput as an, type FeeOutput as ao, type ContractWatcherConfig as ap, type FeeInfo as aq, type CreateContractParams as ar, type GetContractsFilter as as, type GetSpendablePathsOptions as at, type GetAllSpendingPathsOptions as au, type IssuanceParams as av, type ReissuanceParams as aw, type BurnParams as ax, type RenewVtxosOptions as ay, type ContractWithVtxos as az, type WalletConfig as b, type WalletMode as b$, ConditionMultisigTapscript as b0, type ContractBalance as b1, type ContractEventCallback as b2, type ContractHandler as b3, type ContractManagerConfig as b4, type ContractState as b5, type ContractVtxo as b6, ContractWatcher as b7, DelegateManagerImpl as b8, type DelegateOptions as b9, PartialSig as bA, type ProviderClass as bB, RestDelegateProvider as bC, RestDelegatorProvider as bD, type ScanContractsOptions as bE, type ScanResult as bF, type ScheduledSession as bG, SettlementEventType as bH, type SignRequest as bI, type SignerClassification as bJ, type SignerSet as bK, type SubscriptionEvent as bL, type SubscriptionHeartbeat as bM, type TapLeaves as bN, TapTreeCoder as bO, TapscriptType as bP, type TreeNonces as bQ, type TreePartialSigs as bR, type Tx as bS, type TxHistoryRecord as bT, type TxKey as bU, type TxTreeNode as bV, TxType as bW, type VirtualStatus as bX, type Vtxo as bY, type VtxoChain as bZ, type VtxoType as b_, DelegatorManagerImpl as ba, type DelegatorProvider as bb, type DeprecatedSignerMigrationReport as bc, type DeprecatedSignerReport as bd, DigestMismatchError as be, type Discoverable as bf, type DiscoveredContract as bg, type DiscoveryDeps as bh, ESPLORA_URL as bi, EsploraProvider as bj, type ExitChainResolver as bk, type ExtendedContractVtxo as bl, type GroupMembership as bm, type HandlerError as bn, type IDelegatorManager as bo, INTENT_TERMINAL_STATES as bp, IndexerTxType as bq, type KnownMetadata as br, type MigrateDeprecatedSignerOptions as bs, type MigrationLegReport as bt, type MigrationVtxoRef as bu, MultisigTapscript as bv, type Nonces as bw, type Output as bx, type PageResponse as by, type PaginationOptions as bz, type WalletBalance as c, boardingResolver as c0, classifyAgainstSignerSet as c1, classifyContractSigner as c2, createDefaultActivityRegistry as c3, createExitChainResolver as c4, decodeTapscript as c5, getNetwork as c6, getSequence as c7, isBatchSignable as c8, isCooperativelyMigratable as c9, isDiscoverable as ca, isExpired as cb, isRecoverable as cc, isSpendable as cd, isSubdust as ce, isTerminalIntentState as cf, isVtxoExpiringSoon as cg, networks as ch, signerSetFromInfo as ci, toXOnlySignerHex as cj, type ExtendedCoin as d, ActivityRegistry as e, type Activity as f, type IContractManager as g, type IDelegateManager as h, type SettleParams as i, type SettlementEvent as j, type IAssetManager as k, RestArkProvider as l, RestIndexerProvider as m, type SubscriptionResponse as n, type ArkProvider as o, type IndexerProvider as p, type RelativeTimelock as q, type TapLeafScript as r, type VirtualCoin as s, type Contract as t, type TreeSigningStartedEvent as u, TxTree as v, type TreeNoncesEvent as w, type BatchFinalizationEvent as x, type BatchFinalizedEvent as y, type BatchFailedEvent as z };

package/dist/{asyncStorageTaskQueue-D1FfHfgK.d.cts → asyncStorageTaskQueue-BmBPvTyh.d.cts}

@@ -1,4 +1,4 @@
-import { a as TaskQueue, c as TaskItem, d as TaskResult } from './taskRunner-BSnslNmq.cjs';
+import { a as TaskQueue, c as TaskItem, d as TaskResult } from './taskRunner-DOiyRuJa.cjs';
 
 /**
  * Minimal async key-value storage interface.

package/dist/{asyncStorageTaskQueue-CjoL-35w.d.ts → asyncStorageTaskQueue-CHpI3moJ.d.ts}

@@ -1,4 +1,4 @@
-import { a as TaskQueue, c as TaskItem, d as TaskResult } from './taskRunner-Djlhfgi1.js';
+import { a as TaskQueue, c as TaskItem, d as TaskResult } from './taskRunner-BngWSFMi.js';
 
 /**
  * Minimal async key-value storage interface.

package/dist/{chunk-VKKLOT2E.js → chunk-BOA4SHCD.js}

@@ -1,4 +1,4 @@
-import { RestArkProvider, isFetchTimeoutError, RestIndexerProvider, buildVersion, sdkVersion, fetch } from './chunk-763XHDAJ.js';
+import { RestArkProvider, isFetchTimeoutError, RestIndexerProvider, buildVersion, sdkVersion, fetch } from './chunk-YBQV7XBC.js';
 import { DEFAULT_ARKADE_SERVER_URL } from './chunk-BE5MUB7T.js';
 
 // src/providers/expoUtils.ts
@@ -212,5 +212,5 @@ var ExpoIndexerProvider = class extends RestIndexerProvider {
 };
 
 export { ExpoArkProvider, ExpoIndexerProvider };
-//# sourceMappingURL=chunk-VKKLOT2E.js.map
-//# sourceMappingURL=chunk-VKKLOT2E.js.map
+//# sourceMappingURL=chunk-BOA4SHCD.js.map
+//# sourceMappingURL=chunk-BOA4SHCD.js.map