@arkade-os/sdk 0.4.50 → 0.4.52

package/README.md

@@ -1247,9 +1247,35 @@ This is required for MuSig2 settlements and cryptographic operations.
 
 ### Contract Management
 
-Both `Wallet` and `ServiceWorkerWallet` use a `ContractManager` internally to watch for virtual outputs. This provides resilient connection handling with automatic reconnection and failsafe polling - for your wallet's default address and any external contracts you register (Boltz swaps, HTLCs, etc.).
+Both `Wallet` and `ServiceWorkerWallet` use a `ContractManager` internally to watch for virtual outputs and persist them into repositories. This provides resilient connection handling with automatic reconnection and failsafe polling - for your wallet's default address and any external contracts you register (Boltz swaps, HTLCs, etc.).
 
-When you call `wallet.notifyIncomingFunds()` or use `waitForIncomingFunds()`, it uses the ContractManager under the hood, giving you automatic reconnection and failsafe polling for free - no code changes needed.
+When you call `wallet.notifyIncomingFunds()` or use `waitForIncomingFunds()`, it uses the ContractManager under the hood, giving you automatic reconnection and repository-backed event replay for free - no code changes needed.
+
+`watcherConfig.failsafePollIntervalMs` (default `20_000`) controls how often the watcher replays repository changes into contract events; it does not fetch fresh VTXOs from the indexer.
+
+#### HD look-ahead window
+
+HD wallets (`walletMode: 'hd'`, or an explicit HD `DescriptorProvider`) also watch a band of *unused* offchain receive scripts around their allocation watermark, so a payment to an address that some other party issued from the same seed — a merchant backend such as BTCPay Server, or the .NET SDK driving the same wallet — arrives without the user calling `restore()`. `lookAheadWindow` (default `20`) is the per-side width of that band: the wallet watches `[watermark - N, watermark + N]`. Speculative entries are subscription-only; they become contract rows, and enter balances, only once funded.
+
+The issuer, not the wallet, picks the contract shape, so each index is watched at *every* variant the wallet could own there: `default` and `delegate`, crossed with the unilateral-exit timelock matrix and the operator's current plus deprecated signers. That is the candidate set `restore()` probes too, so watching and restoring cover identical scripts.
+
+```typescript
+const wallet = await Wallet.create({
+  identity,
+  walletMode: 'hd',
+  lookAheadWindow: 50,  // issuer hands out long runs of unpaid invoices
+})
+
+// Same option on the service-worker wallet; it is forwarded to the worker's inner wallet.
+const swWallet = await ServiceWorkerWallet.setup({
+  serviceWorkerPath: '/service-worker.js',
+  identity,
+  walletMode: 'hd',
+  lookAheadWindow: 50,
+})
+```
+
+Raise it when the external issuer is expected to burn more than `N` consecutive addresses without any of them being paid — every index in such a run is a miss, and the funded one sits past the band. When that happens the funds are invisible until a `restore()` whose `gapLimit` is large enough to cross the run (`wallet.restore({ gapLimit: 200 })`); a default restore closes its gap window before reaching the funded index. Keep the value modest: the band adds up to `2N + 1` indices × the candidate matrix (typically 1-4 scripts each) to the wallet's subscription.
 
 For advanced use cases, you can access the ContractManager directly to register external contracts:
 
