@kaleidorg/wallet-protocols 1.0.0-beta.2

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';
+import { ProtocolType } from '../types/base';
+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';
+import { SparkWdkAdapter } from '../adapters/wdk/SparkWdkAdapter';
+import { LiquidWdkAdapter } from '../adapters/wdk/LiquidWdkAdapter';
+import { RlnWdkAdapter } from '../adapters/wdk/RlnWdkAdapter';
+import { ArkadeWdkAdapter } from '../adapters/wdk/ArkadeWdkAdapter';
+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"}

package/dist/router/destination.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Destination Classifier
+ * ----------------------
+ * Pure, dependency-free classification of a send destination string into a
+ * (kind, layer, candidate protocols) triple. The cross-protocol router uses this
+ * to decide which adapter(s) can pay a given destination — without any adapter
+ * needing to know about the others.
+ *
+ * This is the cross-protocol layer that WDK's per-module detection does NOT cover:
+ * WDK detects within a protocol; this chooses BETWEEN protocols.
+ */
+import { ProtocolType, Layer, AddressFormat } from '../types/base';
+export type DestinationKind = 'BOLT11' | 'LN_ADDRESS' | 'RGB_INVOICE' | 'SPARK' | 'ARKADE' | 'LIQUID' | 'BTC_ONCHAIN' | 'BIP21' | 'UNKNOWN';
+export interface ClassifiedDestination {
+    kind: DestinationKind;
+    /** The most specific layer this destination settles on. */
+    layer: Layer | null;
+    /** Address format (for passing to swap receiverAddressFormat / UI). */
+    format: AddressFormat | null;
+    /** Protocols capable of paying this destination, best-first. */
+    candidates: ProtocolType[];
+    /** For BIP21: an embedded BOLT11 fallback, if present. */
+    lightningFallback?: string;
+    /** The normalized payable string (URI-stripped where relevant). */
+    value: string;
+}
+export declare function classifyDestination(raw: string): ClassifiedDestination;
+//# sourceMappingURL=destination.d.ts.map

package/dist/router/destination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"destination.d.ts","sourceRoot":"","sources":["../../src/router/destination.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAElE,MAAM,MAAM,eAAe,GACvB,QAAQ,GACR,YAAY,GACZ,aAAa,GACb,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,aAAa,GACb,OAAO,GACP,SAAS,CAAA;AAEb,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,eAAe,CAAA;IACrB,2DAA2D;IAC3D,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;IACnB,uEAAuE;IACvE,MAAM,EAAE,aAAa,GAAG,IAAI,CAAA;IAC5B,gEAAgE;IAChE,UAAU,EAAE,YAAY,EAAE,CAAA;IAC1B,0DAA0D;IAC1D,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,mEAAmE;IACnE,KAAK,EAAE,MAAM,CAAA;CACd;AAoBD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,qBAAqB,CAoDtE"}

package/dist/router/destination.js

