@kaleidorg/wallet-engine 1.0.0-beta.12

package/dist/manager/ProtocolManager.js

@@ -0,0 +1,305 @@
+/**
+ * Protocol Manager
+ * Central manager for all protocol operations
+ * Ported from rate-extension/src/protocols/manager/ProtocolManager.ts
+ */
+import { ProtocolError, } from '../types/base.js';
+import { ProtocolAdapterRegistry, } from '../adapters/IProtocolAdapter.js';
+import { getLogger } from '../ports/index.js';
+/** Per-protocol timeout for cross-protocol fan-out reads (assets/transactions). */
+const PER_PROTOCOL_TIMEOUT_MS = 8000;
+export class ProtocolManager {
+    constructor(_config = {}) {
+        this.activeProtocol = null;
+        this.registry = new ProtocolAdapterRegistry();
+        this.activeProtocol = _config.defaultProtocol || null;
+        this.log = _config.logger ?? getLogger();
+        this.verifyMessageFallback = _config.verifyMessageFallback;
+    }
+    // ========================================================================
+    // Registry Management
+    // ========================================================================
+    registerAdapter(adapter) {
+        this.registry.register(adapter);
+        this.log.info(`[ProtocolManager] Registered ${adapter.protocolName} adapter`);
+    }
+    getSupportedProtocols() {
+        return this.registry.getSupportedProtocols();
+    }
+    isProtocolSupported(protocol) {
+        return this.registry.has(protocol);
+    }
+    // ========================================================================
+    // Capability Manifest
+    // ========================================================================
+    /**
+     * Static capability manifest for a registered protocol (empty if not
+     * registered). Capabilities are static, so this works while unconfigured.
+     */
+    getCapabilities(protocol) {
+        return this.registry.get(protocol)?.capabilities ?? [];
+    }
+    /** Capability manifest for every registered protocol. */
+    getAllCapabilities() {
+        const result = {};
+        for (const adapter of this.registry.getAll()) {
+            result[adapter.protocolName] = adapter.capabilities;
+        }
+        return result;
+    }
+    /** Whether a protocol declares support for a given operation. */
+    protocolSupports(protocol, capability) {
+        return this.getCapabilities(protocol).includes(capability);
+    }
+    // ========================================================================
+    // Protocol Selection
+    // ========================================================================
+    async setActiveProtocol(protocol) {
+        if (!this.isProtocolSupported(protocol)) {
+            throw new ProtocolError(`Protocol not supported: ${protocol}`, protocol);
+        }
+        const adapter = this.registry.get(protocol);
+        if (!adapter.isConnected()) {
+            throw new ProtocolError(`Protocol not connected: ${protocol}`, protocol, 'NOT_CONNECTED');
+        }
+        this.activeProtocol = protocol;
+        this.log.info(`[ProtocolManager] Active protocol set to ${protocol}`);
+    }
+    getActiveProtocol() {
+        return this.activeProtocol;
+    }
+    getActiveAdapter() {
+        if (!this.activeProtocol) {
+            throw new Error('No active protocol set');
+        }
+        const adapter = this.registry.get(this.activeProtocol);
+        if (!adapter) {
+            throw new Error(`Adapter not found for protocol: ${this.activeProtocol}`);
+        }
+        return adapter;
+    }
+    getAdapter(protocol) {
+        const adapter = this.registry.get(protocol);
+        if (!adapter) {
+            throw new Error(`Adapter not found for protocol: ${protocol}`);
+        }
+        return adapter;
+    }
+    /**
+     * Try to get an adapter, returning undefined if not registered.
+     */
+    getAdapterIfAvailable(protocol) {
+        return this.registry.get(protocol);
+    }
+    // ========================================================================
+    // Connection Management
+    // ========================================================================
+    async connect(protocol, config) {
+        const adapter = this.registry.get(protocol);
+        if (!adapter) {
+            throw new ProtocolError(`Protocol not found: ${protocol}`, protocol, 'NOT_FOUND');
+        }
+        await adapter.connect(config);
+        this.log.info(`[ProtocolManager] Connected to ${protocol}`);
+        // Auto-set as active if no active protocol
+        if (!this.activeProtocol) {
+            this.activeProtocol = protocol;
+        }
+    }
+    async disconnect(protocol) {
+        const adapter = this.registry.get(protocol);
+        if (adapter) {
+            await adapter.disconnect();
+            this.log.info(`[ProtocolManager] Disconnected from ${protocol}`);
+            if (this.activeProtocol === protocol) {
+                this.activeProtocol = null;
+            }
+        }
+    }
+    async disconnectAll() {
+        for (const adapter of this.registry.getAll()) {
+            try {
+                await adapter.disconnect();
+            }
+            catch (error) {
+                this.log.error(`[ProtocolManager] Error disconnecting ${adapter.protocolName}:`, error);
+            }
+        }
+        this.activeProtocol = null;
+    }
+    async getAllConnectionInfo() {
+        const info = new Map();
+        for (const adapter of this.registry.getAll()) {
+            if (adapter.isConnected()) {
+                const connectionInfo = await adapter.getConnectionInfo();
+                info.set(adapter.protocolName, connectionInfo);
+            }
+        }
+        return info;
+    }
+    // ========================================================================
+    // Unified Operations (Route to Active Protocol)
+    // ========================================================================
+    async listAssets() {
+        return this.getActiveAdapter().listAssets();
+    }
+    async getAsset(assetId) {
+        return this.getActiveAdapter().getAsset(assetId);
+    }
+    async getAssetBalance(assetId) {
+        return this.getActiveAdapter().getAssetBalance(assetId);
+    }
+    /**
+     * Invalidate every connected adapter's balance cache so the next read is
+     * fresh. Tolerates per-adapter failures — one slow protocol can't block the
+     * others.
+     */
+    async refreshBalances() {
+        const adapters = this.registry.getAll().filter((a) => a.isConnected());
+        await Promise.allSettled(adapters.map((a) => a.refreshBalances()));
+    }
+    async listTransactions(filter) {
+        return this.getActiveAdapter().listTransactions(filter);
+    }
+    async getTransaction(txId, assetId) {
+        return this.getActiveAdapter().getTransaction(txId, assetId);
+    }
+    async createInvoice(request) {
+        return this.getActiveAdapter().createInvoice(request);
+    }
+    async decodeInvoice(invoice) {
+        return this.getActiveAdapter().decodeInvoice(invoice);
+    }
+    async sendPayment(request) {
+        return this.getActiveAdapter().sendPayment(request);
+    }
+    async payKeysend(request) {
+        const adapter = this.getActiveAdapter();
+        if (!adapter.payKeysend) {
+            throw new ProtocolError('Keysend not supported by active protocol', adapter.protocolName, 'NOT_SUPPORTED');
+        }
+        return adapter.payKeysend(request);
+    }
+    async getPaymentStatus(paymentHash) {
+        return this.getActiveAdapter().getPaymentStatus(paymentHash);
+    }
+    /**
+     * Sign a message with the active adapter's wallet identity key (LND-style
+     * zbase32 recoverable ECDSA). Throws if the adapter doesn't implement it —
+     * callers fall back to their own mnemonic-derived signer.
+     */
+    async signMessage(message) {
+        const adapter = this.getActiveAdapter();
+        if (typeof adapter.signMessage !== 'function') {
+            throw new ProtocolError('signMessage not supported by active protocol', adapter.protocolName, 'NOT_SUPPORTED');
+        }
+        return adapter.signMessage(message);
+    }
+    /**
+     * Verify an LND-style zbase32 signature, returning the signer's hex pubkey.
+     * Routes to the active adapter, else the injected generic fallback, else
+     * throws NOT_SUPPORTED.
+     */
+    async verifyMessage(message, signature) {
+        const adapter = this.getActiveAdapter();
+        if (typeof adapter.verifyMessage === 'function') {
+            return adapter.verifyMessage(message, signature);
+        }
+        if (this.verifyMessageFallback) {
+            return this.verifyMessageFallback(message, signature);
+        }
+        throw new ProtocolError('verifyMessage not supported by active protocol', adapter.protocolName, 'NOT_SUPPORTED');
+    }
+    async getReceiveAddress(assetId) {
+        return this.getActiveAdapter().getReceiveAddress(assetId);
+    }
+    async getSwapQuote(request) {
+        const adapter = this.getActiveAdapter();
+        if (!adapter.supportsSwaps() || !adapter.getSwapQuote) {
+            throw new ProtocolError('Swaps not supported by active protocol', adapter.protocolName, 'NOT_SUPPORTED');
+        }
+        return adapter.getSwapQuote(request);
+    }
+    async executeSwap(quote) {
+        const adapter = this.getActiveAdapter();
+        if (!adapter.supportsSwaps() || !adapter.executeSwap) {
+            throw new ProtocolError('Swaps not supported by active protocol', adapter.protocolName, 'NOT_SUPPORTED');
+        }
+        return adapter.executeSwap(quote);
+    }
+    // ========================================================================
+    // Cross-Protocol Operations
+    // ========================================================================
+    /**
+     * Assets across all connected protocols. Runs per-adapter calls in parallel
+     * with an 8s timeout each — a single slow/degraded backend can't freeze the
+     * whole list for every consumer of asset data.
+     */
+    async listAllAssets() {
+        const adapters = this.registry.getAll().filter((a) => a.isConnected());
+        const results = await Promise.allSettled(adapters.map((adapter) => this.withTimeout(adapter.listAssets(), adapter.protocolName, 'listAssets')));
+        const allAssets = [];
+        results.forEach((result, index) => {
+            if (result.status === 'fulfilled')
+                allAssets.push(...result.value);
+            else
+                this.log.error(`[ProtocolManager] Error listing assets for ${adapters[index].protocolName}:`, result.reason);
+        });
+        return allAssets;
+    }
+    /**
+     * Transactions across all connected protocols. Parallel + per-protocol
+     * timeout, for the same reason as `listAllAssets`.
+     */
+    async listAllTransactions(filter) {
+        const adapters = this.registry.getAll().filter((a) => a.isConnected());
+        const results = await Promise.allSettled(adapters.map((adapter) => this.withTimeout(adapter.listTransactions(filter), adapter.protocolName, 'listTransactions')));
+        const allTransactions = [];
+        results.forEach((result, index) => {
+            if (result.status === 'fulfilled')
+                allTransactions.push(...result.value);
+            else
+                this.log.error(`[ProtocolManager] Error listing transactions for ${adapters[index].protocolName}:`, result.reason);
+        });
+        return allTransactions.sort((a, b) => b.timestamp - a.timestamp);
+    }
+    /** Race a per-protocol call against an 8s timeout. */
+    withTimeout(p, protocol, op) {
+        return Promise.race([
+            p,
+            new Promise((_, reject) => setTimeout(() => reject(new Error(`${op}(${protocol}) timed out after ${PER_PROTOCOL_TIMEOUT_MS}ms`)), PER_PROTOCOL_TIMEOUT_MS)),
+        ]);
+    }
+    async findAsset(assetId) {
+        for (const adapter of this.registry.getAll()) {
+            if (adapter.isConnected()) {
+                try {
+                    const asset = await adapter.getAsset(assetId);
+                    if (asset)
+                        return asset;
+                }
+                catch (_error) {
+                    // Asset not found in this protocol, continue
+                }
+            }
+        }
+        return null;
+    }
+    async getPortfolioSummary() {
+        const allAssets = await this.listAllAssets();
+        const breakdown = new Map();
+        for (const asset of allAssets) {
+            if (!breakdown.has(asset.protocol)) {
+                breakdown.set(asset.protocol, { assets: 0, value: 0 });
+            }
+            const entry = breakdown.get(asset.protocol);
+            entry.assets++;
+        }
+        return {
+            totalAssets: allAssets.length,
+            totalValue: 0,
+            protocolBreakdown: breakdown,
+        };
+    }
+}
+//# sourceMappingURL=ProtocolManager.js.map