@@ -1312,21 +1338,22 @@ const allPaths = await manager.getAllSpendingPaths({
 // Fetch contracts together with their current virtual outputs
 const contractsWithVtxos = await manager.getContractsWithVtxos()
 
-// Force a full refresh from the indexer when needed
+// Force an indexer refresh of the watched contracts when needed
 await manager.refreshVtxos()
 
 // Stop watching
 unsubscribe()
 ```
 
-The watcher features:
-- **Automatic reconnection** with exponential backoff (1s → 30s max)
-- **Failsafe polling** every 60 seconds to catch missed events
-- **Immediate sync** on connection and after failures
+Contract freshness behavior:
+- **Automatic reconnection** with exponential backoff (1s → 5s max)
+- **Immediate sync** on manager initialization, subscription reconnect, and contract events
+- **Failsafe polling** every 20 seconds by default to catch missed events, configurable via `watcherConfig.failsafePollIntervalMs`
+- **Manual refresh** through `manager.refreshVtxos()`; pass `{ includeInactive: true }` to sweep every repository contract
 
 ### Repository Pattern
 
-Most users don't need to touch repositories directly — `Wallet` and `ContractManager` already read and write through them. They are documented here for advanced integrations (custom storage backends, offline-first apps, repository inspection).
+Most users don't need to touch repositories directly — `Wallet` reads through them and `ContractManager` owns VTXO/contract synchronization into them. They are documented here for advanced integrations (custom storage backends, offline-first apps, repository inspection).
 
 ```typescript
 // Wallet repository — VTXOs, UTXOs, transaction history, settings

package/dist/adapters/expo.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
-var chunkTO3SR7TY_cjs = require('../chunk-TO3SR7TY.cjs');
-require('../chunk-SIAVTHMZ.cjs');
+var chunkE6RT5XYB_cjs = require('../chunk-E6RT5XYB.cjs');
+require('../chunk-FZPYPEWN.cjs');
 require('../chunk-E7HB3GKK.cjs');
 require('../chunk-5BLDMQED.cjs');
 
@@ -9,11 +9,11 @@ require('../chunk-5BLDMQED.cjs');
 
 Object.defineProperty(exports, "ExpoArkProvider", {
   enumerable: true,
-  get: function () { return chunkTO3SR7TY_cjs.ExpoArkProvider; }
+  get: function () { return chunkE6RT5XYB_cjs.ExpoArkProvider; }
 });
 Object.defineProperty(exports, "ExpoIndexerProvider", {
   enumerable: true,
-  get: function () { return chunkTO3SR7TY_cjs.ExpoIndexerProvider; }
+  get: function () { return chunkE6RT5XYB_cjs.ExpoIndexerProvider; }
 });
 //# sourceMappingURL=expo.cjs.map
 //# sourceMappingURL=expo.cjs.map

package/dist/adapters/expo.d.cts

@@ -1,5 +1,5 @@
-import { k as RestArkProvider, i as SettlementEvent, T as TxNotification, l as RestIndexerProvider, m as SubscriptionResponse } from '../ark-ApoclKQZ.cjs';
-export { n as ArkProvider, o as IndexerProvider } from '../ark-ApoclKQZ.cjs';
+import { k as RestArkProvider, i as SettlementEvent, T as TxNotification, l as RestIndexerProvider, m as SubscriptionResponse } from '../ark-B69ugeJw.cjs';
+export { n as ArkProvider, o as IndexerProvider } from '../ark-B69ugeJw.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 { k as RestArkProvider, i as SettlementEvent, T as TxNotification, l as RestIndexerProvider, m as SubscriptionResponse } from '../ark-ApoclKQZ.js';
-export { n as ArkProvider, o as IndexerProvider } from '../ark-ApoclKQZ.js';
+import { k as RestArkProvider, i as SettlementEvent, T as TxNotification, l as RestIndexerProvider, m as SubscriptionResponse } from '../ark-B69ugeJw.js';
+export { n as ArkProvider, o as IndexerProvider } from '../ark-B69ugeJw.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-ZXRSSBCF.js';
-import '../chunk-AA4Q2J57.js';
+export { ExpoArkProvider, ExpoIndexerProvider } from '../chunk-WIVQWYPZ.js';
+import '../chunk-ZK3JITHP.js';
 import '../chunk-EFNLTS6Q.js';
 import '../chunk-NSBPE2FW.js';
 //# sourceMappingURL=expo.js.map

package/dist/adapters/indexedDB.cjs

@@ -1,8 +1,8 @@
 'use strict';
 
-var chunk6BQTROB4_cjs = require('../chunk-6BQTROB4.cjs');
-require('../chunk-SIAVTHMZ.cjs');
-require('../chunk-LJQ2VQBE.cjs');
+var chunkML33GFCH_cjs = require('../chunk-ML33GFCH.cjs');
+require('../chunk-FZPYPEWN.cjs');
+require('../chunk-IEMPH7J6.cjs');
 require('../chunk-E7HB3GKK.cjs');
 require('../chunk-5BLDMQED.cjs');
 
@@ -11,7 +11,7 @@ var IndexedDBStorageAdapter = class {
   dbName;
   version;
   db = null;
-  constructor(dbName, version = chunk6BQTROB4_cjs.DB_VERSION) {
+  constructor(dbName, version = chunkML33GFCH_cjs.DB_VERSION) {
     this.dbName = dbName;
     this.version = version;
   }

package/dist/adapters/indexedDB.js

@@ -1,6 +1,6 @@
-import { DB_VERSION } from '../chunk-SNTSB6M2.js';
-import '../chunk-AA4Q2J57.js';
-import '../chunk-MBSYQ3WX.js';
+import { DB_VERSION } from '../chunk-AXCKRS2D.js';
+import '../chunk-ZK3JITHP.js';
+import '../chunk-UZLQUWYP.js';
 import '../chunk-EFNLTS6Q.js';
 import '../chunk-NSBPE2FW.js';
 

package/dist/{ark-ApoclKQZ.d.cts → ark-B69ugeJw.d.cts}

@@ -2102,6 +2102,15 @@ interface IContractManager extends Disposable {
      * Outpoints not owned by any tracked contract are silently dropped.
      */
     refreshOutpoints(outpoints: Outpoint[]): Promise<void>;
+    /**
+     * Rebuild the HD look-ahead watch window around the current allocation
+     * watermark. No-op when the manager was configured without `lookAhead`.
+     *
+     * Call after anything that moves the watermark (restore, boarding
+     * allocation, receive rotation, server-signer rotation). Concurrent calls
+     * coalesce into a single drain.
+     */
+    refillLookAhead(): Promise<void>;
     /**
      * Explicit, gap-limit contract discovery used by `wallet.restore()`.
      *
@@ -2192,6 +2201,33 @@ interface ContractManagerConfig {
     onVtxosSpent?: (vtxos: Outpoint[]) => Promise<void>;
     /** Watcher configuration */
     watcherConfig?: Partial<ContractWatcherConfig>;
+    /**
+     * Enables the HD look-ahead watch window. Absent ⇒ feature off (static /
+     * non-HD wallets, third-party embedders). See
+     * {@link ContractManager.refillLookAhead}.
+     */
+    lookAhead?: LookAheadConfig;
+}
+/**
+ * Wallet-injected surface backing the HD look-ahead window. Kept as a
+ * callback bundle so the contracts layer never learns what an HD descriptor
+ * is (mirrors {@link ScanContractsOptions.materialize}).
+ */
+interface LookAheadConfig {
+    /** Per-side band bound: the window spans `[max(0, w - size), w + size]`. */
+    size: number;
+    /** Current allocation watermark (`lastIndexUsed ?? -1`). */
+    currentWatermark(): Promise<number>;
+    /** Signing descriptor at an HD index. Pure derivation. */
+    materialize(index: number): string;
+    /**
+     * Key and timelock axes an externally issued receive script could be
+     * anchored to. Read once per refill, so a band rebuilt after
+     * `rotateServerSigner` fans the new signer set.
+     */
+    candidateDeps(): CandidateDeps;
+    /** Fired after a speculative entry at `index` is promoted to a real row. */
+    onPromoted?(index: number): Promise<void>;
 }
 /**
  * Parameters for creating a new contract.
@@ -2257,6 +2293,12 @@ declare class ContractManager implements IContractManager {
     private syncDegradedReason?;
     /** Epoch-ms of the last successful provider sync, if any. */
     private lastSyncedAt?;
+    /** Speculative look-ahead scripts, keyed by script. @see LookAheadEntry */
+    private lookAheadEntries;
+    /** In-flight look-ahead drain, if any. @see scheduleLookAheadDrain */
+    private lookAheadDrain?;
+    /** A refill was requested while a drain was running. */
+    private lookAheadDirty;
     private constructor();
     /**
      * Static factory method for creating a new ContractManager.
@@ -2298,6 +2340,63 @@ declare class ContractManager implements IContractManager {
      * a failure is logged and sync continues. No-op without an intent store.
      */
     private reconcileStaleIntents;
+    /** @see IContractManager.refillLookAhead */
+    refillLookAhead(): Promise<void>;
+    /**
+     * Serialized drain of the look-ahead band: concurrent callers join the
+     * active drain and mark it dirty, an idle call starts a new one. Promotion
+     * can uncover more funded indices, and boot / SSE / rotate / reconnect can
+     * all request a refill at once, so the loop coalesces them instead of
+     * recursing.
+     */
+    private scheduleLookAheadDrain;
+    /**
+     * Request a drain without awaiting it. Used from inside a sync (promotion),
+     * where awaiting the drain that the sync itself is part of would deadlock.
+     */
+    private requestLookAheadDrain;
+    /**
+     * Rebuild the speculative watch band around the allocation watermark.
+     *
+     * NArk needs no analogue because it *is* the address issuer: it persists a
+     * contract row at derivation time, so its watched set is a superset of
+     * every address it ever advertised. This SDK, when a third party issues
+     * addresses from the shared seed, cannot observe those allocations at all —
+     * the window is how a non-issuer compensates.
+     *
+     * Entries are registered with the watcher but NOT persisted: they become
+     * repository rows only once funded (see {@link promoteLookAheadHits}).
+     *
+     * Each index contributes every {@link Discoverable.candidatesAt} candidate —
+     * the same set `restore()`'s gap scan probes, since the wallet cannot know
+     * which variant a third-party issuer handed out.
+     */
+    private ensureLookAhead;
+    /**
+     * One-time full-history sync for speculative entries the manager has not
+     * successfully caught up on yet.
+     *
+     * Every normal sync uses the cursor-derived delta window and SSE only
+     * delivers events after a script is subscribed, so a script first
+     * registered after its funding time would otherwise be skipped forever
+     * (upgrade migration, or a band that slid over an already-funded index).
+     * The entries are passed as in-memory contracts because `refreshVtxos`
+     * resolves scripts through the repository, where they deliberately do not
+     * exist. Targeted + explicitly windowed, so the global cursor stays put.
+     */
+    private runLookAheadCatchUp;
+    /**
+     * Promote every look-ahead entry funded by `vtxos` into a real repository
+     * row, returning the persisted rows keyed by script.
+     *
+     * MUST run on each raw indexer fetch before `annotateVtxos`:
+     * `extendVirtualCoinForContract` throws when a VTXO's script has no
+     * contract row, so a funded window entry has to be persisted before its
+     * VTXOs are annotated and saved. Callers also swap the returned rows into
+     * the local contract maps they built pre-promotion, so `saveVtxosForContract`
+     * and `onVtxosPersisted` never see the synthetic watcher object.
+     */
+    private promoteLookAheadHits;
     /**
      * Create and register a new contract.
      *
@@ -2324,6 +2423,7 @@ declare class ContractManager implements IContractManager {
      * `persisted` is `true`.
      */
     private upsertContract;
+    private upsertContractRow;
     /**
      * Explicit, gap-limit contract discovery (see {@link IContractManager.scanContracts}).
      *
@@ -2787,6 +2887,12 @@ interface DiscoveryDeps {
     /** Present only for delegate wallets. */
     delegatePubKey?: Uint8Array;
 }
+/**
+ * The I/O-free subset of {@link DiscoveryDeps}: the axes a receive script can
+ * be anchored to. `DiscoveryDeps` satisfies it structurally, so one
+ * {@link Discoverable.candidatesAt} serves the scan and the look-ahead band.
+ */
+type CandidateDeps = Pick<DiscoveryDeps, "network" | "serverPubKey" | "csvTimelocks"> & Pick<Partial<DiscoveryDeps>, "deprecatedSignerPubKeys" | "delegatePubKey">;
 /**
  * Optional capability a {@link ContractHandler} implements to participate
  * in `wallet.restore()`'s gap-limit scan. The scanner owns the index
@@ -2818,7 +2924,19 @@ interface Discoverable {
         index: number;
         descriptor: string;
     }[], deps: DiscoveryDeps): Promise<Map<number, DiscoveredContract[]>>;
+    /**
+     * Optional: every unverified contract this handler could own at one HD
+     * index — pure derivation, no I/O, no metadata. `discoverRange` probes
+     * these scripts and the look-ahead band subscribes to them, so the two
+     * cannot cover different sets.
+     *
+     * `boarding` omits it: its probe is an on-chain address lookup, and that
+     * keeps it out of the band (deposits are watched on their own channel).
+     */
+    candidatesAt?(index: number, descriptor: string, deps: CandidateDeps): DiscoveredContract[];
 }
+/** Duck-typed guard for the pure candidate surface. @see Discoverable.candidatesAt */
+declare function hasCandidates(handler: ContractHandler<unknown> | undefined): handler is ContractHandler<unknown> & Required<Pick<Discoverable, "candidatesAt">>;
 /** Duck-typed guard (mirrors `hasReceiveRotatorFactory`). */
 declare function isDiscoverable(handler: ContractHandler<unknown> | undefined): handler is ContractHandler<unknown> & Discoverable;
 /**
@@ -3624,6 +3742,20 @@ interface WalletConfig extends ReadonlyWalletConfig {
      * @defaultValue `'auto'`
      */
     walletMode?: WalletMode;
+    /**
+     * Per-side width of the HD look-ahead watch window: the wallet watches
+     * missing offchain receive scripts across `[watermark - N, watermark + N]`
+     * so funds paid to an address issued by an external party (a merchant
+     * backend sharing the seed) arrive without an explicit `restore()`.
+     *
+     * Only meaningful for HD wallets (`walletMode: 'hd'` or an HD
+     * {@link DescriptorProvider}); ignored otherwise. Raise it when the issuer
+     * is expected to hand out more than `N` consecutive addresses without any
+     * of them being paid. Must be a positive integer.
+     *
+     * @defaultValue `20`
+     */
+    lookAheadWindow?: number;
 }
 /**
  * Repository implementations used to store wallet and contract state.
@@ -5034,4 +5166,4 @@ declare namespace ProtoTypes {
     export {  };
 }
 
-export { type NetworkName as $, type ArkTransaction as A, type BatchStartedEvent as B, type ContractRepository as C, type TreeTxEvent as D, type ExtendedCoin 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 Network as L, type DelegateProvider as M, type NormalizedExtendedVirtualCoin as N, type OnchainProvider as O, type ReadonlyWalletConfig as P, type IntentRepository as Q, type Recipient as R, type SendBitcoinParams as S, type TxNotification as T, type VirtualTxRepository as U, VtxoScript as V, type WalletRepository as W, type ExitCaptureMode as X, type ExitDataSource as Y, type IReadonlyAssetManager as Z, type ContractSyncState as _, type Identity as a, ChainTxType as a$, type ArkInfo as a0, ArkAddress as a1, type Coin as a2, ContractManager as a3, CSVMultisigTapscript as a4, type SettlementConfig as a5, VtxoManager as a6, type SignerSession as a7, type SignedIntent as a8, Intent as a9, type BurnParams as aA, type RenewVtxosOptions as aB, type ContractWithVtxos as aC, type PathSelection as aD, type ContractEvent as aE, type AssetDetails as aF, type IssuanceResult as aG, type DelegateInfo as aH, type MigrationGlobalSkipReason as aI, type MigrationLegSkipReason as aJ, type SignerStatus as aK, type StorageConfig as aL, type IVtxoManager as aM, type ExplorerTransaction as aN, type EncodedVtxoScript as aO, type Status as aP, type ChainTx as aQ, type PathContext as aR, type ActivityIntent as aS, type ActivityResolver as aT, type ArkIntentState as aU, type ArkTapscript as aV, type AssetMetadata as aW, type BaseWalletConfig as aX, type BatchInfo as aY, type BatchSignableIdentity as aZ, CLTVMultisigTapscript as a_, type TimeHeight as aa, type VtxoRepositoryKey as ab, type WalletState as ac, type ContractFilter as ad, type ArkIntent as ae, type IntentFilter as af, type Outpoint as ag, type VirtualTx as ah, type VtxoBranch as ai, ChainedTxType as aj, type DescriptorSigningRequest as ak, Transaction as al, type IntentFeeConfig as am, type OffchainInput as an, FeeAmount as ao, type OnchainInput as ap, type FeeOutput as aq, type ContractWatcherConfig as ar, type Asset as as, type FeeInfo as at, type CreateContractParams as au, type GetContractsFilter as av, type GetSpendablePathsOptions as aw, type GetAllSpendingPathsOptions as ax, type IssuanceParams as ay, type ReissuanceParams as az, type WalletConfig as b, type VtxoChain as b$, type CommitmentTx as b0, ConditionCSVMultisigTapscript as b1, ConditionMultisigTapscript as b2, type ContractBalance as b3, type ContractEventCallback as b4, type ContractHandler as b5, type ContractManagerConfig as b6, type ContractState as b7, type ContractVtxo as b8, ContractWatcher as b9, type PageResponse as bA, type PaginationOptions as bB, PartialSig as bC, type ProviderClass as bD, RestDelegateProvider as bE, RestDelegatorProvider as bF, type ScanContractsOptions as bG, type ScanResult as bH, type ScheduledSession as bI, SettlementEventType as bJ, type SignRequest as bK, type SignerClassification as bL, type SignerSet as bM, type SubscriptionEvent as bN, type SubscriptionHeartbeat as bO, type TapLeaves as bP, TapTreeCoder as bQ, TapscriptType as bR, type TreeNonces as bS, type TreePartialSigs as bT, type Tx as bU, type TxHistoryRecord as bV, type TxKey as bW, type TxTreeNode as bX, TxType as bY, type VirtualStatus as bZ, type Vtxo as b_, DelegateManagerImpl as ba, type DelegateOptions as bb, DelegatorManagerImpl as bc, type DelegatorProvider as bd, type DeprecatedSignerMigrationReport as be, type DeprecatedSignerReport as bf, DigestMismatchError as bg, type Discoverable as bh, type DiscoveredContract as bi, type DiscoveryDeps as bj, ESPLORA_URL as bk, EsploraProvider as bl, type ExitChainResolver as bm, type ExtendedContractVtxo as bn, type GroupMembership as bo, type HandlerError as bp, type IDelegatorManager as bq, INTENT_TERMINAL_STATES as br, IndexerTxType as bs, type KnownMetadata as bt, type MigrateDeprecatedSignerOptions as bu, type MigrationLegReport as bv, type MigrationVtxoRef as bw, MultisigTapscript as bx, type Nonces as by, type Output as bz, type WalletBalance as c, type VtxoType as c0, type WalletMode as c1, boardingResolver as c2, canRecoverOnchain as c3, canSpendOffchain as c4, classifyAgainstSignerSet as c5, classifyContractSigner as c6, createDefaultActivityRegistry as c7, createExitChainResolver as c8, decodeTapscript as c9, getNetwork as ca, getSequence as cb, hasTerminalSpend as cc, isBatchSignable as cd, isCooperativelyMigratable as ce, isDiscoverable as cf, isExpired as cg, isPastExpiry as ch, isRecoverable as ci, isSpendable as cj, isSubdust as ck, isTerminalIntentState as cl, isVirtualCoin as cm, isVtxoExpiringSoon as cn, networks as co, signerSetFromInfo as cp, toXOnlySignerHex as cq, type TapscriptDeriving as cr, ActivityRegistry as d, type Activity as e, type IContractManager as f, type IDelegateManager as g, type SettleParams as h, type SettlementEvent as i, type IAssetManager as j, RestArkProvider as k, RestIndexerProvider as l, type SubscriptionResponse as m, type ArkProvider as n, type IndexerProvider as o, type RelativeTimelock as p, type TapLeafScript as q, type VirtualCoin as r, type Contract as s, type ExtendedVirtualCoin 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 NetworkName as $, type ArkTransaction as A, type BatchStartedEvent as B, type ContractRepository as C, type TreeTxEvent as D, type ExtendedCoin 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 Network as L, type DelegateProvider as M, type NormalizedExtendedVirtualCoin as N, type OnchainProvider as O, type ReadonlyWalletConfig as P, type IntentRepository as Q, type Recipient as R, type SendBitcoinParams as S, type TxNotification as T, type VirtualTxRepository as U, VtxoScript as V, type WalletRepository as W, type ExitCaptureMode as X, type ExitDataSource as Y, type IReadonlyAssetManager as Z, type ContractSyncState as _, type Identity as a, CLTVMultisigTapscript as a$, type ArkInfo as a0, ArkAddress as a1, type Coin as a2, ContractManager as a3, type ContractManagerConfig as a4, CSVMultisigTapscript as a5, type SettlementConfig as a6, VtxoManager as a7, type SignerSession as a8, type SignedIntent as a9, type ReissuanceParams as aA, type BurnParams as aB, type RenewVtxosOptions as aC, type ContractWithVtxos as aD, type PathSelection as aE, type ContractEvent as aF, type AssetDetails as aG, type IssuanceResult as aH, type DelegateInfo as aI, type MigrationGlobalSkipReason as aJ, type MigrationLegSkipReason as aK, type SignerStatus as aL, type StorageConfig as aM, type IVtxoManager as aN, type ExplorerTransaction as aO, type EncodedVtxoScript as aP, type Status as aQ, type ChainTx as aR, type PathContext as aS, type ActivityIntent as aT, type ActivityResolver as aU, type ArkIntentState as aV, type ArkTapscript as aW, type AssetMetadata as aX, type BaseWalletConfig as aY, type BatchInfo as aZ, type BatchSignableIdentity as a_, Intent as aa, type TimeHeight as ab, type VtxoRepositoryKey as ac, type WalletState as ad, type ContractFilter as ae, type ArkIntent as af, type IntentFilter as ag, type Outpoint as ah, type VirtualTx as ai, type VtxoBranch as aj, ChainedTxType as ak, type DescriptorSigningRequest as al, Transaction as am, type IntentFeeConfig as an, type OffchainInput as ao, FeeAmount as ap, type OnchainInput as aq, type FeeOutput as ar, type ContractWatcherConfig as as, type Asset as at, type FeeInfo as au, type CreateContractParams as av, type GetContractsFilter as aw, type GetSpendablePathsOptions as ax, type GetAllSpendingPathsOptions as ay, type IssuanceParams as az, type WalletConfig as b, type Vtxo as b$, type CandidateDeps as b0, ChainTxType as b1, type CommitmentTx as b2, ConditionCSVMultisigTapscript as b3, ConditionMultisigTapscript as b4, type ContractBalance as b5, type ContractEventCallback as b6, type ContractHandler as b7, type ContractState as b8, type ContractVtxo as b9, type Output as bA, type PageResponse as bB, type PaginationOptions as bC, PartialSig as bD, type ProviderClass as bE, RestDelegateProvider as bF, RestDelegatorProvider as bG, type ScanContractsOptions as bH, type ScanResult as bI, type ScheduledSession as bJ, SettlementEventType as bK, type SignRequest as bL, type SignerClassification as bM, type SignerSet as bN, type SubscriptionEvent as bO, type SubscriptionHeartbeat as bP, type TapLeaves as bQ, TapTreeCoder as bR, TapscriptType as bS, type TreeNonces as bT, type TreePartialSigs as bU, type Tx as bV, type TxHistoryRecord as bW, type TxKey as bX, type TxTreeNode as bY, TxType as bZ, type VirtualStatus as b_, ContractWatcher as ba, DelegateManagerImpl as bb, type DelegateOptions as bc, DelegatorManagerImpl as bd, type DelegatorProvider as be, type DeprecatedSignerMigrationReport as bf, type DeprecatedSignerReport as bg, DigestMismatchError as bh, type Discoverable as bi, type DiscoveredContract as bj, type DiscoveryDeps as bk, ESPLORA_URL as bl, EsploraProvider as bm, type ExitChainResolver as bn, type ExtendedContractVtxo as bo, type GroupMembership as bp, type HandlerError as bq, type IDelegatorManager as br, INTENT_TERMINAL_STATES as bs, IndexerTxType as bt, type KnownMetadata as bu, type MigrateDeprecatedSignerOptions as bv, type MigrationLegReport as bw, type MigrationVtxoRef as bx, MultisigTapscript as by, type Nonces as bz, type WalletBalance as c, type VtxoChain as c0, type VtxoType as c1, type WalletMode as c2, boardingResolver as c3, canRecoverOnchain as c4, canSpendOffchain as c5, classifyAgainstSignerSet as c6, classifyContractSigner as c7, createDefaultActivityRegistry as c8, createExitChainResolver as c9, decodeTapscript as ca, getNetwork as cb, getSequence as cc, hasCandidates as cd, hasTerminalSpend as ce, isBatchSignable as cf, isCooperativelyMigratable as cg, isDiscoverable as ch, isExpired as ci, isPastExpiry as cj, isRecoverable as ck, isSpendable as cl, isSubdust as cm, isTerminalIntentState as cn, isVirtualCoin as co, isVtxoExpiringSoon as cp, networks as cq, signerSetFromInfo as cr, toXOnlySignerHex as cs, type TapscriptDeriving as ct, ActivityRegistry as d, type Activity as e, type IContractManager as f, type IDelegateManager as g, type SettleParams as h, type SettlementEvent as i, type IAssetManager as j, RestArkProvider as k, RestIndexerProvider as l, type SubscriptionResponse as m, type ArkProvider as n, type IndexerProvider as o, type RelativeTimelock as p, type TapLeafScript as q, type VirtualCoin as r, type Contract as s, type ExtendedVirtualCoin 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-ApoclKQZ.d.ts → ark-B69ugeJw.d.ts}

@@ -2102,6 +2102,15 @@ interface IContractManager extends Disposable {
      * Outpoints not owned by any tracked contract are silently dropped.
      */
     refreshOutpoints(outpoints: Outpoint[]): Promise<void>;
+    /**
+     * Rebuild the HD look-ahead watch window around the current allocation
+     * watermark. No-op when the manager was configured without `lookAhead`.
+     *
+     * Call after anything that moves the watermark (restore, boarding
+     * allocation, receive rotation, server-signer rotation). Concurrent calls
+     * coalesce into a single drain.
+     */
+    refillLookAhead(): Promise<void>;
     /**
      * Explicit, gap-limit contract discovery used by `wallet.restore()`.
      *
@@ -2192,6 +2201,33 @@ interface ContractManagerConfig {
     onVtxosSpent?: (vtxos: Outpoint[]) => Promise<void>;
     /** Watcher configuration */
     watcherConfig?: Partial<ContractWatcherConfig>;
+    /**
+     * Enables the HD look-ahead watch window. Absent ⇒ feature off (static /
+     * non-HD wallets, third-party embedders). See
+     * {@link ContractManager.refillLookAhead}.
+     */
+    lookAhead?: LookAheadConfig;
+}
+/**
+ * Wallet-injected surface backing the HD look-ahead window. Kept as a
+ * callback bundle so the contracts layer never learns what an HD descriptor
+ * is (mirrors {@link ScanContractsOptions.materialize}).
+ */
+interface LookAheadConfig {
+    /** Per-side band bound: the window spans `[max(0, w - size), w + size]`. */
+    size: number;
+    /** Current allocation watermark (`lastIndexUsed ?? -1`). */
+    currentWatermark(): Promise<number>;
+    /** Signing descriptor at an HD index. Pure derivation. */
+    materialize(index: number): string;
+    /**
+     * Key and timelock axes an externally issued receive script could be
+     * anchored to. Read once per refill, so a band rebuilt after
+     * `rotateServerSigner` fans the new signer set.
+     */
+    candidateDeps(): CandidateDeps;
+    /** Fired after a speculative entry at `index` is promoted to a real row. */
+    onPromoted?(index: number): Promise<void>;
 }
 /**
  * Parameters for creating a new contract.
@@ -2257,6 +2293,12 @@ declare class ContractManager implements IContractManager {
     private syncDegradedReason?;
     /** Epoch-ms of the last successful provider sync, if any. */
     private lastSyncedAt?;
