@kaleidorg/wallet-engine 1.0.0-beta.31 → 1.0.0-beta.32

package/dist/adapters/ArkadeAdapter.js

@@ -1,316 +1,806 @@
 /**
  * Arkade Protocol Adapter
- * Implements IProtocolAdapter using @arkade-os/sdk.
- * Ported from rate-extension, adapted for React Native with Expo providers.
+ * Implements IProtocolAdapter using @arkade-os/sdk v0.4.x.
+ *
+ * SDK API facts for v0.4.x:
+ *  - `wallet.getBalance()` includes `assets: { assetId, amount }[]`
+ *  - `wallet.assetManager.getAssetDetails(assetId)` resolves supply + metadata
+ *  - `wallet.send({ address, assets: [...] })` sends Arkade-native assets
+ *  - `wallet.sendBitcoin({ address, amount })` still sends BTC
+ *  - `wallet.getTransactionHistory()` → ArkTransaction[]
+ *    where ArkTransaction = { key, type: TxType, amount: number, settled: boolean, createdAt: number }
+ *  - `TxType.TxSent = "SENT"`, `TxType.TxReceived = "RECEIVED"`
+ *  - `WalletBalance.boarding.total` (number), `.settled`, `.preconfirmed`, `.available`, `.recoverable`, `.total`
  */
