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

package/dist/swap2/router.js

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

package/dist/swap2/router.js.map

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

package/dist/value.cjs

@@ -0,0 +1,118 @@
+"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/value.ts
+var value_exports = {};
+__export(value_exports, {
+  quoteValues: () => quoteValues,
+  usdValue: () => usdValue
+});
+module.exports = __toCommonJS(value_exports);
+var import_core = require("@anywalletkit/core");
+var import_swap2_assets = require("@anywalletkit/swap2-assets");
+var PAR = /^(USDC|USDT|USDT0|USD₮0|DAI|USDC\.E)$/i;
+function priceOf(prices, symbol) {
+  const tries = [symbol, symbol.toUpperCase()];
+  if (/^w/i.test(symbol) && symbol.length > 2) tries.push(symbol.slice(1), symbol.slice(1).toUpperCase());
+  for (const t of tries) {
+    const p = prices[t];
+    if (typeof p === "number" && Number.isFinite(p) && p > 0) return p;
+  }
+  return PAR.test(symbol) ? 1 : null;
+}
+var units = (amount, decimals) => (0, import_core.bigintToUnits)(BigInt(amount), decimals);
+function usdValue(prices, options) {
+  return (quote, params) => {
+    const dest = (0, import_swap2_assets.ccAssetByToken)(params.destChain, params.destToken);
+    if (!dest) return null;
+    const destPrice = priceOf(prices, dest.symbol);
+    if (destPrice === null) return null;
+    let value = units(quote.minDestAmount, dest.decimals) * destPrice;
+    const nativeFee = quote.txRequest?.nativeFee;
+    if (nativeFee && BigInt(nativeFee) > 0n) {
+      const native = (0, import_swap2_assets.ccAssetByToken)(params.sourceChain, "");
+      const nativePrice = native ? priceOf(prices, native.symbol) : null;
+      if (!native || nativePrice === null) return null;
+      value -= units(nativeFee, native.decimals) * nativePrice;
+    }
+    if (options?.gasUsd) {
+      const gas = options.gasUsd(quote, params);
+      if (gas === null || !Number.isFinite(gas)) return null;
+      value -= gas;
+    }
+    return value;
+  };
+}
+function assetFor(chain, token) {
+  const byToken = (0, import_swap2_assets.ccAssetByToken)(chain, token);
+  if (byToken) return byToken;
+  const want = token.toLowerCase();
+  return (0, import_swap2_assets.ccChain)(chain)?.assets.find((a) => a.symbol.toLowerCase() === want);
+}
+function quoteValues(prices, params, quotes, options = {}) {
+  const betterBy = options.betterByPct ?? 2;
+  const src = assetFor(params.sourceChain, params.sourceToken);
+  const dest = assetFor(params.destChain, params.destToken);
+  const srcPrice = src ? priceOf(prices, src.symbol) : null;
+  const destPrice = dest ? priceOf(prices, dest.symbol) : null;
+  let valueUsdIn = null;
+  if (src && srcPrice !== null) {
+    try {
+      valueUsdIn = units(params.amountIn, src.decimals) * srcPrice;
+    } catch {
+      valueUsdIn = null;
+    }
+  }
+  const out = quotes.map((q) => {
+    let valueUsdOut = null;
+    if (dest && destPrice !== null) {
+      try {
+        valueUsdOut = units(q.destAmount, dest.decimals) * destPrice;
+        const nativeFee = q.txRequest?.nativeFee;
+        if (nativeFee && BigInt(nativeFee) > 0n) {
+          const native = (0, import_swap2_assets.ccAssetByToken)(params.sourceChain, "");
+          const nativePrice = native ? priceOf(prices, native.symbol) : null;
+          if (native && nativePrice !== null) valueUsdOut -= units(nativeFee, native.decimals) * nativePrice;
+        }
+      } catch {
+        valueUsdOut = null;
+      }
+    }
+    const lossPct = valueUsdIn !== null && valueUsdIn > 0 && valueUsdOut !== null ? (valueUsdIn - valueUsdOut) / valueUsdIn * 100 : null;
+    const impact = q.providerData?.priceImpactBps;
+    const priceImpactBps = typeof impact === "string" && /^\d+$/.test(impact) ? Number(impact) : void 0;
+    const v = { provider: q.provider, valueUsdIn, valueUsdOut, lossPct };
+    if (priceImpactBps !== void 0) v.priceImpactBps = priceImpactBps;
+    return v;
+  });
+  const allPriced = out.length > 1 && out.every((v) => v.valueUsdOut !== null);
+  if (out.length > 1) {
+    const measure = (v) => allPriced ? v.valueUsdOut : (0, import_core.bigintToNumber)(BigInt(quotes.find((q) => q.provider === v.provider).destAmount));
+    const top = out.reduce((a, b) => measure(b) > measure(a) ? b : a);
+    const topQuote = quotes.find((q) => q.provider === top.provider);
+    for (const v of out) {
+      if (v === top) continue;
+      const mine = measure(v);
+      const byPct = mine > 0 ? (measure(top) - mine) / mine * 100 : Infinity;
+      if (byPct > betterBy) v.betterAlternative = { provider: top.provider, valueUsdOut: top.valueUsdOut, destAmount: topQuote.destAmount, byPct };
+    }
+  }
+  return out;
+}
+//# sourceMappingURL=value.cjs.map

