@arkade-os/sdk 0.3.0-alpha.4 → 0.3.0-alpha.5

package/dist/cjs/providers/onchain.js

@@ -23,6 +23,7 @@ exports.ESPLORA_URL = {
 class EsploraProvider {
     constructor(baseUrl) {
         this.baseUrl = baseUrl;
+        this.polling = false;
     }
     async getCoins(address) {
         const response = await fetch(`${this.baseUrl}/address/${address}/utxo`);
@@ -93,6 +94,9 @@ class EsploraProvider {
         let intervalId = null;
         const wsUrl = this.baseUrl.replace(/^http(s)?:/, "ws$1:") + "/v1/ws";
         const poll = async () => {
+            if (this.polling)
+                return;
+            this.polling = true;
             // websocket is not reliable, so we will fallback to polling
             const pollingInterval = 5000; // 5 seconds
             const getAllTxs = () => {
@@ -102,19 +106,19 @@ class EsploraProvider {
             const initialTxs = await getAllTxs();
             // we use block_time in key to also notify when a transaction is confirmed
             const txKey = (tx) => `${tx.txid}_${tx.status.block_time}`;
+            // create a set of existing transactions to avoid duplicates
+            const existingTxs = new Set(initialTxs.map(txKey));
             // polling for new transactions
             intervalId = setInterval(async () => {
                 try {
                     // get current transactions
                     // we will compare with initialTxs to find new ones
                     const currentTxs = await getAllTxs();
-                    // create a set of existing transactions to avoid duplicates
-                    const existingTxs = new Set(initialTxs.map(txKey));
                     // filter out transactions that are already in initialTxs
                     const newTxs = currentTxs.filter((tx) => !existingTxs.has(txKey(tx)));
                     if (newTxs.length > 0) {
                         // Update the tracking set instead of growing the array
-                        initialTxs.push(...newTxs);
+                        newTxs.forEach((tx) => existingTxs.add(txKey(tx)));
                         callback(newTxs);
                     }
                 }
@@ -175,6 +179,7 @@ class EsploraProvider {
                 ws.close();
             if (intervalId)
                 clearInterval(intervalId);
+            this.polling = false;
         };
         return stopFunc;
     }

package/dist/cjs/repositories/contractRepository.js

@@ -126,5 +126,9 @@ class ContractRepositoryImpl {
             throw error; // Rethrow to notify caller of failure
         }
     }
+    async clearContractData() {
+        await this.storage.clear();
+        this.cache.clear();
+    }
 }
 exports.ContractRepositoryImpl = ContractRepositoryImpl;

package/dist/cjs/repositories/walletRepository.js

@@ -7,8 +7,7 @@ const btc_signer_1 = require("@scure/btc-signer");
 const toHex = (b) => (b ? base_1.hex.encode(b) : undefined);
 const fromHex = (h) => h ? base_1.hex.decode(h) : undefined;
 const serializeTapLeaf = ([cb, s]) => ({
-    cb: btc_signer_1.TaprootControlBlock.encode(cb) &&
-        base_1.hex.encode(btc_signer_1.TaprootControlBlock.encode(cb)),
+    cb: base_1.hex.encode(btc_signer_1.TaprootControlBlock.encode(cb)),
     s: base_1.hex.encode(s),
 });
 const serializeVtxo = (v) => ({
@@ -91,7 +90,7 @@ class WalletRepositoryImpl {
     async removeVtxo(address, vtxoId) {
         const vtxos = await this.getVtxos(address);
         const [txid, vout] = vtxoId.split(":");
-        const filtered = vtxos.filter((v) => !(v.txid === txid && v.vout === parseInt(vout)));
+        const filtered = vtxos.filter((v) => !(v.txid === txid && v.vout === parseInt(vout, 10)));
         this.cache.vtxos.set(address, filtered);
         await this.storage.setItem(`vtxos:${address}`, JSON.stringify(filtered.map(serializeVtxo)));
     }
@@ -122,18 +121,36 @@ class WalletRepositoryImpl {
     }
     async saveTransaction(address, tx) {
         const transactions = await this.getTransactionHistory(address);
-        const existing = transactions.findIndex((t) => t.id === tx.id);
+        const existing = transactions.findIndex((t) => t.key === tx.key);
         if (existing !== -1) {
             transactions[existing] = tx;
         }
         else {
             transactions.push(tx);
-            // Sort by timestamp descending
-            transactions.sort((a, b) => b.timestamp - a.timestamp);
         }
+        // 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) {
+            const existing = storedTransactions.findIndex((t) => t.key === tx.key);
+            if (existing !== -1) {
+                storedTransactions[existing] = tx;
+            }
+            else {
+                storedTransactions.push(tx);
+            }
+        }
+        this.cache.transactions.set(address, storedTransactions);
+        await this.storage.setItem(`tx:${address}`, JSON.stringify(storedTransactions));
+    }
+    async clearTransactions(address) {
+        this.cache.transactions.set(address, []);
+        await this.storage.removeItem(`tx:${address}`);
+    }
     async getWalletState() {
         if (this.cache.walletState !== null ||
             this.cache.initialized.has("walletState")) {

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

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.setupServiceWorker = setupServiceWorker;
+exports.extendVirtualCoin = extendVirtualCoin;
 /**
  * setupServiceWorker sets up the service worker.
  * @param path - the path to the service worker script
@@ -47,3 +48,11 @@ async function setupServiceWorker(path) {
         navigator.serviceWorker.addEventListener("error", onError);
     });
 }
+function extendVirtualCoin(wallet, vtxo) {
+    return {
+        ...vtxo,
+        forfeitTapLeafScript: wallet.offchainTapscript.forfeit(),
+        intentTapLeafScript: wallet.offchainTapscript.exit(),
+        tapTree: wallet.offchainTapscript.encode(),
+    };
+}

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

@@ -13,6 +13,7 @@ const indexer_1 = require("../../providers/indexer");
 const base_1 = require("@scure/base");
 const indexedDB_1 = require("../../storage/indexedDB");
 const walletRepository_1 = require("../../repositories/walletRepository");
+const utils_1 = require("./utils");
 /**
  * Worker is a class letting to interact with ServiceWorkerWallet from the client
  * it aims to be run in a service worker context
@@ -41,7 +42,7 @@ class Worker {
             return [];
         const address = await this.wallet.getAddress();
         const allVtxos = await this.walletRepository.getVtxos(address);
-        return allVtxos.filter((vtxo) => vtxo.virtualStatus.state === "swept" && (0, __1.isSpendable)(vtxo));
+        return allVtxos.filter((vtxo) => vtxo.virtualStatus.state === "swept");
     }
     /**
      * Get all vtxos categorized by type
@@ -72,19 +73,15 @@ class Worker {
         }
     }
     async clear() {
-        if (this.vtxoSubscription) {
-            this.vtxoSubscription.abort();
-        }
+        if (this.incomingFundsSubscription)
+            this.incomingFundsSubscription();
         // Clear storage - this replaces vtxoRepository.close()
         await this.storage.clear();
         this.wallet = undefined;
         this.arkProvider = undefined;
         this.indexerProvider = undefined;
-        this.vtxoSubscription = undefined;
     }
     async reload() {
-        if (this.vtxoSubscription)
-            this.vtxoSubscription.abort();
         await this.onWalletInitialized();
     }
     async onWalletInitialized() {
@@ -95,58 +92,37 @@ class Worker {
             !this.wallet.boardingTapscript) {
             return;
         }
-        const encodedOffchainTapscript = this.wallet.offchainTapscript.encode();
-        const forfeit = this.wallet.offchainTapscript.forfeit();
-        const exit = this.wallet.offchainTapscript.exit();
+        // Get public key script and set the initial vtxos state
         const script = base_1.hex.encode(this.wallet.offchainTapscript.pkScript);
-        // set the initial vtxos state
         const response = await this.indexerProvider.getVtxos({
             scripts: [script],
         });
-        const vtxos = response.vtxos.map((vtxo) => ({
-            ...vtxo,
-            forfeitTapLeafScript: forfeit,
-            intentTapLeafScript: exit,
-            tapTree: encodedOffchainTapscript,
-        }));
+        const vtxos = response.vtxos.map((vtxo) => (0, utils_1.extendVirtualCoin)(this.wallet, vtxo));
         // Get wallet address and save vtxos using unified repository
         const address = await this.wallet.getAddress();
         await this.walletRepository.saveVtxos(address, vtxos);
-        this.processVtxoSubscription({
-            script,
-            vtxoScript: this.wallet.offchainTapscript,
-        });
-    }
-    async processVtxoSubscription({ script, vtxoScript, }) {
-        try {
-            const forfeitTapLeafScript = vtxoScript.forfeit();
-            const intentTapLeafScript = vtxoScript.exit();
-            const abortController = new AbortController();
-            const subscriptionId = await this.indexerProvider.subscribeForScripts([script]);
-            const subscription = this.indexerProvider.getSubscription(subscriptionId, abortController.signal);
-            this.vtxoSubscription = abortController;
-            const tapTree = vtxoScript.encode();
-            for await (const update of subscription) {
-                const vtxos = [...update.newVtxos, ...update.spentVtxos];
-                if (vtxos.length === 0) {
-                    continue;
-                }
-                const extendedVtxos = vtxos.map((vtxo) => ({
-                    ...vtxo,
-                    forfeitTapLeafScript,
-                    intentTapLeafScript,
-                    tapTree,
-                }));
-                // Get wallet address and save vtxos using unified repository
-                const address = await this.wallet.getAddress();
-                await this.walletRepository.saveVtxos(address, extendedVtxos);
-                // Notify all clients about the vtxo update
-                this.sendMessageToAllClients("VTXO_UPDATE", "");
+        // Get transaction history to cache boarding txs
+        const txs = await this.wallet.getTransactionHistory();
+        if (txs)
+            await this.walletRepository.saveTransactions(address, txs);
+        // stop previous subscriptions if any
+        if (this.incomingFundsSubscription)
+            this.incomingFundsSubscription();
+        // subscribe for incoming funds and notify all clients when new funds arrive
+        this.incomingFundsSubscription = await this.wallet.notifyIncomingFunds(async (funds) => {
+            if (funds.type === "vtxo" && funds.vtxos.length > 0) {
+                // extend vtxos with taproot scripts
+                const extendedVtxos = funds.vtxos.map((vtxo) => (0, utils_1.extendVirtualCoin)(this.wallet, vtxo));
+                // save vtxos using unified repository
+                await this.walletRepository.saveVtxos(address, funds.vtxos.map((vtxo) => (0, utils_1.extendVirtualCoin)(this.wallet, vtxo)));
+                // notify all clients about the vtxo update
+                this.sendMessageToAllClients("VTXO_UPDATE", JSON.stringify(extendedVtxos));
             }
-        }
-        catch (error) {
-            console.error("Error processing address updates:", error);
-        }
+            if (funds.type === "utxo" && funds.coins.length > 0) {
+                // notify all clients about the utxo update
+                this.sendMessageToAllClients("UTXO_UPDATE", JSON.stringify(funds.coins));
+            }
+        });
     }
     async handleClear(event) {
         await this.clear();
@@ -374,7 +350,11 @@ class Worker {
                 if (!this.wallet)
                     throw new Error("Wallet not initialized");
                 // exclude subdust is we don't want recoverable
-                vtxos = vtxos.filter((v) => !(0, __1.isSubdust)(v, this.wallet.dustAmount));
+                const dustAmount = this.wallet?.dustAmount;
+                vtxos =
+                    dustAmount == null
+                        ? vtxos
+                        : vtxos.filter((v) => !(0, __1.isSubdust)(v, dustAmount));
             }
             if (message.filter?.withRecoverable) {
                 // get also swept and spendable vtxos

package/dist/cjs/wallet/wallet.js

@@ -60,6 +60,7 @@ const txTree_1 = require("../tree/txTree");
 const inMemory_1 = require("../storage/inMemory");
 const walletRepository_1 = require("../repositories/walletRepository");
 const contractRepository_1 = require("../repositories/contractRepository");
+const utils_1 = require("./serviceWorker/utils");
 /**
  * Main wallet implementation for Bitcoin transactions with Ark protocol support.
  * The wallet does not store any data locally and relies on Ark and onchain
@@ -678,7 +679,7 @@ class Wallet {
                         if (update.newVtxos?.length > 0) {
                             eventCallback({
                                 type: "vtxo",
-                                vtxos: update.newVtxos,
+                                vtxos: update.newVtxos.map((vtxo) => (0, utils_1.extendVirtualCoin)(this, vtxo)),
                             });
                         }
                     }

package/dist/esm/providers/onchain.js

@@ -20,6 +20,7 @@ export const ESPLORA_URL = {
 export class EsploraProvider {
     constructor(baseUrl) {
         this.baseUrl = baseUrl;
+        this.polling = false;
     }
     async getCoins(address) {
         const response = await fetch(`${this.baseUrl}/address/${address}/utxo`);
@@ -90,6 +91,9 @@ export class EsploraProvider {
         let intervalId = null;
         const wsUrl = this.baseUrl.replace(/^http(s)?:/, "ws$1:") + "/v1/ws";
         const poll = async () => {
+            if (this.polling)
+                return;
+            this.polling = true;
             // websocket is not reliable, so we will fallback to polling
             const pollingInterval = 5000; // 5 seconds
             const getAllTxs = () => {
@@ -99,19 +103,19 @@ export class EsploraProvider {
             const initialTxs = await getAllTxs();
             // we use block_time in key to also notify when a transaction is confirmed
             const txKey = (tx) => `${tx.txid}_${tx.status.block_time}`;
+            // create a set of existing transactions to avoid duplicates
+            const existingTxs = new Set(initialTxs.map(txKey));
             // polling for new transactions
             intervalId = setInterval(async () => {
                 try {
                     // get current transactions
                     // we will compare with initialTxs to find new ones
                     const currentTxs = await getAllTxs();
-                    // create a set of existing transactions to avoid duplicates
-                    const existingTxs = new Set(initialTxs.map(txKey));
                     // filter out transactions that are already in initialTxs
                     const newTxs = currentTxs.filter((tx) => !existingTxs.has(txKey(tx)));
                     if (newTxs.length > 0) {
                         // Update the tracking set instead of growing the array
-                        initialTxs.push(...newTxs);
+                        newTxs.forEach((tx) => existingTxs.add(txKey(tx)));
                         callback(newTxs);
                     }
                 }
@@ -172,6 +176,7 @@ export class EsploraProvider {
                 ws.close();
             if (intervalId)
                 clearInterval(intervalId);
+            this.polling = false;
         };
         return stopFunc;
     }

package/dist/esm/repositories/contractRepository.js

@@ -123,4 +123,8 @@ export class ContractRepositoryImpl {
             throw error; // Rethrow to notify caller of failure
         }
     }
+    async clearContractData() {
+        await this.storage.clear();
+        this.cache.clear();
+    }
 }

package/dist/esm/repositories/walletRepository.js

@@ -4,8 +4,7 @@ import { TaprootControlBlock } from "@scure/btc-signer";
 const toHex = (b) => (b ? hex.encode(b) : undefined);
 const fromHex = (h) => h ? hex.decode(h) : undefined;
 const serializeTapLeaf = ([cb, s]) => ({
-    cb: TaprootControlBlock.encode(cb) &&
-        hex.encode(TaprootControlBlock.encode(cb)),
+    cb: hex.encode(TaprootControlBlock.encode(cb)),
     s: hex.encode(s),
 });
 const serializeVtxo = (v) => ({
@@ -88,7 +87,7 @@ export class WalletRepositoryImpl {
     async removeVtxo(address, vtxoId) {
         const vtxos = await this.getVtxos(address);
         const [txid, vout] = vtxoId.split(":");
-        const filtered = vtxos.filter((v) => !(v.txid === txid && v.vout === parseInt(vout)));
+        const filtered = vtxos.filter((v) => !(v.txid === txid && v.vout === parseInt(vout, 10)));
         this.cache.vtxos.set(address, filtered);
         await this.storage.setItem(`vtxos:${address}`, JSON.stringify(filtered.map(serializeVtxo)));
     }
@@ -119,18 +118,36 @@ export class WalletRepositoryImpl {
     }
     async saveTransaction(address, tx) {
         const transactions = await this.getTransactionHistory(address);
-        const existing = transactions.findIndex((t) => t.id === tx.id);
+        const existing = transactions.findIndex((t) => t.key === tx.key);
         if (existing !== -1) {
             transactions[existing] = tx;
         }
         else {
             transactions.push(tx);
-            // Sort by timestamp descending
-            transactions.sort((a, b) => b.timestamp - a.timestamp);
         }
+        // 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) {
+            const existing = storedTransactions.findIndex((t) => t.key === tx.key);
+            if (existing !== -1) {
+                storedTransactions[existing] = tx;
+            }
+            else {
+                storedTransactions.push(tx);
+            }
+        }
+        this.cache.transactions.set(address, storedTransactions);
+        await this.storage.setItem(`tx:${address}`, JSON.stringify(storedTransactions));
+    }
+    async clearTransactions(address) {
+        this.cache.transactions.set(address, []);
+        await this.storage.removeItem(`tx:${address}`);
+    }
     async getWalletState() {
         if (this.cache.walletState !== null ||
             this.cache.initialized.has("walletState")) {

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

@@ -44,3 +44,11 @@ export async function setupServiceWorker(path) {
         navigator.serviceWorker.addEventListener("error", onError);
     });
 }
+export function extendVirtualCoin(wallet, vtxo) {
+    return {
+        ...vtxo,
+        forfeitTapLeafScript: wallet.offchainTapscript.forfeit(),
+        intentTapLeafScript: wallet.offchainTapscript.exit(),
+        tapTree: wallet.offchainTapscript.encode(),
+    };
+}

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

@@ -10,6 +10,7 @@ import { RestIndexerProvider } from '../../providers/indexer.js';
 import { hex } from "@scure/base";
 import { IndexedDBStorageAdapter } from '../../storage/indexedDB.js';
 import { WalletRepositoryImpl, } from '../../repositories/walletRepository.js';
+import { extendVirtualCoin } from './utils.js';
 /**
  * Worker is a class letting to interact with ServiceWorkerWallet from the client
  * it aims to be run in a service worker context
@@ -38,7 +39,7 @@ export class Worker {
             return [];
         const address = await this.wallet.getAddress();
         const allVtxos = await this.walletRepository.getVtxos(address);
-        return allVtxos.filter((vtxo) => vtxo.virtualStatus.state === "swept" && isSpendable(vtxo));
+        return allVtxos.filter((vtxo) => vtxo.virtualStatus.state === "swept");
     }
     /**
      * Get all vtxos categorized by type
@@ -69,19 +70,15 @@ export class Worker {
         }
     }
     async clear() {
-        if (this.vtxoSubscription) {
-            this.vtxoSubscription.abort();
-        }
+        if (this.incomingFundsSubscription)
+            this.incomingFundsSubscription();
         // Clear storage - this replaces vtxoRepository.close()
         await this.storage.clear();
         this.wallet = undefined;
         this.arkProvider = undefined;
         this.indexerProvider = undefined;
-        this.vtxoSubscription = undefined;
     }
     async reload() {
-        if (this.vtxoSubscription)
-            this.vtxoSubscription.abort();
         await this.onWalletInitialized();
     }
     async onWalletInitialized() {
@@ -92,58 +89,37 @@ export class Worker {
             !this.wallet.boardingTapscript) {
             return;
         }
-        const encodedOffchainTapscript = this.wallet.offchainTapscript.encode();
-        const forfeit = this.wallet.offchainTapscript.forfeit();
-        const exit = this.wallet.offchainTapscript.exit();
+        // Get public key script and set the initial vtxos state
         const script = hex.encode(this.wallet.offchainTapscript.pkScript);
-        // set the initial vtxos state
         const response = await this.indexerProvider.getVtxos({
             scripts: [script],
         });
-        const vtxos = response.vtxos.map((vtxo) => ({
-            ...vtxo,
-            forfeitTapLeafScript: forfeit,
-            intentTapLeafScript: exit,
-            tapTree: encodedOffchainTapscript,
-        }));
+        const vtxos = response.vtxos.map((vtxo) => extendVirtualCoin(this.wallet, vtxo));
         // Get wallet address and save vtxos using unified repository
         const address = await this.wallet.getAddress();
         await this.walletRepository.saveVtxos(address, vtxos);
-        this.processVtxoSubscription({
-            script,
-            vtxoScript: this.wallet.offchainTapscript,
-        });
-    }
-    async processVtxoSubscription({ script, vtxoScript, }) {
-        try {
-            const forfeitTapLeafScript = vtxoScript.forfeit();
-            const intentTapLeafScript = vtxoScript.exit();
-            const abortController = new AbortController();
-            const subscriptionId = await this.indexerProvider.subscribeForScripts([script]);
-            const subscription = this.indexerProvider.getSubscription(subscriptionId, abortController.signal);
-            this.vtxoSubscription = abortController;
-            const tapTree = vtxoScript.encode();
-            for await (const update of subscription) {
-                const vtxos = [...update.newVtxos, ...update.spentVtxos];
-                if (vtxos.length === 0) {
-                    continue;
-                }
-                const extendedVtxos = vtxos.map((vtxo) => ({
-                    ...vtxo,
-                    forfeitTapLeafScript,
-                    intentTapLeafScript,
-                    tapTree,
-                }));
-                // Get wallet address and save vtxos using unified repository
-                const address = await this.wallet.getAddress();
-                await this.walletRepository.saveVtxos(address, extendedVtxos);
-                // Notify all clients about the vtxo update
-                this.sendMessageToAllClients("VTXO_UPDATE", "");
+        // Get transaction history to cache boarding txs
+        const txs = await this.wallet.getTransactionHistory();
+        if (txs)
+            await this.walletRepository.saveTransactions(address, txs);
+        // stop previous subscriptions if any
+        if (this.incomingFundsSubscription)
+            this.incomingFundsSubscription();
+        // subscribe for incoming funds and notify all clients when new funds arrive
+        this.incomingFundsSubscription = await this.wallet.notifyIncomingFunds(async (funds) => {
+            if (funds.type === "vtxo" && funds.vtxos.length > 0) {
+                // extend vtxos with taproot scripts
+                const extendedVtxos = funds.vtxos.map((vtxo) => extendVirtualCoin(this.wallet, vtxo));
+                // save vtxos using unified repository
+                await this.walletRepository.saveVtxos(address, funds.vtxos.map((vtxo) => extendVirtualCoin(this.wallet, vtxo)));
+                // notify all clients about the vtxo update
+                this.sendMessageToAllClients("VTXO_UPDATE", JSON.stringify(extendedVtxos));
             }
-        }
-        catch (error) {
-            console.error("Error processing address updates:", error);
-        }
+            if (funds.type === "utxo" && funds.coins.length > 0) {
+                // notify all clients about the utxo update
+                this.sendMessageToAllClients("UTXO_UPDATE", JSON.stringify(funds.coins));
+            }
+        });
     }
     async handleClear(event) {
         await this.clear();
@@ -371,7 +347,11 @@ export class Worker {
                 if (!this.wallet)
                     throw new Error("Wallet not initialized");
                 // exclude subdust is we don't want recoverable
-                vtxos = vtxos.filter((v) => !isSubdust(v, this.wallet.dustAmount));
+                const dustAmount = this.wallet?.dustAmount;
+                vtxos =
+                    dustAmount == null
+                        ? vtxos
+                        : vtxos.filter((v) => !isSubdust(v, dustAmount));
             }
             if (message.filter?.withRecoverable) {
                 // get also swept and spendable vtxos

package/dist/esm/wallet/wallet.js

@@ -23,6 +23,7 @@ import { TxTree } from '../tree/txTree.js';
 import { InMemoryStorageAdapter } from '../storage/inMemory.js';
 import { WalletRepositoryImpl, } from '../repositories/walletRepository.js';
 import { ContractRepositoryImpl, } from '../repositories/contractRepository.js';
+import { extendVirtualCoin } from './serviceWorker/utils.js';
 /**
  * Main wallet implementation for Bitcoin transactions with Ark protocol support.
  * The wallet does not store any data locally and relies on Ark and onchain
@@ -641,7 +642,7 @@ export class Wallet {
                         if (update.newVtxos?.length > 0) {
                             eventCallback({
                                 type: "vtxo",
-                                vtxos: update.newVtxos,
+                                vtxos: update.newVtxos.map((vtxo) => extendVirtualCoin(this, vtxo)),
                             });
                         }
                     }

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

@@ -49,6 +49,7 @@ export interface OnchainProvider {
  */
 export declare class EsploraProvider implements OnchainProvider {
     private baseUrl;
+    private polling;
     constructor(baseUrl: string);
     getCoins(address: string): Promise<Coin[]>;
     getFeeRate(): Promise<number | undefined>;

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

@@ -3,6 +3,7 @@ export interface ContractRepository {
     getContractData<T>(contractId: string, key: string): Promise<T | null>;
     setContractData<T>(contractId: string, key: string, data: T): Promise<void>;
     deleteContractData(contractId: string, key: string): Promise<void>;
+    clearContractData(): Promise<void>;
     getContractCollection<T>(contractType: string): Promise<ReadonlyArray<T>>;
     saveToContractCollection<T, K extends keyof T>(contractType: string, item: T, idField: K): Promise<void>;
     removeFromContractCollection<T, K extends keyof T>(contractType: string, id: T[K], idField: K): Promise<void>;
@@ -17,4 +18,5 @@ export declare class ContractRepositoryImpl implements ContractRepository {
     getContractCollection<T>(contractType: string): Promise<ReadonlyArray<T>>;
     saveToContractCollection<T, K extends keyof T>(contractType: string, item: T, idField: K): Promise<void>;
     removeFromContractCollection<T, K extends keyof T>(contractType: string, id: T[K], idField: K): Promise<void>;
+    clearContractData(): Promise<void>;
 }

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

@@ -1,24 +1,19 @@
 import { StorageAdapter } from "../storage";
-import { ExtendedVirtualCoin } from "../wallet";
+import { ArkTransaction, ExtendedVirtualCoin } from "../wallet";
 export interface WalletState {
     lastSyncTime?: number;
     settings?: Record<string, any>;
 }
-export interface Transaction {
-    id: string;
-    timestamp: number;
-    amount: number;
-    type: "send" | "receive";
-    status: "pending" | "confirmed" | "failed";
-}
 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<Transaction[]>;
-    saveTransaction(address: string, tx: Transaction): 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>;
     saveWalletState(state: WalletState): Promise<void>;
 }
@@ -31,8 +26,10 @@ export declare class WalletRepositoryImpl implements WalletRepository {
     saveVtxos(address: string, vtxos: ExtendedVirtualCoin[]): Promise<void>;
     removeVtxo(address: string, vtxoId: string): Promise<void>;
     clearVtxos(address: string): Promise<void>;
-    getTransactionHistory(address: string): Promise<Transaction[]>;
-    saveTransaction(address: string, tx: Transaction): 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>;
     saveWalletState(state: WalletState): Promise<void>;
 }

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

@@ -1,3 +1,4 @@
+import { ExtendedVirtualCoin, VirtualCoin, Wallet } from "../..";
 /**
  * setupServiceWorker sets up the service worker.
  * @param path - the path to the service worker script
@@ -7,3 +8,4 @@
  * ```
  */
 export declare function setupServiceWorker(path: string): Promise<ServiceWorker>;
+export declare function extendVirtualCoin(wallet: Wallet, vtxo: VirtualCoin): ExtendedVirtualCoin;

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

@@ -7,7 +7,7 @@ export declare class Worker {
     private wallet;
     private arkProvider;
     private indexerProvider;
-    private vtxoSubscription;
+    private incomingFundsSubscription;
     private walletRepository;
     private storage;
     constructor(messageCallback?: (message: ExtendableMessageEvent) => void);
@@ -27,7 +27,6 @@ export declare class Worker {
     clear(): Promise<void>;
     reload(): Promise<void>;
     private onWalletInitialized;
-    private processVtxoSubscription;
     private handleClear;
     private handleInitWallet;
     private handleSettle;

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

@@ -4,7 +4,7 @@ import { Network, NetworkName } from "../networks";
 import { OnchainProvider } from "../providers/onchain";
 import { SettlementEvent, ArkProvider } from "../providers/ark";
 import { Identity } from "../identity";
-import { ArkTransaction, Coin, ExtendedCoin, ExtendedVirtualCoin, GetVtxosFilter, IWallet, SendBitcoinParams, SettleParams, VirtualCoin, WalletBalance, WalletConfig } from ".";
+import { ArkTransaction, Coin, ExtendedCoin, ExtendedVirtualCoin, GetVtxosFilter, IWallet, SendBitcoinParams, SettleParams, WalletBalance, WalletConfig } from ".";
 import { Bytes } from "@scure/btc-signer/utils.js";
 import { CSVMultisigTapscript } from "../script/tapscript";
 import { IndexerProvider } from "../providers/indexer";
@@ -15,7 +15,7 @@ export type IncomingFunds = {
     coins: Coin[];
 } | {
     type: "vtxo";
-    vtxos: VirtualCoin[];
+    vtxos: ExtendedVirtualCoin[];
 };
 /**
  * Main wallet implementation for Bitcoin transactions with Ark protocol support.

package/package.json

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