@kaleidorg/wallet-engine 1.0.0-beta.12

package/dist/capabilities/index.js

@@ -0,0 +1,102 @@
+/**
+ * Protocol Capability Manifest
+ * ----------------------------
+ * The backbone of the plugin architecture: protocol *differences* are expressed
+ * here as DATA, never as new methods on `IProtocolAdapter`. The cross-protocol
+ * router and the lite/advanced UI read this manifest to decide behaviour, so
+ * adding or changing one protocol never edits another protocol's code.
+ *
+ * Rule: when you're tempted to add a method to the contract for a single
+ * protocol, add a capability flag here instead.
+ */
+/**
+ * Single source of truth for what each protocol can do.
+ * Keyed by ProtocolType. 'BTC' is the abstract on-chain-only base.
+ */
+export const PROTOCOL_CAPABILITIES = {
+    BTC: {
+        protocol: 'BTC',
+        layers: ['BTC_L1'],
+        supportsOnchain: true,
+        supportsLightning: false,
+        supportsAssets: false,
+        supportsSwaps: false,
+        zeroFee: false,
+        staticReceiveAddress: false,
+        boarding: false,
+        invoiceExpiry: false,
+        needsChannelLiquidity: false,
+        wdkModule: null,
+        maturity: 'stable',
+    },
+    SPARK: {
+        protocol: 'SPARK',
+        layers: ['BTC_SPARK', 'SPARK_SPARK', 'BTC_LN'],
+        supportsOnchain: true, // via static/single-use deposit addresses
+        supportsLightning: true,
+        supportsAssets: true, // Spark tokens
+        supportsSwaps: false, // swaps handled by the cross-protocol router / Flashnet
+        zeroFee: true,
+        staticReceiveAddress: true,
+        boarding: false,
+        invoiceExpiry: true,
+        needsChannelLiquidity: false, // Spark has no LN channels to manage
+        wdkModule: '@tetherto/wdk-wallet-spark',
+        maturity: 'beta',
+    },
+    ARKADE: {
+        protocol: 'ARKADE',
+        layers: ['BTC_ARKADE', 'ARKADE_ARKADE', 'BTC_LN'],
+        supportsOnchain: true, // boarding
+        supportsLightning: true, // via boltz-swap
+        supportsAssets: true,
+        supportsSwaps: false,
+        zeroFee: false,
+        staticReceiveAddress: true,
+        boarding: true,
+        invoiceExpiry: true,
+        needsChannelLiquidity: false,
+        wdkModule: '@arkade-os/wdk',
+        maturity: 'beta',
+    },
+    RGB: {
+        protocol: 'RGB',
+        layers: ['BTC_L1', 'BTC_LN', 'RGB_L1', 'RGB_LN'],
+        supportsOnchain: true,
+        supportsLightning: true,
+        supportsAssets: true, // RGB assets (USDT, XAUT)
+        supportsSwaps: true, // RGB-LN atomic swaps via the maker
+        zeroFee: false,
+        staticReceiveAddress: false,
+        boarding: false,
+        invoiceExpiry: true,
+        needsChannelLiquidity: true, // RGB-LN needs channels / LSPS1
+        wdkModule: '@kaleidorg/wdk-wallet-rln',
+        maturity: 'beta',
+    },
+    LIQUID: {
+        protocol: 'LIQUID',
+        layers: ['BTC_LIQUID', 'LIQUID_ASSET'],
+        supportsOnchain: true, // Liquid is its own L1
+        supportsLightning: false, // (Boltz could add this later → flag, not new method)
+        supportsAssets: true, // USDt on Liquid = lite-mode "USD"
+        supportsSwaps: false,
+        zeroFee: false,
+        staticReceiveAddress: false,
+        boarding: false,
+        invoiceExpiry: false,
+        needsChannelLiquidity: false,
+        wdkModule: '@kaleidorg/wdk-wallet-liquid',
+        maturity: 'beta',
+    },
+};
+export function getCapabilities(protocol) {
+    return PROTOCOL_CAPABILITIES[protocol];
+}
+/** Protocols that can settle a given layer — used by the cross-protocol router. */
+export function protocolsForLayer(layer) {
+    return Object.values(PROTOCOL_CAPABILITIES)
+        .filter((c) => c.layers.includes(layer))
+        .map((c) => c.protocol);
+}
+//# sourceMappingURL=index.js.map

