@arkade-os/sdk 0.4.42 → 0.4.44

package/dist/index.d.ts

@@ -1,9 +1,9 @@
-import { K as ReadonlyIdentity, a as Identity, a7 as DescriptorSigningRequest, a8 as Transaction, a1 as SignerSession, W as WalletRepository, E as ExtendedVirtualCoin, a4 as VtxoRepositoryKey, d as ExtendedCoin, A as ArkTransaction, a5 as WalletState, t as Contract, C as ContractRepository, a6 as ContractFilter, a9 as IntentFeeConfig, aa as OffchainInput, ab as FeeAmount, ac as OnchainInput, ad as FeeOutput, o as ArkProvider, $ as SettlementConfig, ae as ContractWatcherConfig, I as IWallet, af as FeeInfo, j as SettlementEvent, H as DescriptorProvider, i as SettleParams, S as SendBitcoinParams, G as GetVtxosFilter, ag as CreateContractParams, ah as GetContractsFilter, s as VirtualCoin, ai as GetSpendablePathsOptions, aj as GetAllSpendingPathsOptions, R as Recipient, ak as IssuanceParams, al as ReissuanceParams, am as BurnParams, an as RenewVtxosOptions, c as WalletBalance, ao as ContractWithVtxos, ap as PathSelection, aq as ContractEvent, ar as AssetDetails, as as IssuanceResult, at as DelegateInfo, au as MigrationGlobalSkipReason, av as MigrationLegSkipReason, aw as SignerStatus, J as IReadonlyWallet, e as ActivityRegistry, P as IReadonlyAssetManager, ax as StorageConfig, f as Activity, g as IContractManager, k as IAssetManager, h as IDelegateManager, ay as IVtxoManager, O as OnchainProvider, N as Network, Q as NetworkName, Y as Coin, az as ExplorerTransaction, r as TapLeafScript, aA as EncodedVtxoScript, _ as CSVMultisigTapscript, q as RelativeTimelock, V as VtxoScript, aB as Status, aC as Outpoint, aD as ChainTx, p as IndexerProvider, v as TxTree, aE as PathContext } from './ark-CKDWpuGL.js';
-export { aF as ActivityIntent, aG as ActivityResolver, X as ArkAddress, U as ArkInfo, aH as ArkTapscript, aI as Asset, aJ as AssetMetadata, aK as BaseWalletConfig, z as BatchFailedEvent, x as BatchFinalizationEvent, y as BatchFinalizedEvent, aL as BatchInfo, aM as BatchSignableIdentity, B as BatchStartedEvent, aN as CLTVMultisigTapscript, aO as ChainTxType, aP as CommitmentTx, aQ as ConditionCSVMultisigTapscript, aR as ConditionMultisigTapscript, aS as ContractBalance, aT as ContractEventCallback, aU as ContractHandler, Z as ContractManager, aV as ContractManagerConfig, aW as ContractState, aX as ContractVtxo, aY as ContractWatcher, aZ as DelegateManagerImpl, a_ as DelegateOptions, L as DelegateProvider, a$ as DelegatorManagerImpl, b0 as DelegatorProvider, b1 as DeprecatedSignerMigrationReport, b2 as DeprecatedSignerReport, b3 as DigestMismatchError, b4 as Discoverable, b5 as DiscoveredContract, b6 as DiscoveryDeps, b7 as ESPLORA_URL, b8 as EsploraProvider, b9 as ExtendedContractVtxo, ba as GroupMembership, bb as HandlerError, bc as IDelegatorManager, bd as IndexerTxType, a3 as Intent, be as KnownMetadata, bf as MigrateDeprecatedSignerOptions, bg as MigrationLegReport, bh as MigrationVtxoRef, bi as MultisigTapscript, bj as Nonces, bk as Output, bl as PageResponse, bm as PaginationOptions, bn as PartialSig, bo as ProviderClass, M as ReadonlyWalletConfig, l as RestArkProvider, bp as RestDelegateProvider, bq as RestDelegatorProvider, m as RestIndexerProvider, br as ScanContractsOptions, bs as ScanResult, bt as ScheduledSession, bu as SettlementEventType, bv as SignRequest, a2 as SignedIntent, bw as SignerClassification, bx as SignerSet, by as SubscriptionEvent, bz as SubscriptionHeartbeat, n as SubscriptionResponse, bA as TapLeaves, bB as TapTreeCoder, bC as TapscriptType, bD as TreeNonces, w as TreeNoncesEvent, bE as TreePartialSigs, F as TreeSignatureEvent, u as TreeSigningStartedEvent, D as TreeTxEvent, bF as Tx, bG as TxHistoryRecord, bH as TxKey, T as TxNotification, bI as TxTreeNode, bJ as TxType, bK as VirtualStatus, bL as Vtxo, bM as VtxoChain, a0 as VtxoManager, bN as VtxoType, b as WalletConfig, bO as WalletMode, bP as boardingResolver, bQ as classifyAgainstSignerSet, bR as classifyContractSigner, bS as createDefaultActivityRegistry, bT as decodeTapscript, bU as getNetwork, bV as getSequence, bW as isBatchSignable, bX as isCooperativelyMigratable, bY as isDiscoverable, bZ as isExpired, b_ as isRecoverable, b$ as isSpendable, c0 as isSubdust, c1 as isVtxoExpiringSoon, c2 as networks, c3 as signerSetFromInfo, c4 as toXOnlySignerHex } from './ark-CKDWpuGL.js';
-export { B as BoardingContractHandler, a as BoardingContractParams, D as DefaultContractHandler, b as DefaultContractParams, c as DelegateContractHandler, d as DelegateContractParams, V as VHTLC, e as VHTLCContractHandler, f as VHTLCContractParams, g as contractHandlers } from './index-DVdCGyyH.js';
-export { D as DefaultVtxo, a as DelegateVtxo } from './delegate-DllAQ3Eu.js';
-import { W as Wallet, R as ReadonlyWallet, a as ReceiveRotatorFactory, b as ReceiveRotatorBootOpts, c as ReceiveRotatorBoot } from './wallet-CrIVUQMb.js';
-export { B as Batch, d as BoardingUtxoGroup, I as IncomingFunds, w as waitForIncomingFunds } from './wallet-CrIVUQMb.js';
+import { K as ReadonlyIdentity, a as Identity, af as DescriptorSigningRequest, ag as Transaction, a3 as SignerSession, P as IntentRepository, a9 as ArkIntent, aa as IntentFilter, ab as Outpoint, Q as VirtualTxRepository, ac as VirtualTx, ad as VtxoBranch, W as WalletRepository, E as ExtendedVirtualCoin, a6 as VtxoRepositoryKey, d as ExtendedCoin, A as ArkTransaction, a7 as WalletState, t as Contract, C as ContractRepository, a8 as ContractFilter, ah as IntentFeeConfig, ai as OffchainInput, aj as FeeAmount, ak as OnchainInput, al as FeeOutput, o as ArkProvider, a1 as SettlementConfig, am as ContractWatcherConfig, I as IWallet, an as FeeInfo, j as SettlementEvent, H as DescriptorProvider, i as SettleParams, S as SendBitcoinParams, G as GetVtxosFilter, ao as CreateContractParams, ap as GetContractsFilter, s as VirtualCoin, aq as GetSpendablePathsOptions, ar as GetAllSpendingPathsOptions, R as Recipient, as as IssuanceParams, at as ReissuanceParams, au as BurnParams, av as RenewVtxosOptions, c as WalletBalance, aw as ContractWithVtxos, ax as PathSelection, ay as ContractEvent, az as AssetDetails, aA as IssuanceResult, aB as DelegateInfo, aC as MigrationGlobalSkipReason, aD as MigrationLegSkipReason, aE as SignerStatus, J as IReadonlyWallet, e as ActivityRegistry, U as IReadonlyAssetManager, aF as StorageConfig, f as Activity, g as IContractManager, k as IAssetManager, h as IDelegateManager, aG as IVtxoManager, O as OnchainProvider, N as Network, X as NetworkName, _ as Coin, aH as ExplorerTransaction, r as TapLeafScript, aI as EncodedVtxoScript, a0 as CSVMultisigTapscript, q as RelativeTimelock, V as VtxoScript, aJ as Status, aK as ChainTx, p as IndexerProvider, v as TxTree, aL as PathContext } from './ark-I8jfe5VE.js';
+export { aM as ActivityIntent, aN as ActivityResolver, Z as ArkAddress, Y as ArkInfo, aO as ArkIntentState, aP as ArkTapscript, aQ as Asset, aR as AssetMetadata, aS as BaseWalletConfig, z as BatchFailedEvent, x as BatchFinalizationEvent, y as BatchFinalizedEvent, aT as BatchInfo, aU as BatchSignableIdentity, B as BatchStartedEvent, aV as CLTVMultisigTapscript, aW as ChainTxType, ae as ChainedTxType, aX as CommitmentTx, aY as ConditionCSVMultisigTapscript, aZ as ConditionMultisigTapscript, a_ as ContractBalance, a$ as ContractEventCallback, b0 as ContractHandler, $ as ContractManager, b1 as ContractManagerConfig, b2 as ContractState, b3 as ContractVtxo, b4 as ContractWatcher, b5 as DelegateManagerImpl, b6 as DelegateOptions, L as DelegateProvider, b7 as DelegatorManagerImpl, b8 as DelegatorProvider, b9 as DeprecatedSignerMigrationReport, ba as DeprecatedSignerReport, bb as DigestMismatchError, bc as Discoverable, bd as DiscoveredContract, be as DiscoveryDeps, bf as ESPLORA_URL, bg as EsploraProvider, bh as ExtendedContractVtxo, bi as GroupMembership, bj as HandlerError, bk as IDelegatorManager, bl as INTENT_TERMINAL_STATES, bm as IndexerTxType, a5 as Intent, bn as KnownMetadata, bo as MigrateDeprecatedSignerOptions, bp as MigrationLegReport, bq as MigrationVtxoRef, br as MultisigTapscript, bs as Nonces, bt as Output, bu as PageResponse, bv as PaginationOptions, bw as PartialSig, bx as ProviderClass, M as ReadonlyWalletConfig, l as RestArkProvider, by as RestDelegateProvider, bz as RestDelegatorProvider, m as RestIndexerProvider, bA as ScanContractsOptions, bB as ScanResult, bC as ScheduledSession, bD as SettlementEventType, bE as SignRequest, a4 as SignedIntent, bF as SignerClassification, bG as SignerSet, bH as SubscriptionEvent, bI as SubscriptionHeartbeat, n as SubscriptionResponse, bJ as TapLeaves, bK as TapTreeCoder, bL as TapscriptType, bM as TreeNonces, w as TreeNoncesEvent, bN as TreePartialSigs, F as TreeSignatureEvent, u as TreeSigningStartedEvent, D as TreeTxEvent, bO as Tx, bP as TxHistoryRecord, bQ as TxKey, T as TxNotification, bR as TxTreeNode, bS as TxType, bT as VirtualStatus, bU as Vtxo, bV as VtxoChain, a2 as VtxoManager, bW as VtxoType, b as WalletConfig, bX as WalletMode, bY as boardingResolver, bZ as classifyAgainstSignerSet, b_ as classifyContractSigner, b$ as createDefaultActivityRegistry, c0 as decodeTapscript, c1 as getNetwork, c2 as getSequence, c3 as isBatchSignable, c4 as isCooperativelyMigratable, c5 as isDiscoverable, c6 as isExpired, c7 as isRecoverable, c8 as isSpendable, c9 as isSubdust, ca as isTerminalIntentState, cb as isVtxoExpiringSoon, cc as networks, cd as signerSetFromInfo, ce as toXOnlySignerHex } from './ark-I8jfe5VE.js';
+export { B as BoardingContractHandler, a as BoardingContractParams, D as DefaultContractHandler, b as DefaultContractParams, c as DelegateContractHandler, d as DelegateContractParams, V as VHTLC, e as VHTLCContractHandler, f as VHTLCContractParams, g as contractHandlers } from './index-DvWNB_rl.js';
+export { D as DefaultVtxo, a as DelegateVtxo } from './delegate-CgjVjYOP.js';
+import { W as Wallet, R as ReadonlyWallet, a as ReceiveRotatorFactory, b as ReceiveRotatorBootOpts, c as ReceiveRotatorBoot } from './wallet-D9z7wssl.js';
+export { B as Batch, d as BoardingUtxoGroup, I as IncomingFunds, w as waitForIncomingFunds } from './wallet-D9z7wssl.js';
 import { Bytes, BTC_NETWORK } from '@scure/btc-signer/utils.js';
 import { P2TR } from '@scure/btc-signer/payment.js';
 import { Transaction as Transaction$1 } from '@scure/btc-signer';
