@arkade-os/sdk 0.3.1-alpha.2 → 0.3.1-alpha.3

package/dist/cjs/index.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Transaction = exports.Unroll = exports.P2A = exports.TxTree = exports.Intent = exports.ContractRepositoryImpl = exports.WalletRepositoryImpl = exports.networks = exports.ArkNote = 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.CLTVMultisigTapscript = exports.ConditionMultisigTapscript = exports.ConditionCSVMultisigTapscript = exports.CSVMultisigTapscript = exports.MultisigTapscript = exports.decodeTapscript = exports.Response = exports.Request = exports.ServiceWorkerWallet = exports.Worker = exports.setupServiceWorker = exports.SettlementEventType = exports.ChainTxType = exports.IndexerTxType = exports.TxType = exports.VHTLC = exports.VtxoScript = exports.DefaultVtxo = exports.ArkAddress = exports.RestIndexerProvider = exports.RestArkProvider = exports.EsploraProvider = exports.ESPLORA_URL = exports.VtxoManager = exports.Ramps = exports.OnchainWallet = exports.SingleKey = exports.Wallet = void 0;
+exports.ArkError = exports.Transaction = exports.Unroll = exports.P2A = exports.TxTree = exports.Intent = exports.ContractRepositoryImpl = exports.WalletRepositoryImpl = exports.networks = exports.ArkNote = 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.CLTVMultisigTapscript = exports.ConditionMultisigTapscript = exports.ConditionCSVMultisigTapscript = exports.CSVMultisigTapscript = exports.MultisigTapscript = exports.decodeTapscript = exports.Response = exports.Request = exports.ServiceWorkerWallet = exports.Worker = exports.setupServiceWorker = exports.SettlementEventType = exports.ChainTxType = exports.IndexerTxType = exports.TxType = exports.VHTLC = exports.VtxoScript = exports.DefaultVtxo = exports.ArkAddress = exports.RestIndexerProvider = exports.RestArkProvider = exports.EsploraProvider = exports.ESPLORA_URL = exports.VtxoManager = exports.Ramps = exports.OnchainWallet = exports.SingleKey = exports.Wallet = void 0;
+exports.maybeArkError = void 0;
 const transaction_js_1 = require("@scure/btc-signer/transaction.js");
 Object.defineProperty(exports, "Transaction", { enumerable: true, get: function () { return transaction_js_1.Transaction; } });
 const singleKey_1 = require("./identity/singleKey");
@@ -80,3 +81,6 @@ const walletRepository_1 = require("./repositories/walletRepository");
 Object.defineProperty(exports, "WalletRepositoryImpl", { enumerable: true, get: function () { return walletRepository_1.WalletRepositoryImpl; } });
 const contractRepository_1 = require("./repositories/contractRepository");
 Object.defineProperty(exports, "ContractRepositoryImpl", { enumerable: true, get: function () { return contractRepository_1.ContractRepositoryImpl; } });
+const errors_1 = require("./providers/errors");
+Object.defineProperty(exports, "ArkError", { enumerable: true, get: function () { return errors_1.ArkError; } });
+Object.defineProperty(exports, "maybeArkError", { enumerable: true, get: function () { return errors_1.maybeArkError; } });

package/dist/cjs/providers/ark.js

@@ -4,6 +4,7 @@ exports.RestArkProvider = exports.SettlementEventType = void 0;
 exports.isFetchTimeoutError = isFetchTimeoutError;
 const base_1 = require("@scure/base");
 const utils_1 = require("./utils");
