@kaleidorg/wallet-engine 1.0.0-beta.4 → 1.0.0-beta.42

package/dist/ports/index.js

@@ -5,5 +5,27 @@
  * browser extension, Node) implements these ports and injects them at startup,
  * so the same engine + adapters run everywhere unchanged.
  */
-export {};
+/**
+ * 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

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

@@ -51,4 +51,16 @@ export interface UnifiedReceiveParams {
 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;
+/**
+ * The distinct payment methods present in a parsed unified URI.
+ *
+ * A unified `bitcoin:` URI may carry several independent payment methods (an
+ * on-chain address AND a `lightning=` invoice AND an asset invoice). They are
+ * NOT cryptographically bound to one another — a scanned QR could pair an
+ * address with an unrelated invoice. Consumers MUST present the methods and let
+ * the user/router choose one explicitly; they must not silently auto-pay a
+ * different method than the one the user intended. This helper enumerates what's
+ * on offer so the UI can do that.
+ */
+export declare function receiveMethodsOf(p: UnifiedReceiveParams): Array<keyof UnifiedReceiveParams>;
 //# sourceMappingURL=unifiedReceive.d.ts.map

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

@@ -1 +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"}
+{"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,CAsB/E;AAcD;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,oBAAoB,GAAG,KAAK,CAAC,MAAM,oBAAoB,CAAC,CAW3F"}

package/dist/receive/unifiedReceive.js

@@ -79,11 +79,12 @@ export function parseUnifiedReceiveURI(uri) {
         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,
+        // Amounts are coerced through a finite/non-negative guard: a junk, negative,
+        // or non-finite `amount=` must surface as `undefined`, never as NaN/-1/Infinity
+        // flowing into a send.
+        amountBtc: toNonNegativeFinite(params.get('amount')),
         label: params.get('label') ?? undefined,
         lightningInvoice: params.get(K.lightning) ?? undefined,
         lightningOffer: params.get(K.lno) ?? undefined,
@@ -92,11 +93,41 @@ export function parseUnifiedReceiveURI(uri) {
         liquidAddress: params.get(K.liquid) ?? undefined,
         rgbInvoice: params.get(K.rgb) ?? undefined,
         assetId: params.get(K.assetId) ?? undefined,
-        assetAmount: assetAmount != null ? Number(assetAmount) : undefined,
+        assetAmount: toNonNegativeFinite(params.get(K.assetAmount)),
     };
 }
+/** Parse a query value as a finite, non-negative number, else `undefined`. */
+function toNonNegativeFinite(v) {
+    if (v == null || v.trim() === '')
+        return undefined;
+    const n = Number(v);
+    return Number.isFinite(n) && n >= 0 ? n : 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+$/, '');
 }
+/**
+ * The distinct payment methods present in a parsed unified URI.
+ *
+ * A unified `bitcoin:` URI may carry several independent payment methods (an
+ * on-chain address AND a `lightning=` invoice AND an asset invoice). They are
+ * NOT cryptographically bound to one another — a scanned QR could pair an
+ * address with an unrelated invoice. Consumers MUST present the methods and let
+ * the user/router choose one explicitly; they must not silently auto-pay a
+ * different method than the one the user intended. This helper enumerates what's
+ * on offer so the UI can do that.
+ */
+export function receiveMethodsOf(p) {
+    const keys = [
+        'btcAddress',
+        'lightningInvoice',
+        'lightningOffer',
+        'sparkAddress',
+        'arkadeAddress',
+        'liquidAddress',
+        'rgbInvoice',
+    ];
+    return keys.filter((k) => p[k] != null && p[k] !== '');
+}
 //# sourceMappingURL=unifiedReceive.js.map

package/dist/receive/unifiedReceive.js.map

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

package/dist/registry/createWdkRegistry.d.ts

@@ -10,11 +10,19 @@
  * 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';