package/dist/value.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/value.ts"],"sourcesContent":["import {bigintToNumber, bigintToUnits} from \"@anywalletkit/core\";\nimport {ccAssetByToken, ccChain} from \"@anywalletkit/swap2-assets\";\nimport type {Quote, QuoteParams} from \"@anywalletkit/protocol-swap2-core/types\";\n\n/** Stables priced at par when the map has no entry for them. */\nconst PAR = /^(USDC|USDT|USDT0|USD₮0|DAI|USDC\\.E)$/i;\n\n/** symbol → USD, trying the exact symbol, upper case, the unwrapped native (WETH → ETH, wS → S), then par for stables. */\nfunction priceOf(prices: Readonly<Record<string, number>>, symbol: string): number | null {\n  const tries = [symbol, symbol.toUpperCase()];\n  if (/^w/i.test(symbol) && symbol.length > 2) tries.push(symbol.slice(1), symbol.slice(1).toUpperCase());\n  for (const t of tries) {\n    const p = prices[t];\n    if (typeof p === \"number\" && Number.isFinite(p) && p > 0) return p;\n  }\n  return PAR.test(symbol) ? 1 : null;\n}\n\nconst units = (amount: string | bigint, decimals: number) => bigintToUnits(BigInt(amount), decimals);\n\n/**\n * A `valueUsd` for the router: the guaranteed output in USD, minus the native\n * fee the route charges on top of the input (bridge messaging fees), minus\n * the source gas when `gasUsd` can say it. null when a needed price is missing\n * — the auction then falls back to comparing guaranteed outputs.\n */\nexport function usdValue(\n  prices: Readonly<Record<string, number>>,\n  options?: {gasUsd?: (quote: Quote, params: QuoteParams) => number | null},\n): (quote: Quote, params: QuoteParams) => number | null {\n  return (quote, params) => {\n    const dest = ccAssetByToken(params.destChain, params.destToken);\n    if (!dest) return null;\n    const destPrice = priceOf(prices, dest.symbol);\n    if (destPrice === null) return null;\n    let value = units(quote.minDestAmount, dest.decimals) * destPrice;\n    const nativeFee = quote.txRequest?.nativeFee;\n    if (nativeFee && BigInt(nativeFee) > 0n) {\n      const native = ccAssetByToken(params.sourceChain, \"\");\n      const nativePrice = native ? priceOf(prices, native.symbol) : null;\n      if (!native || nativePrice === null) return null;\n      value -= units(nativeFee, native.decimals) * nativePrice;\n    }\n    if (options?.gasUsd) {\n      const gas = options.gasUsd(quote, params);\n      if (gas === null || !Number.isFinite(gas)) return null;\n      value -= gas;\n    }\n    return value;\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Value information for the user (SDK-127): never a refusal, always a fact.\n// ---------------------------------------------------------------------------\n\n/**\n * A quote's value in USD: what the user pays, what arrives, the loss, and a better alternative when\n * one exists. Use it to warn before a bad-value swap.\n */\nexport interface QuoteValue {\n  provider: string;\n  /** USD the user pays: the source amount at the current price. null when unpriced. */\n  valueUsdIn: number | null;\n  /** USD the quote delivers: the expected `destAmount` at the current price, minus a native fee paid on top. null when unpriced. */\n  valueUsdOut: number | null;\n  /** (in − out) / in × 100. Positive = the user receives less value than they pay. null when either side is unpriced. */\n  lossPct: number | null;\n  /** Another provider in the same set that delivers more than `betterByPct` more. Every quote of a request pays out the\n   *  same destination token, so the comparison is by delivered USD when priced and by raw `destAmount` otherwise. */\n  betterAlternative?: {provider: string; valueUsdOut: number | null; destAmount: string; byPct: number};\n  /** The venue's own price impact in basis points (`providerData.priceImpactBps`), when it measures one. */\n  priceImpactBps?: number;\n}\n\n/** Options for quote valuation. */\nexport interface QuoteValueOptions {\n  /** How much more (percent of this quote's value) another provider must deliver to be named as the better alternative. Default 2. */\n  betterByPct?: number;\n}\n\ntype ValueParams = Pick<QuoteParams, \"sourceChain\" | \"sourceToken\" | \"destChain\" | \"destToken\" | \"amountIn\">;\ntype ValueQuote = Pick<Quote, \"provider\" | \"destAmount\"> & Partial<Pick<Quote, \"txRequest\" | \"providerData\">>;\n\n/** The catalog asset for a token given as a contract / asset id (the wire form) or as a symbol (what apps pass for the source). */\nfunction assetFor(chain: string, token: string) {\n  const byToken = ccAssetByToken(chain, token);\n  if (byToken) return byToken;\n  const want = token.toLowerCase();\n  return ccChain(chain)?.assets.find((a) => a.symbol.toLowerCase() === want);\n}\n\n/**\n * USD in / out / loss for every quote of one request, and the better\n * alternative inside the set. Prices are the caller's current spot prices\n * (symbol → USD). The owner's rule (2026-10-16): the wallet shows this and\n * says \"be careful\"; it never blocks — the Oct 16 funded run lost ~$33 on\n * two Uniswap legs that nothing compared to the other venues' quotes.\n */\nexport function quoteValues(prices: Readonly<Record<string, number>>, params: ValueParams, quotes: readonly ValueQuote[], options: QuoteValueOptions = {}): QuoteValue[] {\n  const betterBy = options.betterByPct ?? 2;\n  const src = assetFor(params.sourceChain, params.sourceToken);\n  const dest = assetFor(params.destChain, params.destToken);\n  const srcPrice = src ? priceOf(prices, src.symbol) : null;\n  const destPrice = dest ? priceOf(prices, dest.symbol) : null;\n  let valueUsdIn: number | null = null;\n  if (src && srcPrice !== null) {\n    try {\n      valueUsdIn = units(params.amountIn, src.decimals) * srcPrice;\n    } catch {\n      valueUsdIn = null;\n    }\n  }\n  const out: QuoteValue[] = quotes.map((q) => {\n    let valueUsdOut: number | null = null;\n    if (dest && destPrice !== null) {\n      try {\n        valueUsdOut = units(q.destAmount, dest.decimals) * destPrice;\n        const nativeFee = q.txRequest?.nativeFee;\n        if (nativeFee && BigInt(nativeFee) > 0n) {\n          const native = ccAssetByToken(params.sourceChain, \"\");\n          const nativePrice = native ? priceOf(prices, native.symbol) : null;\n          if (native && nativePrice !== null) valueUsdOut -= units(nativeFee, native.decimals) * nativePrice;\n        }\n      } catch {\n        valueUsdOut = null;\n      }\n    }\n    const lossPct = valueUsdIn !== null && valueUsdIn > 0 && valueUsdOut !== null ? ((valueUsdIn - valueUsdOut) / valueUsdIn) * 100 : null;\n    const impact = q.providerData?.priceImpactBps;\n    const priceImpactBps = typeof impact === \"string\" && /^\\d+$/.test(impact) ? Number(impact) : undefined;\n    const v: QuoteValue = {provider: q.provider, valueUsdIn, valueUsdOut, lossPct};\n    if (priceImpactBps !== undefined) v.priceImpactBps = priceImpactBps;\n    return v;\n  });\n  // The best delivery in the set names itself as the alternative for every quote it beats by more than betterBy %.\n  // Priced: by delivered USD (native fees netted). Unpriced: by raw destAmount — same token for every quote, so the ratio is exact.\n  const allPriced = out.length > 1 && out.every((v) => v.valueUsdOut !== null);\n  if (out.length > 1) {\n    const measure = (v: QuoteValue): number => (allPriced ? v.valueUsdOut! : bigintToNumber(BigInt(quotes.find((q) => q.provider === v.provider)!.destAmount)));\n    const top = out.reduce((a, b) => (measure(b) > measure(a) ? b : a));\n    const topQuote = quotes.find((q) => q.provider === top.provider)!;\n    for (const v of out) {\n      if (v === top) continue;\n      const mine = measure(v);\n      const byPct = mine > 0 ? ((measure(top) - mine) / mine) * 100 : Infinity;\n      if (byPct > betterBy) v.betterAlternative = {provider: top.provider, valueUsdOut: top.valueUsdOut, destAmount: topQuote.destAmount, byPct};\n    }\n  }\n  return out;\n}\n"],"mappings":"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","names":[]}