+const errors_1 = require("./errors");
 var SettlementEventType;
 (function (SettlementEventType) {
     SettlementEventType["BatchStarted"] = "batch_started";
@@ -32,7 +33,8 @@ class RestArkProvider {
         const url = `${this.serverUrl}/v1/info`;
         const response = await fetch(url);
         if (!response.ok) {
-            throw new Error(`Failed to get server info: ${response.statusText}`);
+            const errorText = await response.text();
+            handleError(errorText, `Failed to get server info: ${response.statusText}`);
         }
         const fromServer = await response.json();
         return {
@@ -82,16 +84,7 @@ class RestArkProvider {
         });
         if (!response.ok) {
             const errorText = await response.text();
-            try {
-                const grpcError = JSON.parse(errorText);
-                // gRPC errors usually have a message and code field
-                throw new Error(`Failed to submit virtual transaction: ${grpcError.message || grpcError.error || errorText}`);
-                // eslint-disable-next-line @typescript-eslint/no-unused-vars
-            }
-            catch (_) {
-                // If JSON parse fails, use the raw error text
-                throw new Error(`Failed to submit virtual transaction: ${errorText}`);
-            }
+            handleError(errorText, `Failed to submit virtual transaction: ${errorText}`);
         }
         const data = await response.json();
         return {
@@ -114,7 +107,7 @@ class RestArkProvider {
         });
         if (!response.ok) {
             const errorText = await response.text();
-            throw new Error(`Failed to finalize offchain transaction: ${errorText}`);
+            handleError(errorText, `Failed to finalize offchain transaction: ${errorText}`);
         }
     }
     async registerIntent(intent) {
@@ -133,7 +126,7 @@ class RestArkProvider {
         });
         if (!response.ok) {
             const errorText = await response.text();
-            throw new Error(`Failed to register intent: ${errorText}`);
+            handleError(errorText, `Failed to register intent: ${errorText}`);
         }
         const data = await response.json();
         return data.intentId;
@@ -154,7 +147,7 @@ class RestArkProvider {
         });
         if (!response.ok) {
             const errorText = await response.text();
-            throw new Error(`Failed to delete intent: ${errorText}`);
+            handleError(errorText, `Failed to delete intent: ${errorText}`);
         }
     }
     async confirmRegistration(intentId) {
@@ -170,7 +163,7 @@ class RestArkProvider {
         });
         if (!response.ok) {
             const errorText = await response.text();
-            throw new Error(`Failed to confirm registration: ${errorText}`);
+            handleError(errorText, `Failed to confirm registration: ${errorText}`);
         }
     }
     async submitTreeNonces(batchId, pubkey, nonces) {
@@ -188,7 +181,7 @@ class RestArkProvider {
         });
         if (!response.ok) {
             const errorText = await response.text();
-            throw new Error(`Failed to submit tree nonces: ${errorText}`);
+            handleError(errorText, `Failed to submit tree nonces: ${errorText}`);
         }
     }
     async submitTreeSignatures(batchId, pubkey, signatures) {
@@ -206,7 +199,7 @@ class RestArkProvider {
         });
         if (!response.ok) {
             const errorText = await response.text();
-            throw new Error(`Failed to submit tree signatures: ${errorText}`);
+            handleError(errorText, `Failed to submit tree signatures: ${errorText}`);
         }
     }
     async submitSignedForfeitTxs(signedForfeitTxs, signedCommitmentTx) {
@@ -222,7 +215,8 @@ class RestArkProvider {
             }),
         });
         if (!response.ok) {
-            throw new Error(`Failed to submit forfeit transactions: ${response.statusText}`);
+            const errorText = await response.text();
+            handleError(errorText, `Failed to submit forfeit transactions: ${response.statusText}`);
         }
     }
     async *getEventStream(signal, topics) {
@@ -331,16 +325,7 @@ class RestArkProvider {
         });
         if (!response.ok) {
             const errorText = await response.text();
-            try {
-                const grpcError = JSON.parse(errorText);
-                // gRPC errors usually have a message and code field
-                throw new Error(`Failed to get pending transactions: ${grpcError.message || grpcError.error || errorText}`);
-                // eslint-disable-next-line @typescript-eslint/no-unused-vars
-            }
-            catch (_) {
-                // If JSON parse fails, use the raw error text
-                throw new Error(`Failed to get pending transactions: ${errorText}`);
-            }
+            handleError(errorText, `Failed to get pending transactions: ${errorText}`);
         }
         const data = await response.json();
         return data.pendingTxs;
@@ -524,3 +509,8 @@ function mapVtxo(vtxo) {
         arkTxid: vtxo.arkTxid,
     };
 }
+function handleError(errorText, defaultMessage) {
+    const error = new Error(errorText);
+    const arkError = (0, errors_1.maybeArkError)(error);
+    throw arkError ?? new Error(defaultMessage);
+}

