@kaleidorg/wallet-protocols 1.0.0-beta.2

package/dist/disclosure/index.js

@@ -0,0 +1,64 @@
+/**
+ * Disclosure Level (Lite / Advanced)
+ * ----------------------------------
+ * Lite and Advanced are NOT a code fork — they are one setting that controls how
+ * much the UI reveals and how much the auto-router decides vs. the user. The engine
+ * is identical underneath. This module is the single source of truth for what each
+ * level exposes, so neither the apps nor the adapters branch on "mode" ad-hoc.
+ *
+ * Default is chosen at wallet creation but is REVERSIBLE in settings.
+ */
+import { LIQUID_USDT_ASSET_ID } from '../adapters/wdk/LiquidWdkAdapter';
+export function policyFor(level) {
+    if (level === 'advanced') {
+        return {
+            level,
+            showNetworks: true,
+            showRouteSelector: true,
+            showChannelManagement: true,
+            showExperimental: true,
+            showRawIds: true,
+        };
+    }
+    return {
+        level: 'lite',
+        showNetworks: false,
+        showRouteSelector: false,
+        showChannelManagement: false,
+        showExperimental: false,
+        showRawIds: false,
+    };
+}
+/**
+ * Lite-mode "USD" = USDt on Liquid (locked product decision).
+ * Used to relabel/aggregate the user-facing "USD" balance.
+ */
+export const LITE_USD = {
+    protocol: 'LIQUID',
+    assetId: LIQUID_USDT_ASSET_ID,
+    displayTicker: 'USD',
+};
+export function liteBucketOf(asset) {
+    // All BTC representations (on-chain, LN, Spark, Arkade, L-BTC) collapse to one "BTC".
+    if (asset.ticker === 'BTC' || asset.ticker === 'L-BTC' || asset.id === 'BTC')
+        return 'BTC';
+    if (asset.id === LITE_USD.assetId || asset.ticker === 'USDt' || asset.ticker === 'USD')
+        return 'USD';
+    return 'OTHER';
+}
+export function aggregateForLite(assets) {
+    let btc = 0;
+    let usd = 0;
+    const other = [];
+    for (const a of assets) {
+        const bucket = liteBucketOf(a);
+        if (bucket === 'BTC')
+            btc += a.balance.total;
+        else if (bucket === 'USD')
+            usd += a.balance.total;
+        else
+            other.push(a);
+    }
+    return { btc, usd, other };
+}
+//# sourceMappingURL=index.js.map