package/dist/capabilities/index.js.map

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

package/dist/capabilities/operations.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Operation-level capability manifest.
+ * --------------------------------------
+ * Distinct from the differences-as-data `PROTOCOL_CAPABILITIES` record in
+ * `./index.ts` (which the router and lite/advanced UI read). This manifest is
+ * the list of concrete *operations* each protocol natively supports, exposed on
+ * every adapter via `IProtocolAdapter.capabilities` so the UI can gate actions
+ * before an adapter connects — without per-call-site network checks.
+ *
+ * Naming: `ProtocolCapability` / `PROTOCOL_OPERATIONS` here vs
+ * `ProtocolCapabilities` / `PROTOCOL_CAPABILITIES` in `./index.ts`. The two are
+ * deliberately different shapes; see the wallet-engine integration spec (A5).
+ *
+ * Provider-routed features (swaps) live outside this manifest — a swap venue
+ * may run over multiple protocols without each adapter implementing it.
+ */
+import type { ProtocolType } from '../types/base.js';
+export type ProtocolCapability = 'onchain-send' | 'onchain-receive' | 'lightning-send' | 'lightning-receive' | 'asset-send' | 'asset-receive' | 'rgb-invoice' | 'spark-transfer' | 'arkade-onboard' | 'arkade-offboard';
+export declare const PROTOCOL_OPERATIONS: Record<ProtocolType, readonly ProtocolCapability[]>;
+export declare function getProtocolOperations(protocol: ProtocolType): readonly ProtocolCapability[];
+export declare function protocolSupportsOperation(protocol: ProtocolType, capability: ProtocolCapability): boolean;
+//# sourceMappingURL=operations.d.ts.map

package/dist/capabilities/operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.d.ts","sourceRoot":"","sources":["../../src/capabilities/operations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAEjD,MAAM,MAAM,kBAAkB,GAC1B,cAAc,GACd,iBAAiB,GACjB,gBAAgB,GAChB,mBAAmB,GACnB,YAAY,GACZ,eAAe,GACf,aAAa,GACb,gBAAgB,GAChB,gBAAgB,GAChB,iBAAiB,CAAA;AAErB,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,YAAY,EAAE,SAAS,kBAAkB,EAAE,CA+BnF,CAAA;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,YAAY,GAAG,SAAS,kBAAkB,EAAE,CAE3F;AAED,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,YAAY,EACtB,UAAU,EAAE,kBAAkB,GAC7B,OAAO,CAET"}

package/dist/capabilities/operations.js

@@ -0,0 +1,55 @@
+/**
+ * Operation-level capability manifest.
+ * --------------------------------------
+ * Distinct from the differences-as-data `PROTOCOL_CAPABILITIES` record in
+ * `./index.ts` (which the router and lite/advanced UI read). This manifest is
+ * the list of concrete *operations* each protocol natively supports, exposed on
+ * every adapter via `IProtocolAdapter.capabilities` so the UI can gate actions
+ * before an adapter connects — without per-call-site network checks.
+ *
+ * Naming: `ProtocolCapability` / `PROTOCOL_OPERATIONS` here vs
+ * `ProtocolCapabilities` / `PROTOCOL_CAPABILITIES` in `./index.ts`. The two are
+ * deliberately different shapes; see the wallet-engine integration spec (A5).
+ *
+ * Provider-routed features (swaps) live outside this manifest — a swap venue
+ * may run over multiple protocols without each adapter implementing it.
+ */
+export const PROTOCOL_OPERATIONS = {
+    RGB: [
+        'onchain-send',
+        'onchain-receive',
+        'lightning-send',
+        'lightning-receive',
+        'asset-send',
+        'asset-receive',
+        'rgb-invoice',
+    ],
+    SPARK: [
+        'onchain-send',
+        'onchain-receive',
+        'lightning-send',
+        'lightning-receive',
+        'asset-send',
+        'asset-receive',
+        'spark-transfer',
+    ],
+    ARKADE: [
+        'onchain-send',
+        'onchain-receive',
+        'lightning-send',
+        'lightning-receive',
+        'asset-send',
+        'asset-receive',
+        'arkade-onboard',
+        'arkade-offboard',
+    ],
+    LIQUID: ['onchain-send', 'onchain-receive', 'asset-send', 'asset-receive'],
+    BTC: ['onchain-send', 'onchain-receive'],
+};
+export function getProtocolOperations(protocol) {
+    return PROTOCOL_OPERATIONS[protocol] ?? [];
+}
+export function protocolSupportsOperation(protocol, capability) {
+    return getProtocolOperations(protocol).includes(capability);
+}
+//# sourceMappingURL=operations.js.map