package/dist/cjs/providers/errors.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ArkError = void 0;
+exports.maybeArkError = maybeArkError;
+class ArkError extends Error {
+    constructor(code, message, name, metadata) {
+        super(message);
+        this.code = code;
+        this.message = message;
+        this.name = name;
+        this.metadata = metadata;
+    }
+}
+exports.ArkError = ArkError;
+/**
+ * Try to convert an error to an ArkError class, returning undefined if the error is not an ArkError
+ * @param error - The error to parse
+ * @returns The parsed ArkError, or undefined if the error is not an ArkError
+ */
+function maybeArkError(error) {
+    try {
+        if (!(error instanceof Error))
+            return undefined;
+        const decoded = JSON.parse(error.message);
+        if (!("details" in decoded))
+            return undefined;
+        if (!Array.isArray(decoded.details))
+            return undefined;
+        // search for a valid details object with the correct type
+        for (const details of decoded.details) {
+            if (!("@type" in details))
+                continue;
+            const type = details["@type"];
+            if (type !== "type.googleapis.com/ark.v1.ErrorDetails")
+                continue;
+            if (!("code" in details))
+                continue;
+            const code = details.code;
+            if (!("message" in details))
+                continue;
+            const message = details.message;
+            if (!("name" in details))
+                continue;
+            const name = details.name;
+            let metadata;
+            if ("metadata" in details && isMetadata(details.metadata)) {
+                metadata = details.metadata;
+            }
+            return new ArkError(code, message, name, metadata);
+        }
+        return undefined;
+    }
+    catch (e) {
+        return undefined;
+    }
+}
+function isMetadata(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}

package/dist/cjs/repositories/walletRepository.js

@@ -61,18 +61,6 @@ class WalletRepositoryImpl {
             return [];
         }
     }
-    async saveVtxo(address, vtxo) {
-        const vtxos = await this.getVtxos(address);
-        const existing = vtxos.findIndex((v) => v.txid === vtxo.txid && v.vout === vtxo.vout);
-        if (existing !== -1) {
-            vtxos[existing] = vtxo;
-        }
-        else {
-            vtxos.push(vtxo);
-        }
-        this.cache.vtxos.set(address, vtxos.slice());
-        await this.storage.setItem(`vtxos:${address}`, JSON.stringify(vtxos.map(serializeVtxo)));
-    }
     async saveVtxos(address, vtxos) {
         const storedVtxos = await this.getVtxos(address);
         for (const vtxo of vtxos) {
@@ -119,20 +107,6 @@ class WalletRepositoryImpl {
             return [];
         }
     }
-    async saveTransaction(address, tx) {
-        const transactions = await this.getTransactionHistory(address);
-        const existing = transactions.findIndex((t) => t.key === tx.key);
-        if (existing !== -1) {
-            transactions[existing] = tx;
-        }
-        else {
-            transactions.push(tx);
-        }
-        // Sort by createdAt descending
-        transactions.sort((a, b) => b.createdAt - a.createdAt);
-        this.cache.transactions.set(address, transactions);
-        await this.storage.setItem(`tx:${address}`, JSON.stringify(transactions));
-    }
     async saveTransactions(address, txs) {
         const storedTransactions = await this.getTransactionHistory(address);
         for (const tx of txs) {

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

@@ -1,6 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Response = void 0;
+const base_1 = require("@scure/base");
+function getRandomId() {
+    const randomValue = crypto.getRandomValues(new Uint8Array(16));
+    return base_1.hex.encode(randomValue);
+}
 /**
  * Response is the namespace that contains the response types for the service worker.
  */
@@ -187,4 +192,31 @@ var Response;
         };
     }
     Response.walletReloaded = walletReloaded;
+    function isVtxoUpdate(response) {
+        return response.type === "VTXO_UPDATE";
+    }
+    Response.isVtxoUpdate = isVtxoUpdate;
+    function vtxoUpdate(newVtxos, spentVtxos) {
+        return {
+            type: "VTXO_UPDATE",
+            id: getRandomId(), // spontaneous update, not tied to a request
+            success: true,
+            spentVtxos,
+            newVtxos,
+        };
+    }
+    Response.vtxoUpdate = vtxoUpdate;
+    function isUtxoUpdate(response) {
+        return response.type === "UTXO_UPDATE";
+    }
+    Response.isUtxoUpdate = isUtxoUpdate;
+    function utxoUpdate(coins) {
+        return {
+            type: "UTXO_UPDATE",
+            id: getRandomId(), // spontaneous update, not tied to a request
+            success: true,
+            coins,
+        };
+    }
+    Response.utxoUpdate = utxoUpdate;
 })(Response || (exports.Response = Response = {}));

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