@@ -0,0 +1,72 @@
+/**
+ * Destination Classifier
+ * ----------------------
+ * Pure, dependency-free classification of a send destination string into a
+ * (kind, layer, candidate protocols) triple. The cross-protocol router uses this
+ * to decide which adapter(s) can pay a given destination — without any adapter
+ * needing to know about the others.
+ *
+ * This is the cross-protocol layer that WDK's per-module detection does NOT cover:
+ * WDK detects within a protocol; this chooses BETWEEN protocols.
+ */
+const RE = {
+    bolt11: /^ln(bc|tb|bcrt|sb)[0-9]/i,
+    lnurl: /^lnurl[0-9a-z]/i,
+    lnAddress: /^[^@\s]+@[^@\s]+\.[^@\s]+$/i,
+    rgb: /^(rgb:|utxob:)/i,
+    spark: /^(spark|sparkrt|sprt|spt)1[0-9a-z]/i,
+    arkade: /^(ark|tark)1[0-9a-z]/i,
+    liquid: /^(lq1|tlq1|ex1|el1|VJL|VT|CT|Az|Gq|H)/, // confidential + segwit Liquid prefixes
+    btc: /^(bc1|tb1|bcrt1|[13]|[mn2])[0-9a-zA-Z]/,
+    bip21: /^bitcoin:/i,
+};
+/** Pull a `lightning=` parameter out of a BIP21 URI, if present. */
+function extractLightning(uri) {
+    const m = uri.match(/[?&]lightning=([^&]+)/i);
+    return m ? decodeURIComponent(m[1]) : undefined;
+}
+export function classifyDestination(raw) {
+    const dest = (raw ?? '').trim();
+    if (RE.bip21.test(dest)) {
+        const addr = dest.slice('bitcoin:'.length).split('?')[0];
+        const lightningFallback = extractLightning(dest);
+        return {
+            kind: 'BIP21',
+            layer: 'BTC_L1',
+            format: 'BTC_ADDRESS',
+            // On-chain BTC can be served by any protocol with an on-chain path; LN fallback widens it.
+            candidates: ['RGB', 'ARKADE', 'SPARK', 'LIQUID'],
+            lightningFallback,
+            value: addr,
+        };
+    }
+    if (RE.bolt11.test(dest)) {
+        return { kind: 'BOLT11', layer: 'BTC_LN', format: 'BOLT11', candidates: ['RGB', 'SPARK', 'ARKADE'], value: dest };
+    }
+    if (RE.lnurl.test(dest) || RE.lnAddress.test(dest)) {
+        return { kind: 'LN_ADDRESS', layer: 'BTC_LN', format: 'BOLT11', candidates: ['RGB', 'SPARK', 'ARKADE'], value: dest };
+    }
+    if (RE.rgb.test(dest)) {
+        return { kind: 'RGB_INVOICE', layer: 'RGB_LN', format: 'RGB_INVOICE', candidates: ['RGB'], value: dest };
+    }
+    if (RE.spark.test(dest)) {
+        return { kind: 'SPARK', layer: 'SPARK_SPARK', format: 'SPARK_ADDRESS', candidates: ['SPARK'], value: dest };
+    }
+    if (RE.arkade.test(dest)) {
+        return { kind: 'ARKADE', layer: 'ARKADE_ARKADE', format: 'ARKADE_ADDRESS', candidates: ['ARKADE'], value: dest };
+    }
+    if (RE.liquid.test(dest)) {
+        return { kind: 'LIQUID', layer: 'BTC_LIQUID', format: 'LIQUID_ADDRESS', candidates: ['LIQUID'], value: dest };
+    }
+    if (RE.btc.test(dest)) {
+        return {
+            kind: 'BTC_ONCHAIN',
+            layer: 'BTC_L1',
+            format: 'BTC_ADDRESS',
+            candidates: ['RGB', 'ARKADE', 'SPARK'], // protocols that can pay an on-chain BTC address
+            value: dest,
+        };
+    }
+    return { kind: 'UNKNOWN', layer: null, format: null, candidates: [], value: dest };
+}
+//# sourceMappingURL=destination.js.map

package/dist/router/destination.js.map

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

package/dist/router/index.d.ts

