@agentcash/router 1.7.0 → 1.7.1

package/dist/index.js

@@ -242,12 +242,139 @@ var init_facilitators = __esm({
   }
 });
 
+// src/kv-store/facilitator-supported.ts
+function withCachedSupported(inner, options = {}) {
+  const { kv, cacheKey, ttlSeconds = FACILITATOR_SUPPORTED_TTL_SECONDS, fallback } = options;
+  const kvKey = kv && cacheKey ? `${FACILITATOR_SUPPORTED_KV_PREFIX}${cacheKey}` : void 0;
+  let inflight;
+  return {
+    verify: inner.verify.bind(inner),
+    settle: inner.settle.bind(inner),
+    getSupported: () => {
+      if (inflight) return inflight;
+      const attempt = fetchSupported(inner, kv, kvKey, ttlSeconds, fallback);
+      inflight = attempt;
+      attempt.catch(() => {
+        if (inflight === attempt) inflight = void 0;
+      });
+      return attempt;
+    }
+  };
+}
+async function fetchSupported(inner, kv, kvKey, ttlSeconds, fallback) {
+  if (kv && kvKey) {
+    const cached = await readKvCache(kv, kvKey);
+    if (cached) return cached;
+  }
+  const fresh = await tryFetchLive(inner, fallback);
+  if (fresh === null) return fallback();
+  if (kv && kvKey) await writeKvCache(kv, kvKey, fresh, ttlSeconds);
+  return fresh;
+}
+async function tryFetchLive(inner, fallback) {
+  try {
+    return await inner.getSupported();
+  } catch (err) {
+    if (!fallback) throw err;
+    console.warn(
+      `[x402] facilitator /supported failed, using hardcoded baseline: ${err instanceof Error ? err.message : String(err)}`
+    );
+    return null;
+  }
+}
+async function readKvCache(kv, key) {
+  try {
+    const cached = await kv.get(key);
+    return isSupportedResponse(cached) ? cached : void 0;
+  } catch {
+    return void 0;
+  }
+}
+async function writeKvCache(kv, key, value, ttlSeconds) {
+  try {
+    await kv.setNxEx(key, value, ttlSeconds);
+  } catch {
+  }
+}
+function isSupportedResponse(value) {
+  return typeof value === "object" && value !== null && Array.isArray(value.kinds);
+}
+var FACILITATOR_SUPPORTED_TTL_SECONDS, FACILITATOR_SUPPORTED_KV_PREFIX;
+var init_facilitator_supported = __esm({
+  "src/kv-store/facilitator-supported.ts"() {
+    "use strict";
+    FACILITATOR_SUPPORTED_TTL_SECONDS = 60 * 60;
+    FACILITATOR_SUPPORTED_KV_PREFIX = "x402:facilitator-supported:";
+  }
+});
+
+// src/protocols/x402/facilitator-clients.ts
+function createFacilitatorClients(facilitatorsByNetwork, HTTPFacilitatorClient, kvStore) {
+  return getResolvedX402FacilitatorGroups(facilitatorsByNetwork).map((group) => {
+    const inner = new HTTPFacilitatorClient(group.config);
+    const kinds = buildSupportedKinds(group);
+    const baseline = () => ({
+      kinds,
+      extensions: [],
+      signers: {}
+    });
+    if (group.family === "solana") {
+      return hardcodedSupportedClient(inner, baseline);
+    }
+    const cached = withCachedSupported(inner, {
+      kv: kvStore,
+      cacheKey: group.config.url,
+      fallback: baseline
+    });
+    return withScopedKinds(cached, kinds);
+  });
+}
+function hardcodedSupportedClient(inner, build) {
+  return {
+    verify: inner.verify.bind(inner),
+    settle: inner.settle.bind(inner),
+    getSupported: async () => build()
+  };
+}
+function withScopedKinds(client, kinds) {
+  return {
+    verify: client.verify.bind(client),
+    settle: client.settle.bind(client),
+    getSupported: async () => ({ ...await client.getSupported(), kinds })
+  };
+}
+function buildSupportedKinds(group) {
+  return group.networks.flatMap((network) => {
+    if (group.family === "solana") {
+      return [
+        {
+          x402Version: 2,
+          scheme: "exact",
+          network,
+          extra: { features: { xSettlementAccountSupported: true } }
+        }
+      ];
+    }
+    return [
+      { x402Version: 2, scheme: "exact", network },
+      { x402Version: 2, scheme: "upto", network }
+    ];
+  });
+}
+var init_facilitator_clients = __esm({
+  "src/protocols/x402/facilitator-clients.ts"() {
+    "use strict";
+    init_facilitator_supported();
+    init_facilitators();
+  }
+});
+
 // src/init/x402-server.ts
 var x402_server_exports = {};
 __export(x402_server_exports, {
   createX402Server: () => createX402Server
 });