@@ -414,6 +414,73 @@ declare class ReadonlySingleKey implements ReadonlyIdentity {
     compressedPublicKey(): Promise<Uint8Array>;
 }
 
+declare class InMemoryIntentRepository implements IntentRepository {
+    readonly version: 1;
+    private byId;
+    clear(): Promise<void>;
+    saveIntent(intent: ArkIntent): Promise<void>;
+    getIntents(filter?: IntentFilter): Promise<ArkIntent[]>;
+    getLockedVtxoOutpoints(): Promise<Outpoint[]>;
+    [Symbol.asyncDispose](): Promise<void>;
+}
+
+declare class InMemoryVirtualTxRepository implements VirtualTxRepository {
+    readonly version: 1;
+    private txs;
+    private branches;
+    clear(): Promise<void>;
+    upsertVirtualTxs(txs: VirtualTx[]): Promise<void>;
+    getVirtualTx(txid: string): Promise<VirtualTx | null>;
+    setBranch(vtxo: Outpoint, branch: VtxoBranch[]): Promise<void>;
+    getBranch(vtxo: Outpoint): Promise<VirtualTx[]>;
+    hasBranch(vtxo: Outpoint): Promise<boolean>;
+    pruneForSpentVtxo(vtxo: Outpoint): Promise<void>;
+    [Symbol.asyncDispose](): Promise<void>;
+}
+
+/**
+ * @experimental Virtual-tx persistence is inert by default. This repository
+ * opens its DB at {@link INTENT_DB_VERSION} and creates the virtualtx stores,
+ * so it must be given a *dedicated* `dbName` distinct from the wallet/contract
+ * DB until this persistence is activated in the shared schema — otherwise the
+ * shared DB's version-conflict guard rejects the mismatched open.
+ */
+declare class IndexedDBVirtualTxRepository implements VirtualTxRepository {
+    private readonly dbName;
+    readonly version: 1;
+    private db;
+    constructor(dbName?: string);
+    private getDB;
+    clear(): Promise<void>;
+    upsertVirtualTxs(txs: VirtualTx[]): Promise<void>;
+    getVirtualTx(txid: string): Promise<VirtualTx | null>;
+    setBranch(vtxo: Outpoint, branch: VtxoBranch[]): Promise<void>;
+    getBranch(vtxo: Outpoint): Promise<VirtualTx[]>;
+    hasBranch(vtxo: Outpoint): Promise<boolean>;
+    pruneForSpentVtxo(vtxo: Outpoint): Promise<void>;
+    [Symbol.asyncDispose](): Promise<void>;
+}
+
+/**
+ * @experimental Intent persistence is inert by default. This repository opens
+ * its DB at {@link INTENT_DB_VERSION} and creates the intent stores, so it must
+ * be given a *dedicated* `dbName` distinct from the wallet/contract DB until
+ * intent persistence is activated in the shared schema — otherwise the shared
+ * DB's version-conflict guard rejects the mismatched open.
+ */
+declare class IndexedDBIntentRepository implements IntentRepository {
+    private readonly dbName;
+    readonly version: 1;
+    private db;
+    constructor(dbName?: string);
+    private getDB;
+    clear(): Promise<void>;
+    saveIntent(intent: ArkIntent): Promise<void>;
+    getIntents(filter?: IntentFilter): Promise<ArkIntent[]>;
+    getLockedVtxoOutpoints(): Promise<Outpoint[]>;
+    [Symbol.asyncDispose](): Promise<void>;
+}
+
 /**
  * In-memory implementation of WalletRepository.
  * Data is ephemeral and scoped to the instance.
@@ -2187,6 +2254,27 @@ declare class OnchainWallet implements AnchorBumper {
      * @see send
      */
     bumpP2A(parent: Transaction): Promise<[string, string]>;