@@ -256,6 +256,9 @@ class ServiceWorkerWallet {
             return new Promise((resolve, reject) => {
                 const messageHandler = (event) => {
                     const response = event.data;
+                    if (response.id !== message.id) {
+                        return;
+                    }
                     if (!response.success) {
                         navigator.serviceWorker.removeEventListener("message", messageHandler);
                         reject(new Error(response.message));

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

@@ -130,11 +130,11 @@ class Worker {
                     ...spentVtxos,
                 ]);
                 // notify all clients about the vtxo update
-                this.sendMessageToAllClients("VTXO_UPDATE", JSON.stringify({ newVtxos, spentVtxos }));
+                this.sendMessageToAllClients(response_1.Response.vtxoUpdate(newVtxos, spentVtxos));
             }
             if (funds.type === "utxo") {
                 // notify all clients about the utxo update
-                this.sendMessageToAllClients("UTXO_UPDATE", JSON.stringify(funds.coins));
+                this.sendMessageToAllClients(response_1.Response.utxoUpdate(funds.coins));
             }
         });
     }
@@ -518,15 +518,12 @@ class Worker {
                 event.source?.postMessage(response_1.Response.error(message.id, "Unknown message type"));
         }
     }
-    async sendMessageToAllClients(type, message) {
+    async sendMessageToAllClients(message) {
         self.clients
             .matchAll({ includeUncontrolled: true, type: "window" })
             .then((clients) => {
             clients.forEach((client) => {
-                client.postMessage({
-                    type,
-                    message,
-                });
+                client.postMessage(message);
             });
         });
     }

package/dist/esm/index.js

@@ -28,6 +28,7 @@ import { P2A } from './utils/anchor.js';
 import { Unroll } from './wallet/unroll.js';
 import { WalletRepositoryImpl } from './repositories/walletRepository.js';
 import { ContractRepositoryImpl } from './repositories/contractRepository.js';
+import { ArkError, maybeArkError } from './providers/errors.js';
 export { 
 // Wallets
 Wallet, SingleKey, OnchainWallet, Ramps, VtxoManager, 
@@ -56,4 +57,6 @@ Intent,
 // TxTree
 TxTree, 
 // Anchor
-P2A, Unroll, Transaction, };
+P2A, Unroll, Transaction, 
+// Errors
+ArkError, maybeArkError, };

package/dist/esm/providers/ark.js

@@ -1,5 +1,6 @@
 import { hex } from "@scure/base";
 import { eventSourceIterator } from './utils.js';