+    /** Speculative look-ahead scripts, keyed by script. @see LookAheadEntry */
+    private lookAheadEntries;
+    /** In-flight look-ahead drain, if any. @see scheduleLookAheadDrain */
+    private lookAheadDrain?;
+    /** A refill was requested while a drain was running. */
+    private lookAheadDirty;
     private constructor();
     /**
      * Static factory method for creating a new ContractManager.
@@ -2298,6 +2340,63 @@ declare class ContractManager implements IContractManager {
      * a failure is logged and sync continues. No-op without an intent store.
      */
     private reconcileStaleIntents;
+    /** @see IContractManager.refillLookAhead */
+    refillLookAhead(): Promise<void>;
+    /**
+     * Serialized drain of the look-ahead band: concurrent callers join the
+     * active drain and mark it dirty, an idle call starts a new one. Promotion
+     * can uncover more funded indices, and boot / SSE / rotate / reconnect can
+     * all request a refill at once, so the loop coalesces them instead of
+     * recursing.
+     */
+    private scheduleLookAheadDrain;
+    /**
+     * Request a drain without awaiting it. Used from inside a sync (promotion),
+     * where awaiting the drain that the sync itself is part of would deadlock.
+     */
+    private requestLookAheadDrain;
+    /**
+     * Rebuild the speculative watch band around the allocation watermark.
+     *
+     * NArk needs no analogue because it *is* the address issuer: it persists a
+     * contract row at derivation time, so its watched set is a superset of
+     * every address it ever advertised. This SDK, when a third party issues
+     * addresses from the shared seed, cannot observe those allocations at all —
+     * the window is how a non-issuer compensates.
+     *
+     * Entries are registered with the watcher but NOT persisted: they become
+     * repository rows only once funded (see {@link promoteLookAheadHits}).
+     *
+     * Each index contributes every {@link Discoverable.candidatesAt} candidate —
+     * the same set `restore()`'s gap scan probes, since the wallet cannot know
+     * which variant a third-party issuer handed out.
+     */
+    private ensureLookAhead;
+    /**
+     * One-time full-history sync for speculative entries the manager has not
+     * successfully caught up on yet.
+     *
+     * Every normal sync uses the cursor-derived delta window and SSE only
+     * delivers events after a script is subscribed, so a script first
+     * registered after its funding time would otherwise be skipped forever
+     * (upgrade migration, or a band that slid over an already-funded index).
+     * The entries are passed as in-memory contracts because `refreshVtxos`
+     * resolves scripts through the repository, where they deliberately do not
+     * exist. Targeted + explicitly windowed, so the global cursor stays put.
+     */
+    private runLookAheadCatchUp;
+    /**
+     * Promote every look-ahead entry funded by `vtxos` into a real repository
+     * row, returning the persisted rows keyed by script.
+     *
+     * MUST run on each raw indexer fetch before `annotateVtxos`:
+     * `extendVirtualCoinForContract` throws when a VTXO's script has no
+     * contract row, so a funded window entry has to be persisted before its
+     * VTXOs are annotated and saved. Callers also swap the returned rows into
+     * the local contract maps they built pre-promotion, so `saveVtxosForContract`
+     * and `onVtxosPersisted` never see the synthetic watcher object.
+     */
+    private promoteLookAheadHits;
     /**
      * Create and register a new contract.
      *
@@ -2324,6 +2423,7 @@ declare class ContractManager implements IContractManager {
      * `persisted` is `true`.
      */
     private upsertContract;