package/dist/disclosure/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/disclosure/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAA;AAkBvE,MAAM,UAAU,SAAS,CAAC,KAAsB;IAC9C,IAAI,KAAK,KAAK,UAAU,EAAE,CAAC;QACzB,OAAO;YACL,KAAK;YACL,YAAY,EAAE,IAAI;YAClB,iBAAiB,EAAE,IAAI;YACvB,qBAAqB,EAAE,IAAI;YAC3B,gBAAgB,EAAE,IAAI;YACtB,UAAU,EAAE,IAAI;SACjB,CAAA;IACH,CAAC;IACD,OAAO;QACL,KAAK,EAAE,MAAM;QACb,YAAY,EAAE,KAAK;QACnB,iBAAiB,EAAE,KAAK;QACxB,qBAAqB,EAAE,KAAK;QAC5B,gBAAgB,EAAE,KAAK;QACvB,UAAU,EAAE,KAAK;KAClB,CAAA;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,QAAQ,EAAE,QAAwB;IAClC,OAAO,EAAE,oBAAoB;IAC7B,aAAa,EAAE,KAAK;CACZ,CAAA;AAKV,MAAM,UAAU,YAAY,CAAC,KAAmB;IAC9C,sFAAsF;IACtF,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,OAAO,IAAI,KAAK,CAAC,EAAE,KAAK,KAAK;QAAE,OAAO,KAAK,CAAA;IAC1F,IAAI,KAAK,CAAC,EAAE,KAAK,QAAQ,CAAC,OAAO,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK;QAAE,OAAO,KAAK,CAAA;IACpG,OAAO,OAAO,CAAA;AAChB,CAAC;AAcD,MAAM,UAAU,gBAAgB,CAAC,MAAsB;IACrD,IAAI,GAAG,GAAG,CAAC,CAAA;IACX,IAAI,GAAG,GAAG,CAAC,CAAA;IACX,MAAM,KAAK,GAAmB,EAAE,CAAA;IAChC,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,MAAM,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,CAAA;QAC9B,IAAI,MAAM,KAAK,KAAK;YAAE,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,CAAA;aACvC,IAAI,MAAM,KAAK,KAAK;YAAE,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,CAAA;;YAC5C,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACpB,CAAC;IACD,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,CAAA;AAC5B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @kaleidorg/wallet-protocols
+ * Shared wallet protocol adapters for Spark, Arkade, RGB, and Flashnet.
+ */
+export * from './types/base';
+export * from './types/cross-l2';
+export type { SparkConfig, SparkTransfer, SparkLightningInvoice, SparkLightningSend, SparkNodeInfo } from './types/spark';
+export type { ArkadeConfig, ArkadeVtxo, ArkadeBalance, ArkadeTransaction } from './types/arkade';
+export type { RgbConfig, RgbAssetMetadata, RgbChannel, RgbInvoice, RgbTransfer, KaleidoswapQuote, RgbNodeInfo, TradingPair } from './types/rgb';
+export * from './types/flashnet';
+export { type IProtocolAdapter, type BaseProtocolConfig, type IProtocolAdapterFactory, ProtocolAdapterRegistry } from './adapters/IProtocolAdapter';
+export { PROTOCOL_CAPABILITIES, getCapabilities, protocolsForLayer, type ProtocolCapabilities } from './capabilities';
+export type { IStorageProvider, IRuntimeProvider, PlatformContext } from './ports';
+export { SparkAdapter } from './adapters/SparkAdapter';
+export { ArkadeAdapter } from './adapters/ArkadeAdapter';
+export { RgbAdapter } from './adapters/RgbAdapter';
+export { SparkWdkAdapter, type SparkAdapterConfig } from './adapters/wdk/SparkWdkAdapter';
+export { LiquidWdkAdapter, type LiquidAdapterConfig, LIQUID_USDT_ASSET_ID } from './adapters/wdk/LiquidWdkAdapter';
+export { RlnWdkAdapter, type RlnAdapterConfig } from './adapters/wdk/RlnWdkAdapter';
+export { ArkadeWdkAdapter, type ArkadeAdapterConfig } from './adapters/wdk/ArkadeWdkAdapter';
+export { createWdkRegistry, type WdkRegistryOptions } from './registry/createWdkRegistry';
+export { registerWdkModule, hasWdkModule, type WdkModuleLoader } from './adapters/wdk/moduleLoader';
+export { CrossProtocolRouter, type SendRoute, type SendResolution, type ReceiveRoute, } from './router';
+export { classifyDestination, type ClassifiedDestination, type DestinationKind, } from './router/destination';
+export { KaleidoswapSwap, type KaleidoswapSwapConfig, type SwapQuoteRequest, type SwapExecuteRequest, } from './swap/KaleidoswapSwap';
+export { buildUnifiedReceiveURI, parseUnifiedReceiveURI, type UnifiedReceiveParams, } from './receive/unifiedReceive';
+export { policyFor, liteBucketOf, aggregateForLite, LITE_USD, type DisclosureLevel, type DisclosurePolicy, type LiteBucket, type LiteBalances, } from './disclosure';
+export { ProtocolManager, type ProtocolManagerConfig } from './manager/ProtocolManager';
+export { sparkClientManager } from './lib/spark-client-manager';
+export { arkadeClientManager, type ArkadePlatformProviders } from './lib/arkade-client-manager';
+export { kaleidoClientManager, type KaleidoClientConfig } from './lib/kaleido-client-manager';
+export { flashnetClientManager } from './lib/flashnet-client-manager';
+export { networkTypeToProtocol, protocolToNetworkType } from './utils';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,cAAc,cAAc,CAAA;AAC5B,cAAc,kBAAkB,CAAA;AAChC,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AACzH,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAChG,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,gBAAgB,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAC/I,cAAc,kBAAkB,CAAA;AAGhC,OAAO,EAAE,KAAK,gBAAgB,EAAE,KAAK,kBAAkB,EAAE,KAAK,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAA;AAGnJ,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,iBAAiB,EAAE,KAAK,oBAAoB,EAAE,MAAM,gBAAgB,CAAA;AAGrH,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAGlF,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAGlD,OAAO,EAAE,eAAe,EAAE,KAAK,kBAAkB,EAAE,MAAM,gCAAgC,CAAA;AACzF,OAAO,EAAE,gBAAgB,EAAE,KAAK,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAA;AAClH,OAAO,EAAE,aAAa,EAAE,KAAK,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AACnF,OAAO,EAAE,gBAAgB,EAAE,KAAK,mBAAmB,EAAE,MAAM,iCAAiC,CAAA;AAC5F,OAAO,EAAE,iBAAiB,EAAE,KAAK,kBAAkB,EAAE,MAAM,8BAA8B,CAAA;AAGzF,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,KAAK,eAAe,EAAE,MAAM,6BAA6B,CAAA;AAGnG,OAAO,EACL,mBAAmB,EACnB,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,YAAY,GAClB,MAAM,UAAU,CAAA;AACjB,OAAO,EACL,mBAAmB,EACnB,KAAK,qBAAqB,EAC1B,KAAK,eAAe,GACrB,MAAM,sBAAsB,CAAA;AAG7B,OAAO,EACL,eAAe,EACf,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,GACxB,MAAM,wBAAwB,CAAA;AAG/B,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,KAAK,oBAAoB,GAC1B,MAAM,0BAA0B,CAAA;AAGjC,OAAO,EACL,SAAS,EACT,YAAY,EACZ,gBAAgB,EAChB,QAAQ,EACR,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,UAAU,EACf,KAAK,YAAY,GAClB,MAAM,cAAc,CAAA;AAGrB,OAAO,EAAE,eAAe,EAAE,KAAK,qBAAqB,EAAE,MAAM,2BAA2B,CAAA;AAGvF,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAA;AAC/D,OAAO,EAAE,mBAAmB,EAAE,KAAK,uBAAuB,EAAE,MAAM,6BAA6B,CAAA;AAC/F,OAAO,EAAE,oBAAoB,EAAE,KAAK,mBAAmB,EAAE,MAAM,8BAA8B,CAAA;AAC7F,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAA;AAGrE,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAA"}

