@kaleidorg/wallet-protocols 1.0.0-beta.2

package/dist/adapters/wdk/SparkWdkAdapter.js

@@ -0,0 +1,317 @@
+/**
+ * SparkWdkAdapter
+ * ---------------
+ * Thin adapter mapping the WDK Spark module (@tetherto/wdk-wallet-spark) onto the
+ * stable `IProtocolAdapter` contract. This is the reference implementation of the
+ * "wrap a WDK module behind the contract" pattern (see docs/WDK_INTEGRATION_PLAN.md).
+ *
+ * Discipline rules enforced here:
+ *  - NO WDK/SDK types cross the contract boundary — everything returned is a domain
+ *    type from ../types/base. The WDK objects are held as `any` internally.
+ *  - Protocol quirks (zero-fee, static address) live in the capability manifest,
+ *    not in this interface.
+ *
+ * WDK Spark account surface (captured via Spike A, 2026-06-03):
+ *   manager: getAccount, getAccountByPath, getFeeRates
+ *   account: getAddress, getBalance, sendTransaction, transfer,
+ *            getStaticDepositAddress, getSingleUseDepositAddress, quoteWithdraw,
+ *            withdraw, createLightningInvoice, payLightningInvoice,
+ *            createSparkSatsInvoice, createSparkTokensInvoice, paySparkInvoice,
+ *            syncWalletBalance, dispose, cleanupConnections
+ *
+ * Status: skeleton — core receive/balance/invoice/send wired to the real WDK calls;
+ * remaining contract methods stubbed with explicit ProtocolError until Phase 2.
+ */
+import { ProtocolError, } from '../../types/base';
+import { getCapabilities } from '../../capabilities';
+import { loadWdkModule } from './moduleLoader';
+import { decodeBolt11, isBolt11 } from '../../lib/bolt11';
+/** Map a spark-sdk Transfer proto status → domain TransactionStatus. */
+function mapSparkStatus(s) {
+    const v = String(s ?? '').toUpperCase();
+    if (v.includes('COMPLET'))
+        return 'confirmed';
+    if (v.includes('FAIL') || v.includes('EXPIRED') || v.includes('RETURN'))
+        return 'failed';
+    return 'pending';
+}
+const SPARK_NETWORK_MAP = {
+    mainnet: 'MAINNET',
+    testnet: 'TESTNET',
+    regtest: 'REGTEST',
+    signet: 'SIGNET', // Spark supports SIGNET natively
+};
+export class SparkWdkAdapter {
+    constructor() {
+        this.protocolName = 'SPARK';
+        this.supportedLayers = getCapabilities('SPARK').layers;
+        this.version = '0.1.0-wdk';
+        this.manager = null;
+        this.account = null;
+        this.connected = false;
+        this.network = 'mainnet';
+    }
+    // --- Connection ---------------------------------------------------------
+    async connect(config) {
+        const cfg = config;
+        if (!cfg.mnemonic) {
+            throw new ProtocolError('SparkWdkAdapter requires a mnemonic', 'SPARK', 'CONFIG');
+        }
+        this.network = cfg.network ?? 'mainnet';
+        // Injectable loader (RN injects a static require; Node/Vite use the import fallback).
+        // @ts-ignore — declared as a workspace/optional dep; resolved at runtime.
+        const mod = await loadWdkModule('@tetherto/wdk-wallet-spark', () => import('@tetherto/wdk-wallet-spark'));
+        const WalletManagerSpark = mod.default ?? mod;
+        this.manager = new WalletManagerSpark(cfg.mnemonic, {
+            network: SPARK_NETWORK_MAP[this.network] ?? 'MAINNET',
+        });
+        this.account = await this.manager.getAccount(cfg.accountIndex ?? 0);
+        this.connected = true;
+    }
+    async disconnect() {
+        try {
+            await this.account?.dispose?.();
+            await this.account?.cleanupConnections?.();
+        }
+        finally {
+            this.account = null;
+            this.manager = null;
+            this.connected = false;
+        }
+    }
+    isConnected() {
+        return this.connected;
+    }
+    async getConnectionInfo() {
+        return { protocol: 'SPARK', connected: this.connected, network: this.network };
+    }
+    // --- Address / receive --------------------------------------------------
+    async getReceiveAddress() {
+        this.assertConnected();
+        const address = await this.account.getAddress();
+        return { address, format: 'SPARK_ADDRESS' };
+    }
+    // --- Balance ------------------------------------------------------------
+    async getBtcBalance() {
+        this.assertConnected();
+        // WDK: getBalance(): Promise<bigint> — sats, settled balance.
+        const bal = await this.account.getBalance();
+        const total = Number(bal);
+        return { confirmed: total, unconfirmed: 0, total };
+    }
+    async refreshBalances() {
+        this.assertConnected();
+        await this.account.syncWalletBalance?.();
+    }
+    async listAssets() {
+        this.assertConnected();
+        const { total } = await this.getBtcBalance();
+        const btc = {
+            id: 'BTC',
+            name: 'Bitcoin',
+            ticker: 'BTC',
+            precision: 8,
+            protocol: 'SPARK',
+            layer: 'BTC_SPARK',
+            balance: {
+                total,
+                available: total,
+                pending: 0,
+                totalDisplay: String(total),
+                availableDisplay: String(total),
+            },
+            capabilities: {
+                canSend: true,
+                canReceive: true,
+                canSwap: false,
+                supportsLightning: true,
+                supportsOnchain: true,
+            },
+        };
+        // TODO(Phase 2): enumerate Spark tokens from account.getBalance() token map.
+        return [btc];
+    }
+    async getAssetBalance(assetId) {
+        const assets = await this.listAssets();
+        const found = assets.find((a) => a.id === assetId);
+        if (!found)
+            throw new ProtocolError(`Unknown asset ${assetId}`, 'SPARK', 'NO_ASSET');
+        return found.balance;
+    }
+    async getAsset(assetId) {
+        const assets = await this.listAssets();
+        const found = assets.find((a) => a.id === assetId);
+        if (!found)
+            throw new ProtocolError(`Unknown asset ${assetId}`, 'SPARK', 'NO_ASSET');
+        return found;
+    }
+    // --- Invoices / receive amounts ----------------------------------------
+    async createInvoice(request) {
+        this.assertConnected();
+        const expiresAt = Date.now() + (request.expirySeconds ?? 3600) * 1000;
+        // 1) Lightning receive (BOLT11) — when the caller targets the LN layer.
+        if (request.layer === 'BTC_LN') {
+            // WDK createLightningInvoice({ amountSats, memo, expirySeconds }): LightningReceiveRequest
+            const r = await this.account.createLightningInvoice({
+                amountSats: request.amount ?? 0,
+                memo: request.description,
+                expirySeconds: request.expirySeconds,
+            });
+            const encoded = r?.invoice?.encodedInvoice ?? r?.encodedInvoice ?? r?.invoice ?? '';
+            return {
+                invoice: encoded,
+                paymentHash: r?.invoice?.paymentHash ?? r?.id ?? '',
+                amount: request.amount,
+                expiresAt,
+                description: request.description,
+            };
+        }
+        // 2) Spark token invoice — returns a SparkAddressFormat string.
+        if (request.asset && request.asset !== 'BTC') {
+            const invoice = await this.account.createSparkTokensInvoice({
+                tokenIdentifier: request.asset,
+                amount: request.assetAmount != null ? BigInt(request.assetAmount) : undefined,
+                memo: request.description,
+            });
+            return { invoice, paymentHash: '', amount: request.assetAmount, expiresAt, description: request.description };
+        }
+        // 3) Default: native Spark sats invoice — returns a SparkAddressFormat string.
+        const invoice = await this.account.createSparkSatsInvoice({
+            amount: request.amount,
+            memo: request.description,
+        });
+        return { invoice, paymentHash: '', amount: request.amount, expiresAt, description: request.description };
+    }
+    // --- Send ---------------------------------------------------------------
+    async sendPayment(request) {
+        this.assertConnected();
+        const dest = request.invoice.trim();
+        const isBolt11 = /^ln(bc|tb|bcrt)/i.test(dest);
+        const timestamp = Date.now();
+        // 1) Lightning send — WDK requires a maxFeeSats cap.
+        if (isBolt11) {
+            const r = await this.account.payLightningInvoice({
+                invoice: dest,
+                maxFeeSats: request.maxFeeSats ?? this.defaultMaxFeeSats(request.amount),
+            });
+            return {
+                paymentHash: r?.paymentHash ?? r?.id ?? '',
+                preimage: r?.preimage,
+                amount: Number(r?.amountSats ?? request.amount ?? 0),
+                fee: Number(r?.feeSats ?? 0),
+                status: 'confirmed',
+                timestamp,
+            };
+        }
+        // 2) Plain Spark address + explicit amount → direct transfer (zero-fee).
+        if (request.amount != null) {
+            const r = await this.account.sendTransaction({ to: dest, value: request.amount });
+            return {
+                paymentHash: r?.id ?? r?.transferId ?? '',
+                amount: request.amount,
+                fee: 0, // Spark transfers are zero-fee (capability flag)
+                status: 'confirmed',
+                timestamp,
+            };
+        }
+        // 3) Encoded Spark invoice (amount embedded) → fulfill. Takes an ARRAY.
+        const res = await this.account.paySparkInvoice([{ invoice: dest }]);
+        const ok = res?.satsTransactionSuccess?.[0];
+        return {
+            paymentHash: ok?.transferResponse?.id ?? '',
+            amount: Number(request.amount ?? 0),
+            fee: 0,
+            status: ok ? 'confirmed' : 'failed',
+            timestamp,
+        };
+    }
+    /** Conservative default LN fee cap: 0.5% of amount, min 5 sats. */
+    defaultMaxFeeSats(amount) {
+        if (!amount || amount <= 0)
+            return 10;
+        return Math.max(5, Math.ceil(amount * 0.005));
+    }
+    // --- Transactions -------------------------------------------------------
+    async decodeInvoice(invoice) {
+        const dest = invoice.trim();
+        if (isBolt11(dest)) {
+            const { amountSat } = decodeBolt11(dest);
+            return { paymentHash: '', amount: amountSat, expiresAt: 0, destination: dest };
+        }
+        // Spark invoice/address — no on-device decode; surface the raw value.
+        return { paymentHash: '', expiresAt: 0, destination: dest };
+    }
+    async getPaymentStatus(paymentHash) {
+        this.assertConnected();
+        const t = await this.account.getTransactionReceipt(paymentHash).catch(() => null);
+        return { paymentHash, status: mapSparkStatus(t?.status), amount: t ? Number(t.totalValue ?? 0) : undefined };
+    }
+    async listTransactions(filter) {
+        this.assertConnected();
+        const transfers = await this.account.getTransfers({ limit: filter?.limit ?? 50, skip: filter?.offset ?? 0 });
+        return (transfers ?? []).map((t) => this.toUnifiedTx(t));
+    }
+    async getTransaction(txId) {
+        this.assertConnected();
+        const t = await this.account.getTransactionReceipt(txId);
+        if (!t)
+            throw new ProtocolError(`Unknown tx ${txId}`, 'SPARK', 'NO_TX');
+        return this.toUnifiedTx(t);
+    }
+    async getNodeInfo() {
+        return { protocol: 'SPARK', network: this.network };
+    }
+    async listChannels() {
+        return []; // Spark has no LN channels
+    }
+    /**
+     * Escape hatch: the underlying spark-sdk SparkWallet, for integrations that need the
+     * raw client (e.g. the flashnet Spark-DEX, which piggybacks on a SparkWallet). Returns
+     * the same instance this adapter uses (no duplicate wallet). Null if not connected.
+     */
+    getUnderlyingSparkWallet() {
+        return this.account?._wallet ?? null;
+    }
+    async listPayments() {
+        // Outgoing transfers only.
+        const txs = await this.listTransactions();
+        return txs.filter((t) => t.type === 'send');
+    }
+    async listTransfers() {
+        this.assertConnected();
+        return this.account.getTransfers({ limit: 100 });
+    }
+    supportsSwaps() {
+        return getCapabilities('SPARK').supportsSwaps;
+    }
+    /** Map a spark-sdk Transfer (proto) → domain UnifiedTransaction (fields read defensively). */
+    toUnifiedTx(t) {
+        const dir = String(t?.transferDirection ?? t?.direction ?? '').toUpperCase();
+        const isReceive = dir.includes('INCOMING') || dir.includes('RECEIV');
+        const tsRaw = t?.createdTime ?? t?.updatedTime ?? t?.createdAt;
+        const timestamp = typeof tsRaw === 'number'
+            ? tsRaw
+            : tsRaw?.seconds
+                ? Number(tsRaw.seconds) * 1000
+                : tsRaw
+                    ? new Date(tsRaw).getTime()
+                    : 0;
+        return {
+            id: t?.id ?? t?.sparkId ?? '',
+            type: isReceive ? 'receive' : 'send',
+            status: mapSparkStatus(t?.status),
+            timestamp,
+            amount: Number(t?.totalValue ?? t?.value ?? 0),
+            amountDisplay: '',
+            asset: undefined,
+            protocolData: t,
+        };
+    }
+    // --- helpers ------------------------------------------------------------
+    assertConnected() {
+        if (!this.connected || !this.account) {
+            throw new ProtocolError('SparkWdkAdapter not connected', 'SPARK', 'NOT_CONNECTED');
+        }
+    }
+}
+//# sourceMappingURL=SparkWdkAdapter.js.map