package/dist/capabilities/operations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.js","sourceRoot":"","sources":["../../src/capabilities/operations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAgBH,MAAM,CAAC,MAAM,mBAAmB,GAAwD;IACtF,GAAG,EAAE;QACH,cAAc;QACd,iBAAiB;QACjB,gBAAgB;QAChB,mBAAmB;QACnB,YAAY;QACZ,eAAe;QACf,aAAa;KACd;IACD,KAAK,EAAE;QACL,cAAc;QACd,iBAAiB;QACjB,gBAAgB;QAChB,mBAAmB;QACnB,YAAY;QACZ,eAAe;QACf,gBAAgB;KACjB;IACD,MAAM,EAAE;QACN,cAAc;QACd,iBAAiB;QACjB,gBAAgB;QAChB,mBAAmB;QACnB,YAAY;QACZ,eAAe;QACf,gBAAgB;QAChB,iBAAiB;KAClB;IACD,MAAM,EAAE,CAAC,cAAc,EAAE,iBAAiB,EAAE,YAAY,EAAE,eAAe,CAAC;IAC1E,GAAG,EAAE,CAAC,cAAc,EAAE,iBAAiB,CAAC;CACzC,CAAA;AAED,MAAM,UAAU,qBAAqB,CAAC,QAAsB;IAC1D,OAAO,mBAAmB,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAA;AAC5C,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,QAAsB,EACtB,UAA8B;IAE9B,OAAO,qBAAqB,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAA;AAC7D,CAAC"}

package/dist/constants.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Neutral, dependency-free constants shared across core (router, disclosure)
+ * and adapters. Kept here so core modules never import from an adapter module
+ * (which would pull adapter/SDK weight into the adapter-free main barrel).
+ */
+/** Well-known Liquid mainnet Tether USD (USDt) asset id — the lite-mode "USD". */
+export declare const LIQUID_USDT_ASSET_ID = "ce091c998b83c78bb71a632313ba3760f1763d9cfcffae02258ffa9865a37bd2";
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,kFAAkF;AAClF,eAAO,MAAM,oBAAoB,qEACmC,CAAA"}

package/dist/constants.js

@@ -0,0 +1,8 @@
+/**
+ * Neutral, dependency-free constants shared across core (router, disclosure)
+ * and adapters. Kept here so core modules never import from an adapter module
+ * (which would pull adapter/SDK weight into the adapter-free main barrel).
+ */
+/** Well-known Liquid mainnet Tether USD (USDt) asset id — the lite-mode "USD". */
+export const LIQUID_USDT_ASSET_ID = 'ce091c998b83c78bb71a632313ba3760f1763d9cfcffae02258ffa9865a37bd2';
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,kFAAkF;AAClF,MAAM,CAAC,MAAM,oBAAoB,GAC/B,kEAAkE,CAAA"}

package/dist/disclosure/index.d.ts