package/dist/index.js

@@ -0,0 +1,43 @@
+/**
+ * @kaleidorg/wallet-protocols
+ * Shared wallet protocol adapters for Spark, Arkade, RGB, and Flashnet.
+ */
+// Types
+export * from './types/base';
+export * from './types/cross-l2';
+export * from './types/flashnet';
+// Adapter interface
+export { ProtocolAdapterRegistry } from './adapters/IProtocolAdapter';
+// Capability manifest (differences-as-data backbone)
+export { PROTOCOL_CAPABILITIES, getCapabilities, protocolsForLayer } from './capabilities';
+// Adapters (native — being migrated to WDK)
+export { SparkAdapter } from './adapters/SparkAdapter';
+export { ArkadeAdapter } from './adapters/ArkadeAdapter';
+export { RgbAdapter } from './adapters/RgbAdapter';
+// Adapters (WDK-backed)
+export { SparkWdkAdapter } from './adapters/wdk/SparkWdkAdapter';
+export { LiquidWdkAdapter, LIQUID_USDT_ASSET_ID } from './adapters/wdk/LiquidWdkAdapter';
+export { RlnWdkAdapter } from './adapters/wdk/RlnWdkAdapter';
+export { ArkadeWdkAdapter } from './adapters/wdk/ArkadeWdkAdapter';
+export { createWdkRegistry } from './registry/createWdkRegistry';
+// WDK module loader (RN injects static require; other hosts use dynamic import)
+export { registerWdkModule, hasWdkModule } from './adapters/wdk/moduleLoader';
+// Cross-protocol router (chooses BETWEEN protocols)
+export { CrossProtocolRouter, } from './router';
+export { classifyDestination, } from './router/destination';
+// Kaleidoswap RFQ swap wrapper
+export { KaleidoswapSwap, } from './swap/KaleidoswapSwap';
+// Unified receive QR (single BIP21 with embedded LN/Ark/Spark/Liquid/RGB)
+export { buildUnifiedReceiveURI, parseUnifiedReceiveURI, } from './receive/unifiedReceive';
+// Lite/Advanced disclosure model
+export { policyFor, liteBucketOf, aggregateForLite, LITE_USD, } from './disclosure';
+// Manager
+export { ProtocolManager } from './manager/ProtocolManager';
+// Client managers
+export { sparkClientManager } from './lib/spark-client-manager';
+export { arkadeClientManager } from './lib/arkade-client-manager';
+export { kaleidoClientManager } from './lib/kaleido-client-manager';
+export { flashnetClientManager } from './lib/flashnet-client-manager';
+// Utilities
+export { networkTypeToProtocol, protocolToNetworkType } from './utils';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,QAAQ;AACR,cAAc,cAAc,CAAA;AAC5B,cAAc,kBAAkB,CAAA;AAIhC,cAAc,kBAAkB,CAAA;AAEhC,oBAAoB;AACpB,OAAO,EAAgF,uBAAuB,EAAE,MAAM,6BAA6B,CAAA;AAEnJ,qDAAqD;AACrD,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,iBAAiB,EAA6B,MAAM,gBAAgB,CAAA;AAKrH,4CAA4C;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAElD,wBAAwB;AACxB,OAAO,EAAE,eAAe,EAA2B,MAAM,gCAAgC,CAAA;AACzF,OAAO,EAAE,gBAAgB,EAA4B,oBAAoB,EAAE,MAAM,iCAAiC,CAAA;AAClH,OAAO,EAAE,aAAa,EAAyB,MAAM,8BAA8B,CAAA;AACnF,OAAO,EAAE,gBAAgB,EAA4B,MAAM,iCAAiC,CAAA;AAC5F,OAAO,EAAE,iBAAiB,EAA2B,MAAM,8BAA8B,CAAA;AAEzF,gFAAgF;AAChF,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAwB,MAAM,6BAA6B,CAAA;AAEnG,oDAAoD;AACpD,OAAO,EACL,mBAAmB,GAIpB,MAAM,UAAU,CAAA;AACjB,OAAO,EACL,mBAAmB,GAGpB,MAAM,sBAAsB,CAAA;AAE7B,+BAA+B;AAC/B,OAAO,EACL,eAAe,GAIhB,MAAM,wBAAwB,CAAA;AAE/B,0EAA0E;AAC1E,OAAO,EACL,sBAAsB,EACtB,sBAAsB,GAEvB,MAAM,0BAA0B,CAAA;AAEjC,iCAAiC;AACjC,OAAO,EACL,SAAS,EACT,YAAY,EACZ,gBAAgB,EAChB,QAAQ,GAKT,MAAM,cAAc,CAAA;AAErB,UAAU;AACV,OAAO,EAAE,eAAe,EAA8B,MAAM,2BAA2B,CAAA;AAEvF,kBAAkB;AAClB,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAA;AAC/D,OAAO,EAAE,mBAAmB,EAAgC,MAAM,6BAA6B,CAAA;AAC/F,OAAO,EAAE,oBAAoB,EAA4B,MAAM,8BAA8B,CAAA;AAC7F,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAA;AAErE,YAAY;AACZ,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAA"}

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