package/dist/value.d.cts

@@ -0,0 +1,51 @@
+import { QuoteParams, Quote } from '@anywalletkit/protocol-swap2-core/types';
+
+/**
+ * A `valueUsd` for the router: the guaranteed output in USD, minus the native
+ * fee the route charges on top of the input (bridge messaging fees), minus
+ * the source gas when `gasUsd` can say it. null when a needed price is missing
+ * — the auction then falls back to comparing guaranteed outputs.
+ */
+declare function usdValue(prices: Readonly<Record<string, number>>, options?: {
+    gasUsd?: (quote: Quote, params: QuoteParams) => number | null;
+}): (quote: Quote, params: QuoteParams) => number | null;
+/**
+ * A quote's value in USD: what the user pays, what arrives, the loss, and a better alternative when
+ * one exists. Use it to warn before a bad-value swap.
+ */
+interface QuoteValue {
+    provider: string;
+    /** USD the user pays: the source amount at the current price. null when unpriced. */
+    valueUsdIn: number | null;
+    /** USD the quote delivers: the expected `destAmount` at the current price, minus a native fee paid on top. null when unpriced. */
+    valueUsdOut: number | null;
+    /** (in − out) / in × 100. Positive = the user receives less value than they pay. null when either side is unpriced. */
+    lossPct: number | null;
+    /** Another provider in the same set that delivers more than `betterByPct` more. Every quote of a request pays out the
+     *  same destination token, so the comparison is by delivered USD when priced and by raw `destAmount` otherwise. */
+    betterAlternative?: {
+        provider: string;
+        valueUsdOut: number | null;
+        destAmount: string;
+        byPct: number;
+    };
+    /** The venue's own price impact in basis points (`providerData.priceImpactBps`), when it measures one. */
+    priceImpactBps?: number;
+}
+/** Options for quote valuation. */
+interface QuoteValueOptions {
+    /** How much more (percent of this quote's value) another provider must deliver to be named as the better alternative. Default 2. */
+    betterByPct?: number;
+}
+type ValueParams = Pick<QuoteParams, "sourceChain" | "sourceToken" | "destChain" | "destToken" | "amountIn">;
+type ValueQuote = Pick<Quote, "provider" | "destAmount"> & Partial<Pick<Quote, "txRequest" | "providerData">>;
+/**
+ * USD in / out / loss for every quote of one request, and the better
+ * alternative inside the set. Prices are the caller's current spot prices
+ * (symbol → USD). The owner's rule (2026-10-16): the wallet shows this and
+ * says "be careful"; it never blocks — the Oct 16 funded run lost ~$33 on
+ * two Uniswap legs that nothing compared to the other venues' quotes.
+ */
+declare function quoteValues(prices: Readonly<Record<string, number>>, params: ValueParams, quotes: readonly ValueQuote[], options?: QuoteValueOptions): QuoteValue[];
+
+export { type QuoteValue, type QuoteValueOptions, quoteValues, usdValue };