@@ -0,0 +1,51 @@
+/**
+ * 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 { ProtocolType, UnifiedAsset } from '../types/base.js';
+export type DisclosureLevel = 'lite' | 'advanced';
+export interface DisclosurePolicy {
+    level: DisclosureLevel;
+    /** Show the network/layer behind balances and the network selector. */
+    showNetworks: boolean;
+    /** Let the user pick the send route (vs. auto-router picks `.best`). */
+    showRouteSelector: boolean;
+    /** Expose Lightning channel / LSPS1 management. */
+    showChannelManagement: boolean;
+    /** Expose experimental/advanced features (raw UTXOs, node config, etc.). */
+    showExperimental: boolean;
+    /** Show raw protocol/asset ids vs. friendly tickers only. */
+    showRawIds: boolean;
+}
+export declare function policyFor(level: DisclosureLevel): DisclosurePolicy;
+/**
+ * Lite-mode "USD" = USDt on Liquid (locked product decision).
+ * Used to relabel/aggregate the user-facing "USD" balance.
+ */
+export declare const LITE_USD: {
+    readonly protocol: ProtocolType;
+    readonly assetId: "ce091c998b83c78bb71a632313ba3760f1763d9cfcffae02258ffa9865a37bd2";
+    readonly displayTicker: "USD";
+};
+/** Buckets a unified asset into the three lite-mode user-facing buckets. */
+export type LiteBucket = 'BTC' | 'USD' | 'OTHER';
+export declare function liteBucketOf(asset: UnifiedAsset): LiteBucket;
+/**
+ * Aggregate per-protocol assets into the lite-mode view: a single BTC number,
+ * a single USD number, and any other assets — hiding which network each lives on.
+ * NOTE: callers should surface spendability constraints just-in-time (a unified BTC
+ * total can hide that a given route needs a swap); this only aggregates display balances.
+ */
+export interface LiteBalances {
+    btc: number;
+    usd: number;
+    other: UnifiedAsset[];
+}
+export declare function aggregateForLite(assets: UnifiedAsset[]): LiteBalances;
+//# sourceMappingURL=index.d.ts.map

package/dist/disclosure/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/disclosure/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAG1D,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,UAAU,CAAA;AAEjD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,eAAe,CAAA;IACtB,uEAAuE;IACvE,YAAY,EAAE,OAAO,CAAA;IACrB,wEAAwE;IACxE,iBAAiB,EAAE,OAAO,CAAA;IAC1B,mDAAmD;IACnD,qBAAqB,EAAE,OAAO,CAAA;IAC9B,4EAA4E;IAC5E,gBAAgB,EAAE,OAAO,CAAA;IACzB,6DAA6D;IAC7D,UAAU,EAAE,OAAO,CAAA;CACpB;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,eAAe,GAAG,gBAAgB,CAmBlE;AAED;;;GAGG;AACH,eAAO,MAAM,QAAQ;uBACG,YAAY;;;CAG1B,CAAA;AAEV,4EAA4E;AAC5E,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,KAAK,GAAG,OAAO,CAAA;AAEhD,wBAAgB,YAAY,CAAC,KAAK,EAAE,YAAY,GAAG,UAAU,CAK5D;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,YAAY,EAAE,CAAA;CACtB;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,YAAY,CAWrE"}

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 '../constants.js';
+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,cAAc,CAAA;AAkBnD,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,22 @@
+/**
+ * @kaleidorg/wallet-engine
+ * Shared wallet protocol adapters for Spark, Arkade, RGB, and Flashnet.
+ */
+export * from './types/base.js';
+export * from './types/cross-l2.js';
+export type { SparkConfig, SparkTransfer, SparkLightningInvoice, SparkLightningSend, SparkNodeInfo } from './types/spark.js';
+export type { ArkadeConfig, ArkadeVtxo, ArkadeBalance, ArkadeTransaction } from './types/arkade.js';
+export type { RgbConfig, RgbAssetMetadata, RgbChannel, RgbInvoice, RgbTransfer, KaleidoswapQuote, RgbNodeInfo, TradingPair } from './types/rgb.js';
+export * from './types/flashnet.js';
+export { type IProtocolAdapter, type BaseProtocolConfig, type ProtocolConfig, type IProtocolAdapterFactory, ProtocolAdapterRegistry } from './adapters/IProtocolAdapter.js';
+export { PROTOCOL_CAPABILITIES, getCapabilities, protocolsForLayer, type ProtocolCapabilities } from './capabilities/index.js';
+export { PROTOCOL_OPERATIONS, getProtocolOperations, protocolSupportsOperation, type ProtocolCapability } from './capabilities/operations.js';
+export type { IStorageProvider, IRuntimeProvider, PlatformContext } from './ports/index.js';
+export { LIQUID_USDT_ASSET_ID } from './constants.js';
+export { CrossProtocolRouter, type SendRoute, type SendResolution, type ReceiveRoute, } from './router/index.js';
+export { classifyDestination, type ClassifiedDestination, type DestinationKind, } from './router/destination.js';
+export { buildUnifiedReceiveURI, parseUnifiedReceiveURI, type UnifiedReceiveParams, } from './receive/unifiedReceive.js';
+export { policyFor, liteBucketOf, aggregateForLite, LITE_USD, type DisclosureLevel, type DisclosurePolicy, type LiteBucket, type LiteBalances, } from './disclosure/index.js';
+export { ProtocolManager, type ProtocolManagerConfig } from './manager/ProtocolManager.js';
+export { networkTypeToProtocol, protocolToNetworkType } from './utils.js';
+//# 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,cAAc,EAAE,KAAK,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAA;AAGxK,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,iBAAiB,EAAE,KAAK,oBAAoB,EAAE,MAAM,gBAAgB,CAAA;AAGrH,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,yBAAyB,EAAE,KAAK,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AAG1I,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAGlF,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAUlD,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,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,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAA"}