+import { ProtocolAdapterRegistry } from '../adapters/IProtocolAdapter.js';
+import { ProtocolType } from '../types/base.js';
 export interface WdkRegistryOptions {
     /** Which protocols to register (default: all four). */
     enabled?: ProtocolType[];
+    /**
+     * Which RGB_L1 backing to register when `RGB_L1` is enabled:
+     *  - `'native'` (default): `RgbLibWdkAdapter` (native rgb-lib + filesystem
+     *    dataDir; Node/RN/desktop only).
+     *  - `'wasm'`: `RgbLibWasmAdapter` (browser/WASM rgb-lib + IndexedDB; runs
+     *    node-less in an MV3 service worker).
+     */
+    rgbL1Backing?: 'native' | 'wasm';
 }
 export declare function createWdkRegistry(opts?: WdkRegistryOptions): ProtocolAdapterRegistry;
 //# sourceMappingURL=createWdkRegistry.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"createWdkRegistry.d.ts","sourceRoot":"","sources":["../../src/registry/createWdkRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAA;AAOtE,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAE5C,MAAM,WAAW,kBAAkB;IACjC,uDAAuD;IACvD,OAAO,CAAC,EAAE,YAAY,EAAE,CAAA;IACxB;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAA;CACjC;AAMD,wBAAgB,iBAAiB,CAAC,IAAI,GAAE,kBAAuB,GAAG,uBAAuB,CAWxF"}

package/dist/registry/createWdkRegistry.js

@@ -10,12 +10,16 @@
  * 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'];