package/dist/adapters/wdk/SparkWdkAdapter.js.map

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

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

@@ -0,0 +1,22 @@
+/**
+ * WDK Module Loader (platform-injectable)
+ * ---------------------------------------
+ * WDK modules are heavy native/WASM packages. How they're loaded differs per host:
+ *  - Node / Vite (extension): dynamic `import()` works fine.
+ *  - React Native / Metro: dynamic import of node_modules packages is unreliable;
+ *    the app injects a STATIC `require()` instead (mirrors rate's existing
+ *    `setSdkFactory` pattern for the native SDKs).
+ *
+ * Adapters call `loadWdkModule(pkgName, () => import(pkgName))`. If the host has
+ * registered a loader for that package, it's used; otherwise the inline dynamic
+ * import fallback runs. The fallback's import specifier is a string literal so
+ * bundlers can still analyze it.
+ */
+export type WdkModuleLoader = () => any | Promise<any>;
+/** Host registers how to load a WDK package (e.g. `() => require('@tetherto/wdk-wallet-spark')`). */
+export declare function registerWdkModule(pkgName: string, loader: WdkModuleLoader): void;
+/** True if the host injected a loader for this package. */
+export declare function hasWdkModule(pkgName: string): boolean;
+/** Resolve a WDK module via the injected loader, falling back to the inline dynamic import. */
+export declare function loadWdkModule(pkgName: string, fallback: () => Promise<any>): Promise<any>;
+//# sourceMappingURL=moduleLoader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"moduleLoader.d.ts","sourceRoot":"","sources":["../../../src/adapters/wdk/moduleLoader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;AAItD,qGAAqG;AACrG,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAEhF;AAED,2DAA2D;AAC3D,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAErD;AAED,+FAA+F;AAC/F,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAI/F"}