package/dist/index.js

@@ -0,0 +1,34 @@
+/**
+ * @kaleidorg/wallet-engine
+ * Shared wallet protocol adapters for Spark, Arkade, RGB, and Flashnet.
+ */
+// Types
+export * from './types/base.js';
+export * from './types/cross-l2.js';
+export * from './types/flashnet.js';
+// Adapter interface
+export { ProtocolAdapterRegistry } from './adapters/IProtocolAdapter.js';
+// Capability manifest (differences-as-data backbone)
+export { PROTOCOL_CAPABILITIES, getCapabilities, protocolsForLayer } from './capabilities/index.js';
+// Operation-level capability manifest (per-adapter `capabilities` field)
+export { PROTOCOL_OPERATIONS, getProtocolOperations, protocolSupportsOperation } from './capabilities/operations.js';
+// Shared constants
+export { LIQUID_USDT_ASSET_ID } from './constants.js';
+// NOTE: adapters are deliberately NOT exported from this barrel — they pull
+// heavy SDKs / WDK weight an extension host does not want. Import them from the
+// opt-in sub-paths instead:
+//   @kaleidorg/wallet-engine/adapters/native  (SDK-backed + client managers)
+//   @kaleidorg/wallet-engine/adapters/wdk     (WDK-backed + createWdkRegistry)
+//   @kaleidorg/wallet-engine/swap             (Kaleidoswap RFQ wrapper)
+// Cross-protocol router (chooses BETWEEN protocols)
+export { CrossProtocolRouter, } from './router/index.js';
+export { classifyDestination, } from './router/destination.js';
+// Unified receive QR (single BIP21 with embedded LN/Ark/Spark/Liquid/RGB)
+export { buildUnifiedReceiveURI, parseUnifiedReceiveURI, } from './receive/unifiedReceive.js';
+// Lite/Advanced disclosure model
+export { policyFor, liteBucketOf, aggregateForLite, LITE_USD, } from './disclosure/index.js';
+// Manager
+export { ProtocolManager } from './manager/ProtocolManager.js';
+// Utilities
+export { networkTypeToProtocol, protocolToNetworkType } from './utils.js';
+//# 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,EAAqG,uBAAuB,EAAE,MAAM,6BAA6B,CAAA;AAExK,qDAAqD;AACrD,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,iBAAiB,EAA6B,MAAM,gBAAgB,CAAA;AAErH,yEAAyE;AACzE,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,yBAAyB,EAA2B,MAAM,2BAA2B,CAAA;AAK1I,mBAAmB;AACnB,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAElD,4EAA4E;AAC5E,gFAAgF;AAChF,4BAA4B;AAC5B,6EAA6E;AAC7E,+EAA+E;AAC/E,wEAAwE;AAExE,oDAAoD;AACpD,OAAO,EACL,mBAAmB,GAIpB,MAAM,UAAU,CAAA;AACjB,OAAO,EACL,mBAAmB,GAGpB,MAAM,sBAAsB,CAAA;AAE7B,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,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.js';
+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"}