+    private upsertContractRow;
     /**
      * Explicit, gap-limit contract discovery (see {@link IContractManager.scanContracts}).
      *
@@ -2787,6 +2887,12 @@ interface DiscoveryDeps {
     /** Present only for delegate wallets. */
     delegatePubKey?: Uint8Array;
 }
+/**
+ * The I/O-free subset of {@link DiscoveryDeps}: the axes a receive script can
+ * be anchored to. `DiscoveryDeps` satisfies it structurally, so one
+ * {@link Discoverable.candidatesAt} serves the scan and the look-ahead band.
+ */
+type CandidateDeps = Pick<DiscoveryDeps, "network" | "serverPubKey" | "csvTimelocks"> & Pick<Partial<DiscoveryDeps>, "deprecatedSignerPubKeys" | "delegatePubKey">;
 /**
  * Optional capability a {@link ContractHandler} implements to participate
  * in `wallet.restore()`'s gap-limit scan. The scanner owns the index
@@ -2818,7 +2924,19 @@ interface Discoverable {
         index: number;
         descriptor: string;
     }[], deps: DiscoveryDeps): Promise<Map<number, DiscoveredContract[]>>;
+    /**
+     * Optional: every unverified contract this handler could own at one HD
+     * index — pure derivation, no I/O, no metadata. `discoverRange` probes
+     * these scripts and the look-ahead band subscribes to them, so the two
+     * cannot cover different sets.
+     *
+     * `boarding` omits it: its probe is an on-chain address lookup, and that
+     * keeps it out of the band (deposits are watched on their own channel).
+     */
+    candidatesAt?(index: number, descriptor: string, deps: CandidateDeps): DiscoveredContract[];
 }
