@arkade-os/sdk 0.4.29 → 0.4.31

package/dist/adapters/expo.d.cts

@@ -1,5 +1,5 @@
-import { j as RestArkProvider, h as SettlementEvent, T as TxNotification, k as RestIndexerProvider, l as SubscriptionResponse } from '../ark-ChhTwpLf.cjs';
-export { m as ArkProvider, n as IndexerProvider } from '../ark-ChhTwpLf.cjs';
+import { j as RestArkProvider, h as SettlementEvent, T as TxNotification, k as RestIndexerProvider, l as SubscriptionResponse } from '../ark-ibLW4Hte.cjs';
+export { m as ArkProvider, n as IndexerProvider } from '../ark-ibLW4Hte.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 { j as RestArkProvider, h as SettlementEvent, T as TxNotification, k as RestIndexerProvider, l as SubscriptionResponse } from '../ark-ChhTwpLf.js';
-export { m as ArkProvider, n as IndexerProvider } from '../ark-ChhTwpLf.js';
+import { j as RestArkProvider, h as SettlementEvent, T as TxNotification, k as RestIndexerProvider, l as SubscriptionResponse } from '../ark-ibLW4Hte.js';
+export { m as ArkProvider, n as IndexerProvider } from '../ark-ibLW4Hte.js';
 import '@scure/btc-signer/transaction.js';
 import '@scure/btc-signer/utils.js';
 import '@scure/btc-signer/psbt.js';

package/dist/adapters/indexedDB.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkGDCTOSMV_cjs = require('../chunk-GDCTOSMV.cjs');
+var chunkGPZH5QNA_cjs = require('../chunk-GPZH5QNA.cjs');
 require('../chunk-6FLL2Q36.cjs');
 require('../chunk-IEO3XDKI.cjs');
 require('../chunk-WMIPYZSB.cjs');
