@arkade-os/sdk 0.4.7 → 0.4.9

package/dist/types/contracts/contractManager.d.ts

@@ -102,6 +102,11 @@ export interface IContractManager extends Disposable {
      * @returns Unsubscribe function
      */
     onContractEvent(callback: ContractEventCallback): () => void;
+    /**
+     * Force a full VTXO refresh from the indexer for all contracts.
+     * Populates the wallet repository with complete VTXO history.
+     */
+    refreshVtxos(): Promise<void>;
     /**
      * Whether the underlying watcher is currently active.
      */
@@ -292,6 +297,11 @@ export declare class ContractManager implements IContractManager {
      * ```
      */
     onContractEvent(callback: ContractEventCallback): () => void;
+    /**
+     * Force a full VTXO refresh from the indexer for all contracts.
+     * Populates the wallet repository with complete VTXO history.
+     */
+    refreshVtxos(): Promise<void>;
     /**
      * Check if currently watching.
      */

package/dist/types/identity/seedIdentity.d.ts

@@ -3,8 +3,11 @@ import { Transaction } from "../utils/transaction";
 import { SignerSession } from "../tree/signingSession";
 /** Use default BIP86 derivation with network selection. */
 export interface NetworkOptions {
-    /** Mainnet (coin type 0) or testnet (coin type 1). */
-    isMainnet: boolean;
+    /**
+     * Mainnet (coin type 0) or testnet (coin type 1).
+     * @default true
+     */
+    isMainnet?: boolean;
 }
 /** Use a custom output descriptor for derivation. */
 export interface DescriptorOptions {

package/dist/types/index.d.ts

@@ -16,7 +16,7 @@ import { TxTree, TxTreeNode } from "./tree/txTree";
 import { SignerSession, TreeNonces, TreePartialSigs } from "./tree/signingSession";
 import { Ramps } from "./wallet/ramps";
 import { isVtxoExpiringSoon, VtxoManager } from "./wallet/vtxo-manager";
-import type { SettlementConfig } from "./wallet/vtxo-manager";
+import type { IVtxoManager, SettlementConfig } from "./wallet/vtxo-manager";
 import { ServiceWorkerWallet, ServiceWorkerReadonlyWallet } from "./wallet/serviceWorker/wallet";
 import { OnchainWallet } from "./wallet/onchain";
 import { setupServiceWorker } from "./worker/browser/utils";
@@ -47,6 +47,7 @@ import { ContractManager, ContractWatcher, contractHandlers, DefaultContractHand
 import type { Contract, ContractVtxo, ContractState, ContractEvent, ContractEventCallback, ContractBalance, ContractWithVtxos, ContractHandler, PathSelection, PathContext, ContractManagerConfig, CreateContractParams, ContractWatcherConfig, ParsedArkContract, DefaultContractParams, DelegateContractParams, VHTLCContractParams } from "./contracts";
 import { IContractManager } from "./contracts/contractManager";
 import { closeDatabase, openDatabase } from "./repositories/indexedDB/manager";
-import { WalletMessageHandler } from "./wallet/serviceWorker/wallet-message-handler";
-export { Wallet, ReadonlyWallet, SingleKey, ReadonlySingleKey, SeedIdentity, MnemonicIdentity, ReadonlyDescriptorIdentity, OnchainWallet, Ramps, VtxoManager, DelegatorManagerImpl, RestDelegatorProvider, ESPLORA_URL, EsploraProvider, RestArkProvider, RestIndexerProvider, ArkAddress, DefaultVtxo, DelegateVtxo, VtxoScript, VHTLC, TxType, IndexerTxType, ChainTxType, SettlementEventType, setupServiceWorker, MessageBus, WalletMessageHandler, ServiceWorkerWallet, ServiceWorkerReadonlyWallet, decodeTapscript, MultisigTapscript, CSVMultisigTapscript, ConditionCSVMultisigTapscript, ConditionMultisigTapscript, CLTVMultisigTapscript, TapTreeCoder, ArkPsbtFieldKey, ArkPsbtFieldKeyType, setArkPsbtField, getArkPsbtFields, CosignerPublicKey, VtxoTreeExpiry, VtxoTaprootTree, ConditionWitness, buildOffchainTx, verifyTapscriptSignatures, waitForIncomingFunds, hasBoardingTxExpired, combineTapscriptSigs, isVtxoExpiringSoon, isValidArkAddress, ArkNote, networks, closeDatabase, openDatabase, IndexedDBWalletRepository, IndexedDBContractRepository, InMemoryWalletRepository, InMemoryContractRepository, MIGRATION_KEY, migrateWalletRepository, requiresMigration, getMigrationStatus, rollbackMigration, WalletRepositoryImpl, ContractRepositoryImpl, Intent, BIP322, TxTree, P2A, Unroll, Transaction, ArkError, maybeArkError, Batch, validateVtxoTxGraph, validateConnectorsTxGraph, buildForfeitTx, isRecoverable, isSpendable, isSubdust, isExpired, getSequence, ContractManager, ContractWatcher, contractHandlers, DefaultContractHandler, DelegateContractHandler, VHTLCContractHandler, encodeArkContract, decodeArkContract, contractFromArkContract, contractFromArkContractWithAddress, isArkContract, };
-export type { Identity, ReadonlyIdentity, IWallet, IReadonlyWallet, BaseWalletConfig, WalletConfig, ReadonlyWalletConfig, ProviderClass, ArkTransaction, Coin, ExtendedCoin, ExtendedVirtualCoin, WalletBalance, SendBitcoinParams, SettleParams, Status, VirtualStatus, Outpoint, VirtualCoin, TxKey, TapscriptType, ArkTxInput, OffchainTx, TapLeaves, IncomingFunds, SeedIdentityOptions, MnemonicOptions, NetworkOptions, DescriptorOptions, IndexerProvider, PageResponse, BatchInfo, ChainTx, CommitmentTx, TxHistoryRecord, Vtxo, VtxoChain, Tx, OnchainProvider, ArkProvider, SettlementEvent, FeeInfo, ArkInfo, SignedIntent, Output, TxNotification, ExplorerTransaction, BatchFinalizationEvent, BatchFinalizedEvent, BatchFailedEvent, TreeSigningStartedEvent, TreeNoncesEvent, BatchStartedEvent, TreeTxEvent, TreeSignatureEvent, ScheduledSession, PaginationOptions, SubscriptionResponse, SubscriptionHeartbeat, SubscriptionEvent, Network, NetworkName, ArkTapscript, RelativeTimelock, EncodedVtxoScript, TapLeafScript, SignerSession, TreeNonces, TreePartialSigs, GetVtxosFilter, SettlementConfig, Asset, Recipient, IssuanceParams, IssuanceResult, ReissuanceParams, BurnParams, AssetDetails, AssetMetadata, KnownMetadata, Nonces, PartialSig, ArkPsbtFieldCoder, TxTreeNode, AnchorBumper, StorageConfig, Contract, ContractVtxo, ContractState, ContractEvent, ContractEventCallback, ContractBalance, ContractWithVtxos, ContractHandler, IContractManager, PathSelection, PathContext, ContractManagerConfig, CreateContractParams, ContractWatcherConfig, ParsedArkContract, DefaultContractParams, DelegateContractParams, VHTLCContractParams, MessageHandler, RequestEnvelope, ResponseEnvelope, IDelegatorManager, DelegatorProvider, DelegateInfo, DelegateOptions, WalletRepository, ContractRepository, MigrationStatus, };
+import { WalletMessageHandler, WalletNotInitializedError, ReadonlyWalletError, DelegatorNotConfiguredError } from "./wallet/serviceWorker/wallet-message-handler";
+import { MessageBusNotInitializedError, ServiceWorkerTimeoutError } from "./worker/errors";
+export { Wallet, ReadonlyWallet, SingleKey, ReadonlySingleKey, SeedIdentity, MnemonicIdentity, ReadonlyDescriptorIdentity, OnchainWallet, Ramps, VtxoManager, DelegatorManagerImpl, RestDelegatorProvider, ESPLORA_URL, EsploraProvider, RestArkProvider, RestIndexerProvider, ArkAddress, DefaultVtxo, DelegateVtxo, VtxoScript, VHTLC, TxType, IndexerTxType, ChainTxType, SettlementEventType, setupServiceWorker, MessageBus, WalletMessageHandler, WalletNotInitializedError, ReadonlyWalletError, DelegatorNotConfiguredError, MessageBusNotInitializedError, ServiceWorkerTimeoutError, ServiceWorkerWallet, ServiceWorkerReadonlyWallet, decodeTapscript, MultisigTapscript, CSVMultisigTapscript, ConditionCSVMultisigTapscript, ConditionMultisigTapscript, CLTVMultisigTapscript, TapTreeCoder, ArkPsbtFieldKey, ArkPsbtFieldKeyType, setArkPsbtField, getArkPsbtFields, CosignerPublicKey, VtxoTreeExpiry, VtxoTaprootTree, ConditionWitness, buildOffchainTx, verifyTapscriptSignatures, waitForIncomingFunds, hasBoardingTxExpired, combineTapscriptSigs, isVtxoExpiringSoon, isValidArkAddress, ArkNote, networks, closeDatabase, openDatabase, IndexedDBWalletRepository, IndexedDBContractRepository, InMemoryWalletRepository, InMemoryContractRepository, MIGRATION_KEY, migrateWalletRepository, requiresMigration, getMigrationStatus, rollbackMigration, WalletRepositoryImpl, ContractRepositoryImpl, Intent, BIP322, TxTree, P2A, Unroll, Transaction, ArkError, maybeArkError, Batch, validateVtxoTxGraph, validateConnectorsTxGraph, buildForfeitTx, isRecoverable, isSpendable, isSubdust, isExpired, getSequence, ContractManager, ContractWatcher, contractHandlers, DefaultContractHandler, DelegateContractHandler, VHTLCContractHandler, encodeArkContract, decodeArkContract, contractFromArkContract, contractFromArkContractWithAddress, isArkContract, };
+export type { Identity, ReadonlyIdentity, IWallet, IReadonlyWallet, BaseWalletConfig, WalletConfig, ReadonlyWalletConfig, ProviderClass, ArkTransaction, Coin, ExtendedCoin, ExtendedVirtualCoin, WalletBalance, SendBitcoinParams, SettleParams, Status, VirtualStatus, Outpoint, VirtualCoin, TxKey, TapscriptType, ArkTxInput, OffchainTx, TapLeaves, IncomingFunds, SeedIdentityOptions, MnemonicOptions, NetworkOptions, DescriptorOptions, IndexerProvider, PageResponse, BatchInfo, ChainTx, CommitmentTx, TxHistoryRecord, Vtxo, VtxoChain, Tx, OnchainProvider, ArkProvider, SettlementEvent, FeeInfo, ArkInfo, SignedIntent, Output, TxNotification, ExplorerTransaction, BatchFinalizationEvent, BatchFinalizedEvent, BatchFailedEvent, TreeSigningStartedEvent, TreeNoncesEvent, BatchStartedEvent, TreeTxEvent, TreeSignatureEvent, ScheduledSession, PaginationOptions, SubscriptionResponse, SubscriptionHeartbeat, SubscriptionEvent, Network, NetworkName, ArkTapscript, RelativeTimelock, EncodedVtxoScript, TapLeafScript, SignerSession, TreeNonces, TreePartialSigs, GetVtxosFilter, SettlementConfig, IVtxoManager, Asset, Recipient, IssuanceParams, IssuanceResult, ReissuanceParams, BurnParams, AssetDetails, AssetMetadata, KnownMetadata, Nonces, PartialSig, ArkPsbtFieldCoder, TxTreeNode, AnchorBumper, StorageConfig, Contract, ContractVtxo, ContractState, ContractEvent, ContractEventCallback, ContractBalance, ContractWithVtxos, ContractHandler, IContractManager, PathSelection, PathContext, ContractManagerConfig, CreateContractParams, ContractWatcherConfig, ParsedArkContract, DefaultContractParams, DelegateContractParams, VHTLCContractParams, MessageHandler, RequestEnvelope, ResponseEnvelope, IDelegatorManager, DelegatorProvider, DelegateInfo, DelegateOptions, WalletRepository, ContractRepository, MigrationStatus, };

package/dist/types/repositories/serialization.d.ts

@@ -20,6 +20,7 @@ export declare const serializeVtxo: (v: ExtendedVirtualCoin) => {
     isUnrolled: boolean;
     isSpent?: boolean;
     assets?: import("../wallet").Asset[];
+    script?: string;
     value: number;
     status: import("../wallet").Status;
     txid: string;

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

@@ -11,5 +11,5 @@ type ExtendedArkTransaction = ArkTransaction & {
  * @param {Set<string>} commitmentsToIgnore - A set of commitment IDs that should be excluded from processing.
  * @return {ExtendedArkTransaction[]} A sorted array of extended Ark transactions, representing the transaction history.
  */
-export declare function buildTransactionHistory(vtxos: VirtualCoin[], allBoardingTxs: ArkTransaction[], commitmentsToIgnore: Set<string>, getTxCreatedAt?: (txid: string) => Promise<number>): Promise<ExtendedArkTransaction[]>;
+export declare function buildTransactionHistory(vtxos: VirtualCoin[], allBoardingTxs: ArkTransaction[], commitmentsToIgnore: Set<string>, getTxCreatedAt?: (txid: string) => Promise<number | undefined>): Promise<ExtendedArkTransaction[]>;
 export {};

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

@@ -220,6 +220,8 @@ export interface VirtualCoin extends Coin {
     isUnrolled: boolean;
     isSpent?: boolean;
     assets?: Asset[];
+    /** The scriptPubKey (hex) locking this VTXO, as returned by the indexer. */
+    script?: string;
 }
 export declare enum TxType {
     TxSent = "SENT",

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

@@ -1,10 +1,19 @@
 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, GetVtxosFilter, IssuanceParams, IssuanceResult, IWallet, Recipient, ReissuanceParams, SendBitcoinParams, SettleParams, WalletBalance } from "../index";
+import { ArkTransaction, AssetDetails, BurnParams, ExtendedCoin, ExtendedVirtualCoin, GetVtxosFilter, IssuanceParams, IssuanceResult, IWallet, Recipient, ReissuanceParams, SendBitcoinParams, SettleParams, WalletBalance } from "../index";
 import { DelegateInfo } from "../../providers/delegator";
 import { MessageHandler, RequestEnvelope, ResponseEnvelope } from "../../worker/messageBus";
 import { Transaction } from "../../utils/transaction";
+export declare class WalletNotInitializedError extends Error {
+    constructor();
+}
+export declare class ReadonlyWalletError extends Error {
+    constructor();
+}
+export declare class DelegatorNotConfiguredError extends Error {
+    constructor();
+}
 export declare const DEFAULT_MESSAGE_TAG = "WALLET_UPDATER";
 export type RequestInitWallet = RequestEnvelope & {
     type: "INIT_WALLET";
@@ -219,6 +228,12 @@ export type ResponseIsContractManagerWatching = ResponseEnvelope & {
         isWatching: boolean;
     };
 };
+export type RequestRefreshVtxos = RequestEnvelope & {
+    type: "REFRESH_VTXOS";
+};
+export type ResponseRefreshVtxos = ResponseEnvelope & {
+    type: "REFRESH_VTXOS_SUCCESS";
+};
 export type RequestGetAllSpendingPaths = RequestEnvelope & {
     type: "GET_ALL_SPENDING_PATHS";
     payload: {
@@ -236,6 +251,14 @@ export type ResponseSettleEvent = ResponseEnvelope & {
     type: "SETTLE_EVENT";
     payload: SettlementEvent;
 };
+export type ResponseRecoverVtxosEvent = ResponseEnvelope & {
+    type: "RECOVER_VTXOS_EVENT";
+    payload: SettlementEvent;
+};
+export type ResponseRenewVtxosEvent = ResponseEnvelope & {
+    type: "RENEW_VTXOS_EVENT";
+    payload: SettlementEvent;
+};
 export type ResponseUtxoUpdate = ResponseEnvelope & {
     broadcast: true;
     type: "UTXO_UPDATE";
@@ -355,8 +378,68 @@ export type ResponseGetDelegateInfo = ResponseEnvelope & {
         info: DelegateInfo;
     };
 };
-export type WalletUpdaterRequest = RequestInitWallet | RequestSettle | RequestSendBitcoin | RequestGetAddress | RequestGetBoardingAddress | RequestGetBalance | RequestGetVtxos | RequestGetBoardingUtxos | RequestGetTransactionHistory | RequestGetStatus | RequestClear | RequestReloadWallet | RequestSignTransaction | RequestCreateContract | RequestGetContracts | RequestGetContractsWithVtxos | RequestUpdateContract | RequestDeleteContract | RequestGetSpendablePaths | RequestGetAllSpendingPaths | RequestIsContractManagerWatching | RequestSend | RequestGetAssetDetails | RequestIssue | RequestReissue | RequestBurn | RequestDelegate | RequestGetDelegateInfo;
-export type WalletUpdaterResponse = ResponseEnvelope & (ResponseInitWallet | ResponseSettle | ResponseSettleEvent | ResponseSendBitcoin | ResponseGetAddress | ResponseGetBoardingAddress | ResponseGetBalance | ResponseGetVtxos | ResponseGetBoardingUtxos | ResponseGetTransactionHistory | ResponseGetStatus | ResponseClear | ResponseReloadWallet | ResponseUtxoUpdate | ResponseVtxoUpdate | ResponseSignTransaction | ResponseCreateContract | ResponseGetContracts | ResponseGetContractsWithVtxos | ResponseUpdateContract | ResponseDeleteContract | ResponseGetSpendablePaths | ResponseGetAllSpendingPaths | ResponseIsContractManagerWatching | ResponseContractEvent | ResponseSend | ResponseGetAssetDetails | ResponseIssue | ResponseReissue | ResponseBurn | ResponseDelegate | ResponseGetDelegateInfo);
+export type RequestRecoverVtxos = RequestEnvelope & {
+    type: "RECOVER_VTXOS";
+};
+export type ResponseRecoverVtxos = ResponseEnvelope & {
+    type: "RECOVER_VTXOS_SUCCESS";
+    payload: {
+        txid: string;
+    };
+};
+export type RequestGetRecoverableBalance = RequestEnvelope & {
+    type: "GET_RECOVERABLE_BALANCE";
+};
+export type ResponseGetRecoverableBalance = ResponseEnvelope & {
+    type: "RECOVERABLE_BALANCE";
+    payload: {
+        recoverable: string;
+        subdust: string;
+        includesSubdust: boolean;
+        vtxoCount: number;
+    };
+};
+export type RequestGetExpiringVtxos = RequestEnvelope & {
+    type: "GET_EXPIRING_VTXOS";
+    payload: {
+        thresholdMs?: number;
+    };
+};
+export type ResponseGetExpiringVtxos = ResponseEnvelope & {
+    type: "EXPIRING_VTXOS";
+    payload: {
+        vtxos: ExtendedVirtualCoin[];
+    };
+};
+export type RequestRenewVtxos = RequestEnvelope & {
+    type: "RENEW_VTXOS";
+};
+export type ResponseRenewVtxos = ResponseEnvelope & {
+    type: "RENEW_VTXOS_SUCCESS";
+    payload: {
+        txid: string;
+    };
+};
+export type RequestGetExpiredBoardingUtxos = RequestEnvelope & {
+    type: "GET_EXPIRED_BOARDING_UTXOS";
+};
+export type ResponseGetExpiredBoardingUtxos = ResponseEnvelope & {
+    type: "EXPIRED_BOARDING_UTXOS";
+    payload: {
+        utxos: ExtendedCoin[];
+    };
+};
+export type RequestSweepExpiredBoardingUtxos = RequestEnvelope & {
+    type: "SWEEP_EXPIRED_BOARDING_UTXOS";
+};
+export type ResponseSweepExpiredBoardingUtxos = ResponseEnvelope & {
+    type: "SWEEP_EXPIRED_BOARDING_UTXOS_SUCCESS";
+    payload: {
+        txid: string;
+    };
+};
+export type WalletUpdaterRequest = RequestInitWallet | RequestSettle | RequestSendBitcoin | RequestGetAddress | RequestGetBoardingAddress | RequestGetBalance | RequestGetVtxos | RequestGetBoardingUtxos | RequestGetTransactionHistory | RequestGetStatus | RequestClear | RequestReloadWallet | RequestSignTransaction | RequestCreateContract | RequestGetContracts | RequestGetContractsWithVtxos | 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 | ResponseUpdateContract | ResponseDeleteContract | ResponseGetSpendablePaths | ResponseGetAllSpendingPaths | ResponseIsContractManagerWatching | ResponseRefreshVtxos | 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;
@@ -386,19 +469,30 @@ export declare class WalletMessageHandler implements MessageHandler<WalletUpdate
     private handleGetBalance;
     private getAllBoardingUtxos;
     /**
-     * Get spendable vtxos for the current wallet address
+     * Get spendable vtxos from the repository
      */
     private getSpendableVtxos;
+    private onWalletInitialized;
     /**
-     * Get swept vtxos for the current wallet address
+     * Force a full VTXO refresh from the indexer, then re-run bootstrap.
+     * Used by RELOAD_WALLET to ensure fresh data.
      */
-    private getSweptVtxos;
-    private onWalletInitialized;
+    private reloadWallet;
     private handleSettle;
     private handleSendBitcoin;
     private handleSignTransaction;
     private handleDelegate;
     private handleGetVtxos;
     private clear;
+    /**
+     * Read all VTXOs from the repository, aggregated across all contract
+     * addresses and the wallet's primary address, with deduplication.
+     */
+    private getVtxosFromRepo;
+    /**
+     * Build transaction history from cached VTXOs without hitting the indexer.
+     * Falls back to indexer only for uncached transaction timestamps.
+     */
+    private buildTransactionHistoryFromCache;
     private ensureContractEventBroadcasting;
 }

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

@@ -6,6 +6,8 @@ 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";
 type PrivateKeyIdentity = Identity & {
     toHex(): string;
 };
@@ -44,12 +46,15 @@ type PrivateKeyIdentity = Identity & {
 interface ServiceWorkerWalletOptions {
     arkServerPublicKey?: string;
     arkServerUrl: string;
+    indexerUrl?: string;
     esploraUrl?: string;
     storage?: StorageConfig;
     identity: ReadonlyIdentity | Identity;
     delegatorUrl?: string;
     walletUpdaterTag?: string;
     messageBusTimeoutMs?: number;
+    settlementConfig?: SettlementConfig | false;
+    watcherConfig?: Partial<Omit<ContractWatcherConfig, "indexerProvider">>;
 }
 export type ServiceWorkerWalletCreateOptions = ServiceWorkerWalletOptions & {
     serviceWorker: ServiceWorker;
@@ -69,7 +74,11 @@ type MessageBusInitConfig = {
         publicKey?: string;
     };
     delegatorUrl?: string;
+    indexerUrl?: string;
+    esploraUrl?: string;
     timeoutMs?: number;
+    settlementConfig?: SettlementConfig | false;
+    watcherConfig?: Partial<Omit<ContractWatcherConfig, "indexerProvider">>;
 };
 export declare class ServiceWorkerReadonlyWallet implements IReadonlyWallet {
     readonly serviceWorker: ServiceWorker;
@@ -82,6 +91,8 @@ export declare class ServiceWorkerReadonlyWallet implements IReadonlyWallet {
     protected initWalletPayload: RequestInitWallet["payload"] | null;
     protected messageBusTimeoutMs?: number;
     private reinitPromise;
+    private pingPromise;
+    private inflightRequests;
     get assetManager(): IReadonlyAssetManager;
     protected constructor(serviceWorker: ServiceWorker, identity: ReadonlyIdentity, walletRepository: WalletRepository, contractRepository: ContractRepository, messageTag: string);
     static create(options: ServiceWorkerWalletCreateOptions): Promise<ServiceWorkerReadonlyWallet>;
@@ -108,7 +119,11 @@ export declare class ServiceWorkerReadonlyWallet implements IReadonlyWallet {
      */
     static setup(options: ServiceWorkerWalletSetupOptions): Promise<ServiceWorkerReadonlyWallet>;
     private sendMessageDirect;
+    private sendMessageStreaming;
     protected sendMessage(request: WalletUpdaterRequest): Promise<WalletUpdaterResponse>;
+    private pingServiceWorker;
+    private sendMessageWithRetry;
+    protected sendMessageWithEvents(request: WalletUpdaterRequest, onEvent: (response: WalletUpdaterResponse) => void, isComplete: (response: WalletUpdaterResponse) => boolean): Promise<WalletUpdaterResponse>;
     private reinitialize;
     clear(): Promise<void>;
     getAddress(): Promise<string>;
@@ -157,5 +172,6 @@ export declare class ServiceWorkerWallet extends ServiceWorkerReadonlyWallet imp
     settle(params?: SettleParams, callback?: (event: SettlementEvent) => void): Promise<string>;
     send(...recipients: Recipient[]): Promise<string>;
     getDelegatorManager(): Promise<IDelegatorManager | undefined>;
+    getVtxoManager(): Promise<IVtxoManager>;
 }
 export {};

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

@@ -145,7 +145,21 @@ export declare function getExpiringAndRecoverableVtxos(vtxos: ExtendedVirtualCoi
  * }
  * ```
  */
-export declare class VtxoManager implements AsyncDisposable {
+export interface IVtxoManager {
+    recoverVtxos(eventCallback?: (event: SettlementEvent) => void): Promise<string>;
+    getRecoverableBalance(): Promise<{
+        recoverable: bigint;
+        subdust: bigint;
+        includesSubdust: boolean;
+        vtxoCount: number;
+    }>;
+    getExpiringVtxos(thresholdMs?: number): Promise<ExtendedVirtualCoin[]>;
+    renewVtxos(eventCallback?: (event: SettlementEvent) => void): Promise<string>;
+    getExpiredBoardingUtxos(): Promise<ExtendedCoin[]>;
+    sweepExpiredBoardingUtxos(): Promise<string>;
+    dispose(): Promise<void>;
+}
+export declare class VtxoManager implements AsyncDisposable, IVtxoManager {
     readonly wallet: IWallet;
     /** @deprecated Use settlementConfig instead */
     readonly renewalConfig?: RenewalConfig | undefined;
@@ -153,10 +167,17 @@ export declare class VtxoManager implements AsyncDisposable {
     private contractEventsSubscription?;
     private readonly contractEventsSubscriptionReady;
     private disposePromise?;
-    private pollIntervalId?;
+    private pollTimeoutId?;
     private knownBoardingUtxos;
     private sweptBoardingUtxos;
     private pollInProgress;
+    private disposed;
+    private consecutivePollFailures;
+    private startupPollTimeoutId?;
+    private static readonly MAX_BACKOFF_MS;
+    private renewalInProgress;
+    private lastRenewalTimestamp;
+    private static readonly RENEWAL_COOLDOWN_MS;
     constructor(wallet: IWallet, 
     /** @deprecated Use settlementConfig instead */
     renewalConfig?: RenewalConfig | undefined, settlementConfig?: SettlementConfig | false);
@@ -323,12 +344,18 @@ export declare class VtxoManager implements AsyncDisposable {
     /** Returns the wallet's identity for transaction signing. */
     private getIdentity;
     private initializeSubscription;
+    /** Computes the next poll delay, applying exponential backoff on failures. */
+    private getNextPollDelay;
     /**
      * Starts a polling loop that:
      * 1. Auto-settles new boarding UTXOs into Ark
      * 2. Sweeps expired boarding UTXOs (when boardingUtxoSweep is enabled)
+     *
+     * Uses setTimeout chaining (not setInterval) so a slow/blocked poll
+     * cannot stack up and the next delay can incorporate backoff.
      */
     private startBoardingUtxoPoll;
+    private schedulePoll;
     private pollBoardingUtxos;
     /**
      * Auto-settle new (unexpired) boarding UTXOs into the Ark.

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

@@ -171,6 +171,14 @@ export declare class Wallet extends ReadonlyWallet implements IWallet {
     private _vtxoManager?;
     private _vtxoManagerInitializing?;
     private _walletAssetManager?;
+    /**
+     * Async mutex that serializes all operations submitting VTXOs to the Ark
+     * server (`settle`, `send`, `sendBitcoin`). This prevents VtxoManager's
+     * background renewal from racing with user-initiated transactions for the
+     * same VTXO inputs.
+     */
+    private _txLock;
+    private _withTxLock;
     /** @deprecated Use settlementConfig instead */
     readonly renewalConfig: Required<Omit<WalletConfig["renewalConfig"], "enabled">> & {
         enabled: boolean;
@@ -209,6 +217,7 @@ export declare class Wallet extends ReadonlyWallet implements IWallet {
      */
     sendBitcoin(params: SendBitcoinParams): Promise<string>;
     settle(params?: SettleParams, eventCallback?: (event: SettlementEvent) => void): Promise<string>;
+    private _settleImpl;
     private handleSettlementFinalizationEvent;
     /**
      * @implements Batch.Handler interface.
@@ -247,6 +256,7 @@ export declare class Wallet extends ReadonlyWallet implements IWallet {
      * ```
      */
     send(...args: Recipient[]): Promise<string>;
+    private _sendImpl;
     /**
      * Build an offchain transaction from the given inputs and outputs,
      * sign it, submit to the ark provider, and finalize.

package/dist/types/worker/errors.d.ts

@@ -0,0 +1,6 @@
+export declare class MessageBusNotInitializedError extends Error {
+    constructor();
+}
+export declare class ServiceWorkerTimeoutError extends Error {
+    constructor(detail: string);
+}

package/dist/types/worker/messageBus.d.ts

@@ -1,5 +1,7 @@
 import { ArkProvider } from "../providers/ark";
 import { ReadonlyWallet, Wallet } from "../wallet/wallet";
+import type { SettlementConfig } from "../wallet/vtxo-manager";
+import type { ContractWatcherConfig } from "../contracts/contractWatcher";
 import { ContractRepository, WalletRepository } from "../repositories";
 export type RequestEnvelope = {
     tag: string;
@@ -70,6 +72,10 @@ type Initialize = {
             publicKey?: string;
         };
         delegatorUrl?: string;
+        indexerUrl?: string;
+        esploraUrl?: string;
+        settlementConfig?: SettlementConfig | false;
+        watcherConfig?: Partial<Omit<ContractWatcherConfig, "indexerProvider">>;
     };
 };
 export declare class MessageBus {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arkade-os/sdk",
-  "version": "0.4.7",
+  "version": "0.4.9",
   "description": "Bitcoin wallet SDK with Taproot and Ark integration",
   "type": "module",
   "main": "./dist/cjs/index.js",