+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 { RgbLibWdkAdapter } from '../adapters/wdk/RgbLibWdkAdapter.js';
+import { RgbLibWasmAdapter } from '../adapters/wdk/RgbLibWasmAdapter.js';
+import { ArkadeWdkAdapter } from '../adapters/wdk/ArkadeWdkAdapter.js';
+// RGB_L1 is opt-in (not in the default set): it's an alternative to the
+// node-backed RGB path, not an addition to it, and the backing is host-specific.
+const ALL = ['SPARK', 'LIQUID', 'RGB_LN', 'ARKADE'];
 export function createWdkRegistry(opts = {}) {
     const enabled = opts.enabled ?? ALL;
     const registry = new ProtocolAdapterRegistry();
@@ -23,8 +27,11 @@ export function createWdkRegistry(opts = {}) {
         registry.register(new SparkWdkAdapter());
     if (enabled.includes('LIQUID'))
         registry.register(new LiquidWdkAdapter());
-    if (enabled.includes('RGB'))
+    if (enabled.includes('RGB_LN'))
         registry.register(new RlnWdkAdapter());
+    if (enabled.includes('RGB_L1')) {
+        registry.register(opts.rgbL1Backing === 'wasm' ? new RgbLibWasmAdapter() : new RgbLibWdkAdapter());
+    }
     if (enabled.includes('ARKADE'))
         registry.register(new ArkadeWdkAdapter());
     return registry;

package/dist/registry/createWdkRegistry.js.map

@@ -1 +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"}
+{"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;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAA;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAA;AAgBnE,wEAAwE;AACxE,iFAAiF;AACjF,MAAM,GAAG,GAAmB,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAA;AAEnE,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,QAAQ,CAAC;QAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI,aAAa,EAAE,CAAC,CAAA;IACtE,IAAI,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC/B,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,iBAAiB,EAAE,CAAC,CAAC,CAAC,IAAI,gBAAgB,EAAE,CAAC,CAAA;IACpG,CAAC;IACD,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

@@ -9,8 +9,8 @@
  * 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';
+import { ProtocolType, Layer, AddressFormat } from '../types/base.js';
+export type DestinationKind = 'BOLT11' | 'BOLT12' | 'LN_ADDRESS' | 'RGB_INVOICE' | 'SPARK' | 'ARKADE' | 'LIQUID' | 'BTC_ONCHAIN' | 'BIP21' | 'UNKNOWN';
 export interface ClassifiedDestination {
     kind: DestinationKind;
     /** The most specific layer this destination settles on. */

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

@@ -1 +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"}
+{"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,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;AAoCD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,qBAAqB,CA4DtE"}

package/dist/router/destination.js

@@ -9,15 +9,31 @@
  * This is the cross-protocol layer that WDK's per-module detection does NOT cover:
  * WDK detects within a protocol; this chooses BETWEEN protocols.
  */
+// Matchers are deliberately STRICT and anchored: the classifier directs funds,
+// so it must fail CLOSED (→ UNKNOWN, no candidates) on anything it cannot
+// positively identify. A loose prefix that matches arbitrary text (the old
+// Liquid `H`/`VT`/`Az` and the bare-letter BTC fallbacks) is a fund-misrouting
+// bug, not a convenience.
 const RE = {
     bolt11: /^ln(bc|tb|bcrt|sb)[0-9]/i,
-    lnurl: /^lnurl[0-9a-z]/i,
+    bolt12: /^lno1[0-9a-z]+$/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]/,
+    // Spark bech32m HRPs, per the @buildonspark/spark-sdk address encoder:
+    // `spark1` (mainnet), `sparkt1` (testnet), `sparkrt1` (regtest), `sparkl1`
+    // (local/signet), plus the legacy `spl1`/`sprt1` forms. `sp1` is deliberately
+    // NOT here — that HRP belongs to BIP352 Silent Payments, so matching it as
+    // Spark would be a fund-misrouting bug. Longest prefixes first.
+    spark: /^(sparkrt|sparkt|sparkl|spark|sprt|spl)1[0-9a-z]{6,}$/i,
+    arkade: /^(ark|tark)1[0-9a-z]{6,}$/i,
+    // Liquid bech32/blech32 only (confidential `lq1`, unconfidential `ex1`, +
+    // testnet/regtest variants). Legacy base58 Liquid prefixes are intentionally
+    // dropped: `VT`/`H`/`Gq` are indistinguishable from arbitrary text.
+    liquid: /^(lq1|tlq1|ex1|tex1|el1|ert1)[0-9a-z]{6,}$/i,
+    // BTC bech32 (charset excludes 1/b/i/o) or legacy base58 (charset excludes
+    // 0/O/I/l), length-bounded so junk like `not-an-address` cannot match.
+    btc: /^(bc1|tb1|bcrt1)[02-9ac-hj-np-z]{6,87}$|^[13mn2][a-km-zA-HJ-NP-Z1-9]{25,39}$/,
     bip21: /^bitcoin:/i,
 };
 /** Pull a `lightning=` parameter out of a BIP21 URI, if present. */
@@ -34,20 +50,27 @@ export function classifyDestination(raw) {
             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'],
+            // On-chain BTC can be served by any protocol with a Bitcoin on-chain path.
+            // LIQUID is excluded: it's a separate L1 and cannot settle a BTC address.
+            // (An embedded `lightning=` fallback widens the route at the router layer.)
+            candidates: ['RGB_LN', 'RGB_L1', 'ARKADE', 'SPARK'],
             lightningFallback,
             value: addr,
         };
     }
+    if (RE.bolt12.test(dest)) {
+        return { kind: 'BOLT12', layer: 'BTC_LN', format: 'BOLT12', candidates: ['RGB_LN', 'SPARK', 'ARKADE'], value: dest };
+    }
     if (RE.bolt11.test(dest)) {
-        return { kind: 'BOLT11', layer: 'BTC_LN', format: 'BOLT11', candidates: ['RGB', 'SPARK', 'ARKADE'], value: dest };
+        return { kind: 'BOLT11', layer: 'BTC_LN', format: 'BOLT11', candidates: ['RGB_LN', '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 };
+        return { kind: 'LN_ADDRESS', layer: 'BTC_LN', format: 'BOLT11', candidates: ['RGB_LN', 'SPARK', 'ARKADE'], value: dest };
     }
     if (RE.rgb.test(dest)) {
-        return { kind: 'RGB_INVOICE', layer: 'RGB_LN', format: 'RGB_INVOICE', candidates: ['RGB'], value: dest };
+        // Either RGB backing can pay an RGB invoice; the router filters to whichever
+        // is registered + connected (and verifies it can settle the layer).
+        return { kind: 'RGB_INVOICE', layer: 'RGB_LN', format: 'RGB_INVOICE', candidates: ['RGB_LN', 'RGB_L1'], value: dest };
     }
     if (RE.spark.test(dest)) {
         return { kind: 'SPARK', layer: 'SPARK_SPARK', format: 'SPARK_ADDRESS', candidates: ['SPARK'], value: dest };
@@ -63,7 +86,7 @@ export function classifyDestination(raw) {
             kind: 'BTC_ONCHAIN',
             layer: 'BTC_L1',
             format: 'BTC_ADDRESS',
-            candidates: ['RGB', 'ARKADE', 'SPARK'], // protocols that can pay an on-chain BTC address
+            candidates: ['RGB_LN', 'RGB_L1', 'ARKADE', 'SPARK'], // protocols that can pay an on-chain BTC address
             value: dest,
         };
     }

package/dist/router/destination.js.map

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

package/dist/router/index.d.ts

@@ -9,9 +9,11 @@
  * 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';
+import { ProtocolAdapterRegistry, IProtocolAdapter } from '../adapters/IProtocolAdapter.js';
+import { ProtocolType, Layer } from '../types/base.js';
+import { ClassifiedDestination } from './destination.js';
+import { type UnifiedReceiveParams } from '../receive/unifiedReceive.js';
+import { type Rail, type RoutePreference } from './preference.js';
 export interface SendRoute {
     protocol: ProtocolType;
     adapter: IProtocolAdapter;
@@ -31,6 +33,21 @@ export interface ReceiveRoute {
     adapter: IProtocolAdapter;
     layer: Layer;
 }
+/** A send route through a specific rail of a unified payment URI. */
+export interface UnifiedSendRoute extends SendRoute {
+    /** Which embedded rail this route pays through (lno/lightning/spark/…/onchain). */
+    rail: Rail;
+    /** The payable value for this rail (invoice/offer/address). */
+    value: string;
+}
+export interface UnifiedSendResolution {
+    /** The parsed unified URI (null when the input was a single raw destination). */
+    source: UnifiedReceiveParams | null;
+    /** Every payable rail×protocol route, ranked by preference (best first). */
+    routes: UnifiedSendRoute[];
+    /** The auto-selected route (highest-priority direct route) for lite mode, or null. */
+    best: UnifiedSendRoute | null;
+}
 export declare class CrossProtocolRouter {
     private registry;
     constructor(registry: ProtocolAdapterRegistry);
@@ -41,6 +58,25 @@ export declare class CrossProtocolRouter {
      * Lite mode uses `.best`; advanced mode can offer the full `.routes` list.
      */
     resolveSend(destination: string): SendResolution;
+    /**
+     * Resolve how to SEND to a UNIFIED payment URI (BIP21 / BIP321) that may carry
+     * several rails at once — a BOLT12 offer, a BOLT11 invoice, Spark/Arkade/Liquid
+     * addresses, an RGB invoice, an on-chain address. Each present rail is matched
+     * to the registered+connected protocols that can settle it, then the whole set
+     * is ranked by the user's `preference` (per-asset layer ranking) falling back to
+     * the Lightning-first default. `.best` is the auto-route for lite mode; advanced
+     * mode can present the full ranked `.routes` list.
+     *
+     * A plain (non-`bitcoin:`) string is handled too: it falls back to a single-rail
+     * `resolveSend`, so callers can use one entry point for any pasted destination.
+     *
+     * NOTE: BIP353 (₿user@domain) is intentionally out of scope here — it needs a
+     * DNS-over-HTTPS lookup the dependency-free engine doesn't perform; resolve it
+     * to a BIP321 URI in the host, then pass the result in.
+     */
+    resolveUnifiedSend(uri: string, opts?: {
+        preference?: RoutePreference;
+    }): UnifiedSendResolution;
     /**
      * Resolve which protocols can RECEIVE on a given layer (e.g. show the user
      * the available "receive over Lightning / Spark / on-chain" options).

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

@@ -1 +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"}
+{"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;AAC1E,OAAO,EAA0B,KAAK,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAC7F,OAAO,EACL,KAAK,IAAI,EACT,KAAK,eAAe,EAIrB,MAAM,cAAc,CAAA;AA+BrB,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,qEAAqE;AACrE,MAAM,WAAW,gBAAiB,SAAQ,SAAS;IACjD,mFAAmF;IACnF,IAAI,EAAE,IAAI,CAAA;IACV,+DAA+D;IAC/D,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,qBAAqB;IACpC,iFAAiF;IACjF,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAAA;IACnC,4EAA4E;IAC5E,MAAM,EAAE,gBAAgB,EAAE,CAAA;IAC1B,sFAAsF;IACtF,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAAA;CAC9B;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;IAoBhD;;;;;;;;;;;;;;;OAeG;IACH,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,eAAe,CAAA;KAAE,GAAG,qBAAqB;IAqD/F;;;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

@@ -9,8 +9,38 @@
  * It reads the capability manifest (differences-as-data) + the destination
  * classifier — never the adapters' internals.
  */
-import { getCapabilities } from '../capabilities';
-import { classifyDestination } from './destination';
+import { getCapabilities } from '../capabilities/index.js';
+import { classifyDestination } from './destination.js';
+import { parseUnifiedReceiveURI } from '../receive/unifiedReceive.js';
+import { layerPreferenceFor, compareByPreference, railOfKind, } from './preference.js';
+/**
+ * Whether `protocol` can pay `dest` DIRECTLY (no swap), per the capability
+ * manifest. Reads capability flags rather than exact layer strings so a protocol
+ * that reaches a surface by a different path (e.g. Spark paying on-chain via a
+ * deposit/exit) is still recognised.
+ */
+function canSettleDirectly(protocol, dest) {
+    const caps = getCapabilities(protocol);
+    switch (dest.kind) {
+        case 'BOLT11':
+        case 'BOLT12':
+        case 'LN_ADDRESS':
+            return caps.supportsLightning;
+        case 'BTC_ONCHAIN':
+        case 'BIP21':
+            return caps.supportsOnchain;
+        case 'RGB_INVOICE':
+            return caps.supportsAssets && caps.layers.some((l) => l.startsWith('RGB'));
+        case 'SPARK':
+            return protocol === 'SPARK';
+        case 'ARKADE':
+            return protocol === 'ARKADE';
+        case 'LIQUID':
+            return protocol === 'LIQUID';
+        default:
+            return false;
+    }
+}
 export class CrossProtocolRouter {
     constructor(registry) {
         this.registry = registry;
@@ -31,9 +61,88 @@ export class CrossProtocolRouter {
             const adapter = this.connected(protocol);
             if (!adapter)
                 continue;
-            routes.push({ protocol, adapter, layer: classified.layer, direct: true });
+            // `direct` is verified against the capability manifest, not assumed: a
+            // candidate is only a direct route if its protocol actually supports the
+            // surface this destination settles on. Lite mode's auto-route (`best`)
+            // must never claim a protocol can pay directly when the manifest disagrees.
+            const direct = canSettleDirectly(protocol, classified);
+            routes.push({ protocol, adapter, layer: classified.layer, direct });
+        }
+        // Direct routes first, so `best` is always a genuinely-direct route (or null).
+        routes.sort((a, b) => Number(b.direct) - Number(a.direct));
+        return { destination: classified, routes, best: routes.find((r) => r.direct) ?? null };
+    }
+    /**
+     * Resolve how to SEND to a UNIFIED payment URI (BIP21 / BIP321) that may carry
+     * several rails at once — a BOLT12 offer, a BOLT11 invoice, Spark/Arkade/Liquid
+     * addresses, an RGB invoice, an on-chain address. Each present rail is matched
+     * to the registered+connected protocols that can settle it, then the whole set
+     * is ranked by the user's `preference` (per-asset layer ranking) falling back to
+     * the Lightning-first default. `.best` is the auto-route for lite mode; advanced
+     * mode can present the full ranked `.routes` list.
+     *
+     * A plain (non-`bitcoin:`) string is handled too: it falls back to a single-rail
+     * `resolveSend`, so callers can use one entry point for any pasted destination.
+     *
+     * NOTE: BIP353 (₿user@domain) is intentionally out of scope here — it needs a
+     * DNS-over-HTTPS lookup the dependency-free engine doesn't perform; resolve it
+     * to a BIP321 URI in the host, then pass the result in.
+     */
+    resolveUnifiedSend(uri, opts) {
+        const parsed = parseUnifiedReceiveURI(uri);
+        // Not a unified `bitcoin:` URI → treat as a single raw destination.
+        if (!parsed) {
+            const r = this.resolveSend(uri);
+            const routes = r.routes.map((rt) => ({
+                ...rt,
+                rail: railOfKind(r.destination.kind),
+                value: r.destination.value,
+            }));
+            return { source: null, routes, best: routes.find((rt) => rt.direct) ?? null };
+        }
+        // Collect the (rail, payable value) pairs actually present in the URI.
+        const railValues = [];
+        if (parsed.lightningOffer)
+            railValues.push({ rail: 'lno', value: parsed.lightningOffer });
+        if (parsed.lightningInvoice)
+            railValues.push({ rail: 'lightning', value: parsed.lightningInvoice });
+        if (parsed.sparkAddress)
+            railValues.push({ rail: 'spark', value: parsed.sparkAddress });
+        if (parsed.arkadeAddress)
+            railValues.push({ rail: 'ark', value: parsed.arkadeAddress });
+        if (parsed.rgbInvoice)
+            railValues.push({ rail: 'rgb', value: parsed.rgbInvoice });
+        if (parsed.liquidAddress)
+            railValues.push({ rail: 'liquid', value: parsed.liquidAddress });
+        if (parsed.btcAddress)
+            railValues.push({ rail: 'onchain', value: parsed.btcAddress });
+        const routes = [];
+        for (const { rail, value } of railValues) {
+            // Classify each rail's value through the same single source of truth.
+            const classified = classifyDestination(value);
+            for (const protocol of classified.candidates) {
+                const adapter = this.connected(protocol);
+                if (!adapter)
+                    continue;
+                routes.push({
+                    protocol,
+                    adapter,
+                    layer: classified.layer,
+                    direct: canSettleDirectly(protocol, classified),
+                    rail,
+                    value,
+                });
+            }
         }
-        return { destination: classified, routes, best: routes[0] ?? null };
+        // Rank: direct routes first, then by the (per-asset) layer preference, then
+        // the default Lightning-first rail order.
+        const layerPref = layerPreferenceFor(opts?.preference, parsed.assetId);
+        routes.sort((a, b) => {
+            if (a.direct !== b.direct)
+                return Number(b.direct) - Number(a.direct);
+            return compareByPreference(a, b, layerPref);
+        });
+        return { source: parsed, routes, best: routes.find((r) => r.direct) ?? null };
     }
     /**
      * Resolve which protocols can RECEIVE on a given layer (e.g. show the user

package/dist/router/index.js.map

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

package/dist/router/preference.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Route preference + rail priority
+ * --------------------------------
+ * A unified payment URI (BIP21/BIP321) can carry several rails at once — a
+ * BOLT12 offer, a BOLT11 invoice, Spark/Arkade addresses, an RGB invoice, a
+ * Liquid address, an on-chain address. When more than one is payable, the
+ * engine has to pick. This module is the *data* that drives that choice:
+ *
+ *  - a DEFAULT rail ordering (Lightning-first), used when the user expresses no
+ *    preference, and
+ *  - a `RoutePreference` the host can supply: an ordered list of layers, with
+ *    optional per-asset overrides.
+ *
+ * Pure + dependency-free; the router consumes it.
+ */
+import { Layer } from '../types/base.js';
+import { DestinationKind } from './destination.js';
+/** A concrete payment rail, i.e. which embedded method pays the destination. */
+export type Rail = 'lno' | 'lightning' | 'spark' | 'ark' | 'rgb' | 'liquid' | 'onchain';
+/**
+ * Default rail priority — **Lightning-first**: BOLT12 offer, then BOLT11, then
+ * the off-chain instant rails (Spark, Arkade), then on-chain (RGB-L1, Liquid,
+ * bare BTC). Used when no user preference applies. Lower index = higher priority.
+ */
+export declare const DEFAULT_RAIL_ORDER: readonly Rail[];
+/**
+ * The user's routing preference. `layers` is a global ranking (highest first);
+ * `perAsset` overrides it for a specific asset id (e.g. prefer Liquid for USDt,
+ * Lightning for BTC). When neither resolves a tie, the DEFAULT rail order wins.
+ */
+export interface RoutePreference {
+    /** Global ordered layer ranking, highest priority first. */
+    layers?: Layer[];
+    /** Per-asset-id ordered layer rankings, overriding `layers` for that asset. */
+    perAsset?: Record<string, Layer[]>;
+}
+/** Resolve the effective ordered layer list for a given asset id (if any). */
+export declare function layerPreferenceFor(pref: RoutePreference | undefined, assetId?: string): Layer[] | undefined;
+/**
+ * Comparator for two rail/layer routes given a resolved layer preference.
+ * Primary key: the user's layer ranking (if the route's layer appears in it).
+ * Tiebreak: the default rail ordering. Routes neither side ranks compare equal.
+ */
+export declare function compareByPreference(a: {
+    rail: Rail;
+    layer: Layer | null;
+}, b: {
+    rail: Rail;
+    layer: Layer | null;
+}, layerPref?: Layer[]): number;
+/** Map a single-destination classification kind → its rail (for the non-URI path). */
+export declare function railOfKind(kind: DestinationKind): Rail;
+//# sourceMappingURL=preference.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"preference.d.ts","sourceRoot":"","sources":["../../src/router/preference.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AACrC,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAE/C,gFAAgF;AAChF,MAAM,MAAM,IAAI,GAAG,KAAK,GAAG,WAAW,GAAG,OAAO,GAAG,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,SAAS,CAAA;AAEvF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAAS,IAAI,EAQ7C,CAAA;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,4DAA4D;IAC5D,MAAM,CAAC,EAAE,KAAK,EAAE,CAAA;IAChB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,CAAA;CACnC;AAED,8EAA8E;AAC9E,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,eAAe,GAAG,SAAS,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,KAAK,EAAE,GAAG,SAAS,CAI3G;AAUD;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,CAAC,EAAE;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;CAAE,EACtC,CAAC,EAAE;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;CAAE,EACtC,SAAS,CAAC,EAAE,KAAK,EAAE,GAClB,MAAM,CAOR;AAED,sFAAsF;AACtF,wBAAgB,UAAU,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,CAoBtD"}