@@ -0,0 +1,47 @@
+/**
+ * Arkade Client Manager
+ * Manages the lifecycle of an Arkade wallet (@arkade-os/sdk).
+ * Platform-agnostic: storage/providers are injected by consumers.
+ * BIP86 key derivation via @scure/bip39 + @scure/bip32.
+ */
+import type { ArkadeConfig } from '../types/arkade';
+type ArkadeWallet = any;
+/**
+ * Platform-specific providers injected by consumers.
+ */
+export interface ArkadePlatformProviders {
+    createArkProvider?: () => any;
+    createIndexerProvider?: () => any;
+    createWalletRepository?: () => any;
+    createContractRepository?: () => any;
+}
+/**
+ * SDK factory injected by consumers.
+ * Consumers must call `setArkadeSdkFactory()` before `initialize()`.
+ */
+export interface ArkadeSdkFactory {
+    createWallet: (config: any) => Promise<any>;
+    createIdentity: (privateKeyHex: string) => any;
+}
+declare class ArkadeClientManager {
+    private wallet;
+    private config;
+    private _initPromise;
+    private platformProviders;
+    private sdkFactory;
+    setPlatformProviders(providers: ArkadePlatformProviders): void;
+    /**
+     * Set the SDK factory before calling initialize().
+     * This avoids dynamic import() which breaks in some bundlers.
+     */
+    setSdkFactory(factory: ArkadeSdkFactory): void;
+    initialize(config: ArkadeConfig): Promise<void>;
+    private _doInitialize;
+    disconnect(): Promise<void>;
+    isInitialized(): boolean;
+    getWallet(): ArkadeWallet;
+    getConfig(): ArkadeConfig | null;
+}
+export declare const arkadeClientManager: ArkadeClientManager;
+export {};
+//# sourceMappingURL=arkade-client-manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"arkade-client-manager.d.ts","sourceRoot":"","sources":["../../src/lib/arkade-client-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAInD,KAAK,YAAY,GAAG,GAAG,CAAA;AAEvB;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,iBAAiB,CAAC,EAAE,MAAM,GAAG,CAAA;IAC7B,qBAAqB,CAAC,EAAE,MAAM,GAAG,CAAA;IACjC,sBAAsB,CAAC,EAAE,MAAM,GAAG,CAAA;IAClC,wBAAwB,CAAC,EAAE,MAAM,GAAG,CAAA;CACrC;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAA;IAC3C,cAAc,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,GAAG,CAAA;CAC/C;AAgBD,cAAM,mBAAmB;IACvB,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,iBAAiB,CAA8B;IACvD,OAAO,CAAC,UAAU,CAAgC;IAElD,oBAAoB,CAAC,SAAS,EAAE,uBAAuB,GAAG,IAAI;IAI9D;;;OAGG;IACH,aAAa,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI;IAI9C,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;YASjC,aAAa;IAkErB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAKjC,aAAa,IAAI,OAAO;IAIxB,SAAS,IAAI,YAAY;IAOzB,SAAS,IAAI,YAAY,GAAG,IAAI;CAGjC;AAED,eAAO,MAAM,mBAAmB,qBAA4B,CAAA"}

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

