@arkade-os/sdk 0.4.12 → 0.4.14

package/README.md

@@ -3,7 +3,7 @@
 The Arkade SDK is a TypeScript library for building Bitcoin wallets with support for both on-chain and off-chain transactions via the Ark protocol.
 
 [![TypeScript Documentation](https://img.shields.io/badge/TypeScript-Documentation-blue?style=flat-square)](https://arkade-os.github.io/ts-sdk/)
-[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/ark-ts-sdk)
+[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/arkade-os/ts-sdk)
 
 ## Installation
 

package/dist/cjs/identity/seedIdentity.js

@@ -7,8 +7,7 @@ const utils_js_1 = require("@scure/btc-signer/utils.js");
 const btc_signer_1 = require("@scure/btc-signer");
 const signingSession_1 = require("../tree/signingSession");
 const secp256k1_1 = require("@noble/secp256k1");
-const bitcoin_descriptors_1 = require("@kukks/bitcoin-descriptors");
-const { expand } = bitcoin_descriptors_1.defaultFactory;
+const descriptors_scure_1 = require("@bitcoinerlab/descriptors-scure");
 const ALL_SIGHASH = Object.values(btc_signer_1.SigHash).filter((x) => typeof x === "number");
 /**
  * Detects the network from a descriptor string by checking for tpub (testnet)
@@ -16,7 +15,7 @@ const ALL_SIGHASH = Object.values(btc_signer_1.SigHash).filter((x) => typeof x =
  * @internal
  */
 function detectNetwork(descriptor) {
-    return descriptor.includes("tpub") ? bitcoin_descriptors_1.networks.testnet : bitcoin_descriptors_1.networks.bitcoin;
+    return descriptor.includes("tpub") ? descriptors_scure_1.networks.testnet : descriptors_scure_1.networks.bitcoin;
 }
 function hasDescriptor(opts) {
     return "descriptor" in opts && typeof opts.descriptor === "string";
@@ -26,9 +25,9 @@ function hasDescriptor(opts) {
  * @internal
  */
 function buildDescriptor(seed, isMainnet) {
-    const network = isMainnet ? bitcoin_descriptors_1.networks.bitcoin : bitcoin_descriptors_1.networks.testnet;
-    const masterNode = bitcoin_descriptors_1.scureBIP32.fromSeed(seed, network);
-    return bitcoin_descriptors_1.scriptExpressions.trBIP32({
+    const network = isMainnet ? descriptors_scure_1.networks.bitcoin : descriptors_scure_1.networks.testnet;
+    const masterNode = descriptors_scure_1.HDKey.fromMasterSeed(seed, network.bip32);
+    return descriptors_scure_1.scriptExpressions.trBIP32({
         masterNode,
         network,
         account: 0,
@@ -72,22 +71,22 @@ class SeedIdentity {
         this.descriptor = descriptor;
         const network = detectNetwork(descriptor);
         // Parse and validate the descriptor using the library
-        const expansion = expand({ descriptor, network });
+        const expansion = (0, descriptors_scure_1.expand)({ descriptor, network });
         const keyInfo = expansion.expansionMap?.["@0"];
         if (!keyInfo?.originPath) {
             throw new Error("Descriptor must include a key origin path");
         }
         // Verify the xpub in the descriptor matches our seed
-        const masterNode = bitcoin_descriptors_1.scureBIP32.fromSeed(seed, network);
-        const accountNode = masterNode.derivePath(`m${keyInfo.originPath}`);
-        if (accountNode.neutered().toBase58() !== keyInfo.bip32?.toBase58()) {
+        const masterNode = descriptors_scure_1.HDKey.fromMasterSeed(seed, network.bip32);
+        const accountNode = masterNode.derive(`m${keyInfo.originPath}`);
+        if (accountNode.publicExtendedKey !== keyInfo.bip32?.toBase58()) {
             throw new Error("xpub mismatch: derived key does not match descriptor");
         }
         // Derive the private key using the full path from the descriptor
         if (!keyInfo.path) {
             throw new Error("Descriptor must specify a full derivation path");
         }
-        const derivedNode = masterNode.derivePath(keyInfo.path);
+        const derivedNode = masterNode.derive(keyInfo.path);
         if (!derivedNode.privateKey) {
             throw new Error("Failed to derive private key");
         }
@@ -217,7 +216,7 @@ class ReadonlyDescriptorIdentity {
     constructor(descriptor) {
         this.descriptor = descriptor;
         const network = detectNetwork(descriptor);
-        const expansion = expand({ descriptor, network });
+        const expansion = (0, descriptors_scure_1.expand)({ descriptor, network });
         const keyInfo = expansion.expansionMap?.["@0"];
         if (!keyInfo?.pubkey) {
             throw new Error("Failed to derive public key from descriptor");

package/dist/cjs/index.js

@@ -36,9 +36,9 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-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.MESSAGE_BUS_NOT_INITIALIZED = 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.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 = exports.VtxoTaprootTree = void 0;
-exports.isArkContract = exports.contractFromArkContractWithAddress = void 0;
+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.DEFAULT_MESSAGE_TIMEOUTS = exports.ServiceWorkerReadonlyWallet = exports.ServiceWorkerWallet = exports.ServiceWorkerTimeoutError = exports.MessageBusNotInitializedError = exports.MESSAGE_BUS_NOT_INITIALIZED = 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.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 = exports.VtxoTaprootTree = exports.VtxoTreeExpiry = void 0;
+exports.isArkContract = exports.contractFromArkContractWithAddress = exports.contractFromArkContract = 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");
@@ -84,6 +84,7 @@ Object.defineProperty(exports, "VtxoManager", { enumerable: true, get: function
 const wallet_3 = require("./wallet/serviceWorker/wallet");
 Object.defineProperty(exports, "ServiceWorkerWallet", { enumerable: true, get: function () { return wallet_3.ServiceWorkerWallet; } });
 Object.defineProperty(exports, "ServiceWorkerReadonlyWallet", { enumerable: true, get: function () { return wallet_3.ServiceWorkerReadonlyWallet; } });
+Object.defineProperty(exports, "DEFAULT_MESSAGE_TIMEOUTS", { enumerable: true, get: function () { return wallet_3.DEFAULT_MESSAGE_TIMEOUTS; } });
 const onchain_1 = require("./wallet/onchain");
 Object.defineProperty(exports, "OnchainWallet", { enumerable: true, get: function () { return onchain_1.OnchainWallet; } });
 const utils_1 = require("./worker/browser/utils");

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

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ServiceWorkerWallet = exports.ServiceWorkerReadonlyWallet = void 0;
+exports.ServiceWorkerWallet = exports.ServiceWorkerReadonlyWallet = exports.DEFAULT_MESSAGE_TIMEOUTS = void 0;
 const base_1 = require("@scure/base");
 const utils_1 = require("../../worker/browser/utils");
 const repositories_1 = require("../../repositories");
@@ -14,6 +14,47 @@ function isMessageBusNotInitializedError(error) {
     return (error instanceof Error &&
         error.message.includes(errors_1.MESSAGE_BUS_NOT_INITIALIZED));
 }
+exports.DEFAULT_MESSAGE_TIMEOUTS = {
+    // Fast reads — fail quickly
+    GET_ADDRESS: 10000,
+    GET_BALANCE: 10000,
+    GET_BOARDING_ADDRESS: 10000,
+    GET_STATUS: 10000,
+    GET_DELEGATE_INFO: 10000,
+    IS_CONTRACT_MANAGER_WATCHING: 10000,
+    // Medium reads — may involve indexer queries
+    GET_VTXOS: 20000,
+    GET_BOARDING_UTXOS: 20000,
+    GET_TRANSACTION_HISTORY: 20000,
+    GET_CONTRACTS: 20000,
+    GET_CONTRACTS_WITH_VTXOS: 20000,
+    GET_SPENDABLE_PATHS: 20000,
+    GET_ALL_SPENDING_PATHS: 20000,
+    GET_ASSET_DETAILS: 20000,
+    GET_EXPIRING_VTXOS: 20000,
+    GET_EXPIRED_BOARDING_UTXOS: 20000,
+    GET_RECOVERABLE_BALANCE: 20000,
+    RELOAD_WALLET: 20000,
+    // Transactions — need more headroom
+    SEND_BITCOIN: 50000,
+    SEND: 50000,
+    SETTLE: 50000,
+    ISSUE: 50000,
+    REISSUE: 50000,
+    BURN: 50000,
+    DELEGATE: 50000,
+    RECOVER_VTXOS: 50000,
+    RENEW_VTXOS: 50000,
+    SWEEP_EXPIRED_BOARDING_UTXOS: 50000,
+    // Misc writes
+    INIT_WALLET: 30000,
+    CLEAR: 10000,
+    SIGN_TRANSACTION: 30000,
+    CREATE_CONTRACT: 30000,
+    UPDATE_CONTRACT: 30000,
+    DELETE_CONTRACT: 10000,
+    REFRESH_VTXOS: 30000,
+};
 const DEDUPABLE_REQUEST_TYPES = new Set([
     "GET_ADDRESS",
     "GET_BALANCE",
@@ -129,6 +170,7 @@ class ServiceWorkerReadonlyWallet {
         this.messageTag = messageTag;
         this.initConfig = null;
         this.initWalletPayload = null;
+        this.messageTimeouts = exports.DEFAULT_MESSAGE_TIMEOUTS;
         this.reinitPromise = null;
         this.pingPromise = null;
         this.inflightRequests = new Map();
@@ -137,6 +179,9 @@ class ServiceWorkerReadonlyWallet {
         this.contractRepository = contractRepository;
         this._readonlyAssetManager = new ServiceWorkerReadonlyAssetManager((msg) => this.sendMessage(msg), messageTag);
     }
+    getTimeoutForRequest(request) {
+        return this.messageTimeouts[request.type] ?? 30000;
+    }
     static async create(options) {
         const walletRepository = options.storage?.walletRepository ??
             new repositories_1.IndexedDBWalletRepository();
@@ -188,6 +233,12 @@ class ServiceWorkerReadonlyWallet {
         };
         wallet.initWalletPayload = initConfig;
         wallet.messageBusTimeoutMs = options.messageBusTimeoutMs;
+        if (options.messageTimeouts) {
+            wallet.messageTimeouts = {
+                ...exports.DEFAULT_MESSAGE_TIMEOUTS,
+                ...options.messageTimeouts,
+            };
+        }
         return wallet;
     }
     /**
@@ -223,7 +274,7 @@ class ServiceWorkerReadonlyWallet {
             serviceWorker,
         });
     }
-    sendMessageDirect(request) {
+    sendMessageDirect(request, timeoutMs) {
         return new Promise((resolve, reject) => {
             const cleanup = () => {
                 clearTimeout(timeoutId);
@@ -232,7 +283,7 @@ class ServiceWorkerReadonlyWallet {
             const timeoutId = setTimeout(() => {
                 cleanup();
                 reject(new errors_1.ServiceWorkerTimeoutError(`Service worker message timed out (${request.type})`));
-            }, 30000);
+            }, timeoutMs);
             const messageHandler = (event) => {
                 const response = event.data;
                 if (request.id !== response.id) {
@@ -255,14 +306,14 @@ class ServiceWorkerReadonlyWallet {
     // 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) {
+    sendMessageStreaming(request, onEvent, isComplete, timeoutMs) {
         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);
+                }, timeoutMs);
             };
             const cleanup = () => {
                 clearTimeout(timeoutId);
@@ -348,10 +399,11 @@ class ServiceWorkerReadonlyWallet {
                 await this.reinitialize();
             }
         }
+        const timeoutMs = this.getTimeoutForRequest(request);
         const maxRetries = 2;
         for (let attempt = 0;; attempt++) {
             try {
-                return await this.sendMessageDirect(request);
+                return await this.sendMessageDirect(request, timeoutMs);
             }
             catch (error) {
                 if (!isMessageBusNotInitializedError(error) ||
@@ -373,10 +425,11 @@ class ServiceWorkerReadonlyWallet {
                 await this.reinitialize();
             }
         }
+        const timeoutMs = this.getTimeoutForRequest(request);
         const maxRetries = 2;
         for (let attempt = 0;; attempt++) {
             try {
-                return await this.sendMessageStreaming(request, onEvent, isComplete);
+                return await this.sendMessageStreaming(request, onEvent, isComplete, timeoutMs);
             }
             catch (error) {
                 if (!isMessageBusNotInitializedError(error) ||
@@ -401,7 +454,7 @@ class ServiceWorkerReadonlyWallet {
                 id: (0, utils_2.getRandomId)(),
                 payload: this.initWalletPayload,
             };
-            await this.sendMessageDirect(initMessage);
+            await this.sendMessageDirect(initMessage, this.getTimeoutForRequest(initMessage));
         })().finally(() => {
             this.reinitPromise = null;
         });
@@ -793,6 +846,12 @@ class ServiceWorkerWallet extends ServiceWorkerReadonlyWallet {
         };
         wallet.initWalletPayload = initConfig;
         wallet.messageBusTimeoutMs = options.messageBusTimeoutMs;
+        if (options.messageTimeouts) {
+            wallet.messageTimeouts = {
+                ...exports.DEFAULT_MESSAGE_TIMEOUTS,
+                ...options.messageTimeouts,
+            };
+        }
         return wallet;
     }
     /**

package/dist/esm/identity/seedIdentity.js

@@ -4,8 +4,7 @@ import { pubECDSA, pubSchnorr } from "@scure/btc-signer/utils.js";
 import { SigHash } from "@scure/btc-signer";
 import { TreeSignerSession } from '../tree/signingSession.js';
 import { schnorr, signAsync } from "@noble/secp256k1";
-import { defaultFactory, scureBIP32 as BIP32, networks, scriptExpressions, } from "@kukks/bitcoin-descriptors";
-const { expand } = defaultFactory;
+import { HDKey, expand, networks, scriptExpressions, } from "@bitcoinerlab/descriptors-scure";
 const ALL_SIGHASH = Object.values(SigHash).filter((x) => typeof x === "number");
 /**
  * Detects the network from a descriptor string by checking for tpub (testnet)
@@ -24,7 +23,7 @@ function hasDescriptor(opts) {
  */
 function buildDescriptor(seed, isMainnet) {
     const network = isMainnet ? networks.bitcoin : networks.testnet;
-    const masterNode = BIP32.fromSeed(seed, network);
+    const masterNode = HDKey.fromMasterSeed(seed, network.bip32);
     return scriptExpressions.trBIP32({
         masterNode,
         network,
@@ -75,16 +74,16 @@ export class SeedIdentity {
             throw new Error("Descriptor must include a key origin path");
         }
         // Verify the xpub in the descriptor matches our seed
-        const masterNode = BIP32.fromSeed(seed, network);
-        const accountNode = masterNode.derivePath(`m${keyInfo.originPath}`);
-        if (accountNode.neutered().toBase58() !== keyInfo.bip32?.toBase58()) {
+        const masterNode = HDKey.fromMasterSeed(seed, network.bip32);
+        const accountNode = masterNode.derive(`m${keyInfo.originPath}`);
+        if (accountNode.publicExtendedKey !== keyInfo.bip32?.toBase58()) {
             throw new Error("xpub mismatch: derived key does not match descriptor");
         }
         // Derive the private key using the full path from the descriptor
         if (!keyInfo.path) {
             throw new Error("Descriptor must specify a full derivation path");
         }
-        const derivedNode = masterNode.derivePath(keyInfo.path);
+        const derivedNode = masterNode.derive(keyInfo.path);
         if (!derivedNode.privateKey) {
             throw new Error("Failed to derive private key");
         }

package/dist/esm/index.js

@@ -13,7 +13,7 @@ import { Wallet, ReadonlyWallet, waitForIncomingFunds, } from './wallet/wallet.j
 import { TxTree } from './tree/txTree.js';
 import { Ramps } from './wallet/ramps.js';
 import { isVtxoExpiringSoon, VtxoManager } from './wallet/vtxo-manager.js';
-import { ServiceWorkerWallet, ServiceWorkerReadonlyWallet, } from './wallet/serviceWorker/wallet.js';
+import { ServiceWorkerWallet, ServiceWorkerReadonlyWallet, DEFAULT_MESSAGE_TIMEOUTS, } from './wallet/serviceWorker/wallet.js';
 import { OnchainWallet } from './wallet/onchain.js';
 import { setupServiceWorker } from './worker/browser/utils.js';
 import { ESPLORA_URL, EsploraProvider, } from './providers/onchain.js';
@@ -51,7 +51,7 @@ ArkAddress, DefaultVtxo, DelegateVtxo, VtxoScript, VHTLC,
 // Enums
 TxType, IndexerTxType, ChainTxType, SettlementEventType, 
 // Service Worker
-setupServiceWorker, MessageBus, WalletMessageHandler, WalletNotInitializedError, ReadonlyWalletError, DelegatorNotConfiguredError, MESSAGE_BUS_NOT_INITIALIZED, MessageBusNotInitializedError, ServiceWorkerTimeoutError, ServiceWorkerWallet, ServiceWorkerReadonlyWallet, 
+setupServiceWorker, MessageBus, WalletMessageHandler, WalletNotInitializedError, ReadonlyWalletError, DelegatorNotConfiguredError, MESSAGE_BUS_NOT_INITIALIZED, MessageBusNotInitializedError, ServiceWorkerTimeoutError, ServiceWorkerWallet, ServiceWorkerReadonlyWallet, DEFAULT_MESSAGE_TIMEOUTS, 
 // Tapscript
 decodeTapscript, MultisigTapscript, CSVMultisigTapscript, ConditionCSVMultisigTapscript, ConditionMultisigTapscript, CLTVMultisigTapscript, TapTreeCoder, 
 // Ark PSBT fields

package/dist/esm/wallet/serviceWorker/wallet.js

@@ -11,6 +11,47 @@ function isMessageBusNotInitializedError(error) {
     return (error instanceof Error &&
         error.message.includes(MESSAGE_BUS_NOT_INITIALIZED));
 }
+export const DEFAULT_MESSAGE_TIMEOUTS = {
+    // Fast reads — fail quickly
+    GET_ADDRESS: 10000,
+    GET_BALANCE: 10000,
+    GET_BOARDING_ADDRESS: 10000,
+    GET_STATUS: 10000,
+    GET_DELEGATE_INFO: 10000,
+    IS_CONTRACT_MANAGER_WATCHING: 10000,
+    // Medium reads — may involve indexer queries
+    GET_VTXOS: 20000,
+    GET_BOARDING_UTXOS: 20000,
+    GET_TRANSACTION_HISTORY: 20000,
+    GET_CONTRACTS: 20000,
+    GET_CONTRACTS_WITH_VTXOS: 20000,
+    GET_SPENDABLE_PATHS: 20000,
+    GET_ALL_SPENDING_PATHS: 20000,
+    GET_ASSET_DETAILS: 20000,
+    GET_EXPIRING_VTXOS: 20000,
+    GET_EXPIRED_BOARDING_UTXOS: 20000,
+    GET_RECOVERABLE_BALANCE: 20000,
+    RELOAD_WALLET: 20000,
+    // Transactions — need more headroom
+    SEND_BITCOIN: 50000,
+    SEND: 50000,
+    SETTLE: 50000,
+    ISSUE: 50000,
+    REISSUE: 50000,
+    BURN: 50000,
+    DELEGATE: 50000,
+    RECOVER_VTXOS: 50000,
+    RENEW_VTXOS: 50000,
+    SWEEP_EXPIRED_BOARDING_UTXOS: 50000,
+    // Misc writes
+    INIT_WALLET: 30000,
+    CLEAR: 10000,
+    SIGN_TRANSACTION: 30000,
+    CREATE_CONTRACT: 30000,
+    UPDATE_CONTRACT: 30000,
+    DELETE_CONTRACT: 10000,
+    REFRESH_VTXOS: 30000,
+};
 const DEDUPABLE_REQUEST_TYPES = new Set([
     "GET_ADDRESS",
     "GET_BALANCE",
@@ -126,6 +167,7 @@ export class ServiceWorkerReadonlyWallet {
         this.messageTag = messageTag;
         this.initConfig = null;
         this.initWalletPayload = null;
+        this.messageTimeouts = DEFAULT_MESSAGE_TIMEOUTS;
         this.reinitPromise = null;
         this.pingPromise = null;
         this.inflightRequests = new Map();
@@ -134,6 +176,9 @@ export class ServiceWorkerReadonlyWallet {
         this.contractRepository = contractRepository;
         this._readonlyAssetManager = new ServiceWorkerReadonlyAssetManager((msg) => this.sendMessage(msg), messageTag);
     }
+    getTimeoutForRequest(request) {
+        return this.messageTimeouts[request.type] ?? 30000;
+    }
     static async create(options) {
         const walletRepository = options.storage?.walletRepository ??
             new IndexedDBWalletRepository();
@@ -185,6 +230,12 @@ export class ServiceWorkerReadonlyWallet {
         };
         wallet.initWalletPayload = initConfig;
         wallet.messageBusTimeoutMs = options.messageBusTimeoutMs;
+        if (options.messageTimeouts) {
+            wallet.messageTimeouts = {
+                ...DEFAULT_MESSAGE_TIMEOUTS,
+                ...options.messageTimeouts,
+            };
+        }
         return wallet;
     }
     /**
@@ -220,7 +271,7 @@ export class ServiceWorkerReadonlyWallet {
             serviceWorker,
         });
     }
-    sendMessageDirect(request) {
+    sendMessageDirect(request, timeoutMs) {
         return new Promise((resolve, reject) => {
             const cleanup = () => {
                 clearTimeout(timeoutId);
@@ -229,7 +280,7 @@ export class ServiceWorkerReadonlyWallet {
             const timeoutId = setTimeout(() => {
                 cleanup();
                 reject(new ServiceWorkerTimeoutError(`Service worker message timed out (${request.type})`));
-            }, 30000);
+            }, timeoutMs);
             const messageHandler = (event) => {
                 const response = event.data;
                 if (request.id !== response.id) {
@@ -252,14 +303,14 @@ export class ServiceWorkerReadonlyWallet {
     // 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) {
+    sendMessageStreaming(request, onEvent, isComplete, timeoutMs) {
         return new Promise((resolve, reject) => {
             const resetTimeout = () => {
                 clearTimeout(timeoutId);
                 timeoutId = setTimeout(() => {
                     cleanup();
                     reject(new ServiceWorkerTimeoutError(`Service worker message timed out (${request.type})`));
-                }, 30000);
+                }, timeoutMs);
             };
             const cleanup = () => {
                 clearTimeout(timeoutId);
@@ -345,10 +396,11 @@ export class ServiceWorkerReadonlyWallet {
                 await this.reinitialize();
             }
         }
+        const timeoutMs = this.getTimeoutForRequest(request);
         const maxRetries = 2;
         for (let attempt = 0;; attempt++) {
             try {
-                return await this.sendMessageDirect(request);
+                return await this.sendMessageDirect(request, timeoutMs);
             }
             catch (error) {
                 if (!isMessageBusNotInitializedError(error) ||
@@ -370,10 +422,11 @@ export class ServiceWorkerReadonlyWallet {
                 await this.reinitialize();
             }
         }
+        const timeoutMs = this.getTimeoutForRequest(request);
         const maxRetries = 2;
         for (let attempt = 0;; attempt++) {
             try {
-                return await this.sendMessageStreaming(request, onEvent, isComplete);
+                return await this.sendMessageStreaming(request, onEvent, isComplete, timeoutMs);
             }
             catch (error) {
                 if (!isMessageBusNotInitializedError(error) ||
@@ -398,7 +451,7 @@ export class ServiceWorkerReadonlyWallet {
                 id: getRandomId(),
                 payload: this.initWalletPayload,
             };
-            await this.sendMessageDirect(initMessage);
+            await this.sendMessageDirect(initMessage, this.getTimeoutForRequest(initMessage));
         })().finally(() => {
             this.reinitPromise = null;
         });
@@ -789,6 +842,12 @@ export class ServiceWorkerWallet extends ServiceWorkerReadonlyWallet {
         };
         wallet.initWalletPayload = initConfig;
         wallet.messageBusTimeoutMs = options.messageBusTimeoutMs;
+        if (options.messageTimeouts) {
+            wallet.messageTimeouts = {
+                ...DEFAULT_MESSAGE_TIMEOUTS,
+                ...options.messageTimeouts,
+            };
+        }
         return wallet;
     }
     /**

package/dist/types/index.d.ts

@@ -17,7 +17,8 @@ import { SignerSession, TreeNonces, TreePartialSigs } from "./tree/signingSessio
 import { Ramps } from "./wallet/ramps";
 import { isVtxoExpiringSoon, VtxoManager } from "./wallet/vtxo-manager";
 import type { IVtxoManager, SettlementConfig } from "./wallet/vtxo-manager";
-import { ServiceWorkerWallet, ServiceWorkerReadonlyWallet } from "./wallet/serviceWorker/wallet";
+import { ServiceWorkerWallet, ServiceWorkerReadonlyWallet, DEFAULT_MESSAGE_TIMEOUTS } from "./wallet/serviceWorker/wallet";
+import type { MessageTimeouts } from "./wallet/serviceWorker/wallet";
 import { OnchainWallet } from "./wallet/onchain";
 import { setupServiceWorker } from "./worker/browser/utils";
 import { ESPLORA_URL, EsploraProvider, OnchainProvider, ExplorerTransaction } from "./providers/onchain";
@@ -49,5 +50,5 @@ import { IContractManager } from "./contracts/contractManager";
 import { closeDatabase, openDatabase } from "./repositories/indexedDB/manager";
 import { WalletMessageHandler, WalletNotInitializedError, ReadonlyWalletError, DelegatorNotConfiguredError } from "./wallet/serviceWorker/wallet-message-handler";
 import { MESSAGE_BUS_NOT_INITIALIZED, 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, MESSAGE_BUS_NOT_INITIALIZED, 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, };
+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, MESSAGE_BUS_NOT_INITIALIZED, MessageBusNotInitializedError, ServiceWorkerTimeoutError, ServiceWorkerWallet, ServiceWorkerReadonlyWallet, DEFAULT_MESSAGE_TIMEOUTS, 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, MessageTimeouts, IDelegatorManager, DelegatorProvider, DelegateInfo, DelegateOptions, WalletRepository, ContractRepository, MigrationStatus, };

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

@@ -8,6 +8,9 @@ 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 RequestType = WalletUpdaterRequest["type"];
+export type MessageTimeouts = Partial<Record<RequestType, number>>;
+export declare const DEFAULT_MESSAGE_TIMEOUTS: Readonly<Record<RequestType, number>>;
 type PrivateKeyIdentity = Identity & {
     toHex(): string;
 };
@@ -55,6 +58,7 @@ interface ServiceWorkerWalletOptions {
     messageBusTimeoutMs?: number;
     settlementConfig?: SettlementConfig | false;
     watcherConfig?: Partial<Omit<ContractWatcherConfig, "indexerProvider">>;
+    messageTimeouts?: MessageTimeouts;
 }
 export type ServiceWorkerWalletCreateOptions = ServiceWorkerWalletOptions & {
     serviceWorker: ServiceWorker;
@@ -90,11 +94,13 @@ export declare class ServiceWorkerReadonlyWallet implements IReadonlyWallet {
     protected initConfig: MessageBusInitConfig | null;
     protected initWalletPayload: RequestInitWallet["payload"] | null;
     protected messageBusTimeoutMs?: number;
+    protected messageTimeouts: Record<RequestType, number>;
     private reinitPromise;
     private pingPromise;
     private inflightRequests;
     get assetManager(): IReadonlyAssetManager;
     protected constructor(serviceWorker: ServiceWorker, identity: ReadonlyIdentity, walletRepository: WalletRepository, contractRepository: ContractRepository, messageTag: string);
+    private getTimeoutForRequest;
     static create(options: ServiceWorkerWalletCreateOptions): Promise<ServiceWorkerReadonlyWallet>;
     /**
      * Simplified setup method that handles service worker registration,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arkade-os/sdk",
-  "version": "0.4.12",
+  "version": "0.4.14",
   "description": "Bitcoin wallet SDK with Taproot and Ark integration",
   "type": "module",
   "main": "./dist/cjs/index.js",
@@ -80,12 +80,11 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@kukks/bitcoin-descriptors": "3.2.3",
+    "@bitcoinerlab/descriptors-scure": "3.1.7",
     "@marcbachmann/cel-js": "7.3.1",
-    "@noble/curves": "2.0.0",
+    "@noble/curves": "2.0.1",
     "@noble/secp256k1": "3.0.0",
     "@scure/base": "2.0.0",
-    "@scure/bip32": "2.0.0",
     "@scure/bip39": "2.0.1",
     "@scure/btc-signer": "2.0.1",
     "bip68": "1.0.4"