-import { arkadeClientManager } from '../lib/arkade-client-manager.js';
-import { ProtocolError, ConnectionError, } from '../types/base.js';
-import { PROTOCOL_OPERATIONS } from '../capabilities/operations.js';
+import { mnemonicToSeedSync } from "@scure/bip39";
+import { HDKey } from "@scure/bip32";
+import { signLnMessage, verifyLnMessage } from "../lib/ln-message-sign.js";
+import { log } from "../lib/log.js";
+import { arkadeClientManager } from "../lib/arkade-client-manager.js";
+import { arkadeSwapsClientManager } from "../lib/arkade-swaps-client-manager.js";
+import { Ramps, isSpendable, } from "@arkade-os/sdk";
+import { PROTOCOL_OPERATIONS } from "../capabilities/operations.js";
+import { formatSats, formatUnits, getAssetMetadata, getAssetName, getAssetPrecision, getAssetTicker, normalizeVtxos, selectVtxosByExpiry, sortVtxosByExpiry, toNumber, toPositiveIntegerBigInt, toStringValue, } from "../lib/arkade-helpers.js";
+import { convertArkTxToUnifiedAll } from "../lib/arkade-converters.js";
+import { ProtocolError, ConnectionError, } from "../types/base.js";
+/** Bare bolt11 prefixes (lnbc / lntb / lnbcrt / lnsb) — case-insensitive. */
+function isLightningInvoice(value) {
+    if (!value)
+        return false;
+    const lower = value.trim().toLowerCase();
+    // Strip a `lightning:` URI prefix if present.
+    const body = lower.startsWith("lightning:") ? lower.slice("lightning:".length) : lower;
+    return /^ln(bc|tb|bcrt|sb)/.test(body);
+}
+function stripLightningPrefix(value) {
+    const trimmed = value.trim();
+    return trimmed.toLowerCase().startsWith("lightning:")
+        ? trimmed.slice("lightning:".length)
+        : trimmed;
+}
+function isArkadeAddress(value) {
+    return /^(ark1|tark1)/i.test(value.trim());
+}
 export class ArkadeAdapter {
     constructor() {
-        this.protocolName = 'ARKADE';
+        this.protocolName = "ARKADE";
+        this.supportedLayers = ["BTC_ARKADE", "BTC_L1", "ARKADE_ARKADE"];
+        this.version = "1.0.0";
         this.capabilities = PROTOCOL_OPERATIONS.ARKADE;
-        this.supportedLayers = ['BTC_ARKADE', 'BTC_L1', 'ARKADE_ARKADE'];
-        this.version = '1.0.0';
         this.config = null;
+        this.assetDetailsCache = new Map();
     }
-    // ========================================================================
+    // =========================================================================
     // Connection Management
-    // ========================================================================
+    // =========================================================================
     async connect(config) {
         const arkadeConfig = config;
         if (!arkadeConfig.mnemonic) {
-            throw new ConnectionError('Mnemonic is required for Arkade wallet', 'ARKADE');
+            throw new ConnectionError("Wallet recovery secret is required for Arkade wallet", "ARKADE");
         }
         if (!arkadeConfig.arkServerUrl) {
-            throw new ConnectionError('arkServerUrl is required for Arkade wallet', 'ARKADE');
+            throw new ConnectionError("arkServerUrl is required for Arkade wallet", "ARKADE");
         }
         try {
             await arkadeClientManager.initialize(arkadeConfig);
             this.config = arkadeConfig;
-            console.log('[ArkadeAdapter] Connected to Arkade successfully');
+            this.assetDetailsCache.clear();
+            log.info("[ArkadeAdapter] Connected to Arkade successfully");
+            // Initialize the Boltz swap client in the background. Failures are
+            // non-fatal — swaps just stay unavailable until the next connect.
+            const wallet = arkadeClientManager.getWallet();
+            arkadeSwapsClientManager.initialize(wallet).catch((error) => {
+                log.warn("[ArkadeAdapter] Boltz swaps init failed (Lightning swaps unavailable):", error);
+            });
         }
         catch (error) {
             const msg = error instanceof Error ? error.message : String(error);
-            throw new ConnectionError(`Failed to connect to Arkade: ${msg}`, 'ARKADE');
+            throw new ConnectionError(`Failed to connect to Arkade: ${msg}`, "ARKADE");
         }
     }
     async disconnect() {
+        // Dispose Boltz swaps client first (stops SwapManager monitoring) so it
+        // doesn't try to use the wallet after we tear it down.
+        await arkadeSwapsClientManager.dispose();
         await arkadeClientManager.disconnect();
         this.config = null;
-        console.log('[ArkadeAdapter] Disconnected from Arkade');
+        this.assetDetailsCache.clear();
+        log.info("[ArkadeAdapter] Disconnected from Arkade");
     }
     isConnected() {
         return arkadeClientManager.isInitialized();
     }
     async getConnectionInfo() {
         if (!this.isConnected()) {
-            throw new ProtocolError('Not connected', 'ARKADE', 'NOT_CONNECTED');
+            throw new ProtocolError("Not connected", "ARKADE", "NOT_CONNECTED");
         }
         return {
-            protocol: 'ARKADE',
+            protocol: "ARKADE",
             connected: true,
-            network: this.config?.network ?? 'signet',
+            network: this.config?.network ?? "signet",
             syncStatus: { synced: true, progress: 100 },
         };
     }
-    // ========================================================================
+    // =========================================================================
     // Asset Operations
-    // ========================================================================
+    // =========================================================================
     async listAssets() {
         if (!this.isConnected()) {
-            throw new ProtocolError('Not connected', 'ARKADE', 'NOT_CONNECTED');
+            throw new ProtocolError("Not connected", "ARKADE", "NOT_CONNECTED");
         }
         try {
             const wallet = arkadeClientManager.getWallet();
-            const balance = await wallet.getBalance();
-            const totalSats = this.toNumber(balance?.total);
-            const availableSats = this.toNumber(balance?.available);
-            const preconfirmed = this.toNumber(balance?.preconfirmed);
-            return [{
-                    id: 'BTC',
-                    name: 'Bitcoin (Arkade)',
-                    ticker: 'BTC',
-                    precision: 8,
-                    protocol: 'ARKADE',
-                    layer: 'BTC_ARKADE',
+            const rawBalance = await wallet.getBalance();
+            const balance = await this.getWalletBalanceSummary(wallet);
+            const totalSats = balance.total;
+            const preconfirmed = balance.preconfirmed;
+            const btcAsset = {
+                id: "BTC",
+                name: "Bitcoin (Arkade)",
+                ticker: "BTC",
+                precision: 8,
+                protocol: "ARKADE",
+                layer: "BTC_ARKADE",
+                balance: {
+                    total: totalSats,
+                    // preconfirmed VTXOs are spendable (isSpendable = !vtxo.isSpent in the SDK),
+                    // so they count as available just like settled ones.
+                    available: balance.available,
+                    pending: 0,
+                    locked: 0,
+                    totalDisplay: formatSats(totalSats),
+                    availableDisplay: formatSats(balance.available),
+                },
+                capabilities: {
+                    canSend: true,
+                    canReceive: true,
+                    canSwap: false,
+                    supportsLightning: false,
+                    supportsOnchain: true,
+                },
+                metadata: {
+                    boarding: balance.boardingTotal,
+                    settled: balance.settled,
+                    preconfirmed,
+                    recoverable: balance.recoverable,
+                },
+            };
+            const rawAssets = Array.isArray(rawBalance?.assets) ? rawBalance.assets : [];
+            const arkadeAssets = await Promise.all(rawAssets
+                .filter((entry) => toStringValue(entry?.assetId) !== "" && toNumber(entry?.amount) > 0)
+                .map(async (entry) => {
+                const assetId = toStringValue(entry.assetId);
+                const amount = toNumber(entry.amount);
+                const details = await this.getCachedAssetDetails(wallet, assetId);
+                const metadata = getAssetMetadata(details);
+                const precision = getAssetPrecision(metadata);
+                const ticker = getAssetTicker(assetId, metadata);
+                const name = getAssetName(assetId, ticker, metadata);
+                const icon = typeof metadata?.icon === "string" ? metadata.icon : undefined;
+                const asset = {
+                    id: assetId,
+                    name,
+                    ticker,
+                    precision,
+                    protocol: "ARKADE",
+                    layer: "ARKADE_ARKADE",
                     balance: {
-                        total: totalSats,
-                        available: availableSats,
-                        pending: preconfirmed,
+                        total: amount,
+                        available: amount,
+                        pending: 0,
                         locked: 0,
-                        totalDisplay: this.formatSats(totalSats),
-                        availableDisplay: this.formatSats(availableSats),
+                        totalDisplay: formatUnits(amount, precision),
+                        availableDisplay: formatUnits(amount, precision),
                     },
+                    icon,
                     capabilities: {
                         canSend: true,
                         canReceive: true,
                         canSwap: false,
                         supportsLightning: false,
-                        supportsOnchain: true,
+                        supportsOnchain: false,
                     },
+                    // Don't spread `details` — the Arkade SDK returns BigInt /
+                    // Uint8Array fields (totalSupply, raw identifiers) that crash
+                    // chrome.runtime.sendMessage with "Could not serialize message".
                     metadata: {
-                        boarding: this.toNumber(balance?.boarding?.total),
-                        settled: this.toNumber(balance?.settled),
-                        preconfirmed,
-                        recoverable: this.toNumber(balance?.recoverable),
+                        arkadeAssetId: assetId,
+                        decimals: precision,
                     },
-                }];
+                };
+                return asset;
+            }));
+            return [btcAsset, ...arkadeAssets];
         }
         catch (error) {
             const msg = error instanceof Error ? error.message : String(error);
-            throw new ProtocolError(`Failed to list assets: ${msg}`, 'ARKADE', 'LIST_ASSETS_ERROR');
+            throw new ProtocolError(`Failed to list assets: ${msg}`, "ARKADE", "LIST_ASSETS_ERROR");
         }
     }
     async getAsset(assetId) {
         const assets = await this.listAssets();
-        const asset = assets.find(a => a.id === assetId || a.ticker === assetId);
+        const asset = assets.find((a) => a.id === assetId || a.ticker === assetId);
         if (!asset) {
-            throw new ProtocolError(`Asset not found: ${assetId}`, 'ARKADE', 'ASSET_NOT_FOUND');
+            throw new ProtocolError(`Asset not found: ${assetId}`, "ARKADE", "ASSET_NOT_FOUND");
         }
         return asset;
     }
     async getAssetBalance(assetId) {
+        if (assetId === "BTC" || assetId.toLowerCase() === "btc") {
+            const asset = await this.getAsset("BTC");
+            return asset.balance;
+        }
         const asset = await this.getAsset(assetId);
         return asset.balance;
     }
-    async refreshBalances() { }
-    // ========================================================================
+    async refreshBalances() {
+        // Balances are fetched live on each call
+    }
+    // =========================================================================
     // Transaction Operations
-    // ========================================================================
+    // =========================================================================
     async listTransactions(filter) {
         if (!this.isConnected()) {
-            throw new ProtocolError('Not connected', 'ARKADE', 'NOT_CONNECTED');
+            throw new ProtocolError("Not connected", "ARKADE", "NOT_CONNECTED");
         }
         try {
             const wallet = arkadeClientManager.getWallet();
             const history = await wallet.getTransactionHistory();
-            return (history ?? [])
-                .map((item) => this.convertArkTx(item))
-                .filter((tx) => tx !== null)
-                .filter(tx => {
+            const resolveDetails = (assetId) => this.getCachedAssetDetails(wallet, assetId);
+            const expanded = await Promise.all((history ?? []).map((item) => convertArkTxToUnifiedAll(item, resolveDetails)));
+            const validTxs = expanded.flat();
+            return validTxs
+                .filter((tx) => {
                 if (!filter)
                     return true;
+                if (filter.asset && tx.asset?.id !== filter.asset)
+                    return false;
                 if (filter.type && tx.type !== filter.type)
                     return false;
                 if (filter.status && tx.status !== filter.status)
                     return false;
+                if (filter.fromTimestamp && tx.timestamp < filter.fromTimestamp)
+                    return false;
+                if (filter.toTimestamp && tx.timestamp > filter.toTimestamp)
+                    return false;
                 return true;
             })
                 .slice(filter?.offset ?? 0, filter?.limit ? (filter.offset ?? 0) + filter.limit : undefined);
         }
         catch (error) {
             const msg = error instanceof Error ? error.message : String(error);
-            throw new ProtocolError(`Failed to list transactions: ${msg}`, 'ARKADE', 'LIST_TRANSACTIONS_ERROR');
+            throw new ProtocolError(`Failed to list transactions: ${msg}`, "ARKADE", "LIST_TRANSACTIONS_ERROR");
         }
     }
     async getTransaction(txId) {
         const txs = await this.listTransactions();
-        const tx = txs.find(t => t.id === txId);
+        const tx = txs.find((t) => t.id === txId);
         if (!tx) {
-            throw new ProtocolError(`Transaction not found: ${txId}`, 'ARKADE', 'TX_NOT_FOUND');
+            throw new ProtocolError(`Transaction not found: ${txId}`, "ARKADE", "TX_NOT_FOUND");
         }
         return tx;
     }
-    // ========================================================================
+    // =========================================================================
     // Payment Operations
-    // ========================================================================
+    // =========================================================================
     async createInvoice(request) {
         if (!this.isConnected()) {
-            throw new ProtocolError('Not connected', 'ARKADE', 'NOT_CONNECTED');
+            throw new ProtocolError("Not connected", "ARKADE", "NOT_CONNECTED");
+        }
+        try {
+            const wallet = arkadeClientManager.getWallet();
+            const address = await wallet.getAddress();
+            return {
+                invoice: address,
+                paymentHash: "",
+                amount: request.amount,
+                expiresAt: Date.now() + (request.expirySeconds ?? 3600) * 1000,
+                description: request.description ?? "Arkade receiving address",
+            };
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            throw new ProtocolError(`Failed to create invoice: ${msg}`, "ARKADE", "CREATE_INVOICE_ERROR");
+        }
+    }
+    /**
+     * Generate a Boltz reverse-swap Lightning invoice that, when paid, lands
+     * the funds in this Arkade wallet as a VTXO. Requires amount > 0 — Boltz
+     * can't issue an amountless invoice. The embedded `SwapManager` claims
+     * the VHTLC automatically once the LN payment settles.
+     */
+    async createArkadeLightningInvoice(request) {
+        if (!this.isConnected()) {
+            throw new ProtocolError("Not connected", "ARKADE", "NOT_CONNECTED");
+        }
+        if (!request.amount || request.amount <= 0) {
+            throw new ProtocolError("Amount is required for Boltz Lightning invoices into Arkade", "ARKADE", "INVALID_AMOUNT");
+        }
+        if (!arkadeSwapsClientManager.isInitialized()) {
+            throw new ProtocolError("Lightning swaps are not ready yet. Try again in a moment.", "ARKADE", "SWAPS_NOT_READY");
+        }
+        try {
+            const swaps = arkadeSwapsClientManager.getClient();
+            const result = await swaps.createLightningInvoice({
+                amount: request.amount,
+                description: request.description,
+            });
+            return {
+                invoice: result.invoice,
+                paymentHash: result.paymentHash ?? "",
+                amount: request.amount,
+                expiresAt: Date.now() + (request.expirySeconds ?? 3600) * 1000,
+                description: request.description ?? "Boltz reverse swap into Arkade",
+            };
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            throw new ProtocolError(`Failed to create Boltz Lightning invoice: ${msg}`, "ARKADE", "CREATE_INVOICE_ERROR");
         }
-        const wallet = arkadeClientManager.getWallet();
-        const address = await wallet.getAddress();
-        return {
-            invoice: address,
-            paymentHash: '',
-            amount: request.amount,
-            expiresAt: Date.now() + (request.expirySeconds ?? 3600) * 1000,
-            description: request.description ?? 'Arkade receiving address',
-        };
     }
     async decodeInvoice(invoice) {
-        return { paymentHash: '', expiresAt: 0, destination: invoice };
+        // Arkade uses addresses, not bolt11 invoices
+        return {
+            paymentHash: "",
+            expiresAt: 0,
+            destination: invoice,
+        };
     }
     async sendPayment(request) {
         if (!this.isConnected()) {
-            throw new ProtocolError('Not connected', 'ARKADE', 'NOT_CONNECTED');
+            throw new ProtocolError("Not connected", "ARKADE", "NOT_CONNECTED");
+        }
+        // Lightning invoice → Boltz submarine swap (Arkade → Lightning).
+        // The swap library extracts the amount from the invoice itself, so
+        // amountless invoices cannot be paid this way (Boltz rejects them
+        // with "0 is less than minimal of 333"). Reject early with a clear
+        // error rather than letting Boltz's cryptic message bubble up.
+        if (isLightningInvoice(request.invoice)) {
+            if (!arkadeSwapsClientManager.isInitialized()) {
+                throw new ProtocolError("Lightning swaps are not ready yet. Try again in a moment.", "ARKADE", "SWAPS_NOT_READY");
+            }
+            const invoiceBody = stripLightningPrefix(request.invoice);
+            try {
+                const swaps = arkadeSwapsClientManager.getClient();
+                const result = await swaps.sendLightningPayment({ invoice: invoiceBody });
+                return {
+                    paymentHash: result.preimage ?? result.txid ?? "",
+                    amount: result.amount ?? request.amount ?? 0,
+                    fee: 0,
+                    // Boltz submarine swap; the swap can still fail in the HODL/claim
+                    // phase. Caller polls `getPaymentStatus` to reach a terminal state.
+                    status: "pending",
+                    timestamp: Date.now(),
+                };
+            }
+            catch (error) {
+                const msg = error instanceof Error ? error.message : String(error);
+                // Translate Boltz error strings to actionable messages.
+                if (/less than minimal/i.test(msg)) {
+                    throw new ProtocolError("Arkade can't pay amountless Lightning invoices. Please use a different route or ask the recipient for an invoice with an amount.", "ARKADE", "INVALID_AMOUNT");
+                }
+                if (/vHTLC.*already exists/i.test(msg)) {
+                    throw new ProtocolError("A swap for this invoice is already in progress. Wait for it to complete or refund before retrying.", "ARKADE", "SWAP_IN_PROGRESS");
+                }
+                throw new ProtocolError(`Failed to send Lightning payment via Boltz: ${msg}`, "ARKADE", "SEND_PAYMENT_ERROR");
+            }
         }
+        // Non-Lightning destinations: existing Ark / on-chain BTC path.
         if (!request.amount || request.amount <= 0) {
-            throw new ProtocolError('Amount is required for Arkade payments', 'ARKADE', 'INVALID_AMOUNT');
+            throw new ProtocolError("Amount is required for Arkade payments", "ARKADE", "INVALID_AMOUNT");
         }
         try {
             const wallet = arkadeClientManager.getWallet();
+            const selectedVtxos = await this.selectSpendableBtcVtxos(wallet, request.amount);
             const txid = await wallet.sendBitcoin({
-                address: request.invoice,
-                amount: request.amount,
+                address: request.invoice, // Ark or on-chain address
+                amount: request.amount, // satoshis
+                ...(selectedVtxos ? { selectedVtxos } : {}),
             });
             return {
                 paymentHash: txid,
                 amount: request.amount,
                 fee: 0,
-                status: 'confirmed',
+                // Ark VTXO sends are immediately valid once sendBitcoin resolves.
+                // On-chain destinations still need confirmation, so callers should
+                // keep polling via getPaymentStatus.
+                status: (isArkadeAddress(request.invoice) ? "confirmed" : "pending"),
                 timestamp: Date.now(),
             };
         }
         catch (error) {
             const msg = error instanceof Error ? error.message : String(error);
-            throw new ProtocolError(`Failed to send payment: ${msg}`, 'ARKADE', 'SEND_PAYMENT_ERROR');
+            throw new ProtocolError(`Failed to send payment: ${msg}`, "ARKADE", "SEND_PAYMENT_ERROR");
         }
     }
+    /**
+     * Resolve a payment's terminal state from the SDK's transaction history.
+     * `paymentHash` is the txid returned by `sendBitcoin` / `sendLightningPayment`
+     * (Boltz returns a preimage as a fallback if there's no on-chain txid yet —
+     * in that case we don't have a history row and the payment stays pending).
+     */
     async getPaymentStatus(paymentHash) {
-        return { paymentHash, status: 'pending' };
+        if (!this.isConnected() || !paymentHash) {
+            return { paymentHash, status: "pending" };
+        }
+        try {
+            const wallet = arkadeClientManager.getWallet();
+            const history = (await wallet.getTransactionHistory());
+            const match = history.find((entry) => {
+                const key = entry?.key;
+                const id = typeof key === "string" ? key : key?.txid;
+                return id === paymentHash;
+            });
+            if (!match) {
+                return { paymentHash, status: "pending" };
+            }
+            // Arkade's reference wallet treats SENT history rows as settled while
+            // leaving unsettled RECEIVED rows as preconfirmed/pending.
+            const isSent = match.type === "SENT";
+            return {
+                paymentHash,
+                status: (isSent || match.settled ? "confirmed" : "pending"),
+                amount: match.amount,
+                timestamp: Date.now(),
+            };
+        }
+        catch (error) {
+            log.warn("[ArkadeAdapter] getPaymentStatus history lookup failed:", error);
+            return { paymentHash, status: "pending" };
+        }
     }
-    // ========================================================================
+    // =========================================================================
     // Address Operations
-    // ========================================================================
+    // =========================================================================
     async getReceiveAddress(assetId) {
         if (!this.isConnected()) {
-            throw new ProtocolError('Not connected', 'ARKADE', 'NOT_CONNECTED');
+            throw new ProtocolError("Not connected", "ARKADE", "NOT_CONNECTED");
         }
-        const wallet = arkadeClientManager.getWallet();
-        if (assetId === 'onchain' || assetId === 'boarding') {
-            const address = await wallet.getBoardingAddress();
-            return { address, format: 'BTC_ADDRESS', asset: 'BTC' };
+        try {
+            const wallet = arkadeClientManager.getWallet();
+            // 'onchain' or 'boarding' → return on-chain boarding address
+            if (assetId === "onchain" || assetId === "boarding") {
+                const address = await wallet.getBoardingAddress();
+                return { address, format: "BTC_ADDRESS", asset: "BTC" };
+            }
+            // Default → Ark address (off-chain)
+            const address = await wallet.getAddress();
+            return {
+                address,
+                format: "ARKADE_ADDRESS",
+                asset: assetId && assetId !== "BTC" ? assetId : "BTC",
+            };
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            throw new ProtocolError(`Failed to get receive address: ${msg}`, "ARKADE", "GET_ADDRESS_ERROR");
         }
-        const address = await wallet.getAddress();
-        return { address, format: 'ARKADE_ADDRESS', asset: 'BTC' };
     }
-    // ========================================================================
+    // =========================================================================
     // Node & Balance Operations
-    // ========================================================================
+    // =========================================================================
     async getNodeInfo() {
         if (!this.isConnected()) {
-            throw new ProtocolError('Not connected', 'ARKADE', 'NOT_CONNECTED');
+            throw new ProtocolError("Not connected", "ARKADE", "NOT_CONNECTED");
+        }
+        try {
+            const wallet = arkadeClientManager.getWallet();
+            const balance = await this.getWalletBalanceSummary(wallet);
+            const spendableSats = balance.available;
+            return {
+                channelsBalanceMsat: spendableSats * 1000,
+                maxPayableMsat: spendableSats * 1000,
+                onchainBalanceMsat: balance.boardingConfirmed * 1000,
+                pendingOnchainBalanceMsat: balance.boardingUnconfirmed * 1000,
+                maxReceivableMsat: 0,
+                inboundLiquidityMsats: 0,
+                connectedPeers: [],
+                utxos: 0,
+            };
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            throw new ProtocolError(`Failed to get node info: ${msg}`, "ARKADE", "NODE_INFO_ERROR");
         }
-        const wallet = arkadeClientManager.getWallet();
-        const balance = await wallet.getBalance();
-        const spendable = this.toNumber(balance?.available);
-        return {
-            channelsBalanceMsat: spendable * 1000,
-            maxPayableMsat: spendable * 1000,
-            onchainBalanceMsat: this.toNumber(balance?.boarding?.total) * 1000,
-            pendingOnchainBalanceMsat: 0,
-            maxReceivableMsat: 0,
-            inboundLiquidityMsats: 0,
-            connectedPeers: [],
-            utxos: 0,
-        };
     }
     async getBtcBalance() {
         if (!this.isConnected()) {
-            throw new ProtocolError('Not connected', 'ARKADE', 'NOT_CONNECTED');
+            throw new ProtocolError("Not connected", "ARKADE", "NOT_CONNECTED");
         }
-        const wallet = arkadeClientManager.getWallet();
-        const balance = await wallet.getBalance();
-        const confirmed = this.toNumber(balance?.available);
-        const total = this.toNumber(balance?.total);
-        return { confirmed, unconfirmed: Math.max(total - confirmed, 0), total };
-    }
-    async listChannels() { return []; }
-    async listPayments() { return { payments: await this.listTransactions() }; }
-    async listTransfers(_options) { return { transfers: [] }; }
-    // ========================================================================
-    // Unsupported Operations
-    // ========================================================================
-    supportsSwaps() { return false; }
+        try {
+            const wallet = arkadeClientManager.getWallet();
+            const balance = await this.getWalletBalanceSummary(wallet);
+            // preconfirmed VTXOs are spendable (isSpendable = !vtxo.isSpent in the SDK),
+            // so include them in `confirmed` so the Withdraw UI sees the full spendable balance.
+            const confirmed = balance.available; // settled + preconfirmed
+            const total = balance.total;
+            const unconfirmed = Math.max(total - confirmed, 0);
+            return { confirmed, unconfirmed, total };
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            throw new ProtocolError(`Failed to get BTC balance: ${msg}`, "ARKADE", "BALANCE_ERROR");
+        }
+    }
+    async listChannels() {
+        return [];
+    }
+    async listPayments() {
+        const txs = await this.listTransactions();
+        return { payments: txs };
+    }
+    /**
+     * Get all VTXOs, sorted by batchExpiry ascending (expiry-first).
+     * This ensures UI consumers see soon-to-expire VTXOs first, and any
+     * manual coin selection naturally picks the shortest-lived coins.
+     */
+    async getVtxos() {
+        if (!this.isConnected()) {
+            throw new ProtocolError("Not connected", "ARKADE", "NOT_CONNECTED");
+        }
+        try {
+            const wallet = arkadeClientManager.getWallet();
+            const vtxos = await wallet.getVtxos();
+            const sorted = sortVtxosByExpiry(vtxos);
+            return normalizeVtxos(sorted).map((vtxo) => ({
+                txid: vtxo.txid,
+                vout: vtxo.vout,
+                value: vtxo.value,
+                state: vtxo.state,
+                batchTxid: vtxo.batchTxid,
+                batchExpiry: vtxo.batchExpiry,
+                createdAt: vtxo.createdAt,
+                assets: vtxo.assets,
+            }));
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            throw new ProtocolError(`Failed to get VTXOs: ${msg}`, "ARKADE", "GET_VTXOS_ERROR");
+        }
+    }
+    async getBoardingUtxos() {
+        if (!this.isConnected()) {
+            throw new ProtocolError("Not connected", "ARKADE", "NOT_CONNECTED");
+        }
+        try {
+            const wallet = arkadeClientManager.getWallet();
+            const utxos = await wallet.getBoardingUtxos();
+            return (utxos ?? []).map((u) => ({
+                txid: u.txid,
+                vout: u.vout,
+                value: u.value,
+                confirmed: u.status?.confirmed ?? false,
+            }));
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            throw new ProtocolError(`Failed to get boarding UTXOs: ${msg}`, "ARKADE", "GET_BOARDING_UTXOS_ERROR");
+        }
+    }
+    /**
+     * Onboard — settle boarding UTXOs into VTXOs via a Commitment Transaction.
+     * Requires at least one confirmed boarding UTXO.
+     * Returns the commitment txid.
+     */
+    async onboard() {
+        if (!this.isConnected()) {
+            throw new ProtocolError("Not connected", "ARKADE", "NOT_CONNECTED");
+        }
+        try {
+            const wallet = arkadeClientManager.getWallet();
+            // Get current fee info from server
+            const info = await wallet.arkProvider.getInfo();
+            const commitmentTxid = await new Ramps(wallet).onboard(info.fees);
+            return { txid: commitmentTxid };
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            throw new ProtocolError(`Onboard failed: ${msg}`, "ARKADE", "ONBOARD_ERROR");
+        }
+    }
+    /**
+     * Offboard — collaborative exit: convert VTXOs back to an on-chain Bitcoin UTXO.
+     * @param address  Bitcoin on-chain destination (bc1/tb1)
+     * @param amount   Optional sats to offboard; undefined = exit all
+     */
+    async offboard(address, amount) {
+        if (!this.isConnected()) {
+            throw new ProtocolError("Not connected", "ARKADE", "NOT_CONNECTED");
+        }
+        if (!address) {
+            throw new ProtocolError("Destination address required for offboard", "ARKADE", "INVALID_ADDRESS");
+        }
+        if (amount !== undefined && (!Number.isInteger(amount) || amount <= 0)) {
+            throw new ProtocolError(`Invalid offboard amount: ${amount} (must be a positive integer of sats)`, "ARKADE", "INVALID_AMOUNT");
+        }
+        try {
+            const wallet = arkadeClientManager.getWallet();
+            const info = await wallet.arkProvider.getInfo();
+            const exitTxid = await new Ramps(wallet).offboard(address, info.fees, amount !== undefined ? BigInt(amount) : undefined);
+            return { txid: exitTxid };
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            throw new ProtocolError(`Offboard failed: ${msg}`, "ARKADE", "OFFBOARD_ERROR");
+        }
+    }
+    async listTransfers(_options) {
+        return { transfers: [] };
+    }
+    // =========================================================================
+    // Asset / On-chain Send
+    // =========================================================================
+    async sendAsset(params) {
+        if (!this.isConnected()) {
+            throw new ProtocolError("Not connected", "ARKADE", "NOT_CONNECTED");
+        }
+        const request = (params ?? {});
+        const assetId = toStringValue(request.assetId);
+        const amount = toPositiveIntegerBigInt(request.amount);
+        const recipientId = toStringValue(request.recipientId);
+        if (!assetId) {
+            throw new ProtocolError("Asset ID is required", "ARKADE", "INVALID_ASSET");
+        }
+        if (!recipientId) {
+            throw new ProtocolError("Recipient address is required", "ARKADE", "INVALID_ADDRESS");
+        }
+        if (amount <= 0n) {
+            throw new ProtocolError("Amount must be greater than zero", "ARKADE", "INVALID_AMOUNT");
+        }
+        try {
+            const wallet = arkadeClientManager.getWallet();
+            const txid = await wallet.send({
+                address: recipientId,
+                assets: [{ assetId, amount }],
+            });
+            return { txid };
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            throw new ProtocolError(`Failed to send Arkade asset: ${msg}`, "ARKADE", "SEND_ASSET_ERROR");
+        }
+    }
     async sendBtcOnchain(params) {
         if (!this.isConnected()) {
-            throw new ProtocolError('Not connected', 'ARKADE', 'NOT_CONNECTED');
+            throw new ProtocolError("Not connected", "ARKADE", "NOT_CONNECTED");
+        }
+        try {
+            const wallet = arkadeClientManager.getWallet();
+            const selectedVtxos = await this.selectSpendableBtcVtxos(wallet, params.amount);
+            const txid = await wallet.sendBitcoin({
+                address: params.address,
+                amount: params.amount,
+                ...(selectedVtxos ? { selectedVtxos } : {}),
+            });
+            return { txid };
         }
-        const wallet = arkadeClientManager.getWallet();
-        const txid = await wallet.sendBitcoin({ address: params.address, amount: params.amount });
-        return { txid };
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            throw new ProtocolError(`Failed to send BTC: ${msg}`, "ARKADE", "SEND_BTC_ERROR");
+        }
+    }
+    // =========================================================================
+    // Swap Operations (Not supported)
+    // =========================================================================
+    supportsSwaps() {
+        return false;
+    }
+    async getSwapQuote(_request) {
+        throw new ProtocolError("Not supported", "ARKADE", "NOT_SUPPORTED");
+    }
+    async executeSwap(_quote) {
+        throw new ProtocolError("Not supported", "ARKADE", "NOT_SUPPORTED");
     }
-    // ========================================================================
+    async getSwapStatus(_swapId) {
+        throw new ProtocolError("Not supported", "ARKADE", "NOT_SUPPORTED");
+    }
+    // =========================================================================
+    // Message Signing
+    // =========================================================================
+    async signMessage(message) {
+        if (!this.config?.mnemonic) {
+            throw new ProtocolError("Wallet mnemonic not available", "ARKADE", "NOT_CONNECTED");
+        }
+        const seed = mnemonicToSeedSync(this.config.mnemonic);
+        const node = HDKey.fromMasterSeed(seed).derive("m/138'/1");
+        if (!node.privateKey) {
+            throw new ProtocolError("Failed to derive message-signing key", "ARKADE", "KEY_DERIVATION_ERROR");
+        }
+        return signLnMessage(message, node.privateKey);
+    }
+    async verifyMessage(message, signature) {
+        return verifyLnMessage(message, signature);
+    }
+    // =========================================================================
     // Private Helpers
-    // ========================================================================
-    convertArkTx(tx) {
+    // =========================================================================
+    /**
+     * Pre-select spendable BTC VTXOs for a sendBitcoin call using the
+     * expiry-first policy. Returns `undefined` (not an empty array) when no
+     * override should be applied — that lets the SDK fall back to its own
+     * selection when the fetch fails, the spendable set can't cover the target,
+     * or the target is non-positive. Mixed-asset VTXOs are filtered out.
+     */
+    async selectSpendableBtcVtxos(wallet, targetSats) {
+        if (!Number.isFinite(targetSats) || targetSats <= 0)
+            return undefined;
         try {
-            const isSend = tx.type === 'SENT';
-            const amountSats = tx.amount ?? 0;
-            const timestamp = typeof tx.createdAt === 'number' ? tx.createdAt
-                : tx.createdAt instanceof Date ? tx.createdAt.getTime()
-                    : Date.now();
-            const txId = tx.key?.arkTxid || tx.key?.commitmentTxid || tx.key?.boardingTxid || tx.txid || `ark-${timestamp}`;
-            const btcAsset = {
-                id: 'BTC', name: 'Bitcoin (Ark)', ticker: 'BTC', precision: 8,
-                protocol: 'ARKADE', layer: 'ARKADE_ARKADE',
-                balance: {
-                    total: amountSats, available: amountSats, pending: 0,
-                    totalDisplay: this.formatSats(amountSats),
-                    availableDisplay: this.formatSats(amountSats),
-                },
-                capabilities: { canSend: true, canReceive: true, canSwap: false, supportsLightning: false, supportsOnchain: true },
-            };
-            return {
-                id: txId,
-                type: isSend ? 'send' : 'receive',
-                status: tx.settled || !isSend ? 'confirmed' : 'pending',
-                timestamp, amount: amountSats,
-                amountDisplay: this.formatSats(amountSats),
-                fee: 0, feeDisplay: '0.00000000',
-                asset: btcAsset,
-                protocolData: { type: tx.type, settled: tx.settled, key: tx.key },
-            };
+            const raw = await wallet.getVtxos();
+            const list = Array.isArray(raw)
+                ? raw
+                : Array.isArray(raw?.vtxos)
+                    ? raw.vtxos
+                    : [];
+            const spendableBtc = list.filter((vtxo) => {
+                if (!isSpendable(vtxo))
+                    return false;
+                // Exclude VTXOs carrying assets — sendBitcoin would either reject
+                // them or accidentally burn the asset side. Pure BTC only.
+                const assets = vtxo.assets;
+                if (Array.isArray(assets) && assets.length > 0)
+                    return false;
+                return true;
+            });
+            const selected = selectVtxosByExpiry(spendableBtc, targetSats);
+            return selected ?? undefined;
         }
-        catch {
-            return null;
+        catch (error) {
+            log.warn("[ArkadeAdapter] selectSpendableBtcVtxos failed; falling back to SDK default selection:", error);
+            return undefined;
         }
     }
-    toNumber(value) {
-        if (typeof value === 'number' && Number.isFinite(value))
-            return value;
-        if (typeof value === 'bigint')
-            return Number(value);
-        if (typeof value === 'string' && value.trim() !== '') {
-            const parsed = Number(value);
-            return Number.isFinite(parsed) ? parsed : 0;
+    async getWalletBalanceSummary(wallet) {
+        const balance = await wallet.getBalance();
+        const normalized = {
+            boardingConfirmed: toNumber(balance?.boarding?.confirmed),
+            boardingUnconfirmed: toNumber(balance?.boarding?.unconfirmed),
+            boardingTotal: toNumber(balance?.boarding?.total),
+            settled: toNumber(balance?.settled),
+            preconfirmed: toNumber(balance?.preconfirmed),
+            available: toNumber(balance?.available),
+            recoverable: toNumber(balance?.recoverable),
+            total: toNumber(balance?.total),
+        };
+        let normalizedVtxos = [];
+        try {
+            normalizedVtxos = normalizeVtxos(await wallet.getVtxos());
+        }
+        catch (error) {
+            log.warn("[ArkadeAdapter] Failed to derive balance from VTXOs, falling back to wallet.getBalance()", error);
         }
-        return 0;
+        if (normalizedVtxos.length === 0) {
+            // Mirror the vtxo path: boarding UTXOs must be counted in total even
+            // when there are no VTXOs. The SDK's top-level balance.total omits the
+            // boarding portion, so we compute it the same way as the vtxo path below.
+            const available = normalized.settled + normalized.preconfirmed;
+            return {
+                ...normalized,
+                available,
+                total: normalized.boardingTotal + available + normalized.recoverable,
+            };
+        }
+        const vtxoSummary = normalizedVtxos.reduce((summary, vtxo) => {
+            if (vtxo.state === "swept") {
+                summary.recoverable += vtxo.value;
+            }
+            else if (vtxo.state === "preconfirmed") {
+                summary.preconfirmed += vtxo.value;
+            }
+            else {
+                summary.settled += vtxo.value;
+            }
+            return summary;
+        }, {
+            settled: 0,
+            preconfirmed: 0,
+            recoverable: 0,
+        });
+        const available = vtxoSummary.settled + vtxoSummary.preconfirmed;
+        const total = normalized.boardingTotal + available + vtxoSummary.recoverable;
+        return {
+            ...normalized,
+            settled: vtxoSummary.settled,
+            preconfirmed: vtxoSummary.preconfirmed,
+            available,
+            recoverable: vtxoSummary.recoverable,
+            total,
+        };
     }
-    formatSats(sats) {
-        return (sats / 1e8).toFixed(8);
+    async getCachedAssetDetails(wallet, assetId) {
+        if (this.assetDetailsCache.has(assetId)) {
+            return this.assetDetailsCache.get(assetId) ?? null;
+        }
+        try {
+            const details = await wallet.assetManager.getAssetDetails(assetId);
+            const normalized = details && typeof details === "object" ? details : null;
+            this.assetDetailsCache.set(assetId, normalized);
+            return normalized;
+        }
+        catch (error) {
+            log.warn("[ArkadeAdapter] Failed to fetch asset details for", assetId, error);
+            this.assetDetailsCache.set(assetId, null);
+            return null;
+        }
     }
 }
 //# sourceMappingURL=ArkadeAdapter.js.map