@arkade-os/sdk 0.4.41 → 0.4.43

package/dist/adapters/expo.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
-var chunkWBF3FNS3_cjs = require('../chunk-WBF3FNS3.cjs');
-require('../chunk-ALISWEQ5.cjs');
+var chunkPLJZRIFZ_cjs = require('../chunk-PLJZRIFZ.cjs');
+require('../chunk-3AQNLQPM.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 chunkWBF3FNS3_cjs.ExpoArkProvider; }
+  get: function () { return chunkPLJZRIFZ_cjs.ExpoArkProvider; }
 });
 Object.defineProperty(exports, "ExpoIndexerProvider", {
   enumerable: true,
-  get: function () { return chunkWBF3FNS3_cjs.ExpoIndexerProvider; }
+  get: function () { return chunkPLJZRIFZ_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-CSqMJczW.cjs';
-export { o as ArkProvider, p as IndexerProvider } from '../ark-CSqMJczW.cjs';
+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 '@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-CSqMJczW.js';
-export { o as ArkProvider, p as IndexerProvider } from '../ark-CSqMJczW.js';
+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 '@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-DDG4RE5F.js';
-import '../chunk-5XAYUPK4.js';
+export { ExpoArkProvider, ExpoIndexerProvider } from '../chunk-VKKLOT2E.js';
+import '../chunk-763XHDAJ.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 chunk3MPXMLP4_cjs = require('../chunk-3MPXMLP4.cjs');
-require('../chunk-ALISWEQ5.cjs');
+var chunkQGNTDGMN_cjs = require('../chunk-QGNTDGMN.cjs');
+require('../chunk-3AQNLQPM.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 = chunk3MPXMLP4_cjs.DB_VERSION) {
+  constructor(dbName, version = chunkQGNTDGMN_cjs.DB_VERSION) {
     this.dbName = dbName;
     this.version = version;
   }

package/dist/adapters/indexedDB.js

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

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

@@ -965,6 +965,11 @@ interface IVtxoManager {
      * Available regardless of the `deprecatedSignerMigration` config flag (that
      * flag only gates the automatic poll-loop pass).
      *
+     * As a side effect, refreshes the wallet's cached deprecated-signer set from
+     * fresh server info, so a subsequent `settle()` correctly excludes EXPIRED
+     * deprecated-signer inputs. To refresh that filter without migrating, call
+     * `wallet.refreshDeprecatedSigners(await wallet.arkProvider.getInfo())` instead.
+     *
      * @returns A report of what was migrated, skipped, expired, or failed.
      */
     migrateDeprecatedSignerVtxos(options?: MigrateDeprecatedSignerOptions): Promise<DeprecatedSignerMigrationReport>;
@@ -1650,6 +1655,120 @@ interface ContractRepository extends AsyncDisposable {
     deleteContract(script: string): Promise<void>;
 }
 
+type ArkIntentState = "waiting_to_submit" | "waiting_for_batch" | "batch_in_progress" | "batch_failed" | "batch_succeeded" | "cancelled";
+declare const INTENT_TERMINAL_STATES: ReadonlySet<ArkIntentState>;
+declare function isTerminalIntentState(s: ArkIntentState): boolean;
+interface ArkIntent {
+    /** Intent proof tx id. Primary key. */
+    intentTxId: string;
+    /**
+     * Server-assigned batch intent id. Unique when present: saving a *different*
+     * intentTxId that reuses a live intentId is rejected (NArk parity). Absent
+     * until the intent is registered with arkd.
+     */
+    intentId?: string;
+    state: ArkIntentState;
+    validFrom?: number;
+    validUntil?: number;
+    createdAt: number;
+    updatedAt: number;
+    /** hex PSBT. */
+    registerProof: string;
+    /** canonical JSON signed by the register proof. */
+    registerProofMessage: string;
+    /** hex PSBT. */
+    deleteProof: string;
+    deleteProofMessage: string;
+    batchId?: string;
+    commitmentTransactionId?: string;
+    cancellationReason?: string;
+    partialForfeits: string[];
+    signerDescriptor?: string;
+    /** Input VTXOs locked by this intent. */
+    intentVtxos: Outpoint[];
+}
+interface IntentFilter {
+    intentTxIds?: string[];
+    intentIds?: string[];
+    /** Intents whose `intentVtxos` intersect any of these outpoints. */
+    containingInputs?: Outpoint[];
+    states?: ArkIntentState[];
+    /** Intents valid at this ms-epoch instant (null bounds = open). */
+    validAt?: number;
+    /** Substring match over intentId, batchId, commitmentTransactionId. */
+    searchText?: string;
+    skip?: number;
+    take?: number;
+}
+interface IntentRepository extends AsyncDisposable {
+    readonly version: 1;
+    clear(): Promise<void>;
+    /** Upsert by `intentTxId`; implementation sets `updatedAt = Date.now()`. */
+    saveIntent(intent: ArkIntent): Promise<void>;
+    getIntents(filter?: IntentFilter): Promise<ArkIntent[]>;
+    /**
+     * Outpoints held by NON-terminal intents — `waiting_to_submit`,
+     * `waiting_for_batch`, and `batch_in_progress` — to exclude from spendable
+     * balance. Terminal states never lock.
+     *
+     * Deliberate divergence from NArk EF storage, whose `GetLockedVtxoOutpoints`
+     * locks only `WaitingToSubmit`/`WaitingForBatch`: the TS wallet balance is
+     * offline-first and reads this set as its single source of coin locking, so
+     * it must also hold inputs already committed to an in-progress batch. NArk
+     * excludes `BatchInProgress` here but protects those inputs through its
+     * active-intent services instead.
+     */
+    getLockedVtxoOutpoints(): Promise<Outpoint[]>;
+}
+
+/**
+ * Type of a tx inside a VTXO's chain (commitment → leaf), as reported by
+ * arkd's chain indexer. Values pinned verbatim from NArk `ChainedTxType.cs`.
+ */
+declare enum ChainedTxType {
+    Unspecified = 0,
+    Commitment = 1,
+    Ark = 2,
+    Tree = 3,
+    Checkpoint = 4
+}
+/** A single virtual transaction in the VTXO tree. */
+interface VirtualTx {
+    /** Transaction id (hex). Primary key. */
+    txid: string;
+    /** Base64-encoded PSBT body; null when only metadata has been cached. */
+    psbt: string | null;
+    /** Operator pre-signature expiry, ms epoch; null if not applicable. */
+    expiresAt: number | null;
+    /** Tx type as reported by arkd's chain indexer. */
+    type: ChainedTxType;
+}
+/**
+ * Links a VTXO to one virtual tx in its exit branch, ordered.
+ * `position` 0 = closest to commitment (tree root); higher = closer to leaf.
+ */
+interface VtxoBranch {
+    vtxoTxid: string;
+    vtxoVout: number;
+    virtualTxid: string;
+    position: number;
+}
+interface VirtualTxRepository extends AsyncDisposable {
+    readonly version: 1;
+    clear(): Promise<void>;
+    /** Upsert: non-null incoming fields overwrite; null (or, for `type`,
+     *  `Unspecified`) is treated as absent and preserves the stored value. */
+    upsertVirtualTxs(txs: VirtualTx[]): Promise<void>;
+    getVirtualTx(txid: string): Promise<VirtualTx | null>;
+    /** Replace the entire stored branch for a VTXO. */
+    setBranch(vtxo: Outpoint, branch: VtxoBranch[]): Promise<void>;
+    /** Resolved virtual txs in the VTXO's branch, ordered by position asc. */
+    getBranch(vtxo: Outpoint): Promise<VirtualTx[]>;
+    hasBranch(vtxo: Outpoint): Promise<boolean>;
+    /** Drop branch rows for a spent VTXO, then delete now-orphaned VirtualTx rows. */
+    pruneForSpentVtxo(vtxo: Outpoint): Promise<void>;
+}
+
 type RefreshVtxosOptions = {
     scripts?: string[];
     after?: number;
@@ -1877,6 +1996,13 @@ interface ContractManagerConfig {
     contractRepository: ContractRepository;
     /** The wallet repository for virtual output storage (single source of truth) */
     walletRepository: WalletRepository;
+    /**
+     * Optional intent store. When present, the online sync path reconciles
+     * persisted non-terminal settlement intents against authoritative indexer
+     * state (crash recovery) on boot and reconnect — see
+     * {@link reconcileIntents}. Absent ⇒ no-op.
+     */
+    intentRepository?: IntentRepository;
     /** Watcher configuration */
     watcherConfig?: Partial<ContractWatcherConfig>;
 }
@@ -1963,6 +2089,15 @@ declare class ContractManager implements IContractManager {
      * outputs that could sit outside any delta window.
      */
     private reconcileWatched;
+    /**
+     * Crash-recovery for persisted settlement intents: reconcile any
+     * non-terminal intent left behind by a mid-settle crash against
+     * authoritative indexer state (see {@link reconcileIntents}). Runs on the
+     * online sync path only — boot and subscription reconnect — never from a
+     * wallet read API. Best-effort: intent recovery is not a sync invariant, so
+     * a failure is logged and sync continues. No-op without an intent store.
+     */
+    private reconcileStaleIntents;
     /**
      * Create and register a new contract.
      *
@@ -3195,6 +3330,22 @@ type StorageConfig = {
     walletRepository: WalletRepository;
     /** Contract-state repository implementation. */
     contractRepository: ContractRepository;
+    /**
+     * Optional intent-lifecycle repository. Opt-in: when present, the wallet
+     * persists settlement intents and excludes intent-locked VTXOs from
+     * spendable balance. Absent ⇒ those code paths are no-ops.
+     */
+    intentRepository?: IntentRepository;
+    /**
+     * **Experimental / inert.** Optional virtual-tx (exit-branch) repository.
+     * Today it is only a best-effort raw-PSBT cache that unilateral exit
+     * ({@link Unroll}) reads and writes when a caller passes it to
+     * `Unroll.Session.create`. Normal wallet/contract sync does NOT populate,
+     * maintain, or prune it, and {@link ContractManager} is never given it —
+     * branch/full-mode persistence is out of scope for this release. Treat this
+     * option as experimental until those paths land. Absent ⇒ no-op.
+     */
+    virtualTxRepository?: VirtualTxRepository;
 };
 /**
  * Provider class constructor interface for dependency injection.
@@ -3233,7 +3384,11 @@ interface WalletBalance {
     settled: number;
     /** Spendable preconfirmed (unfinalized) balance. */
     preconfirmed: number;
-    /** Spendable offchain balance (`settled + preconfirmed`). */
+    /**
+     * Immediately spendable offchain balance: the `settled + preconfirmed`
+     * rule applied only to VTXOs not locked by an in-flight (non-terminal)
+     * intent. Equals `settled + preconfirmed` when nothing is intent-locked.
+     */
     available: number;
     /** Recoverable balance from subdust or expired (swept) virtual outputs. */
     recoverable: number;
@@ -4539,4 +4694,4 @@ declare namespace ProtoTypes {
     export {  };
 }
 
-export { type Coin as $, type ArkTransaction as A, type BatchStartedEvent as B, type ContractRepository as C, type BatchFinalizationEvent as D, type ExtendedVirtualCoin as E, type BatchFinalizedEvent as F, type GetVtxosFilter as G, type BatchFailedEvent as H, type IWallet as I, type TreeTxEvent as J, type TreeSignatureEvent as K, type DescriptorProvider as L, type IReadonlyWallet as M, type ReadonlyIdentity as N, type Network as O, type OnchainProvider as P, type DelegateProvider as Q, type Recipient as R, type SendBitcoinParams as S, type TxNotification as T, type ReadonlyWalletConfig as U, VtxoScript as V, type WalletRepository as W, type IReadonlyAssetManager as X, type NetworkName as Y, type ArkInfo as Z, ArkAddress as _, type Identity as a, DelegatorManagerImpl as a$, ContractManager as a0, CSVMultisigTapscript as a1, type SettlementConfig as a2, VtxoManager as a3, type SignerSession as a4, type SignedIntent as a5, Intent as a6, type DescriptorSigningRequest as a7, Transaction as a8, type IntentFeeConfig as a9, type EncodedVtxoScript as aA, type Status as aB, type Outpoint as aC, type ChainTx as aD, type PathContext as aE, type ActivityIntent as aF, type ActivityResolver as aG, type ArkTapscript as aH, type Asset as aI, type AssetMetadata as aJ, type BaseWalletConfig as aK, type BatchInfo as aL, type BatchSignableIdentity as aM, CLTVMultisigTapscript as aN, ChainTxType as aO, type CommitmentTx as aP, ConditionCSVMultisigTapscript as aQ, ConditionMultisigTapscript as aR, type ContractBalance as aS, type ContractEventCallback as aT, type ContractHandler as aU, type ContractManagerConfig as aV, type ContractState as aW, type ContractVtxo as aX, ContractWatcher as aY, DelegateManagerImpl as aZ, type DelegateOptions as a_, type OffchainInput as aa, FeeAmount as ab, type OnchainInput as ac, type FeeOutput as ad, type ContractWatcherConfig as ae, type FeeInfo as af, type CreateContractParams as ag, type GetContractsFilter as ah, type GetSpendablePathsOptions as ai, type GetAllSpendingPathsOptions as aj, type IssuanceParams as ak, type ReissuanceParams as al, type BurnParams as am, type RenewVtxosOptions as an, type ContractWithVtxos as ao, type PathSelection as ap, type ContractEvent as aq, type AssetDetails as ar, type IssuanceResult as as, type DelegateInfo as at, type MigrationGlobalSkipReason as au, type MigrationLegSkipReason as av, type SignerStatus as aw, type StorageConfig as ax, type IVtxoManager as ay, type ExplorerTransaction as az, type WalletConfig as b, isSpendable as b$, type DelegatorProvider as b0, type DeprecatedSignerMigrationReport as b1, type DeprecatedSignerReport as b2, DigestMismatchError as b3, type Discoverable as b4, type DiscoveredContract as b5, type DiscoveryDeps as b6, ESPLORA_URL as b7, EsploraProvider as b8, type ExtendedContractVtxo as b9, type TapLeaves as bA, TapTreeCoder as bB, TapscriptType as bC, type TreeNonces as bD, type TreePartialSigs as bE, type Tx as bF, type TxHistoryRecord as bG, type TxKey as bH, type TxTreeNode as bI, TxType as bJ, type VirtualStatus as bK, type Vtxo as bL, type VtxoChain as bM, type VtxoType as bN, type WalletMode as bO, boardingResolver as bP, classifyAgainstSignerSet as bQ, classifyContractSigner as bR, createDefaultActivityRegistry as bS, decodeTapscript as bT, getNetwork as bU, getSequence as bV, isBatchSignable as bW, isCooperativelyMigratable as bX, isDiscoverable as bY, isExpired as bZ, isRecoverable as b_, type GroupMembership as ba, type HandlerError as bb, type IDelegatorManager as bc, IndexerTxType as bd, type KnownMetadata as be, type MigrateDeprecatedSignerOptions as bf, type MigrationLegReport as bg, type MigrationVtxoRef as bh, MultisigTapscript as bi, type Nonces as bj, type Output as bk, type PageResponse as bl, type PaginationOptions as bm, PartialSig as bn, type ProviderClass as bo, RestDelegateProvider as bp, RestDelegatorProvider as bq, type ScanContractsOptions as br, type ScanResult as bs, type ScheduledSession as bt, SettlementEventType as bu, type SignRequest as bv, type SignerClassification as bw, type SignerSet as bx, type SubscriptionEvent as by, type SubscriptionHeartbeat as bz, type WalletBalance as c, isSubdust as c0, isVtxoExpiringSoon as c1, networks as c2, signerSetFromInfo as c3, toXOnlySignerHex as c4, 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 VtxoRepositoryKey as u, type WalletState as v, type ContractFilter as w, type TreeSigningStartedEvent as x, TxTree as y, type TreeNoncesEvent as z };
+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 };

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

@@ -965,6 +965,11 @@ interface IVtxoManager {
      * Available regardless of the `deprecatedSignerMigration` config flag (that
      * flag only gates the automatic poll-loop pass).
      *
+     * As a side effect, refreshes the wallet's cached deprecated-signer set from
+     * fresh server info, so a subsequent `settle()` correctly excludes EXPIRED
+     * deprecated-signer inputs. To refresh that filter without migrating, call
+     * `wallet.refreshDeprecatedSigners(await wallet.arkProvider.getInfo())` instead.
+     *
      * @returns A report of what was migrated, skipped, expired, or failed.
      */
     migrateDeprecatedSignerVtxos(options?: MigrateDeprecatedSignerOptions): Promise<DeprecatedSignerMigrationReport>;
@@ -1650,6 +1655,120 @@ interface ContractRepository extends AsyncDisposable {
     deleteContract(script: string): Promise<void>;
 }
 
+type ArkIntentState = "waiting_to_submit" | "waiting_for_batch" | "batch_in_progress" | "batch_failed" | "batch_succeeded" | "cancelled";
+declare const INTENT_TERMINAL_STATES: ReadonlySet<ArkIntentState>;
+declare function isTerminalIntentState(s: ArkIntentState): boolean;
+interface ArkIntent {
+    /** Intent proof tx id. Primary key. */
+    intentTxId: string;
+    /**
+     * Server-assigned batch intent id. Unique when present: saving a *different*
+     * intentTxId that reuses a live intentId is rejected (NArk parity). Absent
+     * until the intent is registered with arkd.
+     */
+    intentId?: string;
+    state: ArkIntentState;
+    validFrom?: number;
+    validUntil?: number;
+    createdAt: number;
+    updatedAt: number;
+    /** hex PSBT. */
+    registerProof: string;
+    /** canonical JSON signed by the register proof. */
+    registerProofMessage: string;
+    /** hex PSBT. */
+    deleteProof: string;
+    deleteProofMessage: string;
+    batchId?: string;
+    commitmentTransactionId?: string;
+    cancellationReason?: string;
+    partialForfeits: string[];
+    signerDescriptor?: string;
+    /** Input VTXOs locked by this intent. */
+    intentVtxos: Outpoint[];
+}
+interface IntentFilter {
+    intentTxIds?: string[];
+    intentIds?: string[];
+    /** Intents whose `intentVtxos` intersect any of these outpoints. */
+    containingInputs?: Outpoint[];
+    states?: ArkIntentState[];
+    /** Intents valid at this ms-epoch instant (null bounds = open). */
+    validAt?: number;
+    /** Substring match over intentId, batchId, commitmentTransactionId. */
+    searchText?: string;
+    skip?: number;
+    take?: number;
+}
+interface IntentRepository extends AsyncDisposable {
+    readonly version: 1;
+    clear(): Promise<void>;
+    /** Upsert by `intentTxId`; implementation sets `updatedAt = Date.now()`. */
+    saveIntent(intent: ArkIntent): Promise<void>;
+    getIntents(filter?: IntentFilter): Promise<ArkIntent[]>;
+    /**
+     * Outpoints held by NON-terminal intents — `waiting_to_submit`,
+     * `waiting_for_batch`, and `batch_in_progress` — to exclude from spendable
+     * balance. Terminal states never lock.
+     *
+     * Deliberate divergence from NArk EF storage, whose `GetLockedVtxoOutpoints`
+     * locks only `WaitingToSubmit`/`WaitingForBatch`: the TS wallet balance is
+     * offline-first and reads this set as its single source of coin locking, so
+     * it must also hold inputs already committed to an in-progress batch. NArk
+     * excludes `BatchInProgress` here but protects those inputs through its
+     * active-intent services instead.
+     */
+    getLockedVtxoOutpoints(): Promise<Outpoint[]>;
+}
+
+/**
+ * Type of a tx inside a VTXO's chain (commitment → leaf), as reported by
+ * arkd's chain indexer. Values pinned verbatim from NArk `ChainedTxType.cs`.
+ */
+declare enum ChainedTxType {
+    Unspecified = 0,
+    Commitment = 1,
+    Ark = 2,
+    Tree = 3,
+    Checkpoint = 4
+}
+/** A single virtual transaction in the VTXO tree. */
+interface VirtualTx {
+    /** Transaction id (hex). Primary key. */
+    txid: string;
+    /** Base64-encoded PSBT body; null when only metadata has been cached. */
+    psbt: string | null;
+    /** Operator pre-signature expiry, ms epoch; null if not applicable. */
+    expiresAt: number | null;
+    /** Tx type as reported by arkd's chain indexer. */
+    type: ChainedTxType;
+}
+/**
+ * Links a VTXO to one virtual tx in its exit branch, ordered.
+ * `position` 0 = closest to commitment (tree root); higher = closer to leaf.
+ */
+interface VtxoBranch {
+    vtxoTxid: string;
+    vtxoVout: number;
+    virtualTxid: string;
+    position: number;
+}
+interface VirtualTxRepository extends AsyncDisposable {
+    readonly version: 1;
+    clear(): Promise<void>;
+    /** Upsert: non-null incoming fields overwrite; null (or, for `type`,
+     *  `Unspecified`) is treated as absent and preserves the stored value. */
+    upsertVirtualTxs(txs: VirtualTx[]): Promise<void>;
+    getVirtualTx(txid: string): Promise<VirtualTx | null>;
+    /** Replace the entire stored branch for a VTXO. */
+    setBranch(vtxo: Outpoint, branch: VtxoBranch[]): Promise<void>;
+    /** Resolved virtual txs in the VTXO's branch, ordered by position asc. */
+    getBranch(vtxo: Outpoint): Promise<VirtualTx[]>;
+    hasBranch(vtxo: Outpoint): Promise<boolean>;
+    /** Drop branch rows for a spent VTXO, then delete now-orphaned VirtualTx rows. */
+    pruneForSpentVtxo(vtxo: Outpoint): Promise<void>;
+}
+
 type RefreshVtxosOptions = {
     scripts?: string[];
     after?: number;
@@ -1877,6 +1996,13 @@ interface ContractManagerConfig {
     contractRepository: ContractRepository;
     /** The wallet repository for virtual output storage (single source of truth) */
     walletRepository: WalletRepository;
+    /**
+     * Optional intent store. When present, the online sync path reconciles
+     * persisted non-terminal settlement intents against authoritative indexer
+     * state (crash recovery) on boot and reconnect — see
+     * {@link reconcileIntents}. Absent ⇒ no-op.
+     */
+    intentRepository?: IntentRepository;
     /** Watcher configuration */
     watcherConfig?: Partial<ContractWatcherConfig>;
 }
@@ -1963,6 +2089,15 @@ declare class ContractManager implements IContractManager {
      * outputs that could sit outside any delta window.
      */
     private reconcileWatched;
+    /**
+     * Crash-recovery for persisted settlement intents: reconcile any
+     * non-terminal intent left behind by a mid-settle crash against
+     * authoritative indexer state (see {@link reconcileIntents}). Runs on the
+     * online sync path only — boot and subscription reconnect — never from a
+     * wallet read API. Best-effort: intent recovery is not a sync invariant, so
+     * a failure is logged and sync continues. No-op without an intent store.
+     */
+    private reconcileStaleIntents;
     /**
      * Create and register a new contract.
      *
@@ -3195,6 +3330,22 @@ type StorageConfig = {
     walletRepository: WalletRepository;
     /** Contract-state repository implementation. */
     contractRepository: ContractRepository;
+    /**
+     * Optional intent-lifecycle repository. Opt-in: when present, the wallet
+     * persists settlement intents and excludes intent-locked VTXOs from
+     * spendable balance. Absent ⇒ those code paths are no-ops.
+     */
+    intentRepository?: IntentRepository;
+    /**
+     * **Experimental / inert.** Optional virtual-tx (exit-branch) repository.
+     * Today it is only a best-effort raw-PSBT cache that unilateral exit
+     * ({@link Unroll}) reads and writes when a caller passes it to
+     * `Unroll.Session.create`. Normal wallet/contract sync does NOT populate,
+     * maintain, or prune it, and {@link ContractManager} is never given it —
+     * branch/full-mode persistence is out of scope for this release. Treat this
+     * option as experimental until those paths land. Absent ⇒ no-op.
+     */
+    virtualTxRepository?: VirtualTxRepository;
 };
 /**
  * Provider class constructor interface for dependency injection.
@@ -3233,7 +3384,11 @@ interface WalletBalance {
     settled: number;
     /** Spendable preconfirmed (unfinalized) balance. */
     preconfirmed: number;
-    /** Spendable offchain balance (`settled + preconfirmed`). */
+    /**
+     * Immediately spendable offchain balance: the `settled + preconfirmed`
+     * rule applied only to VTXOs not locked by an in-flight (non-terminal)
+     * intent. Equals `settled + preconfirmed` when nothing is intent-locked.
+     */
     available: number;
     /** Recoverable balance from subdust or expired (swept) virtual outputs. */
     recoverable: number;
@@ -4539,4 +4694,4 @@ declare namespace ProtoTypes {
     export {  };
 }
 
-export { type Coin as $, type ArkTransaction as A, type BatchStartedEvent as B, type ContractRepository as C, type BatchFinalizationEvent as D, type ExtendedVirtualCoin as E, type BatchFinalizedEvent as F, type GetVtxosFilter as G, type BatchFailedEvent as H, type IWallet as I, type TreeTxEvent as J, type TreeSignatureEvent as K, type DescriptorProvider as L, type IReadonlyWallet as M, type ReadonlyIdentity as N, type Network as O, type OnchainProvider as P, type DelegateProvider as Q, type Recipient as R, type SendBitcoinParams as S, type TxNotification as T, type ReadonlyWalletConfig as U, VtxoScript as V, type WalletRepository as W, type IReadonlyAssetManager as X, type NetworkName as Y, type ArkInfo as Z, ArkAddress as _, type Identity as a, DelegatorManagerImpl as a$, ContractManager as a0, CSVMultisigTapscript as a1, type SettlementConfig as a2, VtxoManager as a3, type SignerSession as a4, type SignedIntent as a5, Intent as a6, type DescriptorSigningRequest as a7, Transaction as a8, type IntentFeeConfig as a9, type EncodedVtxoScript as aA, type Status as aB, type Outpoint as aC, type ChainTx as aD, type PathContext as aE, type ActivityIntent as aF, type ActivityResolver as aG, type ArkTapscript as aH, type Asset as aI, type AssetMetadata as aJ, type BaseWalletConfig as aK, type BatchInfo as aL, type BatchSignableIdentity as aM, CLTVMultisigTapscript as aN, ChainTxType as aO, type CommitmentTx as aP, ConditionCSVMultisigTapscript as aQ, ConditionMultisigTapscript as aR, type ContractBalance as aS, type ContractEventCallback as aT, type ContractHandler as aU, type ContractManagerConfig as aV, type ContractState as aW, type ContractVtxo as aX, ContractWatcher as aY, DelegateManagerImpl as aZ, type DelegateOptions as a_, type OffchainInput as aa, FeeAmount as ab, type OnchainInput as ac, type FeeOutput as ad, type ContractWatcherConfig as ae, type FeeInfo as af, type CreateContractParams as ag, type GetContractsFilter as ah, type GetSpendablePathsOptions as ai, type GetAllSpendingPathsOptions as aj, type IssuanceParams as ak, type ReissuanceParams as al, type BurnParams as am, type RenewVtxosOptions as an, type ContractWithVtxos as ao, type PathSelection as ap, type ContractEvent as aq, type AssetDetails as ar, type IssuanceResult as as, type DelegateInfo as at, type MigrationGlobalSkipReason as au, type MigrationLegSkipReason as av, type SignerStatus as aw, type StorageConfig as ax, type IVtxoManager as ay, type ExplorerTransaction as az, type WalletConfig as b, isSpendable as b$, type DelegatorProvider as b0, type DeprecatedSignerMigrationReport as b1, type DeprecatedSignerReport as b2, DigestMismatchError as b3, type Discoverable as b4, type DiscoveredContract as b5, type DiscoveryDeps as b6, ESPLORA_URL as b7, EsploraProvider as b8, type ExtendedContractVtxo as b9, type TapLeaves as bA, TapTreeCoder as bB, TapscriptType as bC, type TreeNonces as bD, type TreePartialSigs as bE, type Tx as bF, type TxHistoryRecord as bG, type TxKey as bH, type TxTreeNode as bI, TxType as bJ, type VirtualStatus as bK, type Vtxo as bL, type VtxoChain as bM, type VtxoType as bN, type WalletMode as bO, boardingResolver as bP, classifyAgainstSignerSet as bQ, classifyContractSigner as bR, createDefaultActivityRegistry as bS, decodeTapscript as bT, getNetwork as bU, getSequence as bV, isBatchSignable as bW, isCooperativelyMigratable as bX, isDiscoverable as bY, isExpired as bZ, isRecoverable as b_, type GroupMembership as ba, type HandlerError as bb, type IDelegatorManager as bc, IndexerTxType as bd, type KnownMetadata as be, type MigrateDeprecatedSignerOptions as bf, type MigrationLegReport as bg, type MigrationVtxoRef as bh, MultisigTapscript as bi, type Nonces as bj, type Output as bk, type PageResponse as bl, type PaginationOptions as bm, PartialSig as bn, type ProviderClass as bo, RestDelegateProvider as bp, RestDelegatorProvider as bq, type ScanContractsOptions as br, type ScanResult as bs, type ScheduledSession as bt, SettlementEventType as bu, type SignRequest as bv, type SignerClassification as bw, type SignerSet as bx, type SubscriptionEvent as by, type SubscriptionHeartbeat as bz, type WalletBalance as c, isSubdust as c0, isVtxoExpiringSoon as c1, networks as c2, signerSetFromInfo as c3, toXOnlySignerHex as c4, 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 VtxoRepositoryKey as u, type WalletState as v, type ContractFilter as w, type TreeSigningStartedEvent as x, TxTree as y, type TreeNoncesEvent as z };
+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 };

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

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

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

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

package/dist/{chunk-ALISWEQ5.cjs → chunk-3AQNLQPM.cjs}

@@ -351,16 +351,31 @@ function prepareCoinAsIntentProofInput(coin) {
 }
 
 // package.json
-var version = "0.4.41";
+var version = "0.4.43";
 
 // src/utils/fetch.ts
 var buildVersion = "0.9.9";
 var sdkVersion = `ts-sdk/${version}`;
+var FetchError = class extends Error {
+  /** The request URL that failed, when derivable from the `fetch` input. */
+  url;
+  /** The HTTP method of the failed request (defaults to `"GET"`). */
+  method;
+  constructor(message, options) {
+    super(message, { cause: options.cause });
+    this.name = "FetchError";
+    this.url = options.url;
+    this.method = options.method;
+  }
+};
 function baseFetch(input, init) {
   if (typeof globalThis.fetch !== "function") {
     throw new Error("Fetch API is not available in this environment.");
   }
-  return globalThis.fetch(input, init);
+  return globalThis.fetch(input, init).catch((cause) => {
+    const { url, method } = describeRequest(input, init);
+    throw new FetchError(`Network request failed: ${method} ${url}`, { url, method, cause });
+  });
 }
 function fetch(input, init) {
   const headers = new Headers(init?.headers);
@@ -368,6 +383,25 @@ function fetch(input, init) {
   headers.set("X-SDK-VERSION", sdkVersion);
   return baseFetch(input, { ...init, headers });
 }
+function describeRequest(input, init) {
+  let url;
+  if (typeof input === "string") {
+    url = input;
+  } else if (input instanceof URL) {
+    url = input.href;
+  } else {
+    url = input.url;
+  }
+  let method;
+  if (init?.method !== void 0) {
+    method = init.method;
+  } else if (input instanceof Request) {
+    method = input.method;
+  } else {
+    method = "GET";
+  }
+  return { url, method };
+}
 
 // src/providers/utils.ts
 function createAbortError() {
@@ -2788,6 +2822,7 @@ exports.ChainTxType = ChainTxType;
 exports.ConditionWitness = ConditionWitness;
 exports.CosignerPublicKey = CosignerPublicKey;
 exports.DigestMismatchError = DigestMismatchError;
+exports.FetchError = FetchError;
 exports.IndexerTxType = IndexerTxType;
 exports.Metadata = Metadata;
 exports.OP_RETURN_EMPTY_PKSCRIPT = OP_RETURN_EMPTY_PKSCRIPT;
@@ -2809,5 +2844,5 @@ exports.isFetchTimeoutError = isFetchTimeoutError;
 exports.maybeArkError = maybeArkError;
 exports.sdkVersion = sdkVersion;
 exports.setArkPsbtField = setArkPsbtField;
-//# sourceMappingURL=chunk-ALISWEQ5.cjs.map
-//# sourceMappingURL=chunk-ALISWEQ5.cjs.map
+//# sourceMappingURL=chunk-3AQNLQPM.cjs.map
+//# sourceMappingURL=chunk-3AQNLQPM.cjs.map