@anywalletkit/protocol-swap2-router 0.0.0-stage → 0.2.1

package/dist/router.cjs

@@ -0,0 +1,316 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/router.ts
+var router_exports = {};
+__export(router_exports, {
+  CrossChainRouter: () => CrossChainRouter
+});
+module.exports = __toCommonJS(router_exports);
+var import_validate = require("@anywalletkit/protocol-swap2-core/validate");
+var DEFAULT_WEIGHTS = { price: 0.6, speed: 0.3, reliability: 0.1 };
+var DEFAULT_TIE_BAND = 2e-3;
+var QUOTE_TIMEOUT_MS = 8e3;
+var SOLO_QUOTE_TIMEOUT_MS = 25e3;
+function parseWeights(spec) {
+  if (!spec) return DEFAULT_WEIGHTS;
+  const w = { ...DEFAULT_WEIGHTS };
+  for (const part of spec.split(",")) {
+    const [k, v] = part.split(":");
+    const n = Number(v);
+    if ((k === "price" || k === "speed" || k === "reliability") && Number.isFinite(n)) {
+      w[k] = Math.max(0, n);
+    }
+  }
+  return w;
+}
+async function withTimeout(p, ms) {
+  return new Promise((resolve, reject) => {
+    const timer = setTimeout(() => reject(new Error(`quote timed out after ${ms}ms`)), ms);
+    p.then(resolve, reject).finally(() => clearTimeout(timer));
+  });
+}
+var CrossChainRouter = class _CrossChainRouter {
+  providers;
+  /** Why the venues of the LAST getBestQuote call sat out — for error surfaces. */
+  _lastRejections = [];
+  /** Why providers sat out the last auction, one line each. */
+  get lastRejections() {
+    return this._lastRejections;
+  }
+  weights;
+  valueUsd;
+  tieBand;
+  options;
+  constructor(providers, options) {
+    const opts = typeof options === "string" ? { weights: options } : { ...options ?? {} };
+    if (opts.tieBand !== void 0 && !(Number.isFinite(opts.tieBand) && opts.tieBand >= 0 && opts.tieBand < 1)) {
+      throw new Error("cross-chain router: tieBand must be a fraction in [0, 1)");
+    }
+    const names = /* @__PURE__ */ new Set();
+    for (const provider of providers) {
+      if (typeof provider.name !== "string" || !/^[A-Za-z0-9_-]+$/.test(provider.name) || names.has(provider.name)) {
+        throw new Error(`cross-chain router: invalid or duplicate provider name '${String(provider.name)}'`);
+      }
+      names.add(provider.name);
+    }
+    this.providers = providers.map((provider) => ({
+      name: provider.name,
+      enabled: provider.enabled.bind(provider),
+      supportsRoute: provider.supportsRoute.bind(provider),
+      getQuote: provider.getQuote.bind(provider),
+      buildDeposit: provider.buildDeposit.bind(provider),
+      trackIntent: provider.trackIntent.bind(provider),
+      ...provider.preflightDeposit ? { preflightDeposit: provider.preflightDeposit.bind(provider) } : {},
+      ...provider.notifyDeposit ? { notifyDeposit: provider.notifyDeposit.bind(provider) } : {},
+      ...provider.registerSignedOrder ? { registerSignedOrder: provider.registerSignedOrder.bind(provider) } : {},
+      // Two-phase routes (CCTP): the destination claim. Missing here, the engine
+      // and the server both reported "provider 'cctp' has no claim step" (2026-10-13).
+      ...provider.buildClaim ? { buildClaim: provider.buildClaim.bind(provider) } : {},
+      ...provider.close ? { close: provider.close.bind(provider) } : {},
+      ...provider.supportsChain ? { supportsChain: provider.supportsChain.bind(provider) } : {},
+      ...provider.supportsChainPair ? { supportsChainPair: provider.supportsChainPair.bind(provider) } : {},
+      ...provider.describeActivity ? { describeActivity: provider.describeActivity.bind(provider) } : {},
+      ...provider.supportsSameChain !== void 0 ? { supportsSameChain: provider.supportsSameChain } : {}
+    }));
+    this.weights = parseWeights(opts.weights);
+    this.valueUsd = opts.valueUsd;
+    this.tieBand = opts.tieBand ?? DEFAULT_TIE_BAND;
+    this.options = opts;
+  }
+  /** The same auction restricted to one provider — to execute the route a user picked. */
+  only(name) {
+    const provider = this.getProvider(name);
+    if (!provider) throw new Error(`cross-chain router: provider '${name}' is not registered`);
+    return new _CrossChainRouter([provider], this.options);
+  }
+  /**
+   * Activity recognition across the installed providers: the first one that
+   * claims the transaction describes it. Null when none does (or none is held).
+   */
+  describeActivity(tx, ctx) {
+    for (const provider of this.providers) {
+      const item = provider.describeActivity?.(tx, ctx);
+      if (item) return item;
+    }
+    return null;
+  }
+  /** A provider by name. */
+  getProvider(name) {
+    return this.providers.find((p) => p.name === name);
+  }
+  /** True when a provider of that name is installed. */
+  hasProvider(name) {
+    return this.providers.some((p) => p.name === name);
+  }
+  /** True when that provider is installed and enabled. */
+  hasEnabledProvider(name) {
+    return this.providers.some((p) => {
+      try {
+        return p.name === name && p.enabled();
+      } catch {
+        return false;
+      }
+    });
+  }
+  /** True when any enabled provider declares the chain. */
+  supportsChain(caip2) {
+    return this.providers.some((p) => {
+      try {
+        return p.enabled() && !!p.supportsChain?.(caip2);
+      } catch {
+        return false;
+      }
+    });
+  }
+  /** True when any enabled provider declares the chain pair. */
+  supportsChainPair(fromChain, toChain) {
+    return this.providers.some((p) => {
+      try {
+        return p.enabled() && (p.supportsChainPair?.(fromChain, toChain) ?? false);
+      } catch {
+        return false;
+      }
+    });
+  }
+  /**
+   * The auction's pick: the best price (net of native fees and gas when
+   * `valueUsd` is set; faster, then more reliable, among equal prices), or
+   * the fastest route with `prefer: "fastest"`.
+   */
+  async getBestQuote(params, options) {
+    const set = await this.getQuotes(params, options);
+    if (!set) return null;
+    const pick = options?.prefer === "fastest" ? set.fastest : set.best;
+    const { netValueUsd: _n, relativeValue: _r, tags: _t, ...quote } = pick;
+    return {
+      ...quote,
+      routeScore: {
+        score: pick.relativeValue,
+        weights: this.weights,
+        candidates: set.quotes.map((q) => ({
+          provider: q.provider,
+          sourceAmount: q.sourceAmount,
+          etaSeconds: q.etaSeconds,
+          score: q.relativeValue,
+          minDestAmount: q.minDestAmount,
+          netValueUsd: q.netValueUsd
+        }))
+      }
+    };
+  }
+  /**
+   * Every validated route, ranked — for a route picker that shows the best and
+   * the fastest and lets the user choose. Providers run in parallel; with
+   * `onUpdate` each one that answers re-publishes the ranked set at once (the
+   * first price shows in the time of the fastest venue, not the slowest).
+   */
+  async getQuotes(params, options) {
+    const rejections = [];
+    this._lastRejections = rejections;
+    const snapshot = Object.freeze({ ...params });
+    const from = Object.freeze({ chain: snapshot.sourceChain, token: snapshot.sourceToken });
+    const to = Object.freeze({ chain: snapshot.destChain, token: snapshot.destToken });
+    let eligible = this.providers.filter((p) => {
+      try {
+        return p.enabled() && p.supportsRoute(from, to);
+      } catch {
+        return false;
+      }
+    });
+    if (snapshot.sourceChain === snapshot.destChain) {
+      eligible = eligible.filter((p) => p.supportsSameChain === true);
+    }
+    if (eligible.length === 0) return null;
+    const timeoutMs = eligible.length === 1 ? SOLO_QUOTE_TIMEOUT_MS : QUOTE_TIMEOUT_MS;
+    const refusals = [];
+    const accepted = [];
+    const pending = new Set(eligible.map((p) => p.name));
+    const publish = () => {
+      if (!options?.onUpdate || accepted.length === 0) return;
+      const set = this.rank(accepted, snapshot, [...pending], rejections);
+      try {
+        options.onUpdate(set);
+      } catch {
+      }
+    };
+    await Promise.all(eligible.map(async (p, i) => {
+      const controller = new AbortController();
+      const own = Object.freeze({ ...snapshot, onRefusal: (reason) => {
+        refusals[i] ??= reason.startsWith(`${p.name}:`) ? reason : `${p.name}: ${reason}`;
+        try {
+          snapshot.onRefusal?.(reason);
+        } catch {
+        }
+      } });
+      let q = null;
+      try {
+        q = await withTimeout(p.getQuote(own, controller.signal), timeoutMs);
+        if (!q) {
+          rejections.push(refusals[i] ?? `${p.name}: returned no quote`);
+        } else if (!(0, import_validate.validQuote)(q, snapshot, p.name)) {
+          const reason = `${p.name}: rejected by validation (minDest=${q.minDestAmount} vs floor=${snapshot.minAmountOut ?? "-"}, validUntil=${q.validUntilMs}, now=${Date.now()})`;
+          rejections.push(reason);
+          console.warn(`swap2-router: ${reason}`);
+          q = null;
+        } else if (options?.requireImmediateExecution && !(q.depositAddress.length > 0 || q.txRequest !== void 0)) {
+          q = null;
+        }
+      } catch (err) {
+        const reason = `${p.name}: ${err instanceof Error ? err.message.slice(0, 160) : String(err).slice(0, 160)}`;
+        rejections.push(reason);
+        console.warn(`swap2-router: quote failed \u2014 ${reason}`);
+        q = null;
+      } finally {
+        controller.abort();
+      }
+      pending.delete(p.name);
+      if (q) accepted.push({ ...q, provider: p.name });
+      publish();
+    }));
+    if (accepted.length === 0) return null;
+    return this.rank(accepted, snapshot, [], rejections);
+  }
+  /** Status from the named provider; `failed` when it is not installed. */
+  async trackIntent(providerName, ref) {
+    const provider = this.getProvider(providerName);
+    if (!provider) return { state: "failed" };
+    return provider.trackIntent(ref);
+  }
+  /** Forward a source-broadcast notification to the intent's provider. */
+  async notifyDeposit(providerName, intentId, txHash) {
+    await this.getProvider(providerName)?.notifyDeposit?.(intentId, txHash);
+  }
+  /** Release every provider's resources. */
+  close() {
+    for (const provider of this.providers) provider.close?.();
+  }
+  /**
+   * Price first: each quote's value is its net USD (`valueUsd`) — or, when any
+   * quote cannot be priced, its guaranteed output — against the best one.
+   * Quotes within `tieBand` of the best are the same price; among those the
+   * weights order speed and reliability. A $0.01 edge no longer beats a route
+   * that lands in seconds instead of twenty minutes, and a route that charges
+   * a native bridge fee on top no longer wins on its gross output.
+   */
+  rank(quotes, params, pending, rejections) {
+    const usd = this.valueUsd ? quotes.map((q) => {
+      try {
+        const v = this.valueUsd(q, params);
+        return typeof v === "number" && Number.isFinite(v) ? v : null;
+      } catch {
+        return null;
+      }
+    }) : quotes.map(() => null);
+    const priced = usd.every((v) => v !== null);
+    let relative;
+    if (priced) {
+      const values = usd;
+      const max = Math.max(...values);
+      relative = values.map((v) => max > 0 ? Math.max(0, v) / max : v >= max ? 1 : 0);
+    } else {
+      const outs = quotes.map((q) => BigInt(q.minDestAmount));
+      const max = outs.reduce((a, b) => b > a ? b : a);
+      relative = outs.map((o) => fraction(o, max));
+    }
+    const ranked = quotes.map((q, i) => ({
+      ...q,
+      netValueUsd: priced ? usd[i] : null,
+      relativeValue: relative[i],
+      tags: []
+    }));
+    const tier = ranked.filter((q) => q.relativeValue >= 1 - this.tieBand - 1e-12);
+    const etas = tier.map((q) => q.etaSeconds);
+    const minEta = Math.min(...etas);
+    const maxEta = Math.max(...etas);
+    const w = this.weights;
+    const tieScore = (q) => w.price * q.relativeValue + w.speed * (maxEta === minEta ? 1 : (maxEta - q.etaSeconds) / (maxEta - minEta)) + w.reliability * q.reliability;
+    const best = tier.reduce((a, b) => tieScore(b) > tieScore(a) ? b : a);
+    const fastest = ranked.reduce((a, b) => b.etaSeconds < a.etaSeconds || b.etaSeconds === a.etaSeconds && b.relativeValue > a.relativeValue ? b : a);
+    best.tags.push("best");
+    fastest.tags.push("fastest");
+    ranked.sort((a, b) => a === best ? -1 : b === best ? 1 : b.relativeValue - a.relativeValue || a.etaSeconds - b.etaSeconds);
+    return { quotes: ranked, best, fastest, pending, rejections: [...rejections] };
+  }
+};
+function fraction(num, den) {
+  if (den === 0n) return 1;
+  return Number(num * 10000n / den) / 1e4;
+}
+//# sourceMappingURL=router.cjs.map