@@ -0,0 +1,55 @@
+/**
+ * CrossProtocolRouter
+ * -------------------
+ * Sits ON TOP of the adapters and chooses BETWEEN protocols. Given a send
+ * destination or a receive intent, it returns the protocol(s) that can fulfil it,
+ * filtered to what's actually registered and connected. This is the layer that
+ * makes lite mode possible: it auto-selects the route so the UI never has to.
+ *
+ * It reads the capability manifest (differences-as-data) + the destination
+ * classifier — never the adapters' internals.
+ */
+import { ProtocolAdapterRegistry, IProtocolAdapter } from '../adapters/IProtocolAdapter';
+import { ProtocolType, Layer } from '../types/base';
+import { ClassifiedDestination } from './destination';
+export interface SendRoute {
+    protocol: ProtocolType;
+    adapter: IProtocolAdapter;
+    layer: Layer | null;
+    /** True when this protocol can pay the destination directly (no swap). */
+    direct: boolean;
+}
+export interface SendResolution {
+    destination: ClassifiedDestination;
+    /** Routes that can pay the destination directly, best-first. */
+    routes: SendRoute[];
+    /** The auto-selected route for lite mode (first direct route), or null. */
+    best: SendRoute | null;
+}
+export interface ReceiveRoute {
+    protocol: ProtocolType;
+    adapter: IProtocolAdapter;
+    layer: Layer;
+}
+export declare class CrossProtocolRouter {
+    private registry;
+    constructor(registry: ProtocolAdapterRegistry);
+    /** Only adapters that are registered AND connected are eligible to route. */
+    private connected;
+    /**
+     * Resolve how to SEND to a destination string.
+     * Lite mode uses `.best`; advanced mode can offer the full `.routes` list.
+     */
+    resolveSend(destination: string): SendResolution;
+    /**
+     * Resolve which protocols can RECEIVE on a given layer (e.g. show the user
+     * the available "receive over Lightning / Spark / on-chain" options).
+     */
+    resolveReceive(layer: Layer): ReceiveRoute[];
+    /**
+     * Which registered+connected protocols hold/transfer a given asset family.
+     * `assetFamily`: 'BTC' or a specific asset id resolved by the caller to a protocol.
+     */
+    resolveByCapability(predicate: (protocol: ProtocolType) => boolean): IProtocolAdapter[];
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/router/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AACxF,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAEnD,OAAO,EAAuB,qBAAqB,EAAE,MAAM,eAAe,CAAA;AAE1E,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,YAAY,CAAA;IACtB,OAAO,EAAE,gBAAgB,CAAA;IACzB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;IACnB,0EAA0E;IAC1E,MAAM,EAAE,OAAO,CAAA;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,qBAAqB,CAAA;IAClC,gEAAgE;IAChE,MAAM,EAAE,SAAS,EAAE,CAAA;IACnB,2EAA2E;IAC3E,IAAI,EAAE,SAAS,GAAG,IAAI,CAAA;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,YAAY,CAAA;IACtB,OAAO,EAAE,gBAAgB,CAAA;IACzB,KAAK,EAAE,KAAK,CAAA;CACb;AAED,qBAAa,mBAAmB;IAClB,OAAO,CAAC,QAAQ;gBAAR,QAAQ,EAAE,uBAAuB;IAErD,6EAA6E;IAC7E,OAAO,CAAC,SAAS;IAKjB;;;OAGG;IACH,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc;IAahD;;;OAGG;IACH,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,YAAY,EAAE;IAY5C;;;OAGG;IACH,mBAAmB,CAAC,SAAS,EAAE,CAAC,QAAQ,EAAE,YAAY,KAAK,OAAO,GAAG,gBAAgB,EAAE;CAOxF"}

package/dist/router/index.js

@@ -0,0 +1,67 @@
+/**
+ * CrossProtocolRouter
+ * -------------------
+ * Sits ON TOP of the adapters and chooses BETWEEN protocols. Given a send
+ * destination or a receive intent, it returns the protocol(s) that can fulfil it,
+ * filtered to what's actually registered and connected. This is the layer that
+ * makes lite mode possible: it auto-selects the route so the UI never has to.
+ *
+ * It reads the capability manifest (differences-as-data) + the destination
+ * classifier — never the adapters' internals.
+ */
+import { getCapabilities } from '../capabilities';
+import { classifyDestination } from './destination';
+export class CrossProtocolRouter {
+    constructor(registry) {
+        this.registry = registry;
+    }
+    /** Only adapters that are registered AND connected are eligible to route. */
+    connected(protocol) {
+        const a = this.registry.get(protocol);
+        return a && a.isConnected() ? a : null;
+    }
+    /**
+     * Resolve how to SEND to a destination string.
+     * Lite mode uses `.best`; advanced mode can offer the full `.routes` list.
+     */
+    resolveSend(destination) {
+        const classified = classifyDestination(destination);
+        const routes = [];
+        for (const protocol of classified.candidates) {
+            const adapter = this.connected(protocol);
+            if (!adapter)
+                continue;
+            routes.push({ protocol, adapter, layer: classified.layer, direct: true });
+        }
+        return { destination: classified, routes, best: routes[0] ?? null };
+    }
+    /**
+     * Resolve which protocols can RECEIVE on a given layer (e.g. show the user
+     * the available "receive over Lightning / Spark / on-chain" options).
+     */
+    resolveReceive(layer) {
+        const out = [];
+        for (const protocol of this.registry.getSupportedProtocols()) {
+            const caps = getCapabilities(protocol);
+            if (!caps.layers.includes(layer))
+                continue;
+            const adapter = this.connected(protocol);
+            if (!adapter)
+                continue;
+            out.push({ protocol, adapter, layer });
+        }
+        return out;
+    }
+    /**
+     * Which registered+connected protocols hold/transfer a given asset family.
+     * `assetFamily`: 'BTC' or a specific asset id resolved by the caller to a protocol.
+     */
+    resolveByCapability(predicate) {
+        return this.registry
+            .getSupportedProtocols()
+            .filter(predicate)
+            .map((p) => this.connected(p))
+            .filter((a) => a != null);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/router/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/router/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,EAAE,mBAAmB,EAAyB,MAAM,eAAe,CAAA;AAwB1E,MAAM,OAAO,mBAAmB;IAC9B,YAAoB,QAAiC;QAAjC,aAAQ,GAAR,QAAQ,CAAyB;IAAG,CAAC;IAEzD,6EAA6E;IACrE,SAAS,CAAC,QAAsB;QACtC,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QACrC,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IACxC,CAAC;IAED;;;OAGG;IACH,WAAW,CAAC,WAAmB;QAC7B,MAAM,UAAU,GAAG,mBAAmB,CAAC,WAAW,CAAC,CAAA;QACnD,MAAM,MAAM,GAAgB,EAAE,CAAA;QAE9B,KAAK,MAAM,QAAQ,IAAI,UAAU,CAAC,UAAU,EAAE,CAAC;YAC7C,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAA;YACxC,IAAI,CAAC,OAAO;gBAAE,SAAQ;YACtB,MAAM,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;QAC3E,CAAC;QAED,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAA;IACrE,CAAC;IAED;;;OAGG;IACH,cAAc,CAAC,KAAY;QACzB,MAAM,GAAG,GAAmB,EAAE,CAAA;QAC9B,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,qBAAqB,EAAE,EAAE,CAAC;YAC7D,MAAM,IAAI,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAA;YACtC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAAE,SAAQ;YAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAA;YACxC,IAAI,CAAC,OAAO;gBAAE,SAAQ;YACtB,GAAG,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAA;QACxC,CAAC;QACD,OAAO,GAAG,CAAA;IACZ,CAAC;IAED;;;OAGG;IACH,mBAAmB,CAAC,SAA8C;QAChE,OAAO,IAAI,CAAC,QAAQ;aACjB,qBAAqB,EAAE;aACvB,MAAM,CAAC,SAAS,CAAC;aACjB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;aAC7B,MAAM,CAAC,CAAC,CAAC,EAAyB,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,CAAA;IACpD,CAAC;CACF"}

package/dist/swap/KaleidoswapSwap.d.ts

@@ -0,0 +1,44 @@
+/**
+ * KaleidoswapSwap
+ * ---------------
+ * Wraps the WDK Kaleidoswap swap protocol module (@kaleidorg/wdk-protocol-swap-kaleidoswap)
+ * behind domain `Quote`/`SwapResult` types. This is the cross-asset swap path (RFQ via the
+ * maker) — distinct from the lower-level cross-L2 atomic (VHTLC/Boltz) layer in types/cross-l2.
+ *
+ * The swap module is bound to an account (it needs a wallet to settle legs) + a baseUrl.
+ * No WDK/kaleido-sdk types cross this boundary.
+ */
+import { Quote, QuoteRequest, SwapResult } from '../types/base';
+export interface KaleidoswapSwapConfig {
+    /** KaleidoSwap maker API base URL. */
+    baseUrl: string;
+}
+/** Extended quote request carrying the layer hints the maker RFQ needs. */
+export interface SwapQuoteRequest extends QuoteRequest {
+    fromLayer: string;
+    toLayer: string;
+}
+export interface SwapExecuteRequest extends SwapQuoteRequest {
+    /** Destination address/invoice for the OUTPUT asset. */
+    receiverAddress: string;
+    /** Format of the receiver address (e.g. 'RGB_INVOICE', 'BOLT11', 'BTC_ADDRESS'). */
+    receiverAddressFormat: string;
+}
+export declare class KaleidoswapSwap {
+    private account;
+    private config;
+    private proto;
+    /**
+     * @param account a connected WDK account (e.g. the RLN account that settles RGB-LN legs).
+     *        Passed straight through to the swap module; held as `any`.
+     */
+    constructor(account: any, config: KaleidoswapSwapConfig);
+    private ensure;
+    getQuote(req: SwapQuoteRequest): Promise<Quote>;
+    executeSwap(req: SwapExecuteRequest): Promise<SwapResult & {
+        depositAddress: string | null;
+        depositAddressFormat: string | null;
+    }>;
+    getSwapStatus(orderId: string): Promise<SwapResult>;
+}
+//# sourceMappingURL=KaleidoswapSwap.d.ts.map

package/dist/swap/KaleidoswapSwap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KaleidoswapSwap.d.ts","sourceRoot":"","sources":["../../src/swap/KaleidoswapSwap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,UAAU,EAAiB,MAAM,eAAe,CAAA;AAG9E,MAAM,WAAW,qBAAqB;IACpC,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,2EAA2E;AAC3E,MAAM,WAAW,gBAAiB,SAAQ,YAAY;IACpD,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,kBAAmB,SAAQ,gBAAgB;IAC1D,wDAAwD;IACxD,eAAe,EAAE,MAAM,CAAA;IACvB,oFAAoF;IACpF,qBAAqB,EAAE,MAAM,CAAA;CAC9B;AAED,qBAAa,eAAe;IAOd,OAAO,CAAC,OAAO;IAAO,OAAO,CAAC,MAAM;IANhD,OAAO,CAAC,KAAK,CAAY;IAEzB;;;OAGG;gBACiB,OAAO,EAAE,GAAG,EAAU,MAAM,EAAE,qBAAqB;YAEzD,MAAM;IASd,QAAQ,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,KAAK,CAAC;IAyB/C,WAAW,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,GAAG;QAAE,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAkClI,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;CAqB1D"}

package/dist/swap/KaleidoswapSwap.js

@@ -0,0 +1,123 @@
+/**
+ * KaleidoswapSwap
+ * ---------------
+ * Wraps the WDK Kaleidoswap swap protocol module (@kaleidorg/wdk-protocol-swap-kaleidoswap)
+ * behind domain `Quote`/`SwapResult` types. This is the cross-asset swap path (RFQ via the
+ * maker) — distinct from the lower-level cross-L2 atomic (VHTLC/Boltz) layer in types/cross-l2.
+ *
+ * The swap module is bound to an account (it needs a wallet to settle legs) + a baseUrl.
+ * No WDK/kaleido-sdk types cross this boundary.
+ */
+import { ProtocolError } from '../types/base';
+import { loadWdkModule } from '../adapters/wdk/moduleLoader';
+export class KaleidoswapSwap {
+    /**
+     * @param account a connected WDK account (e.g. the RLN account that settles RGB-LN legs).
+     *        Passed straight through to the swap module; held as `any`.
+     */
+    constructor(account, config) {
+        this.account = account;
+        this.config = config;
+        this.proto = null;
+    }
+    async ensure() {
+        if (this.proto)
+            return this.proto;
+        // @ts-ignore — declared as a workspace/optional dep; resolved at runtime.
+        const mod = await loadWdkModule('@kaleidorg/wdk-protocol-swap-kaleidoswap', () => import('@kaleidorg/wdk-protocol-swap-kaleidoswap'));
+        const KaleidoswapProtocol = mod.default ?? mod;
+        this.proto = new KaleidoswapProtocol(this.account, { baseUrl: this.config.baseUrl });
+        return this.proto;
+    }
+    async getQuote(req) {
+        if (req.fromAmount == null) {
+            throw new ProtocolError('Swap quote requires fromAmount', 'RGB', 'NO_AMOUNT');
+        }
+        const proto = await this.ensure();
+        const q = await proto.quoteSwap({
+            fromAssetId: req.fromAsset,
+            toAssetId: req.toAsset,
+            fromLayer: req.fromLayer,
+            toLayer: req.toLayer,
+            fromAmount: req.fromAmount,
+        });
+        return {
+            id: q.rfqId,
+            fromAsset: req.fromAsset,
+            fromAmount: Number(q.tokenInAmount),
+            toAsset: req.toAsset,
+            toAmount: Number(q.tokenOutAmount),
+            price: Number(q.price),
+            fee: { amount: Number(q.fee), asset: req.fromAsset },
+            expiresAt: Number(q.expiresAt) * 1000,
+            provider: 'kaleidoswap',
+        };
+    }
+    async executeSwap(req) {
+        if (req.fromAmount == null) {
+            throw new ProtocolError('Swap requires fromAmount', 'RGB', 'NO_AMOUNT');
+        }
+        const proto = await this.ensure();
+        const r = await proto.swap({
+            fromAssetId: req.fromAsset,
+            toAssetId: req.toAsset,
+            fromLayer: req.fromLayer,
+            toLayer: req.toLayer,
+            fromAmount: req.fromAmount,
+            receiverAddress: req.receiverAddress,
+            receiverAddressFormat: req.receiverAddressFormat,
+        });
+        return {
+            swapId: r.orderId,
+            status: 'pending',
+            quote: {
+                id: r.orderId,
+                fromAsset: req.fromAsset,
+                fromAmount: Number(r.tokenInAmount),
+                toAsset: req.toAsset,
+                toAmount: Number(r.tokenOutAmount),
+                price: 0,
+                fee: { amount: Number(r.fee), asset: req.fromAsset },
+                expiresAt: 0,
+                provider: 'kaleidoswap',
+            },
+            timestamp: Date.now(),
+            depositAddress: r.depositAddress ?? null,
+            depositAddressFormat: r.depositAddressFormat ?? null,
+        };
+    }
+    async getSwapStatus(orderId) {
+        const proto = await this.ensure();
+        const o = await proto.getOrderStatus(orderId);
+        const status = mapOrderStatus(o?.status);
+        return {
+            swapId: o.id,
+            status,
+            quote: {
+                id: o.rfq_id,
+                fromAsset: o.from_asset?.asset_id,
+                fromAmount: Number(o.from_asset?.amount ?? 0),
+                toAsset: o.to_asset?.asset_id,
+                toAmount: Number(o.to_asset?.amount ?? 0),
+                price: Number(o.price ?? 0),
+                fee: { amount: 0, asset: o.from_asset?.asset_id },
+                expiresAt: 0,
+                provider: 'kaleidoswap',
+            },
+            timestamp: Date.now(),
+        };
+    }
+}
+function mapOrderStatus(s) {
+    switch (s) {
+        case 'FILLED':
+            return 'confirmed';
+        case 'FAILED':
+        case 'EXPIRED':
+        case 'CANCELLED':
+            return 'failed';
+        default:
+            return 'pending';
+    }
+}
+//# sourceMappingURL=KaleidoswapSwap.js.map

package/dist/swap/KaleidoswapSwap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"KaleidoswapSwap.js","sourceRoot":"","sources":["../../src/swap/KaleidoswapSwap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAmC,aAAa,EAAE,MAAM,eAAe,CAAA;AAC9E,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAA;AAoB5D,MAAM,OAAO,eAAe;IAG1B;;;OAGG;IACH,YAAoB,OAAY,EAAU,MAA6B;QAAnD,YAAO,GAAP,OAAO,CAAK;QAAU,WAAM,GAAN,MAAM,CAAuB;QAN/D,UAAK,GAAQ,IAAI,CAAA;IAMiD,CAAC;IAEnE,KAAK,CAAC,MAAM;QAClB,IAAI,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC,KAAK,CAAA;QACjC,0EAA0E;QAC1E,MAAM,GAAG,GAAG,MAAM,aAAa,CAAC,0CAA0C,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,0CAA0C,CAAC,CAAC,CAAA;QACrI,MAAM,mBAAmB,GAAG,GAAG,CAAC,OAAO,IAAI,GAAG,CAAA;QAC9C,IAAI,CAAC,KAAK,GAAG,IAAI,mBAAmB,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAA;QACpF,OAAO,IAAI,CAAC,KAAK,CAAA;IACnB,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,GAAqB;QAClC,IAAI,GAAG,CAAC,UAAU,IAAI,IAAI,EAAE,CAAC;YAC3B,MAAM,IAAI,aAAa,CAAC,gCAAgC,EAAE,KAAK,EAAE,WAAW,CAAC,CAAA;QAC/E,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,CAAA;QACjC,MAAM,CAAC,GAAQ,MAAM,KAAK,CAAC,SAAS,CAAC;YACnC,WAAW,EAAE,GAAG,CAAC,SAAS;YAC1B,SAAS,EAAE,GAAG,CAAC,OAAO;YACtB,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,UAAU,EAAE,GAAG,CAAC,UAAU;SAC3B,CAAC,CAAA;QACF,OAAO;YACL,EAAE,EAAE,CAAC,CAAC,KAAK;YACX,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC;YACnC,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC;YAClC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC;YACtB,GAAG,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,SAAS,EAAE;YACpD,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI;YACrC,QAAQ,EAAE,aAAa;SACxB,CAAA;IACH,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,GAAuB;QACvC,IAAI,GAAG,CAAC,UAAU,IAAI,IAAI,EAAE,CAAC;YAC3B,MAAM,IAAI,aAAa,CAAC,0BAA0B,EAAE,KAAK,EAAE,WAAW,CAAC,CAAA;QACzE,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,CAAA;QACjC,MAAM,CAAC,GAAQ,MAAM,KAAK,CAAC,IAAI,CAAC;YAC9B,WAAW,EAAE,GAAG,CAAC,SAAS;YAC1B,SAAS,EAAE,GAAG,CAAC,OAAO;YACtB,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,UAAU,EAAE,GAAG,CAAC,UAAU;YAC1B,eAAe,EAAE,GAAG,CAAC,eAAe;YACpC,qBAAqB,EAAE,GAAG,CAAC,qBAAqB;SACjD,CAAC,CAAA;QACF,OAAO;YACL,MAAM,EAAE,CAAC,CAAC,OAAO;YACjB,MAAM,EAAE,SAAS;YACjB,KAAK,EAAE;gBACL,EAAE,EAAE,CAAC,CAAC,OAAO;gBACb,SAAS,EAAE,GAAG,CAAC,SAAS;gBACxB,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC;gBACnC,OAAO,EAAE,GAAG,CAAC,OAAO;gBACpB,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC;gBAClC,KAAK,EAAE,CAAC;gBACR,GAAG,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,SAAS,EAAE;gBACpD,SAAS,EAAE,CAAC;gBACZ,QAAQ,EAAE,aAAa;aACxB;YACD,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,cAAc,EAAE,CAAC,CAAC,cAAc,IAAI,IAAI;YACxC,oBAAoB,EAAE,CAAC,CAAC,oBAAoB,IAAI,IAAI;SACrD,CAAA;IACH,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,OAAe;QACjC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,CAAA;QACjC,MAAM,CAAC,GAAQ,MAAM,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,CAAA;QAClD,MAAM,MAAM,GAAG,cAAc,CAAC,CAAC,EAAE,MAAM,CAAC,CAAA;QACxC,OAAO;YACL,MAAM,EAAE,CAAC,CAAC,EAAE;YACZ,MAAM;YACN,KAAK,EAAE;gBACL,EAAE,EAAE,CAAC,CAAC,MAAM;gBACZ,SAAS,EAAE,CAAC,CAAC,UAAU,EAAE,QAAQ;gBACjC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC,CAAC;gBAC7C,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,QAAQ;gBAC7B,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC,CAAC;gBACzC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;gBAC3B,GAAG,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,UAAU,EAAE,QAAQ,EAAE;gBACjD,SAAS,EAAE,CAAC;gBACZ,QAAQ,EAAE,aAAa;aACxB;YACD,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAA;IACH,CAAC;CACF;AAED,SAAS,cAAc,CAAC,CAAU;IAChC,QAAQ,CAAC,EAAE,CAAC;QACV,KAAK,QAAQ;YACX,OAAO,WAAW,CAAA;QACpB,KAAK,QAAQ,CAAC;QACd,KAAK,SAAS,CAAC;QACf,KAAK,WAAW;YACd,OAAO,QAAQ,CAAA;QACjB;YACE,OAAO,SAAS,CAAA;IACpB,CAAC;AACH,CAAC"}

package/dist/types/arkade.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Arkade Protocol Types
+ * Ported from rate-extension/src/protocols/types/arkade.ts
+ */
+import { BaseProtocolConfig } from '../adapters/IProtocolAdapter';
+export interface ArkadeConfig extends Omit<BaseProtocolConfig, 'network'> {
+    protocol: 'ARKADE';
+    mnemonic: string;
+    arkServerUrl: string;
+    esploraUrl?: string;
+    network?: 'mainnet' | 'signet';
+    delegatorUrl?: string;
+    delegationEnabled?: boolean;
+    vtxoThresholdSeconds?: number;
+}
+export interface ArkadeVtxo {
+    txid: string;
+    vout: number;
+    amount: bigint;
+    expiresAt?: number;
+    status?: 'confirmed' | 'preconfirmed' | 'recoverable';
+}
+export interface ArkadeBalance {
+    total: bigint;
+    available: bigint;
+    preconfirmed: bigint;
+    settled: bigint;
+    recoverable: bigint;
+    boarding: {
+        total: bigint;
+    };
+}
+export interface ArkadeTransaction {
+    type: 'send' | 'receive' | 'boarding' | 'offboard';
+    amount: number;
+    txid?: string;
+    timestamp?: number;
+    status?: string;
+}
+//# sourceMappingURL=arkade.d.ts.map

package/dist/types/arkade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arkade.d.ts","sourceRoot":"","sources":["../../src/types/arkade.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAA;AAEjE,MAAM,WAAW,YAAa,SAAQ,IAAI,CAAC,kBAAkB,EAAE,SAAS,CAAC;IACvE,QAAQ,EAAE,QAAQ,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAA;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,oBAAoB,CAAC,EAAE,MAAM,CAAA;CAC9B;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,WAAW,GAAG,cAAc,GAAG,aAAa,CAAA;CACtD;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,YAAY,EAAE,MAAM,CAAA;IACpB,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE;QACR,KAAK,EAAE,MAAM,CAAA;KACd,CAAA;CACF;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,CAAA;IAClD,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB"}