-async function createX402Server(config) {
+async function createX402Server(config, kvStore) {
   const { x402ResourceServer, HTTPFacilitatorClient } = await import("@x402/core/server");
   const { registerExactEvmScheme } = await import("@x402/evm/exact/server");
   const { bazaarResourceServerExtension } = await import("@x402/extensions/bazaar");
@@ -261,7 +388,11 @@ async function createX402Server(config) {
   );
   const evmNetworks = filterEvmNetworks(configuredNetworks);
   const svmNetworks = filterSolanaNetworks(configuredNetworks);
-  const facilitatorClients = createFacilitatorClients(facilitatorsByNetwork, HTTPFacilitatorClient);
+  const facilitatorClients = createFacilitatorClients(
+    facilitatorsByNetwork,
+    HTTPFacilitatorClient,
+    kvStore
+  );
   const server = new x402ResourceServer(
     facilitatorClients.length === 1 ? facilitatorClients[0] : facilitatorClients
   );
@@ -285,48 +416,13 @@ async function createX402Server(config) {
     facilitatorsByNetwork
   };
 }
-function createFacilitatorClients(facilitatorsByNetwork, HTTPFacilitatorClient) {
-  const groups = getResolvedX402FacilitatorGroups(facilitatorsByNetwork);
-  return groups.map((group) => {
-    const inner = new HTTPFacilitatorClient(group.config);
-    const kinds = buildSupportedKinds(group);
-    return hardcodedSupportedClient(inner, kinds);
-  });
-}
-function hardcodedSupportedClient(inner, kinds) {
-  return {
-    verify: inner.verify.bind(inner),
-    settle: inner.settle.bind(inner),
-    getSupported: async () => ({ kinds, extensions: [], signers: {} })
-  };
-}
-function buildSupportedKinds(group) {
-  return group.networks.flatMap((network) => {
-    const exactKind = {
-      x402Version: 2,
-      scheme: "exact",
-      network,
-      ...group.family === "solana" ? {
-        extra: {
-          features: {
-            xSettlementAccountSupported: true
-          }
-        }
-      } : {}
-    };
-    const uptoKind = { x402Version: 2, scheme: "upto", network };
-    if (group.family === "evm") {
-      return [exactKind, uptoKind];
-    }
-    return [exactKind, uptoKind];
-  });
-}
 var init_x402_server = __esm({
   "src/init/x402-server.ts"() {
     "use strict";
     init_evm();
     init_solana();
     init_facilitators();
+    init_facilitator_clients();
     init_accepts();
   }
 });
@@ -1028,6 +1124,61 @@ async function runApiKeyOnlyFlow(ctx) {
   return runHandlerOnly(ctx, null, result.account);
 }
 
+// src/pricing/format.ts
+var USDC_DECIMALS = 6;
+var DECIMAL_RE = /^(\d+)(?:\.(\d+))?$/;
+function badDecimal(amount) {
+  return Object.assign(new Error(`'${amount}' is not a valid decimal-dollar string`), {
+    status: 400
+  });
+}
+function decimalToAtomic(amount, decimals = USDC_DECIMALS) {
+  const match = DECIMAL_RE.exec(amount.trim());
+  if (!match) throw badDecimal(amount);
+  const whole = match[1];
+  const fraction = match[2] ?? "";
+  if (fraction.length > decimals) {
+    throw Object.assign(new Error(`Amount '${amount}' exceeds ${decimals} decimal places`), {
+      status: 400
+    });
+  }
+  const normalized = `${whole}${fraction.padEnd(decimals, "0")}`.replace(/^0+(?=\d)/, "");
+  return BigInt(normalized || "0");
+}
+function atomicToDecimal(atomic, decimals = USDC_DECIMALS) {
+  const divisor = 10n ** BigInt(decimals);
+  const whole = atomic / divisor;
+  const fraction = atomic % divisor;
+  if (fraction === 0n) return whole.toString();
+  const fractionStr = fraction.toString().padStart(decimals, "0").replace(/0+$/, "");
+  return `${whole}.${fractionStr}`;
+}
+function compareDecimals(a, b) {
+  const av = decimalToAtomic(a);
+  const bv = decimalToAtomic(b);
+  if (av < bv) return -1;
+  if (av > bv) return 1;
+  return 0;
+}
+function isPositiveDecimal(value) {
+  try {
+    return decimalToAtomic(value) > 0n;
+  } catch {
+    return false;
+  }
+}
+function multiplyDecimal(decimal, factor) {
+  if (!Number.isFinite(factor) || factor <= 0) return decimal;
+  const [whole, fraction = ""] = decimal.split(".");
+  const scaled = (BigInt(whole + fraction) * BigInt(factor)).toString();
+  const decimals = fraction.length;
+  if (decimals === 0) return scaled;
+  const padded = scaled.padStart(decimals + 1, "0");
+  const intPart = padded.slice(0, padded.length - decimals);
+  const fracPart = padded.slice(padded.length - decimals).replace(/0+$/, "");
+  return fracPart ? `${intPart}.${fracPart}` : intPart;
+}
+
 // src/pricing/dynamic.ts
 var DynamicPricing = class {
   constructor(opts) {
@@ -1063,9 +1214,13 @@ var DynamicPricing = class {
   }
   cap(raw, body) {
     if (!this.opts.maxPrice) return raw;
-    const n = parseFloat(raw);
-    const max = parseFloat(this.opts.maxPrice);
-    if (!Number.isFinite(n) || n > max) {
+    let overCap;
+    try {
+      overCap = compareDecimals(raw, this.opts.maxPrice) > 0;
+    } catch {
+      overCap = true;
+    }
+    if (overCap) {
       this.alert("warn", `Price ${raw} exceeds maxPrice ${this.opts.maxPrice}, capping`, {
         calculated: raw,
         maxPrice: this.opts.maxPrice,
@@ -1142,7 +1297,7 @@ var TieredPricing = class {
   maxTierPrice() {
     let max = "0";
     for (const tier of Object.values(this.opts.tiers)) {
-      if (parseFloat(tier.price) > parseFloat(max)) max = tier.price;
+      if (compareDecimals(tier.price, max) > 0) max = tier.price;
     }
     return max;
   }
@@ -1620,17 +1775,6 @@ var mppStrategy = {
     return buildChargeChallenge(args);
   }
 };
-function multiplyDecimal(decimal, factor) {
-  if (!Number.isFinite(factor) || factor <= 0) return decimal;
-  const [whole, fraction = ""] = decimal.split(".");
-  const scaled = (BigInt(whole + fraction) * BigInt(factor)).toString();
-  const decimals = fraction.length;
-  if (decimals === 0) return scaled;
-  const padded = scaled.padStart(decimals + 1, "0");
-  const intPart = padded.slice(0, padded.length - decimals);
-  const fracPart = padded.slice(padded.length - decimals).replace(/0+$/, "");
-  return fracPart ? `${intPart}.${fracPart}` : intPart;
-}
 async function buildChargeChallenge(args) {
   if (!args.deps.mppx) return {};
   try {
@@ -1723,26 +1867,13 @@ function buildCustomRequirement(price, accept) {
   return {
     scheme: accept.scheme,
     network: accept.network,
-    amount: decimalToAtomicUnits(price, accept.decimals ?? 6),
+    amount: decimalToAtomic(price, accept.decimals ?? 6).toString(),
     asset: accept.asset,
     payTo: accept.payTo,
     maxTimeoutSeconds: accept.maxTimeoutSeconds ?? 300,
     extra: accept.extra ?? {}
   };
 }
-function decimalToAtomicUnits(amount, decimals) {
-  const match = /^(?<whole>\d+)(?:\.(?<fraction>\d+))?$/.exec(amount);
-  if (!match?.groups) {
-    throw new Error(`Invalid decimal amount '${amount}'`);
-  }
-  const whole = match.groups.whole;
-  const fraction = match.groups.fraction ?? "";
-  if (fraction.length > decimals) {
-    throw new Error(`Amount '${amount}' exceeds ${decimals} decimal places`);
-  }
-  const normalized = `${whole}${fraction.padEnd(decimals, "0")}`.replace(/^0+(?=\d)/, "");
-  return normalized === "" ? "0" : normalized;
-}
 
 // src/protocols/x402/challenge.ts
 async function buildX402Challenge(opts) {
@@ -2105,13 +2236,14 @@ async function buildX402ChallengeContribution(args) {
 }
 function reportSettleFailure(report, err, network) {
   const facilitator = err ?? {};
-  report("error", "Settlement failed", {
+  const meta = {
     error: err instanceof Error ? err.message : String(err),
     network,
     errorReason: facilitator.errorReason,
     facilitatorStatus: facilitator.response?.status,
     facilitatorBody: facilitator.response?.data ?? facilitator.response?.body
-  });
+  };
+  report("error", "Settlement failed", meta);
 }
 
 // src/protocols/index.ts
@@ -2134,6 +2266,7 @@ function getAllowedStrategies(allowed) {
 import { NextResponse as NextResponse4 } from "next/server";
 
 // src/pipeline/challenge-extensions.ts
+init_evm();
 async function buildChallengeExtensions(ctx) {
   const { routeEntry } = ctx;
   let extensions;
@@ -2178,6 +2311,23 @@ async function buildChallengeExtensions(ctx) {
     } catch {
     }
   }
+  const hasEvmUpto = ctx.deps.x402Accepts.some(
+    (accept) => accept.scheme === "upto" && isEvmNetwork(accept.network)
+  );
+  if (hasEvmUpto) {
+    try {
+      const { declareEip2612GasSponsoringExtension } = await import("@x402/extensions");
+      extensions = {
+        ...extensions ?? {},
+        ...declareEip2612GasSponsoringExtension()
+      };
+    } catch (err) {
+      ctx.report(
+        "warn",
+        `EIP-2612 gas-sponsoring declaration failed: ${err instanceof Error ? err.message : String(err)}`
+      );
+    }
+  }
   return extensions;
 }
 
@@ -2333,27 +2483,6 @@ async function runDynamicChannelMgmtFlow(args) {
 // src/pipeline/flows/dynamic/dynamic-invoke.ts
 import { NextResponse as NextResponse6 } from "next/server";
 
-// src/pricing/atomic.ts
-var USDC_DECIMALS = 6;
-function decimalToAtomic(amount) {
-  const m = /^(\d+)(?:\.(\d+))?$/.exec(amount.trim());
-  if (!m) {
-    throw Object.assign(new Error(`'${amount}' is not a valid decimal-dollar string`), {
-      status: 400
-    });
-  }
-  const whole = m[1];
-  const fraction = (m[2] ?? "").slice(0, USDC_DECIMALS).padEnd(USDC_DECIMALS, "0");
-  return BigInt(`${whole}${fraction}`.replace(/^0+(?=\d)/, "") || "0");
-}
-function atomicToDecimal(atomic) {
-  const whole = atomic / 10n ** BigInt(USDC_DECIMALS);
-  const fraction = atomic % 10n ** BigInt(USDC_DECIMALS);
-  if (fraction === 0n) return whole.toString();
-  const fractionStr = fraction.toString().padStart(USDC_DECIMALS, "0").replace(/0+$/, "");
-  return `${whole}.${fractionStr}`;
-}
-
 // src/pricing/charge-context.ts
 function createChargeContext(args) {
   const { tickCost, maxPrice, route } = args;
@@ -2764,6 +2893,19 @@ async function runPaidFlow(ctx) {
 import { NextResponse as NextResponse7 } from "next/server";
 
 // src/kv-store/client.ts
+var BIGINT_SUFFIX = "#__bigint";
+function stringifyValue(value) {
+  return JSON.stringify(
+    value,
+    (_key, v) => typeof v === "bigint" ? `${v.toString()}${BIGINT_SUFFIX}` : v
+  );
+}
+function parseValue(raw) {
+  return JSON.parse(
+    raw,
+    (_key, v) => typeof v === "string" && v.endsWith(BIGINT_SUFFIX) ? BigInt(v.slice(0, -BIGINT_SUFFIX.length)) : v
+  );
+}
 function restKvStore(url, token) {
   const base = url.replace(/\/+$/, "");
   const authHeader = { Authorization: `Bearer ${token}` };
@@ -2785,16 +2927,22 @@ function restKvStore(url, token) {
     const res = await fetch(`${base}/get/${encodeURIComponent(key)}`, { headers: authHeader });
     if (!res.ok) throw new Error(`[kv-store] GET ${key}: ${res.status}`);
     const { result } = await res.json();
-    return result ?? null;
+    if (result == null) return null;
+    if (typeof result !== "string") return result;
+    try {
+      return parseValue(result);
+    } catch {
+      return result;
+    }
   }
   async function set(key, value) {
-    await exec(["SET", key, JSON.stringify(value)]);
+    await exec(["SET", key, stringifyValue(value)]);
   }
   async function del(key) {
     await exec(["DEL", key]);
   }
   async function setNxEx(key, value, ttlSeconds) {
-    const result = await exec(["SET", key, JSON.stringify(value), "EX", ttlSeconds, "NX"]);
+    const result = await exec(["SET", key, stringifyValue(value), "EX", ttlSeconds, "NX"]);
     return result === "OK";
   }
   async function sadd(key, member) {
@@ -3123,142 +3271,109 @@ ${issues}`
 }
 
 // src/builder.ts
-var RouteBuilder = class {
-  /** @internal */
-  _key;
-  /** @internal */
-  _registry;
-  /** @internal */
-  _deps;
-  /** @internal */
-  _authMode = null;
-  /** @internal */
-  _pricing;
-  /** @internal */
-  _siwxEnabled = false;
-  /** @internal */
-  _protocols = ["x402"];
-  /** @internal */
-  _maxPrice;
-  /** @internal */
-  _minPrice;
-  /** @internal */
-  _dynamicPrice = false;
-  /** @internal */
-  _tickCost;
-  /** @internal */
-  _unitType;
-  /** @internal */
-  _payTo;
-  /** @internal */
-  _bodySchema;
-  /** @internal */
-  _querySchema;
-  /** @internal */
-  _outputSchema;
-  /** @internal */
-  _inputExample = void 0;
-  /** @internal */
-  _hasInputExample = false;
-  /** @internal */
-  _outputExample = void 0;
-  /** @internal */
-  _hasOutputExample = false;
-  /** @internal */
-  _description;
-  /** @internal */
-  _path;
-  /** @internal */
-  _method = "POST";
-  /** @internal */
-  _apiKeyResolver;
-  /** @internal */
-  _providerName;
-  /** @internal */
-  _providerConfig;
-  /** @internal */
-  _validateFn;
-  /** @internal */
-  _settlement;
-  /** @internal */
-  _mppInfo;
-  constructor(key, registry, deps) {
-    this._key = key;
-    this._registry = registry;
-    this._deps = deps;
+var RouteBuilder = class _RouteBuilder {
+  #s;
+  constructor(key, registry, deps, defaults) {
+    this.#s = {
+      key,
+      registry,
+      deps,
+      authMode: null,
+      pricing: void 0,
+      siwxEnabled: false,
+      protocols: defaults?.protocols ? [...defaults.protocols] : ["x402"],
+      maxPrice: void 0,
+      minPrice: void 0,
+      dynamicPrice: false,
+      tickCost: void 0,
+      unitType: void 0,
+      payTo: void 0,
+      bodySchema: void 0,
+      querySchema: void 0,
+      outputSchema: void 0,
+      inputExample: void 0,
+      hasInputExample: false,
+      outputExample: void 0,
+      hasOutputExample: false,
+      description: void 0,
+      path: void 0,
+      method: "POST",
+      apiKeyResolver: void 0,
+      providerName: void 0,
+      providerConfig: void 0,
+      validateFn: void 0,
+      settlement: void 0,
+      mppInfo: void 0
+    };
   }
   fork() {
-    const next = Object.create(Object.getPrototypeOf(this));
-    Object.assign(next, this);
-    next._protocols = [...this._protocols];
+    const next = new _RouteBuilder(
+      this.#s.key,
+      this.#s.registry,
+      this.#s.deps
+    );
+    next.#s = { ...this.#s, protocols: [...this.#s.protocols] };
     return next;
   }
   paid(pricingOrOptions, options) {
-    const { pricing, resolvedOptions } = resolvePaidArgs(this._key, pricingOrOptions, options);
-    if (this._authMode === "unprotected") {
+    const { pricing, resolvedOptions } = resolvePaidArgs(this.#s.key, pricingOrOptions, options);
+    if (this.#s.authMode === "unprotected") {
       throw new Error(
-        `route '${this._key}': Cannot combine .unprotected() and .paid() on the same route.`
+        `route '${this.#s.key}': Cannot combine .unprotected() and .paid() on the same route.`
       );
     }
-    if (this._pricing !== void 0) {
+    if (this.#s.pricing !== void 0) {
       throw new Error(
-        `route '${this._key}': Cannot call .paid() more than once on the same route.`
+        `route '${this.#s.key}': Cannot call .paid() more than once on the same route.`
       );
     }
     const next = this.fork();
-    next._authMode = "paid";
-    next._pricing = pricing;
+    next.#s.authMode = "paid";
+    next.#s.pricing = pricing;
     if (resolvedOptions?.protocols) {
-      next._protocols = [...resolvedOptions.protocols];
-    } else if (next._protocols.length === 0) {
-      next._protocols = ["x402"];
+      next.#s.protocols = [...resolvedOptions.protocols];
+    } else if (next.#s.protocols.length === 0) {
+      next.#s.protocols = ["x402"];
     }
-    if (resolvedOptions?.maxPrice) next._maxPrice = resolvedOptions.maxPrice;
-    if (resolvedOptions?.minPrice) next._minPrice = resolvedOptions.minPrice;
-    if (resolvedOptions?.payTo) next._payTo = resolvedOptions.payTo;
-    if (resolvedOptions?.mpp) next._mppInfo = resolvedOptions.mpp;
-    if (resolvedOptions?.dynamic) next._dynamicPrice = true;
-    if (resolvedOptions?.tickCost) next._tickCost = resolvedOptions.tickCost;
-    if (resolvedOptions?.unitType) next._unitType = resolvedOptions.unitType;
+    if (resolvedOptions?.maxPrice) next.#s.maxPrice = resolvedOptions.maxPrice;
+    if (resolvedOptions?.minPrice) next.#s.minPrice = resolvedOptions.minPrice;
+    if (resolvedOptions?.payTo) next.#s.payTo = resolvedOptions.payTo;
+    if (resolvedOptions?.mpp) next.#s.mppInfo = resolvedOptions.mpp;
+    if (resolvedOptions?.dynamic) next.#s.dynamicPrice = true;
+    if (resolvedOptions?.tickCost) next.#s.tickCost = resolvedOptions.tickCost;
+    if (resolvedOptions?.unitType) next.#s.unitType = resolvedOptions.unitType;
     if (typeof pricing === "object" && "tiers" in pricing) {
-      if (next._dynamicPrice) {
+      if (next.#s.dynamicPrice) {
         throw new Error(
-          `route '${this._key}': .paid({ dynamic: true }) is incompatible with tiered pricing`
+          `route '${this.#s.key}': .paid({ dynamic: true }) is incompatible with tiered pricing`
         );
       }
       for (const [tierKey, tierConfig] of Object.entries(pricing.tiers)) {
         if (!tierKey) {
-          throw new Error(`route '${this._key}': tier key cannot be empty`);
+          throw new Error(`route '${this.#s.key}': tier key cannot be empty`);
         }
-        const tierPrice = parseFloat(tierConfig.price);
-        if (isNaN(tierPrice) || tierPrice <= 0) {
+        if (!isPositiveDecimal(tierConfig.price)) {
           throw new Error(
-            `route '${this._key}': tier '${tierKey}' price '${tierConfig.price}' must be a positive decimal string`
+            `route '${this.#s.key}': tier '${tierKey}' price '${tierConfig.price}' must be a positive decimal string`
           );
         }
       }
     }
-    if (resolvedOptions?.maxPrice !== void 0) {
-      const parsed = parseFloat(resolvedOptions.maxPrice);
-      if (isNaN(parsed) || parsed <= 0) {
-        throw new Error(
-          `route '${this._key}': maxPrice '${resolvedOptions.maxPrice}' must be a positive decimal string`
-        );
-      }
+    if (resolvedOptions?.maxPrice !== void 0 && !isPositiveDecimal(resolvedOptions.maxPrice)) {
+      throw new Error(
+        `route '${this.#s.key}': maxPrice '${resolvedOptions.maxPrice}' must be a positive decimal string`
+      );
     }
-    if (resolvedOptions?.tickCost !== void 0) {
-      const parsed = parseFloat(resolvedOptions.tickCost);
-      if (isNaN(parsed) || parsed <= 0) {
-        throw new Error(
-          `route '${this._key}': tickCost '${resolvedOptions.tickCost}' must be a positive decimal string`
-        );
-      }
+    if (resolvedOptions?.tickCost !== void 0 && !isPositiveDecimal(resolvedOptions.tickCost)) {
+      throw new Error(
+        `route '${this.#s.key}': tickCost '${resolvedOptions.tickCost}' must be a positive decimal string`
+      );
     }
-    if (next._dynamicPrice && !next._maxPrice) {
-      throw new Error(`route '${this._key}': .paid({ dynamic: true }) requires maxPrice`);
+    if (next.#s.dynamicPrice && !next.#s.maxPrice) {
+      throw new Error(`route '${this.#s.key}': .paid({ dynamic: true }) requires maxPrice`);
     }
-    if (next._dynamicPrice && !next._tickCost) {
-      throw new Error(`route '${this._key}': .paid({ dynamic: true }) requires tickCost`);
+    if (next.#s.dynamicPrice && !next.#s.tickCost) {
+      throw new Error(`route '${this.#s.key}': .paid({ dynamic: true }) requires tickCost`);
     }
     return next;
   }
@@ -3273,25 +3388,25 @@ var RouteBuilder = class {
    * ```
    */
   siwx() {
-    if (this._authMode === "unprotected") {
+    if (this.#s.authMode === "unprotected") {
       throw new Error(
-        `route '${this._key}': Cannot combine .unprotected() and .siwx() on the same route.`
+        `route '${this.#s.key}': Cannot combine .unprotected() and .siwx() on the same route.`
       );
     }
-    if (this._apiKeyResolver) {
+    if (this.#s.apiKeyResolver) {
       throw new Error(
-        `route '${this._key}': Combining .siwx() and .apiKey() is not supported on the same route.`
+        `route '${this.#s.key}': Combining .siwx() and .apiKey() is not supported on the same route.`
       );
     }
     const next = this.fork();
-    next._siwxEnabled = true;
-    if (next._authMode === "paid" || next._pricing) {
-      next._authMode = "paid";
-      if (next._protocols.length === 0) next._protocols = ["x402"];
+    next.#s.siwxEnabled = true;
+    if (next.#s.authMode === "paid" || next.#s.pricing) {
+      next.#s.authMode = "paid";
+      if (next.#s.protocols.length === 0) next.#s.protocols = ["x402"];
       return next;
     }
-    next._authMode = "siwx";
-    next._protocols = [];
+    next.#s.authMode = "siwx";
+    next.#s.protocols = [];
     return next;
   }
   /**
@@ -3308,14 +3423,14 @@ var RouteBuilder = class {
    * ```
    */
   apiKey(resolver) {
-    if (this._siwxEnabled) {
+    if (this.#s.siwxEnabled) {
       throw new Error(
-        `route '${this._key}': Combining .apiKey() and .siwx() is not supported on the same route.`
+        `route '${this.#s.key}': Combining .apiKey() and .siwx() is not supported on the same route.`
       );
     }
     const next = this.fork();
-    next._authMode = "apiKey";
-    next._apiKeyResolver = resolver;
+    next.#s.authMode = "apiKey";
+    next.#s.apiKeyResolver = resolver;
     return next;
   }
   /**
@@ -3328,19 +3443,19 @@ var RouteBuilder = class {
    * ```
    */
   unprotected() {
-    if (this._authMode && this._authMode !== "unprotected") {
+    if (this.#s.authMode && this.#s.authMode !== "unprotected") {
       throw new Error(
-        `route '${this._key}': Cannot combine .unprotected() and .${this._authMode}() on the same route.`
+        `route '${this.#s.key}': Cannot combine .unprotected() and .${this.#s.authMode}() on the same route.`
       );
     }
-    if (this._pricing) {
+    if (this.#s.pricing) {
       throw new Error(
-        `route '${this._key}': Cannot combine .unprotected() and .paid() on the same route.`
+        `route '${this.#s.key}': Cannot combine .unprotected() and .paid() on the same route.`
       );
     }
     const next = this.fork();
-    next._authMode = "unprotected";
-    next._protocols = [];
+    next.#s.authMode = "unprotected";
+    next.#s.protocols = [];
     return next;
   }
   /**
@@ -3359,8 +3474,8 @@ var RouteBuilder = class {
    */
   provider(name, config) {
     const next = this.fork();
-    next._providerName = name;
-    next._providerConfig = config ?? {};
+    next.#s.providerName = name;
+    next.#s.providerConfig = config ?? {};
     return next;
   }
   /**
@@ -3375,7 +3490,7 @@ var RouteBuilder = class {
    */
   body(schema) {
     const next = this.fork();
-    next._bodySchema = schema;
+    next.#s.bodySchema = schema;
     return next;
   }
   /**
@@ -3391,8 +3506,8 @@ var RouteBuilder = class {
    */
   query(schema) {
     const next = this.fork();
-    next._querySchema = schema;
-    next._method = "GET";
+    next.#s.querySchema = schema;
+    next.#s.method = "GET";
     return next;
   }
   /**
@@ -3409,7 +3524,7 @@ var RouteBuilder = class {
    */
   output(schema) {
     const next = this.fork();
-    next._outputSchema = schema;
+    next.#s.outputSchema = schema;
     return next;
   }
   /**
@@ -3423,8 +3538,8 @@ var RouteBuilder = class {
    */
   inputExample(example) {
     const next = this.fork();
-    next._inputExample = example;
-    next._hasInputExample = true;
+    next.#s.inputExample = example;
+    next.#s.hasInputExample = true;
     return next;
   }
   /**
@@ -3438,8 +3553,8 @@ var RouteBuilder = class {
    */
   outputExample(example) {
     const next = this.fork();
-    next._outputExample = example;
-    next._hasOutputExample = true;
+    next.#s.outputExample = example;
+    next.#s.hasOutputExample = true;
     return next;
   }
   /**
@@ -3453,7 +3568,7 @@ var RouteBuilder = class {
    */
   description(text) {
     const next = this.fork();
-    next._description = text;
+    next.#s.description = text;
     return next;
   }
   /**
@@ -3467,7 +3582,7 @@ var RouteBuilder = class {
    */
   path(p) {
     const next = this.fork();
-    next._path = p;
+    next.#s.path = p;
     return next;
   }
   /**
@@ -3481,7 +3596,7 @@ var RouteBuilder = class {
    */
   method(m) {
     const next = this.fork();
-    next._method = m;
+    next.#s.method = m;
     return next;
   }
   /**
@@ -3500,7 +3615,7 @@ var RouteBuilder = class {
    */
   validate(fn) {
     const next = this.fork();
-    next._validateFn = fn;
+    next.#s.validateFn = fn;
     return next;
   }
   /**
@@ -3518,7 +3633,7 @@ var RouteBuilder = class {
    */
   settlement(lifecycle) {
     const next = this.fork();
-    next._settlement = lifecycle;
+    next.#s.settlement = lifecycle;
     return next;
   }
   /**
@@ -3561,79 +3676,79 @@ var RouteBuilder = class {
     return this.register(fn, true);
   }
   register(handlerFn, streaming) {
-    if (!this._authMode) {
+    if (!this.#s.authMode) {
       throw new Error(
-        `route '${this._key}': Select an auth mode: .paid(pricing), .siwx(), .apiKey(resolver), or .unprotected()`
+        `route '${this.#s.key}': Select an auth mode: .paid(pricing), .siwx(), .apiKey(resolver), or .unprotected()`
       );
     }
-    if (this._validateFn && !this._bodySchema) {
+    if (this.#s.validateFn && !this.#s.bodySchema) {
       throw new Error(
-        `route '${this._key}': .validate() requires .body() \u2014 validation runs on parsed body`
+        `route '${this.#s.key}': .validate() requires .body() \u2014 validation runs on parsed body`
       );
     }
-    if (this._settlement && !this._pricing) {
-      throw new Error(`route '${this._key}': .settlement() requires a paid route`);
+    if (this.#s.settlement && !this.#s.pricing) {
+      throw new Error(`route '${this.#s.key}': .settlement() requires a paid route`);
     }
-    if (this._dynamicPrice && this._protocols.includes("x402")) {
-      const hasUpto = this._deps.x402Accepts.some((accept) => accept.scheme === "upto");
+    if (this.#s.dynamicPrice && this.#s.protocols.includes("x402")) {
+      const hasUpto = this.#s.deps.x402Accepts.some((accept) => accept.scheme === "upto");
       if (!hasUpto) {
         throw new Error(
-          `route '${this._key}': .paid({ dynamic: true }) on an x402 route requires an 'upto' accept on at least one configured network. Add { scheme: 'upto', network, asset } to RouterConfig.x402.accepts.`
+          `route '${this.#s.key}': .paid({ dynamic: true }) on an x402 route requires an 'upto' accept on at least one configured network. Add { scheme: 'upto', network, asset } to RouterConfig.x402.accepts.`
         );
       }
     }
-    if (this._dynamicPrice && this._protocols.includes("mpp")) {
-      if (!this._deps.mppSessionConfig) {
+    if (this.#s.dynamicPrice && this.#s.protocols.includes("mpp")) {
+      if (!this.#s.deps.mppSessionConfig) {
         throw new Error(
-          `route '${this._key}': .paid({ dynamic: true }) on an MPP route requires session mode. Set RouterConfig.mpp.session = {} and provide mpp.operatorKey.`
+          `route '${this.#s.key}': .paid({ dynamic: true }) on an MPP route requires session mode. Set RouterConfig.mpp.session = {} and provide mpp.operatorKey.`
         );
       }
     }
-    if (streaming && !this._dynamicPrice) {
+    if (streaming && !this.#s.dynamicPrice) {
       throw new Error(
-        `route '${this._key}': .stream() requires .paid({ dynamic: true }) \u2014 static/free routes can't meter per-chunk billing.`
+        `route '${this.#s.key}': .stream() requires .paid({ dynamic: true }) \u2014 static/free routes can't meter per-chunk billing.`
       );
     }
     validateExamples(
-      this._key,
-      this._bodySchema,
-      this._querySchema,
-      this._outputSchema,
-      this._inputExample,
-      this._hasInputExample,
-      this._outputExample,
-      this._hasOutputExample
+      this.#s.key,
+      this.#s.bodySchema,
+      this.#s.querySchema,
+      this.#s.outputSchema,
+      this.#s.inputExample,
+      this.#s.hasInputExample,
+      this.#s.outputExample,
+      this.#s.hasOutputExample
     );
     const entry = {
-      key: this._key,
-      authMode: this._authMode,
-      siwxEnabled: this._siwxEnabled,
-      pricing: this._pricing,
-      dynamicPrice: this._dynamicPrice ? true : void 0,
+      key: this.#s.key,
+      authMode: this.#s.authMode,
+      siwxEnabled: this.#s.siwxEnabled,
+      pricing: this.#s.pricing,
+      dynamicPrice: this.#s.dynamicPrice ? true : void 0,
       streaming: streaming ? true : void 0,
-      protocols: this._protocols,
-      bodySchema: this._bodySchema,
-      querySchema: this._querySchema,
-      outputSchema: this._outputSchema,
-      inputExample: this._hasInputExample ? this._inputExample : void 0,
-      outputExample: this._hasOutputExample ? this._outputExample : void 0,
-      description: this._description,
-      path: this._path,
-      method: this._method,
-      maxPrice: this._maxPrice,
-      minPrice: this._minPrice,
-      payTo: this._payTo,
-      apiKeyResolver: this._apiKeyResolver,
-      providerName: this._providerName,
-      providerConfig: this._providerConfig,
-      validateFn: this._validateFn,
-      settlement: this._settlement,
-      mppInfo: this._mppInfo,
-      tickCost: this._tickCost,
-      unitType: this._unitType
+      protocols: this.#s.protocols,
+      bodySchema: this.#s.bodySchema,
+      querySchema: this.#s.querySchema,
+      outputSchema: this.#s.outputSchema,
+      inputExample: this.#s.hasInputExample ? this.#s.inputExample : void 0,
+      outputExample: this.#s.hasOutputExample ? this.#s.outputExample : void 0,
+      description: this.#s.description,
+      path: this.#s.path,
+      method: this.#s.method,
+      maxPrice: this.#s.maxPrice,
+      minPrice: this.#s.minPrice,
+      payTo: this.#s.payTo,
+      apiKeyResolver: this.#s.apiKeyResolver,
+      providerName: this.#s.providerName,
+      providerConfig: this.#s.providerConfig,
+      validateFn: this.#s.validateFn,
+      settlement: this.#s.settlement,
+      mppInfo: this.#s.mppInfo,
+      tickCost: this.#s.tickCost,
+      unitType: this.#s.unitType
     };
-    this._registry.register(entry);
-    return createRequestHandler(entry, handlerFn, this._deps);
+    this.#s.registry.register(entry);
+    return createRequestHandler(entry, handlerFn, this.#s.deps);
   }
 };
 function resolvePaidArgs(routeKey, pricingOrOptions, options) {
@@ -3877,17 +3992,16 @@ function buildPricingInfo(entry) {
     };
   }
   if ("tiers" in entry.pricing) {
-    const tierPrices = Object.values(entry.pricing.tiers).map((tier) => parseFloat(tier.price));
-    const min = Math.min(...tierPrices);
-    const max = Math.max(...tierPrices);
-    if (Number.isFinite(min) && Number.isFinite(max)) {
-      if (min === max) {
+    const tierPrices = Object.values(entry.pricing.tiers).map((tier) => tier.price);
+    const extrema = tierExtrema(tierPrices);
+    if (extrema) {
+      if (extrema.min === extrema.max) {
         return {
-          price: { mode: "fixed", currency: "USD", amount: String(min) }
+          price: { mode: "fixed", currency: "USD", amount: extrema.min }
         };
       }
       return {
-        price: { mode: "dynamic", currency: "USD", min: String(min), max: String(max) }
+        price: { mode: "dynamic", currency: "USD", min: extrema.min, max: extrema.max }
       };
     }
     return {
@@ -3901,6 +4015,20 @@ function buildPricingInfo(entry) {
   }
   return void 0;
 }
+function tierExtrema(prices) {
+  if (prices.length === 0) return null;
+  let min = prices[0];
+  let max = prices[0];
+  try {
+    for (const price of prices.slice(1)) {
+      if (compareDecimals(price, min) < 0) min = price;
+      if (compareDecimals(price, max) > 0) max = price;
+    }
+  } catch {
+    return null;
+  }
+  return { min, max };
+}
 
 // src/discovery/llms-txt.ts
 import { NextResponse as NextResponse10 } from "next/server";
@@ -4387,11 +4515,11 @@ function getRouterConfigIssues(config, options = {}) {
 }
 
 // src/init/x402.ts
-async function initX402(config, configError) {
+async function initX402(config, kvStore, configError) {
   if (configError) return { initError: configError };
   try {
     const { createX402Server: createX402Server2 } = await Promise.resolve().then(() => (init_x402_server(), x402_server_exports));
-    const result = await createX402Server2(config);
+    const result = await createX402Server2(config, kvStore);
     await result.initPromise;
     return {
       server: result.server,
@@ -4574,7 +4702,7 @@ function createRouter(config) {
     mppSessionConfig: config.mpp?.session ? { depositMultiplier: config.mpp.session.depositMultiplier ?? 10 } : null
   };
   deps.initPromise = (async () => {
-    const x402Result = await initX402(config, x402ConfigError);
+    const x402Result = await initX402(config, kvStore, x402ConfigError);
     deps.x402Server = x402Result.server ?? null;
     deps.x402FacilitatorsByNetwork = x402Result.facilitatorsByNetwork;
     if (x402Result.initError) deps.x402InitError = x402Result.initError;
@@ -4603,11 +4731,10 @@ function createRouter(config) {
           `[router] strictRoutes=true forbids key/path divergence for route '${definition.path}'. Remove custom \`key\` or make it equal to \`path\`.`
         );
       }
-      let builder = new RouteBuilder(key, registry, deps);
+      let builder = new RouteBuilder(key, registry, deps, {
+        protocols: config.protocols
+      });
       builder = builder.path(normalizedPath);
-      if (config.protocols) {
-        builder._protocols = [...config.protocols];
-      }
       if (definition.method) {
         builder = builder.method(definition.method);
       }