package/dist/router.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/router.ts"],"sourcesContent":["/**\n * The auction engine of the optional aggregator: routes a cross-chain delivery\n * over whichever providers the caller installed and passed in. Protocol\n * modules never need it — each one runs standalone on @anywalletkit/protocol-swap2-core.\n */\nimport type {\n  CrossChainProvider,\n  IntentRef,\n  IntentStatus,\n  Quote,\n  QuoteParams,\n  RoutedQuote,\n  ScoreWeights,\n} from \"@anywalletkit/protocol-swap2-core/types\";\nimport {validQuote} from \"@anywalletkit/protocol-swap2-core/validate\";\nimport type {ActivityItem, ChainTx, DescribeActivityContext} from \"@anywalletkit/core\";\n\nconst DEFAULT_WEIGHTS: ScoreWeights = {price: 0.6, speed: 0.3, reliability: 0.1};\n/** Quotes within 0.2% of the best net value count as the same price. */\nconst DEFAULT_TIE_BAND = 0.002;\n\nexport interface RouterOptions {\n  /**\n   * \"price:0.6,speed:0.3,reliability:0.1\" — how quotes inside the tie band\n   * (same price, within `tieBand`) are ordered. Price itself always leads.\n   */\n  weights?: string;\n  /**\n   * What a quote is worth to the user in USD: its guaranteed output minus what\n   * the route charges on top (a native bridge fee, the source gas). Return null\n   * when it cannot be priced — the auction then compares guaranteed outputs.\n   * `usdValue(prices)` builds one from a symbol → USD price map.\n   */\n  valueUsd?: (quote: Quote, params: QuoteParams) => number | null;\n  /** Fraction of the best net value inside which quotes tie on price (default 0.002). */\n  tieBand?: number;\n}\n\n/** A validated quote with its place in the auction. */\nexport interface RankedQuote extends Quote {\n  /** Net USD value (`valueUsd`), or null when the auction compared raw outputs. */\n  netValueUsd: number | null;\n  /** This quote's value against the best one, 0..1 (1 = the best price). */\n  relativeValue: number;\n  /** \"best\": the pick (best price; faster/more reliable among equal prices). \"fastest\": the lowest ETA. */\n  tags: (\"best\" | \"fastest\")[];\n}\n\n/** Every validated route for one request, ranked by value. */\nexport interface RouteSet {\n  /** Every validated route, best first. */\n  quotes: RankedQuote[];\n  /** Most delivered value (net of fees when priced) within the tie band. */\n  best: RankedQuote;\n  /** Lowest ETA. */\n  fastest: RankedQuote;\n  /** Providers still quoting (only non-empty in progressive `onUpdate` snapshots). */\n  pending: string[];\n  /** Why the venues that sat out did (same as `lastRejections`). */\n  rejections: string[];\n}\n// LI.FI's /quote routinely takes ~3.5s (it builds executable calldata) — 4s\n// raced it out of every round. All providers still run in parallel.\nconst QUOTE_TIMEOUT_MS = 8000;\n/** Pinned single-venue (execution) budget — see the comment at the call site. */\nconst SOLO_QUOTE_TIMEOUT_MS = 25_000;\n\nfunction parseWeights(spec?: string): ScoreWeights {\n  if (!spec) return DEFAULT_WEIGHTS;\n  const w = {...DEFAULT_WEIGHTS};\n  for (const part of spec.split(\",\")) {\n    const [k, v] = part.split(\":\");\n    const n = Number(v);\n    if ((k === \"price\" || k === \"speed\" || k === \"reliability\") && Number.isFinite(n)) {\n      w[k] = Math.max(0, n);\n    }\n  }\n  return w;\n}\n\nasync function withTimeout<T>(p: Promise<T>, ms: number): Promise<T | null> {\n  return new Promise((resolve, reject) => {\n    // Timeouts and failures must REJECT: the old `() => resolve(null)` arm\n    // swallowed every provider error — including forwarded venue refusals —\n    // into a null indistinguishable from \"no route\", which made execution\n    // failures undiagnosable from the surface (the '(c2)' hunt of 2026-08-31).\n    const timer = setTimeout(() => reject(new Error(`quote timed out after ${ms}ms`)), ms);\n    p.then(resolve, reject).finally(() => clearTimeout(timer));\n  });\n}\n\n/**\n * Routes a cross-chain delivery over pluggable providers: queries all that\n * support the route in parallel (with a timeout so a slow provider can't block),\n * normalizes their quotes, scores by configurable weights, and returns the best\n * tagged with `routeScore`. A failed/slow provider simply doesn't participate.\n */\nexport class CrossChainRouter {\n  private readonly providers: CrossChainProvider[];\n  /** Why the venues of the LAST getBestQuote call sat out — for error surfaces. */\n  private _lastRejections: string[] = [];\n  /** Why providers sat out the last auction, one line each. */\n  get lastRejections(): readonly string[] {\n    return this._lastRejections;\n  }\n  private readonly weights: ScoreWeights;\n  private readonly valueUsd: RouterOptions[\"valueUsd\"];\n  private readonly tieBand: number;\n  private readonly options: RouterOptions;\n\n  constructor(providers: CrossChainProvider[], options?: string | RouterOptions) {\n    const opts: RouterOptions = typeof options === \"string\" ? {weights: options} : {...(options ?? {})};\n    if (opts.tieBand !== undefined && !(Number.isFinite(opts.tieBand) && opts.tieBand >= 0 && opts.tieBand < 1)) {\n      throw new Error(\"cross-chain router: tieBand must be a fraction in [0, 1)\");\n    }\n    const names = new Set<string>();\n    for (const provider of providers) {\n      if (typeof provider.name !== \"string\" || !/^[A-Za-z0-9_-]+$/.test(provider.name) || names.has(provider.name)) {\n        throw new Error(`cross-chain router: invalid or duplicate provider name '${String(provider.name)}'`);\n      }\n      names.add(provider.name);\n    }\n    // Snapshot the dispatch surface. A caller mutating provider.name or method\n    // properties after construction must not redirect quote→build/status.\n    this.providers = providers.map((provider) => ({\n      name: provider.name,\n      enabled: provider.enabled.bind(provider),\n      supportsRoute: provider.supportsRoute.bind(provider),\n      getQuote: provider.getQuote.bind(provider),\n      buildDeposit: provider.buildDeposit.bind(provider),\n      trackIntent: provider.trackIntent.bind(provider),\n      ...(provider.preflightDeposit ? {preflightDeposit: provider.preflightDeposit.bind(provider)} : {}),\n      ...(provider.notifyDeposit ? {notifyDeposit: provider.notifyDeposit.bind(provider)} : {}),\n      ...(provider.registerSignedOrder ? {registerSignedOrder: provider.registerSignedOrder.bind(provider)} : {}),\n      // Two-phase routes (CCTP): the destination claim. Missing here, the engine\n      // and the server both reported \"provider 'cctp' has no claim step\" (2026-10-13).\n      ...(provider.buildClaim ? {buildClaim: provider.buildClaim.bind(provider)} : {}),\n      ...(provider.close ? {close: provider.close.bind(provider)} : {}),\n      ...(provider.supportsChain ? {supportsChain: provider.supportsChain.bind(provider)} : {}),\n      ...(provider.supportsChainPair ? {supportsChainPair: provider.supportsChainPair.bind(provider)} : {}),\n      ...(provider.describeActivity ? {describeActivity: provider.describeActivity.bind(provider)} : {}),\n      ...(provider.supportsSameChain !== undefined ? {supportsSameChain: provider.supportsSameChain} : {}),\n    }));\n    this.weights = parseWeights(opts.weights);\n    this.valueUsd = opts.valueUsd;\n    this.tieBand = opts.tieBand ?? DEFAULT_TIE_BAND;\n    this.options = opts;\n  }\n\n  /** The same auction restricted to one provider — to execute the route a user picked. */\n  only(name: string): CrossChainRouter {\n    const provider = this.getProvider(name);\n    if (!provider) throw new Error(`cross-chain router: provider '${name}' is not registered`);\n    return new CrossChainRouter([provider], this.options);\n  }\n\n  /**\n   * Activity recognition across the installed providers: the first one that\n   * claims the transaction describes it. Null when none does (or none is held).\n   */\n  describeActivity(tx: ChainTx, ctx: DescribeActivityContext): ActivityItem | null {\n    for (const provider of this.providers) {\n      const item = provider.describeActivity?.(tx, ctx);\n      if (item) return item;\n    }\n    return null;\n  }\n\n  /** A provider by name. */\n  getProvider(name: string): CrossChainProvider | undefined {\n    return this.providers.find((p) => p.name === name);\n  }\n\n  /** True when a provider of that name is installed. */\n  hasProvider(name: string): boolean {\n    return this.providers.some((p) => p.name === name);\n  }\n\n  /** True when that provider is installed and enabled. */\n  hasEnabledProvider(name: string): boolean {\n    return this.providers.some((p) => {\n      try { return p.name === name && p.enabled(); } catch { return false; }\n    });\n  }\n\n  /** True when any enabled provider declares the chain. */\n  supportsChain(caip2: string): boolean {\n    return this.providers.some((p) => {\n      try { return p.enabled() && !!p.supportsChain?.(caip2); } catch { return false; }\n    });\n  }\n\n  /** True when any enabled provider declares the chain pair. */\n  supportsChainPair(fromChain: string, toChain: string): boolean {\n    return this.providers.some((p) => {\n      try {\n        return p.enabled() && (p.supportsChainPair?.(fromChain, toChain) ?? false);\n      } catch { return false; }\n    });\n  }\n\n  /**\n   * The auction's pick: the best price (net of native fees and gas when\n   * `valueUsd` is set; faster, then more reliable, among equal prices), or\n   * the fastest route with `prefer: \"fastest\"`.\n   */\n  async getBestQuote(\n    params: QuoteParams,\n    options?: {requireImmediateExecution?: boolean; prefer?: \"best\" | \"fastest\"},\n  ): Promise<RoutedQuote | null> {\n    const set = await this.getQuotes(params, options);\n    if (!set) return null;\n    const pick = options?.prefer === \"fastest\" ? set.fastest : set.best;\n    const {netValueUsd: _n, relativeValue: _r, tags: _t, ...quote} = pick;\n    return {\n      ...quote,\n      routeScore: {\n        score: pick.relativeValue,\n        weights: this.weights,\n        candidates: set.quotes.map((q) => ({\n          provider: q.provider,\n          sourceAmount: q.sourceAmount,\n          etaSeconds: q.etaSeconds,\n          score: q.relativeValue,\n          minDestAmount: q.minDestAmount,\n          netValueUsd: q.netValueUsd,\n        })),\n      },\n    };\n  }\n\n  /**\n   * Every validated route, ranked — for a route picker that shows the best and\n   * the fastest and lets the user choose. Providers run in parallel; with\n   * `onUpdate` each one that answers re-publishes the ranked set at once (the\n   * first price shows in the time of the fastest venue, not the slowest).\n   */\n  async getQuotes(\n    params: QuoteParams,\n    options?: {requireImmediateExecution?: boolean; onUpdate?: (set: RouteSet) => void},\n  ): Promise<RouteSet | null> {\n    // A public engine caller — or one provider running in the same auction —\n    // must not be able to rewrite another provider's request while async quote\n    // work is in flight. QuoteParams is intentionally flat, so a frozen copy is\n    // a complete execution snapshot.\n    const rejections: string[] = [];\n    this._lastRejections = rejections;\n    const snapshot = Object.freeze({...params});\n    const from = Object.freeze({chain: snapshot.sourceChain, token: snapshot.sourceToken});\n    const to = Object.freeze({chain: snapshot.destChain, token: snapshot.destToken});\n    // Only enabled (validated) providers that can serve the route participate.\n    let eligible = this.providers.filter((p) => {\n      try { return p.enabled() && p.supportsRoute(from, to); } catch { return false; }\n    });\n    if (snapshot.sourceChain === snapshot.destChain) {\n      eligible = eligible.filter((p) => p.supportsSameChain === true);\n    }\n    if (eligible.length === 0) return null;\n\n    // The short timeout protects the AUCTION — one slow venue must not hold\n    // the others hostage. With a single eligible provider (a pinned execution\n    // re-quote) there is nobody to protect, and a live deposit-creating quote\n    // legitimately takes longer than a dry one (serverless hop + upstream\n    // retries) — starving it surfaced as a terminal \"no route\" on execution.\n    const timeoutMs = eligible.length === 1 ? SOLO_QUOTE_TIMEOUT_MS : QUOTE_TIMEOUT_MS;\n    // Each venue names its own refusal (per call, so concurrent quotes cannot race).\n    const refusals: (string | undefined)[] = [];\n    const accepted: Quote[] = [];\n    const pending = new Set(eligible.map((p) => p.name));\n    const publish = () => {\n      if (!options?.onUpdate || accepted.length === 0) return;\n      const set = this.rank(accepted, snapshot, [...pending], rejections);\n      try { options.onUpdate(set); } catch { /* an observer must not break the auction */ }\n    };\n    await Promise.all(eligible.map(async (p, i) => {\n      const controller = new AbortController();\n      const own = Object.freeze({...snapshot, onRefusal: (reason: string) => {\n        refusals[i] ??= reason.startsWith(`${p.name}:`) ? reason : `${p.name}: ${reason}`;\n        try { snapshot.onRefusal?.(reason); } catch { /* diagnostics only */ }\n      }});\n      let q: Quote | null = null;\n      try {\n        q = await withTimeout(p.getQuote(own, controller.signal), timeoutMs);\n        if (!q) {\n          // A provider RETURNING null (vs throwing) was the one silent path\n          // left — record it so the surfaced no-route error names the venue.\n          rejections.push(refusals[i] ?? `${p.name}: returned no quote`);\n        } else if (!validQuote(q, snapshot, p.name)) {\n          const reason = `${p.name}: rejected by validation (minDest=${q.minDestAmount} vs floor=${snapshot.minAmountOut ?? \"-\"}, validUntil=${q.validUntilMs}, now=${Date.now()})`;\n          rejections.push(reason);\n          console.warn(`swap2-router: ${reason}`);\n          q = null;\n        } else if (options?.requireImmediateExecution && !(q.depositAddress.length > 0 || q.txRequest !== undefined)) {\n          // Legacy deposit-address screens cannot execute order-based quotes that\n          // require a separate build/sign/register lifecycle.\n          q = null;\n        }\n      } catch (err) {\n        // A failed venue sitting out silently is indistinguishable from \"no\n        // route\" — record why (surfaced through lastRejections) and say it in\n        // the console (same posture as onModuleSkipped).\n        const reason = `${p.name}: ${err instanceof Error ? err.message.slice(0, 160) : String(err).slice(0, 160)}`;\n        rejections.push(reason);\n        console.warn(`swap2-router: quote failed — ${reason}`);\n        q = null;\n      } finally {\n        controller.abort();\n      }\n      pending.delete(p.name);\n      // Provider identity is an execution security boundary. Never trust the\n      // provider field returned by an untrusted adapter; bind it to its slot.\n      if (q) accepted.push({...q, provider: p.name});\n      publish();\n    }));\n    if (accepted.length === 0) return null;\n    return this.rank(accepted, snapshot, [], rejections);\n  }\n\n  /** Status from the named provider; `failed` when it is not installed. */\n  async trackIntent(providerName: string, ref: IntentRef): Promise<IntentStatus> {\n    const provider = this.getProvider(providerName);\n    if (!provider) return {state: \"failed\"};\n    return provider.trackIntent(ref);\n  }\n\n  /** Forward a source-broadcast notification to the intent's provider. */\n  async notifyDeposit(providerName: string, intentId: string, txHash: string): Promise<void> {\n    await this.getProvider(providerName)?.notifyDeposit?.(intentId, txHash);\n  }\n\n  /** Release every provider's resources. */\n  close(): void {\n    for (const provider of this.providers) provider.close?.();\n  }\n\n  /**\n   * Price first: each quote's value is its net USD (`valueUsd`) — or, when any\n   * quote cannot be priced, its guaranteed output — against the best one.\n   * Quotes within `tieBand` of the best are the same price; among those the\n   * weights order speed and reliability. A $0.01 edge no longer beats a route\n   * that lands in seconds instead of twenty minutes, and a route that charges\n   * a native bridge fee on top no longer wins on its gross output.\n   */\n  private rank(quotes: Quote[], params: QuoteParams, pending: string[], rejections: string[]): RouteSet {\n    const usd = this.valueUsd ? quotes.map((q) => {\n      try {\n        const v = this.valueUsd!(q, params);\n        return typeof v === \"number\" && Number.isFinite(v) ? v : null;\n      } catch { return null; }\n    }) : quotes.map(() => null);\n    const priced = usd.every((v) => v !== null);\n    let relative: number[];\n    if (priced) {\n      const values = usd as number[];\n      const max = Math.max(...values);\n      relative = values.map((v) => (max > 0 ? Math.max(0, v) / max : v >= max ? 1 : 0));\n    } else {\n      const outs = quotes.map((q) => BigInt(q.minDestAmount));\n      const max = outs.reduce((a, b) => (b > a ? b : a));\n      relative = outs.map((o) => fraction(o, max));\n    }\n    const ranked: RankedQuote[] = quotes.map((q, i) => ({\n      ...q,\n      netValueUsd: priced ? usd[i]! : null,\n      relativeValue: relative[i]!,\n      tags: [],\n    }));\n\n    const tier = ranked.filter((q) => q.relativeValue >= 1 - this.tieBand - 1e-12);\n    const etas = tier.map((q) => q.etaSeconds);\n    const minEta = Math.min(...etas);\n    const maxEta = Math.max(...etas);\n    const w = this.weights;\n    const tieScore = (q: RankedQuote) =>\n      w.price * q.relativeValue +\n      w.speed * (maxEta === minEta ? 1 : (maxEta - q.etaSeconds) / (maxEta - minEta)) +\n      w.reliability * q.reliability;\n    const best = tier.reduce((a, b) => (tieScore(b) > tieScore(a) ? b : a));\n    const fastest = ranked.reduce((a, b) =>\n      b.etaSeconds < a.etaSeconds || (b.etaSeconds === a.etaSeconds && b.relativeValue > a.relativeValue) ? b : a);\n    best.tags.push(\"best\");\n    fastest.tags.push(\"fastest\");\n\n    // The list reads top-down by value; the pick leads its price tier.\n    ranked.sort((a, b) => (a === best ? -1 : b === best ? 1 : b.relativeValue - a.relativeValue || a.etaSeconds - b.etaSeconds));\n    return {quotes: ranked, best, fastest, pending, rejections: [...rejections]};\n  }\n}\n\n/** Ratio of two non-negative bigints as a 0..1 number. */\nfunction fraction(num: bigint, den: bigint): number {\n  if (den === 0n) return 1;\n  // scale to keep precision, then to float\n  return Number((num * 10_000n) / den) / 10_000;\n}\n"],"mappings":"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","names":[]}

