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

package/dist/lib/flashnet-client-manager.js

@@ -1,10 +1,16 @@
 /**
  * Flashnet Client Manager
- * Manages the lifecycle of a FlashnetClient from @flashnet/sdk.
+ * Singleton managing the lifecycle of a FlashnetClient from `@flashnet/sdk`.
  * Requires an initialized SparkWallet to function.
- * Ported from rate-extension/src/lib/flashnet-client-manager.ts
+ *
+ * Ported from rate-extension/src/protocols/spark/flashnet-client-manager.ts.
+ * The SDK is a value import (optional dependency) — consumers install
+ * `@flashnet/sdk` to use this manager, matching the Spark client-manager convention.
  */
-import { BTC_ASSET_PUBKEY, getFlashnetNetworkForSpark, getFlashnetUsdbTokenAddress, } from '../types/flashnet';
+import { FlashnetClient } from '@flashnet/sdk';
+import { BTC_ASSET_PUBKEY, USDB_DECIMALS, getFlashnetNetworkForSpark, getFlashnetUsdbTokenAddress, isUsdbTokenAddress, } from '../types/flashnet.js';
+import { log } from './log.js';
+import { saveSentTokenRecord } from './spark-sent-token-records.js';
 /**
  * Normalize the SDK pools response to always return an array.
  * The SDK may return `Pool[]` or `{ pools: Pool[] }`.
@@ -26,11 +32,6 @@ class FlashnetClientManager {
         this.poolId = null;
         this.network = null;
     }
-    /**
-     * Initialize with a SparkWallet instance.
-     * @param wallet - SparkWallet from @buildonspark/spark-sdk
-     * @param sparkNetwork - The Spark network ('mainnet' | 'regtest')
-     */
     initialize(wallet, sparkNetwork) {
         if (this.initPromise)
             return this.initPromise;
@@ -48,11 +49,12 @@ class FlashnetClientManager {
             throw new Error('Flashnet is only available when Spark is on mainnet or regtest.');
         }
         try {
-            const { FlashnetClient } = await import('@flashnet/sdk');
+            // The SDK accepts SparkWallet | IssuerSparkWallet but doesn't export a
+            // shared base — the cast keeps the call site honest while letting the
+            // rest of the file enjoy real types from the SDK.
             this.client = new FlashnetClient(wallet);
             await this.client.initialize();
             this.network = network;
-            // Auto-discover the largest BTC/USDB pool
             try {
                 const poolsResponse = await this.client.listPools({
                     assetAAddress: BTC_ASSET_PUBKEY,
@@ -61,12 +63,22 @@ class FlashnetClientManager {
                 });
                 const pools = normalizePoolsResponse(poolsResponse);
                 if (pools && pools.length > 0) {
-                    this.poolId = pools[0].lpPublicKey;
+                    // listPools returns LpPublicKey identifiers; we store the first
+                    // (highest-TVL) BTC↔USDB pool as the default for swap UX.
+                    const first = pools[0];
+                    if (first?.lpPublicKey)
+                        this.poolId = first.lpPublicKey;
                 }
             }
             catch (error) {
-                console.warn('[FlashnetClientManager] Pool discovery failed:', error);
+                log.warn('[FlashnetClientManager] Pool discovery failed:', error);
             }
+            // Backfill outgoing-swap history into the sent-token outbox so past
+            // token swaps (e.g. USDB → BTC) appear as sends in transaction history.
+            // Flashnet's AMM swap endpoint is the authoritative, retroactive source
+            // of direction — the Spark SDK exposes none for token transactions.
+            // Best-effort and async: never blocks or fails wallet init.
+            void this.backfillSwapHistory(wallet);
         }
         catch (error) {
             this.client = null;
@@ -76,12 +88,84 @@ class FlashnetClientManager {
             throw new Error(`Failed to initialize FlashnetClient: ${message}`);
         }
     }
+    /**
+     * Fetch the wallet's AMM swap history and persist the outgoing (token-in)
+     * legs to the sent-token outbox.
+     *
+     * A swap moves a token to the pool via an internal SDK transfer that the
+     * Spark token-transaction query cannot classify as a send. Flashnet's
+     * `GET /v1/swaps/user/{pubkey}` returns every past swap with explicit
+     * direction (assetIn / amountIn / inboundTransferId), so this both fixes
+     * future swaps and recovers ones made before any recording existed.
+     *
+     * Idempotent — records are keyed by transfer hash, so re-running on each
+     * connect simply refreshes them.
+     */
+    async backfillSwapHistory(wallet) {
+        const client = this.client;
+        if (!client)
+            return;
+        // `toHumanReadableTokenIdentifier` is private on FlashnetClient; the swap
+        // endpoint may return hex token ids, so normalize to the bech32 form the
+        // rest of the wallet uses when possible.
+        const toHumanReadable = (raw) => {
+            try {
+                const fn = client
+                    .toHumanReadableTokenIdentifier;
+                return fn ? fn.call(client, raw) : raw;
+            }
+            catch {
+                return raw;
+            }
+        };
+        try {
+            const senderSparkAddress = (await wallet.getSparkAddress());
+            const { swaps } = await client.getUserSwaps(undefined, {
+                sort: 'timestampDesc',
+                limit: 200,
+            });
+            let recorded = 0;
+            for (const swap of swaps ?? []) {
+                // Only the token-in leg is an outflow that needs the outbox. The
+                // token-out leg of a swap is a receive, already returned by the
+                // Spark token-transaction query.
+                const assetIn = swap?.assetInAddress;
+                const inboundTransferId = swap?.inboundTransferId;
+                if (!assetIn || assetIn === BTC_ASSET_PUBKEY || !inboundTransferId)
+                    continue;
+                const assetId = toHumanReadable(assetIn);
+                const isUsdb = isUsdbTokenAddress(assetId);
+                const parsedTs = Date.parse(swap?.timestamp ?? '');
+                await saveSentTokenRecord({
+                    hash: inboundTransferId,
+                    senderSparkAddress,
+                    amount: Number(swap?.amountIn ?? 0) || 0,
+                    assetId,
+                    ticker: isUsdb ? 'USDB' : 'TOKEN',
+                    name: isUsdb ? 'USDB' : assetId,
+                    decimals: isUsdb ? USDB_DECIMALS : 0,
+                    timestamp: Number.isFinite(parsedTs) ? parsedTs : Date.now(),
+                });
+                recorded += 1;
+            }
+            if (recorded > 0) {
+                log.info(`[FlashnetClientManager] Backfilled ${recorded} outgoing swap(s) into token history`);
+            }
+        }
+        catch (error) {
+            log.warn('[FlashnetClientManager] Swap history backfill failed:', error);
+        }
+    }
     getClient() {
         if (!this.client) {
             throw new Error('FlashnetClient not initialized. Call initialize() first.');
         }
         return this.client;
     }
+    /** Convenience pass-through so callers don't need to await client.getBalance() through a cast. */
+    async getBalance() {
+        return this.getClient().getBalance();
+    }
     getPoolId() {
         return this.poolId;
     }
@@ -103,7 +187,7 @@ class FlashnetClientManager {
                 await this.client.cleanup();
             }
             catch (error) {
-                console.warn('[FlashnetClientManager] Disconnect error:', error);
+                log.warn('[FlashnetClientManager] Disconnect error:', error);
             }
         }
         this.client = null;

package/dist/lib/flashnet-client-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"flashnet-client-manager.js","sourceRoot":"","sources":["../../src/lib/flashnet-client-manager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"flashnet-client-manager.js","sourceRoot":"","sources":["../../src/lib/flashnet-client-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,cAAc,EAAsB,MAAM,eAAe,CAAA;AAClE,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,0BAA0B,EAC1B,2BAA2B,EAC3B,kBAAkB,GAEnB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAA;AAC3B,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAGhE;;;GAGG;AACH,SAAS,sBAAsB,CAAC,QAAiB;IAC/C,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;QAAE,OAAO,QAAQ,CAAA;IAC5C,IACE,QAAQ;QACR,OAAO,QAAQ,KAAK,QAAQ;QAC5B,KAAK,CAAC,OAAO,CAAE,QAAkC,CAAC,KAAK,CAAC,EACxD,CAAC;QACD,OAAQ,QAAiC,CAAC,KAAK,CAAA;IACjD,CAAC;IACD,OAAO,EAAE,CAAA;AACX,CAAC;AAED,MAAM,qBAAqB;IAA3B;QACU,WAAM,GAA0B,IAAI,CAAA;QACpC,gBAAW,GAAyB,IAAI,CAAA;QACxC,WAAM,GAAkB,IAAI,CAAA;QAC5B,YAAO,GAA2B,IAAI,CAAA;IAoLhD,CAAC;IAlLC,UAAU,CAAC,MAAmB,EAAE,YAAqC;QACnE,IAAI,IAAI,CAAC,WAAW;YAAE,OAAO,IAAI,CAAC,WAAW,CAAA;QAC7C,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE;YACtE,IAAI,CAAC,WAAW,GAAG,IAAI,CAAA;QACzB,CAAC,CAAC,CAAA;QACF,OAAO,IAAI,CAAC,WAAW,CAAA;IACzB,CAAC;IAEO,KAAK,CAAC,YAAY,CACxB,MAAmB,EACnB,YAAqC;QAErC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,IAAI,CAAC,UAAU,EAAE,CAAA;QACzB,CAAC;QAED,MAAM,OAAO,GAAG,0BAA0B,CAAC,YAAY,CAAC,CAAA;QACxD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAA;QACpF,CAAC;QAED,IAAI,CAAC;YACH,uEAAuE;YACvE,sEAAsE;YACtE,kDAAkD;YAClD,IAAI,CAAC,MAAM,GAAG,IAAI,cAAc,CAAC,MAAe,CAAC,CAAA;YACjD,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAA;YAC9B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;YAEtB,IAAI,CAAC;gBACH,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC;oBAChD,aAAa,EAAE,gBAAgB;oBAC/B,aAAa,EAAE,2BAA2B,CAAC,OAAO,CAAC;oBACnD,IAAI,EAAE,UAAU;iBACjB,CAAC,CAAA;gBACF,MAAM,KAAK,GAAG,sBAAsB,CAAC,aAAa,CAAC,CAAA;gBACnD,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC9B,gEAAgE;oBAChE,0DAA0D;oBAC1D,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAA6B,CAAA;oBAClD,IAAI,KAAK,EAAE,WAAW;wBAAE,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,WAAW,CAAA;gBACzD,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,GAAG,CAAC,IAAI,CAAC,gDAAgD,EAAE,KAAK,CAAC,CAAA;YACnE,CAAC;YAED,oEAAoE;YACpE,wEAAwE;YACxE,wEAAwE;YACxE,oEAAoE;YACpE,4DAA4D;YAC5D,KAAK,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAA;QACvC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,GAAG,IAAI,CAAA;YAClB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAA;YAClB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAA;YACnB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;YACtE,MAAM,IAAI,KAAK,CAAC,wCAAwC,OAAO,EAAE,CAAC,CAAA;QACpE,CAAC;IACH,CAAC;IAED;;;;;;;;;;;;OAYG;IACK,KAAK,CAAC,mBAAmB,CAAC,MAAmB;QACnD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAA;QAC1B,IAAI,CAAC,MAAM;YAAE,OAAM;QAEnB,0EAA0E;QAC1E,yEAAyE;QACzE,yCAAyC;QACzC,MAAM,eAAe,GAAG,CAAC,GAAW,EAAU,EAAE;YAC9C,IAAI,CAAC;gBACH,MAAM,EAAE,GAAI,MAA6E;qBACtF,8BAA8B,CAAA;gBACjC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAA;YACxC,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,GAAG,CAAA;YACZ,CAAC;QACH,CAAC,CAAA;QAED,IAAI,CAAC;YACH,MAAM,kBAAkB,GAAG,CAAC,MAAM,MAAM,CAAC,eAAe,EAAE,CAAW,CAAA;YACrE,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,SAAS,EAAE;gBACrD,IAAI,EAAE,eAAe;gBACrB,KAAK,EAAE,GAAG;aACX,CAAC,CAAA;YAEF,IAAI,QAAQ,GAAG,CAAC,CAAA;YAChB,KAAK,MAAM,IAAI,IAAI,KAAK,IAAI,EAAE,EAAE,CAAC;gBAC/B,iEAAiE;gBACjE,gEAAgE;gBAChE,iCAAiC;gBACjC,MAAM,OAAO,GAAG,IAAI,EAAE,cAAc,CAAA;gBACpC,MAAM,iBAAiB,GAAG,IAAI,EAAE,iBAAiB,CAAA;gBACjD,IAAI,CAAC,OAAO,IAAI,OAAO,KAAK,gBAAgB,IAAI,CAAC,iBAAiB;oBAAE,SAAQ;gBAE5E,MAAM,OAAO,GAAG,eAAe,CAAC,OAAO,CAAC,CAAA;gBACxC,MAAM,MAAM,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAA;gBAC1C,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,SAAS,IAAI,EAAE,CAAC,CAAA;gBAElD,MAAM,mBAAmB,CAAC;oBACxB,IAAI,EAAE,iBAAiB;oBACvB,kBAAkB;oBAClB,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,QAAQ,IAAI,CAAC,CAAC,IAAI,CAAC;oBACxC,OAAO;oBACP,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO;oBACjC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO;oBAC/B,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;oBACpC,SAAS,EAAE,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE;iBAC7D,CAAC,CAAA;gBACF,QAAQ,IAAI,CAAC,CAAA;YACf,CAAC;YAED,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;gBACjB,GAAG,CAAC,IAAI,CACN,sCAAsC,QAAQ,sCAAsC,CACrF,CAAA;YACH,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,GAAG,CAAC,IAAI,CAAC,uDAAuD,EAAE,KAAK,CAAC,CAAA;QAC1E,CAAC;IACH,CAAC;IAED,SAAS;QACP,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAA;QAC7E,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAA;IACpB,CAAC;IAED,kGAAkG;IAClG,KAAK,CAAC,UAAU;QACd,OAAO,IAAI,CAAC,SAAS,EAAE,CAAC,UAAU,EAAE,CAAA;IACtC,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAA;IACpB,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,OAAO,CAAA;IACrB,CAAC;IAED,mBAAmB;QACjB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAA;QAC/E,CAAC;QACD,OAAO,2BAA2B,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAClD,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC,MAAM,KAAK,IAAI,CAAA;IAC7B,CAAC;IAED,KAAK,CAAC,UAAU;QACd,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAA;YAC7B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,GAAG,CAAC,IAAI,CAAC,2CAA2C,EAAE,KAAK,CAAC,CAAA;YAC9D,CAAC;QACH,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAA;QAClB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAA;QAClB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAA;QACnB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAA;IACzB,CAAC;CACF;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,qBAAqB,EAAE,CAAA"}

package/dist/lib/kaleido-client-manager.d.ts

@@ -1,24 +1,59 @@
 /**
  * KaleidoClient Manager
- * Singleton manager for KaleidoClient lifecycle.
- * Ported from rate-extension/src/lib/kaleido-client-manager.ts
+ * Singleton manager for KaleidoClient lifecycle (RGB Lightning node + Kaleidoswap maker).
+ *
+ * Transport is either "http" (kaleido-sdk's HTTP RlnClient) or "nwc" (an
+ * RLN-shaped client over Nostr Wallet Connect). The NWC implementation carries
+ * a nostr/relay dependency, so it is NOT bundled here — the consumer injects a
+ * factory via `setNwcRlnClientFactory()` (the extension supplies its NwcRlnClient;
+ * React Native / node hosts that don't use NWC never register one).
  */
-import { KaleidoClient } from 'kaleido-sdk';
+import { KaleidoClient } from "kaleido-sdk";
+import type { RgbTransport } from "../types/rgb.js";
 export interface KaleidoClientConfig {
     baseUrl: string;
     nodeUrl?: string;
     apiKey?: string;
     timeout?: number;
+    /** Node transport. Defaults to "http". */
+    transport?: RgbTransport;
+    /** `nostr+walletconnect://` connection string — required when transport === "nwc". */
+    nwcUri?: string;
 }
+/** RLN-shaped client the NWC transport must provide (mirrors kaleido-sdk's RlnClient). */
+export interface NwcRlnClientLike {
+    close(): void;
+    [method: string]: unknown;
+}
+/** Consumer-injected factory that builds an NWC-backed RLN client from a connection string. */
+export type NwcRlnClientFactory = (nwcUri: string) => NwcRlnClientLike;
+/**
+ * Register the NWC-backed RLN client factory. The extension calls this once at
+ * startup with `(uri) => new NwcRlnClient(uri)`. Without it, transport "nwc" throws.
+ */
+export declare function setNwcRlnClientFactory(factory: NwcRlnClientFactory): void;
 declare class KaleidoClientManager {
     private client;
     private config;
+    /** Held only in NWC mode so reset() can tear down the relay pool. */
+    private nwcRln;
+    /** Initialize the KaleidoClient with configuration. */
     initialize(config: KaleidoClientConfig): void;
+    /** @throws if not initialized */
     getClient(): KaleidoClient;
     isInitialized(): boolean;
+    /**
+     * Check if a node is reachable — either an HTTP node URL or an NWC link.
+     * Gates almost every RLN operation in the adapter.
+     */
     hasNode(): boolean;
     getConfig(): KaleidoClientConfig | null;
+    /**
+     * Reset the client (disconnect and clear). Tears down the NWC relay pool
+     * when running the NWC transport so we don't leak sockets on reconnect.
+     */
     reset(): void;
+    /** Update configuration (re-initializes the client). */
     updateConfig(config: Partial<KaleidoClientConfig>): void;
 }
 export declare const kaleidoClientManager: KaleidoClientManager;

package/dist/lib/kaleido-client-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"kaleido-client-manager.d.ts","sourceRoot":"","sources":["../../src/lib/kaleido-client-manager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAE3C,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,cAAM,oBAAoB;IACxB,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,MAAM,CAAmC;IAEjD,UAAU,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI;IAgB7C,SAAS,IAAI,aAAa;IAO1B,aAAa,IAAI,OAAO;IAIxB,OAAO,IAAI,OAAO;IAIlB,SAAS,IAAI,mBAAmB,GAAG,IAAI;IAIvC,KAAK,IAAI,IAAI;IAMb,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,IAAI;CAOzD;AAED,eAAO,MAAM,oBAAoB,sBAA6B,CAAA"}
+{"version":3,"file":"kaleido-client-manager.d.ts","sourceRoot":"","sources":["../../src/lib/kaleido-client-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAI5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,SAAS,CAAC,EAAE,YAAY,CAAC;IACzB,sFAAsF;IACtF,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,0FAA0F;AAC1F,MAAM,WAAW,gBAAgB;IAC/B,KAAK,IAAI,IAAI,CAAC;IACd,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;CAC3B;AAED,+FAA+F;AAC/F,MAAM,MAAM,mBAAmB,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,gBAAgB,CAAC;AAIvE;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAEzE;AAyBD,cAAM,oBAAoB;IACxB,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,MAAM,CAAoC;IAClD,qEAAqE;IACrE,OAAO,CAAC,MAAM,CAAiC;IAE/C,uDAAuD;IACvD,UAAU,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI;IAuD7C,iCAAiC;IACjC,SAAS,IAAI,aAAa;IAO1B,aAAa,IAAI,OAAO;IAIxB;;;OAGG;IACH,OAAO,IAAI,OAAO;IAIlB,SAAS,IAAI,mBAAmB,GAAG,IAAI;IAIvC;;;OAGG;IACH,KAAK,IAAI,IAAI;IAQb,wDAAwD;IACxD,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,IAAI;CAMzD;AAED,eAAO,MAAM,oBAAoB,sBAA6B,CAAC"}

package/dist/lib/kaleido-client-manager.js

@@ -1,54 +1,123 @@
 /**
  * KaleidoClient Manager
- * Singleton manager for KaleidoClient lifecycle.
- * Ported from rate-extension/src/lib/kaleido-client-manager.ts
+ * Singleton manager for KaleidoClient lifecycle (RGB Lightning node + Kaleidoswap maker).
+ *
+ * Transport is either "http" (kaleido-sdk's HTTP RlnClient) or "nwc" (an
+ * RLN-shaped client over Nostr Wallet Connect). The NWC implementation carries
+ * a nostr/relay dependency, so it is NOT bundled here — the consumer injects a
+ * factory via `setNwcRlnClientFactory()` (the extension supplies its NwcRlnClient;
+ * React Native / node hosts that don't use NWC never register one).
  */
-import { KaleidoClient } from 'kaleido-sdk';
+import { KaleidoClient } from "kaleido-sdk";
+import { log } from "./log.js";
+import { ProtocolError } from "../types/base.js";
+let nwcRlnClientFactory = null;
+/**
+ * Register the NWC-backed RLN client factory. The extension calls this once at
+ * startup with `(uri) => new NwcRlnClient(uri)`. Without it, transport "nwc" throws.
+ */
+export function setNwcRlnClientFactory(factory) {
+    nwcRlnClientFactory = factory;
+}
+/**
+ * A MakerClient stand-in used in NWC mode when no maker URL is configured.
+ * Every access rejects with MAKER_NOT_CONFIGURED so swap flows fail loudly
+ * instead of silently hitting the wrong endpoint.
+ */
+function createMakerStub() {
+    return new Proxy({}, {
+        get() {
+            return () => Promise.reject(new ProtocolError("Maker API not configured. Set a maker URL to enable swaps.", "RGB_LN", "MAKER_NOT_CONFIGURED"));
+        },
+    });
+}
 class KaleidoClientManager {
     constructor() {
         this.client = null;
         this.config = null;
+        /** Held only in NWC mode so reset() can tear down the relay pool. */
+        this.nwcRln = null;
     }
+    /** Initialize the KaleidoClient with configuration. */
     initialize(config) {
+        // Tear down any prior NWC relay pool before replacing the client.
+        this.nwcRln?.close();
+        this.nwcRln = null;
         this.config = config;
+        if (config.transport === "nwc") {
+            if (!config.nwcUri) {
+                throw new ProtocolError("NWC connection string is required for transport 'nwc'", "RGB_LN", "NODE_NOT_CONFIGURED");
+            }
+            if (!nwcRlnClientFactory) {
+                throw new ProtocolError("NWC transport is not available: no NwcRlnClient factory registered. Call setNwcRlnClientFactory() at startup.", "RGB_LN", "NODE_NOT_CONFIGURED");
+            }
+            // Compose a KaleidoClient-shaped object: NWC-backed `.rln`, plus an
+            // optional HTTP `.maker` (a separate, transport-independent concern).
+            const rln = nwcRlnClientFactory(config.nwcUri);
+            this.nwcRln = rln;
+            const hasMaker = !!config.baseUrl;
+            const maker = hasMaker
+                ? KaleidoClient.create({ baseUrl: config.baseUrl, timeout: config.timeout }).maker
+                : createMakerStub();
+            this.client = {
+                rln,
+                maker,
+                hasNode: () => true,
+                hasMaker: () => hasMaker,
+                close: async () => rln.close(),
+            };
+            log.info("[KaleidoClientManager] Initialized NWC transport:", { hasMakerUrl: hasMaker });
+            return;
+        }
         this.client = KaleidoClient.create({
             baseUrl: config.baseUrl,
             nodeUrl: config.nodeUrl,
             apiKey: config.apiKey,
             timeout: config.timeout,
         });
-        console.log('[KaleidoClientManager] Initialized with config:', {
+        log.info("[KaleidoClientManager] Initialized with config:", {
             baseUrl: config.baseUrl,
             hasNodeUrl: !!config.nodeUrl,
             hasApiKey: !!config.apiKey,
         });
     }
+    /** @throws if not initialized */
     getClient() {
         if (!this.client) {
-            throw new Error('KaleidoClient not initialized. Call initialize() first.');
+            throw new Error("KaleidoClient not initialized. Call initialize() first.");
         }
         return this.client;
     }
     isInitialized() {
         return this.client !== null;
     }
+    /**
+     * Check if a node is reachable — either an HTTP node URL or an NWC link.
+     * Gates almost every RLN operation in the adapter.
+     */
     hasNode() {
-        return !!this.config?.nodeUrl;
+        return !!this.config?.nodeUrl || this.config?.transport === "nwc";
     }
     getConfig() {
         return this.config;
     }
+    /**
+     * Reset the client (disconnect and clear). Tears down the NWC relay pool
+     * when running the NWC transport so we don't leak sockets on reconnect.
+     */
     reset() {
+        this.nwcRln?.close();
+        this.nwcRln = null;
         this.client = null;
         this.config = null;
-        console.log('[KaleidoClientManager] Reset complete');
+        log.info("[KaleidoClientManager] Reset complete");
     }
+    /** Update configuration (re-initializes the client). */
     updateConfig(config) {
         if (!this.config) {
-            throw new Error('Cannot update config: client not initialized');
+            throw new Error("Cannot update config: client not initialized");
         }
-        const newConfig = { ...this.config, ...config };
-        this.initialize(newConfig);
+        this.initialize({ ...this.config, ...config });
     }
 }
 export const kaleidoClientManager = new KaleidoClientManager();

package/dist/lib/kaleido-client-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"kaleido-client-manager.js","sourceRoot":"","sources":["../../src/lib/kaleido-client-manager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAS3C,MAAM,oBAAoB;IAA1B;QACU,WAAM,GAAyB,IAAI,CAAA;QACnC,WAAM,GAA+B,IAAI,CAAA;IAkDnD,CAAC;IAhDC,UAAU,CAAC,MAA2B;QACpC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;QACpB,IAAI,CAAC,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC;YACjC,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,OAAO,EAAE,MAAM,CAAC,OAAO;SACxB,CAAC,CAAA;QAEF,OAAO,CAAC,GAAG,CAAC,iDAAiD,EAAE;YAC7D,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO;YAC5B,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM;SAC3B,CAAC,CAAA;IACJ,CAAC;IAED,SAAS;QACP,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAA;QAC5E,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAA;IACpB,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC,MAAM,KAAK,IAAI,CAAA;IAC7B,CAAC;IAED,OAAO;QACL,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAA;IAC/B,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAA;IACpB,CAAC;IAED,KAAK;QACH,IAAI,CAAC,MAAM,GAAG,IAAI,CAAA;QAClB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAA;QAClB,OAAO,CAAC,GAAG,CAAC,uCAAuC,CAAC,CAAA;IACtD,CAAC;IAED,YAAY,CAAC,MAAoC;QAC/C,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAA;QACjE,CAAC;QACD,MAAM,SAAS,GAAG,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAA;QAC/C,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAA;IAC5B,CAAC;CACF;AAED,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,oBAAoB,EAAE,CAAA"}
+{"version":3,"file":"kaleido-client-manager.js","sourceRoot":"","sources":["../../src/lib/kaleido-client-manager.ts"],"names":[],"mappings":"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"}

package/dist/lib/ln-message-sign.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Reject phishing-style messages that match the canonical LNURL-auth
+ * disclaimer. Signing one would expose the LNURL-auth identity.
+ */
+export declare function assertSafeToSign(message: string): void;
+/**
+ * Sign a message with the LND `signmessage` algorithm and return the
+ * zbase32-encoded recoverable signature.
+ */
+export declare function signLnMessage(message: string, privateKey: Uint8Array): string;
+/**
+ * Verify a zbase32-encoded LND signature against the supplied message.
+ * Returns the recovered compressed pubkey (hex) on success, or throws.
+ */
+export declare function verifyLnMessage(message: string, zbase32Signature: string): string;
+/**
+ * Verify a zbase32 signature is from a specific pubkey. Throws on mismatch.
+ */
+export declare function verifyLnMessageFrom(message: string, zbase32Signature: string, expectedPubkeyHex: string): void;
+//# sourceMappingURL=ln-message-sign.d.ts.map

package/dist/lib/ln-message-sign.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ln-message-sign.d.ts","sourceRoot":"","sources":["../../src/lib/ln-message-sign.ts"],"names":[],"mappings":"AA8BA;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAItD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,GAAG,MAAM,CAmB7E;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,MAAM,CAkBjF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,gBAAgB,EAAE,MAAM,EACxB,iBAAiB,EAAE,MAAM,GACxB,IAAI,CAKN"}

package/dist/lib/ln-message-sign.js

@@ -0,0 +1,90 @@
+import { secp256k1 } from "@noble/curves/secp256k1.js";
+import { sha256 } from "@noble/hashes/sha2.js";
+import { bytesToHex } from "@noble/hashes/utils.js";
+import { zbase32Encode, zbase32Decode } from "./zbase32.js";
+// LND-style signMessage / verifyMessage.
+//
+//   prefix = "Lightning Signed Message:"
+//   hash   = sha256(sha256(prefix + message))
+//   sig    = recoverable ECDSA over secp256k1, 65 bytes (recid+31 || r || s)
+//   text   = zbase32(sig)
+//
+// This is the format Alby's LND/lndhub/LNbits connectors return and is
+// what LNURL-auth-style verifyMessage callers expect. The non-recoverable
+// hex/DER form some other wallets emit cannot be verified without knowing
+// the signing pubkey out-of-band.
+const LN_MSG_PREFIX = new TextEncoder().encode("Lightning Signed Message:");
+const LNURL_AUTH_CANONICAL_PHRASE = "DO NOT EVER SIGN THIS TEXT WITH YOUR PRIVATE KEYS! IT IS ONLY USED FOR DERIVATION OF LNURL-AUTH HASHING-KEY, DISCLOSING ITS SIGNATURE WILL COMPROMISE YOUR LNURL-AUTH IDENTITY AND MAY LEAD TO LOSS OF FUNDS!";
+function lnMessageHash(message) {
+    const msgBytes = new TextEncoder().encode(message);
+    const concat = new Uint8Array(LN_MSG_PREFIX.length + msgBytes.length);
+    concat.set(LN_MSG_PREFIX, 0);
+    concat.set(msgBytes, LN_MSG_PREFIX.length);
+    return sha256(sha256(concat));
+}
+/**
+ * Reject phishing-style messages that match the canonical LNURL-auth
+ * disclaimer. Signing one would expose the LNURL-auth identity.
+ */
+export function assertSafeToSign(message) {
+    if (message.trim() === LNURL_AUTH_CANONICAL_PHRASE.trim()) {
+        throw new Error("Refusing to sign LNURL-auth canonical phrase");
+    }
+}
+/**
+ * Sign a message with the LND `signmessage` algorithm and return the
+ * zbase32-encoded recoverable signature.
+ */
+export function signLnMessage(message, privateKey) {
+    assertSafeToSign(message);
+    const hash = lnMessageHash(message);
+    // `format: "recovered"` returns 65 bytes laid out as [recid, r(32), s(32)].
+    // `prehash: false` because we already hashed.
+    const recovered = secp256k1.sign(hash, privateKey, {
+        format: "recovered",
+        prehash: false,
+        lowS: true,
+    });
+    if (recovered.length !== 65) {
+        throw new Error("Unexpected recoverable signature length");
+    }
+    // LND wire format adds 31 to the recovery id to land in the printable byte
+    // range; downstream Bitcoin Core's signmessage uses 27 — we match LND.
+    const out = new Uint8Array(65);
+    out[0] = recovered[0] + 31;
+    out.set(recovered.subarray(1), 1);
+    return zbase32Encode(out);
+}
+/**
+ * Verify a zbase32-encoded LND signature against the supplied message.
+ * Returns the recovered compressed pubkey (hex) on success, or throws.
+ */
+export function verifyLnMessage(message, zbase32Signature) {
+    const bytes = zbase32Decode(zbase32Signature, 65);
+    if (bytes.length !== 65) {
+        throw new Error("Invalid signature length");
+    }
+    const recovery = bytes[0] - 31;
+    if (recovery < 0 || recovery > 3) {
+        throw new Error("Invalid recovery id");
+    }
+    // Reassemble `recovered` shape expected by @noble: [recid, r, s].
+    const recoveredBytes = new Uint8Array(65);
+    recoveredBytes[0] = recovery;
+    recoveredBytes.set(bytes.subarray(1), 1);
+    const hash = lnMessageHash(message);
+    const pubkeyBytes = secp256k1.recoverPublicKey(recoveredBytes, hash, {
+        prehash: false,
+    });
+    return bytesToHex(pubkeyBytes);
+}
+/**
+ * Verify a zbase32 signature is from a specific pubkey. Throws on mismatch.
+ */
+export function verifyLnMessageFrom(message, zbase32Signature, expectedPubkeyHex) {
+    const recovered = verifyLnMessage(message, zbase32Signature);
+    if (recovered.toLowerCase() !== expectedPubkeyHex.toLowerCase()) {
+        throw new Error("Signature does not match expected pubkey");
+    }
+}
+//# sourceMappingURL=ln-message-sign.js.map

package/dist/lib/ln-message-sign.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ln-message-sign.js","sourceRoot":"","sources":["../../src/lib/ln-message-sign.ts"],"names":[],"mappings":"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"}

package/dist/lib/log.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Thin logger proxy over the platform `ports` seam.
+ *
+ * Ported Arkade modules use `log.info(...)` / `log.warn(...)` call sites. This
+ * proxy resolves the active platform logger lazily on each call so that a
+ * consumer's `setPlatform()` (extension / React Native) is honoured even when
+ * it runs after these modules are imported. Falls back to `consoleLogger`.
+ */
+export declare const log: {
+    debug: (...args: unknown[]) => void;
+    info: (...args: unknown[]) => void;
+    warn: (...args: unknown[]) => void;
+    error: (...args: unknown[]) => void;
+};
+//# sourceMappingURL=log.d.ts.map

package/dist/lib/log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../src/lib/log.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,eAAO,MAAM,GAAG;qBACG,OAAO,EAAE,KAAG,IAAI;oBACjB,OAAO,EAAE,KAAG,IAAI;oBAChB,OAAO,EAAE,KAAG,IAAI;qBACf,OAAO,EAAE,KAAG,IAAI;CAClC,CAAC"}

package/dist/lib/log.js

@@ -0,0 +1,16 @@
+/**
+ * Thin logger proxy over the platform `ports` seam.
+ *
+ * Ported Arkade modules use `log.info(...)` / `log.warn(...)` call sites. This
+ * proxy resolves the active platform logger lazily on each call so that a
+ * consumer's `setPlatform()` (extension / React Native) is honoured even when
+ * it runs after these modules are imported. Falls back to `consoleLogger`.
+ */
+import { getLogger } from "../ports/index.js";
+export const log = {
+    debug: (...args) => getLogger().debug(...args),
+    info: (...args) => getLogger().info(...args),
+    warn: (...args) => getLogger().warn(...args),
+    error: (...args) => getLogger().error(...args),
+};
+//# sourceMappingURL=log.js.map

package/dist/lib/log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.js","sourceRoot":"","sources":["../../src/lib/log.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAErC,MAAM,CAAC,MAAM,GAAG,GAAG;IACjB,KAAK,EAAE,CAAC,GAAG,IAAe,EAAQ,EAAE,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;IAC/D,IAAI,EAAE,CAAC,GAAG,IAAe,EAAQ,EAAE,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC7D,IAAI,EAAE,CAAC,GAAG,IAAe,EAAQ,EAAE,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC7D,KAAK,EAAE,CAAC,GAAG,IAAe,EAAQ,EAAE,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;CAChE,CAAC"}