+import { maybeArkError } from './errors.js';
 export var SettlementEventType;
 (function (SettlementEventType) {
     SettlementEventType["BatchStarted"] = "batch_started";
@@ -28,7 +29,8 @@ export class RestArkProvider {
         const url = `${this.serverUrl}/v1/info`;
         const response = await fetch(url);
         if (!response.ok) {
-            throw new Error(`Failed to get server info: ${response.statusText}`);
+            const errorText = await response.text();
+            handleError(errorText, `Failed to get server info: ${response.statusText}`);
         }
         const fromServer = await response.json();
         return {
@@ -78,16 +80,7 @@ export class RestArkProvider {
         });
         if (!response.ok) {
             const errorText = await response.text();
-            try {
-                const grpcError = JSON.parse(errorText);
-                // gRPC errors usually have a message and code field
-                throw new Error(`Failed to submit virtual transaction: ${grpcError.message || grpcError.error || errorText}`);
-                // eslint-disable-next-line @typescript-eslint/no-unused-vars
-            }
-            catch (_) {
-                // If JSON parse fails, use the raw error text
-                throw new Error(`Failed to submit virtual transaction: ${errorText}`);
-            }
+            handleError(errorText, `Failed to submit virtual transaction: ${errorText}`);
         }
         const data = await response.json();
         return {
@@ -110,7 +103,7 @@ export class RestArkProvider {
         });
         if (!response.ok) {
             const errorText = await response.text();
-            throw new Error(`Failed to finalize offchain transaction: ${errorText}`);
+            handleError(errorText, `Failed to finalize offchain transaction: ${errorText}`);
         }
     }
     async registerIntent(intent) {
@@ -129,7 +122,7 @@ export class RestArkProvider {
         });
         if (!response.ok) {
             const errorText = await response.text();
-            throw new Error(`Failed to register intent: ${errorText}`);
+            handleError(errorText, `Failed to register intent: ${errorText}`);
         }
         const data = await response.json();
         return data.intentId;
@@ -150,7 +143,7 @@ export class RestArkProvider {
         });
         if (!response.ok) {
             const errorText = await response.text();
-            throw new Error(`Failed to delete intent: ${errorText}`);
+            handleError(errorText, `Failed to delete intent: ${errorText}`);
         }
     }
     async confirmRegistration(intentId) {
@@ -166,7 +159,7 @@ export class RestArkProvider {
         });
         if (!response.ok) {
             const errorText = await response.text();
-            throw new Error(`Failed to confirm registration: ${errorText}`);
+            handleError(errorText, `Failed to confirm registration: ${errorText}`);
         }
     }
     async submitTreeNonces(batchId, pubkey, nonces) {
@@ -184,7 +177,7 @@ export class RestArkProvider {
         });
         if (!response.ok) {
             const errorText = await response.text();
-            throw new Error(`Failed to submit tree nonces: ${errorText}`);
+            handleError(errorText, `Failed to submit tree nonces: ${errorText}`);
         }
     }
     async submitTreeSignatures(batchId, pubkey, signatures) {
@@ -202,7 +195,7 @@ export class RestArkProvider {
         });
         if (!response.ok) {
             const errorText = await response.text();
-            throw new Error(`Failed to submit tree signatures: ${errorText}`);
+            handleError(errorText, `Failed to submit tree signatures: ${errorText}`);
         }
     }
     async submitSignedForfeitTxs(signedForfeitTxs, signedCommitmentTx) {
@@ -218,7 +211,8 @@ export class RestArkProvider {
             }),
         });
         if (!response.ok) {
-            throw new Error(`Failed to submit forfeit transactions: ${response.statusText}`);
+            const errorText = await response.text();
+            handleError(errorText, `Failed to submit forfeit transactions: ${response.statusText}`);
         }
     }
     async *getEventStream(signal, topics) {
@@ -327,16 +321,7 @@ export class RestArkProvider {
         });
         if (!response.ok) {
             const errorText = await response.text();
-            try {
-                const grpcError = JSON.parse(errorText);
-                // gRPC errors usually have a message and code field
-                throw new Error(`Failed to get pending transactions: ${grpcError.message || grpcError.error || errorText}`);
-                // eslint-disable-next-line @typescript-eslint/no-unused-vars
-            }
-            catch (_) {
-                // If JSON parse fails, use the raw error text
-                throw new Error(`Failed to get pending transactions: ${errorText}`);
-            }
+            handleError(errorText, `Failed to get pending transactions: ${errorText}`);
         }
         const data = await response.json();
         return data.pendingTxs;
@@ -519,3 +504,8 @@ function mapVtxo(vtxo) {
         arkTxid: vtxo.arkTxid,
     };
 }
+function handleError(errorText, defaultMessage) {
+    const error = new Error(errorText);
+    const arkError = maybeArkError(error);
+    throw arkError ?? new Error(defaultMessage);
+}

package/dist/esm/providers/errors.js

@@ -0,0 +1,54 @@
+export class ArkError extends Error {
+    constructor(code, message, name, metadata) {
+        super(message);
+        this.code = code;
+        this.message = message;
+        this.name = name;
+        this.metadata = metadata;
+    }
+}
+/**
+ * Try to convert an error to an ArkError class, returning undefined if the error is not an ArkError
+ * @param error - The error to parse
+ * @returns The parsed ArkError, or undefined if the error is not an ArkError
+ */
+export function maybeArkError(error) {
+    try {
+        if (!(error instanceof Error))
+            return undefined;
+        const decoded = JSON.parse(error.message);
+        if (!("details" in decoded))
+            return undefined;
+        if (!Array.isArray(decoded.details))
+            return undefined;
+        // search for a valid details object with the correct type
+        for (const details of decoded.details) {
+            if (!("@type" in details))
+                continue;
+            const type = details["@type"];
+            if (type !== "type.googleapis.com/ark.v1.ErrorDetails")
+                continue;
+            if (!("code" in details))
+                continue;
+            const code = details.code;
+            if (!("message" in details))
+                continue;
+            const message = details.message;
+            if (!("name" in details))
+                continue;
+            const name = details.name;
+            let metadata;
+            if ("metadata" in details && isMetadata(details.metadata)) {
+                metadata = details.metadata;
+            }
+            return new ArkError(code, message, name, metadata);
+        }
+        return undefined;
+    }
+    catch (e) {
+        return undefined;
+    }
+}
+function isMetadata(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}