@@ -0,0 +1,121 @@
+/**
+ * Arkade Client Manager
+ * Manages the lifecycle of an Arkade wallet (@arkade-os/sdk).
+ * Platform-agnostic: storage/providers are injected by consumers.
+ * BIP86 key derivation via @scure/bip39 + @scure/bip32.
+ */
+import { mnemonicToSeedSync } from '@scure/bip39';
+import { HDKey } from '@scure/bip32';
+function derivePrivateKeyFromMnemonic(mnemonic, isMainnet) {
+    const seed = mnemonicToSeedSync(mnemonic);
+    const root = HDKey.fromMasterSeed(seed);
+    const coinType = isMainnet ? 0 : 1;
+    const child = root.derive(`m/86'/${coinType}'/0'/0/0`);
+    if (!child.privateKey) {
+        throw new Error('Failed to derive private key from mnemonic');
+    }
+    return Array.from(child.privateKey).map(b => b.toString(16).padStart(2, '0')).join('');
+}
+class ArkadeClientManager {
+    constructor() {
+        this.wallet = null;
+        this.config = null;
+        this._initPromise = null;
+        this.platformProviders = {};
+        this.sdkFactory = null;
+    }
+    setPlatformProviders(providers) {
+        this.platformProviders = providers;
+    }
+    /**
+     * Set the SDK factory before calling initialize().
+     * This avoids dynamic import() which breaks in some bundlers.
+     */
+    setSdkFactory(factory) {
+        this.sdkFactory = factory;
+    }
+    initialize(config) {
+        if (this._initPromise)
+            return this._initPromise;
+        this._initPromise = this._doInitialize(config).finally(() => {
+            this._initPromise = null;
+        });
+        return this._initPromise;
+    }
+    async _doInitialize(config) {
+        if (this.wallet) {
+            console.warn('[ArkadeClientManager] Wallet already initialized, re-initializing...');
+            await this.disconnect();
+        }
+        try {
+            const isMainnet = config.network === 'mainnet';
+            const privateKeyHex = derivePrivateKeyFromMnemonic(config.mnemonic, isMainnet);
+            const arkServerUrl = config.arkServerUrl;
+            const walletConfig = {
+                arkServerUrl,
+            };
+            // Only pass esploraUrl if explicitly configured (SDK defaults to mempool.space)
+            if (config.esploraUrl) {
+                walletConfig.esploraUrl = config.esploraUrl;
+            }
+            // Storage repositories (IndexedDB for extension, AsyncStorage for RN)
+            const storage = {};
+            if (this.platformProviders.createWalletRepository) {
+                storage.walletRepository = this.platformProviders.createWalletRepository();
+            }
+            if (this.platformProviders.createContractRepository) {
+                storage.contractRepository = this.platformProviders.createContractRepository();
+            }
+            if (Object.keys(storage).length > 0) {
+                walletConfig.storage = storage;
+            }
+            // Settlement config (VTXO lifecycle)
+            walletConfig.settlementConfig = {
+                vtxoThreshold: config.vtxoThresholdSeconds ?? 259200, // 3 days default
+                boardingUtxoSweep: true,
+                pollIntervalMs: 60000,
+            };
+            // Platform-specific providers
+            if (this.platformProviders.createArkProvider) {
+                walletConfig.arkProvider = this.platformProviders.createArkProvider();
+            }
+            if (this.platformProviders.createIndexerProvider) {
+                walletConfig.indexerProvider = this.platformProviders.createIndexerProvider();
+            }
+            if (this.sdkFactory) {
+                walletConfig.identity = this.sdkFactory.createIdentity(privateKeyHex);
+                this.wallet = await this.sdkFactory.createWallet(walletConfig);
+            }
+            else {
+                const { Wallet, SingleKey } = await import('@arkade-os/sdk');
+                walletConfig.identity = SingleKey.fromHex(privateKeyHex);
+                this.wallet = await Wallet.create(walletConfig);
+            }
+            this.config = config;
+            console.log('[ArkadeClientManager] Arkade wallet initialized, network:', config.network || 'signet');
+        }
+        catch (error) {
+            this.wallet = null;
+            const msg = error instanceof Error ? error.message : String(error);
+            throw new Error(`Failed to initialize Arkade wallet: ${msg}`);
+        }
+    }
+    async disconnect() {
+        this.wallet = null;
+        this.config = null;
+    }
+    isInitialized() {
+        return this.wallet !== null;
+    }
+    getWallet() {
+        if (!this.wallet) {
+            throw new Error('[ArkadeClientManager] Wallet not initialized');
+        }
+        return this.wallet;
+    }
+    getConfig() {
+        return this.config;
+    }
+}
+export const arkadeClientManager = new ArkadeClientManager();
+//# sourceMappingURL=arkade-client-manager.js.map

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

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

