@arkade-os/sdk 0.4.13 → 0.4.15

package/dist/esm/index.js

@@ -1,6 +1,7 @@
 import { Transaction } from './utils/transaction.js';
 import { SingleKey, ReadonlySingleKey } from './identity/singleKey.js';
 import { SeedIdentity, MnemonicIdentity, ReadonlyDescriptorIdentity, } from './identity/seedIdentity.js';
+import { isBatchSignable, } from './identity/index.js';
 import { ArkAddress } from './script/address.js';
 import { VHTLC } from './script/vhtlc.js';
 import { DefaultVtxo } from './script/default.js';
@@ -13,7 +14,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';
@@ -43,7 +44,7 @@ import { WalletMessageHandler, WalletNotInitializedError, ReadonlyWalletError, D
 import { MESSAGE_BUS_NOT_INITIALIZED, MessageBusNotInitializedError, ServiceWorkerTimeoutError, } from './worker/errors.js';
 export { 
 // Wallets
-Wallet, ReadonlyWallet, SingleKey, ReadonlySingleKey, SeedIdentity, MnemonicIdentity, ReadonlyDescriptorIdentity, OnchainWallet, Ramps, VtxoManager, DelegatorManagerImpl, RestDelegatorProvider, 
+Wallet, ReadonlyWallet, SingleKey, ReadonlySingleKey, SeedIdentity, MnemonicIdentity, ReadonlyDescriptorIdentity, isBatchSignable, OnchainWallet, Ramps, VtxoManager, DelegatorManagerImpl, RestDelegatorProvider, 
 // Providers
 ESPLORA_URL, EsploraProvider, RestArkProvider, RestIndexerProvider, 
 // Script-related
@@ -51,7 +52,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/script/tapscript.js

@@ -498,7 +498,7 @@ export var CLTVMultisigTapscript;
             throw new Error(`Invalid script: too short (expected at least 3)`);
         }
         const locktime = asm[0];
-        if (typeof locktime === "string" || typeof locktime === "number") {
+        if (typeof locktime === "string") {
             throw new Error("Invalid script: expected locktime number");
         }
         if (asm[1] !== "CHECKLOCKTIMEVERIFY" || asm[2] !== "DROP") {
@@ -512,7 +512,13 @@ export var CLTVMultisigTapscript;
         catch (error) {
             throw new Error(`Invalid multisig script: ${error instanceof Error ? error.message : String(error)}`);
         }
-        const absoluteTimelock = MinimalScriptNum.decode(locktime);
+        let absoluteTimelock;
+        if (typeof locktime === "number") {
+            absoluteTimelock = BigInt(locktime);
+        }
+        else {
+            absoluteTimelock = MinimalScriptNum.decode(locktime);
+        }
         const reconstructed = encode({
             absoluteTimelock,
             ...multisig.params,

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/esm/wallet/vtxo-manager.js

@@ -576,6 +576,7 @@ export class VtxoManager {
                                 return;
                             }
                             if (e.message.includes("VTXO_ALREADY_REGISTERED") ||
+                                e.message.includes("VTXO_ALREADY_SPENT") ||
                                 e.message.includes("duplicated input")) {
                                 // VTXO is already being used in a concurrent
                                 // user-initiated operation. Skip silently — the

package/dist/esm/wallet/wallet.js

@@ -10,11 +10,12 @@ import { RestArkProvider, } from '../providers/ark.js';
 import { buildForfeitTx } from '../forfeit.js';
 import { validateConnectorsTxGraph, validateVtxoTxGraph, } from '../tree/validation.js';
 import { validateBatchRecipients } from './validation.js';
+import { isBatchSignable } from '../identity/index.js';
 import { isExpired, isRecoverable, isSpendable, isSubdust, TxType, } from './index.js';
 import { createAssetPacket, selectedCoinsToAssetInputs, selectCoinsWithAsset, } from './asset.js';
 import { VtxoScript } from '../script/base.js';
 import { CSVMultisigTapscript } from '../script/tapscript.js';
-import { buildOffchainTx, hasBoardingTxExpired, isValidArkAddress, } from '../utils/arkTransaction.js';
+import { buildOffchainTx, combineTapscriptSigs, hasBoardingTxExpired, isValidArkAddress, } from '../utils/arkTransaction.js';
 import { DEFAULT_RENEWAL_CONFIG, DEFAULT_SETTLEMENT_CONFIG, VtxoManager, } from './vtxo-manager.js';
 import { ArkNote } from '../arknote/index.js';
 import { Intent } from '../intent/index.js';
@@ -340,6 +341,19 @@ export class ReadonlyWallet {
         }
         const requestStartedAt = Date.now();
         const allVtxos = [];
+        const extendWithScript = (vtxo) => {
+            const vtxoScript = vtxo.script
+                ? scriptMap.get(vtxo.script)
+                : undefined;
+            if (!vtxoScript)
+                return undefined;
+            return {
+                ...vtxo,
+                forfeitTapLeafScript: vtxoScript.forfeit(),
+                intentTapLeafScript: vtxoScript.forfeit(),
+                tapTree: vtxoScript.encode(),
+            };
+        };
         // Full fetch for scripts with no cursor.
         if (bootstrapScripts.length > 0) {
             const response = await this.indexerProvider.getVtxos({
@@ -364,46 +378,76 @@ export class ReadonlyWallet {
         // Extend every fetched VTXO and upsert into the cache.
         const fetchedExtended = [];
         for (const vtxo of allVtxos) {
-            const vtxoScript = vtxo.script
-                ? scriptMap.get(vtxo.script)
-                : undefined;
-            if (!vtxoScript)
-                continue;
-            fetchedExtended.push({
-                ...vtxo,
-                forfeitTapLeafScript: vtxoScript.forfeit(),
-                intentTapLeafScript: vtxoScript.forfeit(),
-                tapTree: vtxoScript.encode(),
-            });
+            const extended = extendWithScript(vtxo);
+            if (extended)
+                fetchedExtended.push(extended);
         }
         // Save VTXOs first, then advance cursors only on success.
         const cutoff = cursorCutoff(requestStartedAt);
         await this.walletRepository.saveVtxos(address, fetchedExtended);
         await advanceSyncCursors(this.walletRepository, Object.fromEntries(allScripts.map((s) => [s, cutoff])));
-        // For delta syncs, reconcile pending (preconfirmed/spent) VTXOs
-        // whose state may have changed since the cursor so that
-        // getVtxos()/getTransactionHistory() don't serve stale state.
+        // Delta-sync reconciliation: full re-fetch for delta scripts.
+        //
+        // The delta fetch (above) only returns VTXOs changed after the
+        // cursor, so it can miss preconfirmed VTXOs that were consumed
+        // by a round between syncs.  Rather than layering targeted
+        // queries (pendingOnly, spendableOnly) with pagination guards
+        // and set algebra, we perform a single unfiltered re-fetch for
+        // delta scripts.  This is slightly more data over the wire but
+        // gives us complete, authoritative state in one call and keeps
+        // the reconciliation logic simple.
+        //
+        // Any cached non-spent VTXO that is absent from the full
+        // result set is marked spent; any VTXO whose state changed
+        // (e.g. preconfirmed → settled) is updated in place.
         if (hasDelta) {
-            const { vtxos: pendingVtxos } = await this.indexerProvider.getVtxos({
+            const { vtxos: fullVtxos, page: fullPage } = await this.indexerProvider.getVtxos({
                 scripts: deltaScripts,
-                pendingOnly: true,
             });
-            const pendingExtended = [];
-            for (const vtxo of pendingVtxos) {
-                const vtxoScript = vtxo.script
-                    ? scriptMap.get(vtxo.script)
-                    : undefined;
-                if (!vtxoScript)
-                    continue;
-                pendingExtended.push({
-                    ...vtxo,
-                    forfeitTapLeafScript: vtxoScript.forfeit(),
-                    intentTapLeafScript: vtxoScript.forfeit(),
-                    tapTree: vtxoScript.encode(),
-                });
+            // Reconciliation is best-effort: if the response is
+            // paginated we don't have a complete picture, so we skip
+            // rather than act on partial data.  Wallets with enough
+            // VTXOs to exceed a single page rely solely on the
+            // cursor-based delta mechanism for state updates.
+            const fullSetComplete = !fullPage || fullPage.total <= 1;
+            if (fullSetComplete) {
+                const fullOutpoints = new Map(fullVtxos.map((v) => [`${v.txid}:${v.vout}`, v]));
+                const deltaScriptSet = new Set(deltaScripts);
+                const cachedVtxos = await this.walletRepository.getVtxos(address);
+                const reconciledExtended = [];
+                for (const cached of cachedVtxos) {
+                    if (!cached.script ||
+                        !deltaScriptSet.has(cached.script) ||
+                        cached.isSpent) {
+                        continue;
+                    }
+                    const outpoint = `${cached.txid}:${cached.vout}`;
+                    const fresh = fullOutpoints.get(outpoint);
+                    if (!fresh) {
+                        // Server no longer knows about this VTXO —
+                        // it was spent between syncs.
+                        reconciledExtended.push({
+                            ...cached,
+                            isSpent: true,
+                        });
+                        continue;
+                    }
+                    const extended = extendWithScript(fresh);
+                    if (extended &&
+                        extended.virtualStatus.state !==
+                            cached.virtualStatus.state) {
+                        // State transitioned (e.g. preconfirmed →
+                        // settled) — update the cached entry.
+                        reconciledExtended.push(extended);
+                    }
+                }
+                if (reconciledExtended.length > 0) {
+                    console.warn(`[ark-sdk] delta sync: reconciled ${reconciledExtended.length} stale VTXO(s) via full re-fetch`);
+                    await this.walletRepository.saveVtxos(address, reconciledExtended);
+                }
             }
-            if (pendingExtended.length > 0) {
-                await this.walletRepository.saveVtxos(address, pendingExtended);
+            else {
+                console.warn("[ark-sdk] delta sync: skipping reconciliation — full re-fetch was paginated");
             }
         }
         return {
@@ -1713,16 +1757,47 @@ export class Wallet extends ReadonlyWallet {
                 tapLeafScript: input.forfeitTapLeafScript,
             };
         }), outputs, this.serverUnrollScript);
-        const signedVirtualTx = await this.identity.sign(offchainTx.arkTx);
+        let signedVirtualTx;
+        let userSignedCheckpoints;
+        if (isBatchSignable(this.identity)) {
+            // Batch-sign arkTx + all checkpoints in one wallet popup.
+            // Clone so the provider can't mutate originals before submitTx.
+            const requests = [
+                { tx: offchainTx.arkTx.clone() },
+                ...offchainTx.checkpoints.map((c) => ({ tx: c.clone() })),
+            ];
+            const signed = await this.identity.signMultiple(requests);
+            if (signed.length !== requests.length) {
+                throw new Error(`signMultiple returned ${signed.length} transactions, expected ${requests.length}`);
+            }
+            const [firstSignedTx, ...signedCheckpoints] = signed;
+            signedVirtualTx = firstSignedTx;
+            userSignedCheckpoints = signedCheckpoints;
+        }
+        else {
+            signedVirtualTx = await this.identity.sign(offchainTx.arkTx);
+        }
         // Mark pending before submitting — if we crash between submit and
         // finalize, the next init will recover via finalizePendingTxs.
         await this.setPendingTxFlag(true);
         const { arkTxid, signedCheckpointTxs } = await this.arkProvider.submitTx(base64.encode(signedVirtualTx.toPSBT()), offchainTx.checkpoints.map((c) => base64.encode(c.toPSBT())));
-        const finalCheckpoints = await Promise.all(signedCheckpointTxs.map(async (c) => {
-            const tx = Transaction.fromPSBT(base64.decode(c));
-            const signedCheckpoint = await this.identity.sign(tx);
-            return base64.encode(signedCheckpoint.toPSBT());
-        }));
+        let finalCheckpoints;
+        if (userSignedCheckpoints) {
+            // Merge pre-signed user signatures onto server-signed checkpoints
+            finalCheckpoints = signedCheckpointTxs.map((c, i) => {
+                const serverSigned = Transaction.fromPSBT(base64.decode(c));
+                combineTapscriptSigs(userSignedCheckpoints[i], serverSigned);
+                return base64.encode(serverSigned.toPSBT());
+            });
+        }
+        else {
+            // Legacy: sign each checkpoint individually (N popups)
+            finalCheckpoints = await Promise.all(signedCheckpointTxs.map(async (c) => {
+                const tx = Transaction.fromPSBT(base64.decode(c));
+                const signedCheckpoint = await this.identity.sign(tx);
+                return base64.encode(signedCheckpoint.toPSBT());
+            }));
+        }
         await this.arkProvider.finalizeTx(arkTxid, finalCheckpoints);
         try {
             await this.setPendingTxFlag(false);

package/dist/types/contracts/handlers/helpers.d.ts

@@ -12,6 +12,16 @@ export declare function sequenceToTimelock(sequence: number): RelativeTimelock;
  * Resolve wallet's role from explicit role or by matching pubkey.
  */
 export declare function resolveRole(contract: Contract, context: PathContext): "sender" | "receiver" | undefined;
+/**
+ * Check if an absolute (CLTV) locktime is currently satisfied.
+ *
+ * Following the BIP65 convention:
+ * - locktime < 500_000_000  → interpreted as a block height; compared against `context.blockHeight`
+ * - locktime >= 500_000_000 → interpreted as a Unix timestamp (seconds); compared against `context.currentTime`
+ *
+ * Returns false if the relevant context field is missing.
+ */
+export declare function isCltvSatisfied(context: PathContext, locktime: bigint): boolean;
 /**
  * Check if a CSV timelock is currently satisfied for the given context/VTXO.
  */

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

@@ -9,5 +9,25 @@ export interface ReadonlyIdentity {
     xOnlyPublicKey(): Promise<Uint8Array>;
     compressedPublicKey(): Promise<Uint8Array>;
 }
+/** A single PSBT signing request within a batch. */
+export interface SignRequest {
+    tx: Transaction;
+    inputIndexes?: number[];
+}
+/**
+ * Identity that supports signing multiple PSBTs in a single wallet interaction.
+ * Browser wallet providers that support batch signing (e.g. Xverse, UniSat, OKX)
+ * should implement this interface to reduce the number of confirmation popups
+ * from N+1 to 1 during Arkade send transactions.
+ *
+ * Contract: implementations MUST return exactly one `Transaction` per request,
+ * in the same order as the input array. The SDK validates this at runtime and
+ * will throw if the lengths do not match.
+ */
+export interface BatchSignableIdentity extends Identity {
+    signMultiple(requests: SignRequest[]): Promise<Transaction[]>;
+}
+/** Type guard for identities that support batch signing. */
+export declare function isBatchSignable(identity: Identity): identity is BatchSignableIdentity;
 export * from "./singleKey";
 export * from "./seedIdentity";

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

@@ -61,7 +61,7 @@ export declare class SeedIdentity implements Identity {
      * @param seed - 64-byte seed (typically from mnemonicToSeedSync)
      * @param opts - Network selection or custom descriptor.
      */
-    static fromSeed(seed: Uint8Array, opts: SeedIdentityOptions): SeedIdentity;
+    static fromSeed(seed: Uint8Array, opts?: SeedIdentityOptions): SeedIdentity;
     xOnlyPublicKey(): Promise<Uint8Array>;
     compressedPublicKey(): Promise<Uint8Array>;
     sign(tx: Transaction, inputIndexes?: number[]): Promise<Transaction>;
@@ -99,7 +99,7 @@ export declare class MnemonicIdentity extends SeedIdentity {
      * @param phrase - BIP39 mnemonic phrase (12 or 24 words)
      * @param opts - Network selection or custom descriptor, plus optional passphrase
      */
-    static fromMnemonic(phrase: string, opts: MnemonicOptions): MnemonicIdentity;
+    static fromMnemonic(phrase: string, opts?: MnemonicOptions): MnemonicIdentity;
 }
 /**
  * Watch-only identity from an output descriptor.

package/dist/types/index.d.ts

@@ -2,7 +2,7 @@ import { Transaction } from "./utils/transaction";
 import { SingleKey, ReadonlySingleKey } from "./identity/singleKey";
 import { SeedIdentity, MnemonicIdentity, ReadonlyDescriptorIdentity } from "./identity/seedIdentity";
 import type { SeedIdentityOptions, MnemonicOptions, NetworkOptions, DescriptorOptions } from "./identity/seedIdentity";
-import { Identity, ReadonlyIdentity } from "./identity";
+import { Identity, ReadonlyIdentity, BatchSignableIdentity, SignRequest, isBatchSignable } from "./identity";
 import { ArkAddress } from "./script/address";
 import { VHTLC } from "./script/vhtlc";
 import { DefaultVtxo } from "./script/default";
@@ -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, isBatchSignable, 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, BatchSignableIdentity, SignRequest, 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,7 +1,7 @@
 {
   "name": "@arkade-os/sdk",
-  "version": "0.4.13",
-  "description": "Bitcoin wallet SDK with Taproot and Ark integration",
+  "version": "0.4.15",
+  "description": "TypeScript SDK for building Bitcoin wallets using the Arkade protocol",
   "type": "module",
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.js",
@@ -80,7 +80,7 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@bitcoinerlab/descriptors-scure": "3.1.4",
+    "@bitcoinerlab/descriptors-scure": "3.1.7",
     "@marcbachmann/cel-js": "7.3.1",
     "@noble/curves": "2.0.1",
     "@noble/secp256k1": "3.0.0",
@@ -130,12 +130,20 @@
     }
   },
   "keywords": [
-    "bitcoin",
-    "wallet",
-    "taproot",
     "ark",
+    "arkade",
+    "bip39",
+    "bitcoin",
+    "btc",
+    "crypto",
+    "lightning",
     "sdk",
-    "arkade"
+    "stablecoin",
+    "taproot",
+    "typescript",
+    "utxo",
+    "vtxo",
+    "wallet"
   ],
   "author": "Ark Labs",
   "license": "MIT",
@@ -159,11 +167,11 @@
     "test:master": "ARK_ENV=master vitest run",
     "test:unit": "vitest run --exclude test/e2e",
     "test:setup": "node test/setup.mjs",
-    "regtest": "pnpm test:down-docker && pnpm test:build-docker && pnpm test:up-docker && pnpm test:setup-docker",
+    "regtest:start": "./regtest/start-env.sh",
+    "regtest:stop": "./regtest/stop-env.sh",
+    "regtest:clean": "./regtest/clean-env.sh",
+    "regtest": "pnpm regtest:clean && pnpm regtest:start && pnpm test:setup-docker",
     "test:setup-docker": "node test/setup.mjs docker",
-    "test:build-docker": "docker compose -f docker-compose.yml build --no-cache",
-    "test:up-docker": "docker compose -f docker-compose.yml up -d",
-    "test:down-docker": "docker compose -f docker-compose.yml down",
     "test:integration": "vitest run test/e2e/**",
     "test:integration-docker": "ARK_ENV=docker vitest run test/e2e/**",
     "test:watch": "vitest",