package/dist/value.d.ts

@@ -0,0 +1,51 @@
+import { QuoteParams, Quote } from '@anywalletkit/protocol-swap2-core/types';
+
+/**
+ * A `valueUsd` for the router: the guaranteed output in USD, minus the native
+ * fee the route charges on top of the input (bridge messaging fees), minus
+ * the source gas when `gasUsd` can say it. null when a needed price is missing
+ * — the auction then falls back to comparing guaranteed outputs.
+ */
+declare function usdValue(prices: Readonly<Record<string, number>>, options?: {
+    gasUsd?: (quote: Quote, params: QuoteParams) => number | null;
+}): (quote: Quote, params: QuoteParams) => number | null;
+/**
+ * A quote's value in USD: what the user pays, what arrives, the loss, and a better alternative when
+ * one exists. Use it to warn before a bad-value swap.
+ */
+interface QuoteValue {
+    provider: string;
+    /** USD the user pays: the source amount at the current price. null when unpriced. */
+    valueUsdIn: number | null;
+    /** USD the quote delivers: the expected `destAmount` at the current price, minus a native fee paid on top. null when unpriced. */
+    valueUsdOut: number | null;
+    /** (in − out) / in × 100. Positive = the user receives less value than they pay. null when either side is unpriced. */
+    lossPct: number | null;
+    /** Another provider in the same set that delivers more than `betterByPct` more. Every quote of a request pays out the
+     *  same destination token, so the comparison is by delivered USD when priced and by raw `destAmount` otherwise. */
+    betterAlternative?: {
+        provider: string;
+        valueUsdOut: number | null;
+        destAmount: string;
+        byPct: number;
+    };
+    /** The venue's own price impact in basis points (`providerData.priceImpactBps`), when it measures one. */
+    priceImpactBps?: number;
+}
+/** Options for quote valuation. */
+interface QuoteValueOptions {
+    /** How much more (percent of this quote's value) another provider must deliver to be named as the better alternative. Default 2. */
+    betterByPct?: number;
+}
+type ValueParams = Pick<QuoteParams, "sourceChain" | "sourceToken" | "destChain" | "destToken" | "amountIn">;
+type ValueQuote = Pick<Quote, "provider" | "destAmount"> & Partial<Pick<Quote, "txRequest" | "providerData">>;
+/**
+ * USD in / out / loss for every quote of one request, and the better
+ * alternative inside the set. Prices are the caller's current spot prices
+ * (symbol → USD). The owner's rule (2026-10-16): the wallet shows this and
+ * says "be careful"; it never blocks — the Oct 16 funded run lost ~$33 on
+ * two Uniswap legs that nothing compared to the other venues' quotes.
+ */
+declare function quoteValues(prices: Readonly<Record<string, number>>, params: ValueParams, quotes: readonly ValueQuote[], options?: QuoteValueOptions): QuoteValue[];
+
+export { type QuoteValue, type QuoteValueOptions, quoteValues, usdValue };