package/dist/lib/bolt11.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Minimal, dependency-free BOLT11 helper.
+ * ---------------------------------------
+ * Extracts the amount + network from a Lightning invoice's human-readable prefix
+ * (HRP) without a full bech32 decode. Enough for adapters that only need to show
+ * "how much" before paying (Spark, Arkade), and to avoid pulling a decoder dep.
+ * Full field decode (payment_hash, description) is left to node-side decoders (RLN).
+ */
+export interface Bolt11Summary {
+    /** Amount in satoshis, if the invoice encodes one (open invoices omit it). */
+    amountSat?: number;
+    /** Network token from the HRP: bc | tb | tbs | bcrt. */
+    network: string;
+}
+/** Parse a BOLT11 invoice's HRP for amount + network. Returns network 'unknown' if not BOLT11. */
+export declare function decodeBolt11(invoice: string): Bolt11Summary;
+export declare function isBolt11(s: string): boolean;
+//# sourceMappingURL=bolt11.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bolt11.d.ts","sourceRoot":"","sources":["../../src/lib/bolt11.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,WAAW,aAAa;IAC5B,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,kGAAkG;AAClG,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CAc3D;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAE3C"}

package/dist/lib/bolt11.js

@@ -0,0 +1,31 @@
+/**
+ * Minimal, dependency-free BOLT11 helper.
+ * ---------------------------------------
+ * Extracts the amount + network from a Lightning invoice's human-readable prefix
+ * (HRP) without a full bech32 decode. Enough for adapters that only need to show
+ * "how much" before paying (Spark, Arkade), and to avoid pulling a decoder dep.
+ * Full field decode (payment_hash, description) is left to node-side decoders (RLN).
+ */
+const MULTIPLIER = { m: 1e-3, u: 1e-6, n: 1e-9, p: 1e-12 };
+/** Parse a BOLT11 invoice's HRP for amount + network. Returns network 'unknown' if not BOLT11. */
+export function decodeBolt11(invoice) {
+    const s = (invoice ?? '').trim().toLowerCase();
+    // HRP = ln <currency> [<amount><multiplier>] then the bech32 '1' separator.
+    // Requiring the trailing '1' makes the optional amount backtrack correctly, so the
+    // separator itself is never mistaken for an amount (e.g. amountless `lnbc1...`).
+    const m = s.match(/^ln(bcrt|tbs|bc|tb)(?:(\d+)([munp]?))?1/);
+    if (!m)
+        return { network: 'unknown' };
+    const network = m[1];
+    const digits = m[2];
+    const mult = m[3];
+    if (!digits)
+        return { network }; // amountless / open invoice
+    const base = Number(digits);
+    const btc = mult ? base * MULTIPLIER[mult] : base;
+    return { amountSat: Math.round(btc * 1e8), network };
+}
+export function isBolt11(s) {
+    return /^ln(bcrt|tbs|bc|tb)[0-9]/i.test((s ?? '').trim());
+}
+//# sourceMappingURL=bolt11.js.map