package/dist/router.d.cts

@@ -0,0 +1,118 @@
+import { CrossChainProvider, Quote, QuoteParams, RoutedQuote, IntentRef, IntentStatus } from '@anywalletkit/protocol-swap2-core/types';
+import { ChainTx, DescribeActivityContext, ActivityItem } from '@anywalletkit/core';
+
+/**
+ * The auction engine of the optional aggregator: routes a cross-chain delivery
+ * over whichever providers the caller installed and passed in. Protocol
+ * modules never need it — each one runs standalone on @anywalletkit/protocol-swap2-core.
+ */
+
+interface RouterOptions {
+    /**
+     * "price:0.6,speed:0.3,reliability:0.1" — how quotes inside the tie band
+     * (same price, within `tieBand`) are ordered. Price itself always leads.
+     */
+    weights?: string;
+    /**
+     * What a quote is worth to the user in USD: its guaranteed output minus what
+     * the route charges on top (a native bridge fee, the source gas). Return null
+     * when it cannot be priced — the auction then compares guaranteed outputs.
+     * `usdValue(prices)` builds one from a symbol → USD price map.
+     */
+    valueUsd?: (quote: Quote, params: QuoteParams) => number | null;
+    /** Fraction of the best net value inside which quotes tie on price (default 0.002). */
+    tieBand?: number;
+}
+/** A validated quote with its place in the auction. */
+interface RankedQuote extends Quote {
+    /** Net USD value (`valueUsd`), or null when the auction compared raw outputs. */
+    netValueUsd: number | null;
+    /** This quote's value against the best one, 0..1 (1 = the best price). */
+    relativeValue: number;
+    /** "best": the pick (best price; faster/more reliable among equal prices). "fastest": the lowest ETA. */
+    tags: ("best" | "fastest")[];
+}
+/** Every validated route for one request, ranked by value. */
+interface RouteSet {
+    /** Every validated route, best first. */
+    quotes: RankedQuote[];
+    /** Most delivered value (net of fees when priced) within the tie band. */
+    best: RankedQuote;
+    /** Lowest ETA. */
+    fastest: RankedQuote;
+    /** Providers still quoting (only non-empty in progressive `onUpdate` snapshots). */
+    pending: string[];
+    /** Why the venues that sat out did (same as `lastRejections`). */
+    rejections: string[];
+}
+/**
+ * Routes a cross-chain delivery over pluggable providers: queries all that
+ * support the route in parallel (with a timeout so a slow provider can't block),
+ * normalizes their quotes, scores by configurable weights, and returns the best
+ * tagged with `routeScore`. A failed/slow provider simply doesn't participate.
+ */
+declare class CrossChainRouter {
+    private readonly providers;
+    /** Why the venues of the LAST getBestQuote call sat out — for error surfaces. */
+    private _lastRejections;
+    /** Why providers sat out the last auction, one line each. */
+    get lastRejections(): readonly string[];
+    private readonly weights;
+    private readonly valueUsd;
+    private readonly tieBand;
+    private readonly options;
+    constructor(providers: CrossChainProvider[], options?: string | RouterOptions);
+    /** The same auction restricted to one provider — to execute the route a user picked. */
+    only(name: string): CrossChainRouter;
+    /**
+     * Activity recognition across the installed providers: the first one that
+     * claims the transaction describes it. Null when none does (or none is held).
+     */
+    describeActivity(tx: ChainTx, ctx: DescribeActivityContext): ActivityItem | null;
+    /** A provider by name. */
+    getProvider(name: string): CrossChainProvider | undefined;
+    /** True when a provider of that name is installed. */
+    hasProvider(name: string): boolean;
+    /** True when that provider is installed and enabled. */
+    hasEnabledProvider(name: string): boolean;
+    /** True when any enabled provider declares the chain. */
+    supportsChain(caip2: string): boolean;
+    /** True when any enabled provider declares the chain pair. */
+    supportsChainPair(fromChain: string, toChain: string): boolean;
+    /**
+     * The auction's pick: the best price (net of native fees and gas when
+     * `valueUsd` is set; faster, then more reliable, among equal prices), or
+     * the fastest route with `prefer: "fastest"`.
+     */
+    getBestQuote(params: QuoteParams, options?: {
+        requireImmediateExecution?: boolean;
+        prefer?: "best" | "fastest";
+    }): Promise<RoutedQuote | null>;
+    /**
+     * Every validated route, ranked — for a route picker that shows the best and
+     * the fastest and lets the user choose. Providers run in parallel; with
+     * `onUpdate` each one that answers re-publishes the ranked set at once (the
+     * first price shows in the time of the fastest venue, not the slowest).
+     */
+    getQuotes(params: QuoteParams, options?: {
+        requireImmediateExecution?: boolean;
+        onUpdate?: (set: RouteSet) => void;
+    }): Promise<RouteSet | null>;
+    /** Status from the named provider; `failed` when it is not installed. */
+    trackIntent(providerName: string, ref: IntentRef): Promise<IntentStatus>;
+    /** Forward a source-broadcast notification to the intent's provider. */
+    notifyDeposit(providerName: string, intentId: string, txHash: string): Promise<void>;
+    /** Release every provider's resources. */
+    close(): void;
+    /**
+     * Price first: each quote's value is its net USD (`valueUsd`) — or, when any
+     * quote cannot be priced, its guaranteed output — against the best one.
+     * Quotes within `tieBand` of the best are the same price; among those the
+     * weights order speed and reliability. A $0.01 edge no longer beats a route
+     * that lands in seconds instead of twenty minutes, and a route that charges
+     * a native bridge fee on top no longer wins on its gross output.
+     */
+    private rank;
+}
+
+export { CrossChainRouter, type RankedQuote, type RouteSet, type RouterOptions };

