@arkade-os/sdk 0.4.24 → 0.4.26

package/dist/types/script/default.d.ts

@@ -1,6 +1,6 @@
 import { Bytes } from "@scure/btc-signer/utils.js";
-import { TapLeafScript, VtxoScript } from "./base";
-import { RelativeTimelock } from "./tapscript";
+import { TapLeafScript, VtxoScript } from "./base.js";
+import { RelativeTimelock } from "./tapscript.js";
 /**
  * DefaultVtxo is the default implementation of a VtxoScript.
  * It contains 1 forfeit path and 1 exit path.

package/dist/types/script/delegate.d.ts

@@ -1,6 +1,6 @@
-import { Bytes } from "@scure/btc-signer/utils";
-import { DefaultVtxo } from "./default";
-import { TapLeafScript, VtxoScript } from "./base";
+import { Bytes } from "@scure/btc-signer/utils.js";
+import { DefaultVtxo } from "./default.js";
+import { TapLeafScript, VtxoScript } from "./base.js";
 /**
  * DelegateVtxo extends DefaultVtxo with an extra delegator path
  */

package/dist/types/script/vhtlc.d.ts

@@ -1,6 +1,6 @@
 import { Bytes } from "@scure/btc-signer/utils.js";
-import { RelativeTimelock } from "./tapscript";
-import { TapLeafScript, VtxoScript } from "./base";
+import { RelativeTimelock } from "./tapscript.js";
+import { TapLeafScript, VtxoScript } from "./base.js";
 /** Virtual Hash Time Lock Contract (VHTLC) namespace. */
 export declare namespace VHTLC {
     interface Options {

package/dist/types/storage/asyncStorage.d.ts

@@ -1,4 +1,4 @@
-import type { StorageAdapter } from "./index";
+import type { StorageAdapter } from "./index.js";
 /**
  * @deprecated Use repositories instead
  * Note: This requires @react-native-async-storage/async-storage to be installed

package/dist/types/storage/fileSystem.d.ts

@@ -1,4 +1,4 @@
-import type { StorageAdapter } from "./index";
+import type { StorageAdapter } from "./index.js";
 /**
  * @deprecated Use repository implementations via `StorageConfig` instead.
  */

package/dist/types/storage/inMemory.d.ts

@@ -1,4 +1,4 @@
-import type { StorageAdapter } from "./index";
+import type { StorageAdapter } from "./index.js";
 /**
  * @deprecated Use repository implementations via `StorageConfig` instead.
  */

package/dist/types/storage/indexedDB.d.ts

@@ -1,4 +1,4 @@
-import type { StorageAdapter } from "./index";
+import type { StorageAdapter } from "./index.js";
 /**
  * @deprecated Use repository implementations via `StorageConfig` instead.
  */

package/dist/types/storage/localStorage.d.ts

@@ -1,4 +1,4 @@
-import type { StorageAdapter } from "./index";
+import type { StorageAdapter } from "./index.js";
 /**
  * @deprecated Use repository implementations via `StorageConfig` instead.
  */

package/dist/types/tree/signingSession.d.ts

@@ -1,5 +1,5 @@
-import * as musig2 from "../musig2";
-import { TxTree } from "./txTree";
+import * as musig2 from "../musig2/index.js";
+import { TxTree } from "./txTree.js";
 export declare const ErrMissingVtxoGraph: Error;
 export declare const ErrMissingAggregateKey: Error;
 export type Musig2PublicNonce = Pick<musig2.Nonces, "pubNonce">;

package/dist/types/tree/validation.d.ts

@@ -1,5 +1,5 @@
 import { Transaction } from "@scure/btc-signer/transaction.js";
-import { TxTree } from "./txTree";
+import { TxTree } from "./txTree.js";
 export declare const ErrInvalidSettlementTx: (tx: string) => Error;
 export declare const ErrInvalidSettlementTxOutputs: Error;
 export declare const ErrEmptyTree: Error;

package/dist/types/utils/arkTransaction.d.ts

@@ -1,9 +1,9 @@
 import { TransactionOutput } from "@scure/btc-signer/psbt.js";
-import { ExtendedCoin, VirtualCoin } from "../wallet";
-import { RelativeTimelock } from "../script/tapscript";
-import { EncodedVtxoScript, TapLeafScript } from "../script/base";
-import { CSVMultisigTapscript } from "../script/tapscript";
-import { Transaction } from "./transaction";
+import { ExtendedCoin, VirtualCoin } from "../wallet/index.js";
+import { RelativeTimelock } from "../script/tapscript.js";
+import { EncodedVtxoScript, TapLeafScript } from "../script/base.js";
+import { CSVMultisigTapscript } from "../script/tapscript.js";
+import { Transaction } from "./transaction.js";
 export type ArkTxInput = {
     tapLeafScript: TapLeafScript;
 } & EncodedVtxoScript & Pick<VirtualCoin, "txid" | "vout" | "value">;

package/dist/types/utils/syncCursors.d.ts

@@ -1,4 +1,4 @@
-import { WalletRepository, WalletState } from "../repositories/walletRepository";
+import { WalletRepository, WalletState } from "../repositories/walletRepository.js";
 /** Lag behind real-time to avoid racing with indexer writes. */
 export declare const SAFETY_LAG_MS = 30000;
 /** Overlap window so boundary virtual outputs are never missed. */

package/dist/types/utils/timelock.d.ts

@@ -1,4 +1,4 @@
-import type { RelativeTimelock } from "../script/tapscript";
+import type { RelativeTimelock } from "../script/tapscript.js";
 /**
  * Convert RelativeTimelock to BIP68 sequence number.
  */

package/dist/types/utils/transaction.d.ts

@@ -1,6 +1,6 @@
 import { Transaction as BtcSignerTransaction } from "@scure/btc-signer";
-import { TxOpts } from "@scure/btc-signer/transaction";
-import { Bytes } from "@scure/btc-signer/utils";
+import { TxOpts } from "@scure/btc-signer/transaction.js";
+import { Bytes } from "@scure/btc-signer/utils.js";
 /**
  * Transaction is a wrapper around the @scure/btc-signer Transaction class.
  * It adds the Arkade protocol specific options to the transaction.

package/dist/types/utils/transactionHistory.d.ts

@@ -1,4 +1,4 @@
-import { ArkTransaction, VirtualCoin } from "../wallet";
+import { ArkTransaction, VirtualCoin } from "../wallet/index.js";
 type ExtendedArkTransaction = ArkTransaction & {
     tag: "offchain" | "boarding" | "exit" | "batch";
 };

package/dist/types/utils/txSizeEstimator.d.ts

@@ -1,4 +1,4 @@
-import { Network } from "../networks";
+import { Network } from "../networks.js";
 export type VSize = {
     value: bigint;
     fee(feeRate: bigint): bigint;

package/dist/types/wallet/asset-manager.d.ts

@@ -1,6 +1,6 @@
-import { AssetDetails, BurnParams, IAssetManager, IReadonlyAssetManager, IssuanceParams, IssuanceResult, ReissuanceParams } from ".";
-import { IndexerProvider } from "../providers/indexer";
-import { Wallet } from "./wallet";
+import { AssetDetails, BurnParams, IAssetManager, IReadonlyAssetManager, IssuanceParams, IssuanceResult, ReissuanceParams } from "./index.js";
+import { IndexerProvider } from "../providers/indexer.js";
+import { Wallet } from "./wallet.js";
 export declare class ReadonlyAssetManager implements IReadonlyAssetManager {
     readonly indexer: IndexerProvider;
     constructor(indexer: IndexerProvider);

package/dist/types/wallet/asset.d.ts

@@ -1,5 +1,5 @@
-import { Packet } from "../extension/asset";
-import { Asset, ExtendedVirtualCoin, Recipient, VirtualCoin } from "./index";
+import { Packet } from "../extension/asset/index.js";
+import { Asset, ExtendedVirtualCoin, Recipient, VirtualCoin } from "./index.js";
 /**
  * Creates an asset packet from asset inputs and receivers.
  * Groups inputs and outputs by asset ID and creates the Packet object

package/dist/types/wallet/batch.d.ts

@@ -1,5 +1,5 @@
-import type { BatchStartedEvent, BatchFinalizedEvent, BatchFailedEvent, TreeTxEvent, TreeSignatureEvent, TreeSigningStartedEvent, TreeNoncesEvent, BatchFinalizationEvent, SettlementEvent } from "../providers/ark";
-import { TxTree } from "../tree/txTree";
+import type { BatchStartedEvent, BatchFinalizedEvent, BatchFailedEvent, TreeTxEvent, TreeSignatureEvent, TreeSigningStartedEvent, TreeNoncesEvent, BatchFinalizationEvent, SettlementEvent } from "../providers/ark.js";
+import { TxTree } from "../tree/txTree.js";
 /**
  * Batch namespace provides utilities for joining and processing batch session.
  * The batch settlement process involves multiple events, this namespace provides abstractions and types to handle them.

package/dist/types/wallet/delegator.d.ts

@@ -1,8 +1,8 @@
-import { TransactionOutput } from "@scure/btc-signer/psbt";
-import { ArkProvider, DelegateInfo, Identity, Outpoint } from "..";
-import { ContractVtxo } from "../contracts/types";
-import { DelegatorProvider } from "../providers/delegator";
-import { Bytes } from "@scure/btc-signer/utils";
+import { TransactionOutput } from "@scure/btc-signer/psbt.js";
+import { ArkProvider, DelegateInfo, Identity, Outpoint } from "../index.js";
+import { ContractVtxo } from "../contracts/types.js";
+import { DelegatorProvider } from "../providers/delegator.js";
+import { Bytes } from "@scure/btc-signer/utils.js";
 export interface IDelegatorManager {
     /**
      * Delegate virtual outputs to the remote delegation service.

package/dist/types/wallet/expo/background.d.ts

@@ -1,7 +1,7 @@
-import type { WalletRepository } from "../../repositories/walletRepository";
-import type { ContractRepository } from "../../repositories/contractRepository";
-import type { AsyncStorageTaskQueue } from "../../worker/expo/asyncStorageTaskQueue";
-import type { TaskProcessor } from "../../worker/expo/taskRunner";
+import type { WalletRepository } from "../../repositories/walletRepository.js";
+import type { ContractRepository } from "../../repositories/contractRepository.js";
+import type { AsyncStorageTaskQueue } from "../../worker/expo/asyncStorageTaskQueue.js";
+import type { TaskProcessor } from "../../worker/expo/taskRunner.js";
 /**
  * Wallet parameters persisted by @see ExpoWallet.setup and read
  * by the background handler to reconstruct providers and `extendVtxo`

package/dist/types/wallet/expo/index.d.ts

@@ -1,4 +1,4 @@
-export { ExpoWallet } from "./wallet";
-export type { ExpoWalletConfig, ExpoBackgroundConfig } from "./wallet";
-export { defineExpoBackgroundTask, registerExpoBackgroundTask, unregisterExpoBackgroundTask, } from "./background";
-export type { DefineBackgroundTaskOptions, PersistedBackgroundConfig, } from "./background";
+export { ExpoWallet } from "./wallet.js";
+export type { ExpoWalletConfig, ExpoBackgroundConfig } from "./wallet.js";
+export { defineExpoBackgroundTask, registerExpoBackgroundTask, unregisterExpoBackgroundTask, } from "./background.js";
+export type { DefineBackgroundTaskOptions, PersistedBackgroundConfig, } from "./background.js";

package/dist/types/wallet/expo/wallet.d.ts

@@ -1,11 +1,11 @@
-import { Wallet } from "../wallet";
-import type { IWallet, IAssetManager, WalletBalance, WalletConfig, SendBitcoinParams, SettleParams, GetVtxosFilter, ArkTransaction, ExtendedCoin, ExtendedVirtualCoin, Recipient } from "..";
-import type { SettlementEvent } from "../../providers/ark";
-import type { Identity } from "../../identity";
-import type { IContractManager } from "../../contracts/contractManager";
-import type { IDelegatorManager } from "../delegator";
-import type { TaskQueue } from "../../worker/expo/taskQueue";
-import type { TaskProcessor } from "../../worker/expo/taskRunner";
+import { Wallet } from "../wallet.js";
+import type { IWallet, IAssetManager, WalletBalance, WalletConfig, SendBitcoinParams, SettleParams, GetVtxosFilter, ArkTransaction, ExtendedCoin, ExtendedVirtualCoin, Recipient } from "../index.js";
+import type { SettlementEvent } from "../../providers/ark.js";
+import type { Identity } from "../../identity/index.js";
+import type { IContractManager } from "../../contracts/contractManager.js";
+import type { IDelegatorManager } from "../delegator.js";
+import type { TaskQueue } from "../../worker/expo/taskQueue.js";
+import type { TaskProcessor } from "../../worker/expo/taskRunner.js";
 /**
  * Background processing configuration for @see ExpoWallet.
  */

package/dist/types/wallet/hdDescriptorProvider.d.ts

@@ -1,7 +1,7 @@
-import { DescriptorProvider, DescriptorSigningRequest } from "../identity/descriptorProvider";
-import { HDCapableIdentity } from "../identity/hdCapableIdentity";
-import { WalletRepository } from "../repositories/walletRepository";
-import { Transaction } from "../utils/transaction";
+import { DescriptorProvider, DescriptorSigningRequest } from "../identity/descriptorProvider.js";
+import { HDCapableIdentity } from "../identity/hdCapableIdentity.js";
+import { WalletRepository } from "../repositories/walletRepository.js";
+import { Transaction } from "../utils/transaction.js";
 /**
  * HD-wallet {@link DescriptorProvider} that allocates a fresh signing
  * descriptor on every call. The provider holds no notion of "current" — it

package/dist/types/wallet/index.d.ts

@@ -1,20 +1,20 @@
 import { Bytes } from "@scure/btc-signer/utils.js";
-import { ArkProvider, Output, SettlementEvent } from "../providers/ark";
-import { Identity, ReadonlyIdentity } from "../identity";
-import { RelativeTimelock } from "../script/tapscript";
-import { EncodedVtxoScript, TapLeafScript } from "../script/base";
-import { RenewalConfig, SettlementConfig } from "./vtxo-manager";
-import { IndexerProvider } from "../providers/indexer";
-import { OnchainProvider } from "../providers/onchain";
-import { ContractWatcherConfig } from "../contracts/contractWatcher";
-import { ContractRepository, WalletRepository } from "../repositories";
-import { IContractManager } from "../contracts/contractManager";
-import { IDelegatorManager } from "./delegator";
-import { DelegatorProvider } from "../providers/delegator";
+import { ArkProvider, Output, SettlementEvent } from "../providers/ark.js";
+import { Identity, ReadonlyIdentity } from "../identity/index.js";
+import { RelativeTimelock } from "../script/tapscript.js";
+import { EncodedVtxoScript, TapLeafScript } from "../script/base.js";
+import { RenewalConfig, SettlementConfig } from "./vtxo-manager.js";
+import { IndexerProvider } from "../providers/indexer.js";
+import { OnchainProvider } from "../providers/onchain.js";
+import { ContractWatcherConfig } from "../contracts/contractWatcher.js";
+import { ContractRepository, WalletRepository } from "../repositories/index.js";
+import { IContractManager } from "../contracts/contractManager.js";
+import { IDelegatorManager } from "./delegator.js";
+import { DelegatorProvider } from "../providers/delegator.js";
 /** Defaults */
 export declare const DEFAULT_ARKADE_SERVER_URL: "https://arkade.computer";
-export declare const DEFAULT_ARKADE_HRP = "ark";
-export declare const DEFAULT_NETWORK_NAME = "bitcoin";
+export declare const DEFAULT_ARKADE_HRP: "ark";
+export declare const DEFAULT_NETWORK_NAME: "bitcoin";
 /**
  * Base configuration options shared by all wallet types.
  *
@@ -472,24 +472,27 @@ export interface Coin extends Outpoint {
  * @see VirtualStatus
  */
 export interface VirtualCoin extends Coin {
-    /** Virtual output status */
-    virtualStatus: VirtualStatus;
-    /** Transaction id that spent this virtual output, when known. */
-    spentBy?: string;
-    /** Settlement transaction associated with this virtual output, when known. */
-    settledBy?: string;
-    /** Arkade transaction id that created or spent this virtual output, when known. */
-    arkTxId?: string;
     /** Creation time of the virtual output. */
     createdAt: Date;
-    /** Whether this virtual output has been unrolled to onchain outputs. */
+    /** The scriptPubKey (hex) locking this virtual output, as returned by the indexer. */
+    script: string;
+    /** Whether this virtual output has been broadcasted onchain via an unroll (unilateral exit). */
     isUnrolled: boolean;
-    /** Whether this virtual output is already spent. */
+    /**
+     * Whether this virtual output is already spent (boolean helper for `spentBy`).
+     * This is not set to true if the virtual output is unrolled or swept, only when it's spent offchain.
+     */
     isSpent?: boolean;
+    /** ID of the onchain commitment transaction that settled this output, if applicable. */
+    settledBy?: string;
+    /** ID of the offchain checkpoint transaction that spent this output, if applicable. */
+    spentBy?: string;
+    /** ID of the offchain Arkade transaction that spent the above checkpoint output, if applicable. */
+    arkTxId?: string;
+    /** Virtual output status */
+    virtualStatus: VirtualStatus;
     /** Assets carried by this virtual output, if any. */
     assets?: Asset[];
-    /** The scriptPubKey (hex) locking this virtual output, as returned by the indexer. */
-    script: string;
 }
 /** Wallet transaction direction. */
 export declare enum TxType {

package/dist/types/wallet/onchain.d.ts

@@ -1,10 +1,10 @@
 import { P2TR } from "@scure/btc-signer/payment.js";
-import { Coin, SendBitcoinParams } from ".";
-import { Identity } from "../identity";
-import { Network, NetworkName } from "../networks";
-import { OnchainProvider } from "../providers/onchain";
-import { AnchorBumper } from "../utils/anchor";
-import { Transaction } from "../utils/transaction";
+import { Coin, SendBitcoinParams } from "./index.js";
+import { Identity } from "../identity/index.js";
+import { Network, NetworkName } from "../networks.js";
+import { OnchainProvider } from "../providers/onchain.js";
+import { AnchorBumper } from "../utils/anchor.js";
+import { Transaction } from "../utils/transaction.js";
 /**
  * Onchain Bitcoin wallet implementation for traditional Bitcoin transactions.
  *

package/dist/types/wallet/ramps.d.ts

@@ -1,5 +1,5 @@
-import { ExtendedCoin, IWallet } from ".";
-import { FeeInfo, SettlementEvent } from "../providers/ark";
+import { ExtendedCoin, IWallet } from "./index.js";
+import { FeeInfo, SettlementEvent } from "../providers/ark.js";
 /**
  * Ramps is a class wrapping `settle` method to provide a more convenient interface for onboarding and offboarding operations.
  *

package/dist/types/wallet/serviceWorker/wallet-message-handler.d.ts

@@ -1,10 +1,10 @@
-import { SettlementEvent } from "../../providers/ark";
-import type { Contract, ContractEvent, ContractWithVtxos, GetContractsFilter, PathSelection } from "../../contracts";
-import type { CreateContractParams, GetAllSpendingPathsOptions, GetSpendablePathsOptions } from "../../contracts/contractManager";
-import { ArkTransaction, AssetDetails, BurnParams, ExtendedCoin, ExtendedVirtualCoin, GetVtxosFilter, IssuanceParams, IssuanceResult, IWallet, Recipient, ReissuanceParams, SendBitcoinParams, SettleParams, VirtualCoin, WalletBalance } from "../index";
-import { DelegateInfo } from "../../providers/delegator";
-import { MessageHandler, RequestEnvelope, ResponseEnvelope } from "../../worker/messageBus";
-import { Transaction } from "../../utils/transaction";
+import { SettlementEvent } from "../../providers/ark.js";
+import type { Contract, ContractEvent, ContractWithVtxos, GetContractsFilter, PathSelection } from "../../contracts/index.js";
+import type { CreateContractParams, GetAllSpendingPathsOptions, GetSpendablePathsOptions } from "../../contracts/contractManager.js";
+import { ArkTransaction, AssetDetails, BurnParams, ExtendedCoin, ExtendedVirtualCoin, GetVtxosFilter, IssuanceParams, IssuanceResult, IWallet, Recipient, ReissuanceParams, SendBitcoinParams, SettleParams, VirtualCoin, WalletBalance } from "../index.js";
+import { DelegateInfo } from "../../providers/delegator.js";
+import { MessageHandler, RequestEnvelope, ResponseEnvelope } from "../../worker/messageBus.js";
+import { Transaction } from "../../utils/transaction.js";
 export declare class WalletNotInitializedError extends Error {
     constructor();
 }
@@ -259,6 +259,18 @@ export type RequestRefreshVtxos = RequestEnvelope & {
 export type ResponseRefreshVtxos = ResponseEnvelope & {
     type: "REFRESH_VTXOS_SUCCESS";
 };
+export type RequestRefreshOutpoints = RequestEnvelope & {
+    type: "REFRESH_OUTPOINTS";
+    payload: {
+        outpoints: {
+            txid: string;
+            vout: number;
+        }[];
+    };
+};
+export type ResponseRefreshOutpoints = ResponseEnvelope & {
+    type: "REFRESH_OUTPOINTS_SUCCESS";
+};
 export type RequestGetAllSpendingPaths = RequestEnvelope & {
     type: "GET_ALL_SPENDING_PATHS";
     payload: {
@@ -463,8 +475,8 @@ export type ResponseSweepExpiredBoardingUtxos = ResponseEnvelope & {
         txid: string;
     };
 };
-export type WalletUpdaterRequest = RequestInitWallet | RequestSettle | RequestSendBitcoin | RequestGetAddress | RequestGetBoardingAddress | RequestGetBalance | RequestGetVtxos | RequestGetBoardingUtxos | RequestGetTransactionHistory | RequestGetStatus | RequestClear | RequestReloadWallet | RequestSignTransaction | RequestCreateContract | RequestGetContracts | RequestGetContractsWithVtxos | RequestAnnotateVtxos | RequestUpdateContract | RequestDeleteContract | RequestGetSpendablePaths | RequestGetAllSpendingPaths | RequestIsContractManagerWatching | RequestRefreshVtxos | RequestSend | RequestGetAssetDetails | RequestIssue | RequestReissue | RequestBurn | RequestDelegate | RequestGetDelegateInfo | RequestRecoverVtxos | RequestGetRecoverableBalance | RequestGetExpiringVtxos | RequestRenewVtxos | RequestGetExpiredBoardingUtxos | RequestSweepExpiredBoardingUtxos;
-export type WalletUpdaterResponse = ResponseEnvelope & (ResponseInitWallet | ResponseSettle | ResponseSettleEvent | ResponseSendBitcoin | ResponseGetAddress | ResponseGetBoardingAddress | ResponseGetBalance | ResponseGetVtxos | ResponseGetBoardingUtxos | ResponseGetTransactionHistory | ResponseGetStatus | ResponseClear | ResponseReloadWallet | ResponseUtxoUpdate | ResponseVtxoUpdate | ResponseSignTransaction | ResponseCreateContract | ResponseGetContracts | ResponseGetContractsWithVtxos | ResponseAnnotateVtxos | ResponseUpdateContract | ResponseDeleteContract | ResponseGetSpendablePaths | ResponseGetAllSpendingPaths | ResponseIsContractManagerWatching | ResponseRefreshVtxos | ResponseContractEvent | ResponseSend | ResponseGetAssetDetails | ResponseIssue | ResponseReissue | ResponseBurn | ResponseDelegate | ResponseGetDelegateInfo | ResponseRecoverVtxos | ResponseRecoverVtxosEvent | ResponseGetRecoverableBalance | ResponseGetExpiringVtxos | ResponseRenewVtxos | ResponseRenewVtxosEvent | ResponseGetExpiredBoardingUtxos | ResponseSweepExpiredBoardingUtxos);
+export type WalletUpdaterRequest = RequestInitWallet | RequestSettle | RequestSendBitcoin | RequestGetAddress | RequestGetBoardingAddress | RequestGetBalance | RequestGetVtxos | RequestGetBoardingUtxos | RequestGetTransactionHistory | RequestGetStatus | RequestClear | RequestReloadWallet | RequestSignTransaction | RequestCreateContract | RequestGetContracts | RequestGetContractsWithVtxos | RequestAnnotateVtxos | RequestUpdateContract | RequestDeleteContract | RequestGetSpendablePaths | RequestGetAllSpendingPaths | RequestIsContractManagerWatching | RequestRefreshVtxos | RequestRefreshOutpoints | RequestSend | RequestGetAssetDetails | RequestIssue | RequestReissue | RequestBurn | RequestDelegate | RequestGetDelegateInfo | RequestRecoverVtxos | RequestGetRecoverableBalance | RequestGetExpiringVtxos | RequestRenewVtxos | RequestGetExpiredBoardingUtxos | RequestSweepExpiredBoardingUtxos;
+export type WalletUpdaterResponse = ResponseEnvelope & (ResponseInitWallet | ResponseSettle | ResponseSettleEvent | ResponseSendBitcoin | ResponseGetAddress | ResponseGetBoardingAddress | ResponseGetBalance | ResponseGetVtxos | ResponseGetBoardingUtxos | ResponseGetTransactionHistory | ResponseGetStatus | ResponseClear | ResponseReloadWallet | ResponseUtxoUpdate | ResponseVtxoUpdate | ResponseSignTransaction | ResponseCreateContract | ResponseGetContracts | ResponseGetContractsWithVtxos | ResponseAnnotateVtxos | ResponseUpdateContract | ResponseDeleteContract | ResponseGetSpendablePaths | ResponseGetAllSpendingPaths | ResponseIsContractManagerWatching | ResponseRefreshVtxos | ResponseRefreshOutpoints | ResponseContractEvent | ResponseSend | ResponseGetAssetDetails | ResponseIssue | ResponseReissue | ResponseBurn | ResponseDelegate | ResponseGetDelegateInfo | ResponseRecoverVtxos | ResponseRecoverVtxosEvent | ResponseGetRecoverableBalance | ResponseGetExpiringVtxos | ResponseRenewVtxos | ResponseRenewVtxosEvent | ResponseGetExpiredBoardingUtxos | ResponseSweepExpiredBoardingUtxos);
 export declare class WalletMessageHandler implements MessageHandler<WalletUpdaterRequest, WalletUpdaterResponse> {
     readonly messageTag: string;
     private wallet;

package/dist/types/wallet/serviceWorker/wallet.d.ts

@@ -1,13 +1,13 @@
-import { IWallet, WalletBalance, SendBitcoinParams, SettleParams, ArkTransaction, ExtendedCoin, ExtendedVirtualCoin, GetVtxosFilter, StorageConfig, IReadonlyWallet, IReadonlyAssetManager, IAssetManager, Recipient } from "..";
-import { SettlementEvent } from "../../providers/ark";
-import { Identity, ReadonlyIdentity, type SerializedIdentity, type LegacySerializedIdentity } from "../../identity";
-import { WalletRepository } from "../../repositories/walletRepository";
-import { ContractRepository } from "../../repositories/contractRepository";
-import { RequestInitWallet, ResponseGetStatus, WalletUpdaterRequest, WalletUpdaterResponse } from "./wallet-message-handler";
-import type { IContractManager } from "../../contracts/contractManager";
-import type { IDelegatorManager } from "../delegator";
-import type { IVtxoManager, SettlementConfig } from "../vtxo-manager";
-import type { ContractWatcherConfig } from "../../contracts/contractWatcher";
+import { IWallet, WalletBalance, SendBitcoinParams, SettleParams, ArkTransaction, ExtendedCoin, ExtendedVirtualCoin, GetVtxosFilter, StorageConfig, IReadonlyWallet, IReadonlyAssetManager, IAssetManager, Recipient } from "../index.js";
+import { SettlementEvent } from "../../providers/ark.js";
+import { Identity, ReadonlyIdentity, type SerializedIdentity, type LegacySerializedIdentity } from "../../identity/index.js";
+import { WalletRepository } from "../../repositories/walletRepository.js";
+import { ContractRepository } from "../../repositories/contractRepository.js";
+import { RequestInitWallet, ResponseGetStatus, WalletUpdaterRequest, WalletUpdaterResponse } from "./wallet-message-handler.js";
+import type { IContractManager } from "../../contracts/contractManager.js";
+import type { IDelegatorManager } from "../delegator.js";
+import type { IVtxoManager, SettlementConfig } from "../vtxo-manager.js";
+import type { ContractWatcherConfig } from "../../contracts/contractWatcher.js";
 type RequestType = WalletUpdaterRequest["type"];
 export type MessageTimeouts = Partial<Record<RequestType, number>>;
 export declare const DEFAULT_MESSAGE_TIMEOUTS: Readonly<Record<RequestType, number>>;

package/dist/types/wallet/unroll.d.ts

@@ -1,9 +1,9 @@
-import { ChainTx, IndexerProvider } from "../providers/indexer";
-import { AnchorBumper } from "../utils/anchor";
-import { OnchainProvider } from "../providers/onchain";
-import { Outpoint } from ".";
-import { Wallet } from "./wallet";
-import { Transaction } from "../utils/transaction";
+import { ChainTx, IndexerProvider } from "../providers/indexer.js";
+import { AnchorBumper } from "../utils/anchor.js";
+import { OnchainProvider } from "../providers/onchain.js";
+import { Outpoint } from "./index.js";
+import { Wallet } from "./wallet.js";
+import { Transaction } from "../utils/transaction.js";
 export declare namespace Unroll {
     enum StepType {
         UNROLL = 0,

package/dist/types/wallet/utils.d.ts

@@ -1,8 +1,8 @@
-import { Recipient } from ".";
-import { type Coin, type ExtendedCoin, type ExtendedVirtualCoin, type VirtualCoin } from "..";
-import type { Contract } from "../contracts/types";
-import { ReadonlyWallet } from "./wallet";
-import { Bytes } from "@scure/btc-signer/utils";
+import { Recipient } from "./index.js";
+import { type Coin, type ExtendedCoin, type ExtendedVirtualCoin, type VirtualCoin } from "../index.js";
+import type { Contract } from "../contracts/types.js";
+import { ReadonlyWallet } from "./wallet.js";
+import { Bytes } from "@scure/btc-signer/utils.js";
 export declare const DUST_AMOUNT = 546;
 export declare function extendCoin(wallet: {
     boardingTapscript: ReadonlyWallet["boardingTapscript"];

package/dist/types/wallet/validation.d.ts

@@ -1,6 +1,6 @@
-import { Recipient } from ".";
-import { Transaction } from "../utils/transaction";
-import type { Network } from "../networks";
+import { Recipient } from "./index.js";
+import { Transaction } from "../utils/transaction.js";
+import type { Network } from "../networks.js";
 export declare const ErrOffchainOutputNotFound: (address: string) => Error;
 export declare const ErrInvalidAssetOutputAmount: (got: bigint, want: bigint, assetId: string) => Error;
 export declare const ErrAssetGroupNotFound: (assetId: string) => Error;

package/dist/types/wallet/vtxo-manager.d.ts

@@ -1,5 +1,5 @@
-import { ExtendedCoin, ExtendedVirtualCoin, IWallet } from ".";
-import { SettlementEvent } from "../providers/ark";
+import { ExtendedCoin, ExtendedVirtualCoin, IWallet } from "./index.js";
+import { SettlementEvent } from "../providers/ark.js";
 /** Default renewal threshold in seconds (3 days). */
 export declare const DEFAULT_THRESHOLD_SECONDS: number;
 /**
@@ -410,13 +410,40 @@ export declare class VtxoManager implements AsyncDisposable, IVtxoManager {
     /**
      * VTXO_ALREADY_SPENT means the server's authoritative view of VTXO state
      * is ahead of ours — cross-instance race, pre-lock snapshot drift, or an
-     * SSE gap left stale data in the local cache. Silent-swallowing guarantees
-     * the same error on the next cycle because nothing reconciles the cache,
-     * so instead we trigger a full refreshVtxos() to advance the global sync
-     * cursor. Throttled to prevent a buggy indexer from causing a refresh
-     * storm.
+     * SSE gap left stale data in the local cache. Silent-swallowing
+     * guarantees the same error on the next cycle because nothing
+     * reconciles the cache.
+     *
+     * The cursor-derived delta sync filters by `created_at`, so a VTXO that
+     * was created before the cursor but spent recently can never be
+     * reconciled by `refreshVtxos()`. Use `refreshOutpoints` for surgical
+     * recovery: query the indexer for the specific stale outpoint and
+     * upsert its authoritative state into the wallet repository.
+     *
+     * Throttled because the same VTXO can fire repeatedly before the
+     * upsert observably propagates through the renewal selector.
      */
     private maybeRefreshAfterVtxoSpent;
+    /**
+     * Extract the offending VTXO outpoint from a `VTXO_ALREADY_SPENT` error,
+     * if the server attached one in `metadata.vtxo_outpoint`. Returns
+     * `undefined` when the error isn't a parsed ArkError, isn't this code,
+     * or doesn't carry the metadata.
+     */
+    private extractSpentOutpoint;
+    /**
+     * Reconcile the chosen VTXOs with the indexer's authoritative state
+     * before submitting a settle intent. Pulls the canonical record for
+     * each candidate outpoint via {@link IContractManager.refreshOutpoints}
+     * (which upserts the result into the wallet repository), then
+     * re-selects through the standard expiring-vtxo filter so anything
+     * the refresh flagged as spent is dropped.
+     *
+     * Best-effort: a failed refresh just falls back to the original
+     * candidates and lets the post-submit `VTXO_ALREADY_SPENT` recovery
+     * handle whatever slipped through.
+     */
+    private revalidateBeforeSettle;
     /** Computes the next poll delay, applying exponential backoff on failures. */
     private getNextPollDelay;
     /**

package/dist/types/wallet/wallet.d.ts

@@ -1,24 +1,24 @@
 import { TransactionOutput } from "@scure/btc-signer/psbt.js";
 import { Bytes } from "@scure/btc-signer/utils.js";
-import { ArkAddress } from "../script/address";
-import { DefaultVtxo } from "../script/default";
-import { Network, NetworkName } from "../networks";
-import { OnchainProvider } from "../providers/onchain";
-import { ArkProvider, SettlementEvent, SignedIntent } from "../providers/ark";
-import { SignerSession } from "../tree/signingSession";
-import { Identity, ReadonlyIdentity } from "../identity";
-import { ArkTransaction, Coin, ExtendedCoin, ExtendedVirtualCoin, GetVtxosFilter, IAssetManager, IReadonlyAssetManager, IReadonlyWallet, IWallet, ReadonlyWalletConfig, Recipient, SendBitcoinParams, SettleParams, WalletBalance, WalletConfig } from ".";
-import { CSVMultisigTapscript, RelativeTimelock } from "../script/tapscript";
-import { SettlementConfig, VtxoManager } from "./vtxo-manager";
-import { Intent } from "../intent";
-import { IndexerProvider } from "../providers/indexer";
-import { WalletRepository } from "../repositories/walletRepository";
-import { ContractRepository } from "../repositories/contractRepository";
-import { Batch } from "./batch";
-import { DelegatorProvider } from "../providers/delegator";
-import { DelegateVtxo } from "../script/delegate";
-import { IDelegatorManager } from "./delegator";
-import { ContractManager } from "../contracts/contractManager";
+import { ArkAddress } from "../script/address.js";
+import { DefaultVtxo } from "../script/default.js";
+import { Network, NetworkName } from "../networks.js";
+import { OnchainProvider } from "../providers/onchain.js";
+import { ArkProvider, SettlementEvent, SignedIntent } from "../providers/ark.js";
+import { SignerSession } from "../tree/signingSession.js";
+import { Identity, ReadonlyIdentity } from "../identity/index.js";
+import { ArkTransaction, Coin, ExtendedCoin, ExtendedVirtualCoin, GetVtxosFilter, IAssetManager, IReadonlyAssetManager, IReadonlyWallet, IWallet, ReadonlyWalletConfig, Recipient, SendBitcoinParams, SettleParams, WalletBalance, WalletConfig } from "./index.js";
+import { CSVMultisigTapscript, RelativeTimelock } from "../script/tapscript.js";
+import { SettlementConfig, VtxoManager } from "./vtxo-manager.js";
+import { Intent } from "../intent/index.js";
+import { IndexerProvider } from "../providers/indexer.js";
+import { WalletRepository } from "../repositories/walletRepository.js";
+import { ContractRepository } from "../repositories/contractRepository.js";
+import { Batch } from "./batch.js";
+import { DelegatorProvider } from "../providers/delegator.js";
+import { DelegateVtxo } from "../script/delegate.js";
+import { IDelegatorManager } from "./delegator.js";
+import { ContractManager } from "../contracts/contractManager.js";
 export declare const getArkadeServerUrl: ({ arkServerUrl, }: {
     arkServerUrl?: string;
 }) => string;
@@ -67,7 +67,7 @@ export declare class ReadonlyWallet implements IReadonlyWallet {
         dustAmount: bigint;
         walletRepository: WalletRepository;
         contractRepository: ContractRepository;
-        info: import("../providers/ark").ArkInfo;
+        info: import("../providers/ark.js").ArkInfo;
         delegatorProvider: DelegatorProvider | undefined;
         walletContractTimelocks: RelativeTimelock[];
     }>;

package/dist/types/worker/expo/asyncStorageTaskQueue.d.ts

@@ -1,4 +1,4 @@
-import type { TaskItem, TaskResult, TaskQueue } from "./taskQueue";
+import type { TaskItem, TaskResult, TaskQueue } from "./taskQueue.js";
 /**
  * Minimal async key-value storage interface.
  *

package/dist/types/worker/expo/index.d.ts

@@ -1,7 +1,7 @@
-export type { TaskItem, TaskResult, TaskQueue } from "./taskQueue";
-export { InMemoryTaskQueue } from "./taskQueue";
-export type { AsyncStorageLike } from "./asyncStorageTaskQueue";
-export { AsyncStorageTaskQueue } from "./asyncStorageTaskQueue";
-export type { TaskProcessor, TaskDependencies, CreateTaskDependenciesOptions, } from "./taskRunner";
-export { runTasks, createTaskDependencies } from "./taskRunner";
-export { contractPollProcessor, CONTRACT_POLL_TASK_TYPE } from "./processors";
+export type { TaskItem, TaskResult, TaskQueue } from "./taskQueue.js";
+export { InMemoryTaskQueue } from "./taskQueue.js";
+export type { AsyncStorageLike } from "./asyncStorageTaskQueue.js";
+export { AsyncStorageTaskQueue } from "./asyncStorageTaskQueue.js";
+export type { TaskProcessor, TaskDependencies, CreateTaskDependenciesOptions, } from "./taskRunner.js";
+export { runTasks, createTaskDependencies } from "./taskRunner.js";
+export { contractPollProcessor, CONTRACT_POLL_TASK_TYPE } from "./processors/index.js";