package/dist/adapters/wdk/moduleLoader.js

@@ -0,0 +1,31 @@
+/**
+ * WDK Module Loader (platform-injectable)
+ * ---------------------------------------
+ * WDK modules are heavy native/WASM packages. How they're loaded differs per host:
+ *  - Node / Vite (extension): dynamic `import()` works fine.
+ *  - React Native / Metro: dynamic import of node_modules packages is unreliable;
+ *    the app injects a STATIC `require()` instead (mirrors rate's existing
+ *    `setSdkFactory` pattern for the native SDKs).
+ *
+ * Adapters call `loadWdkModule(pkgName, () => import(pkgName))`. If the host has
+ * registered a loader for that package, it's used; otherwise the inline dynamic
+ * import fallback runs. The fallback's import specifier is a string literal so
+ * bundlers can still analyze it.
+ */
+const registry = new Map();
+/** Host registers how to load a WDK package (e.g. `() => require('@tetherto/wdk-wallet-spark')`). */
+export function registerWdkModule(pkgName, loader) {
+    registry.set(pkgName, loader);
+}
+/** True if the host injected a loader for this package. */
+export function hasWdkModule(pkgName) {
+    return registry.has(pkgName);
+}
+/** Resolve a WDK module via the injected loader, falling back to the inline dynamic import. */
+export async function loadWdkModule(pkgName, fallback) {
+    const loader = registry.get(pkgName);
+    if (loader)
+        return await loader();
+    return await fallback();
+}
+//# sourceMappingURL=moduleLoader.js.map

