@arkade-os/sdk 0.0.16 → 0.1.1

package/README.md

@@ -1,7 +1,5 @@
-# Ark Wallet SDK
-The Ark Wallet SDK is a TypeScript library for building Bitcoin wallets with support for both on-chain and off-chain transactions via Ark protocol.
-
-![v3](https://github.com/user-attachments/assets/bec6fd29-417d-46af-8216-709edc39d566)
+# Arkade TypeScript SDK
+The Arkade SDK is a TypeScript library for building Bitcoin wallets with support for both on-chain and off-chain transactions via the Ark protocol.
 
 ## Installation
 
@@ -92,6 +90,16 @@ console.log('History:', history)
 }
 ```
 
+### Unilateral Exit
+
+```typescript
+// Unilateral exit all vtxos
+await wallet.exit();
+
+// Unilateral exit a specific vtxo
+await wallet.exit([{ txid: vtxo.txid, vout: vtxo.vout }]);
+```
+
 ### Running the wallet in a service worker
 
 1. Create a service worker file

package/dist/cjs/providers/ark.js

@@ -40,6 +40,23 @@ class RestArkProvider {
             spentVtxos: [...(data.spentVtxos || [])].map(convertVtxo),
         };
     }
+    async getRound(txid) {
+        const url = `${this.serverUrl}/v1/round/${txid}`;
+        const response = await fetch(url);
+        if (!response.ok) {
+            throw new Error(`Failed to fetch round: ${response.statusText}`);
+        }
+        const data = (await response.json());
+        const round = data.round;
+        return {
+            id: round.id,
+            start: new Date(Number(round.start) * 1000), // Convert from Unix timestamp to Date
+            end: new Date(Number(round.end) * 1000), // Convert from Unix timestamp to Date
+            vtxoTree: this.toTxTree(round.vtxoTree),
+            forfeitTxs: round.forfeitTxs || [],
+            connectors: this.toTxTree(round.connectors),
+        };
+    }
     async submitVirtualTx(psbtBase64) {
         const url = `${this.serverUrl}/v1/redeem-tx`;
         const response = await fetch(url, {

package/dist/cjs/providers/onchain.js

@@ -57,5 +57,17 @@ class EsploraProvider {
         }
         return response.json();
     }
+    async getTxStatus(txid) {
+        const response = await fetch(`${this.baseUrl}/tx/${txid}/status`);
+        if (!response.ok) {
+            throw new Error(`Failed to get transaction status: ${response.statusText}`);
+        }
+        const data = await response.json();
+        return {
+            confirmed: data.confirmed,
+            blockTime: data.block_time,
+            blockHeight: data.block_height,
+        };
+    }
 }
 exports.EsploraProvider = EsploraProvider;

package/dist/cjs/tree/vtxoTree.js

@@ -111,6 +111,11 @@ class TxTree {
         }
         return branch;
     }
+    // Returns the remaining transactions to broadcast in order to exit the vtxo
+    async exitBranch(vtxoTxid, isTxConfirmed) {
+        const offchainPart = await getOffchainPart(this.branch(vtxoTxid), isTxConfirmed);
+        return offchainPart.map(getExitTransaction);
+    }
     // Helper method to find parent of a node
     findParent(node) {
         for (const level of this.tree) {
@@ -195,3 +200,32 @@ function getCosignerKeys(tx) {
     }
     return keys;
 }
+async function getOffchainPart(branch, isTxConfirmed) {
+    let offchainPath = [...branch];
+    // Iterate from the end of the branch (leaf) to the beginning (root)
+    for (let i = branch.length - 1; i >= 0; i--) {
+        const node = branch[i];
+        // check if the transaction is confirmed on-chain
+        if (await isTxConfirmed(node.txid)) {
+            // if this is the leaf node, return empty array as everything is confirmed
+            if (i === branch.length - 1) {
+                return [];
+            }
+            // otherwise, return the unconfirmed part of the branch
+            return branch.slice(i + 1);
+        }
+    }
+    // no confirmation: everything is offchain
+    return offchainPath;
+}
+// getExitTransaction finalizes the psbt's input using the musig2 tapkey signature
+function getExitTransaction(treeNode) {
+    const tx = btc_signer_1.Transaction.fromPSBT(base_1.base64.decode(treeNode.tx));
+    const input = tx.getInput(0);
+    if (!input.tapKeySig)
+        throw new TxTreeError("missing tapkey signature");
+    const rawTx = btc_signer_1.RawTx.decode(tx.unsignedTx);
+    rawTx.witnesses = [[input.tapKeySig]];
+    rawTx.segwitFlag = true;
+    return base_1.hex.encode(btc_signer_1.RawTx.encode(rawTx));
+}

package/dist/cjs/utils/psbt.js

@@ -43,16 +43,25 @@ function addConditionWitness(inIndex, tx, witness) {
     });
 }
 function createVirtualTx(inputs, outputs) {
-    let lockTime;
+    let lockTime = 0n;
     for (const input of inputs) {
         const tapscript = (0, tapscript_1.decodeTapscript)((0, base_1.scriptFromTapLeafScript)(input.tapLeafScript));
         if (tapscript_1.CLTVMultisigTapscript.is(tapscript)) {
-            lockTime = Number(tapscript.params.absoluteTimelock);
+            if (lockTime !== 0n) {
+                // if a locktime is already set, check if the new locktime is in the same unit
+                if (isSeconds(lockTime) !==
+                    isSeconds(tapscript.params.absoluteTimelock)) {
+                    throw new Error("cannot mix seconds and blocks locktime");
+                }
+            }
+            if (tapscript.params.absoluteTimelock > lockTime) {
+                lockTime = tapscript.params.absoluteTimelock;
+            }
         }
     }
     const tx = new btc_signer_1.Transaction({
         allowUnknown: true,
-        lockTime,
+        lockTime: Number(lockTime),
     });
     for (const [i, input] of inputs.entries()) {
         tx.addInput({
@@ -122,3 +131,7 @@ function encodeCompactSizeUint(value) {
         return buffer;
     }
 }
+const nLocktimeMinSeconds = 500000000n;
+function isSeconds(locktime) {
+    return locktime >= nLocktimeMinSeconds;
+}

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

@@ -72,4 +72,8 @@ var Request;
         return message.type === "GET_STATUS";
     }
     Request.isGetStatus = isGetStatus;
+    function isExit(message) {
+        return message.type === "EXIT";
+    }
+    Request.isExit = isExit;
 })(Request || (exports.Request = Request = {}));

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

@@ -184,4 +184,12 @@ var Response;
         };
     }
     Response.clearResponse = clearResponse;
+    function exitSuccess(id) {
+        return {
+            type: "EXIT_SUCCESS",
+            success: true,
+            id,
+        };
+    }
+    Response.exitSuccess = exitSuccess;
 })(Response || (exports.Response = Response = {}));

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

@@ -82,20 +82,17 @@ class ServiceWorkerWallet {
             registration = await navigator.serviceWorker.register(path);
             // Handle updates
             registration.addEventListener("updatefound", () => {
-                console.info("@arklabs/wallet-sdk: Service worker auto-update...");
                 const newWorker = registration.installing;
                 if (!newWorker)
                     return;
                 newWorker.addEventListener("statechange", () => {
-                    if (newWorker.state === "installed" &&
+                    if (newWorker.state === "activated" &&
                         navigator.serviceWorker.controller) {
-                        console.info("@arklabs/wallet-sdk: Service worker updated, reloading...");
+                        console.info("Service worker activated, reloading...");
                         window.location.reload();
                     }
                 });
             });
-            // Check for updates
-            await registration.update();
             const sw = registration.active ||
                 registration.waiting ||
                 registration.installing;
@@ -324,6 +321,23 @@ class ServiceWorkerWallet {
             throw new Error(`Failed to get transaction history: ${error}`);
         }
     }
+    async exit(outpoints) {
+        const message = {
+            type: "EXIT",
+            outpoints,
+            id: getRandomId(),
+        };
+        try {
+            const response = await this.sendMessage(message);
+            if (response.type === "EXIT_SUCCESS") {
+                return;
+            }
+            throw new UnexpectedResponseError(response);
+        }
+        catch (error) {
+            throw new Error(`Failed to exit: ${error}`);
+        }
+    }
 }
 exports.ServiceWorkerWallet = ServiceWorkerWallet;
 function getRandomId() {

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

@@ -17,10 +17,20 @@ class Worker {
         this.vtxoRepository = vtxoRepository;
         this.messageCallback = messageCallback;
     }
-    async start() {
+    async start(withServiceWorkerUpdate = true) {
         self.addEventListener("message", async (event) => {
             await this.handleMessage(event);
         });
+        if (withServiceWorkerUpdate) {
+            // activate service worker immediately
+            self.addEventListener("install", () => {
+                self.skipWaiting();
+            });
+            // take control of clients immediately
+            self.addEventListener("activate", () => {
+                self.clients.claim();
+            });
+        }
     }
     async clear() {
         if (this.vtxoSubscription) {
@@ -387,6 +397,30 @@ class Worker {
         }
         event.source?.postMessage(response_1.Response.walletStatus(message.id, this.wallet !== undefined));
     }
+    async handleExit(event) {
+        const message = event.data;
+        if (!request_1.Request.isExit(message)) {
+            console.error("Invalid EXIT message format", message);
+            event.source?.postMessage(response_1.Response.error(message.id, "Invalid EXIT message format"));
+            return;
+        }
+        if (!this.wallet) {
+            console.error("Wallet not initialized");
+            event.source?.postMessage(response_1.Response.error(message.id, "Wallet not initialized"));
+            return;
+        }
+        try {
+            await this.wallet.exit(message.outpoints);
+            event.source?.postMessage(response_1.Response.exitSuccess(message.id));
+        }
+        catch (error) {
+            console.error("Error exiting:", error);
+            const errorMessage = error instanceof Error
+                ? error.message
+                : "Unknown error occurred";
+            event.source?.postMessage(response_1.Response.error(message.id, errorMessage));
+        }
+    }
     async handleMessage(event) {
         this.messageCallback(event);
         const message = event.data;
@@ -440,6 +474,10 @@ class Worker {
                 await this.handleGetStatus(event);
                 break;
             }
+            case "EXIT": {
+                await this.handleExit(event);
+                break;
+            }
             case "CLEAR": {
                 await this.handleClear(event);
                 break;

package/dist/cjs/wallet/wallet.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Wallet = void 0;
 const base_1 = require("@scure/base");
 const payment_1 = require("@scure/btc-signer/payment");
+const btc_signer_1 = require("@scure/btc-signer");
 const psbt_1 = require("@scure/btc-signer/psbt");
 const transactionHistory_1 = require("../utils/transactionHistory");
 const bip21_1 = require("../utils/bip21");
@@ -19,7 +20,6 @@ const _1 = require(".");
 const base_2 = require("../script/base");
 const tapscript_1 = require("../script/tapscript");
 const psbt_2 = require("../utils/psbt");
-const btc_signer_1 = require("@scure/btc-signer");
 const arknote_1 = require("../arknote");
 // Wallet does not store any data and rely on the Ark and onchain providers to fetch utxos and vtxos
 class Wallet {
@@ -369,7 +369,6 @@ class Wallet {
                     amount: BigInt(input.value),
                 },
                 tapInternalKey: this.onchainP2TR.tapInternalKey,
-                tapMerkleRoot: this.onchainP2TR.tapMerkleRoot,
             });
         }
         // Add payment output
@@ -585,6 +584,48 @@ class Wallet {
         }
         throw new Error("Settlement failed");
     }
+    async exit(outpoints) {
+        // TODO store the exit branches in repository
+        // exit should not depend on the ark provider
+        if (!this.arkProvider) {
+            throw new Error("Ark provider not configured");
+        }
+        let vtxos = await this.getVtxos();
+        if (outpoints && outpoints.length > 0) {
+            vtxos = vtxos.filter((vtxo) => outpoints.some((outpoint) => vtxo.txid === outpoint.txid &&
+                vtxo.vout === outpoint.vout));
+        }
+        if (vtxos.length === 0) {
+            throw new Error("No vtxos to exit");
+        }
+        const trees = new Map();
+        const transactions = [];
+        for (const vtxo of vtxos) {
+            const batchTxid = vtxo.virtualStatus.batchTxID;
+            if (!batchTxid)
+                continue;
+            if (!trees.has(batchTxid)) {
+                const round = await this.arkProvider.getRound(batchTxid);
+                trees.set(batchTxid, round.vtxoTree);
+            }
+            const tree = trees.get(batchTxid);
+            if (!tree) {
+                throw new Error("Tree not found");
+            }
+            const exitBranch = await tree.exitBranch(vtxo.txid, async (txid) => {
+                const status = await this.onchainProvider.getTxStatus(txid);
+                return status.confirmed;
+            });
+            transactions.push(...exitBranch);
+        }
+        const broadcastedTxs = new Map();
+        for (const tx of transactions) {
+            if (broadcastedTxs.has(tx))
+                continue;
+            const txid = await this.onchainProvider.broadcastTransaction(tx);
+            broadcastedTxs.set(txid, true);
+        }
+    }
     // validates the vtxo tree, creates a signing session and generates the musig2 nonces
     async handleSettlementSigningEvent(event, sweepTapTreeRoot, session) {
         const vtxoTree = event.unsignedVtxoTree;

package/dist/esm/providers/ark.js

@@ -37,6 +37,23 @@ export class RestArkProvider {
             spentVtxos: [...(data.spentVtxos || [])].map(convertVtxo),
         };
     }
+    async getRound(txid) {
+        const url = `${this.serverUrl}/v1/round/${txid}`;
+        const response = await fetch(url);
+        if (!response.ok) {
+            throw new Error(`Failed to fetch round: ${response.statusText}`);
+        }
+        const data = (await response.json());
+        const round = data.round;
+        return {
+            id: round.id,
+            start: new Date(Number(round.start) * 1000), // Convert from Unix timestamp to Date
+            end: new Date(Number(round.end) * 1000), // Convert from Unix timestamp to Date
+            vtxoTree: this.toTxTree(round.vtxoTree),
+            forfeitTxs: round.forfeitTxs || [],
+            connectors: this.toTxTree(round.connectors),
+        };
+    }
     async submitVirtualTx(psbtBase64) {
         const url = `${this.serverUrl}/v1/redeem-tx`;
         const response = await fetch(url, {

package/dist/esm/providers/onchain.js

@@ -54,4 +54,16 @@ export class EsploraProvider {
         }
         return response.json();
     }
+    async getTxStatus(txid) {
+        const response = await fetch(`${this.baseUrl}/tx/${txid}/status`);
+        if (!response.ok) {
+            throw new Error(`Failed to get transaction status: ${response.statusText}`);
+        }
+        const data = await response.json();
+        return {
+            confirmed: data.confirmed,
+            blockTime: data.block_time,
+            blockHeight: data.block_height,
+        };
+    }
 }

package/dist/esm/tree/vtxoTree.js

@@ -1,5 +1,5 @@
 import * as bip68 from "bip68";
-import { ScriptNum, Transaction } from "@scure/btc-signer";
+import { RawTx, ScriptNum, Transaction } from "@scure/btc-signer";
 import { sha256x2 } from "@scure/btc-signer/utils";
 import { base64, hex } from "@scure/base";
 export class TxTreeError extends Error {
@@ -72,6 +72,11 @@ export class TxTree {
         }
         return branch;
     }
+    // Returns the remaining transactions to broadcast in order to exit the vtxo
+    async exitBranch(vtxoTxid, isTxConfirmed) {
+        const offchainPart = await getOffchainPart(this.branch(vtxoTxid), isTxConfirmed);
+        return offchainPart.map(getExitTransaction);
+    }
     // Helper method to find parent of a node
     findParent(node) {
         for (const level of this.tree) {
@@ -155,3 +160,32 @@ export function getCosignerKeys(tx) {
     }
     return keys;
 }
+async function getOffchainPart(branch, isTxConfirmed) {
+    let offchainPath = [...branch];
+    // Iterate from the end of the branch (leaf) to the beginning (root)
+    for (let i = branch.length - 1; i >= 0; i--) {
+        const node = branch[i];
+        // check if the transaction is confirmed on-chain
+        if (await isTxConfirmed(node.txid)) {
+            // if this is the leaf node, return empty array as everything is confirmed
+            if (i === branch.length - 1) {
+                return [];
+            }
+            // otherwise, return the unconfirmed part of the branch
+            return branch.slice(i + 1);
+        }
+    }
+    // no confirmation: everything is offchain
+    return offchainPath;
+}
+// getExitTransaction finalizes the psbt's input using the musig2 tapkey signature
+function getExitTransaction(treeNode) {
+    const tx = Transaction.fromPSBT(base64.decode(treeNode.tx));
+    const input = tx.getInput(0);
+    if (!input.tapKeySig)
+        throw new TxTreeError("missing tapkey signature");
+    const rawTx = RawTx.decode(tx.unsignedTx);
+    rawTx.witnesses = [[input.tapKeySig]];
+    rawTx.segwitFlag = true;
+    return hex.encode(RawTx.encode(rawTx));
+}

package/dist/esm/utils/psbt.js

@@ -37,16 +37,25 @@ export function addConditionWitness(inIndex, tx, witness) {
     });
 }
 export function createVirtualTx(inputs, outputs) {
-    let lockTime;
+    let lockTime = 0n;
     for (const input of inputs) {
         const tapscript = decodeTapscript(scriptFromTapLeafScript(input.tapLeafScript));
         if (CLTVMultisigTapscript.is(tapscript)) {
-            lockTime = Number(tapscript.params.absoluteTimelock);
+            if (lockTime !== 0n) {
+                // if a locktime is already set, check if the new locktime is in the same unit
+                if (isSeconds(lockTime) !==
+                    isSeconds(tapscript.params.absoluteTimelock)) {
+                    throw new Error("cannot mix seconds and blocks locktime");
+                }
+            }
+            if (tapscript.params.absoluteTimelock > lockTime) {
+                lockTime = tapscript.params.absoluteTimelock;
+            }
         }
     }
     const tx = new Transaction({
         allowUnknown: true,
-        lockTime,
+        lockTime: Number(lockTime),
     });
     for (const [i, input] of inputs.entries()) {
         tx.addInput({
@@ -116,3 +125,7 @@ function encodeCompactSizeUint(value) {
         return buffer;
     }
 }
+const nLocktimeMinSeconds = 500000000n;
+function isSeconds(locktime) {
+    return locktime >= nLocktimeMinSeconds;
+}

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

@@ -69,4 +69,8 @@ export var Request;
         return message.type === "GET_STATUS";
     }
     Request.isGetStatus = isGetStatus;
+    function isExit(message) {
+        return message.type === "EXIT";
+    }
+    Request.isExit = isExit;
 })(Request || (Request = {}));

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

@@ -181,4 +181,12 @@ export var Response;
         };
     }
     Response.clearResponse = clearResponse;
+    function exitSuccess(id) {
+        return {
+            type: "EXIT_SUCCESS",
+            success: true,
+            id,
+        };
+    }
+    Response.exitSuccess = exitSuccess;
 })(Response || (Response = {}));

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

@@ -79,20 +79,17 @@ export class ServiceWorkerWallet {
             registration = await navigator.serviceWorker.register(path);
             // Handle updates
             registration.addEventListener("updatefound", () => {
-                console.info("@arklabs/wallet-sdk: Service worker auto-update...");
                 const newWorker = registration.installing;
                 if (!newWorker)
                     return;
                 newWorker.addEventListener("statechange", () => {
-                    if (newWorker.state === "installed" &&
+                    if (newWorker.state === "activated" &&
                         navigator.serviceWorker.controller) {
-                        console.info("@arklabs/wallet-sdk: Service worker updated, reloading...");
+                        console.info("Service worker activated, reloading...");
                         window.location.reload();
                     }
                 });
             });
-            // Check for updates
-            await registration.update();
             const sw = registration.active ||
                 registration.waiting ||
                 registration.installing;
@@ -321,6 +318,23 @@ export class ServiceWorkerWallet {
             throw new Error(`Failed to get transaction history: ${error}`);
         }
     }
+    async exit(outpoints) {
+        const message = {
+            type: "EXIT",
+            outpoints,
+            id: getRandomId(),
+        };
+        try {
+            const response = await this.sendMessage(message);
+            if (response.type === "EXIT_SUCCESS") {
+                return;
+            }
+            throw new UnexpectedResponseError(response);
+        }
+        catch (error) {
+            throw new Error(`Failed to exit: ${error}`);
+        }
+    }
 }
 function getRandomId() {
     const randomValue = crypto.getRandomValues(new Uint8Array(16));

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

@@ -14,10 +14,20 @@ export class Worker {
         this.vtxoRepository = vtxoRepository;
         this.messageCallback = messageCallback;
     }
-    async start() {
+    async start(withServiceWorkerUpdate = true) {
         self.addEventListener("message", async (event) => {
             await this.handleMessage(event);
         });
+        if (withServiceWorkerUpdate) {
+            // activate service worker immediately
+            self.addEventListener("install", () => {
+                self.skipWaiting();
+            });
+            // take control of clients immediately
+            self.addEventListener("activate", () => {
+                self.clients.claim();
+            });
+        }
     }
     async clear() {
         if (this.vtxoSubscription) {
@@ -384,6 +394,30 @@ export class Worker {
         }
         event.source?.postMessage(Response.walletStatus(message.id, this.wallet !== undefined));
     }
+    async handleExit(event) {
+        const message = event.data;
+        if (!Request.isExit(message)) {
+            console.error("Invalid EXIT message format", message);
+            event.source?.postMessage(Response.error(message.id, "Invalid EXIT message format"));
+            return;
+        }
+        if (!this.wallet) {
+            console.error("Wallet not initialized");
+            event.source?.postMessage(Response.error(message.id, "Wallet not initialized"));
+            return;
+        }
+        try {
+            await this.wallet.exit(message.outpoints);
+            event.source?.postMessage(Response.exitSuccess(message.id));
+        }
+        catch (error) {
+            console.error("Error exiting:", error);
+            const errorMessage = error instanceof Error
+                ? error.message
+                : "Unknown error occurred";
+            event.source?.postMessage(Response.error(message.id, errorMessage));
+        }
+    }
     async handleMessage(event) {
         this.messageCallback(event);
         const message = event.data;
@@ -437,6 +471,10 @@ export class Worker {
                 await this.handleGetStatus(event);
                 break;
             }
+            case "EXIT": {
+                await this.handleExit(event);
+                break;
+            }
             case "CLEAR": {
                 await this.handleClear(event);
                 break;

package/dist/esm/wallet/wallet.js

@@ -1,5 +1,6 @@
 import { base64, hex } from "@scure/base";
 import { Address, OutScript, p2tr, tapLeafHash, } from "@scure/btc-signer/payment";
+import { Transaction } from "@scure/btc-signer";
 import { TaprootControlBlock } from "@scure/btc-signer/psbt";
 import { vtxosToTxs } from '../utils/transactionHistory.js';
 import { BIP21 } from '../utils/bip21.js';
@@ -16,7 +17,6 @@ import { TxType, } from './index.js';
 import { scriptFromTapLeafScript, VtxoScript } from '../script/base.js';
 import { CSVMultisigTapscript, decodeTapscript, } from '../script/tapscript.js';
 import { createVirtualTx } from '../utils/psbt.js';
-import { Transaction } from "@scure/btc-signer";
 import { ArkNote } from '../arknote/index.js';
 // Wallet does not store any data and rely on the Ark and onchain providers to fetch utxos and vtxos
 export class Wallet {
@@ -366,7 +366,6 @@ export class Wallet {
                     amount: BigInt(input.value),
                 },
                 tapInternalKey: this.onchainP2TR.tapInternalKey,
-                tapMerkleRoot: this.onchainP2TR.tapMerkleRoot,
             });
         }
         // Add payment output
@@ -582,6 +581,48 @@ export class Wallet {
         }
         throw new Error("Settlement failed");
     }
+    async exit(outpoints) {
+        // TODO store the exit branches in repository
+        // exit should not depend on the ark provider
+        if (!this.arkProvider) {
+            throw new Error("Ark provider not configured");
+        }
+        let vtxos = await this.getVtxos();
+        if (outpoints && outpoints.length > 0) {
+            vtxos = vtxos.filter((vtxo) => outpoints.some((outpoint) => vtxo.txid === outpoint.txid &&
+                vtxo.vout === outpoint.vout));
+        }
+        if (vtxos.length === 0) {
+            throw new Error("No vtxos to exit");
+        }
+        const trees = new Map();
+        const transactions = [];
+        for (const vtxo of vtxos) {
+            const batchTxid = vtxo.virtualStatus.batchTxID;
+            if (!batchTxid)
+                continue;
+            if (!trees.has(batchTxid)) {
+                const round = await this.arkProvider.getRound(batchTxid);
+                trees.set(batchTxid, round.vtxoTree);
+            }
+            const tree = trees.get(batchTxid);
+            if (!tree) {
+                throw new Error("Tree not found");
+            }
+            const exitBranch = await tree.exitBranch(vtxo.txid, async (txid) => {
+                const status = await this.onchainProvider.getTxStatus(txid);
+                return status.confirmed;
+            });
+            transactions.push(...exitBranch);
+        }
+        const broadcastedTxs = new Map();
+        for (const tx of transactions) {
+            if (broadcastedTxs.has(tx))
+                continue;
+            const txid = await this.onchainProvider.broadcastTransaction(tx);
+            broadcastedTxs.set(txid, true);
+        }
+    }
     // validates the vtxo tree, creates a signing session and generates the musig2 nonces
     async handleSettlementSigningEvent(event, sweepTapTreeRoot, session) {
         const vtxoTree = event.unsignedVtxoTree;

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

@@ -75,8 +75,17 @@ export interface ArkInfo {
         end: number;
     };
 }
+export interface Round {
+    id: string;
+    start: Date;
+    end: Date;
+    vtxoTree: TxTree;
+    forfeitTxs: string[];
+    connectors: TxTree;
+}
 export interface ArkProvider {
     getInfo(): Promise<ArkInfo>;
+    getRound(txid: string): Promise<Round>;
     getVirtualCoins(address: string): Promise<{
         spendableVtxos: VirtualCoin[];
         spentVtxos: VirtualCoin[];
@@ -105,6 +114,7 @@ export declare class RestArkProvider implements ArkProvider {
         spendableVtxos: VirtualCoin[];
         spentVtxos: VirtualCoin[];
     }>;
+    getRound(txid: string): Promise<Round>;
     submitVirtualTx(psbtBase64: string): Promise<string>;
     subscribeToEvents(callback: (event: ArkEvent) => void): Promise<() => void>;
     registerInputsForNextRound(inputs: Input[]): Promise<{

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

@@ -21,6 +21,11 @@ export interface OnchainProvider {
         txid: string;
     }[]>;
     getTransactions(address: string): Promise<ExplorerTransaction[]>;
+    getTxStatus(txid: string): Promise<{
+        confirmed: boolean;
+        blockTime?: number;
+        blockHeight?: number;
+    }>;
 }
 export declare class EsploraProvider implements OnchainProvider {
     private baseUrl;
@@ -33,4 +38,9 @@ export declare class EsploraProvider implements OnchainProvider {
         txid: string;
     }[]>;
     getTransactions(address: string): Promise<ExplorerTransaction[]>;
+    getTxStatus(txid: string): Promise<{
+        confirmed: boolean;
+        blockTime?: number;
+        blockHeight?: number;
+    }>;
 }

package/dist/types/tree/vtxoTree.d.ts

@@ -20,6 +20,7 @@ export declare class TxTree {
     children(nodeTxid: string): TreeNode[];
     numberOfNodes(): number;
     branch(vtxoTxid: string): TreeNode[];
+    exitBranch(vtxoTxid: string, isTxConfirmed: (txid: string) => Promise<boolean>): Promise<string[]>;
     private findParent;
     validate(): void;
 }

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

@@ -119,4 +119,5 @@ export interface IWallet {
     getTransactionHistory(): Promise<ArkTransaction[]>;
     sendBitcoin(params: SendBitcoinParams, zeroFee?: boolean): Promise<string>;
     settle(params?: SettleParams, eventCallback?: (event: SettlementEvent) => void): Promise<string>;
+    exit(outpoints?: Outpoint[]): Promise<void>;
 }

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

@@ -1,7 +1,7 @@
 import { NetworkName } from "../../networks";
-import { SettleParams, SendBitcoinParams } from "..";
+import { SettleParams, SendBitcoinParams, Outpoint } from "..";
 export declare namespace Request {
-    type Type = "INIT_WALLET" | "SETTLE" | "GET_ADDRESS" | "GET_ADDRESS_INFO" | "GET_BALANCE" | "GET_COINS" | "GET_VTXOS" | "GET_VIRTUAL_COINS" | "GET_BOARDING_UTXOS" | "SEND_BITCOIN" | "GET_TRANSACTION_HISTORY" | "GET_STATUS" | "CLEAR";
+    type Type = "INIT_WALLET" | "SETTLE" | "GET_ADDRESS" | "GET_ADDRESS_INFO" | "GET_BALANCE" | "GET_COINS" | "GET_VTXOS" | "GET_VIRTUAL_COINS" | "GET_BOARDING_UTXOS" | "SEND_BITCOIN" | "GET_TRANSACTION_HISTORY" | "GET_STATUS" | "CLEAR" | "EXIT";
     interface Base {
         type: Type;
         id: string;
@@ -65,4 +65,9 @@ export declare namespace Request {
     interface Clear extends Base {
         type: "CLEAR";
     }
+    interface Exit extends Base {
+        type: "EXIT";
+        outpoints?: Outpoint[];
+    }
+    function isExit(message: Base): message is Exit;
 }

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

@@ -1,7 +1,7 @@
 import { WalletBalance, Coin, VirtualCoin, ArkTransaction, AddressInfo as WalletAddressInfo, IWallet, Addresses } from "..";
 import { SettlementEvent } from "../../providers/ark";
 export declare namespace Response {
-    type Type = "WALLET_INITIALIZED" | "SETTLE_EVENT" | "SETTLE_SUCCESS" | "ADDRESS" | "ADDRESS_INFO" | "BALANCE" | "COINS" | "VTXOS" | "VIRTUAL_COINS" | "BOARDING_UTXOS" | "SEND_BITCOIN_SUCCESS" | "TRANSACTION_HISTORY" | "WALLET_STATUS" | "ERROR" | "CLEAR_RESPONSE";
+    type Type = "WALLET_INITIALIZED" | "SETTLE_EVENT" | "SETTLE_SUCCESS" | "ADDRESS" | "ADDRESS_INFO" | "BALANCE" | "COINS" | "VTXOS" | "VIRTUAL_COINS" | "BOARDING_UTXOS" | "SEND_BITCOIN_SUCCESS" | "TRANSACTION_HISTORY" | "WALLET_STATUS" | "ERROR" | "CLEAR_RESPONSE" | "EXIT_SUCCESS";
     interface Base {
         type: Type;
         success: boolean;
@@ -104,4 +104,9 @@ export declare namespace Response {
     }
     function isClearResponse(response: Base): response is ClearResponse;
     function clearResponse(id: string, success: boolean): ClearResponse;
+    interface ExitSuccess extends Base {
+        type: "EXIT_SUCCESS";
+        success: true;
+    }
+    function exitSuccess(id: string): ExitSuccess;
 }

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

@@ -1,4 +1,4 @@
-import { IWallet, WalletBalance, SendBitcoinParams, SettleParams, AddressInfo, Coin, ArkTransaction, WalletConfig, ExtendedCoin, ExtendedVirtualCoin, Addresses } from "..";
+import { IWallet, WalletBalance, SendBitcoinParams, SettleParams, AddressInfo, Coin, ArkTransaction, WalletConfig, ExtendedCoin, ExtendedVirtualCoin, Addresses, Outpoint } from "..";
 import { Response } from "./response";
 import { SettlementEvent } from "../../providers/ark";
 export declare class ServiceWorkerWallet implements IWallet {
@@ -20,4 +20,5 @@ export declare class ServiceWorkerWallet implements IWallet {
     sendBitcoin(params: SendBitcoinParams, zeroFee?: boolean): Promise<string>;
     settle(params?: SettleParams, callback?: (event: SettlementEvent) => void): Promise<string>;
     getTransactionHistory(): Promise<ArkTransaction[]>;
+    exit(outpoints?: Outpoint[]): Promise<void>;
 }

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

@@ -6,7 +6,7 @@ export declare class Worker {
     private arkProvider;
     private vtxoSubscription;
     constructor(vtxoRepository?: VtxoRepository, messageCallback?: (message: ExtendableMessageEvent) => void);
-    start(): Promise<void>;
+    start(withServiceWorkerUpdate?: boolean): Promise<void>;
     clear(): Promise<void>;
     private onWalletInitialized;
     private processVtxoSubscription;
@@ -22,5 +22,6 @@ export declare class Worker {
     private handleGetBoardingUtxos;
     private handleGetTransactionHistory;
     private handleGetStatus;
+    private handleExit;
     private handleMessage;
 }

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

@@ -1,7 +1,7 @@
 import { ArkAddress } from "../script/address";
 import { DefaultVtxo } from "../script/default";
 import { SettlementEvent } from "../providers/ark";
-import { Addresses, AddressInfo, ArkTransaction, Coin, ExtendedCoin, ExtendedVirtualCoin, IWallet, SendBitcoinParams, SettleParams, WalletBalance, WalletConfig } from ".";
+import { Addresses, AddressInfo, ArkTransaction, Coin, ExtendedCoin, ExtendedVirtualCoin, IWallet, Outpoint, SendBitcoinParams, SettleParams, WalletBalance, WalletConfig } from ".";
 export declare class Wallet implements IWallet {
     private identity;
     private network;
@@ -36,6 +36,7 @@ export declare class Wallet implements IWallet {
     private sendOnchain;
     private sendOffchain;
     settle(params?: SettleParams, eventCallback?: (event: SettlementEvent) => void): Promise<string>;
+    exit(outpoints?: Outpoint[]): Promise<void>;
     private handleSettlementSigningEvent;
     private handleSettlementSigningNoncesGeneratedEvent;
     private handleSettlementFinalizationEvent;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arkade-os/sdk",
-  "version": "0.0.16",
+  "version": "0.1.1",
   "description": "Bitcoin wallet SDK with Taproot and Ark integration",
   "type": "module",
   "main": "./dist/cjs/index.js",
@@ -23,11 +23,11 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@noble/curves": "1.7.0",
-    "@noble/hashes": "1.6.1",
+    "@noble/curves": "1.9.1",
+    "@noble/hashes": "1.8.0",
     "@noble/secp256k1": "2.2.3",
-    "@scure/base": "1.2.1",
-    "@scure/btc-signer": "1.7.0",
+    "@scure/base": "1.2.6",
+    "@scure/btc-signer": "1.8.1",
     "bip68": "1.0.4"
   },
   "devDependencies": {
@@ -36,7 +36,7 @@
     "@types/node": "22.10.2",
     "@typescript-eslint/eslint-plugin": "8.18.2",
     "@typescript-eslint/parser": "8.18.2",
-    "@vitest/coverage-v8": "2.1.8",
+    "@vitest/coverage-v8": "2.1.9",
     "esbuild": "^0.20.1",
     "eslint": "^9.17.0",
     "glob": "11.0.1",
@@ -44,7 +44,7 @@
     "lint-staged": "15.3.0",
     "prettier": "3.4.2",
     "typescript": "5.7.2",
-    "vitest": "2.1.8"
+    "vitest": "2.1.9"
   },
   "keywords": [
     "bitcoin",