package/dist/value.js

@@ -0,0 +1,9 @@
+import {
+  quoteValues,
+  usdValue
+} from "./chunk-ATQMEXTG.js";
+export {
+  quoteValues,
+  usdValue
+};
+//# sourceMappingURL=value.js.map

package/dist/value.js.map

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

package/module.json

@@ -0,0 +1,20 @@
+{
+  "name": "@anywalletkit/protocol-swap2-router",
+  "type": "swap2",
+  "chains": [
+    "eip155:*",
+    "solana:*",
+    "ton:-239",
+    "tron:0x2b6653dc",
+    "bip122:000000000019d6689c085ae165831e93"
+  ],
+  "tier": "core",
+  "maintainers": [
+    "@ultratestbro"
+  ],
+  "conformance": "0.x",
+  "repo": "https://github.com/ultratestbro/anywalletkit",
+  "path": "packages/protocol-swap2-router",
+  "description": "Optional aggregator: auctions the swap2 providers you install and pass in, executes the winner. Chains = union of our provider modules.",
+  "addedAt": "2026-10-04"
+}

package/package.json

@@ -1,6 +1,72 @@
 {
   "name": "@anywalletkit/protocol-swap2-router",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.2",
+  "description": "Optional swap2 aggregator for Any Wallet Kit: auctions whichever swap2 providers you install and pass in.",
+  "license": "Apache-2.0",
+  "homepage": "https://docs.anywallet.tech",
+  "bugs": {
+    "url": "https://github.com/ultratestbro/anywalletkit/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ultratestbro/anywalletkit.git",
+    "directory": "packages/protocol-swap2-router"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./router": {
+      "types": "./dist/router.d.ts",
+      "import": "./dist/router.js",
+      "require": "./dist/router.cjs"
+    },
+    "./value": {
+      "types": "./dist/value.d.ts",
+      "import": "./dist/value.js",
+      "require": "./dist/value.cjs"
+    },
+    "./swap2/router": {
+      "types": "./dist/swap2/router.d.ts",
+      "import": "./dist/swap2/router.js",
+      "require": "./dist/swap2/router.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "module.json"
+  ],
+  "dependencies": {
+    "@anywalletkit/protocol-swap2-core": "0.3.1",
+    "@anywalletkit/swap2-assets": "0.1.3"
+  },
+  "peerDependencies": {
+    "@anywalletkit/core": "0.3.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22",
+    "vitest": "^5.0.3",
+    "@anywalletkit/core": "0.3.1",
+    "@anywalletkit/conformance": "0.3.1"
+  },
+  "keywords": [],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "lint": "echo ok"
+  }
 }