package/dist/esm/repositories/walletRepository.js

@@ -58,18 +58,6 @@ export class WalletRepositoryImpl {
             return [];
         }
     }
-    async saveVtxo(address, vtxo) {
-        const vtxos = await this.getVtxos(address);
-        const existing = vtxos.findIndex((v) => v.txid === vtxo.txid && v.vout === vtxo.vout);
-        if (existing !== -1) {
-            vtxos[existing] = vtxo;
-        }
-        else {
-            vtxos.push(vtxo);
-        }
-        this.cache.vtxos.set(address, vtxos.slice());
-        await this.storage.setItem(`vtxos:${address}`, JSON.stringify(vtxos.map(serializeVtxo)));
-    }
     async saveVtxos(address, vtxos) {
         const storedVtxos = await this.getVtxos(address);
         for (const vtxo of vtxos) {
@@ -116,20 +104,6 @@ export class WalletRepositoryImpl {
             return [];
         }
     }
-    async saveTransaction(address, tx) {
-        const transactions = await this.getTransactionHistory(address);
-        const existing = transactions.findIndex((t) => t.key === tx.key);
-        if (existing !== -1) {
-            transactions[existing] = tx;
-        }
-        else {
-            transactions.push(tx);
-        }
-        // Sort by createdAt descending
-        transactions.sort((a, b) => b.createdAt - a.createdAt);
-        this.cache.transactions.set(address, transactions);
-        await this.storage.setItem(`tx:${address}`, JSON.stringify(transactions));
-    }
     async saveTransactions(address, txs) {
         const storedTransactions = await this.getTransactionHistory(address);
         for (const tx of txs) {

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

@@ -1,3 +1,8 @@
+import { hex } from "@scure/base";
+function getRandomId() {
+    const randomValue = crypto.getRandomValues(new Uint8Array(16));
+    return hex.encode(randomValue);
+}
 /**
  * Response is the namespace that contains the response types for the service worker.
  */
@@ -184,4 +189,31 @@ export var Response;
         };
     }
     Response.walletReloaded = walletReloaded;
+    function isVtxoUpdate(response) {
+        return response.type === "VTXO_UPDATE";
+    }
+    Response.isVtxoUpdate = isVtxoUpdate;
+    function vtxoUpdate(newVtxos, spentVtxos) {
+        return {
+            type: "VTXO_UPDATE",
+            id: getRandomId(), // spontaneous update, not tied to a request
+            success: true,
+            spentVtxos,
+            newVtxos,
+        };
+    }
+    Response.vtxoUpdate = vtxoUpdate;
+    function isUtxoUpdate(response) {
+        return response.type === "UTXO_UPDATE";
+    }
+    Response.isUtxoUpdate = isUtxoUpdate;
+    function utxoUpdate(coins) {
+        return {
+            type: "UTXO_UPDATE",
+            id: getRandomId(), // spontaneous update, not tied to a request
+            success: true,
+            coins,
+        };
+    }
+    Response.utxoUpdate = utxoUpdate;
 })(Response || (Response = {}));

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

@@ -253,6 +253,9 @@ export class ServiceWorkerWallet {
             return new Promise((resolve, reject) => {
                 const messageHandler = (event) => {
                     const response = event.data;
+                    if (response.id !== message.id) {
+                        return;
+                    }
                     if (!response.success) {
                         navigator.serviceWorker.removeEventListener("message", messageHandler);
                         reject(new Error(response.message));

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

@@ -127,11 +127,11 @@ export class Worker {
                     ...spentVtxos,
                 ]);
                 // notify all clients about the vtxo update
-                this.sendMessageToAllClients("VTXO_UPDATE", JSON.stringify({ newVtxos, spentVtxos }));
+                this.sendMessageToAllClients(Response.vtxoUpdate(newVtxos, spentVtxos));
             }
             if (funds.type === "utxo") {
                 // notify all clients about the utxo update
-                this.sendMessageToAllClients("UTXO_UPDATE", JSON.stringify(funds.coins));
+                this.sendMessageToAllClients(Response.utxoUpdate(funds.coins));
             }
         });
     }