package/dist/manager/ProtocolManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProtocolManager.js","sourceRoot":"","sources":["../../src/manager/ProtocolManager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAiBL,aAAa,GACd,MAAM,eAAe,CAAA;AAEtB,OAAO,EAGL,uBAAuB,GACxB,MAAM,8BAA8B,CAAA;AAErC,OAAO,EAAe,SAAS,EAAE,MAAM,UAAU,CAAA;AAEjD,mFAAmF;AACnF,MAAM,uBAAuB,GAAG,IAAK,CAAA;AAiBrC,MAAM,OAAO,eAAe;IAM1B,YAAY,UAAiC,EAAE;QAJvC,mBAAc,GAAwB,IAAI,CAAA;QAKhD,IAAI,CAAC,QAAQ,GAAG,IAAI,uBAAuB,EAAE,CAAA;QAC7C,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,eAAe,IAAI,IAAI,CAAA;QACrD,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,MAAM,IAAI,SAAS,EAAE,CAAA;QACxC,IAAI,CAAC,qBAAqB,GAAG,OAAO,CAAC,qBAAqB,CAAA;IAC5D,CAAC;IAED,2EAA2E;IAC3E,sBAAsB;IACtB,2EAA2E;IAE3E,eAAe,CAAC,OAAyB;QACvC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;QAC/B,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,gCAAgC,OAAO,CAAC,YAAY,UAAU,CAAC,CAAA;IAC/E,CAAC;IAED,qBAAqB;QACnB,OAAO,IAAI,CAAC,QAAQ,CAAC,qBAAqB,EAAE,CAAA;IAC9C,CAAC;IAED,mBAAmB,CAAC,QAAsB;QACxC,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;IACpC,CAAC;IAED,2EAA2E;IAC3E,sBAAsB;IACtB,2EAA2E;IAE3E;;;OAGG;IACH,eAAe,CAAC,QAAsB;QACpC,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,YAAY,IAAI,EAAE,CAAA;IACxD,CAAC;IAED,yDAAyD;IACzD,kBAAkB;QAChB,MAAM,MAAM,GAAiE,EAAE,CAAA;QAC/E,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;YAC7C,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,YAAY,CAAA;QACrD,CAAC;QACD,OAAO,MAAM,CAAA;IACf,CAAC;IAED,iEAAiE;IACjE,gBAAgB,CAAC,QAAsB,EAAE,UAA8B;QACrE,OAAO,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAA;IAC5D,CAAC;IAED,2EAA2E;IAC3E,qBAAqB;IACrB,2EAA2E;IAE3E,KAAK,CAAC,iBAAiB,CAAC,QAAsB;QAC5C,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,EAAE,CAAC;YACxC,MAAM,IAAI,aAAa,CAAC,2BAA2B,QAAQ,EAAE,EAAE,QAAQ,CAAC,CAAA;QAC1E,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAE,CAAA;QAC5C,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;YAC3B,MAAM,IAAI,aAAa,CAAC,2BAA2B,QAAQ,EAAE,EAAE,QAAQ,EAAE,eAAe,CAAC,CAAA;QAC3F,CAAC;QAED,IAAI,CAAC,cAAc,GAAG,QAAQ,CAAA;QAC9B,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,4CAA4C,QAAQ,EAAE,CAAC,CAAA;IACvE,CAAC;IAED,iBAAiB;QACf,OAAO,IAAI,CAAC,cAAc,CAAA;IAC5B,CAAC;IAEM,gBAAgB;QACrB,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAA;QAC3C,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;QACtD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,mCAAmC,IAAI,CAAC,cAAc,EAAE,CAAC,CAAA;QAC3E,CAAC;QAED,OAAO,OAAO,CAAA;IAChB,CAAC;IAED,UAAU,CAAC,QAAsB;QAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QAC3C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,mCAAmC,QAAQ,EAAE,CAAC,CAAA;QAChE,CAAC;QACD,OAAO,OAAO,CAAA;IAChB,CAAC;IAED;;OAEG;IACH,qBAAqB,CAAC,QAAsB;QAC1C,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;IACpC,CAAC;IAED,2EAA2E;IAC3E,wBAAwB;IACxB,2EAA2E;IAE3E,KAAK,CAAC,OAAO,CAAC,QAAsB,EAAE,MAAsB;QAC1D,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QAC3C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,aAAa,CAAC,uBAAuB,QAAQ,EAAE,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAA;QACnF,CAAC;QAED,MAAM,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;QAC7B,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,kCAAkC,QAAQ,EAAE,CAAC,CAAA;QAE3D,2CAA2C;QAC3C,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;YACzB,IAAI,CAAC,cAAc,GAAG,QAAQ,CAAA;QAChC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,QAAsB;QACrC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QAC3C,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,OAAO,CAAC,UAAU,EAAE,CAAA;YAC1B,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,uCAAuC,QAAQ,EAAE,CAAC,CAAA;YAEhE,IAAI,IAAI,CAAC,cAAc,KAAK,QAAQ,EAAE,CAAC;gBACrC,IAAI,CAAC,cAAc,GAAG,IAAI,CAAA;YAC5B,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,CAAC,aAAa;QACjB,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;YAC7C,IAAI,CAAC;gBACH,MAAM,OAAO,CAAC,UAAU,EAAE,CAAA;YAC5B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,yCAAyC,OAAO,CAAC,YAAY,GAAG,EAAE,KAAK,CAAC,CAAA;YACzF,CAAC;QACH,CAAC;QACD,IAAI,CAAC,cAAc,GAAG,IAAI,CAAA;IAC5B,CAAC;IAED,KAAK,CAAC,oBAAoB;QACxB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAgC,CAAA;QAEpD,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;YAC7C,IAAI,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;gBAC1B,MAAM,cAAc,GAAG,MAAM,OAAO,CAAC,iBAAiB,EAAE,CAAA;gBACxD,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,YAAY,EAAE,cAAc,CAAC,CAAA;YAChD,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAA;IACb,CAAC;IAED,2EAA2E;IAC3E,gDAAgD;IAChD,2EAA2E;IAE3E,KAAK,CAAC,UAAU;QACd,OAAO,IAAI,CAAC,gBAAgB,EAAE,CAAC,UAAU,EAAE,CAAA;IAC7C,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,OAAe;QAC5B,OAAO,IAAI,CAAC,gBAAgB,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;IAClD,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,OAAe;QACnC,OAAO,IAAI,CAAC,gBAAgB,EAAE,CAAC,eAAe,CAAC,OAAO,CAAC,CAAA;IACzD,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,eAAe;QACnB,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAA;QACtE,MAAM,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC,CAAA;IACpE,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,MAA0B;QAC/C,OAAO,IAAI,CAAC,gBAAgB,EAAE,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAA;IACzD,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,IAAY,EAAE,OAAgB;QACjD,OAAO,IAAI,CAAC,gBAAgB,EAAE,CAAC,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;IAC9D,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,OAAuB;QACzC,OAAO,IAAI,CAAC,gBAAgB,EAAE,CAAC,aAAa,CAAC,OAAO,CAAC,CAAA;IACvD,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,OAAe;QACjC,OAAO,IAAI,CAAC,gBAAgB,EAAE,CAAC,aAAa,CAAC,OAAO,CAAC,CAAA;IACvD,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,OAAuB;QACvC,OAAO,IAAI,CAAC,gBAAgB,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,CAAA;IACrD,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,OAAuB;QACtC,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAA;QACvC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;YACxB,MAAM,IAAI,aAAa,CACrB,0CAA0C,EAC1C,OAAO,CAAC,YAAY,EACpB,eAAe,CAChB,CAAA;QACH,CAAC;QACD,OAAO,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAA;IACpC,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,WAAmB;QACxC,OAAO,IAAI,CAAC,gBAAgB,EAAE,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAA;IAC9D,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,WAAW,CAAC,OAAe;QAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAA;QACvC,IAAI,OAAO,OAAO,CAAC,WAAW,KAAK,UAAU,EAAE,CAAC;YAC9C,MAAM,IAAI,aAAa,CACrB,8CAA8C,EAC9C,OAAO,CAAC,YAAY,EACpB,eAAe,CAChB,CAAA;QACH,CAAC;QACD,OAAO,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAA;IACrC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,aAAa,CAAC,OAAe,EAAE,SAAiB;QACpD,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAA;QACvC,IAAI,OAAO,OAAO,CAAC,aAAa,KAAK,UAAU,EAAE,CAAC;YAChD,OAAO,OAAO,CAAC,aAAa,CAAC,OAAO,EAAE,SAAS,CAAC,CAAA;QAClD,CAAC;QACD,IAAI,IAAI,CAAC,qBAAqB,EAAE,CAAC;YAC/B,OAAO,IAAI,CAAC,qBAAqB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAA;QACvD,CAAC;QACD,MAAM,IAAI,aAAa,CACrB,gDAAgD,EAChD,OAAO,CAAC,YAAY,EACpB,eAAe,CAChB,CAAA;IACH,CAAC;IAED,KAAK,CAAC,iBAAiB,CAAC,OAAgB;QACtC,OAAO,IAAI,CAAC,gBAAgB,EAAE,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAA;IAC3D,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,OAAqB;QACtC,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAA;QACvC,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;YACtD,MAAM,IAAI,aAAa,CACrB,wCAAwC,EACxC,OAAO,CAAC,YAAY,EACpB,eAAe,CAChB,CAAA;QACH,CAAC;QACD,OAAO,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAA;IACtC,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,KAAY;QAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAA;QACvC,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;YACrD,MAAM,IAAI,aAAa,CACrB,wCAAwC,EACxC,OAAO,CAAC,YAAY,EACpB,eAAe,CAChB,CAAA;QACH,CAAC;QACD,OAAO,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,CAAA;IACnC,CAAC;IAED,2EAA2E;IAC3E,4BAA4B;IAC5B,2EAA2E;IAE3E;;;;OAIG;IACH,KAAK,CAAC,aAAa;QACjB,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAA;QACtE,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CACtC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,OAAO,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC,CACtG,CAAA;QAED,MAAM,SAAS,GAAmB,EAAE,CAAA;QACpC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;YAChC,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW;gBAAE,SAAS,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;;gBAC7D,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,8CAA8C,QAAQ,CAAC,KAAK,CAAC,CAAC,YAAY,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,CAAA;QACnH,CAAC,CAAC,CAAA;QACF,OAAO,SAAS,CAAA;IAClB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,mBAAmB,CAAC,MAA0B;QAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAA;QACtE,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CACtC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CACvB,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,EAAE,kBAAkB,CAAC,CAC7F,CACF,CAAA;QAED,MAAM,eAAe,GAAyB,EAAE,CAAA;QAChD,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;YAChC,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW;gBAAE,eAAe,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;;gBACnE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,oDAAoD,QAAQ,CAAC,KAAK,CAAC,CAAC,YAAY,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,CAAA;QACzH,CAAC,CAAC,CAAA;QACF,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAA;IAClE,CAAC;IAED,sDAAsD;IAC9C,WAAW,CAAI,CAAa,EAAE,QAAsB,EAAE,EAAU;QACtE,OAAO,OAAO,CAAC,IAAI,CAAC;YAClB,CAAC;YACD,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAC/B,UAAU,CACR,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,GAAG,EAAE,IAAI,QAAQ,qBAAqB,uBAAuB,IAAI,CAAC,CAAC,EAC1F,uBAAuB,CACxB,CACF;SACF,CAAC,CAAA;IACJ,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,OAAe;QAC7B,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;YAC7C,IAAI,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;gBAC1B,IAAI,CAAC;oBACH,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;oBAC7C,IAAI,KAAK;wBAAE,OAAO,KAAK,CAAA;gBACzB,CAAC;gBAAC,OAAO,MAAM,EAAE,CAAC;oBAChB,6CAA6C;gBAC/C,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IAED,KAAK,CAAC,mBAAmB;QAKvB,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAA;QAC5C,MAAM,SAAS,GAAG,IAAI,GAAG,EAAmD,CAAA;QAE5E,KAAK,MAAM,KAAK,IAAI,SAAS,EAAE,CAAC;YAC9B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACnC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAA;YACxD,CAAC;YACD,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAE,CAAA;YAC5C,KAAK,CAAC,MAAM,EAAE,CAAA;QAChB,CAAC;QAED,OAAO;YACL,WAAW,EAAE,SAAS,CAAC,MAAM;YAC7B,UAAU,EAAE,CAAC;YACb,iBAAiB,EAAE,SAAS;SAC7B,CAAA;IACH,CAAC;CACF"}