package/dist/router.d.ts

@@ -0,0 +1,118 @@
+import { CrossChainProvider, Quote, QuoteParams, RoutedQuote, IntentRef, IntentStatus } from '@anywalletkit/protocol-swap2-core/types';
+import { ChainTx, DescribeActivityContext, ActivityItem } from '@anywalletkit/core';
+
+/**
+ * The auction engine of the optional aggregator: routes a cross-chain delivery
+ * over whichever providers the caller installed and passed in. Protocol
+ * modules never need it — each one runs standalone on @anywalletkit/protocol-swap2-core.
+ */
+
+interface RouterOptions {
+    /**
+     * "price:0.6,speed:0.3,reliability:0.1" — how quotes inside the tie band
+     * (same price, within `tieBand`) are ordered. Price itself always leads.
+     */
+    weights?: string;
+    /**
+     * What a quote is worth to the user in USD: its guaranteed output minus what
+     * the route charges on top (a native bridge fee, the source gas). Return null
+     * when it cannot be priced — the auction then compares guaranteed outputs.
+     * `usdValue(prices)` builds one from a symbol → USD price map.
+     */
+    valueUsd?: (quote: Quote, params: QuoteParams) => number | null;
+    /** Fraction of the best net value inside which quotes tie on price (default 0.002). */
+    tieBand?: number;
+}
+/** A validated quote with its place in the auction. */
+interface RankedQuote extends Quote {
+    /** Net USD value (`valueUsd`), or null when the auction compared raw outputs. */
+    netValueUsd: number | null;
+    /** This quote's value against the best one, 0..1 (1 = the best price). */
+    relativeValue: number;
+    /** "best": the pick (best price; faster/more reliable among equal prices). "fastest": the lowest ETA. */
+    tags: ("best" | "fastest")[];
+}
+/** Every validated route for one request, ranked by value. */
+interface RouteSet {
+    /** Every validated route, best first. */
+    quotes: RankedQuote[];
+    /** Most delivered value (net of fees when priced) within the tie band. */
+    best: RankedQuote;
+    /** Lowest ETA. */
+    fastest: RankedQuote;
+    /** Providers still quoting (only non-empty in progressive `onUpdate` snapshots). */
+    pending: string[];
+    /** Why the venues that sat out did (same as `lastRejections`). */
+    rejections: string[];
+}
+/**
+ * Routes a cross-chain delivery over pluggable providers: queries all that
+ * support the route in parallel (with a timeout so a slow provider can't block),
+ * normalizes their quotes, scores by configurable weights, and returns the best
+ * tagged with `routeScore`. A failed/slow provider simply doesn't participate.
+ */
+declare class CrossChainRouter {
+    private readonly providers;
+    /** Why the venues of the LAST getBestQuote call sat out — for error surfaces. */
+    private _lastRejections;
+    /** Why providers sat out the last auction, one line each. */
+    get lastRejections(): readonly string[];
+    private readonly weights;
+    private readonly valueUsd;
+    private readonly tieBand;
+    private readonly options;
+    constructor(providers: CrossChainProvider[], options?: string | RouterOptions);
+    /** The same auction restricted to one provider — to execute the route a user picked. */
+    only(name: string): CrossChainRouter;
+    /**
+     * Activity recognition across the installed providers: the first one that
+     * claims the transaction describes it. Null when none does (or none is held).
+     */
+    describeActivity(tx: ChainTx, ctx: DescribeActivityContext): ActivityItem | null;
+    /** A provider by name. */
+    getProvider(name: string): CrossChainProvider | undefined;
+    /** True when a provider of that name is installed. */
+    hasProvider(name: string): boolean;
+    /** True when that provider is installed and enabled. */
+    hasEnabledProvider(name: string): boolean;
+    /** True when any enabled provider declares the chain. */
+    supportsChain(caip2: string): boolean;
+    /** True when any enabled provider declares the chain pair. */
+    supportsChainPair(fromChain: string, toChain: string): boolean;
+    /**
+     * The auction's pick: the best price (net of native fees and gas when
+     * `valueUsd` is set; faster, then more reliable, among equal prices), or
+     * the fastest route with `prefer: "fastest"`.
+     */
+    getBestQuote(params: QuoteParams, options?: {
+        requireImmediateExecution?: boolean;
+        prefer?: "best" | "fastest";
+    }): Promise<RoutedQuote | null>;
+    /**
+     * Every validated route, ranked — for a route picker that shows the best and
+     * the fastest and lets the user choose. Providers run in parallel; with
+     * `onUpdate` each one that answers re-publishes the ranked set at once (the
+     * first price shows in the time of the fastest venue, not the slowest).
+     */
+    getQuotes(params: QuoteParams, options?: {
+        requireImmediateExecution?: boolean;
+        onUpdate?: (set: RouteSet) => void;
+    }): Promise<RouteSet | null>;
+    /** Status from the named provider; `failed` when it is not installed. */
+    trackIntent(providerName: string, ref: IntentRef): Promise<IntentStatus>;
+    /** Forward a source-broadcast notification to the intent's provider. */
+    notifyDeposit(providerName: string, intentId: string, txHash: string): Promise<void>;
+    /** Release every provider's resources. */
+    close(): void;
+    /**
+     * Price first: each quote's value is its net USD (`valueUsd`) — or, when any
+     * quote cannot be priced, its guaranteed output — against the best one.
+     * Quotes within `tieBand` of the best are the same price; among those the
+     * weights order speed and reliability. A $0.01 edge no longer beats a route
+     * that lands in seconds instead of twenty minutes, and a route that charges
+     * a native bridge fee on top no longer wins on its gross output.
+     */
+    private rank;
+}
+
+export { CrossChainRouter, type RankedQuote, type RouteSet, type RouterOptions };

package/dist/router.js

@@ -0,0 +1,7 @@
+import {
+  CrossChainRouter
+} from "./chunk-6WXEWTIF.js";
+export {
+  CrossChainRouter
+};
+//# sourceMappingURL=router.js.map

package/dist/router.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}