@@ -515,15 +515,12 @@ export class Worker {
                 event.source?.postMessage(Response.error(message.id, "Unknown message type"));
         }
     }
-    async sendMessageToAllClients(type, message) {
+    async sendMessageToAllClients(message) {
         self.clients
             .matchAll({ includeUncontrolled: true, type: "window" })
             .then((clients) => {
             clients.forEach((client) => {
-                client.postMessage({
-                    type,
-                    message,
-                });
+                client.postMessage(message);
             });
         });
     }

package/dist/types/index.d.ts

@@ -32,5 +32,6 @@ import { AnchorBumper, P2A } from "./utils/anchor";
 import { Unroll } from "./wallet/unroll";
 import { WalletRepositoryImpl } from "./repositories/walletRepository";
 import { ContractRepositoryImpl } from "./repositories/contractRepository";
-export { Wallet, SingleKey, OnchainWallet, Ramps, VtxoManager, ESPLORA_URL, EsploraProvider, RestArkProvider, RestIndexerProvider, ArkAddress, DefaultVtxo, VtxoScript, VHTLC, TxType, IndexerTxType, ChainTxType, SettlementEventType, setupServiceWorker, Worker, ServiceWorkerWallet, Request, Response, decodeTapscript, MultisigTapscript, CSVMultisigTapscript, ConditionCSVMultisigTapscript, ConditionMultisigTapscript, CLTVMultisigTapscript, ArkPsbtFieldKey, ArkPsbtFieldKeyType, setArkPsbtField, getArkPsbtFields, CosignerPublicKey, VtxoTreeExpiry, VtxoTaprootTree, ConditionWitness, buildOffchainTx, verifyTapscriptSignatures, waitForIncomingFunds, hasBoardingTxExpired, ArkNote, networks, WalletRepositoryImpl, ContractRepositoryImpl, Intent, TxTree, P2A, Unroll, Transaction, };
+import { ArkError, maybeArkError } from "./providers/errors";
+export { Wallet, SingleKey, OnchainWallet, Ramps, VtxoManager, ESPLORA_URL, EsploraProvider, RestArkProvider, RestIndexerProvider, ArkAddress, DefaultVtxo, VtxoScript, VHTLC, TxType, IndexerTxType, ChainTxType, SettlementEventType, setupServiceWorker, Worker, ServiceWorkerWallet, Request, Response, decodeTapscript, MultisigTapscript, CSVMultisigTapscript, ConditionCSVMultisigTapscript, ConditionMultisigTapscript, CLTVMultisigTapscript, ArkPsbtFieldKey, ArkPsbtFieldKeyType, setArkPsbtField, getArkPsbtFields, CosignerPublicKey, VtxoTreeExpiry, VtxoTaprootTree, ConditionWitness, buildOffchainTx, verifyTapscriptSignatures, waitForIncomingFunds, hasBoardingTxExpired, ArkNote, networks, WalletRepositoryImpl, ContractRepositoryImpl, Intent, TxTree, P2A, Unroll, Transaction, ArkError, maybeArkError, };
 export type { Identity, IWallet, WalletConfig, ProviderClass, ArkTransaction, Coin, ExtendedCoin, ExtendedVirtualCoin, WalletBalance, SendBitcoinParams, Recipient, SettleParams, Status, VirtualStatus, Outpoint, VirtualCoin, TxKey, TapscriptType, ArkTxInput, OffchainTx, TapLeaves, IncomingFunds, IndexerProvider, PageResponse, Batch, ChainTx, CommitmentTx, TxHistoryRecord, Vtxo, VtxoChain, Tx, OnchainProvider, ArkProvider, SettlementEvent, 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, Nonces, PartialSig, ArkPsbtFieldCoder, TxTreeNode, AnchorBumper, };

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

@@ -0,0 +1,13 @@
+export declare class ArkError extends Error {
+    readonly code: number;
+    readonly message: string;
+    readonly name: string;
+    readonly metadata?: Record<string, string> | undefined;
+    constructor(code: number, message: string, name: string, metadata?: Record<string, string> | undefined);
+}
+/**
+ * Try to convert an error to an ArkError class, returning undefined if the error is not an ArkError
+ * @param error - The error to parse
+ * @returns The parsed ArkError, or undefined if the error is not an ArkError
+ */
+export declare function maybeArkError(error: any): ArkError | undefined;

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

@@ -6,12 +6,10 @@ export interface WalletState {
 }
 export interface WalletRepository {
     getVtxos(address: string): Promise<ExtendedVirtualCoin[]>;
-    saveVtxo(address: string, vtxo: ExtendedVirtualCoin): Promise<void>;
     saveVtxos(address: string, vtxos: ExtendedVirtualCoin[]): Promise<void>;
     removeVtxo(address: string, vtxoId: string): Promise<void>;
     clearVtxos(address: string): Promise<void>;
     getTransactionHistory(address: string): Promise<ArkTransaction[]>;
-    saveTransaction(address: string, tx: ArkTransaction): Promise<void>;
     saveTransactions(address: string, txs: ArkTransaction[]): Promise<void>;
     clearTransactions(address: string): Promise<void>;
     getWalletState(): Promise<WalletState | null>;
@@ -22,12 +20,10 @@ export declare class WalletRepositoryImpl implements WalletRepository {
     private cache;
     constructor(storage: StorageAdapter);
     getVtxos(address: string): Promise<ExtendedVirtualCoin[]>;
-    saveVtxo(address: string, vtxo: ExtendedVirtualCoin): Promise<void>;
     saveVtxos(address: string, vtxos: ExtendedVirtualCoin[]): Promise<void>;
     removeVtxo(address: string, vtxoId: string): Promise<void>;
     clearVtxos(address: string): Promise<void>;
     getTransactionHistory(address: string): Promise<ArkTransaction[]>;
-    saveTransaction(address: string, tx: ArkTransaction): Promise<void>;
     saveTransactions(address: string, txs: ArkTransaction[]): Promise<void>;
     clearTransactions(address: string): Promise<void>;
     getWalletState(): Promise<WalletState | null>;

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

@@ -1,10 +1,11 @@
-import { WalletBalance, VirtualCoin, ArkTransaction, IWallet } from "..";
+import { WalletBalance, VirtualCoin, ArkTransaction, IWallet, Coin } from "..";
+import { ExtendedVirtualCoin } from "../..";
 import { SettlementEvent } from "../../providers/ark";
 /**
  * Response is the namespace that contains the response types for the service worker.
  */
 export declare namespace Response {
-    type Type = "WALLET_INITIALIZED" | "WALLET_RELOADED" | "SETTLE_EVENT" | "SETTLE_SUCCESS" | "ADDRESS" | "BOARDING_ADDRESS" | "BALANCE" | "VTXOS" | "VIRTUAL_COINS" | "BOARDING_UTXOS" | "SEND_BITCOIN_SUCCESS" | "TRANSACTION_HISTORY" | "WALLET_STATUS" | "ERROR" | "CLEAR_RESPONSE";
+    type Type = "WALLET_INITIALIZED" | "WALLET_RELOADED" | "SETTLE_EVENT" | "SETTLE_SUCCESS" | "ADDRESS" | "BOARDING_ADDRESS" | "BALANCE" | "VTXOS" | "VIRTUAL_COINS" | "BOARDING_UTXOS" | "SEND_BITCOIN_SUCCESS" | "TRANSACTION_HISTORY" | "WALLET_STATUS" | "ERROR" | "CLEAR_RESPONSE" | "VTXO_UPDATE" | "UTXO_UPDATE";
     interface Base {
         type: Type;
         success: boolean;
@@ -106,4 +107,17 @@ export declare namespace Response {
     }
     function isWalletReloaded(response: Base): response is WalletReloaded;
     function walletReloaded(id: string, success: boolean): WalletReloaded;
+    interface VtxoUpdate extends Base {
+        type: "VTXO_UPDATE";
+        spentVtxos: ExtendedVirtualCoin[];
+        newVtxos: ExtendedVirtualCoin[];
+    }
+    function isVtxoUpdate(response: Base): response is VtxoUpdate;
+    function vtxoUpdate(newVtxos: ExtendedVirtualCoin[], spentVtxos: ExtendedVirtualCoin[]): VtxoUpdate;
+    interface UtxoUpdate extends Base {
+        type: "UTXO_UPDATE";
+        coins: Coin[];
+    }
+    function isUtxoUpdate(response: Base): response is UtxoUpdate;
+    function utxoUpdate(coins: Coin[]): UtxoUpdate;
 }

package/package.json

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