@arkade-os/sdk 0.0.16 → 0.1.0

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/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

@@ -324,6 +324,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

@@ -387,6 +387,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 +464,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 {
@@ -585,6 +585,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/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

@@ -321,6 +321,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

@@ -384,6 +384,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 +461,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 {
@@ -582,6 +582,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

@@ -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.0",
   "description": "Bitcoin wallet SDK with Taproot and Ark integration",
   "type": "module",
   "main": "./dist/cjs/index.js",