package/dist/ports/index.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Platform Ports
+ * --------------
+ * The engine must never touch platform APIs directly. Each host (React Native,
+ * browser extension, Node) implements these ports and injects them at startup,
+ * so the same engine + adapters run everywhere unchanged.
+ */
+/** Persistent key/value storage. RN → SecureStore/MMKV; extension → chrome.storage. */
+export interface IStorageProvider {
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string): Promise<void>;
+    remove(key: string): Promise<void>;
+    keys(): Promise<string[]>;
+}
+/** Host capabilities the engine needs but that vary per platform. */
+export interface IRuntimeProvider {
+    /** Host identifier — drives diagnostics and WDK export-condition selection. */
+    readonly host: 'react-native' | 'extension' | 'node' | 'web';
+    /** Secure random bytes from the platform CSPRNG. */
+    randomBytes(length: number): Uint8Array;
+    /** Epoch millis — injectable so tests/replay can be deterministic. */
+    now(): number;
+}
+/** Leveled logger. Hosts inject their own (extension → redacting ring buffer). */
+export interface Logger {
+    debug(...args: unknown[]): void;
+    info(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+    error(...args: unknown[]): void;
+}
+/** Bundle of ports handed to the engine at initialization. */
+export interface PlatformContext {
+    storage: IStorageProvider;
+    runtime: IRuntimeProvider;
+    /** Optional host logger; engine falls back to a console-backed logger. */
+    logger?: Logger;
+}
+/**
+ * Console-backed logger used when a host injects none. Kept as the single place
+ * the engine touches `console`, so the rest of core stays host-agnostic.
+ */
+export declare const consoleLogger: Logger;
+/** Inject the host's platform ports once at startup. */
+export declare function setPlatform(ctx: PlatformContext): void;
+/** The injected platform context, or null if the host never called setPlatform. */
+export declare function getPlatform(): PlatformContext | null;
+/** The active logger: injected host logger if present, else the console logger. */
+export declare function getLogger(): Logger;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ports/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,uFAAuF;AACvF,MAAM,WAAW,gBAAgB;IAC/B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;IACxC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAClC,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;CAC1B;AAED,qEAAqE;AACrE,MAAM,WAAW,gBAAgB;IAC/B,+EAA+E;IAC/E,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,WAAW,GAAG,MAAM,GAAG,KAAK,CAAA;IAC5D,oDAAoD;IACpD,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAAA;IACvC,sEAAsE;IACtE,GAAG,IAAI,MAAM,CAAA;CACd;AAED,kFAAkF;AAClF,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAC/B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAC9B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAC9B,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;CAChC;AAED,8DAA8D;AAC9D,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,gBAAgB,CAAA;IACzB,OAAO,EAAE,gBAAgB,CAAA;IACzB,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,MAK3B,CAAA;AAID,wDAAwD;AACxD,wBAAgB,WAAW,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI,CAEtD;AAED,mFAAmF;AACnF,wBAAgB,WAAW,IAAI,eAAe,GAAG,IAAI,CAEpD;AAED,mFAAmF;AACnF,wBAAgB,SAAS,IAAI,MAAM,CAElC"}

package/dist/ports/index.js

@@ -0,0 +1,31 @@
+/**
+ * Platform Ports
+ * --------------
+ * The engine must never touch platform APIs directly. Each host (React Native,
+ * browser extension, Node) implements these ports and injects them at startup,
+ * so the same engine + adapters run everywhere unchanged.
+ */
+/**
+ * Console-backed logger used when a host injects none. Kept as the single place
+ * the engine touches `console`, so the rest of core stays host-agnostic.
+ */
+export const consoleLogger = {
+    debug: (...a) => console.debug(...a),
+    info: (...a) => console.info(...a),
+    warn: (...a) => console.warn(...a),
+    error: (...a) => console.error(...a),
+};
+let platform = null;
+/** Inject the host's platform ports once at startup. */
+export function setPlatform(ctx) {
+    platform = ctx;
+}
+/** The injected platform context, or null if the host never called setPlatform. */
+export function getPlatform() {
+    return platform;
+}
+/** The active logger: injected host logger if present, else the console logger. */
+export function getLogger() {
+    return platform?.logger ?? consoleLogger;
+}
+//# sourceMappingURL=index.js.map

package/dist/ports/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ports/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAoCH;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAW;IACnC,KAAK,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACpC,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClC,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClC,KAAK,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;CACrC,CAAA;AAED,IAAI,QAAQ,GAA2B,IAAI,CAAA;AAE3C,wDAAwD;AACxD,MAAM,UAAU,WAAW,CAAC,GAAoB;IAC9C,QAAQ,GAAG,GAAG,CAAA;AAChB,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,WAAW;IACzB,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,SAAS;IACvB,OAAO,QAAQ,EAAE,MAAM,IAAI,aAAa,CAAA;AAC1C,CAAC"}

package/dist/receive/unifiedReceive.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Unified Receive URI (BIP321)
+ * ----------------------------
+ * Builds ONE QR payload that any wallet can pay, while Kaleido-aware wallets get the
+ * richer multi-protocol options. The base is a **BIP321** `bitcoin:` URI — the
+ * generalized successor to BIP21: an optional on-chain address in the path plus
+ * payment methods as query params (`lightning=` BOLT11, `lno=` BOLT12), and unknown
+ * params are ignored by other wallets. It stays backward-compatible with BIP21
+ * (the `bitcoin:` scheme + `amount`/`label`/`lightning` are understood by BIP21 wallets).
+ *
+ * Per BIP321 the address MAY be omitted (`bitcoin:?lightning=...&spark=...`), so a
+ * lite wallet with no on-chain address can still publish one QR. Ark / Spark / Liquid
+ * / RGB ride as extra (non-standard) params that only Kaleido wallets read.
+ *
+ * This is the "single QR with embedded LN, Ark, Spark addresses" the lite-mode
+ * receive flow needs. Pure + dependency-free.
+ */
+export interface UnifiedReceiveParams {
+    /** On-chain BTC address. OPTIONAL under BIP321 — omit for a LN/asset-only QR. */
+    btcAddress?: string;
+    /** BOLT11 invoice for Lightning (BIP321 `lightning=`). */
+    lightningInvoice?: string;
+    /** BOLT12 offer for Lightning (BIP321 `lno=`). */
+    lightningOffer?: string;
+    /** Spark address/invoice (Kaleido-only param). */
+    sparkAddress?: string;
+    /** Arkade address (Kaleido-only param). */
+    arkadeAddress?: string;
+    /** Liquid address (Kaleido-only param). */
+    liquidAddress?: string;
+    /** RGB invoice (Kaleido-only param). */
+    rgbInvoice?: string;
+    /** Amount in BTC (BIP21/BIP321 `amount`). */
+    amountBtc?: number;
+    /** Human label/message. */
+    label?: string;
+    /** RGB/Liquid asset id, when receiving a specific asset. */
+    assetId?: string;
+    /** Asset amount in display units. */
+    assetAmount?: number;
+}
+/**
+ * Build a single BIP321 `bitcoin:` URI carrying every available receive method.
+ * The address is optional; at least one of (address | lightning | lno | spark | ark |
+ * liquid | rgb) must be present.
+ *
+ * Examples:
+ *   bitcoin:bc1q...?amount=0.001&lightning=lnbc...&spark=spark1...&ark=ark1...
+ *   bitcoin:?lightning=lnbc...&liquid=lq1...           (BIP321: address omitted)
+ */
+export declare function buildUnifiedReceiveURI(p: UnifiedReceiveParams): string;
+/** Parse a BIP321 unified URI back into its parts (Kaleido wallets use this on scan). */
+export declare function parseUnifiedReceiveURI(uri: string): UnifiedReceiveParams | null;
+//# sourceMappingURL=unifiedReceive.d.ts.map

package/dist/receive/unifiedReceive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unifiedReceive.d.ts","sourceRoot":"","sources":["../../src/receive/unifiedReceive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,WAAW,oBAAoB;IACnC,iFAAiF;IACjF,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,0DAA0D;IAC1D,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,kDAAkD;IAClD,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,kDAAkD;IAClD,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,2CAA2C;IAC3C,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,2CAA2C;IAC3C,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,wCAAwC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,qCAAqC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAcD;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,oBAAoB,GAAG,MAAM,CA4BtE;AAED,yFAAyF;AACzF,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI,CAqB/E"}

package/dist/receive/unifiedReceive.js

@@ -0,0 +1,102 @@
+/**
+ * Unified Receive URI (BIP321)
+ * ----------------------------
+ * Builds ONE QR payload that any wallet can pay, while Kaleido-aware wallets get the
+ * richer multi-protocol options. The base is a **BIP321** `bitcoin:` URI — the
+ * generalized successor to BIP21: an optional on-chain address in the path plus
+ * payment methods as query params (`lightning=` BOLT11, `lno=` BOLT12), and unknown
+ * params are ignored by other wallets. It stays backward-compatible with BIP21
+ * (the `bitcoin:` scheme + `amount`/`label`/`lightning` are understood by BIP21 wallets).
+ *
+ * Per BIP321 the address MAY be omitted (`bitcoin:?lightning=...&spark=...`), so a
+ * lite wallet with no on-chain address can still publish one QR. Ark / Spark / Liquid
+ * / RGB ride as extra (non-standard) params that only Kaleido wallets read.
+ *
+ * This is the "single QR with embedded LN, Ark, Spark addresses" the lite-mode
+ * receive flow needs. Pure + dependency-free.
+ */
+/** BIP321 query keys (case-insensitive). `lightning`/`lno` are standard; the rest are Kaleido-namespaced. */
+const K = {
+    lightning: 'lightning',
+    lno: 'lno',
+    spark: 'spark',
+    ark: 'ark',
+    liquid: 'liquid',
+    rgb: 'rgb',
+    assetId: 'assetid',
+    assetAmount: 'assetamount',
+};
+/**
+ * Build a single BIP321 `bitcoin:` URI carrying every available receive method.
+ * The address is optional; at least one of (address | lightning | lno | spark | ark |
+ * liquid | rgb) must be present.
+ *
+ * Examples:
+ *   bitcoin:bc1q...?amount=0.001&lightning=lnbc...&spark=spark1...&ark=ark1...
+ *   bitcoin:?lightning=lnbc...&liquid=lq1...           (BIP321: address omitted)
+ */
+export function buildUnifiedReceiveURI(p) {
+    const hasMethod = !!p.btcAddress ||
+        !!p.lightningInvoice ||
+        !!p.lightningOffer ||
+        !!p.sparkAddress ||
+        !!p.arkadeAddress ||
+        !!p.liquidAddress ||
+        !!p.rgbInvoice;
+    if (!hasMethod) {
+        throw new Error('buildUnifiedReceiveURI requires at least one receive method (address or a payment param)');
+    }
+    const params = new URLSearchParams();
+    if (p.amountBtc != null)
+        params.set('amount', formatBtc(p.amountBtc));
+    if (p.label)
+        params.set('label', p.label);
+    if (p.lightningInvoice)
+        params.set(K.lightning, p.lightningInvoice);
+    if (p.lightningOffer)
+        params.set(K.lno, p.lightningOffer);
+    if (p.sparkAddress)
+        params.set(K.spark, p.sparkAddress);
+    if (p.arkadeAddress)
+        params.set(K.ark, p.arkadeAddress);
+    if (p.liquidAddress)
+        params.set(K.liquid, p.liquidAddress);
+    if (p.rgbInvoice)
+        params.set(K.rgb, p.rgbInvoice);
+    if (p.assetId)
+        params.set(K.assetId, p.assetId);
+    if (p.assetAmount != null)
+        params.set(K.assetAmount, String(p.assetAmount));
+    const qs = params.toString();
+    // BIP321: `bitcoin:` + optional address + optional `?params`.
+    return `bitcoin:${p.btcAddress ?? ''}${qs ? `?${qs}` : ''}`;
+}
+/** Parse a BIP321 unified URI back into its parts (Kaleido wallets use this on scan). */
+export function parseUnifiedReceiveURI(uri) {
+    // Address is optional under BIP321 → allow an empty path.
+    const m = (uri ?? '').trim().match(/^bitcoin:([^?]*)(?:\?(.*))?$/i);
+    if (!m)
+        return null;
+    const btcAddress = m[1] || undefined;
+    const params = new URLSearchParams(m[2] ?? '');
+    const amount = params.get('amount');
+    const assetAmount = params.get(K.assetAmount);
+    return {
+        btcAddress,
+        amountBtc: amount != null ? Number(amount) : undefined,
+        label: params.get('label') ?? undefined,
+        lightningInvoice: params.get(K.lightning) ?? undefined,
+        lightningOffer: params.get(K.lno) ?? undefined,
+        sparkAddress: params.get(K.spark) ?? undefined,
+        arkadeAddress: params.get(K.ark) ?? undefined,
+        liquidAddress: params.get(K.liquid) ?? undefined,
+        rgbInvoice: params.get(K.rgb) ?? undefined,
+        assetId: params.get(K.assetId) ?? undefined,
+        assetAmount: assetAmount != null ? Number(assetAmount) : undefined,
+    };
+}
+/** BIP21/BIP321 amounts are in BTC with up to 8 decimals, no trailing zeros / exponent. */
+function formatBtc(amountBtc) {
+    return amountBtc.toFixed(8).replace(/\.?0+$/, '');
+}
+//# sourceMappingURL=unifiedReceive.js.map

package/dist/receive/unifiedReceive.js.map

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

package/dist/registry/createWdkRegistry.d.ts

@@ -0,0 +1,20 @@
+/**
+ * WDK Registry Factory
+ * --------------------
+ * Convenience: build a `ProtocolAdapterRegistry` populated with the WDK-backed
+ * adapters. Opt-in — apps may instead register adapters selectively to keep bundles
+ * lean. Importing this pulls only the thin adapter wrappers; the heavy WDK modules
+ * are loaded lazily inside each adapter's `connect()` (dynamic import), so this does
+ * NOT eagerly bundle the WDK modules.
+ *
+ * Adapters are constructed but NOT connected — call `connect(config)` per protocol
+ * (each adapter's config carries its mnemonic + protocol-specific endpoints).
+ */
+import { ProtocolAdapterRegistry } from '../adapters/IProtocolAdapter.js';
+import { ProtocolType } from '../types/base.js';
+export interface WdkRegistryOptions {
+    /** Which protocols to register (default: all four). */
+    enabled?: ProtocolType[];
+}
+export declare function createWdkRegistry(opts?: WdkRegistryOptions): ProtocolAdapterRegistry;
+//# sourceMappingURL=createWdkRegistry.d.ts.map

package/dist/registry/createWdkRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createWdkRegistry.d.ts","sourceRoot":"","sources":["../../src/registry/createWdkRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAA;AAKtE,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAE5C,MAAM,WAAW,kBAAkB;IACjC,uDAAuD;IACvD,OAAO,CAAC,EAAE,YAAY,EAAE,CAAA;CACzB;AAID,wBAAgB,iBAAiB,CAAC,IAAI,GAAE,kBAAuB,GAAG,uBAAuB,CAQxF"}

package/dist/registry/createWdkRegistry.js

@@ -0,0 +1,32 @@
+/**
+ * WDK Registry Factory
+ * --------------------
+ * Convenience: build a `ProtocolAdapterRegistry` populated with the WDK-backed
+ * adapters. Opt-in — apps may instead register adapters selectively to keep bundles
+ * lean. Importing this pulls only the thin adapter wrappers; the heavy WDK modules
+ * are loaded lazily inside each adapter's `connect()` (dynamic import), so this does
+ * NOT eagerly bundle the WDK modules.
+ *
+ * Adapters are constructed but NOT connected — call `connect(config)` per protocol
+ * (each adapter's config carries its mnemonic + protocol-specific endpoints).
+ */
+import { ProtocolAdapterRegistry } from '../adapters/IProtocolAdapter.js';
+import { SparkWdkAdapter } from '../adapters/wdk/SparkWdkAdapter.js';
+import { LiquidWdkAdapter } from '../adapters/wdk/LiquidWdkAdapter.js';
+import { RlnWdkAdapter } from '../adapters/wdk/RlnWdkAdapter.js';
+import { ArkadeWdkAdapter } from '../adapters/wdk/ArkadeWdkAdapter.js';
+const ALL = ['SPARK', 'LIQUID', 'RGB', 'ARKADE'];
+export function createWdkRegistry(opts = {}) {
+    const enabled = opts.enabled ?? ALL;
+    const registry = new ProtocolAdapterRegistry();
+    if (enabled.includes('SPARK'))
+        registry.register(new SparkWdkAdapter());
+    if (enabled.includes('LIQUID'))
+        registry.register(new LiquidWdkAdapter());
+    if (enabled.includes('RGB'))
+        registry.register(new RlnWdkAdapter());
+    if (enabled.includes('ARKADE'))
+        registry.register(new ArkadeWdkAdapter());
+    return registry;
+}
+//# sourceMappingURL=createWdkRegistry.js.map

package/dist/registry/createWdkRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createWdkRegistry.js","sourceRoot":"","sources":["../../src/registry/createWdkRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAA;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAA;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAA;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAA;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAA;AAQnE,MAAM,GAAG,GAAmB,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAA;AAEhE,MAAM,UAAU,iBAAiB,CAAC,OAA2B,EAAE;IAC7D,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,GAAG,CAAA;IACnC,MAAM,QAAQ,GAAG,IAAI,uBAAuB,EAAE,CAAA;IAC9C,IAAI,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI,eAAe,EAAE,CAAC,CAAA;IACvE,IAAI,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI,gBAAgB,EAAE,CAAC,CAAA;IACzE,IAAI,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI,aAAa,EAAE,CAAC,CAAA;IACnE,IAAI,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI,gBAAgB,EAAE,CAAC,CAAA;IACzE,OAAO,QAAQ,CAAA;AACjB,CAAC"}