package/dist/lib/bolt11.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bolt11.js","sourceRoot":"","sources":["../../src/lib/bolt11.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,UAAU,GAA2B,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAA;AASlF,kGAAkG;AAClG,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,MAAM,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;IAC9C,4EAA4E;IAC5E,mFAAmF;IACnF,iFAAiF;IACjF,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAA;IAC5D,IAAI,CAAC,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAA;IACrC,MAAM,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;IACpB,MAAM,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;IACnB,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;IACjB,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,OAAO,EAAE,CAAA,CAAC,4BAA4B;IAC5D,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAA;IAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IACjD,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,GAAG,CAAC,EAAE,OAAO,EAAE,CAAA;AACtD,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,CAAS;IAChC,OAAO,2BAA2B,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAA;AAC3D,CAAC"}

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

@@ -0,0 +1,29 @@
+/**
+ * Flashnet Client Manager
+ * Manages the lifecycle of a FlashnetClient from @flashnet/sdk.
+ * Requires an initialized SparkWallet to function.
+ * Ported from rate-extension/src/lib/flashnet-client-manager.ts
+ */
+import { type FlashnetNetwork } from '../types/flashnet';
+declare class FlashnetClientManager {
+    private client;
+    private initPromise;
+    private poolId;
+    private network;
+    /**
+     * Initialize with a SparkWallet instance.
+     * @param wallet - SparkWallet from @buildonspark/spark-sdk
+     * @param sparkNetwork - The Spark network ('mainnet' | 'regtest')
+     */
+    initialize(wallet: any, sparkNetwork?: string): Promise<void>;
+    private doInitialize;
+    getClient(): any;
+    getPoolId(): string | null;
+    getNetwork(): FlashnetNetwork | null;
+    getUsdbTokenAddress(): string;
+    isInitialized(): boolean;
+    disconnect(): Promise<void>;
+}
+export declare const flashnetClientManager: FlashnetClientManager;
+export {};
+//# sourceMappingURL=flashnet-client-manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"flashnet-client-manager.d.ts","sourceRoot":"","sources":["../../src/lib/flashnet-client-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAIL,KAAK,eAAe,EACrB,MAAM,mBAAmB,CAAA;AAkB1B,cAAM,qBAAqB;IACzB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,WAAW,CAA6B;IAChD,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,OAAO,CAA+B;IAE9C;;;;OAIG;IACH,UAAU,CAAC,MAAM,EAAE,GAAG,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAQ/C,YAAY;IAuC1B,SAAS,IAAI,GAAG;IAOhB,SAAS,IAAI,MAAM,GAAG,IAAI;IAI1B,UAAU,IAAI,eAAe,GAAG,IAAI;IAIpC,mBAAmB,IAAI,MAAM;IAO7B,aAAa,IAAI,OAAO;IAIlB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAalC;AAED,eAAO,MAAM,qBAAqB,uBAA8B,CAAA"}

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