+    /**
+     * Build and sign a CPFP fee child for a parent tx (given as raw hex)
+     * carrying a P2A anchor, funding it from this wallet's **confirmed**
+     * coins, and return the 1P1C package hexes WITHOUT broadcasting.
+     *
+     * This is the graph-mode fee source ({@link ExitFeeWallet}): the exit
+     * executor calls it to bump each transported virtual tx at execution
+     * time, so funding can be deferred rather than pre-signed.
+     *
+     * @param parentHex - Finalized parent transaction, raw network hex
+     * @param feeRate - sat/vB floor for the package (raised to MIN_FEE_RATE)
+     * @returns Tuple of parent hex (unchanged) and signed child hex
+     * @throws If the parent has no anchor, or funding cannot be selected/signed
+     */
+    bumpAnchor(parentHex: string, feeRate: number): Promise<[string, string]>;
+    /**
+     * Shared core of {@link bumpP2A} and {@link bumpAnchor}: probe the package
+     * fee with a single-input child, select coins for it, then build and sign
+     * with the actual selection (the fee grows per extra input).
+     */
+    private buildBumpPackage;
 }
 
 type SetupServiceWorkerOptions = {
@@ -2895,12 +2983,33 @@ declare namespace Unroll {
         readonly bumper: AnchorBumper;
         readonly explorer: OnchainProvider;
         readonly indexer: IndexerProvider;
+        /**
+         * Optional virtual-tx repository. When provided, each step's raw
+         * tx is read from the repo first and fetched from the indexer on a
+         * miss, then cached best-effort for later exits. Omitted ⇒ exact
+         * previous behaviour (indexer only).
+         */
+        readonly virtualTxRepository?: VirtualTxRepository | undefined;
         /** Create an unroll session from a virtual output outpoint and its dependency chain. */
         constructor(toUnroll: Outpoint & {
             chain: ChainTx[];
-        }, bumper: AnchorBumper, explorer: OnchainProvider, indexer: IndexerProvider);
+        }, bumper: AnchorBumper, explorer: OnchainProvider, indexer: IndexerProvider, 
+        /**
+         * Optional virtual-tx repository. When provided, each step's raw
+         * tx is read from the repo first and fetched from the indexer on a
+         * miss, then cached best-effort for later exits. Omitted ⇒ exact
+         * previous behaviour (indexer only).
+         */
+        virtualTxRepository?: VirtualTxRepository | undefined);
         /** Create an unroll session by loading the virtual output chain from the indexer. */