package/dist/adapters/wdk/moduleLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"moduleLoader.js","sourceRoot":"","sources":["../../../src/adapters/wdk/moduleLoader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA2B,CAAA;AAEnD,qGAAqG;AACrG,MAAM,UAAU,iBAAiB,CAAC,OAAe,EAAE,MAAuB;IACxE,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;AAC/B,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,OAAO,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;AAC9B,CAAC;AAED,+FAA+F;AAC/F,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAAe,EAAE,QAA4B;IAC/E,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;IACpC,IAAI,MAAM;QAAE,OAAO,MAAM,MAAM,EAAE,CAAA;IACjC,OAAO,MAAM,QAAQ,EAAE,CAAA;AACzB,CAAC"}

package/dist/capabilities/index.d.ts

@@ -0,0 +1,46 @@
+/**
+ * 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.
+ */
+import { ProtocolType, Layer } from '../types/base';
+export interface ProtocolCapabilities {
+    protocol: ProtocolType;
+    /** Layers this protocol can move value on. */
+    layers: Layer[];
+    supportsOnchain: boolean;
+    supportsLightning: boolean;
+    /** Can hold/transfer non-BTC assets (RGB assets, Liquid assets, Spark tokens). */
+    supportsAssets: boolean;
+    /** Native swap capability exposed by the protocol/module. */
+    supportsSwaps: boolean;
+    /** Spark: transfers are zero-fee. */
+    zeroFee: boolean;
+    /** Receive address is static/reusable for the wallet (Spark static, Arkade). */
+    staticReceiveAddress: boolean;
+    /** Arkade: on-chain "boarding" address to fund the off-chain account. */
+    boarding: boolean;
+    /** Invoices expire (LN / Spark / Liquid-Lightning) → needs a refresh story. */
+    invoiceExpiry: boolean;
+    /** Needs a Lightning channel / inbound liquidity before it can receive over LN. */
+    needsChannelLiquidity: boolean;
+    /** The backing WDK package, or null if still on a native SDK / not yet wired. */
+    wdkModule: string | null;
+    /** Maturity of the backing module — drives whether native fallback stays on. */
+    maturity: 'beta' | 'stable';
+}
+/**
+ * Single source of truth for what each protocol can do.
+ * Keyed by ProtocolType. 'BTC' is the abstract on-chain-only base.
+ */
+export declare const PROTOCOL_CAPABILITIES: Record<ProtocolType, ProtocolCapabilities>;
+export declare function getCapabilities(protocol: ProtocolType): ProtocolCapabilities;
+/** Protocols that can settle a given layer — used by the cross-protocol router. */
+export declare function protocolsForLayer(layer: Layer): ProtocolType[];
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/capabilities/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAEnD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,YAAY,CAAA;IACtB,8CAA8C;IAC9C,MAAM,EAAE,KAAK,EAAE,CAAA;IAGf,eAAe,EAAE,OAAO,CAAA;IACxB,iBAAiB,EAAE,OAAO,CAAA;IAC1B,kFAAkF;IAClF,cAAc,EAAE,OAAO,CAAA;IACvB,6DAA6D;IAC7D,aAAa,EAAE,OAAO,CAAA;IAGtB,qCAAqC;IACrC,OAAO,EAAE,OAAO,CAAA;IAChB,gFAAgF;IAChF,oBAAoB,EAAE,OAAO,CAAA;IAC7B,yEAAyE;IACzE,QAAQ,EAAE,OAAO,CAAA;IACjB,+EAA+E;IAC/E,aAAa,EAAE,OAAO,CAAA;IACtB,mFAAmF;IACnF,qBAAqB,EAAE,OAAO,CAAA;IAG9B,iFAAiF;IACjF,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,gFAAgF;IAChF,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAAA;CAC5B;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,YAAY,EAAE,oBAAoB,CA4E5E,CAAA;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,YAAY,GAAG,oBAAoB,CAE5E;AAED,mFAAmF;AACnF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,KAAK,GAAG,YAAY,EAAE,CAI9D"}

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/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';
+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"}