@@ -0,0 +1,116 @@
+/**
+ * Flashnet Client Manager
+ * Manages the lifecycle of a FlashnetClient from @flashnet/sdk.
+ * Requires an initialized SparkWallet to function.
+ * Ported from rate-extension/src/lib/flashnet-client-manager.ts
+ */
+import { BTC_ASSET_PUBKEY, getFlashnetNetworkForSpark, getFlashnetUsdbTokenAddress, } from '../types/flashnet';
+/**
+ * Normalize the SDK pools response to always return an array.
+ * The SDK may return `Pool[]` or `{ pools: Pool[] }`.
+ */
+function normalizePoolsResponse(response) {
+    if (Array.isArray(response))
+        return response;
+    if (response &&
+        typeof response === 'object' &&
+        Array.isArray(response.pools)) {
+        return response.pools;
+    }
+    return [];
+}
+class FlashnetClientManager {
+    constructor() {
+        this.client = null;
+        this.initPromise = null;
+        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;
+        this.initPromise = this.doInitialize(wallet, sparkNetwork).finally(() => {
+            this.initPromise = null;
+        });
+        return this.initPromise;
+    }
+    async doInitialize(wallet, sparkNetwork) {
+        if (this.client) {
+            await this.disconnect();
+        }
+        const network = getFlashnetNetworkForSpark(sparkNetwork);
+        if (!network) {
+            throw new Error('Flashnet is only available when Spark is on mainnet or regtest.');
+        }
+        try {
+            const { FlashnetClient } = await import('@flashnet/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,
+                    assetBAddress: getFlashnetUsdbTokenAddress(network),
+                    sort: 'TVL_DESC',
+                });
+                const pools = normalizePoolsResponse(poolsResponse);
+                if (pools && pools.length > 0) {
+                    this.poolId = pools[0].lpPublicKey;
+                }
+            }
+            catch (error) {
+                console.warn('[FlashnetClientManager] Pool discovery failed:', error);
+            }
+        }
+        catch (error) {
+            this.client = null;
+            this.poolId = null;
+            this.network = null;
+            const message = error instanceof Error ? error.message : String(error);
+            throw new Error(`Failed to initialize FlashnetClient: ${message}`);
+        }
+    }
+    getClient() {
+        if (!this.client) {
+            throw new Error('FlashnetClient not initialized. Call initialize() first.');
+        }
+        return this.client;
+    }
+    getPoolId() {
+        return this.poolId;
+    }
+    getNetwork() {
+        return this.network;
+    }
+    getUsdbTokenAddress() {
+        if (!this.network) {
+            throw new Error('Flashnet network unavailable. Initialize the client first.');
+        }
+        return getFlashnetUsdbTokenAddress(this.network);
+    }
+    isInitialized() {
+        return this.client !== null;
+    }
+    async disconnect() {
+        if (this.client) {
+            try {
+                await this.client.cleanup();
+            }
+            catch (error) {
+                console.warn('[FlashnetClientManager] Disconnect error:', error);
+            }
+        }
+        this.client = null;
+        this.poolId = null;
+        this.network = null;
+        this.initPromise = null;
+    }
+}
+export const flashnetClientManager = new FlashnetClientManager();
+//# sourceMappingURL=flashnet-client-manager.js.map

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

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

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

@@ -0,0 +1,26 @@
+/**
+ * KaleidoClient Manager
+ * Singleton manager for KaleidoClient lifecycle.
+ * Ported from rate-extension/src/lib/kaleido-client-manager.ts
+ */
+import { KaleidoClient } from 'kaleido-sdk';
+export interface KaleidoClientConfig {
+    baseUrl: string;
+    nodeUrl?: string;
+    apiKey?: string;
+    timeout?: number;
+}
+declare class KaleidoClientManager {
+    private client;
+    private config;
+    initialize(config: KaleidoClientConfig): void;
+    getClient(): KaleidoClient;
+    isInitialized(): boolean;
+    hasNode(): boolean;
+    getConfig(): KaleidoClientConfig | null;
+    reset(): void;
+    updateConfig(config: Partial<KaleidoClientConfig>): void;
+}
+export declare const kaleidoClientManager: KaleidoClientManager;
+export {};
+//# sourceMappingURL=kaleido-client-manager.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,55 @@
+/**
+ * KaleidoClient Manager
+ * Singleton manager for KaleidoClient lifecycle.
+ * Ported from rate-extension/src/lib/kaleido-client-manager.ts
+ */
+import { KaleidoClient } from 'kaleido-sdk';
+class KaleidoClientManager {
+    constructor() {
+        this.client = null;
+        this.config = null;
+    }
+    initialize(config) {
+        this.config = config;
+        this.client = KaleidoClient.create({
+            baseUrl: config.baseUrl,
+            nodeUrl: config.nodeUrl,
+            apiKey: config.apiKey,
+            timeout: config.timeout,
+        });
+        console.log('[KaleidoClientManager] Initialized with config:', {
+            baseUrl: config.baseUrl,
+            hasNodeUrl: !!config.nodeUrl,
+            hasApiKey: !!config.apiKey,
+        });
+    }
+    getClient() {
+        if (!this.client) {
+            throw new Error('KaleidoClient not initialized. Call initialize() first.');
+        }
+        return this.client;
+    }
+    isInitialized() {
+        return this.client !== null;
+    }
+    hasNode() {
+        return !!this.config?.nodeUrl;
+    }
+    getConfig() {
+        return this.config;
+    }
+    reset() {
+        this.client = null;
+        this.config = null;
+        console.log('[KaleidoClientManager] Reset complete');
+    }
+    updateConfig(config) {
+        if (!this.config) {
+            throw new Error('Cannot update config: client not initialized');
+        }
+        const newConfig = { ...this.config, ...config };
+        this.initialize(newConfig);
+    }
+}
+export const kaleidoClientManager = new KaleidoClientManager();
+//# sourceMappingURL=kaleido-client-manager.js.map