+/** Duck-typed guard for the pure candidate surface. @see Discoverable.candidatesAt */
+declare function hasCandidates(handler: ContractHandler<unknown> | undefined): handler is ContractHandler<unknown> & Required<Pick<Discoverable, "candidatesAt">>;
 /** Duck-typed guard (mirrors `hasReceiveRotatorFactory`). */
 declare function isDiscoverable(handler: ContractHandler<unknown> | undefined): handler is ContractHandler<unknown> & Discoverable;
 /**
@@ -3624,6 +3742,20 @@ interface WalletConfig extends ReadonlyWalletConfig {
      * @defaultValue `'auto'`
      */
     walletMode?: WalletMode;
+    /**
+     * Per-side width of the HD look-ahead watch window: the wallet watches
+     * missing offchain receive scripts across `[watermark - N, watermark + N]`
+     * so funds paid to an address issued by an external party (a merchant
+     * backend sharing the seed) arrive without an explicit `restore()`.
+     *
+     * Only meaningful for HD wallets (`walletMode: 'hd'` or an HD
+     * {@link DescriptorProvider}); ignored otherwise. Raise it when the issuer
+     * is expected to hand out more than `N` consecutive addresses without any
+     * of them being paid. Must be a positive integer.
+     *
+     * @defaultValue `20`
+     */
+    lookAheadWindow?: number;
 }
 /**
  * Repository implementations used to store wallet and contract state.
@@ -5034,4 +5166,4 @@ declare namespace ProtoTypes {
     export {  };
 }
 
-export { type NetworkName as $, type ArkTransaction as A, type BatchStartedEvent as B, type ContractRepository as C, type TreeTxEvent as D, type ExtendedCoin 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 Network as L, type DelegateProvider as M, type NormalizedExtendedVirtualCoin as N, type OnchainProvider as O, type ReadonlyWalletConfig as P, type IntentRepository as Q, type Recipient as R, type SendBitcoinParams as S, type TxNotification as T, type VirtualTxRepository as U, VtxoScript as V, type WalletRepository as W, type ExitCaptureMode as X, type ExitDataSource as Y, type IReadonlyAssetManager as Z, type ContractSyncState as _, type Identity as a, ChainTxType as a$, type ArkInfo as a0, ArkAddress as a1, type Coin as a2, ContractManager as a3, CSVMultisigTapscript as a4, type SettlementConfig as a5, VtxoManager as a6, type SignerSession as a7, type SignedIntent as a8, Intent as a9, type BurnParams as aA, type RenewVtxosOptions as aB, type ContractWithVtxos as aC, type PathSelection as aD, type ContractEvent as aE, type AssetDetails as aF, type IssuanceResult as aG, type DelegateInfo as aH, type MigrationGlobalSkipReason as aI, type MigrationLegSkipReason as aJ, type SignerStatus as aK, type StorageConfig as aL, type IVtxoManager as aM, type ExplorerTransaction as aN, type EncodedVtxoScript as aO, type Status as aP, type ChainTx as aQ, type PathContext as aR, type ActivityIntent as aS, type ActivityResolver as aT, type ArkIntentState as aU, type ArkTapscript as aV, type AssetMetadata as aW, type BaseWalletConfig as aX, type BatchInfo as aY, type BatchSignableIdentity as aZ, CLTVMultisigTapscript as a_, type TimeHeight as aa, type VtxoRepositoryKey as ab, type WalletState as ac, type ContractFilter as ad, type ArkIntent as ae, type IntentFilter as af, type Outpoint as ag, type VirtualTx as ah, type VtxoBranch as ai, ChainedTxType as aj, type DescriptorSigningRequest as ak, Transaction as al, type IntentFeeConfig as am, type OffchainInput as an, FeeAmount as ao, type OnchainInput as ap, type FeeOutput as aq, type ContractWatcherConfig as ar, type Asset as as, type FeeInfo as at, type CreateContractParams as au, type GetContractsFilter as av, type GetSpendablePathsOptions as aw, type GetAllSpendingPathsOptions as ax, type IssuanceParams as ay, type ReissuanceParams as az, type WalletConfig as b, type VtxoChain as b$, type CommitmentTx as b0, ConditionCSVMultisigTapscript as b1, ConditionMultisigTapscript as b2, type ContractBalance as b3, type ContractEventCallback as b4, type ContractHandler as b5, type ContractManagerConfig as b6, type ContractState as b7, type ContractVtxo as b8, ContractWatcher as b9, type PageResponse as bA, type PaginationOptions as bB, PartialSig as bC, type ProviderClass as bD, RestDelegateProvider as bE, RestDelegatorProvider as bF, type ScanContractsOptions as bG, type ScanResult as bH, type ScheduledSession as bI, SettlementEventType as bJ, type SignRequest as bK, type SignerClassification as bL, type SignerSet as bM, type SubscriptionEvent as bN, type SubscriptionHeartbeat as bO, type TapLeaves as bP, TapTreeCoder as bQ, TapscriptType as bR, type TreeNonces as bS, type TreePartialSigs as bT, type Tx as bU, type TxHistoryRecord as bV, type TxKey as bW, type TxTreeNode as bX, TxType as bY, type VirtualStatus as bZ, type Vtxo as b_, DelegateManagerImpl as ba, type DelegateOptions as bb, DelegatorManagerImpl as bc, type DelegatorProvider as bd, type DeprecatedSignerMigrationReport as be, type DeprecatedSignerReport as bf, DigestMismatchError as bg, type Discoverable as bh, type DiscoveredContract as bi, type DiscoveryDeps as bj, ESPLORA_URL as bk, EsploraProvider as bl, type ExitChainResolver as bm, type ExtendedContractVtxo as bn, type GroupMembership as bo, type HandlerError as bp, type IDelegatorManager as bq, INTENT_TERMINAL_STATES as br, IndexerTxType as bs, type KnownMetadata as bt, type MigrateDeprecatedSignerOptions as bu, type MigrationLegReport as bv, type MigrationVtxoRef as bw, MultisigTapscript as bx, type Nonces as by, type Output as bz, type WalletBalance as c, type VtxoType as c0, type WalletMode as c1, boardingResolver as c2, canRecoverOnchain as c3, canSpendOffchain as c4, classifyAgainstSignerSet as c5, classifyContractSigner as c6, createDefaultActivityRegistry as c7, createExitChainResolver as c8, decodeTapscript as c9, getNetwork as ca, getSequence as cb, hasTerminalSpend as cc, isBatchSignable as cd, isCooperativelyMigratable as ce, isDiscoverable as cf, isExpired as cg, isPastExpiry as ch, isRecoverable as ci, isSpendable as cj, isSubdust as ck, isTerminalIntentState as cl, isVirtualCoin as cm, isVtxoExpiringSoon as cn, networks as co, signerSetFromInfo as cp, toXOnlySignerHex as cq, type TapscriptDeriving as cr, ActivityRegistry as d, type Activity as e, type IContractManager as f, type IDelegateManager as g, type SettleParams as h, type SettlementEvent as i, type IAssetManager as j, RestArkProvider as k, RestIndexerProvider as l, type SubscriptionResponse as m, type ArkProvider as n, type IndexerProvider as o, type RelativeTimelock as p, type TapLeafScript as q, type VirtualCoin as r, type Contract as s, type ExtendedVirtualCoin 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 NetworkName as $, type ArkTransaction as A, type BatchStartedEvent as B, type ContractRepository as C, type TreeTxEvent as D, type ExtendedCoin 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 Network as L, type DelegateProvider as M, type NormalizedExtendedVirtualCoin as N, type OnchainProvider as O, type ReadonlyWalletConfig as P, type IntentRepository as Q, type Recipient as R, type SendBitcoinParams as S, type TxNotification as T, type VirtualTxRepository as U, VtxoScript as V, type WalletRepository as W, type ExitCaptureMode as X, type ExitDataSource as Y, type IReadonlyAssetManager as Z, type ContractSyncState as _, type Identity as a, CLTVMultisigTapscript as a$, type ArkInfo as a0, ArkAddress as a1, type Coin as a2, ContractManager as a3, type ContractManagerConfig as a4, CSVMultisigTapscript as a5, type SettlementConfig as a6, VtxoManager as a7, type SignerSession as a8, type SignedIntent as a9, type ReissuanceParams as aA, type BurnParams as aB, type RenewVtxosOptions as aC, type ContractWithVtxos as aD, type PathSelection as aE, type ContractEvent as aF, type AssetDetails as aG, type IssuanceResult as aH, type DelegateInfo as aI, type MigrationGlobalSkipReason as aJ, type MigrationLegSkipReason as aK, type SignerStatus as aL, type StorageConfig as aM, type IVtxoManager as aN, type ExplorerTransaction as aO, type EncodedVtxoScript as aP, type Status as aQ, type ChainTx as aR, type PathContext as aS, type ActivityIntent as aT, type ActivityResolver as aU, type ArkIntentState as aV, type ArkTapscript as aW, type AssetMetadata as aX, type BaseWalletConfig as aY, type BatchInfo as aZ, type BatchSignableIdentity as a_, Intent as aa, type TimeHeight as ab, type VtxoRepositoryKey as ac, type WalletState as ad, type ContractFilter as ae, type ArkIntent as af, type IntentFilter as ag, type Outpoint as ah, type VirtualTx as ai, type VtxoBranch as aj, ChainedTxType as ak, type DescriptorSigningRequest as al, Transaction as am, type IntentFeeConfig as an, type OffchainInput as ao, FeeAmount as ap, type OnchainInput as aq, type FeeOutput as ar, type ContractWatcherConfig as as, type Asset as at, type FeeInfo as au, type CreateContractParams as av, type GetContractsFilter as aw, type GetSpendablePathsOptions as ax, type GetAllSpendingPathsOptions as ay, type IssuanceParams as az, type WalletConfig as b, type Vtxo as b$, type CandidateDeps as b0, ChainTxType as b1, type CommitmentTx as b2, ConditionCSVMultisigTapscript as b3, ConditionMultisigTapscript as b4, type ContractBalance as b5, type ContractEventCallback as b6, type ContractHandler as b7, type ContractState as b8, type ContractVtxo as b9, type Output as bA, type PageResponse as bB, type PaginationOptions as bC, PartialSig as bD, type ProviderClass as bE, RestDelegateProvider as bF, RestDelegatorProvider as bG, type ScanContractsOptions as bH, type ScanResult as bI, type ScheduledSession as bJ, SettlementEventType as bK, type SignRequest as bL, type SignerClassification as bM, type SignerSet as bN, type SubscriptionEvent as bO, type SubscriptionHeartbeat as bP, type TapLeaves as bQ, TapTreeCoder as bR, TapscriptType as bS, type TreeNonces as bT, type TreePartialSigs as bU, type Tx as bV, type TxHistoryRecord as bW, type TxKey as bX, type TxTreeNode as bY, TxType as bZ, type VirtualStatus as b_, ContractWatcher as ba, DelegateManagerImpl as bb, type DelegateOptions as bc, DelegatorManagerImpl as bd, type DelegatorProvider as be, type DeprecatedSignerMigrationReport as bf, type DeprecatedSignerReport as bg, DigestMismatchError as bh, type Discoverable as bi, type DiscoveredContract as bj, type DiscoveryDeps as bk, ESPLORA_URL as bl, EsploraProvider as bm, type ExitChainResolver as bn, type ExtendedContractVtxo as bo, type GroupMembership as bp, type HandlerError as bq, type IDelegatorManager as br, INTENT_TERMINAL_STATES as bs, IndexerTxType as bt, type KnownMetadata as bu, type MigrateDeprecatedSignerOptions as bv, type MigrationLegReport as bw, type MigrationVtxoRef as bx, MultisigTapscript as by, type Nonces as bz, type WalletBalance as c, type VtxoChain as c0, type VtxoType as c1, type WalletMode as c2, boardingResolver as c3, canRecoverOnchain as c4, canSpendOffchain as c5, classifyAgainstSignerSet as c6, classifyContractSigner as c7, createDefaultActivityRegistry as c8, createExitChainResolver as c9, decodeTapscript as ca, getNetwork as cb, getSequence as cc, hasCandidates as cd, hasTerminalSpend as ce, isBatchSignable as cf, isCooperativelyMigratable as cg, isDiscoverable as ch, isExpired as ci, isPastExpiry as cj, isRecoverable as ck, isSpendable as cl, isSubdust as cm, isTerminalIntentState as cn, isVirtualCoin as co, isVtxoExpiringSoon as cp, networks as cq, signerSetFromInfo as cr, toXOnlySignerHex as cs, type TapscriptDeriving as ct, ActivityRegistry as d, type Activity as e, type IContractManager as f, type IDelegateManager as g, type SettleParams as h, type SettlementEvent as i, type IAssetManager as j, RestArkProvider as k, RestIndexerProvider as l, type SubscriptionResponse as m, type ArkProvider as n, type IndexerProvider as o, type RelativeTimelock as p, type TapLeafScript as q, type VirtualCoin as r, type Contract as s, type ExtendedVirtualCoin 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-BCWmdVg8.d.ts → asyncStorageTaskQueue-BImF14sj.d.ts}

@@ -1,4 +1,4 @@
-import { a as TaskQueue, c as TaskItem, d as TaskResult } from './taskRunner-ChvV6Xrh.js';
+import { c as TaskQueue, b as TaskItem, d as TaskResult } from './taskRunner-Cf80BqSy.js';
 
 /**
  * Minimal async key-value storage interface.
@@ -46,4 +46,4 @@ declare class AsyncStorageTaskQueue implements TaskQueue {
     private writeList;
 }
 
-export { AsyncStorageTaskQueue as A, type AsyncStorageLike as a };
+export { type AsyncStorageLike as A, AsyncStorageTaskQueue as a };

package/dist/{asyncStorageTaskQueue-CIjgv1co.d.cts → asyncStorageTaskQueue-DScPdQAy.d.cts}

@@ -1,4 +1,4 @@
-import { a as TaskQueue, c as TaskItem, d as TaskResult } from './taskRunner-C3YLaM2x.cjs';
+import { c as TaskQueue, b as TaskItem, d as TaskResult } from './taskRunner-ClwI8jU8.cjs';
 
 /**
  * Minimal async key-value storage interface.
@@ -46,4 +46,4 @@ declare class AsyncStorageTaskQueue implements TaskQueue {
     private writeList;
 }
 
-export { AsyncStorageTaskQueue as A, type AsyncStorageLike as a };
+export { type AsyncStorageLike as A, AsyncStorageTaskQueue as a };