@@ -11,7 +11,7 @@ var IndexedDBStorageAdapter = class {
   dbName;
   version;
   db = null;
-  constructor(dbName, version = chunkGDCTOSMV_cjs.DB_VERSION) {
+  constructor(dbName, version = chunkGPZH5QNA_cjs.DB_VERSION) {
     this.dbName = dbName;
     this.version = version;
   }

package/dist/adapters/indexedDB.js

@@ -1,4 +1,4 @@
-import { DB_VERSION } from '../chunk-BVP2U66Q.js';
+import { DB_VERSION } from '../chunk-HJM6JPG4.js';
 import '../chunk-6NWNOLL3.js';
 import '../chunk-YA4G7RFB.js';
 import '../chunk-TU3LVAPX.js';

package/dist/{ark-ChhTwpLf.d.cts → ark-ibLW4Hte.d.cts}

@@ -608,6 +608,19 @@ interface SettlementConfig {
  * @returns true if virtual output expires within threshold, false otherwise
  */
 declare function isVtxoExpiringSoon(vtxo: ExtendedVirtualCoin, thresholdMs: number): boolean;
+/**
+ * Optional arguments for {@link IVtxoManager.renewVtxos}.
+ */
+interface RenewVtxosOptions {
+    /**
+     * Override the renewal threshold for this call only, in seconds.
+     *
+     * When provided, takes precedence over `SettlementConfig.vtxoThreshold`
+     * and the default (3 days). Useful for renewing only VTXOs that are
+     * more urgently expiring than the globally configured threshold.
+     */
+    thresholdSeconds?: number;
+}
 /**
  * VtxoManager is a unified class for managing virtual output lifecycle operations including
  * recovery of swept/expired virtual outputs and renewal to prevent expiration.
@@ -662,7 +675,7 @@ interface IVtxoManager {
         vtxoCount: number;
     }>;
     getExpiringVtxos(thresholdMs?: number): Promise<ExtendedVirtualCoin[]>;
-    renewVtxos(eventCallback?: (event: SettlementEvent) => void): Promise<string>;
+    renewVtxos(eventCallback?: (event: SettlementEvent) => void, options?: RenewVtxosOptions): Promise<string>;
     getExpiredBoardingUtxos(): Promise<ExtendedCoin[]>;
     sweepExpiredBoardingUtxos(): Promise<string>;
     dispose(): Promise<void>;
@@ -784,6 +797,7 @@ declare class VtxoManager implements AsyncDisposable, IVtxoManager {
      * primary way to prevent virtual outputs from expiring.
      *
      * @param eventCallback - Optional callback for settlement events
+     * @param options - Optional per-call overrides; see {@link RenewVtxosOptions}
      * @returns Settlement transaction ID
      * @throws Error if no virtual outputs available to renew
      * @throws Error if total amount is below dust threshold
@@ -799,9 +813,12 @@ declare class VtxoManager implements AsyncDisposable, IVtxoManager {
      * const txid = await manager.renewVtxos((event) => {
      *   console.log('Settlement event:', event.type);
      * });
+     *
+     * // Renew only VTXOs that expire within 6 hours
+     * const txid = await manager.renewVtxos(undefined, { thresholdSeconds: 6 * 60 * 60 });
      * ```
      */
-    renewVtxos(eventCallback?: (event: SettlementEvent) => void): Promise<string>;
+    renewVtxos(eventCallback?: (event: SettlementEvent) => void, options?: RenewVtxosOptions): Promise<string>;
     /**
      * Get boarding inputs whose timelock has expired.
      *
@@ -3889,4 +3906,4 @@ declare namespace ProtoTypes {
     export {  };
 }
 
-export { CSVMultisigTapscript as $, type ArkTransaction as A, type BatchStartedEvent as B, type ContractRepository as C, type BatchFailedEvent as D, type ExtendedVirtualCoin as E, type TreeTxEvent as F, type GetVtxosFilter as G, type TreeSignatureEvent as H, type IWallet as I, type DescriptorProvider as J, type IReadonlyWallet as K, type ReadonlyIdentity as L, type DelegateProvider as M, type Network as N, type OnchainProvider as O, type ReadonlyWalletConfig as P, type IReadonlyAssetManager as Q, type Recipient as R, type SendBitcoinParams as S, type TxNotification as T, type NetworkName as U, VtxoScript as V, type WalletRepository as W, type ArkInfo as X, ArkAddress as Y, type Coin as Z, ContractManager as _, type Identity as a, type IDelegatorManager as a$, type SettlementConfig as a0, VtxoManager as a1, type SignerSession as a2, type SignedIntent as a3, Intent as a4, type DescriptorSigningRequest as a5, Transaction as a6, type IntentFeeConfig as a7, type OffchainInput as a8, FeeAmount as a9, type AssetMetadata as aA, type BaseWalletConfig as aB, type BatchInfo as aC, type BatchSignableIdentity as aD, CLTVMultisigTapscript as aE, ChainTxType as aF, type CommitmentTx as aG, ConditionCSVMultisigTapscript as aH, ConditionMultisigTapscript as aI, type ContractBalance as aJ, type ContractEventCallback as aK, type ContractHandler as aL, type ContractManagerConfig as aM, type ContractState as aN, type ContractVtxo as aO, ContractWatcher as aP, DelegateManagerImpl as aQ, type DelegateOptions as aR, DelegatorManagerImpl as aS, type DelegatorProvider as aT, type Discoverable as aU, type DiscoveredContract as aV, type DiscoveryDeps as aW, ESPLORA_URL as aX, EsploraProvider as aY, type ExtendedContractVtxo as aZ, type HandlerError as a_, type OnchainInput as aa, type FeeOutput as ab, type ContractWatcherConfig as ac, type FeeInfo as ad, type CreateContractParams as ae, type GetContractsFilter as af, type GetSpendablePathsOptions as ag, type GetAllSpendingPathsOptions as ah, type IssuanceParams as ai, type ReissuanceParams as aj, type BurnParams as ak, type ContractWithVtxos as al, type PathSelection as am, type ContractEvent as an, type AssetDetails as ao, type IssuanceResult as ap, type DelegateInfo as aq, type StorageConfig as ar, type IVtxoManager as as, type ExplorerTransaction as at, type EncodedVtxoScript as au, type Status as av, type Outpoint as aw, type ChainTx as ax, type ArkTapscript as ay, type Asset as az, type WalletConfig as b, IndexerTxType as b0, type KnownMetadata as b1, MultisigTapscript as b2, type Nonces as b3, type Output as b4, type PageResponse as b5, type PaginationOptions as b6, PartialSig as b7, type PathContext as b8, type ProviderClass as b9, isBatchSignable as bA, isDiscoverable as bB, isExpired as bC, isRecoverable as bD, isSpendable as bE, isSubdust as bF, isVtxoExpiringSoon as bG, networks as bH, RestDelegateProvider as ba, RestDelegatorProvider as bb, type ScanContractsOptions as bc, type ScanResult as bd, type ScheduledSession as be, SettlementEventType as bf, type SignRequest 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, decodeTapscript as by, getSequence as bz, type WalletBalance as c, type ExtendedCoin as d, type IContractManager as e, type IDelegateManager as f, type SettleParams as g, type SettlementEvent as h, type IAssetManager as i, RestArkProvider as j, RestIndexerProvider as k, type SubscriptionResponse as l, type ArkProvider as m, type IndexerProvider as n, type RelativeTimelock as o, type TapLeafScript as p, type VirtualCoin as q, type Contract as r, type VtxoRepositoryKey as s, type WalletState as t, type ContractFilter as u, type TreeSigningStartedEvent as v, TxTree as w, type TreeNoncesEvent as x, type BatchFinalizationEvent as y, type BatchFinalizedEvent as z };
+export { CSVMultisigTapscript as $, type ArkTransaction as A, type BatchStartedEvent as B, type ContractRepository as C, type BatchFailedEvent as D, type ExtendedVirtualCoin as E, type TreeTxEvent as F, type GetVtxosFilter as G, type TreeSignatureEvent as H, type IWallet as I, type DescriptorProvider as J, type IReadonlyWallet as K, type ReadonlyIdentity as L, type DelegateProvider as M, type Network as N, type OnchainProvider as O, type ReadonlyWalletConfig as P, type IReadonlyAssetManager as Q, type Recipient as R, type SendBitcoinParams as S, type TxNotification as T, type NetworkName as U, VtxoScript as V, type WalletRepository as W, type ArkInfo as X, ArkAddress as Y, type Coin as Z, ContractManager as _, type Identity as a, type HandlerError as a$, type SettlementConfig as a0, VtxoManager as a1, type SignerSession as a2, type SignedIntent as a3, Intent as a4, type DescriptorSigningRequest as a5, Transaction as a6, type IntentFeeConfig as a7, type OffchainInput as a8, FeeAmount as a9, type Asset as aA, type AssetMetadata as aB, type BaseWalletConfig as aC, type BatchInfo as aD, type BatchSignableIdentity as aE, CLTVMultisigTapscript as aF, ChainTxType as aG, type CommitmentTx as aH, ConditionCSVMultisigTapscript as aI, ConditionMultisigTapscript as aJ, type ContractBalance as aK, type ContractEventCallback as aL, type ContractHandler as aM, type ContractManagerConfig as aN, type ContractState as aO, type ContractVtxo as aP, ContractWatcher as aQ, DelegateManagerImpl as aR, type DelegateOptions as aS, DelegatorManagerImpl as aT, type DelegatorProvider as aU, type Discoverable as aV, type DiscoveredContract as aW, type DiscoveryDeps as aX, ESPLORA_URL as aY, EsploraProvider as aZ, type ExtendedContractVtxo as a_, type OnchainInput as aa, type FeeOutput as ab, type ContractWatcherConfig as ac, type FeeInfo as ad, type CreateContractParams as ae, type GetContractsFilter as af, type GetSpendablePathsOptions as ag, type GetAllSpendingPathsOptions as ah, type IssuanceParams as ai, type ReissuanceParams as aj, type BurnParams as ak, type RenewVtxosOptions as al, type ContractWithVtxos as am, type PathSelection as an, type ContractEvent as ao, type AssetDetails as ap, type IssuanceResult as aq, type DelegateInfo as ar, type StorageConfig as as, type IVtxoManager as at, type ExplorerTransaction as au, type EncodedVtxoScript as av, type Status as aw, type Outpoint as ax, type ChainTx as ay, type ArkTapscript as az, type WalletConfig as b, type IDelegatorManager as b0, IndexerTxType as b1, type KnownMetadata as b2, MultisigTapscript as b3, type Nonces as b4, type Output as b5, type PageResponse as b6, type PaginationOptions as b7, PartialSig as b8, type PathContext as b9, getSequence as bA, isBatchSignable as bB, isDiscoverable as bC, isExpired as bD, isRecoverable as bE, isSpendable as bF, isSubdust as bG, isVtxoExpiringSoon as bH, networks as bI, type ProviderClass as ba, RestDelegateProvider as bb, RestDelegatorProvider as bc, type ScanContractsOptions as bd, type ScanResult as be, type ScheduledSession as bf, SettlementEventType as bg, type SignRequest as bh, type SubscriptionEvent as bi, type SubscriptionHeartbeat as bj, type TapLeaves as bk, TapTreeCoder as bl, TapscriptType as bm, type TreeNonces as bn, type TreePartialSigs as bo, type Tx as bp, type TxHistoryRecord as bq, type TxKey as br, type TxTreeNode as bs, TxType as bt, type VirtualStatus as bu, type Vtxo as bv, type VtxoChain as bw, type VtxoType as bx, type WalletMode as by, decodeTapscript as bz, type WalletBalance as c, type ExtendedCoin as d, type IContractManager as e, type IDelegateManager as f, type SettleParams as g, type SettlementEvent as h, type IAssetManager as i, RestArkProvider as j, RestIndexerProvider as k, type SubscriptionResponse as l, type ArkProvider as m, type IndexerProvider as n, type RelativeTimelock as o, type TapLeafScript as p, type VirtualCoin as q, type Contract as r, type VtxoRepositoryKey as s, type WalletState as t, type ContractFilter as u, type TreeSigningStartedEvent as v, TxTree as w, type TreeNoncesEvent as x, type BatchFinalizationEvent as y, type BatchFinalizedEvent as z };

package/dist/{ark-ChhTwpLf.d.ts → ark-ibLW4Hte.d.ts}

@@ -608,6 +608,19 @@ interface SettlementConfig {
  * @returns true if virtual output expires within threshold, false otherwise
  */
 declare function isVtxoExpiringSoon(vtxo: ExtendedVirtualCoin, thresholdMs: number): boolean;
+/**
+ * Optional arguments for {@link IVtxoManager.renewVtxos}.
+ */
+interface RenewVtxosOptions {
+    /**
+     * Override the renewal threshold for this call only, in seconds.
+     *
+     * When provided, takes precedence over `SettlementConfig.vtxoThreshold`
+     * and the default (3 days). Useful for renewing only VTXOs that are
+     * more urgently expiring than the globally configured threshold.
+     */
+    thresholdSeconds?: number;
+}
 /**
  * VtxoManager is a unified class for managing virtual output lifecycle operations including
  * recovery of swept/expired virtual outputs and renewal to prevent expiration.
@@ -662,7 +675,7 @@ interface IVtxoManager {
         vtxoCount: number;
     }>;
     getExpiringVtxos(thresholdMs?: number): Promise<ExtendedVirtualCoin[]>;
-    renewVtxos(eventCallback?: (event: SettlementEvent) => void): Promise<string>;
+    renewVtxos(eventCallback?: (event: SettlementEvent) => void, options?: RenewVtxosOptions): Promise<string>;
     getExpiredBoardingUtxos(): Promise<ExtendedCoin[]>;
     sweepExpiredBoardingUtxos(): Promise<string>;
     dispose(): Promise<void>;
@@ -784,6 +797,7 @@ declare class VtxoManager implements AsyncDisposable, IVtxoManager {
      * primary way to prevent virtual outputs from expiring.
      *
      * @param eventCallback - Optional callback for settlement events
+     * @param options - Optional per-call overrides; see {@link RenewVtxosOptions}
      * @returns Settlement transaction ID
      * @throws Error if no virtual outputs available to renew
      * @throws Error if total amount is below dust threshold
@@ -799,9 +813,12 @@ declare class VtxoManager implements AsyncDisposable, IVtxoManager {
      * const txid = await manager.renewVtxos((event) => {
      *   console.log('Settlement event:', event.type);
      * });
+     *
+     * // Renew only VTXOs that expire within 6 hours
+     * const txid = await manager.renewVtxos(undefined, { thresholdSeconds: 6 * 60 * 60 });
      * ```
      */
-    renewVtxos(eventCallback?: (event: SettlementEvent) => void): Promise<string>;
+    renewVtxos(eventCallback?: (event: SettlementEvent) => void, options?: RenewVtxosOptions): Promise<string>;
     /**
      * Get boarding inputs whose timelock has expired.
      *
@@ -3889,4 +3906,4 @@ declare namespace ProtoTypes {
     export {  };
 }
 
-export { CSVMultisigTapscript as $, type ArkTransaction as A, type BatchStartedEvent as B, type ContractRepository as C, type BatchFailedEvent as D, type ExtendedVirtualCoin as E, type TreeTxEvent as F, type GetVtxosFilter as G, type TreeSignatureEvent as H, type IWallet as I, type DescriptorProvider as J, type IReadonlyWallet as K, type ReadonlyIdentity as L, type DelegateProvider as M, type Network as N, type OnchainProvider as O, type ReadonlyWalletConfig as P, type IReadonlyAssetManager as Q, type Recipient as R, type SendBitcoinParams as S, type TxNotification as T, type NetworkName as U, VtxoScript as V, type WalletRepository as W, type ArkInfo as X, ArkAddress as Y, type Coin as Z, ContractManager as _, type Identity as a, type IDelegatorManager as a$, type SettlementConfig as a0, VtxoManager as a1, type SignerSession as a2, type SignedIntent as a3, Intent as a4, type DescriptorSigningRequest as a5, Transaction as a6, type IntentFeeConfig as a7, type OffchainInput as a8, FeeAmount as a9, type AssetMetadata as aA, type BaseWalletConfig as aB, type BatchInfo as aC, type BatchSignableIdentity as aD, CLTVMultisigTapscript as aE, ChainTxType as aF, type CommitmentTx as aG, ConditionCSVMultisigTapscript as aH, ConditionMultisigTapscript as aI, type ContractBalance as aJ, type ContractEventCallback as aK, type ContractHandler as aL, type ContractManagerConfig as aM, type ContractState as aN, type ContractVtxo as aO, ContractWatcher as aP, DelegateManagerImpl as aQ, type DelegateOptions as aR, DelegatorManagerImpl as aS, type DelegatorProvider as aT, type Discoverable as aU, type DiscoveredContract as aV, type DiscoveryDeps as aW, ESPLORA_URL as aX, EsploraProvider as aY, type ExtendedContractVtxo as aZ, type HandlerError as a_, type OnchainInput as aa, type FeeOutput as ab, type ContractWatcherConfig as ac, type FeeInfo as ad, type CreateContractParams as ae, type GetContractsFilter as af, type GetSpendablePathsOptions as ag, type GetAllSpendingPathsOptions as ah, type IssuanceParams as ai, type ReissuanceParams as aj, type BurnParams as ak, type ContractWithVtxos as al, type PathSelection as am, type ContractEvent as an, type AssetDetails as ao, type IssuanceResult as ap, type DelegateInfo as aq, type StorageConfig as ar, type IVtxoManager as as, type ExplorerTransaction as at, type EncodedVtxoScript as au, type Status as av, type Outpoint as aw, type ChainTx as ax, type ArkTapscript as ay, type Asset as az, type WalletConfig as b, IndexerTxType as b0, type KnownMetadata as b1, MultisigTapscript as b2, type Nonces as b3, type Output as b4, type PageResponse as b5, type PaginationOptions as b6, PartialSig as b7, type PathContext as b8, type ProviderClass as b9, isBatchSignable as bA, isDiscoverable as bB, isExpired as bC, isRecoverable as bD, isSpendable as bE, isSubdust as bF, isVtxoExpiringSoon as bG, networks as bH, RestDelegateProvider as ba, RestDelegatorProvider as bb, type ScanContractsOptions as bc, type ScanResult as bd, type ScheduledSession as be, SettlementEventType as bf, type SignRequest 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, decodeTapscript as by, getSequence as bz, type WalletBalance as c, type ExtendedCoin as d, type IContractManager as e, type IDelegateManager as f, type SettleParams as g, type SettlementEvent as h, type IAssetManager as i, RestArkProvider as j, RestIndexerProvider as k, type SubscriptionResponse as l, type ArkProvider as m, type IndexerProvider as n, type RelativeTimelock as o, type TapLeafScript as p, type VirtualCoin as q, type Contract as r, type VtxoRepositoryKey as s, type WalletState as t, type ContractFilter as u, type TreeSigningStartedEvent as v, TxTree as w, type TreeNoncesEvent as x, type BatchFinalizationEvent as y, type BatchFinalizedEvent as z };
+export { CSVMultisigTapscript as $, type ArkTransaction as A, type BatchStartedEvent as B, type ContractRepository as C, type BatchFailedEvent as D, type ExtendedVirtualCoin as E, type TreeTxEvent as F, type GetVtxosFilter as G, type TreeSignatureEvent as H, type IWallet as I, type DescriptorProvider as J, type IReadonlyWallet as K, type ReadonlyIdentity as L, type DelegateProvider as M, type Network as N, type OnchainProvider as O, type ReadonlyWalletConfig as P, type IReadonlyAssetManager as Q, type Recipient as R, type SendBitcoinParams as S, type TxNotification as T, type NetworkName as U, VtxoScript as V, type WalletRepository as W, type ArkInfo as X, ArkAddress as Y, type Coin as Z, ContractManager as _, type Identity as a, type HandlerError as a$, type SettlementConfig as a0, VtxoManager as a1, type SignerSession as a2, type SignedIntent as a3, Intent as a4, type DescriptorSigningRequest as a5, Transaction as a6, type IntentFeeConfig as a7, type OffchainInput as a8, FeeAmount as a9, type Asset as aA, type AssetMetadata as aB, type BaseWalletConfig as aC, type BatchInfo as aD, type BatchSignableIdentity as aE, CLTVMultisigTapscript as aF, ChainTxType as aG, type CommitmentTx as aH, ConditionCSVMultisigTapscript as aI, ConditionMultisigTapscript as aJ, type ContractBalance as aK, type ContractEventCallback as aL, type ContractHandler as aM, type ContractManagerConfig as aN, type ContractState as aO, type ContractVtxo as aP, ContractWatcher as aQ, DelegateManagerImpl as aR, type DelegateOptions as aS, DelegatorManagerImpl as aT, type DelegatorProvider as aU, type Discoverable as aV, type DiscoveredContract as aW, type DiscoveryDeps as aX, ESPLORA_URL as aY, EsploraProvider as aZ, type ExtendedContractVtxo as a_, type OnchainInput as aa, type FeeOutput as ab, type ContractWatcherConfig as ac, type FeeInfo as ad, type CreateContractParams as ae, type GetContractsFilter as af, type GetSpendablePathsOptions as ag, type GetAllSpendingPathsOptions as ah, type IssuanceParams as ai, type ReissuanceParams as aj, type BurnParams as ak, type RenewVtxosOptions as al, type ContractWithVtxos as am, type PathSelection as an, type ContractEvent as ao, type AssetDetails as ap, type IssuanceResult as aq, type DelegateInfo as ar, type StorageConfig as as, type IVtxoManager as at, type ExplorerTransaction as au, type EncodedVtxoScript as av, type Status as aw, type Outpoint as ax, type ChainTx as ay, type ArkTapscript as az, type WalletConfig as b, type IDelegatorManager as b0, IndexerTxType as b1, type KnownMetadata as b2, MultisigTapscript as b3, type Nonces as b4, type Output as b5, type PageResponse as b6, type PaginationOptions as b7, PartialSig as b8, type PathContext as b9, getSequence as bA, isBatchSignable as bB, isDiscoverable as bC, isExpired as bD, isRecoverable as bE, isSpendable as bF, isSubdust as bG, isVtxoExpiringSoon as bH, networks as bI, type ProviderClass as ba, RestDelegateProvider as bb, RestDelegatorProvider as bc, type ScanContractsOptions as bd, type ScanResult as be, type ScheduledSession as bf, SettlementEventType as bg, type SignRequest as bh, type SubscriptionEvent as bi, type SubscriptionHeartbeat as bj, type TapLeaves as bk, TapTreeCoder as bl, TapscriptType as bm, type TreeNonces as bn, type TreePartialSigs as bo, type Tx as bp, type TxHistoryRecord as bq, type TxKey as br, type TxTreeNode as bs, TxType as bt, type VirtualStatus as bu, type Vtxo as bv, type VtxoChain as bw, type VtxoType as bx, type WalletMode as by, decodeTapscript as bz, type WalletBalance as c, type ExtendedCoin as d, type IContractManager as e, type IDelegateManager as f, type SettleParams as g, type SettlementEvent as h, type IAssetManager as i, RestArkProvider as j, RestIndexerProvider as k, type SubscriptionResponse as l, type ArkProvider as m, type IndexerProvider as n, type RelativeTimelock as o, type TapLeafScript as p, type VirtualCoin as q, type Contract as r, type VtxoRepositoryKey as s, type WalletState as t, type ContractFilter as u, type TreeSigningStartedEvent as v, TxTree as w, type TreeNoncesEvent as x, type BatchFinalizationEvent as y, type BatchFinalizedEvent as z };

package/dist/{asyncStorageTaskQueue-DZ0nUuEJ.d.ts → asyncStorageTaskQueue-BEOFPNc0.d.ts}

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

package/dist/{asyncStorageTaskQueue-DW1-BpI7.d.cts → asyncStorageTaskQueue-VGHXWR9F.d.cts}

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

package/dist/{chunk-TH6T23XG.js → chunk-AXGVYRAL.js}

@@ -1,4 +1,4 @@
-import { getRandomId, extendVirtualCoinForContract, warnAndFilterVtxosForScript, saveVtxosForContract } from './chunk-BVP2U66Q.js';
+import { getRandomId, extendVirtualCoinForContract, warnAndFilterVtxosForScript, saveVtxosForContract } from './chunk-HJM6JPG4.js';
 
 // src/worker/expo/taskRunner.ts
 async function runTasks(queue, processors, deps) {
@@ -91,5 +91,5 @@ var contractPollProcessor = {
 };
 
 export { CONTRACT_POLL_TASK_TYPE, contractPollProcessor, createTaskDependencies, runTasks };
-//# sourceMappingURL=chunk-TH6T23XG.js.map
-//# sourceMappingURL=chunk-TH6T23XG.js.map
+//# sourceMappingURL=chunk-AXGVYRAL.js.map
+//# sourceMappingURL=chunk-AXGVYRAL.js.map

package/dist/{chunk-TH6T23XG.js.map → chunk-AXGVYRAL.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/worker/expo/taskRunner.ts","../src/worker/expo/processors/contractPollProcessor.ts"],"names":[],"mappings":"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","file":"chunk-TH6T23XG.js","sourcesContent":["import type { TaskItem, TaskResult, TaskQueue } from \"./taskQueue\";\nimport type { WalletRepository } from \"../../repositories/walletRepository\";\nimport type { ContractRepository } from \"../../repositories/contractRepository\";\nimport type { IndexerProvider } from \"../../providers/indexer\";\nimport type { ArkProvider } from \"../../providers/ark\";\nimport type { ExtendedVirtualCoin, VirtualCoin } from \"../../wallet\";\nimport type { Contract } from \"../../contracts/types\";\nimport { getRandomId, extendVirtualCoinForContract } from \"../../wallet/utils\";\n\n/**\n * Shared dependencies injected into every processor at runtime.\n *\n * `extendVtxo` requires the owning contract — processors must resolve each\n * vtxo's `script` to a known contract (via the contract repository) before\n * calling this. The strict signature prevents the footgun where a missing\n * contract silently falls back to the wallet's default tapscript.\n */\nexport interface TaskDependencies {\n    walletRepository: WalletRepository;\n    contractRepository: ContractRepository;\n    indexerProvider: IndexerProvider;\n    arkProvider: ArkProvider;\n    extendVtxo: (vtxo: VirtualCoin, contract: Contract) => ExtendedVirtualCoin;\n}\n\n/**\n * A stateless unit that handles one type of task item.\n *\n * Processors must not keep in-memory state across invocations —\n * all coordination lives in the @see TaskQueue and repositories.\n *\n * The `TDeps` parameter defaults to @see TaskDependencies but\n * can be overridden for domain-specific processors (e.g. swap processing).\n */\nexport interface TaskProcessor<TDeps = TaskDependencies> {\n    readonly taskType: string;\n    execute(item: TaskItem, deps: TDeps): Promise<Omit<TaskResult, \"id\" | \"executedAt\">>;\n}\n\n/**\n * Run all pending tasks from the queue through matching processors.\n *\n * For each task in the inbox:\n * 1. Find the processor whose `taskType` matches `task.type`.\n * 2. Execute it, producing a @see TaskResult.\n * 3. Push the result to the outbox and remove the task from the inbox.\n *\n * Tasks with no matching processor produce a `\"noop\"` result.\n * Processor errors produce a `\"failed\"` result with the error message.\n */\nexport async function runTasks<TDeps = TaskDependencies>(\n    queue: TaskQueue,\n    processors: TaskProcessor<TDeps>[],\n    deps: TDeps,\n): Promise<TaskResult[]> {\n    const tasks = await queue.getTasks();\n    const processorMap = new Map(processors.map((p) => [p.taskType, p]));\n    const results: TaskResult[] = [];\n\n    for (const task of tasks) {\n        const processor = processorMap.get(task.type);\n\n        let partial: Omit<TaskResult, \"id\" | \"executedAt\">;\n\n        if (!processor) {\n            partial = {\n                taskItemId: task.id,\n                type: task.type,\n                status: \"noop\",\n            };\n        } else {\n            try {\n                partial = await processor.execute(task, deps);\n            } catch (error) {\n                partial = {\n                    taskItemId: task.id,\n                    type: task.type,\n                    status: \"failed\",\n                    data: {\n                        error: error instanceof Error ? error.message : String(error),\n                    },\n                };\n            }\n        }\n\n        const result: TaskResult = {\n            ...partial,\n            id: getRandomId(),\n            executedAt: Date.now(),\n        };\n\n        await queue.pushResult(result);\n        await queue.removeTask(task.id);\n        results.push(result);\n    }\n\n    return results;\n}\n\n/**\n * Options for @see createTaskDependencies.\n */\nexport interface CreateTaskDependenciesOptions {\n    walletRepository: WalletRepository;\n    contractRepository: ContractRepository;\n    indexerProvider: IndexerProvider;\n    arkProvider: ArkProvider;\n}\n\n/**\n * Build the @see TaskDependencies needed by task processors\n * (e.g. `src/worker/expo/processors/contractPollProcessor.ts`)\n *\n * This is the same construction that `defineExpoBackgroundTask` does\n * internally, extracted so that consumers with custom schedulers\n * (e.g. bare React Native with `react-native-background-fetch`)\n * can build deps without depending on Expo.\n */\nexport function createTaskDependencies(options: CreateTaskDependenciesOptions): TaskDependencies {\n    return {\n        ...options,\n        extendVtxo: (vtxo: VirtualCoin, contract: Contract) =>\n            extendVirtualCoinForContract(vtxo, contract),\n    };\n}\n","import type { TaskItem, TaskResult } from \"../taskQueue\";\nimport type { TaskProcessor, TaskDependencies } from \"../taskRunner\";\nimport type { ExtendedVirtualCoin } from \"../../../wallet\";\nimport {\n    warnAndFilterVtxosForScript,\n    saveVtxosForContract,\n} from \"../../../contracts/vtxoOwnership\";\n\nexport const CONTRACT_POLL_TASK_TYPE = \"contract-poll\";\n\n/**\n * Polls the indexer for the latest VTXO state of every contract and\n * persists the results to the wallet repository.\n *\n * Replicates the polling subset of @see ContractManager.initialize:\n * 1. Load all contracts from the contract repository.\n * 2. Paginated fetch of every VTXO (including spent) from the indexer.\n * 3. Extend each VTXO with tapscript data.\n * 4. Save to the wallet repository.\n *\n * NOTE: the indexer query deliberately omits `spendableOnly`. Every\n * repository implements `saveVtxos` as an upsert with no batch delete,\n * so filtering to spendable-only would leave VTXOs that became spent\n * between polls marked as spendable forever. Fetching the full set lets\n * the upsert overwrite stale records with their latest state.\n */\nexport const contractPollProcessor: TaskProcessor = {\n    taskType: CONTRACT_POLL_TASK_TYPE,\n\n    async execute(\n        item: TaskItem,\n        deps: TaskDependencies,\n    ): Promise<Omit<TaskResult, \"id\" | \"executedAt\">> {\n        const { contractRepository, walletRepository, indexerProvider, extendVtxo } = deps;\n\n        const contracts = await contractRepository.getContracts();\n        let contractsProcessed = 0;\n        let vtxosSaved = 0;\n\n        for (const contract of contracts) {\n            // Paginated fetch of spendable virtual outputs\n            const pageSize = 100;\n            let pageIndex = 0;\n            let hasMore = true;\n            const allVtxos: ExtendedVirtualCoin[] = [];\n\n            while (hasMore) {\n                const { vtxos, page } = await indexerProvider.getVtxos({\n                    scripts: [contract.script],\n                    pageIndex,\n                    pageSize,\n                });\n\n                for (const vtxo of vtxos) {\n                    allVtxos.push(extendVtxo(vtxo, contract));\n                }\n\n                hasMore = page ? vtxos.length === pageSize : false;\n                pageIndex++;\n            }\n\n            // Skip wrong-script rows (legacy duplicates or indexer drift)\n            // before persisting; the loop must keep going for the remaining\n            // contracts even when one row is rejected.\n            const filtered = warnAndFilterVtxosForScript(\n                allVtxos,\n                contract.script,\n                \"contractPollProcessor\",\n            );\n            await saveVtxosForContract(walletRepository, contract, filtered);\n            vtxosSaved += filtered.length;\n            contractsProcessed++;\n        }\n\n        return {\n            taskItemId: item.id,\n            type: CONTRACT_POLL_TASK_TYPE,\n            status: \"success\",\n            data: { contractsProcessed, vtxosSaved },\n        };\n    },\n};\n"]}
+{"version":3,"sources":["../src/worker/expo/taskRunner.ts","../src/worker/expo/processors/contractPollProcessor.ts"],"names":[],"mappings":"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","file":"chunk-AXGVYRAL.js","sourcesContent":["import type { TaskItem, TaskResult, TaskQueue } from \"./taskQueue\";\nimport type { WalletRepository } from \"../../repositories/walletRepository\";\nimport type { ContractRepository } from \"../../repositories/contractRepository\";\nimport type { IndexerProvider } from \"../../providers/indexer\";\nimport type { ArkProvider } from \"../../providers/ark\";\nimport type { ExtendedVirtualCoin, VirtualCoin } from \"../../wallet\";\nimport type { Contract } from \"../../contracts/types\";\nimport { getRandomId, extendVirtualCoinForContract } from \"../../wallet/utils\";\n\n/**\n * Shared dependencies injected into every processor at runtime.\n *\n * `extendVtxo` requires the owning contract — processors must resolve each\n * vtxo's `script` to a known contract (via the contract repository) before\n * calling this. The strict signature prevents the footgun where a missing\n * contract silently falls back to the wallet's default tapscript.\n */\nexport interface TaskDependencies {\n    walletRepository: WalletRepository;\n    contractRepository: ContractRepository;\n    indexerProvider: IndexerProvider;\n    arkProvider: ArkProvider;\n    extendVtxo: (vtxo: VirtualCoin, contract: Contract) => ExtendedVirtualCoin;\n}\n\n/**\n * A stateless unit that handles one type of task item.\n *\n * Processors must not keep in-memory state across invocations —\n * all coordination lives in the @see TaskQueue and repositories.\n *\n * The `TDeps` parameter defaults to @see TaskDependencies but\n * can be overridden for domain-specific processors (e.g. swap processing).\n */\nexport interface TaskProcessor<TDeps = TaskDependencies> {\n    readonly taskType: string;\n    execute(item: TaskItem, deps: TDeps): Promise<Omit<TaskResult, \"id\" | \"executedAt\">>;\n}\n\n/**\n * Run all pending tasks from the queue through matching processors.\n *\n * For each task in the inbox:\n * 1. Find the processor whose `taskType` matches `task.type`.\n * 2. Execute it, producing a @see TaskResult.\n * 3. Push the result to the outbox and remove the task from the inbox.\n *\n * Tasks with no matching processor produce a `\"noop\"` result.\n * Processor errors produce a `\"failed\"` result with the error message.\n */\nexport async function runTasks<TDeps = TaskDependencies>(\n    queue: TaskQueue,\n    processors: TaskProcessor<TDeps>[],\n    deps: TDeps,\n): Promise<TaskResult[]> {\n    const tasks = await queue.getTasks();\n    const processorMap = new Map(processors.map((p) => [p.taskType, p]));\n    const results: TaskResult[] = [];\n\n    for (const task of tasks) {\n        const processor = processorMap.get(task.type);\n\n        let partial: Omit<TaskResult, \"id\" | \"executedAt\">;\n\n        if (!processor) {\n            partial = {\n                taskItemId: task.id,\n                type: task.type,\n                status: \"noop\",\n            };\n        } else {\n            try {\n                partial = await processor.execute(task, deps);\n            } catch (error) {\n                partial = {\n                    taskItemId: task.id,\n                    type: task.type,\n                    status: \"failed\",\n                    data: {\n                        error: error instanceof Error ? error.message : String(error),\n                    },\n                };\n            }\n        }\n\n        const result: TaskResult = {\n            ...partial,\n            id: getRandomId(),\n            executedAt: Date.now(),\n        };\n\n        await queue.pushResult(result);\n        await queue.removeTask(task.id);\n        results.push(result);\n    }\n\n    return results;\n}\n\n/**\n * Options for @see createTaskDependencies.\n */\nexport interface CreateTaskDependenciesOptions {\n    walletRepository: WalletRepository;\n    contractRepository: ContractRepository;\n    indexerProvider: IndexerProvider;\n    arkProvider: ArkProvider;\n}\n\n/**\n * Build the @see TaskDependencies needed by task processors\n * (e.g. `src/worker/expo/processors/contractPollProcessor.ts`)\n *\n * This is the same construction that `defineExpoBackgroundTask` does\n * internally, extracted so that consumers with custom schedulers\n * (e.g. bare React Native with `react-native-background-fetch`)\n * can build deps without depending on Expo.\n */\nexport function createTaskDependencies(options: CreateTaskDependenciesOptions): TaskDependencies {\n    return {\n        ...options,\n        extendVtxo: (vtxo: VirtualCoin, contract: Contract) =>\n            extendVirtualCoinForContract(vtxo, contract),\n    };\n}\n","import type { TaskItem, TaskResult } from \"../taskQueue\";\nimport type { TaskProcessor, TaskDependencies } from \"../taskRunner\";\nimport type { ExtendedVirtualCoin } from \"../../../wallet\";\nimport {\n    warnAndFilterVtxosForScript,\n    saveVtxosForContract,\n} from \"../../../contracts/vtxoOwnership\";\n\nexport const CONTRACT_POLL_TASK_TYPE = \"contract-poll\";\n\n/**\n * Polls the indexer for the latest VTXO state of every contract and\n * persists the results to the wallet repository.\n *\n * Replicates the polling subset of @see ContractManager.initialize:\n * 1. Load all contracts from the contract repository.\n * 2. Paginated fetch of every VTXO (including spent) from the indexer.\n * 3. Extend each VTXO with tapscript data.\n * 4. Save to the wallet repository.\n *\n * NOTE: the indexer query deliberately omits `spendableOnly`. Every\n * repository implements `saveVtxos` as an upsert with no batch delete,\n * so filtering to spendable-only would leave VTXOs that became spent\n * between polls marked as spendable forever. Fetching the full set lets\n * the upsert overwrite stale records with their latest state.\n */\nexport const contractPollProcessor: TaskProcessor = {\n    taskType: CONTRACT_POLL_TASK_TYPE,\n\n    async execute(\n        item: TaskItem,\n        deps: TaskDependencies,\n    ): Promise<Omit<TaskResult, \"id\" | \"executedAt\">> {\n        const { contractRepository, walletRepository, indexerProvider, extendVtxo } = deps;\n\n        const contracts = await contractRepository.getContracts();\n        let contractsProcessed = 0;\n        let vtxosSaved = 0;\n\n        for (const contract of contracts) {\n            // Paginated fetch of spendable virtual outputs\n            const pageSize = 100;\n            let pageIndex = 0;\n            let hasMore = true;\n            const allVtxos: ExtendedVirtualCoin[] = [];\n\n            while (hasMore) {\n                const { vtxos, page } = await indexerProvider.getVtxos({\n                    scripts: [contract.script],\n                    pageIndex,\n                    pageSize,\n                });\n\n                for (const vtxo of vtxos) {\n                    allVtxos.push(extendVtxo(vtxo, contract));\n                }\n\n                hasMore = page ? vtxos.length === pageSize : false;\n                pageIndex++;\n            }\n\n            // Skip wrong-script rows (legacy duplicates or indexer drift)\n            // before persisting; the loop must keep going for the remaining\n            // contracts even when one row is rejected.\n            const filtered = warnAndFilterVtxosForScript(\n                allVtxos,\n                contract.script,\n                \"contractPollProcessor\",\n            );\n            await saveVtxosForContract(walletRepository, contract, filtered);\n            vtxosSaved += filtered.length;\n            contractsProcessed++;\n        }\n\n        return {\n            taskItemId: item.id,\n            type: CONTRACT_POLL_TASK_TYPE,\n            status: \"success\",\n            data: { contractsProcessed, vtxosSaved },\n        };\n    },\n};\n"]}

package/dist/{chunk-GDCTOSMV.cjs → chunk-GPZH5QNA.cjs}

@@ -2278,27 +2278,57 @@ function extendCoin(wallet, utxo) {
     tapTree: wallet.boardingTapscript.encode()
   };
 }
-function extendVtxoFromContract(vtxo, contract) {
+function deriveContractTapscripts(contract) {
   const handler = chunkIEO3XDKI_cjs.contractHandlers.get(contract.type);
   if (!handler) {
     throw new Error(`No handler for contract type '${contract.type}'`);
   }
   const script = handler.createScript(contract.params);
   return {
-    ...vtxo,
     forfeitTapLeafScript: script.forfeit(),
     intentTapLeafScript: script.forfeit(),
     tapTree: script.encode()
   };
 }
-function extendVirtualCoinForContract(vtxo, contractOrMap) {
+function cloneTapLeafScript([
+  controlBlock,
+  script
+]) {
+  return [
+    {
+      version: controlBlock.version,
+      internalKey: new Uint8Array(controlBlock.internalKey),
+      merklePath: controlBlock.merklePath.map((hash) => new Uint8Array(hash))
+    },
+    new Uint8Array(script)
+  ];
+}
+function cloneContractTapscripts(tapscripts) {
+  return {
+    forfeitTapLeafScript: cloneTapLeafScript(tapscripts.forfeitTapLeafScript),
+    intentTapLeafScript: cloneTapLeafScript(tapscripts.intentTapLeafScript),
+    tapTree: new Uint8Array(tapscripts.tapTree)
+  };
+}
+function extendVtxoFromContract(vtxo, contract, cache) {
+  if (!cache) {
+    return { ...vtxo, ...deriveContractTapscripts(contract) };
+  }
+  let tapscripts = cache.get(contract.script);
+  if (!tapscripts) {
+    tapscripts = deriveContractTapscripts(contract);
+    cache.set(contract.script, tapscripts);
+  }
+  return { ...vtxo, ...cloneContractTapscripts(tapscripts) };
+}
+function extendVirtualCoinForContract(vtxo, contractOrMap, cache) {
   const contract = resolveContract(vtxo, contractOrMap);
   if (!contract) {
     throw new Error(
       "extendVirtualCoinForContract: no contract matched vtxo.script \u2014 callers must resolve the owning contract before annotating"
     );
   }
-  return extendVtxoFromContract(vtxo, contract);
+  return extendVtxoFromContract(vtxo, contract, cache);
 }
 function isContractMap(value) {
   return typeof value.get === "function";
@@ -2621,6 +2651,7 @@ var VtxoManager = class _VtxoManager {
    * primary way to prevent virtual outputs from expiring.
    *
    * @param eventCallback - Optional callback for settlement events
+   * @param options - Optional per-call overrides; see {@link RenewVtxosOptions}
    * @returns Settlement transaction ID
    * @throws Error if no virtual outputs available to renew
    * @throws Error if total amount is below dust threshold
@@ -2636,15 +2667,33 @@ var VtxoManager = class _VtxoManager {
    * const txid = await manager.renewVtxos((event) => {
    *   console.log('Settlement event:', event.type);
    * });
+   *
+   * // Renew only VTXOs that expire within 6 hours
+   * const txid = await manager.renewVtxos(undefined, { thresholdSeconds: 6 * 60 * 60 });
    * ```
    */
-  async renewVtxos(eventCallback) {
+  async renewVtxos(eventCallback, options) {
+    if (options?.thresholdSeconds !== void 0) {
+      const { thresholdSeconds } = options;
+      if (typeof thresholdSeconds !== "number" || !Number.isFinite(thresholdSeconds) || thresholdSeconds <= 0) {
+        throw new TypeError(
+          `Invalid thresholdSeconds: expected a positive finite number, got ${String(thresholdSeconds)}`
+        );
+      }
+    }
     if (this.renewalInProgress) {
       throw new Error("Renewal already in progress");
     }
     this.renewalInProgress = true;
     try {
-      const threshold = this.settlementConfig !== false && this.settlementConfig?.vtxoThreshold !== void 0 ? this.settlementConfig.vtxoThreshold * 1e3 : DEFAULT_RENEWAL_CONFIG.thresholdMs;
+      let threshold;
+      if (options?.thresholdSeconds !== void 0) {
+        threshold = options.thresholdSeconds * 1e3;
+      } else if (this.settlementConfig !== false && this.settlementConfig?.vtxoThreshold !== void 0) {
+        threshold = this.settlementConfig.vtxoThreshold * 1e3;
+      } else {
+        threshold = DEFAULT_RENEWAL_CONFIG.thresholdMs;
+      }
       let vtxos = await this.getExpiringVtxos(threshold);
       if (vtxos.length === 0) {
         throw new Error("No VTXOs available to renew");
@@ -6692,7 +6741,8 @@ var ContractManager = class _ContractManager {
     for (const contract of contracts) {
       byScript.set(contract.script, contract);
     }
-    return vtxos.map((vtxo) => extendVirtualCoinForContract(vtxo, byScript));
+    const tapscriptCache = /* @__PURE__ */ new Map();
+    return vtxos.map((vtxo) => extendVirtualCoinForContract(vtxo, byScript, tapscriptCache));
   }
   buildContractsDbFilter(filter) {
     return {
@@ -10929,7 +10979,7 @@ var WalletMessageHandler = class {
                 payload: e
               })
             );
-          });
+          }, message.payload);
           return this.tagged({
             id,
             type: "RENEW_VTXOS_SUCCESS",
@@ -12546,11 +12596,12 @@ var ServiceWorkerWallet = class _ServiceWorkerWallet extends ServiceWorkerReadon
           throw new Error(`Failed to get expiring vtxos: ${e}`);
         }
       },
-      async renewVtxos(eventCallback) {
+      async renewVtxos(eventCallback, options) {
         const message = {
           tag: messageTag,
           type: "RENEW_VTXOS",
-          id: getRandomId()
+          id: getRandomId(),
+          payload: options
         };
         try {
           const response = await wallet.sendMessageWithEvents(
@@ -14054,5 +14105,5 @@ exports.validateVtxoTxGraph = validateVtxoTxGraph;
 exports.verifyTapscriptSignatures = verifyTapscriptSignatures;
 exports.waitForIncomingFunds = waitForIncomingFunds;
 exports.warnAndFilterVtxosForScript = warnAndFilterVtxosForScript;
-//# sourceMappingURL=chunk-GDCTOSMV.cjs.map
-//# sourceMappingURL=chunk-GDCTOSMV.cjs.map
+//# sourceMappingURL=chunk-GPZH5QNA.cjs.map
+//# sourceMappingURL=chunk-GPZH5QNA.cjs.map