@arkade-os/sdk 0.4.6 → 0.4.8

package/dist/cjs/identity/seedIdentity.js

@@ -105,7 +105,7 @@ class SeedIdentity {
     static fromSeed(seed, opts) {
         const descriptor = hasDescriptor(opts)
             ? opts.descriptor
-            : buildDescriptor(seed, opts.isMainnet);
+            : buildDescriptor(seed, opts.isMainnet ?? true);
         return new SeedIdentity(seed, descriptor);
     }
     async xOnlyPublicKey() {
@@ -194,7 +194,7 @@ class MnemonicIdentity extends SeedIdentity {
         const seed = (0, bip39_1.mnemonicToSeedSync)(phrase, passphrase);
         const descriptor = hasDescriptor(opts)
             ? opts.descriptor
-            : buildDescriptor(seed, opts.isMainnet);
+            : buildDescriptor(seed, opts.isMainnet ?? true);
         return new MnemonicIdentity(seed, descriptor);
     }
 }

package/dist/cjs/index.js

@@ -36,8 +36,9 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.hasBoardingTxExpired = exports.waitForIncomingFunds = exports.verifyTapscriptSignatures = exports.buildOffchainTx = exports.ConditionWitness = exports.VtxoTaprootTree = exports.VtxoTreeExpiry = exports.CosignerPublicKey = exports.getArkPsbtFields = exports.setArkPsbtField = exports.ArkPsbtFieldKeyType = exports.ArkPsbtFieldKey = exports.TapTreeCoder = exports.CLTVMultisigTapscript = exports.ConditionMultisigTapscript = exports.ConditionCSVMultisigTapscript = exports.CSVMultisigTapscript = exports.MultisigTapscript = exports.decodeTapscript = exports.ServiceWorkerReadonlyWallet = exports.ServiceWorkerWallet = exports.WalletMessageHandler = exports.MessageBus = exports.setupServiceWorker = exports.SettlementEventType = exports.ChainTxType = exports.IndexerTxType = exports.TxType = exports.VHTLC = exports.VtxoScript = exports.DelegateVtxo = exports.DefaultVtxo = exports.ArkAddress = exports.RestIndexerProvider = exports.RestArkProvider = exports.EsploraProvider = exports.ESPLORA_URL = exports.RestDelegatorProvider = exports.DelegatorManagerImpl = exports.VtxoManager = exports.Ramps = exports.OnchainWallet = exports.ReadonlyDescriptorIdentity = exports.MnemonicIdentity = exports.SeedIdentity = exports.ReadonlySingleKey = exports.SingleKey = exports.ReadonlyWallet = exports.Wallet = exports.asset = void 0;
-exports.isArkContract = exports.contractFromArkContractWithAddress = exports.contractFromArkContract = exports.decodeArkContract = exports.encodeArkContract = exports.VHTLCContractHandler = exports.DelegateContractHandler = exports.DefaultContractHandler = exports.contractHandlers = exports.ContractWatcher = exports.ContractManager = exports.getSequence = exports.isExpired = exports.isSubdust = exports.isSpendable = exports.isRecoverable = exports.buildForfeitTx = exports.validateConnectorsTxGraph = exports.validateVtxoTxGraph = exports.Batch = exports.maybeArkError = exports.ArkError = exports.Transaction = exports.Unroll = exports.P2A = exports.TxTree = exports.BIP322 = exports.Intent = exports.ContractRepositoryImpl = exports.WalletRepositoryImpl = exports.rollbackMigration = exports.getMigrationStatus = exports.requiresMigration = exports.migrateWalletRepository = exports.MIGRATION_KEY = exports.InMemoryContractRepository = exports.InMemoryWalletRepository = exports.IndexedDBContractRepository = exports.IndexedDBWalletRepository = exports.openDatabase = exports.closeDatabase = exports.networks = exports.ArkNote = exports.isValidArkAddress = exports.isVtxoExpiringSoon = exports.combineTapscriptSigs = void 0;
+exports.VtxoTaprootTree = exports.VtxoTreeExpiry = exports.CosignerPublicKey = exports.getArkPsbtFields = exports.setArkPsbtField = exports.ArkPsbtFieldKeyType = exports.ArkPsbtFieldKey = exports.TapTreeCoder = exports.CLTVMultisigTapscript = exports.ConditionMultisigTapscript = exports.ConditionCSVMultisigTapscript = exports.CSVMultisigTapscript = exports.MultisigTapscript = exports.decodeTapscript = exports.ServiceWorkerReadonlyWallet = exports.ServiceWorkerWallet = exports.ServiceWorkerTimeoutError = exports.MessageBusNotInitializedError = exports.DelegatorNotConfiguredError = exports.ReadonlyWalletError = exports.WalletNotInitializedError = exports.WalletMessageHandler = exports.MessageBus = exports.setupServiceWorker = exports.SettlementEventType = exports.ChainTxType = exports.IndexerTxType = exports.TxType = exports.VHTLC = exports.VtxoScript = exports.DelegateVtxo = exports.DefaultVtxo = exports.ArkAddress = exports.RestIndexerProvider = exports.RestArkProvider = exports.EsploraProvider = exports.ESPLORA_URL = exports.RestDelegatorProvider = exports.DelegatorManagerImpl = exports.VtxoManager = exports.Ramps = exports.OnchainWallet = exports.ReadonlyDescriptorIdentity = exports.MnemonicIdentity = exports.SeedIdentity = exports.ReadonlySingleKey = exports.SingleKey = exports.ReadonlyWallet = exports.Wallet = exports.asset = void 0;
+exports.contractFromArkContractWithAddress = exports.contractFromArkContract = exports.decodeArkContract = exports.encodeArkContract = exports.VHTLCContractHandler = exports.DelegateContractHandler = exports.DefaultContractHandler = exports.contractHandlers = exports.ContractWatcher = exports.ContractManager = exports.getSequence = exports.isExpired = exports.isSubdust = exports.isSpendable = exports.isRecoverable = exports.buildForfeitTx = exports.validateConnectorsTxGraph = exports.validateVtxoTxGraph = exports.Batch = exports.maybeArkError = exports.ArkError = exports.Transaction = exports.Unroll = exports.P2A = exports.TxTree = exports.BIP322 = exports.Intent = exports.ContractRepositoryImpl = exports.WalletRepositoryImpl = exports.rollbackMigration = exports.getMigrationStatus = exports.requiresMigration = exports.migrateWalletRepository = exports.MIGRATION_KEY = exports.InMemoryContractRepository = exports.InMemoryWalletRepository = exports.IndexedDBContractRepository = exports.IndexedDBWalletRepository = exports.openDatabase = exports.closeDatabase = exports.networks = exports.ArkNote = exports.isValidArkAddress = exports.isVtxoExpiringSoon = exports.combineTapscriptSigs = exports.hasBoardingTxExpired = exports.waitForIncomingFunds = exports.verifyTapscriptSignatures = exports.buildOffchainTx = exports.ConditionWitness = void 0;
+exports.isArkContract = void 0;
 const transaction_1 = require("./utils/transaction");
 Object.defineProperty(exports, "Transaction", { enumerable: true, get: function () { return transaction_1.Transaction; } });
 const singleKey_1 = require("./identity/singleKey");
@@ -175,3 +176,9 @@ Object.defineProperty(exports, "closeDatabase", { enumerable: true, get: functio
 Object.defineProperty(exports, "openDatabase", { enumerable: true, get: function () { return manager_1.openDatabase; } });
 const wallet_message_handler_1 = require("./wallet/serviceWorker/wallet-message-handler");
 Object.defineProperty(exports, "WalletMessageHandler", { enumerable: true, get: function () { return wallet_message_handler_1.WalletMessageHandler; } });
+Object.defineProperty(exports, "WalletNotInitializedError", { enumerable: true, get: function () { return wallet_message_handler_1.WalletNotInitializedError; } });
+Object.defineProperty(exports, "ReadonlyWalletError", { enumerable: true, get: function () { return wallet_message_handler_1.ReadonlyWalletError; } });
+Object.defineProperty(exports, "DelegatorNotConfiguredError", { enumerable: true, get: function () { return wallet_message_handler_1.DelegatorNotConfiguredError; } });
+const errors_2 = require("./worker/errors");
+Object.defineProperty(exports, "MessageBusNotInitializedError", { enumerable: true, get: function () { return errors_2.MessageBusNotInitializedError; } });
+Object.defineProperty(exports, "ServiceWorkerTimeoutError", { enumerable: true, get: function () { return errors_2.ServiceWorkerTimeoutError; } });

package/dist/cjs/wallet/serviceWorker/wallet-message-handler.js

@@ -1,9 +1,30 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.WalletMessageHandler = exports.DEFAULT_MESSAGE_TAG = void 0;
+exports.WalletMessageHandler = exports.DEFAULT_MESSAGE_TAG = exports.DelegatorNotConfiguredError = exports.ReadonlyWalletError = exports.WalletNotInitializedError = void 0;
 const indexer_1 = require("../../providers/indexer");
 const index_1 = require("../index");
 const utils_1 = require("../utils");
+class WalletNotInitializedError extends Error {
+    constructor() {
+        super("Wallet handler not initialized");
+        this.name = "WalletNotInitializedError";
+    }
+}
+exports.WalletNotInitializedError = WalletNotInitializedError;
+class ReadonlyWalletError extends Error {
+    constructor() {
+        super("Read-only wallet: operation requires signing");
+        this.name = "ReadonlyWalletError";
+    }
+}
+exports.ReadonlyWalletError = ReadonlyWalletError;
+class DelegatorNotConfiguredError extends Error {
+    constructor() {
+        super("Delegator not configured");
+        this.name = "DelegatorNotConfiguredError";
+    }
+}
+exports.DelegatorNotConfiguredError = DelegatorNotConfiguredError;
 exports.DEFAULT_MESSAGE_TAG = "WALLET_UPDATER";
 class WalletMessageHandler {
     /**
@@ -24,7 +45,31 @@ class WalletMessageHandler {
         this.walletRepository = repositories.walletRepository;
     }
     async stop() {
-        // optional cleanup and persistence
+        if (this.incomingFundsSubscription) {
+            this.incomingFundsSubscription();
+            this.incomingFundsSubscription = undefined;
+        }
+        if (this.contractEventsSubscription) {
+            this.contractEventsSubscription();
+            this.contractEventsSubscription = undefined;
+        }
+        // Dispose the wallet to stop VtxoManager background tasks
+        // (auto-renewal, boarding UTXO polling) and ContractWatcher.
+        try {
+            if (this.wallet) {
+                await this.wallet.dispose();
+            }
+            else if (this.readonlyWallet) {
+                await this.readonlyWallet.dispose();
+            }
+        }
+        catch (_) {
+            // best-effort teardown
+        }
+        this.wallet = undefined;
+        this.readonlyWallet = undefined;
+        this.arkProvider = undefined;
+        this.indexerProvider = undefined;
     }
     async tick(_now) {
         const results = await Promise.allSettled(this.onNextTick.map((fn) => fn()));
@@ -47,7 +92,7 @@ class WalletMessageHandler {
     }
     requireWallet() {
         if (!this.wallet) {
-            throw new Error("Read-only wallet: operation requires signing");
+            throw new ReadonlyWalletError();
         }
         return this.wallet;
     }
@@ -69,7 +114,7 @@ class WalletMessageHandler {
         if (!this.readonlyWallet) {
             return this.tagged({
                 id,
-                error: new Error("Wallet handler not initialized"),
+                error: new WalletNotInitializedError(),
             });
         }
         try {
@@ -297,7 +342,7 @@ class WalletMessageHandler {
                     const wallet = this.requireWallet();
                     const delegatorManager = await wallet.getDelegatorManager();
                     if (!delegatorManager) {
-                        throw new Error("Delegator not configured");
+                        throw new DelegatorNotConfiguredError();
                     }
                     const info = await delegatorManager.getDelegateInfo();
                     return this.tagged({
@@ -306,6 +351,83 @@ class WalletMessageHandler {
                         payload: { info },
                     });
                 }
+                case "RECOVER_VTXOS": {
+                    const wallet = this.requireWallet();
+                    const vtxoManager = await wallet.getVtxoManager();
+                    const txid = await vtxoManager.recoverVtxos((e) => {
+                        this.scheduleForNextTick(() => this.tagged({
+                            id,
+                            type: "RECOVER_VTXOS_EVENT",
+                            payload: e,
+                        }));
+                    });
+                    return this.tagged({
+                        id,
+                        type: "RECOVER_VTXOS_SUCCESS",
+                        payload: { txid },
+                    });
+                }
+                case "GET_RECOVERABLE_BALANCE": {
+                    const wallet = this.requireWallet();
+                    const vtxoManager = await wallet.getVtxoManager();
+                    const balance = await vtxoManager.getRecoverableBalance();
+                    return this.tagged({
+                        id,
+                        type: "RECOVERABLE_BALANCE",
+                        payload: {
+                            recoverable: balance.recoverable.toString(),
+                            subdust: balance.subdust.toString(),
+                            includesSubdust: balance.includesSubdust,
+                            vtxoCount: balance.vtxoCount,
+                        },
+                    });
+                }
+                case "GET_EXPIRING_VTXOS": {
+                    const wallet = this.requireWallet();
+                    const vtxoManager = await wallet.getVtxoManager();
+                    const vtxos = await vtxoManager.getExpiringVtxos(message.payload.thresholdMs);
+                    return this.tagged({
+                        id,
+                        type: "EXPIRING_VTXOS",
+                        payload: { vtxos },
+                    });
+                }
+                case "RENEW_VTXOS": {
+                    const wallet = this.requireWallet();
+                    const vtxoManager = await wallet.getVtxoManager();
+                    const txid = await vtxoManager.renewVtxos((e) => {
+                        this.scheduleForNextTick(() => this.tagged({
+                            id,
+                            type: "RENEW_VTXOS_EVENT",
+                            payload: e,
+                        }));
+                    });
+                    return this.tagged({
+                        id,
+                        type: "RENEW_VTXOS_SUCCESS",
+                        payload: { txid },
+                    });
+                }
+                case "GET_EXPIRED_BOARDING_UTXOS": {
+                    const wallet = this.requireWallet();
+                    const vtxoManager = await wallet.getVtxoManager();
+                    const utxos = await vtxoManager.getExpiredBoardingUtxos();
+                    return this.tagged({
+                        id,
+                        type: "EXPIRED_BOARDING_UTXOS",
+                        payload: { utxos },
+                    });
+                }
+                case "SWEEP_EXPIRED_BOARDING_UTXOS": {
+                    const wallet = this.requireWallet();
+                    const vtxoManager = await wallet.getVtxoManager();
+                    const txid = await vtxoManager.sweepExpiredBoardingUtxos();
+                    return this.tagged({
+                        id,
+                        type: "SWEEP_EXPIRED_BOARDING_UTXOS_SUCCESS",
+                        payload: { txid },
+                    });
+                }
                 default:
                     console.error("Unknown message type", message);
                     throw new Error("Unknown message");
@@ -481,6 +603,17 @@ class WalletMessageHandler {
                 }
             });
         await this.ensureContractEventBroadcasting();
+        // Eagerly start the VtxoManager so its background tasks (auto-renewal,
+        // boarding UTXO polling/sweep) run inside the service worker without
+        // waiting for a client to send a vtxo-manager message first.
+        if (this.wallet) {
+            try {
+                await this.wallet.getVtxoManager();
+            }
+            catch (error) {
+                console.error("Error starting VtxoManager:", error);
+            }
+        }
     }
     async handleSettle(message) {
         const wallet = this.requireWallet();
@@ -523,7 +656,7 @@ class WalletMessageHandler {
         const wallet = this.requireWallet();
         const delegatorManager = await wallet.getDelegatorManager();
         if (!delegatorManager) {
-            throw new Error("Delegator not configured");
+            throw new DelegatorNotConfiguredError();
         }
         const { vtxoOutpoints, destination, delegateAt } = message.payload;
         const allVtxos = await wallet.getVtxos();
@@ -550,7 +683,7 @@ class WalletMessageHandler {
     }
     async handleGetVtxos(message) {
         if (!this.readonlyWallet) {
-            throw new Error("Wallet handler not initialized");
+            throw new WalletNotInitializedError();
         }
         const vtxos = await this.getSpendableVtxos();
         const dustAmount = this.readonlyWallet.dustAmount;

package/dist/cjs/wallet/serviceWorker/wallet.js

@@ -6,6 +6,37 @@ const utils_1 = require("../../worker/browser/utils");
 const repositories_1 = require("../../repositories");
 const wallet_message_handler_1 = require("./wallet-message-handler");
 const utils_2 = require("../utils");
+const errors_1 = require("../../worker/errors");
+// Check by error name instead of instanceof because postMessage uses the
+// structured clone algorithm which strips the prototype chain — the page
+// receives a plain Error, not the original MessageBusNotInitializedError.
+function isMessageBusNotInitializedError(error) {
+    return (error instanceof Error && error.name === "MessageBusNotInitializedError");
+}
+const DEDUPABLE_REQUEST_TYPES = new Set([
+    "GET_ADDRESS",
+    "GET_BALANCE",
+    "GET_BOARDING_ADDRESS",
+    "GET_BOARDING_UTXOS",
+    "GET_STATUS",
+    "GET_TRANSACTION_HISTORY",
+    "IS_CONTRACT_MANAGER_WATCHING",
+    "GET_DELEGATE_INFO",
+    "GET_RECOVERABLE_BALANCE",
+    "GET_EXPIRED_BOARDING_UTXOS",
+    "GET_VTXOS",
+    "GET_CONTRACTS",
+    "GET_CONTRACTS_WITH_VTXOS",
+    "GET_SPENDABLE_PATHS",
+    "GET_ALL_SPENDING_PATHS",
+    "GET_ASSET_DETAILS",
+    "GET_EXPIRING_VTXOS",
+    "RELOAD_WALLET",
+]);
+function getRequestDedupKey(request) {
+    const { id, tag, ...rest } = request;
+    return JSON.stringify(rest);
+}
 const isPrivateKeyIdentity = (identity) => {
     return typeof identity.toHex === "function";
 };
@@ -82,7 +113,7 @@ const initializeMessageBus = (serviceWorker, config, timeoutMs = 2000) => {
         };
         const timeoutId = setTimeout(() => {
             cleanup();
-            reject(new Error("MessageBus timed out!"));
+            reject(new errors_1.ServiceWorkerTimeoutError("MessageBus timed out"));
         }, timeoutMs);
         navigator.serviceWorker.addEventListener("message", onMessage);
         serviceWorker.postMessage(initCmd);
@@ -98,6 +129,8 @@ class ServiceWorkerReadonlyWallet {
         this.initConfig = null;
         this.initWalletPayload = null;
         this.reinitPromise = null;
+        this.pingPromise = null;
+        this.inflightRequests = new Map();
         this.identity = identity;
         this.walletRepository = walletRepository;
         this.contractRepository = contractRepository;
@@ -191,7 +224,7 @@ class ServiceWorkerReadonlyWallet {
             };
             const timeoutId = setTimeout(() => {
                 cleanup();
-                reject(new Error(`Service worker message timed out (${request.type})`));
+                reject(new errors_1.ServiceWorkerTimeoutError(`Service worker message timed out (${request.type})`));
             }, 30000);
             const messageHandler = (event) => {
                 const response = event.data;
@@ -210,18 +243,137 @@ class ServiceWorkerReadonlyWallet {
             this.serviceWorker.postMessage(request);
         });
     }
+    // Like sendMessageDirect but supports streaming responses: intermediate
+    // messages are forwarded via onEvent while the promise resolves on the
+    // first response for which isComplete returns true. The timeout resets
+    // on every intermediate event so long-running but progressing operations
+    // don't time out prematurely.
+    sendMessageStreaming(request, onEvent, isComplete) {
+        return new Promise((resolve, reject) => {
+            const resetTimeout = () => {
+                clearTimeout(timeoutId);
+                timeoutId = setTimeout(() => {
+                    cleanup();
+                    reject(new errors_1.ServiceWorkerTimeoutError(`Service worker message timed out (${request.type})`));
+                }, 30000);
+            };
+            const cleanup = () => {
+                clearTimeout(timeoutId);
+                navigator.serviceWorker.removeEventListener("message", messageHandler);
+            };
+            let timeoutId;
+            resetTimeout();
+            const messageHandler = (event) => {
+                const response = event.data;
+                if (request.id !== response.id)
+                    return;
+                if (response.error) {
+                    cleanup();
+                    reject(response.error);
+                    return;
+                }
+                if (isComplete(response)) {
+                    cleanup();
+                    resolve(response);
+                }
+                else {
+                    resetTimeout();
+                    onEvent(response);
+                }
+            };
+            navigator.serviceWorker.addEventListener("message", messageHandler);
+            this.serviceWorker.postMessage(request);
+        });
+    }
+    async sendMessage(request) {
+        if (!DEDUPABLE_REQUEST_TYPES.has(request.type)) {
+            return this.sendMessageWithRetry(request);
+        }
+        const key = getRequestDedupKey(request);
+        const existing = this.inflightRequests.get(key);
+        if (existing)
+            return existing;
+        const promise = this.sendMessageWithRetry(request).finally(() => {
+            this.inflightRequests.delete(key);
+        });
+        this.inflightRequests.set(key, promise);
+        return promise;
+    }
+    pingServiceWorker() {
+        if (this.pingPromise)
+            return this.pingPromise;
+        this.pingPromise = new Promise((resolve, reject) => {
+            const pingId = (0, utils_2.getRandomId)();
+            const cleanup = () => {
+                clearTimeout(timeoutId);
+                navigator.serviceWorker.removeEventListener("message", onMessage);
+            };
+            const timeoutId = setTimeout(() => {
+                cleanup();
+                reject(new errors_1.ServiceWorkerTimeoutError("Service worker ping timed out"));
+            }, 2000);
+            const onMessage = (event) => {
+                if (event.data?.id === pingId && event.data?.tag === "PONG") {
+                    cleanup();
+                    resolve();
+                }
+            };
+            navigator.serviceWorker.addEventListener("message", onMessage);
+            this.serviceWorker.postMessage({
+                id: pingId,
+                tag: "PING",
+            });
+        }).finally(() => {
+            this.pingPromise = null;
+        });
+        return this.pingPromise;
+    }
     // send a message, retrying up to 2 times if the service worker was
     // killed and restarted by the OS (mobile browsers do this aggressively)
-    async sendMessage(request) {
+    async sendMessageWithRetry(request) {
+        // Skip the preflight ping during the initial INIT_WALLET call:
+        // create() hasn't set initConfig yet, so reinitialize() would throw.
+        if (this.initConfig) {
+            try {
+                await this.pingServiceWorker();
+            }
+            catch {
+                await this.reinitialize();
+            }
+        }
         const maxRetries = 2;
         for (let attempt = 0;; attempt++) {
             try {
                 return await this.sendMessageDirect(request);
             }
             catch (error) {
-                const isNotInitialized = typeof error?.message === "string" &&
-                    error.message.includes("MessageBus not initialized");
-                if (!isNotInitialized || attempt >= maxRetries) {
+                if (!isMessageBusNotInitializedError(error) ||
+                    attempt >= maxRetries) {
+                    throw error;
+                }
+                await this.reinitialize();
+            }
+        }
+    }
+    // Like sendMessage but for streaming responses — retries with
+    // reinitialize when the service worker has been killed/restarted.
+    async sendMessageWithEvents(request, onEvent, isComplete) {
+        if (this.initConfig) {
+            try {
+                await this.pingServiceWorker();
+            }
+            catch {
+                await this.reinitialize();
+            }
+        }
+        const maxRetries = 2;
+        for (let attempt = 0;; attempt++) {
+            try {
+                return await this.sendMessageStreaming(request, onEvent, isComplete);
+            }
+            catch (error) {
+                if (!isMessageBusNotInitializedError(error) ||
+                    attempt >= maxRetries) {
                     throw error;
                 }
                 await this.reinitialize();
@@ -675,34 +827,8 @@ class ServiceWorkerWallet extends ServiceWorkerReadonlyWallet {
             payload: { params },
         };
         try {
-            return new Promise((resolve, reject) => {
-                const messageHandler = (event) => {
-                    const response = event.data;
-                    if (response.id !== message.id) {
-                        return;
-                    }
-                    if (response.error) {
-                        navigator.serviceWorker.removeEventListener("message", messageHandler);
-                        reject(response.error);
-                        return;
-                    }
-                    switch (response.type) {
-                        case "SETTLE_EVENT":
-                            if (callback) {
-                                callback(response.payload);
-                            }
-                            break;
-                        case "SETTLE_SUCCESS":
-                            navigator.serviceWorker.removeEventListener("message", messageHandler);
-                            resolve(response.payload.txid);
-                            break;
-                        default:
-                            console.error(`Unexpected response type for SETTLE request: ${response.type}`);
-                    }
-                };
-                navigator.serviceWorker.addEventListener("message", messageHandler);
-                this.serviceWorker.postMessage(message);
-            });
+            const response = await this.sendMessageWithEvents(message, (resp) => callback?.(resp.payload), (resp) => resp.type === "SETTLE_SUCCESS");
+            return response.payload.txid;
         }
         catch (error) {
             throw new Error(`Settlement failed: ${error}`);
@@ -776,5 +902,109 @@ class ServiceWorkerWallet extends ServiceWorkerReadonlyWallet {
         };
         return manager;
     }
+    async getVtxoManager() {
+        const wallet = this;
+        const messageTag = this.messageTag;
+        const manager = {
+            async recoverVtxos(eventCallback) {
+                const message = {
+                    tag: messageTag,
+                    type: "RECOVER_VTXOS",
+                    id: (0, utils_2.getRandomId)(),
+                };
+                try {
+                    const response = await wallet.sendMessageWithEvents(message, (resp) => eventCallback?.(resp.payload), (resp) => resp.type === "RECOVER_VTXOS_SUCCESS");
+                    return response.payload.txid;
+                }
+                catch (e) {
+                    throw new Error(`Failed to recover vtxos: ${e}`);
+                }
+            },
+            async getRecoverableBalance() {
+                const message = {
+                    tag: messageTag,
+                    type: "GET_RECOVERABLE_BALANCE",
+                    id: (0, utils_2.getRandomId)(),
+                };
+                try {
+                    const response = await wallet.sendMessage(message);
+                    const payload = response
+                        .payload;
+                    return {
+                        recoverable: BigInt(payload.recoverable),
+                        subdust: BigInt(payload.subdust),
+                        includesSubdust: payload.includesSubdust,
+                        vtxoCount: payload.vtxoCount,
+                    };
+                }
+                catch (e) {
+                    throw new Error(`Failed to get recoverable balance: ${e}`);
+                }
+            },
+            async getExpiringVtxos(thresholdMs) {
+                const message = {
+                    tag: messageTag,
+                    type: "GET_EXPIRING_VTXOS",
+                    id: (0, utils_2.getRandomId)(),
+                    payload: { thresholdMs },
+                };
+                try {
+                    const response = await wallet.sendMessage(message);
+                    return response.payload.vtxos;
+                }
+                catch (e) {
+                    throw new Error(`Failed to get expiring vtxos: ${e}`);
+                }
+            },
+            async renewVtxos(eventCallback) {
+                const message = {
+                    tag: messageTag,
+                    type: "RENEW_VTXOS",
+                    id: (0, utils_2.getRandomId)(),
+                };
+                try {
+                    const response = await wallet.sendMessageWithEvents(message, (resp) => eventCallback?.(resp.payload), (resp) => resp.type === "RENEW_VTXOS_SUCCESS");
+                    return response.payload.txid;
+                }
+                catch (e) {
+                    throw new Error(`Failed to renew vtxos: ${e}`);
+                }
+            },
+            async getExpiredBoardingUtxos() {
+                const message = {
+                    tag: messageTag,
+                    type: "GET_EXPIRED_BOARDING_UTXOS",
+                    id: (0, utils_2.getRandomId)(),
+                };
+                try {
+                    const response = await wallet.sendMessage(message);
+                    return response.payload
+                        .utxos;
+                }
+                catch (e) {
+                    throw new Error(`Failed to get expired boarding utxos: ${e}`);
+                }
+            },
+            async sweepExpiredBoardingUtxos() {
+                const message = {
+                    tag: messageTag,
+                    type: "SWEEP_EXPIRED_BOARDING_UTXOS",
+                    id: (0, utils_2.getRandomId)(),
+                };
+                try {
+                    const response = await wallet.sendMessage(message);
+                    return response
+                        .payload.txid;
+                }
+                catch (e) {
+                    throw new Error(`Failed to sweep expired boarding utxos: ${e}`);
+                }
+            },
+            async dispose() {
+                return;
+            },
+        };
+        return manager;
+    }
 }
 exports.ServiceWorkerWallet = ServiceWorkerWallet;