@kaleidorg/wallet-engine 1.0.0-beta.12

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.js';
+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.js';
+import { ProtocolType, Layer } from '../types/base.js';
+import { ClassifiedDestination } from './destination.js';
+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/index.js';
+import { classifyDestination } from './destination.js';
+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.js';
+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.js';
+import { loadWdkModule } from '../adapters/wdk/moduleLoader.js';
+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":"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"}

package/dist/swap/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Kaleidoswap RFQ swap wrapper.
+ *
+ * Opt-in sub-path export: `@kaleidorg/wallet-engine/swap`. Uses the WDK
+ * module loader, so it is kept out of the adapter-free main barrel.
+ */
+export { KaleidoswapSwap, type KaleidoswapSwapConfig, type SwapQuoteRequest, type SwapExecuteRequest, } from './KaleidoswapSwap.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/swap/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,eAAe,EACf,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,GACxB,MAAM,mBAAmB,CAAA"}

package/dist/swap/index.js

@@ -0,0 +1,8 @@
+/**
+ * Kaleidoswap RFQ swap wrapper.
+ *
+ * Opt-in sub-path export: `@kaleidorg/wallet-engine/swap`. Uses the WDK
+ * module loader, so it is kept out of the adapter-free main barrel.
+ */
+export { KaleidoswapSwap, } from './KaleidoswapSwap.js';
+//# sourceMappingURL=index.js.map

package/dist/swap/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/swap/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,eAAe,GAIhB,MAAM,mBAAmB,CAAA"}

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

package/dist/types/arkade.js

@@ -0,0 +1,6 @@
+/**
+ * Arkade Protocol Types
+ * Ported from rate-extension/src/protocols/types/arkade.ts
+ */
+export {};
+//# sourceMappingURL=arkade.js.map

package/dist/types/arkade.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arkade.js","sourceRoot":"","sources":["../../src/types/arkade.ts"],"names":[],"mappings":"AAAA;;;GAGG"}