@kaleidorg/wallet-engine 1.0.0-beta.38 → 1.0.0-beta.41

package/dist/adapters/flashnet.d.ts

@@ -11,4 +11,5 @@
  */
 export { flashnetClientManager } from '../lib/flashnet-client-manager.js';
 export * from '../lib/orchestra-client.js';
+export { isFlashnetError } from '@flashnet/sdk';
 //# sourceMappingURL=flashnet.d.ts.map

package/dist/adapters/flashnet.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flashnet.d.ts","sourceRoot":"","sources":["../../src/adapters/flashnet.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAA;AACtE,cAAc,yBAAyB,CAAA"}
+{"version":3,"file":"flashnet.d.ts","sourceRoot":"","sources":["../../src/adapters/flashnet.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAA;AACtE,cAAc,yBAAyB,CAAA;AAGvC,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA"}

package/dist/adapters/flashnet.js

@@ -11,4 +11,7 @@
  */
 export { flashnetClientManager } from '../lib/flashnet-client-manager.js';
 export * from '../lib/orchestra-client.js';
+// Re-export the SDK error guard so consumers classify Flashnet errors through
+// the engine (no direct `@flashnet/sdk` dependency in the host).
+export { isFlashnetError } from '@flashnet/sdk';
 //# sourceMappingURL=flashnet.js.map

package/dist/adapters/flashnet.js.map

@@ -1 +1 @@
-{"version":3,"file":"flashnet.js","sourceRoot":"","sources":["../../src/adapters/flashnet.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAA;AACtE,cAAc,yBAAyB,CAAA"}
+{"version":3,"file":"flashnet.js","sourceRoot":"","sources":["../../src/adapters/flashnet.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAA;AACtE,cAAc,yBAAyB,CAAA;AACvC,8EAA8E;AAC9E,iEAAiE;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA"}

package/dist/adapters/wdk/ArkadeWdkAdapter.d.ts

@@ -7,19 +7,22 @@
  * receive via Boltz reverse submarine swaps.
  *
  * Discipline: no WDK/@arkade-os types cross the contract — domain types only;
- * module objects are read as `any`.
+ * module objects are read as `any`. The WDK **account** surface is the primary path;
+ * the underlying @arkade-os/sdk Wallet (`account._signingWallet`) is reached only for
+ * the VTXO-lifecycle ops the WDK surface does not expose (getVtxos, getBoardingUtxos,
+ * onboard, offboard, rich balance summary) — ported from the native ArkadeAdapter.
+ * `@arkade-os/sdk` is lazy-loaded in `connect()` so this sub-path stays SDK-free until used.
  *
- * Arkade WDK surface (from JSDoc in the cloned source, v0.1.3):
+ * Arkade WDK surface (from JSDoc, v0.1.4):
  *   read-only: getAddress(): string (Ark address, inherited), getBoardingAddress(): string,
  *              getBalance(): bigint, getTokenBalance(id): bigint, getTransactionHistory()
  *   account:   sendTransaction({to,value}), transfer({token,recipient,amount}),
  *              createLightningInvoice(amountSats, description?): {invoice,paymentHash},
  *              waitForLightningPayment(invoice): {txid}, getLightningLimits/Fees,
- *              subscribeToIncomingFunds, sign, dispose
- *   NOTE: Lightning *send* (pay a BOLT11) is not exposed as a simple method in v0.1.3.
+ *              arkadeSwaps (Boltz client, for Lightning send), subscribeToIncomingFunds, sign, dispose
  */
 import { IProtocolAdapter, BaseProtocolConfig } from '../IProtocolAdapter.js';
-import { ProtocolType, Layer, UnifiedAsset, UnifiedTransaction, InvoiceRequest, Invoice, DecodedInvoice, PaymentRequest, PaymentResult, PaymentStatus, Address, ConnectionInfo, TransactionFilter } from '../../types/base.js';
+import { ProtocolType, Layer, NodeInfo, UnifiedAsset, UnifiedTransaction, InvoiceRequest, Invoice, DecodedInvoice, PaymentRequest, PaymentResult, PaymentStatus, Address, ConnectionInfo, TransactionFilter } from '../../types/base.js';
 import { BaseWdkAdapter } from './BaseWdkAdapter.js';
 export interface ArkadeAdapterConfig extends BaseProtocolConfig {
     protocol: 'ARKADE';
@@ -34,10 +37,16 @@ export declare class ArkadeWdkAdapter extends BaseWdkAdapter implements IProtoco
     readonly protocolName: ProtocolType;
     readonly capabilities: readonly import("../../index.js").ProtocolCapability[];
     readonly supportedLayers: Layer[];
+    /** BIP-39 mnemonic — retained for message signing (derives its own key). */
+    private mnemonic;
+    /** Lazily-loaded `@arkade-os/sdk` (for Ramps onboard/offboard). Kept off the static import graph. */
+    private arkSdk;
+    /** The underlying @arkade-os/sdk Wallet the WDK account wraps — for VTXO-lifecycle ops. */
+    private get rawWallet();
     connect(config: BaseProtocolConfig): Promise<void>;
     getConnectionInfo(): Promise<ConnectionInfo>;
     /** Default Ark address. For the on-chain boarding address use `getBoardingAddress`. */
-    getReceiveAddress(_assetId?: string): Promise<Address>;
+    getReceiveAddress(assetId?: string): Promise<Address>;
     /** On-chain BTC boarding address for funding the Arkade account. */
     getBoardingAddress(): Promise<Address>;
     getBtcBalance(): Promise<{
@@ -49,7 +58,14 @@ export declare class ArkadeWdkAdapter extends BaseWdkAdapter implements IProtoco
     listAssets(): Promise<UnifiedAsset[]>;
     getAssetBalance(assetId: string): Promise<UnifiedAsset['balance']>;
     getAsset(assetId: string): Promise<UnifiedAsset>;
+    /** Arkade on-chain receive is an address, not a bolt11 invoice (mirrors the native adapter). */
     createInvoice(request: InvoiceRequest): Promise<Invoice>;
+    /**
+     * Boltz reverse-swap Lightning invoice that lands 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.
+     */
+    createArkadeLightningInvoice(request: InvoiceRequest): Promise<Invoice>;
     decodeInvoice(invoice: string): Promise<DecodedInvoice>;
     sendPayment(request: PaymentRequest): Promise<PaymentResult>;
     /** Arkade BTC send/offboard. Bitcoin destinations settle on-chain asynchronously. */
@@ -67,11 +83,30 @@ export declare class ArkadeWdkAdapter extends BaseWdkAdapter implements IProtoco
     getPaymentStatus(paymentHash: string): Promise<PaymentStatus>;
     listTransactions(_filter?: TransactionFilter): Promise<UnifiedTransaction[]>;
     getTransaction(txId: string): Promise<UnifiedTransaction>;
-    getNodeInfo(): Promise<any>;
+    getNodeInfo(): Promise<NodeInfo>;
     listChannels(): Promise<any[]>;
     listPayments(): Promise<any>;
     listTransfers(): Promise<any>;
+    /** All VTXOs, sorted by batchExpiry ascending (expiry-first) so soon-to-expire coins surface first. */
+    getVtxos(): Promise<Record<string, unknown>[]>;
+    getBoardingUtxos(): Promise<Record<string, unknown>[]>;
+    /** Onboard — settle confirmed boarding UTXOs into VTXOs via a Commitment Transaction. */
+    onboard(): Promise<{
+        txid: string;
+    }>;
+    /** Offboard — collaborative exit: convert VTXOs back to an on-chain Bitcoin UTXO. */
+    offboard(address: string, amount?: number): Promise<{
+        txid: string;
+    }>;
+    signMessage(message: string): Promise<string>;
+    verifyMessage(message: string, signature: string): Promise<string>;
     /** Escape hatch for Arkade-specific ops (waitForLightningPayment, getLightningLimits, …) — allowlisted. */
     executeProtocolOperation(operation: string, params: any): Promise<any>;
+    /**
+     * Rich balance summary derived from VTXOs + boarding UTXOs (ported from the native
+     * adapter). The SDK's top-level `balance.total` omits the boarding portion, so we
+     * recompute it: available = settled + preconfirmed; total includes boarding + recoverable.
+     */
+    private getWalletBalanceSummary;
 }
 //# sourceMappingURL=ArkadeWdkAdapter.d.ts.map

package/dist/adapters/wdk/ArkadeWdkAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ArkadeWdkAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/wdk/ArkadeWdkAdapter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ArkadeWdkAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/wdk/ArkadeWdkAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AAC1E,OAAO,EACL,YAAY,EACZ,KAAK,EACL,QAAQ,EACR,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,OAAO,EACP,cAAc,EACd,cAAc,EACd,aAAa,EACb,aAAa,EACb,OAAO,EACP,cAAc,EACd,iBAAiB,EAGlB,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAcjD,MAAM,WAAW,mBAAoB,SAAQ,kBAAkB;IAC7D,QAAQ,EAAE,QAAQ,CAAA;IAClB,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAA;IAChB,wCAAwC;IACxC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,6GAA6G;IAC7G,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CACnC;AAiBD,qBAAa,gBAAiB,SAAQ,cAAe,YAAW,gBAAgB;IAC9E,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAW;IAC9C,QAAQ,CAAC,YAAY,gDAA6B;IAClD,QAAQ,CAAC,eAAe,EAAE,KAAK,EAAE,CAAmC;IAEpE,4EAA4E;IAC5E,OAAO,CAAC,QAAQ,CAAsB;IAEtC,qGAAqG;IACrG,OAAO,CAAC,MAAM,CAAY;IAE1B,2FAA2F;IAC3F,OAAO,KAAK,SAAS,GAIpB;IAGK,OAAO,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAiClD,iBAAiB,IAAI,OAAO,CAAC,cAAc,CAAC;IAWlD,uFAAuF;IACjF,iBAAiB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAW3D,oEAAoE;IAC9D,kBAAkB,IAAI,OAAO,CAAC,OAAO,CAAC;IAOtC,aAAa,IAAI,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAQnF,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAIhC,UAAU,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IA4DrC,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;IAWlE,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAQtD,gGAAgG;IAC1F,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAY9D;;;;OAIG;IACG,4BAA4B,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAgBvE,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAUvD,WAAW,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAsDlE,qFAAqF;IAC/E,cAAc,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,aAAa,CAAC;IAiB3G,qCAAqC;IAC/B,SAAS,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,GAAG,CAAC;IAKrF,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAQ7D,gBAAgB,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IA0B5E,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAQzD,WAAW,IAAI,OAAO,CAAC,QAAQ,CAAC;IAgBhC,YAAY,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAI9B,YAAY,IAAI,OAAO,CAAC,GAAG,CAAC;IAK5B,aAAa,IAAI,OAAO,CAAC,GAAG,CAAC;IAKnC,uGAAuG;IACjG,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAe9C,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAW5D,yFAAyF;IACnF,OAAO,IAAI,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAQ1C,qFAAqF;IAC/E,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAiBrE,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAY7C,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIxE,2GAA2G;IACrG,wBAAwB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IAK5E;;;;OAIG;YACW,uBAAuB;CAqDtC"}

package/dist/adapters/wdk/ArkadeWdkAdapter.js

@@ -7,16 +7,19 @@
  * receive via Boltz reverse submarine swaps.
  *
  * Discipline: no WDK/@arkade-os types cross the contract — domain types only;
- * module objects are read as `any`.
+ * module objects are read as `any`. The WDK **account** surface is the primary path;
+ * the underlying @arkade-os/sdk Wallet (`account._signingWallet`) is reached only for
+ * the VTXO-lifecycle ops the WDK surface does not expose (getVtxos, getBoardingUtxos,
+ * onboard, offboard, rich balance summary) — ported from the native ArkadeAdapter.
+ * `@arkade-os/sdk` is lazy-loaded in `connect()` so this sub-path stays SDK-free until used.
  *
- * Arkade WDK surface (from JSDoc in the cloned source, v0.1.3):
+ * Arkade WDK surface (from JSDoc, v0.1.4):
  *   read-only: getAddress(): string (Ark address, inherited), getBoardingAddress(): string,
  *              getBalance(): bigint, getTokenBalance(id): bigint, getTransactionHistory()
  *   account:   sendTransaction({to,value}), transfer({token,recipient,amount}),
  *              createLightningInvoice(amountSats, description?): {invoice,paymentHash},
  *              waitForLightningPayment(invoice): {txid}, getLightningLimits/Fees,
- *              subscribeToIncomingFunds, sign, dispose
- *   NOTE: Lightning *send* (pay a BOLT11) is not exposed as a simple method in v0.1.3.
+ *              arkadeSwaps (Boltz client, for Lightning send), subscribeToIncomingFunds, sign, dispose
  */
 import { ProtocolError, } from '../../types/base.js';
 import { getCapabilities } from '../../capabilities/index.js';
@@ -24,10 +27,18 @@ import { BaseWdkAdapter } from './BaseWdkAdapter.js';
 import { PROTOCOL_OPERATIONS } from '../../capabilities/operations.js';
 import { loadWdkModule } from './moduleLoader.js';
 import { decodeBolt11, isBolt11 } from '../../lib/bolt11.js';
+import { normalizeVtxos, sortVtxosByExpiry, toNumber } from '../../lib/arkade-helpers.js';
+import { signLnMessage, verifyLnMessage } from '../../lib/ln-message-sign.js';
+import { resolveWalletSeed } from '../../lib/wallet-seed.js';
 const isBitcoinAddress = (value) => /^(bc1|tb1|bcrt1)/i.test(value.trim());
+const isLightningInvoice = (value) => {
+    const body = value.trim().toLowerCase().replace(/^lightning:/, '');
+    return /^ln(bc|tb|bcrt|sb)/.test(body);
+};
 /**
  * Allowlist of Arkade account methods reachable via `executeProtocolOperation`.
- * Anything not listed here is rejected — see the method's SECURITY note.
+ * VTXO-lifecycle ops (onboard/offboard/getVtxos/getBoardingUtxos) are now typed
+ * adapter methods, so they are intentionally NOT here.
  */
 const ARKADE_ALLOWED_OPS = new Set([
     'waitForLightningPayment',
@@ -37,10 +48,6 @@ const ARKADE_ALLOWED_OPS = new Set([
     'getBoardingAddress',
     'getTokenBalance',
     'getTransactionHistory',
-    'onboard',
-    'offboard',
-    'getVtxos',
-    'getBoardingUtxos',
 ]);
 export class ArkadeWdkAdapter extends BaseWdkAdapter {
     constructor() {
@@ -48,29 +55,67 @@ export class ArkadeWdkAdapter extends BaseWdkAdapter {
         this.protocolName = 'ARKADE';
         this.capabilities = PROTOCOL_OPERATIONS.ARKADE;
         this.supportedLayers = getCapabilities('ARKADE').layers;
+        /** BIP-39 mnemonic — retained for message signing (derives its own key). */
+        this.mnemonic = null;
+        /** Lazily-loaded `@arkade-os/sdk` (for Ramps onboard/offboard). Kept off the static import graph. */
+        this.arkSdk = null;
+    }
+    /** The underlying @arkade-os/sdk Wallet the WDK account wraps — for VTXO-lifecycle ops. */
+    get rawWallet() {
+        const w = this.account?._signingWallet ?? this.account?._wallet;
+        if (!w)
+            throw new ProtocolError('Arkade wallet unavailable', 'ARKADE', 'NOT_CONNECTED');
+        return w;
     }
     // --- Connection ---------------------------------------------------------
     async connect(config) {
         const cfg = config;
         if (!cfg.mnemonic)
             throw new ProtocolError('ArkadeWdkAdapter requires a mnemonic', 'ARKADE', 'CONFIG');
+        this.mnemonic = cfg.mnemonic;
         this.network = cfg.network ?? 'mainnet';
+        // Accept either an explicit `arkadeConfig` passthrough OR the native adapter's
+        // flat fields (arkServerUrl/esploraUrl/swapProviderUrl) — so hosts can switch
+        // to this adapter without reshaping their connect config. The WDK manager
+        // spreads this straight into @arkade-os/sdk's Wallet.create.
+        const arkadeConfig = cfg.arkadeConfig ??
+            {
+                ...(cfg.arkServerUrl ? { arkServerUrl: cfg.arkServerUrl } : {}),
+                ...(cfg.esploraUrl ? { esploraUrl: cfg.esploraUrl } : {}),
+                ...(cfg.swapProviderUrl ? { swapProviderUrl: cfg.swapProviderUrl } : {}),
+            };
         // @ts-ignore — external module, resolved at runtime in the consuming app.
         const mod = await loadWdkModule('@arkade-os/wdk', () => import('@arkade-os/wdk'));
         const WalletManagerArkade = mod.default ?? mod.WalletManagerArkade ?? mod;
-        this.manager = new WalletManagerArkade(cfg.mnemonic, cfg.arkadeConfig ?? {});
+        // Resolve to seed bytes so nsec/hex-rooted wallets bypass the WDK base's
+        // BIP-39 string validation (which throws "The seed phrase is invalid").
+        this.manager = new WalletManagerArkade(resolveWalletSeed(cfg.mnemonic), arkadeConfig);
         this.account = await this.manager.getAccount(cfg.accountIndex ?? 0);
+        // Lazy-load the SDK for Ramps (onboard/offboard). Off the static import graph.
+        // @ts-ignore — resolved at runtime; a transitive dep of the WDK Arkade module.
+        this.arkSdk = await loadWdkModule('@arkade-os/sdk', () => import('@arkade-os/sdk'));
         this.connected = true;
     }
     async getConnectionInfo() {
-        return { protocol: 'ARKADE', connected: this.connected, network: this.network };
+        this.assertConnected();
+        return {
+            protocol: 'ARKADE',
+            connected: this.connected,
+            network: this.network,
+            syncStatus: { synced: true, progress: 100 },
+        };
     }
     // --- Address / receive --------------------------------------------------
     /** Default Ark address. For the on-chain boarding address use `getBoardingAddress`. */
-    async getReceiveAddress(_assetId) {
+    async getReceiveAddress(assetId) {
         this.assertConnected();
+        // 'onchain'/'boarding' → on-chain boarding address for funding.
+        if (assetId === 'onchain' || assetId === 'boarding') {
+            const address = await this.account.getBoardingAddress();
+            return { address, format: 'BTC_ADDRESS', asset: 'BTC' };
+        }
         const address = await this.account.getAddress();
-        return { address, format: 'ARKADE_ADDRESS' };
+        return { address, format: 'ARKADE_ADDRESS', asset: assetId && assetId !== 'BTC' ? assetId : 'BTC' };
     }
     /** On-chain BTC boarding address for funding the Arkade account. */
     async getBoardingAddress() {
@@ -81,33 +126,40 @@ export class ArkadeWdkAdapter extends BaseWdkAdapter {
     // --- Balance ------------------------------------------------------------
     async getBtcBalance() {
         this.assertConnected();
-        const bal = await this.account.getBalance();
-        const total = Number(bal);
-        return { confirmed: total, unconfirmed: 0, total };
+        const b = await this.getWalletBalanceSummary();
+        // preconfirmed VTXOs are spendable, so `confirmed` = settled + preconfirmed.
+        const confirmed = b.available;
+        return { confirmed, unconfirmed: Math.max(b.total - confirmed, 0), total: b.total };
     }
     async refreshBalances() {
         // Arkade syncs against the indexer on read; no explicit sync call.
     }
     async listAssets() {
         this.assertConnected();
-        const { total } = await this.getBtcBalance();
+        const b = await this.getWalletBalanceSummary();
         const btc = {
             id: 'BTC',
-            name: 'Bitcoin',
+            name: 'Bitcoin (Arkade)',
             ticker: 'BTC',
             precision: 8,
             protocol: 'ARKADE',
             layer: 'BTC_ARKADE',
-            balance: { total, available: total, pending: 0, totalDisplay: String(total), availableDisplay: String(total) },
-            capabilities: { canSend: true, canReceive: true, canSwap: false, supportsLightning: true, supportsOnchain: true },
+            balance: {
+                total: b.total,
+                available: b.available,
+                pending: 0,
+                locked: 0,
+                totalDisplay: String(b.total),
+                availableDisplay: String(b.available),
+            },
+            capabilities: { canSend: true, canReceive: true, canSwap: false, supportsLightning: false, supportsOnchain: true },
+            metadata: { boarding: b.boardingTotal, settled: b.settled, preconfirmed: b.preconfirmed, recoverable: b.recoverable },
         };
         const out = [btc];
-        // Arkade tokens. Per the extension's working adapter, the wallet's
-        // `getBalance()` already includes `assets: { assetId, amount }[]` — token
-        // discovery does NOT come from getVtxos(). Resolve metadata (decimals /
-        // ticker / name) via `assetManager.getAssetDetails(assetId).metadata`.
+        // Arkade tokens. The wallet's `getBalance()` includes `assets: { assetId, amount }[]`;
+        // resolve metadata via `assetManager.getAssetDetails(assetId).metadata`.
         try {
-            const wallet = this.account?._wallet;
+            const wallet = this.rawWallet;
             const rawBalance = wallet?.getBalance ? await wallet.getBalance() : null;
             const rawAssets = Array.isArray(rawBalance?.assets) ? rawBalance.assets : [];
             for (const entry of rawAssets) {
@@ -120,11 +172,11 @@ export class ArkadeWdkAdapter extends BaseWdkAdapter {
                     meta = (await wallet?.assetManager?.getAssetDetails?.(assetId))?.metadata ?? {};
                 }
                 catch {
-                    // metadata lookup is optional — fall back to the raw id
+                    /* metadata lookup is optional */
                 }
                 const decimals = Number(meta.decimals ?? 0) || 0;
-                const ticker = (typeof meta.ticker === 'string' && meta.ticker.trim()) ? meta.ticker : assetId.slice(0, 6);
-                const name = (typeof meta.name === 'string' && meta.name.trim()) ? meta.name : ticker;
+                const ticker = typeof meta.ticker === 'string' && meta.ticker.trim() ? meta.ticker : assetId.slice(0, 6);
+                const name = typeof meta.name === 'string' && meta.name.trim() ? meta.name : ticker;
                 out.push({
                     id: assetId,
                     name,
@@ -132,51 +184,66 @@ export class ArkadeWdkAdapter extends BaseWdkAdapter {
                     precision: decimals,
                     protocol: 'ARKADE',
                     layer: 'ARKADE_ARKADE',
-                    balance: {
-                        total: amount,
-                        available: amount,
-                        pending: 0,
-                        totalDisplay: String(amount),
-                        availableDisplay: String(amount),
-                    },
+                    balance: { total: amount, available: amount, pending: 0, totalDisplay: String(amount), availableDisplay: String(amount) },
                     icon: typeof meta.icon === 'string' ? meta.icon : undefined,
                     capabilities: { canSend: true, canReceive: true, canSwap: false, supportsLightning: false, supportsOnchain: false },
                 });
             }
         }
         catch {
-            // token enumeration is best-effort — keep BTC even if balance is unavailable
+            /* token enumeration is best-effort — keep BTC even if unavailable */
         }
         return out;
     }
     async getAssetBalance(assetId) {
         this.assertConnected();
+        if (assetId === 'BTC' || assetId.toLowerCase() === 'btc') {
+            const { balance } = await this.getAsset('BTC').then((a) => ({ balance: a.balance }));
+            return balance;
+        }
         const bal = await this.account.getTokenBalance(assetId);
         const n = Number(bal);
         return { total: n, available: n, pending: 0, totalDisplay: String(n), availableDisplay: String(n) };
     }
     async getAsset(assetId) {
         const assets = await this.listAssets();
-        const found = assets.find((a) => a.id === assetId);
+        const found = assets.find((a) => a.id === assetId || a.ticker === assetId);
         if (!found)
             throw new ProtocolError(`Unknown asset ${assetId}`, 'ARKADE', 'NO_ASSET');
         return found;
     }
     // --- Invoices -----------------------------------------------------------
+    /** Arkade on-chain receive is an address, not a bolt11 invoice (mirrors the native adapter). */
     async createInvoice(request) {
         this.assertConnected();
-        if (request.layer === 'BTC_LN' || request.amount != null) {
-            // createLightningInvoice(amountSats, description?) — POSITIONAL args; via Boltz reverse swap.
-            const r = await this.account.createLightningInvoice(request.amount ?? 0, request.description);
-            return {
-                invoice: r?.invoice ?? '',
-                paymentHash: r?.paymentHash ?? '',
-                amount: request.amount,
-                expiresAt: Date.now() + (request.expirySeconds ?? 3600) * 1000,
-                description: request.description,
-            };
+        const address = await this.account.getAddress();
+        return {
+            invoice: address,
+            paymentHash: '',
+            amount: request.amount,
+            expiresAt: Date.now() + (request.expirySeconds ?? 3600) * 1000,
+            description: request.description ?? 'Arkade receiving address',
+        };
+    }
+    /**
+     * Boltz reverse-swap Lightning invoice that lands 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) {
+        this.assertConnected();
+        if (!request.amount || request.amount <= 0) {
+            throw new ProtocolError('Amount is required for Boltz Lightning invoices into Arkade', 'ARKADE', 'INVALID_AMOUNT');
         }
-        throw new ProtocolError('Arkade on-chain receive uses getReceiveAddress/getBoardingAddress', 'ARKADE', 'NOT_SUPPORTED');
+        // createLightningInvoice(amountSats, description?) — POSITIONAL args; via Boltz reverse swap.
+        const r = await this.account.createLightningInvoice(request.amount, request.description);
+        return {
+            invoice: r?.invoice ?? '',
+            paymentHash: r?.paymentHash ?? '',
+            amount: request.amount,
+            expiresAt: Date.now() + (request.expirySeconds ?? 3600) * 1000,
+            description: request.description ?? 'Boltz reverse swap into Arkade',
+        };
     }
     async decodeInvoice(invoice) {
         const dest = invoice.trim();
@@ -190,16 +257,36 @@ export class ArkadeWdkAdapter extends BaseWdkAdapter {
     async sendPayment(request) {
         this.assertConnected();
         const dest = request.invoice.trim();
-        if (/^ln(bc|tb|bcrt)/i.test(dest)) {
-            // Lightning send via Boltz submarine swap is not exposed as a simple method in v0.1.3.
-            throw new ProtocolError('Arkade Lightning send not available in this module version', 'ARKADE', 'NOT_SUPPORTED');
+        // Lightning send via Boltz submarine swap (Arkade → Lightning), if the account exposes the swap client.
+        if (isLightningInvoice(dest)) {
+            const swaps = this.account?.arkadeSwaps;
+            if (!swaps?.sendLightningPayment) {
+                throw new ProtocolError('Arkade Lightning send not available in this module version', 'ARKADE', 'NOT_SUPPORTED');
+            }
+            const invoiceBody = dest.toLowerCase().startsWith('lightning:') ? dest.slice('lightning:'.length) : dest;
+            try {
+                const result = await swaps.sendLightningPayment({ invoice: invoiceBody });
+                return {
+                    paymentHash: result?.preimage ?? result?.txid ?? '',
+                    amount: Number(result?.amount ?? request.amount ?? 0),
+                    fee: 0,
+                    status: 'pending',
+                    timestamp: Date.now(),
+                };
+            }
+            catch (error) {
+                const msg = error instanceof Error ? error.message : String(error);
+                if (/less than minimal/i.test(msg)) {
+                    throw new ProtocolError("Arkade can't pay amountless Lightning invoices. Ask the recipient for an invoice with an amount.", 'ARKADE', 'INVALID_AMOUNT');
+                }
+                throw new ProtocolError(`Failed to send Lightning payment via Boltz: ${msg}`, 'ARKADE', 'SEND_PAYMENT_ERROR');
+            }
         }
         if (request.amount == null) {
             throw new ProtocolError('Arkade send requires an explicit amount', 'ARKADE', 'NO_AMOUNT');
         }
         // Bitcoin destination → on-chain offboard. Route through sendBtcOnchain so the
-        // missing-tx-id guard and async `pending` status apply regardless of entry point
-        // (otherwise a BTC offboard with no hash would falsely report success).
+        // missing-tx-id guard and async `pending` status apply regardless of entry point.
         if (isBitcoinAddress(dest)) {
             return this.sendBtcOnchain({ address: dest, amount: request.amount });
         }
@@ -251,11 +338,8 @@ export class ArkadeWdkAdapter extends BaseWdkAdapter {
             // @arkade-os/sdk ArkTransaction shape:
             //   { key:{ arkTxid, commitmentTxid, boardingTxid }, type:'SENT'|'RECEIVED',
             //     amount(sats, net), settled(boolean), createdAt(ms since epoch) }.
-            // The txid lives on `key` (the unused fields are empty strings, so we must
-            // pick the first NON-EMPTY one — `??` would stop at `''`). Direction is the
-            // explicit `type`, not the amount sign (amount is reported as a magnitude).
-            // `createdAt` is already milliseconds; the old `* 1000` pushed every entry
-            // ~50k years into the future, breaking sort order and the displayed date.
+            // The txid lives on `key` (unused fields are empty strings, so pick the first
+            // NON-EMPTY one — `??` would stop at `''`). Direction is the explicit `type`.
             const key = t?.key ?? {};
             const id = t?.txid || key.arkTxid || key.commitmentTxid || key.boardingTxid || '';
             const isSend = String(t?.type ?? '').toUpperCase() === 'SENT';
@@ -279,21 +363,147 @@ export class ArkadeWdkAdapter extends BaseWdkAdapter {
             throw new ProtocolError(`Unknown tx ${txId}`, 'ARKADE', 'NO_TX');
         return found;
     }
+    // --- Node & balance -----------------------------------------------------
     async getNodeInfo() {
-        return { protocol: 'ARKADE', network: this.network };
+        this.assertConnected();
+        const b = await this.getWalletBalanceSummary();
+        const spendableSats = b.available;
+        return {
+            channelsBalanceMsat: spendableSats * 1000,
+            maxPayableMsat: spendableSats * 1000,
+            onchainBalanceMsat: b.boardingConfirmed * 1000,
+            pendingOnchainBalanceMsat: b.boardingUnconfirmed * 1000,
+            maxReceivableMsat: 0,
+            inboundLiquidityMsats: 0,
+            connectedPeers: [],
+            utxos: 0,
+        };
     }
     async listChannels() {
         return []; // Arkade has no LN channels (LN via Boltz swaps)
     }
     async listPayments() {
-        return this.listTransactions();
+        const txs = await this.listTransactions();
+        return { payments: txs };
     }
     async listTransfers() {
-        return this.account.getTransactionHistory();
+        return { transfers: [] };
+    }
+    // --- VTXO lifecycle -----------------------------------------------------
+    /** All VTXOs, sorted by batchExpiry ascending (expiry-first) so soon-to-expire coins surface first. */
+    async getVtxos() {
+        this.assertConnected();
+        const vtxos = await this.rawWallet.getVtxos();
+        return normalizeVtxos(sortVtxosByExpiry(vtxos)).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,
+        }));
+    }
+    async getBoardingUtxos() {
+        this.assertConnected();
+        const utxos = await this.rawWallet.getBoardingUtxos();
+        return (utxos ?? []).map((u) => ({
+            txid: u.txid,
+            vout: u.vout,
+            value: u.value,
+            confirmed: u.status?.confirmed ?? false,
+        }));
+    }
+    /** Onboard — settle confirmed boarding UTXOs into VTXOs via a Commitment Transaction. */
+    async onboard() {
+        this.assertConnected();
+        const wallet = this.rawWallet;
+        const info = await wallet.arkProvider.getInfo();
+        const commitmentTxid = await new this.arkSdk.Ramps(wallet).onboard(info.fees);
+        return { txid: commitmentTxid };
+    }
+    /** Offboard — collaborative exit: convert VTXOs back to an on-chain Bitcoin UTXO. */
+    async offboard(address, amount) {
+        this.assertConnected();
+        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}`, 'ARKADE', 'INVALID_AMOUNT');
+        }
+        const wallet = this.rawWallet;
+        const info = await wallet.arkProvider.getInfo();
+        const exitTxid = await new this.arkSdk.Ramps(wallet).offboard(address, info.fees, amount !== undefined ? BigInt(amount) : undefined);
+        return { txid: exitTxid };
+    }
+    // --- Message signing ----------------------------------------------------
+    async signMessage(message) {
+        if (!this.mnemonic)
+            throw new ProtocolError('Wallet mnemonic not available', 'ARKADE', 'NOT_CONNECTED');
+        const { mnemonicToSeedSync } = await import('@scure/bip39');
+        const { HDKey } = await import('@scure/bip32');
+        const seed = mnemonicToSeedSync(this.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);
     }
     /** Escape hatch for Arkade-specific ops (waitForLightningPayment, getLightningLimits, …) — allowlisted. */
     async executeProtocolOperation(operation, params) {
         return this.runAllowlistedOp(ARKADE_ALLOWED_OPS, operation, params);
     }
+    // --- Private helpers ----------------------------------------------------
+    /**
+     * Rich balance summary derived from VTXOs + boarding UTXOs (ported from the native
+     * adapter). The SDK's top-level `balance.total` omits the boarding portion, so we
+     * recompute it: available = settled + preconfirmed; total includes boarding + recoverable.
+     */
+    async getWalletBalanceSummary() {
+        const wallet = this.rawWallet;
+        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 {
+            /* fall back to wallet.getBalance() */
+        }
+        if (normalizedVtxos.length === 0) {
+            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;
+        return {
+            ...normalized,
+            settled: vtxoSummary.settled,
+            preconfirmed: vtxoSummary.preconfirmed,
+            available,
+            recoverable: vtxoSummary.recoverable,
+            total: normalized.boardingTotal + available + vtxoSummary.recoverable,
+        };
+    }
 }
 //# sourceMappingURL=ArkadeWdkAdapter.js.map