-        static create(toUnroll: Outpoint, bumper: AnchorBumper, explorer: OnchainProvider, indexer: IndexerProvider): Promise<Session>;
+        static create(toUnroll: Outpoint, bumper: AnchorBumper, explorer: OnchainProvider, indexer: IndexerProvider, virtualTxRepository?: VirtualTxRepository): Promise<Session>;
+        /**
+         * Resolve a chain tx's raw PSBT (base64). Repo first when configured;
+         * indexer on a miss, then best-effort cached so a later exit doesn't
+         * re-fetch. Never throws from the cache
+         * write — exit correctness must not depend on persistence.
+         */
+        private resolveVirtualTxBase64;
         /**
          * Get the next step to be executed
          * @returns The next step to be executed + the function to execute it
@@ -2925,6 +3034,216 @@ declare namespace Unroll {
     function completeUnroll(wallet: Wallet, vtxoTxids: string[], outputAddress: string): Promise<string>;
 }
 
+/** Relative delay before a sweep becomes valid, decoded from BIP-68. */
+type ExitDelay = {
+    type: "blocks" | "seconds";
+    value: number;
+};
+/** Broadcast a single pre-signed transaction (the funding splitter). */
+type BroadcastStep = {
+    kind: "broadcast";
+    txid: string;
+    hex: string;
+};
+/** Broadcast a 1P1C package: virtual tx + its pre-signed CPFP fee child. */
+type PackageStep = {
+    kind: "package";
+    parentTxid: string;
+    parentHex: string;
+    childTxid: string;
+    childHex: string;
+    /** Outpoints (txid:vout) of the VTXOs this step serves. */
+    forVtxos: string[];
+};
+/**
+ * A virtual tx that must go onchain but whose CPFP fee child is NOT
+ * pre-signed (graph mode). The executor builds and signs the child at
+ * execution time using its own fee wallet — this is how "send funds to
+ * this address and we proceed" works: funding is deferred, not baked in.
+ */
+type BumpStep = {
+    kind: "bump";
+    parentTxid: string;
+    parentHex: string;
+    /** Outpoints (txid:vout) of the VTXOs this step serves. */
+    forVtxos: string[];
+};
+/** Broadcast a pre-signed CSV sweep once its dependency matured. */
+type SweepStep = {
+    kind: "sweep";
+    vtxo: string;
+    txid: string;
+    hex: string;
+    /** The VTXO-creating leaf tx whose confirmation starts the CSV clock. */
+    dependsOnTxid: string;
+    delay: ExitDelay;
+};
+type ExitStep = BroadcastStep | PackageStep | BumpStep | SweepStep;
+/**
+ * How fee funding is provided:
+ * - `"funded"`: a splitter tx (broadcast at prepare time) pre-funds
+ *   pre-signed fee children — execution is fully keyless.
+ * - `"graph"`: only the tx graph + sweeps are transported; the executor
+ *   funds and signs the CPFP bumps at execution time from its own fee
+ *   wallet ("send funds to this address and we proceed").
+ */
+type ExitMode = "funded" | "graph";
+/** Per-VTXO metadata; skipped VTXOs carry a human-readable reason. */
+type ExitVtxoInfo = {
+    outpoint: string;
+    value?: number;
+    sweepFee?: number;
+    /** `${contractType}:${pathLabel}` for observability, e.g. "vhtlc:unilateral". */
+    path?: string;
+    delay?: ExitDelay;
+    skipped?: string;
+};
+type ExitTotals = {
+    /** Distinct transactions the executor ensures onchain. */
+    txCount: number;
+    totalFeeSats: number;
+    /** Sats consumed from the onchain wallet by the splitter (fees + funding outputs). */
+    fundingRequiredSats: number;
+    /** Sats arriving at the sweep address once all sweeps confirm. */
+    recoveredSats: number;
+};
+/**
+ * Versioned, language-agnostic unilateral exit package.
+ * Everything inside is pre-signed; executing it requires no keys and no
+ * Arkade infrastructure — only an Esplora-compatible API.
+ */
+type ExitPackage = {
+    version: 1;
+    /** Fee-funding strategy. Absent is treated as "funded" (v1 default). */
+    mode?: ExitMode;
+    network: NetworkName;
+    createdAt: number;
+    /** Min batch expiry (unix seconds) across included txs. Informational. */
+    validUntil?: number;
+    feeRate: number;
+    sweepAddress: string;
+    totals: ExitTotals;
+    vtxos: ExitVtxoInfo[];
+    /** Topologically ordered: a step's txs confirm before dependents proceed. */
+    steps: ExitStep[];
+};
+/** Cost/size quote returned by `UnilateralExit.estimate` — no funds needed. */
+type ExitQuote = {
+    feeRate: number;
+    fundingAddress: string;
+    currentBalanceSats: number;
+    shortfallSats: number;
+    validUntil?: number;
+    totals: ExitTotals;
+    vtxos: ExitVtxoInfo[];
+};
+declare function serializeExitPackage(pkg: ExitPackage): string;
+declare function deserializeExitPackage(json: string): ExitPackage;
+
+type ExitOptions = {
+    /** Wallet owning the VTXOs: identity (signing) + indexer + onchain provider. */
+    wallet: Wallet;
+    /** Fee funding source and change/funding address. Must share the wallet identity. */
+    onchainWallet: OnchainWallet;
+    /** Destination for the exited funds. */
+    sweepAddress: string;
+    /** sat/vB; defaults to the onchain provider estimate, floored at MIN_FEE_RATE. */
+    feeRate?: number;
+    /** Defaults to all spendable VTXOs. */
+    vtxos?: Outpoint[];
+    /**
+     * Fee-funding strategy (default `"funded"`):
+     * - `"funded"`: broadcast a splitter at prepare time and pre-sign the
+     *   fee children — the package executes fully keyless.
+     * - `"graph"`: transport only the tx graph + sweeps; the executor funds
+     *   and signs the CPFP bumps at execution time ("send funds to this
+     *   address and we proceed"). No splitter, no `onchainWallet` funds used.
+     */
+    mode?: ExitMode;
+    /**
+     * Network label embedded in the package (executor sanity check).
+     * Resolved from the wallet's network when omitted — exact for
+     * "bitcoin" and "regtest"; the tb-family defaults to "testnet", so
+     * pass this explicitly on signet/mutinynet.
+     */
+    networkName?: NetworkName;
+};
+/**
+ * Quote a unilateral exit: how many transactions, how many sats of fees,
+ * and how much must be deposited to the funding address. Requires no
+ * onchain funds and signs nothing.
+ */
+declare function estimate(opts: ExitOptions): Promise<ExitQuote>;
+
+type ExecutorEvent = {
+    stepIndex: number;
+    kind: ExitStep["kind"];
+    status: "skipped" | "broadcast" | "confirmed" | "waiting_csv" | "failed" | "warning";
+    forVtxos?: string[];
+    txid?: string;
+    reason?: string;
+    /** For waiting_csv with a blocks delay: absolute height at maturity. */
+    maturesAtHeight?: number;
+    /** For waiting_csv with a seconds delay: unix time at maturity. */
+    maturesAtTime?: number;
+};
+/**
+ * Fee source for graph-mode `bump` steps. Given a parent tx carrying a P2A
+ * anchor, it builds and signs the CPFP fee child from its own funds and
+ * returns the 1P1C package hexes (parent unchanged, child signed) — WITHOUT
+ * broadcasting; the executor owns broadcast. `OnchainWallet` implements it.
+ */
+interface ExitFeeWallet {
+    bumpAnchor(parentHex: string, feeRate: number): Promise<[parentHex: string, childHex: string]>;
+}
+/**
+ * Keyless, stateless executor for a pre-signed exit package.
+ *
+ * The blockchain is the only state: every action re-checks tx status first,
+ * so the executor can be killed and re-run anywhere at any time. It never
+ * parses transaction hex — it only relays it.
+ */
+declare class Executor implements AsyncIterable<ExecutorEvent> {
+    readonly pkg: ExitPackage;
+    readonly provider: OnchainProvider;
+    private readonly pollIntervalMs;
+    private readonly feeWallet?;
+    constructor(pkg: ExitPackage, provider: OnchainProvider, opts?: {
+        pollIntervalMs?: number;
+        feeWallet?: ExitFeeWallet;
+    });
+    private sleep;
+    private status;
+    private waitConfirmed;
+    [Symbol.asyncIterator](): AsyncIterator<ExecutorEvent>;
+}
+
+/**
+ * Build the fully pre-signed unilateral exit package.
+ *
+ * Signs every transaction needed to land the selected VTXOs onchain and
+ * **broadcasts the funding splitter** as a side effect — reserving the fee
+ * budget so later wallet activity cannot invalidate the package. The
+ * returned package is keyless to execute: hand it to
+ * `UnilateralExit.Executor` (or any Esplora-speaking watchtower).
+ */
+declare function prepare(opts: ExitOptions): Promise<ExitPackage>;
+
+/**
+ * Pre-signed unilateral exit.
+ *
+ * `estimate` quotes the cost (tx count, fees, funding required) without
+ * touching funds; `prepare` signs every transaction needed to land the
+ * VTXOs onchain and broadcasts the fee-funding splitter; `Executor` drives
+ * the resulting package to completion with nothing but an
+ * Esplora-compatible endpoint — no keys, no Arkade infrastructure.
+ */
+declare const UnilateralExit: {
+    readonly estimate: typeof estimate;
+    readonly prepare: typeof prepare;
+    readonly Executor: typeof Executor;
+};
+
 declare class ArkError extends Error {
     readonly code: number;
     readonly message: string;
@@ -3543,6 +3862,22 @@ declare const buildVersion = "0.9.9";
  * The SDK's own version string, sourced from package.json
  */
 declare const sdkVersion: string;
+/**
+ * Wraps a transport-level `fetch` rejection (DNS failure, connection refused,
+ * TLS or CORS error) with the request method and URL, preserving the original
+ * as {@link Error.cause}.
+ */
+declare class FetchError extends Error {
+    /** The request URL that failed, when derivable from the `fetch` input. */
+    readonly url?: string;
+    /** The HTTP method of the failed request (defaults to `"GET"`). */
+    readonly method?: string;
+    constructor(message: string, options: {
+        url?: string;
+        method?: string;
+        cause?: unknown;
+    });
+}
 
 /**
  * Opens an IndexedDB database and increments the reference count.
@@ -3651,4 +3986,4 @@ declare class AssetManager extends ReadonlyAssetManager implements IAssetManager
     burn(params: BurnParams): Promise<string>;
 }
 
-export { Activity, ActivityRegistry, type AnchorBumper, ArkError, ArkNote, ArkProvider, type ArkPsbtFieldCoder, ArkPsbtFieldKey, ArkPsbtFieldKeyType, ArkTransaction, type ArkTxInput, AssetDetails, AssetManager, BIP322, BurnParams, CSVMultisigTapscript, ChainTx, Coin, ConditionWitness, Contract, ContractEvent, ContractRepository, ContractRepositoryImpl, ContractWatcherConfig, ContractWithVtxos, CosignerPublicKey, CreateContractParams, DEFAULT_MESSAGE_TIMEOUTS, DelegateInfo, DelegateNotConfiguredError, DelegatorNotConfiguredError, type DescriptorOptions, DescriptorSigningProviderMissingError, DustChangeError, ELECTRUM_TCP_HOST, ELECTRUM_WS_URL, type BlockHeader as ElectrumBlockHeader, ElectrumOnchainProvider, type TransactionHistory as ElectrumTransactionHistory, type Unspent as ElectrumUnspent, EncodedVtxoScript, Estimator, ExplorerTransaction, ExtendedCoin, ExtendedVirtualCoin, FeeAmount, FeeInfo, FeeOutput, GetVtxosFilter, HDDescriptorProvider, IAssetManager, IContractManager, IDelegateManager, IReadonlyAssetManager, IReadonlyWallet, IVtxoManager, IWallet, Identity, InMemoryContractRepository, InMemoryWalletRepository, IndexedDBContractRepository, IndexedDBWalletRepository, IndexerProvider, IntentFeeConfig, IssuanceParams, IssuanceResult, MESSAGE_BUS_INITIALIZING, MESSAGE_BUS_NOT_INITIALIZED, MIGRATION_KEY, MessageBus, MessageBusInitializingError, MessageBusNotInitializedError, type MessageHandler, type MessageTimeouts, MigrationGlobalSkipReason, MigrationLegSkipReason, type MigrationStatus, MissingSigningDescriptorError, MnemonicIdentity, type MnemonicOptions, Network, NetworkName, type NetworkOptions, OffchainInput, type OffchainTx, OnchainInput, OnchainProvider, OnchainWallet, Outpoint, P2A, type ParsedArkContract, PathContext, PathSelection, Ramps, ReadonlyAssetManager, ReadonlyDescriptorIdentity, ReadonlyIdentity, ReadonlySingleKey, ReadonlyWallet, ReadonlyWalletError, Recipient, ReissuanceParams, RelativeTimelock, RenewVtxosOptions, type RequestEnvelope, type ResponseEnvelope, SeedIdentity, type SeedIdentityOptions, SendBitcoinParams, ServiceWorkerReadonlyWallet, ServiceWorkerTimeoutError, ServiceWorkerWallet, type ServiceWorkerWalletMode, SettleParams, SettlementConfig, SettlementEvent, SignerSession, SignerStatus, SingleKey, Status, StorageConfig, TapLeafScript, Transaction, TxTree, TxWeightEstimator, Unroll, type VSize, VirtualCoin, VtxoScript, VtxoTaprootTree, VtxoTreeExpiry, Wallet, WalletBalance, WalletMessageHandler, WalletNotInitializedError, WalletRepository, WalletRepositoryImpl, WsElectrumChainSource, assembleBtcdTaprootTree, index as asset, buildForfeitTx, buildOffchainTx, buildVersion, closeDatabase, combineTapscriptSigs, contractFromArkContract, contractFromArkContractWithAddress, decodeArkContract, encodeArkContract, getArkPsbtFields, getMigrationStatus, getRandomId, hasBoardingTxExpired, isArkContract, isCltvSatisfied, isCsvSpendable, isValidArkAddress, maybeArkError, migrateWalletRepository, openDatabase, requiresMigration, rollbackMigration, sdkVersion, sequenceToTimelock, setArkPsbtField, setupServiceWorker, timelockToSequence, validateConnectorsTxGraph, validateVtxoTxGraph, verifyTapscriptSignatures };
+export { Activity, ActivityRegistry, type AnchorBumper, ArkError, ArkIntent, ArkNote, ArkProvider, type ArkPsbtFieldCoder, ArkPsbtFieldKey, ArkPsbtFieldKeyType, ArkTransaction, type ArkTxInput, AssetDetails, AssetManager, BIP322, BurnParams, CSVMultisigTapscript, ChainTx, Coin, ConditionWitness, Contract, ContractEvent, ContractRepository, ContractRepositoryImpl, ContractWatcherConfig, ContractWithVtxos, CosignerPublicKey, CreateContractParams, DEFAULT_MESSAGE_TIMEOUTS, DelegateInfo, DelegateNotConfiguredError, DelegatorNotConfiguredError, type DescriptorOptions, DescriptorSigningProviderMissingError, DustChangeError, ELECTRUM_TCP_HOST, ELECTRUM_WS_URL, type BlockHeader as ElectrumBlockHeader, ElectrumOnchainProvider, type TransactionHistory as ElectrumTransactionHistory, type Unspent as ElectrumUnspent, EncodedVtxoScript, Estimator, type ExecutorEvent, type ExitDelay, type ExitFeeWallet, type ExitMode, type ExitOptions, type ExitPackage, type ExitQuote, type ExitStep, type ExitTotals, type ExitVtxoInfo, ExplorerTransaction, ExtendedCoin, ExtendedVirtualCoin, FeeAmount, FeeInfo, FeeOutput, FetchError, GetVtxosFilter, HDDescriptorProvider, IAssetManager, IContractManager, IDelegateManager, IReadonlyAssetManager, IReadonlyWallet, IVtxoManager, IWallet, Identity, InMemoryContractRepository, InMemoryIntentRepository, InMemoryVirtualTxRepository, InMemoryWalletRepository, IndexedDBContractRepository, IndexedDBIntentRepository, IndexedDBVirtualTxRepository, IndexedDBWalletRepository, IndexerProvider, IntentFeeConfig, IntentFilter, IntentRepository, IssuanceParams, IssuanceResult, MESSAGE_BUS_INITIALIZING, MESSAGE_BUS_NOT_INITIALIZED, MIGRATION_KEY, MessageBus, MessageBusInitializingError, MessageBusNotInitializedError, type MessageHandler, type MessageTimeouts, MigrationGlobalSkipReason, MigrationLegSkipReason, type MigrationStatus, MissingSigningDescriptorError, MnemonicIdentity, type MnemonicOptions, Network, NetworkName, type NetworkOptions, OffchainInput, type OffchainTx, OnchainInput, OnchainProvider, OnchainWallet, Outpoint, P2A, type ParsedArkContract, PathContext, PathSelection, Ramps, ReadonlyAssetManager, ReadonlyDescriptorIdentity, ReadonlyIdentity, ReadonlySingleKey, ReadonlyWallet, ReadonlyWalletError, Recipient, ReissuanceParams, RelativeTimelock, RenewVtxosOptions, type RequestEnvelope, type ResponseEnvelope, SeedIdentity, type SeedIdentityOptions, SendBitcoinParams, ServiceWorkerReadonlyWallet, ServiceWorkerTimeoutError, ServiceWorkerWallet, type ServiceWorkerWalletMode, SettleParams, SettlementConfig, SettlementEvent, SignerSession, SignerStatus, SingleKey, Status, StorageConfig, TapLeafScript, Transaction, TxTree, TxWeightEstimator, UnilateralExit, Unroll, type VSize, VirtualCoin, VirtualTx, VirtualTxRepository, VtxoBranch, VtxoScript, VtxoTaprootTree, VtxoTreeExpiry, Wallet, WalletBalance, WalletMessageHandler, WalletNotInitializedError, WalletRepository, WalletRepositoryImpl, WsElectrumChainSource, assembleBtcdTaprootTree, index as asset, buildForfeitTx, buildOffchainTx, buildVersion, closeDatabase, combineTapscriptSigs, contractFromArkContract, contractFromArkContractWithAddress, decodeArkContract, deserializeExitPackage, encodeArkContract, getArkPsbtFields, getMigrationStatus, getRandomId, hasBoardingTxExpired, isArkContract, isCltvSatisfied, isCsvSpendable, isValidArkAddress, maybeArkError, migrateWalletRepository, openDatabase, requiresMigration, rollbackMigration, sdkVersion, sequenceToTimelock, serializeExitPackage, setArkPsbtField, setupServiceWorker, timelockToSequence, validateConnectorsTxGraph, validateVtxoTxGraph, verifyTapscriptSignatures };

package/dist/index.js

@@ -1,5 +1,5 @@
-export { ActivityRegistry, ArkNote, AssetManager, BIP322, Batch, ContractManager, ContractRepositoryImpl, ContractWatcher, DEFAULT_MESSAGE_TIMEOUTS, DelegateManagerImpl, DelegateNotConfiguredError, DelegatorManagerImpl, DelegatorNotConfiguredError, DescriptorSigningProviderMissingError, DustChangeError, ELECTRUM_TCP_HOST, ELECTRUM_WS_URL, ESPLORA_URL, ElectrumOnchainProvider, EsploraProvider, Estimator, HDDescriptorProvider, InMemoryContractRepository, InMemoryWalletRepository, IndexedDBContractRepository, IndexedDBWalletRepository, MESSAGE_BUS_INITIALIZING, MESSAGE_BUS_NOT_INITIALIZED, MIGRATION_KEY, MessageBus, MessageBusInitializingError, MessageBusNotInitializedError, MissingSigningDescriptorError, MnemonicIdentity, OnchainWallet, P2A, Ramps, ReadonlyAssetManager, ReadonlyDescriptorIdentity, ReadonlySingleKey, ReadonlyWallet, ReadonlyWalletError, RestDelegateProvider, RestDelegatorProvider, SeedIdentity, ServiceWorkerReadonlyWallet, ServiceWorkerTimeoutError, ServiceWorkerWallet, SingleKey, TxTree, TxType, TxWeightEstimator, Unroll, VtxoManager, Wallet, WalletMessageHandler, WalletNotInitializedError, WalletRepositoryImpl, WsElectrumChainSource, boardingResolver, buildForfeitTx, buildOffchainTx, classifyAgainstSignerSet, classifyContractSigner, closeDatabase, combineTapscriptSigs, contractFromArkContract, contractFromArkContractWithAddress, createDefaultActivityRegistry, decodeArkContract, encodeArkContract, getMigrationStatus, getRandomId, hasBoardingTxExpired, isArkContract, isBatchSignable, isCooperativelyMigratable, isDiscoverable, isExpired, isRecoverable, isSpendable, isSubdust, isValidArkAddress, isVtxoExpiringSoon, migrateWalletRepository, openDatabase, requiresMigration, rollbackMigration, setupServiceWorker, signerSetFromInfo, toXOnlySignerHex, validateConnectorsTxGraph, validateVtxoTxGraph, verifyTapscriptSignatures, waitForIncomingFunds } from './chunk-V3FCNVJE.js';
-export { ArkError, ArkPsbtFieldKey, ArkPsbtFieldKeyType, ChainTxType, ConditionWitness, CosignerPublicKey, DigestMismatchError, IndexerTxType, Intent, RestArkProvider, RestIndexerProvider, SettlementEventType, Transaction, VtxoTaprootTree, VtxoTreeExpiry, asset_exports as asset, buildVersion, getArkPsbtFields, maybeArkError, sdkVersion, setArkPsbtField } from './chunk-5X5YMZHB.js';
+export { ActivityRegistry, ArkNote, AssetManager, BIP322, Batch, ChainedTxType, ContractManager, ContractRepositoryImpl, ContractWatcher, DEFAULT_MESSAGE_TIMEOUTS, DelegateManagerImpl, DelegateNotConfiguredError, DelegatorManagerImpl, DelegatorNotConfiguredError, DescriptorSigningProviderMissingError, DustChangeError, ELECTRUM_TCP_HOST, ELECTRUM_WS_URL, ESPLORA_URL, ElectrumOnchainProvider, EsploraProvider, Estimator, HDDescriptorProvider, INTENT_TERMINAL_STATES, InMemoryContractRepository, InMemoryIntentRepository, InMemoryVirtualTxRepository, InMemoryWalletRepository, IndexedDBContractRepository, IndexedDBIntentRepository, IndexedDBVirtualTxRepository, IndexedDBWalletRepository, MESSAGE_BUS_INITIALIZING, MESSAGE_BUS_NOT_INITIALIZED, MIGRATION_KEY, MessageBus, MessageBusInitializingError, MessageBusNotInitializedError, MissingSigningDescriptorError, MnemonicIdentity, OnchainWallet, P2A, Ramps, ReadonlyAssetManager, ReadonlyDescriptorIdentity, ReadonlySingleKey, ReadonlyWallet, ReadonlyWalletError, RestDelegateProvider, RestDelegatorProvider, SeedIdentity, ServiceWorkerReadonlyWallet, ServiceWorkerTimeoutError, ServiceWorkerWallet, SingleKey, TxTree, TxType, TxWeightEstimator, UnilateralExit, Unroll, VtxoManager, Wallet, WalletMessageHandler, WalletNotInitializedError, WalletRepositoryImpl, WsElectrumChainSource, boardingResolver, buildForfeitTx, buildOffchainTx, classifyAgainstSignerSet, classifyContractSigner, closeDatabase, combineTapscriptSigs, contractFromArkContract, contractFromArkContractWithAddress, createDefaultActivityRegistry, decodeArkContract, deserializeExitPackage, encodeArkContract, getMigrationStatus, getRandomId, hasBoardingTxExpired, isArkContract, isBatchSignable, isCooperativelyMigratable, isDiscoverable, isExpired, isRecoverable, isSpendable, isSubdust, isTerminalIntentState, isValidArkAddress, isVtxoExpiringSoon, migrateWalletRepository, openDatabase, requiresMigration, rollbackMigration, serializeExitPackage, setupServiceWorker, signerSetFromInfo, toXOnlySignerHex, validateConnectorsTxGraph, validateVtxoTxGraph, verifyTapscriptSignatures, waitForIncomingFunds } from './chunk-FMI2GKYO.js';
+export { ArkError, ArkPsbtFieldKey, ArkPsbtFieldKeyType, ChainTxType, ConditionWitness, CosignerPublicKey, DigestMismatchError, FetchError, IndexerTxType, Intent, RestArkProvider, RestIndexerProvider, SettlementEventType, Transaction, VtxoTaprootTree, VtxoTreeExpiry, asset_exports as asset, buildVersion, getArkPsbtFields, maybeArkError, sdkVersion, setArkPsbtField } from './chunk-LJ35HPJW.js';
 export { BoardingContractHandler, DefaultContractHandler, DefaultVtxo, DelegateContractHandler, DelegateVtxo, VHTLC, VHTLCContractHandler, contractHandlers, isCltvSatisfied, isCsvSpendable } from './chunk-YNEDJTX2.js';
 export { ArkAddress, CLTVMultisigTapscript, CSVMultisigTapscript, ConditionCSVMultisigTapscript, ConditionMultisigTapscript, MultisigTapscript, TapTreeCoder, VtxoScript, assembleBtcdTaprootTree, decodeTapscript, getNetwork, getSequence, networks, sequenceToTimelock, timelockToSequence } from './chunk-BE5MUB7T.js';
 import './chunk-NSBPE2FW.js';