@agentcash/router 1.6.0 → 1.7.1

package/dist/index.cjs

@@ -31,14 +31,18 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/constants.ts
-var BASE_NETWORK, SOLANA_MAINNET_NETWORK, TEMPO_USDC_CURRENCY, ZERO_EVM_ADDRESS;
+var BASE_MAINNET_NETWORK, SOLANA_MAINNET_NETWORK, TEMPO_USDC_ADDRESS, TEMPO_USDC_DECIMALS, BASE_USDC_ADDRESS, BASE_USDC_DECIMALS, ZERO_EVM_ADDRESS, DEFAULT_SOLANA_FACILITATOR_URL;
 var init_constants = __esm({
   "src/constants.ts"() {
     "use strict";
-    BASE_NETWORK = "eip155:8453";
+    BASE_MAINNET_NETWORK = "eip155:8453";
     SOLANA_MAINNET_NETWORK = "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp";
-    TEMPO_USDC_CURRENCY = "0x20c000000000000000000000b9537d11c60e8b50";
+    TEMPO_USDC_ADDRESS = "0x20c000000000000000000000b9537d11c60e8b50";
+    TEMPO_USDC_DECIMALS = 6;
+    BASE_USDC_ADDRESS = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
+    BASE_USDC_DECIMALS = 6;
     ZERO_EVM_ADDRESS = "0x0000000000000000000000000000000000000000";
+    DEFAULT_SOLANA_FACILITATOR_URL = "https://facilitator.corbits.dev";
   }
 });
 
@@ -55,7 +59,7 @@ function getConfiguredX402Accepts(config) {
   return [
     {
       scheme: "exact",
-      network: config.network ?? BASE_NETWORK,
+      network: config.network ?? BASE_MAINNET_NETWORK,
       payTo: config.payeeAddress
     }
   ];
@@ -235,7 +239,10 @@ async function getAcceptsHeadersForFacilitator(facilitator) {
   return {};
 }
 function resolveX402FacilitatorTarget(config, network, defaultEvmFacilitator) {
-  return (isSolanaNetwork(network) ? config.x402?.facilitators?.solana : void 0) ?? (isEvmNetwork(network) ? config.x402?.facilitators?.evm : void 0) ?? (isSolanaNetwork(network) ? DEFAULT_SOLANA_FACILITATOR_URL : defaultEvmFacilitator);
+  if (isSolanaNetwork(network)) {
+    return config.x402?.facilitators?.solana ?? DEFAULT_SOLANA_FACILITATOR_URL;
+  }
+  return defaultEvmFacilitator;
 }
 function normalizeFacilitatorTarget(target) {
   return typeof target === "string" ? { url: target } : target;
@@ -248,22 +255,148 @@ function getNetworkFamily(network) {
 function sameFacilitatorConfig(a, b) {
   return a.url === b.url && a.createAuthHeaders === b.createAuthHeaders && a.createAcceptsHeaders === b.createAcceptsHeaders;
 }
-var DEFAULT_SOLANA_FACILITATOR_URL;
 var init_facilitators = __esm({
   "src/protocols/x402/facilitators.ts"() {
     "use strict";
     init_evm();
     init_solana();
-    DEFAULT_SOLANA_FACILITATOR_URL = "https://facilitator.corbits.dev";
+    init_constants();
+  }
+});
+
+// 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/server.ts
-var server_exports = {};
-__export(server_exports, {
+// 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");
@@ -277,7 +410,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
   );
@@ -301,48 +438,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_server = __esm({
-  "src/server.ts"() {
+var init_x402_server = __esm({
+  "src/init/x402-server.ts"() {
     "use strict";
     init_evm();
     init_solana();
     init_facilitators();
+    init_facilitator_clients();
     init_accepts();
   }
 });
@@ -350,30 +452,19 @@ var init_server = __esm({
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
-  BASE_NETWORK: () => BASE_NETWORK,
+  BASE_MAINNET_NETWORK: () => BASE_MAINNET_NETWORK,
+  BASE_USDC_ADDRESS: () => BASE_USDC_ADDRESS,
+  BASE_USDC_DECIMALS: () => BASE_USDC_DECIMALS,
+  DEFAULT_SOLANA_FACILITATOR_URL: () => DEFAULT_SOLANA_FACILITATOR_URL,
   HttpError: () => HttpError,
-  MemoryEntitlementStore: () => MemoryEntitlementStore,
-  MemoryNonceStore: () => MemoryNonceStore,
-  RouteBuilder: () => RouteBuilder,
-  RouteRegistry: () => RouteRegistry,
   RouterConfigError: () => RouterConfigError,
-  SIWX_CHALLENGE_EXPIRY_MS: () => SIWX_CHALLENGE_EXPIRY_MS,
-  SIWX_ERROR_MESSAGES: () => SIWX_ERROR_MESSAGES,
   SOLANA_MAINNET_NETWORK: () => SOLANA_MAINNET_NETWORK,
-  TEMPO_USDC_CURRENCY: () => TEMPO_USDC_CURRENCY,
+  TEMPO_USDC_ADDRESS: () => TEMPO_USDC_ADDRESS,
+  TEMPO_USDC_DECIMALS: () => TEMPO_USDC_DECIMALS,
   ZERO_EVM_ADDRESS: () => ZERO_EVM_ADDRESS,
-  consolePlugin: () => consolePlugin,
-  createKvEntitlementStore: () => createKvEntitlementStore,
-  createKvMppStore: () => createKvMppStore,
-  createKvNonceStore: () => createKvNonceStore,
   createRouter: () => createRouter,
-  formatRouterConfigIssues: () => formatRouterConfigIssues,
-  getRouterConfigIssues: () => getRouterConfigIssues,
-  mppFromEnv: () => mppFromEnv,
-  paidOptionsForProtocols: () => paidOptionsForProtocols,
-  validateRouterConfig: () => validateRouterConfig,
-  withPrefix: () => withPrefix,
-  x402AcceptsFromEnv: () => x402AcceptsFromEnv
+  createRouterFromEnv: () => createRouterFromEnv,
+  routerConfigFromEnv: () => routerConfigFromEnv
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -441,7 +532,7 @@ var AUTH_SCHEME = {
   MPP_PAYMENT: "Payment "
 };
 
-// src/plugin.ts
+// src/plugin/index.ts
 function createDefaultContext(meta) {
   const ctx = {
     requestId: meta.requestId,
@@ -477,46 +568,8 @@ function firePluginHook(plugin, method, ...args) {
     return void 0;
   }
 }
-function consolePlugin() {
-  return {
-    onRequest(meta) {
-      const ctx = createDefaultContext(meta);
-      return ctx;
-    },
-    onAuthVerified(_ctx, auth) {
-      const wallet = auth.wallet ? ` wallet=${auth.wallet}` : "";
-      console.log(`[router] AUTH ${auth.authMode} ${auth.route}${wallet}`);
-    },
-    onPaymentVerified(_ctx, payment) {
-      console.log(`[router] VERIFIED ${payment.protocol} ${payment.payer} ${payment.amount}`);
-    },
-    onPaymentSettled(_ctx, settlement) {
-      console.log(`[router] SETTLED ${settlement.protocol} tx=${settlement.transaction}`);
-    },
-    onResponse(ctx, response) {
-      const wallet = ctx.verifiedWallet ? ` wallet=${ctx.verifiedWallet}` : "";
-      console.log(
-        `[router] ${ctx.route} \u2192 ${response.statusCode} (${response.duration}ms)${wallet}`
-      );
-    },
-    onError(_ctx, error) {
-      console.error(`[router] ERROR ${error.status}: ${error.message}`);
-    },
-    onAlert(_ctx, alert) {
-      const logFn = alert.level === "critical" || alert.level === "error" ? console.error : alert.level === "warn" ? console.warn : console.log;
-      logFn(
-        `[router] ${alert.level.toUpperCase()} ${alert.route}: ${alert.message}`,
-        alert.meta ?? ""
-      );
-    },
-    onProviderQuota(_ctx, event) {
-      const logFn = event.level === "critical" ? console.error : event.level === "warn" ? console.warn : console.log;
-      logFn(`[router] QUOTA ${event.level.toUpperCase()} ${event.provider}: ${event.message}`);
-    }
-  };
-}
 
-// src/alert.ts
+// src/plugin/reporter.ts
 function createReporter(plugin, pluginCtx, route) {
   return (level, message, meta) => {
     firePluginHook(plugin, "onAlert", pluginCtx, {
@@ -528,7 +581,7 @@ function createReporter(plugin, pluginCtx, route) {
   };
 }
 
-// src/pipeline/context/preflight.ts
+// src/pipeline/steps/preflight.ts
 function preflight(routeEntry, handler, deps, request) {
   const meta = buildMeta(request, routeEntry);
   const pluginCtx = firePluginHook(deps.plugin, "onRequest", meta) ?? createDefaultContext(meta);
@@ -558,10 +611,10 @@ function buildMeta(request, routeEntry) {
   };
 }
 
-// src/pipeline/context/parse-body.ts
+// src/pipeline/steps/parse-body.ts
 var import_server = require("next/server");
 
-// src/body.ts
+// src/pipeline/body.ts
 async function bufferBody(request) {
   const text = await request.text();
   if (!text) return void 0;
@@ -585,7 +638,19 @@ function validateBody(parsed, schema) {
   };
 }
 
-// src/pipeline/context/fire-plugin-response.ts
+// src/plugin/events.ts
+function fireAuthVerified(ctx, event) {
+  firePluginHook(ctx.deps.plugin, "onAuthVerified", ctx.pluginCtx, {
+    ...event,
+    route: ctx.routeEntry.key
+  });
+}
+function firePaymentVerified(ctx, event) {
+  firePluginHook(ctx.deps.plugin, "onPaymentVerified", ctx.pluginCtx, event);
+}
+function firePaymentSettled(ctx, event) {
+  firePluginHook(ctx.deps.plugin, "onPaymentSettled", ctx.pluginCtx, event);
+}
 function firePluginResponse(ctx, response, requestBody, responseBody) {
   firePluginHook(ctx.deps.plugin, "onResponse", ctx.pluginCtx, {
     statusCode: response.status,
@@ -604,8 +669,37 @@ function firePluginResponse(ctx, response, requestBody, responseBody) {
     });
   }
 }
+function fireProviderQuota(ctx, response, handlerResult) {
+  const { providerName, providerConfig } = ctx.routeEntry;
+  if (!providerName || !providerConfig?.extractQuota) return;
+  if (response.status >= 400) return;
+  try {
+    const quota = providerConfig.extractQuota(handlerResult, response.headers);
+    if (!quota) return;
+    const level = computeQuotaLevel(quota.remaining, providerConfig.warn, providerConfig.critical);
+    const overage = providerConfig.overage ?? "same-rate";
+    const event = {
+      provider: providerName,
+      route: ctx.routeEntry.key,
+      remaining: quota.remaining,
+      limit: quota.limit,
+      spend: quota.spend,
+      level,
+      overage,
+      message: quota.remaining !== null ? `${providerName}: ${quota.remaining}${quota.limit ? `/${quota.limit}` : ""} remaining` : `${providerName}: quota info unavailable`
+    };
+    firePluginHook(ctx.deps.plugin, "onProviderQuota", ctx.pluginCtx, event);
+  } catch {
+  }
+}
+function computeQuotaLevel(remaining, warn, critical) {
+  if (remaining === null) return "healthy";
+  if (critical !== void 0 && remaining <= critical) return "critical";
+  if (warn !== void 0 && remaining <= warn) return "warn";
+  return "healthy";
+}
 
-// src/pipeline/context/parse-body.ts
+// src/pipeline/steps/parse-body.ts
 async function parseBody(ctx, request = ctx.request) {
   if (!ctx.routeEntry.bodySchema) return { ok: true, data: void 0 };
   const raw = await bufferBody(request);
@@ -619,15 +713,7 @@ async function parseBody(ctx, request = ctx.request) {
   return { ok: false, response };
 }
 
-// src/pipeline/context/parse-query.ts
-function parseQuery(request, routeEntry) {
-  if (!routeEntry.querySchema) return void 0;
-  const params = Object.fromEntries(request.nextUrl.searchParams.entries());
-  const result = routeEntry.querySchema.safeParse(params);
-  return result.success ? result.data : params;
-}
-
-// src/pipeline/context/errors.ts
+// src/pipeline/steps/errors.ts
 function errorStatus(error, fallback) {
   const status = error?.status;
   return typeof status === "number" ? status : fallback;
@@ -640,7 +726,7 @@ function handlerFailureError(response) {
   return Object.assign(new Error(message), { status: response.status });
 }
 
-// src/pipeline/context/fail.ts
+// src/pipeline/steps/fail.ts
 var import_server2 = require("next/server");
 function fail(ctx, status, message, requestBody) {
   const response = import_server2.NextResponse.json({ success: false, error: message }, { status });
@@ -648,7 +734,7 @@ function fail(ctx, status, message, requestBody) {
   return response;
 }
 
-// src/pipeline/context/run-validate.ts
+// src/pipeline/steps/run-validate.ts
 async function runValidate(ctx, body) {
   if (!ctx.routeEntry.validateFn) return null;
   try {
@@ -671,6 +757,14 @@ var HttpError = class extends Error {
   }
 };
 
+// src/pipeline/steps/parse-query.ts
+function parseQuery(request, routeEntry) {
+  if (!routeEntry.querySchema) return void 0;
+  const params = Object.fromEntries(request.nextUrl.searchParams.entries());
+  const result = routeEntry.querySchema.safeParse(params);
+  return result.success ? result.data : params;
+}
+
 // src/pipeline/flows/static/static-invoke.ts
 function invokePaidStatic(ctx, wallet, account, body, payment) {
   return runHandler(ctx, buildHandlerCtx(ctx, wallet, account, body, payment));
@@ -688,14 +782,7 @@ function buildHandlerCtx(ctx, wallet, account, body, payment) {
     wallet,
     payment,
     account,
-    alert(level, message, alertMeta) {
-      firePluginHook(ctx.deps.plugin, "onAlert", ctx.pluginCtx, {
-        level,
-        message,
-        route: ctx.routeEntry.key,
-        meta: alertMeta
-      });
-    },
+    alert: ctx.report,
     setVerifiedWallet: (addr) => ctx.pluginCtx.setVerifiedWallet(addr)
   };
 }
@@ -739,45 +826,14 @@ function isThenable(value) {
   return value != null && (typeof value === "object" || typeof value === "function") && typeof value.then === "function";
 }
 
-// src/pipeline/context/fire-provider-quota.ts
-function fireProviderQuota(ctx, response, handlerResult) {
-  const { providerName, providerConfig } = ctx.routeEntry;
-  if (!providerName || !providerConfig?.extractQuota) return;
-  if (response.status >= 400) return;
-  try {
-    const quota = providerConfig.extractQuota(handlerResult, response.headers);
-    if (!quota) return;
-    const level = computeQuotaLevel(quota.remaining, providerConfig.warn, providerConfig.critical);
-    const overage = providerConfig.overage ?? "same-rate";
-    const event = {
-      provider: providerName,
-      route: ctx.routeEntry.key,
-      remaining: quota.remaining,
-      limit: quota.limit,
-      spend: quota.spend,
-      level,
-      overage,
-      message: quota.remaining !== null ? `${providerName}: ${quota.remaining}${quota.limit ? `/${quota.limit}` : ""} remaining` : `${providerName}: quota info unavailable`
-    };
-    firePluginHook(ctx.deps.plugin, "onProviderQuota", ctx.pluginCtx, event);
-  } catch {
-  }
-}
-function computeQuotaLevel(remaining, warn, critical) {
-  if (remaining === null) return "healthy";
-  if (critical !== void 0 && remaining <= critical) return "critical";
-  if (warn !== void 0 && remaining <= warn) return "warn";
-  return "healthy";
-}
-
-// src/pipeline/context/finalize/response.ts
+// src/pipeline/steps/finalize/response.ts
 function finalize(ctx, response, rawResult, requestBody) {
   fireProviderQuota(ctx, response, rawResult);
   firePluginResponse(ctx, response, requestBody, rawResult);
   return response;
 }
 
-// src/pipeline/context/grant-entitlement.ts
+// src/pipeline/steps/grant-entitlement.ts
 async function grantEntitlementIfSiwx(ctx, wallet) {
   if (!ctx.routeEntry.siwxEnabled) return;
   try {
@@ -790,7 +846,7 @@ async function grantEntitlementIfSiwx(ctx, wallet) {
   }
 }
 
-// src/pipeline/context/settlement-context.ts
+// src/pipeline/steps/settlement-context.ts
 function settlementContext(ctx, scope) {
   return {
     route: ctx.routeEntry.key,
@@ -804,7 +860,7 @@ function settlementContext(ctx, scope) {
   };
 }
 
-// src/pipeline/context/run-settlement-error.ts
+// src/pipeline/steps/run-settlement-error.ts
 async function runSettlementError(ctx, scope, error, phase) {
   const hook = ctx.routeEntry.settlement?.onSettlementError;
   if (!hook) return;
@@ -816,7 +872,7 @@ async function runSettlementError(ctx, scope, error, phase) {
   }
 }
 
-// src/pipeline/context/run-after-settle.ts
+// src/pipeline/steps/run-after-settle.ts
 async function runAfterSettle(ctx, scope) {
   const hook = ctx.routeEntry.settlement?.afterSettle;
   if (!hook) return;
@@ -829,11 +885,11 @@ async function runAfterSettle(ctx, scope) {
   }
 }
 
-// src/pipeline/context/finalize/epilogue.ts
+// src/pipeline/steps/finalize/epilogue.ts
 async function runPostSettleEpilogue(args) {
   const { ctx, strategy, wallet, settle, afterSettleScope, rawResult, body } = args;
   await grantEntitlementIfSiwx(ctx, wallet);
-  firePluginHook(ctx.deps.plugin, "onPaymentSettled", ctx.pluginCtx, {
+  firePaymentSettled(ctx, {
     protocol: strategy.protocol,
     payer: wallet,
     transaction: settle.settledPayment.transaction ?? "",
@@ -843,7 +899,7 @@ async function runPostSettleEpilogue(args) {
   return finalize(ctx, settle.response, rawResult, body);
 }
 
-// src/pipeline/context/finalize/request.ts
+// src/pipeline/steps/finalize/request.ts
 async function settleAndFinalizeRequest(args) {
   const { ctx, strategy, verifyOutcome, scope, rawResult, body, billedAmount, onSettleError } = args;
   const { request, routeEntry, deps, report } = ctx;
@@ -876,7 +932,7 @@ async function settleAndFinalizeRequest(args) {
   });
 }
 
-// src/pipeline/context/finalize/stream.ts
+// src/pipeline/steps/finalize/stream.ts
 async function settleAndFinalizeStream(args) {
   const { ctx, strategy, verifyOutcome, source, account, body, bindChannelCharge } = args;
   const { request, routeEntry, deps, report } = ctx;
@@ -914,7 +970,7 @@ async function settleAndFinalizeStream(args) {
   });
 }
 
-// src/pipeline/context/run-handler-only.ts
+// src/pipeline/steps/run-handler-only.ts
 async function runHandlerOnly(ctx, wallet, account) {
   const body = await parseBody(ctx);
   if (!body.ok) return body.response;
@@ -924,7 +980,7 @@ async function runHandlerOnly(ctx, wallet, account) {
   return finalize(ctx, result.response, result.rawResult, body.data);
 }
 
-// src/pipeline/context/run-before-settle.ts
+// src/pipeline/steps/run-before-settle.ts
 async function runBeforeSettle(ctx, scope) {
   const hook = ctx.routeEntry.settlement?.beforeSettle;
   if (!hook) return null;
@@ -941,7 +997,7 @@ async function runBeforeSettle(ctx, scope) {
   }
 }
 
-// src/pipeline/context/run-settled-handler-error.ts
+// src/pipeline/steps/run-settled-handler-error.ts
 async function runSettledHandlerError(ctx, scope, error = scope.handlerError ?? handlerFailureError(scope.response)) {
   const hook = ctx.routeEntry.settlement?.onSettledHandlerError;
   if (!hook) return;
@@ -1015,7 +1071,7 @@ async function buildSIWXExtension() {
   return declareSIWxExtension();
 }
 
-// src/pipeline/context/try-siwx-fast-path.ts
+// src/pipeline/steps/try-siwx-fast-path.ts
 async function trySiwxFastPath(ctx, account) {
   const { request, routeEntry, deps } = ctx;
   if (!routeEntry.siwxEnabled) return null;
@@ -1027,22 +1083,18 @@ async function trySiwxFastPath(ctx, account) {
   ctx.pluginCtx.setVerifiedWallet(wallet);
   const entitled = await deps.entitlementStore.has(routeEntry.key, wallet);
   if (!entitled) return null;
-  firePluginHook(deps.plugin, "onAuthVerified", ctx.pluginCtx, {
-    authMode: "siwx",
-    wallet,
-    route: routeEntry.key
-  });
+  fireAuthVerified(ctx, { authMode: "siwx", wallet });
   return runHandlerOnly(ctx, wallet, account);
 }
 
-// src/pipeline/context/should-parse-body-early.ts
+// src/pipeline/steps/should-parse-body-early.ts
 function shouldParseBodyEarly(incomingStrategy, routeEntry, pricing) {
   if (incomingStrategy) return false;
   if (!routeEntry.bodySchema) return false;
   return (pricing?.needsBody ?? false) || !!routeEntry.validateFn;
 }
 
-// src/pipeline/context/resolve-early-body.ts
+// src/pipeline/steps/resolve-early-body.ts
 async function resolveEarlyBody(args) {
   const { ctx, pricing, incomingStrategy } = args;
   if (!shouldParseBodyEarly(incomingStrategy, ctx.routeEntry, pricing)) {
@@ -1074,24 +1126,19 @@ function extractBearerToken(header) {
   return null;
 }
 
-// src/pipeline/context/run-api-key-gate.ts
+// src/pipeline/steps/run-api-key-gate.ts
 async function runApiKeyGate(ctx) {
-  const { request, routeEntry, deps } = ctx;
+  const { request, routeEntry } = ctx;
   if (!routeEntry.apiKeyResolver) return { ok: true, account: void 0 };
   const apiKeyResult = await verifyApiKey(request, routeEntry.apiKeyResolver);
   if (!apiKeyResult.valid) {
     return { ok: false, response: fail(ctx, 401, "Invalid or missing API key") };
   }
-  firePluginHook(deps.plugin, "onAuthVerified", ctx.pluginCtx, {
-    authMode: "apiKey",
-    wallet: null,
-    route: routeEntry.key,
-    account: apiKeyResult.account
-  });
+  fireAuthVerified(ctx, { authMode: "apiKey", wallet: null, account: apiKeyResult.account });
   return { ok: true, account: apiKeyResult.account };
 }
 
-// src/pipeline/context/protocol-init-error.ts
+// src/pipeline/steps/protocol-init-error.ts
 function protocolInitError(routeEntry, deps) {
   if (!routeEntry.pricing) return null;
   const errors = [];
@@ -1114,15 +1161,65 @@ async function runApiKeyOnlyFlow(ctx) {
   }
   const result = await verifyApiKey(ctx.request, ctx.routeEntry.apiKeyResolver);
   if (!result.valid) return fail(ctx, 401, "Invalid or missing API key");
-  firePluginHook(ctx.deps.plugin, "onAuthVerified", ctx.pluginCtx, {
-    authMode: "apiKey",
-    wallet: null,
-    route: ctx.routeEntry.key,
-    account: result.account
-  });
+  fireAuthVerified(ctx, { authMode: "apiKey", wallet: null, account: result.account });
   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) {
@@ -1158,9 +1255,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,
@@ -1237,7 +1338,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;
   }
@@ -1715,17 +1816,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 {
@@ -1818,26 +1908,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) {
@@ -2200,28 +2277,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
-  });
-}
-
-// src/protocols/detect.ts
-function detectProtocol(request) {
-  if (request.headers.get(HEADERS.X402_PAYMENT_SIGNATURE) ?? request.headers.get(HEADERS.X402_PAYMENT_LEGACY)) {
-    return "x402";
-  }
-  const auth = request.headers.get(HEADERS.AUTHORIZATION);
-  if (auth && auth.startsWith(AUTH_SCHEME.MPP_PAYMENT)) {
-    return "mpp";
-  }
-  if (request.headers.get(HEADERS.SIWX)) {
-    return "siwx";
-  }
-  return null;
+  };
+  report("error", "Settlement failed", meta);
 }
 
 // src/protocols/index.ts
@@ -2244,13 +2307,14 @@ function getAllowedStrategies(allowed) {
 var import_server4 = require("next/server");
 
 // src/pipeline/challenge-extensions.ts
+init_evm();
 async function buildChallengeExtensions(ctx) {
   const { routeEntry } = ctx;
   let extensions;
   try {
-    const { z } = await import("zod");
+    const { z: z2 } = await import("zod");
     const { declareDiscoveryExtension } = await import("@x402/extensions/bazaar");
-    const toJSON = (schema) => z.toJSONSchema(schema, {
+    const toJSON = (schema) => z2.toJSONSchema(schema, {
       target: "draft-2020-12",
       unrepresentable: "any"
     });
@@ -2271,11 +2335,10 @@ async function buildChallengeExtensions(ctx) {
       extensions = declareDiscoveryExtension(config);
     }
   } catch (err) {
-    firePluginHook(ctx.deps.plugin, "onAlert", ctx.pluginCtx, {
-      level: "warn",
-      message: `Bazaar schema generation failed: ${err instanceof Error ? err.message : String(err)}`,
-      route: routeEntry.key
-    });
+    ctx.report(
+      "warn",
+      `Bazaar schema generation failed: ${err instanceof Error ? err.message : String(err)}`
+    );
   }
   if (routeEntry.siwxEnabled) {
     try {
@@ -2289,7 +2352,24 @@ async function buildChallengeExtensions(ctx) {
     } catch {
     }
   }
-  return extensions;
+  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;
 }
 
 // src/pipeline/flows/build402.ts
@@ -2409,7 +2489,7 @@ async function runDynamicChannelMgmtFlow(args) {
     return build402(ctx, pricing, parsedBody, verifyOutcome.failure);
   }
   ctx.pluginCtx.setVerifiedWallet(verifyOutcome.wallet);
-  firePluginHook(deps.plugin, "onPaymentVerified", ctx.pluginCtx, {
+  firePaymentVerified(ctx, {
     protocol: strategy.protocol,
     payer: verifyOutcome.wallet,
     amount: price,
@@ -2444,27 +2524,6 @@ async function runDynamicChannelMgmtFlow(args) {
 // src/pipeline/flows/dynamic/dynamic-invoke.ts
 var import_server6 = require("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;
@@ -2517,14 +2576,7 @@ async function invokeDynamic(ctx, wallet, account, body, payment) {
     wallet,
     payment,
     account,
-    alert(level, message, alertMeta) {
-      firePluginHook(ctx.deps.plugin, "onAlert", ctx.pluginCtx, {
-        level,
-        message,
-        route: ctx.routeEntry.key,
-        meta: alertMeta
-      });
-    },
+    alert: ctx.report,
     setVerifiedWallet: (addr) => ctx.pluginCtx.setVerifiedWallet(addr)
   };
   const handlerCtx = chargeContext !== null ? { ...baseHandlerCtx, charge: chargeContext.charge } : baseHandlerCtx;
@@ -2589,7 +2641,7 @@ function resolveDynamicPreflight(strategy, request, routeEntry) {
 // src/pipeline/flows/dynamic/dynamic-request.ts
 async function runDynamicRequestFlow(args) {
   const { ctx, strategy, verifyOutcome, account, body, result } = args;
-  const { deps, routeEntry } = ctx;
+  const { routeEntry } = ctx;
   const settleScope = {
     wallet: verifyOutcome.wallet,
     account,
@@ -2615,11 +2667,10 @@ async function runDynamicRequestFlow(args) {
     billedAmount,
     onSettleError: async (error, failMessage) => {
       await runSettlementError(ctx, settleScope, error, "settle");
-      firePluginHook(deps.plugin, "onAlert", ctx.pluginCtx, {
-        level: "critical",
-        message: `${strategy.protocol} ${failMessage}: ${errorMessage(error, "unknown")}`,
-        route: routeEntry.key
-      });
+      ctx.report(
+        "critical",
+        `${strategy.protocol} ${failMessage}: ${errorMessage(error, "unknown")}`
+      );
     }
   });
 }
@@ -2689,7 +2740,7 @@ async function runDynamicPaidFlow(ctx) {
     return build402(ctx, pricing, parsedBody, verifyOutcome.failure);
   }
   ctx.pluginCtx.setVerifiedWallet(verifyOutcome.wallet);
-  firePluginHook(deps.plugin, "onPaymentVerified", ctx.pluginCtx, {
+  firePaymentVerified(ctx, {
     protocol: incomingStrategy.protocol,
     payer: verifyOutcome.wallet,
     amount: price,
@@ -2755,7 +2806,6 @@ async function resolveStaticBodyAndPrice(args) {
 // src/pipeline/flows/static/static-request.ts
 async function runStaticRequestFlow(args) {
   const { ctx, strategy, verifyOutcome, account, body, price, result } = args;
-  const { deps, routeEntry } = ctx;
   const settleScope = {
     wallet: verifyOutcome.wallet,
     account,
@@ -2796,11 +2846,10 @@ async function runStaticRequestFlow(args) {
     billedAmount: price,
     onSettleError: async (error, failMessage) => {
       await runSettlementError(ctx, settleScope, error, "settle");
-      firePluginHook(deps.plugin, "onAlert", ctx.pluginCtx, {
-        level: "critical",
-        message: `${strategy.protocol} ${failMessage}: ${errorMessage(error, "unknown")}`,
-        route: routeEntry.key
-      });
+      ctx.report(
+        "critical",
+        `${strategy.protocol} ${failMessage}: ${errorMessage(error, "unknown")}`
+      );
     }
   });
 }
@@ -2846,7 +2895,7 @@ async function runStaticPaidFlow(ctx) {
     return build402(ctx, pricing, parsedBody, verifyOutcome.failure);
   }
   ctx.pluginCtx.setVerifiedWallet(verifyOutcome.wallet);
-  firePluginHook(deps.plugin, "onPaymentVerified", ctx.pluginCtx, {
+  firePaymentVerified(ctx, {
     protocol: incomingStrategy.protocol,
     payer: verifyOutcome.wallet,
     amount: price,
@@ -2885,6 +2934,19 @@ async function runPaidFlow(ctx) {
 var import_server7 = require("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}` };
@@ -2906,16 +2968,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) {
@@ -3030,6 +3098,21 @@ async function createKvMppStore(kv, options) {
   });
 }
 
+// src/protocols/detect.ts
+function detectProtocol(request) {
+  if (request.headers.get(HEADERS.X402_PAYMENT_SIGNATURE) ?? request.headers.get(HEADERS.X402_PAYMENT_LEGACY)) {
+    return "x402";
+  }
+  const auth = request.headers.get(HEADERS.AUTHORIZATION);
+  if (auth && auth.startsWith(AUTH_SCHEME.MPP_PAYMENT)) {
+    return "mpp";
+  }
+  if (request.headers.get(HEADERS.SIWX)) {
+    return "siwx";
+  }
+  return null;
+}
+
 // src/protocols/mpp/siwx-mode.ts
 var import_mppx3 = require("mppx");
 async function verifyMppSiwx(request, mppx) {
@@ -3069,11 +3152,7 @@ async function runSiwxOnlyFlow(ctx) {
     }
     if (mppSiwxResult.valid) {
       ctx.pluginCtx.setVerifiedWallet(mppSiwxResult.wallet);
-      firePluginHook(deps.plugin, "onAuthVerified", ctx.pluginCtx, {
-        authMode: "siwx",
-        wallet: mppSiwxResult.wallet,
-        route: routeEntry.key
-      });
+      fireAuthVerified(ctx, { authMode: "siwx", wallet: mppSiwxResult.wallet });
       const authResponse = await runHandlerOnly(ctx, mppSiwxResult.wallet, void 0);
       if (authResponse.status < 400) {
         return mppSiwxResult.withReceipt(authResponse);
@@ -3095,11 +3174,7 @@ async function runSiwxOnlyFlow(ctx) {
   }
   const wallet = normalizeWalletAddress(siwx.wallet);
   ctx.pluginCtx.setVerifiedWallet(wallet);
-  firePluginHook(deps.plugin, "onAuthVerified", ctx.pluginCtx, {
-    authMode: "siwx",
-    wallet,
-    route: routeEntry.key
-  });
+  fireAuthVerified(ctx, { authMode: "siwx", wallet });
   return runHandlerOnly(ctx, wallet, void 0);
 }
 async function buildSiwxChallenge(ctx) {
@@ -3192,7 +3267,7 @@ async function runUnprotectedFlow(ctx) {
   return runHandlerOnly(ctx, null, void 0);
 }
 
-// src/orchestrate.ts
+// src/pipeline/orchestrate.ts
 function createRequestHandler(routeEntry, handler, deps) {
   return async (request) => {
     await deps.initPromise;
@@ -3237,142 +3312,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;
   }
@@ -3387,25 +3429,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;
   }
   /**
@@ -3422,14 +3464,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;
   }
   /**
@@ -3442,19 +3484,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;
   }
   /**
@@ -3473,8 +3515,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;
   }
   /**
@@ -3489,7 +3531,7 @@ var RouteBuilder = class {
    */
   body(schema) {
     const next = this.fork();
-    next._bodySchema = schema;
+    next.#s.bodySchema = schema;
     return next;
   }
   /**
@@ -3505,8 +3547,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;
   }
   /**
@@ -3523,7 +3565,7 @@ var RouteBuilder = class {
    */
   output(schema) {
     const next = this.fork();
-    next._outputSchema = schema;
+    next.#s.outputSchema = schema;
     return next;
   }
   /**
@@ -3537,8 +3579,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;
   }
   /**
@@ -3552,8 +3594,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;
   }
   /**
@@ -3567,7 +3609,7 @@ var RouteBuilder = class {
    */
   description(text) {
     const next = this.fork();
-    next._description = text;
+    next.#s.description = text;
     return next;
   }
   /**
@@ -3581,7 +3623,7 @@ var RouteBuilder = class {
    */
   path(p) {
     const next = this.fork();
-    next._path = p;
+    next.#s.path = p;
     return next;
   }
   /**
@@ -3595,7 +3637,7 @@ var RouteBuilder = class {
    */
   method(m) {
     const next = this.fork();
-    next._method = m;
+    next.#s.method = m;
     return next;
   }
   /**
@@ -3614,7 +3656,7 @@ var RouteBuilder = class {
    */
   validate(fn) {
     const next = this.fork();
-    next._validateFn = fn;
+    next.#s.validateFn = fn;
     return next;
   }
   /**
@@ -3632,7 +3674,7 @@ var RouteBuilder = class {
    */
   settlement(lifecycle) {
     const next = this.fork();
-    next._settlement = lifecycle;
+    next.#s.settlement = lifecycle;
     return next;
   }
   /**
@@ -3675,79 +3717,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) {
@@ -3967,7 +4009,7 @@ function toProtocolObject(protocol, mppInfo) {
       mpp: {
         method: mppInfo?.method ?? "tempo",
         intent: mppInfo?.intent ?? "charge",
-        currency: mppInfo?.currency ?? TEMPO_USDC_CURRENCY
+        currency: mppInfo?.currency ?? TEMPO_USDC_ADDRESS
       }
     };
   }
@@ -3991,17 +4033,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 {
@@ -4015,6 +4056,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
 var import_server10 = require("next/server");
@@ -4047,142 +4102,256 @@ function formatRouterConfigIssues(issues) {
   return issues.map((issue) => issue.message).join("\n");
 }
 
-// src/config/validators/x402.ts
-init_accepts();
+// src/config/schema.ts
+var import_zod = require("zod");
+init_constants();
 
-// src/config/validators/shared.ts
-init_evm();
-init_solana();
-init_accepts();
-function isEvmAddress(value) {
-  return /^0x[a-fA-F0-9]{40}$/.test(value);
-}
-function isEvmPrivateKey(value) {
-  return /^0x[a-fA-F0-9]{64}$/.test(value);
-}
-function isSupportedX402Network(network) {
-  return isEvmNetwork(network) || isSolanaNetwork(network);
-}
-function findPlaceholderPayee(values) {
-  return values.find((value) => value !== void 0 && /^0x0{40}$/i.test(value)) ?? null;
-}
-function usesDefaultEvmFacilitator(config) {
-  return getConfiguredX402Networks(config).some(
-    (network) => typeof network === "string" && isEvmNetwork(network)
-  ) && config.x402?.facilitators?.evm === void 0;
+// src/config/utils.ts
+var import_accounts = require("viem/accounts");
+var EVM_ADDRESS_RE = /^0x[a-fA-F0-9]{40}$/;
+var EVM_PRIVATE_KEY_RE = /^0x[a-fA-F0-9]{64}$/;
+var SOLANA_ADDRESS_RE = /^[1-9A-HJ-NP-Za-km-z]{32,44}$/;
+var ZERO_EVM_ADDRESS_RE = /^0x0{40}$/i;
+function isUrl(value) {
+  try {
+    new URL(value);
+    return true;
+  } catch {
+    return false;
+  }
+}
+var isEvmAddress = (v) => EVM_ADDRESS_RE.test(v);
+var isEvmPrivateKey = (v) => EVM_PRIVATE_KEY_RE.test(v);
+var isPlaceholderEvm = (v) => ZERO_EVM_ADDRESS_RE.test(v);
+var isSolanaAddress = (v) => SOLANA_ADDRESS_RE.test(v);
+var isX402Network = (v) => v.startsWith("eip155:") || v.startsWith("solana:");
+var canonicalizeEvm = (addr) => addr.toLowerCase();
+function operatorAddressesCollide(opKey, fpKey) {
+  if (!opKey || !fpKey || !isEvmPrivateKey(opKey) || !isEvmPrivateKey(fpKey)) return null;
+  const op = (0, import_accounts.privateKeyToAccount)(opKey).address.toLowerCase();
+  const fp = (0, import_accounts.privateKeyToAccount)(fpKey).address.toLowerCase();
+  return op === fp ? op : null;
+}
+function trimAll(raw) {
+  const out = {};
+  for (const [k, v] of Object.entries(raw)) {
+    if (typeof v !== "string") {
+      out[k] = void 0;
+      continue;
+    }
+    const trimmed = v.trim();
+    out[k] = trimmed.length > 0 ? trimmed : void 0;
+  }
+  return out;
 }
 
-// src/config/validators/x402.ts
-var CHECKS = [
-  checkAcceptNetworkPresent,
-  checkAcceptNetworkSupported,
-  checkNonExactRequiresAsset,
-  checkDecimalsAreValid,
-  checkPayee,
-  checkPlaceholderPayeeAddress,
-  checkCdpKeys
-];
-function validateX402Config(config, env, options) {
-  const accepts = getConfiguredX402Accepts(config);
-  if (accepts.length === 0) {
+// src/config/schema.ts
+function addIssue(ctx, params, message, path = []) {
+  ctx.addIssue({ code: "custom", path, params, message });
+}
+var x402 = { protocol: "x402" };
+var mpp = { protocol: "mpp" };
+var envShape = {
+  BASE_URL: import_zod.z.string().refine(isUrl, {
+    params: { code: "invalid_base_url" },
+    message: "BASE_URL must be a valid URL \u2014 the public origin used as the 402 realm, OpenAPI server URL, and MPP memo prefix. Must match the public domain."
+  }).optional(),
+  EVM_PAYEE_ADDRESS: import_zod.z.string().refine(isEvmAddress, {
+    params: { code: "invalid_x402_payee", ...x402 },
+    message: "EVM_PAYEE_ADDRESS must be a 0x-prefixed 20-byte EVM address \u2014 the wallet that receives x402 and MPP payments."
+  }).refine((v) => !isPlaceholderEvm(v), {
+    params: { code: "placeholder_payee", ...x402 },
+    message: "EVM_PAYEE_ADDRESS is the zero address (0x000\u2026000) \u2014 payments to this address are unrecoverable. Set it to a wallet you control."
+  }).optional(),
+  CDP_API_KEY_ID: import_zod.z.string().optional(),
+  CDP_API_KEY_SECRET: import_zod.z.string().optional(),
+  SOLANA_PAYEE_ADDRESS: import_zod.z.string().refine(isSolanaAddress, {
+    params: { code: "invalid_solana_payee", ...x402 },
+    message: "SOLANA_PAYEE_ADDRESS must be a base58 Solana address (32\u201344 chars). When set, the router also accepts Solana payments."
+  }).optional(),
+  SOLANA_FACILITATOR_URL: import_zod.z.string().refine(isUrl, {
+    params: { code: "invalid_solana_facilitator_url", ...x402 },
+    message: "SOLANA_FACILITATOR_URL must be a valid URL \u2014 override for the Solana x402 facilitator. Defaults to DEFAULT_SOLANA_FACILITATOR_URL."
+  }).optional(),
+  MPP_SECRET_KEY: import_zod.z.string().optional(),
+  MPP_CURRENCY: import_zod.z.string().refine(isEvmAddress, {
+    params: { code: "invalid_mpp_currency", ...mpp },
+    message: "MPP_CURRENCY must be a 0x-prefixed 20-byte Tempo currency address \u2014 the token contract MPP charges in. Use TEMPO_USDC_ADDRESS for Tempo USDC."
+  }).optional(),
+  TEMPO_RPC_URL: import_zod.z.string().refine(isUrl, {
+    params: { code: "invalid_mpp_rpc_url", ...mpp },
+    message: "TEMPO_RPC_URL must be a valid URL \u2014 authenticated Tempo JSON-RPC endpoint. Public rpc.tempo.xyz returns 401."
+  }).optional(),
+  MPP_OPERATOR_KEY: import_zod.z.string().refine(isEvmPrivateKey, {
+    params: { code: "invalid_mpp_operator_key", ...mpp },
+    message: "MPP_OPERATOR_KEY must be a 0x-prefixed 32-byte EVM private key \u2014 signs server-side close/settle; presence enables MPP session mode."
+  }).optional(),
+  MPP_FEE_PAYER_KEY: import_zod.z.string().refine(isEvmPrivateKey, {
+    params: { code: "invalid_mpp_fee_payer_key", ...mpp },
+    message: "MPP_FEE_PAYER_KEY must be a 0x-prefixed 32-byte EVM private key \u2014 sponsors client gas for channel open/topUp. Must resolve to a different address than MPP_OPERATOR_KEY."
+  }).optional(),
+  KV_REST_API_URL: import_zod.z.string().optional(),
+  KV_REST_API_TOKEN: import_zod.z.string().optional(),
+  NODE_ENV: import_zod.z.string().optional()
+};
+var ENV_KEYS = Object.keys(envShape);
+var EnvInputSchema = import_zod.z.object(envShape).passthrough().superRefine((env, ctx) => {
+  if (env.BASE_URL === void 0) {
+    addIssue(
+      ctx,
+      { code: "missing_base_url" },
+      "BASE_URL is required \u2014 the public origin used as the 402 realm, OpenAPI server URL, and MPP memo prefix. Set it to your production domain.",
+      ["BASE_URL"]
+    );
+  }
+  if (env.EVM_PAYEE_ADDRESS === void 0) {
+    addIssue(
+      ctx,
+      { code: "missing_x402_payee", ...x402 },
+      "EVM_PAYEE_ADDRESS is required \u2014 the EVM address that receives x402 and MPP payments.",
+      ["EVM_PAYEE_ADDRESS"]
+    );
+  }
+  if (env.MPP_SECRET_KEY) {
+    if (env.MPP_CURRENCY === void 0) {
+      addIssue(
+        ctx,
+        { code: "missing_mpp_currency", ...mpp },
+        "MPP_CURRENCY is required when MPP is enabled \u2014 the Tempo currency address MPP charges in. Use TEMPO_USDC_ADDRESS for Tempo USDC.",
+        ["MPP_CURRENCY"]
+      );
+    }
+    if (env.TEMPO_RPC_URL === void 0) {
+      addIssue(
+        ctx,
+        { code: "missing_mpp_rpc_url", ...mpp },
+        "TEMPO_RPC_URL is required when MPP is enabled \u2014 authenticated Tempo JSON-RPC endpoint. Public rpc.tempo.xyz returns 401.",
+        ["TEMPO_RPC_URL"]
+      );
+    }
+  }
+  const collision = operatorAddressesCollide(env.MPP_OPERATOR_KEY, env.MPP_FEE_PAYER_KEY);
+  if (collision) {
+    addIssue(
+      ctx,
+      { code: "mpp_operator_equals_fee_payer", ...mpp },
+      `MPP_OPERATOR_KEY and MPP_FEE_PAYER_KEY resolve to the same address (${collision}). Tempo rejects fee-delegated txs with sender === feePayer. Use two distinct wallets, or unset MPP_FEE_PAYER_KEY to let clients pay their own gas.`,
+      ["MPP_FEE_PAYER_KEY"]
+    );
+  }
+});
+function collectKvWarnings(env, kvStoreOptionProvided) {
+  if (kvStoreOptionProvided) return [];
+  const warn = (code, message) => ({
+    code,
+    severity: "warning",
+    message
+  });
+  if (env.KV_REST_API_URL && !env.KV_REST_API_TOKEN) {
     return [
-      {
-        code: "missing_x402_accepts",
-        protocol: "x402",
-        message: "x402 requires at least one accept configuration."
-      }
+      warn(
+        "kv_url_without_token",
+        "KV_REST_API_URL is set but KV_REST_API_TOKEN is missing \u2014 falling back to in-memory KV (unsafe in serverless production)."
+      )
     ];
   }
-  const args = { config, accepts, env, options };
-  return CHECKS.map((check) => check(args)).filter(
-    (issue) => issue !== null
-  );
-}
-function checkAcceptNetworkPresent({ accepts }) {
-  return accepts.some((accept) => !accept.network) ? { code: "missing_x402_network", protocol: "x402", message: "x402 accepts require a network." } : null;
-}
-function checkAcceptNetworkSupported({ accepts }) {
-  const unsupported = accepts.find(
-    (accept) => accept.network && !isSupportedX402Network(accept.network)
-  );
-  if (!unsupported) return null;
-  return {
-    code: "unsupported_x402_network",
-    protocol: "x402",
-    message: `unsupported x402 network '${unsupported.network}'. Use eip155:* or solana:*.`
-  };
-}
-function checkNonExactRequiresAsset({ accepts }) {
-  return accepts.some((accept) => (accept.scheme ?? "exact") !== "exact" && !accept.asset) ? {
-    code: "missing_x402_asset",
-    protocol: "x402",
-    message: "non-exact x402 accepts require an asset."
-  } : null;
+  if (env.KV_REST_API_TOKEN && !env.KV_REST_API_URL) {
+    return [
+      warn(
+        "kv_token_without_url",
+        "KV_REST_API_TOKEN is set but KV_REST_API_URL is missing \u2014 falling back to in-memory KV (unsafe in serverless production)."
+      )
+    ];
+  }
+  if (env.KV_REST_API_URL && env.KV_REST_API_TOKEN && !isUrl(env.KV_REST_API_URL)) {
+    return [
+      warn(
+        "invalid_kv_url",
+        `KV_REST_API_URL is not a valid URL \u2014 KV calls will fail at request time. Got: ${env.KV_REST_API_URL}`
+      )
+    ];
+  }
+  if (!env.KV_REST_API_URL && !env.KV_REST_API_TOKEN && env.NODE_ENV === "production") {
+    return [
+      warn(
+        "missing_kv_in_production",
+        "No KV_REST_API_URL/KV_REST_API_TOKEN set in production \u2014 using the in-memory KV store. SIWX nonce, SIWX entitlement, and MPP replay state will be lost across instances. Configure Upstash/Vercel KV or pass a custom kvStore."
+      )
+    ];
+  }
+  return [];
 }
-function checkDecimalsAreValid({ accepts }) {
-  const invalid = accepts.find(
-    (accept) => accept.decimals !== void 0 && (!Number.isInteger(accept.decimals) || accept.decimals < 0)
-  );
-  if (!invalid) return null;
-  return {
-    code: "invalid_x402_decimals",
-    protocol: "x402",
-    message: "x402 accept decimals must be a non-negative integer."
-  };
+function getConfiguredX402Accepts2(config) {
+  if (config.x402?.accepts?.length) return [...config.x402.accepts];
+  return [
+    {
+      scheme: "exact",
+      network: config.network ?? BASE_MAINNET_NETWORK,
+      payTo: config.payeeAddress
+    }
+  ];
 }
-function checkPayee({ config, accepts }) {
-  if (config.payeeAddress) return null;
-  return accepts.some((accept) => !accept.payTo) ? {
-    code: "missing_x402_payee",
-    protocol: "x402",
-    message: "x402 requires payeeAddress in router config or payTo on every x402 accept."
-  } : null;
-}
-function checkPlaceholderPayeeAddress({
-  config,
-  accepts
-}) {
-  const placeholder = findPlaceholderPayee([
+function validateX402Config(config, env, options) {
+  const accepts = getConfiguredX402Accepts2(config);
+  const issues = [];
+  const push = (code, message) => issues.push({ code, protocol: "x402", message });
+  if (accepts.length === 0) {
+    push("missing_x402_accepts", "x402 requires at least one accept configuration.");
+    return issues;
+  }
+  if (accepts.some((a) => !a.network)) {
+    push("missing_x402_network", "x402 accepts require a network.");
+  }
+  const unsupported = accepts.find((a) => a.network && !isX402Network(a.network));
+  if (unsupported) {
+    push(
+      "unsupported_x402_network",
+      `unsupported x402 network '${unsupported.network}'. Use eip155:* or solana:*.`
+    );
+  }
+  if (accepts.some((a) => (a.scheme ?? "exact") !== "exact" && !a.asset)) {
+    push("missing_x402_asset", "non-exact x402 accepts require an asset.");
+  }
+  if (accepts.some(
+    (a) => a.decimals !== void 0 && (!Number.isInteger(a.decimals) || a.decimals < 0)
+  )) {
+    push("invalid_x402_decimals", "x402 accept decimals must be a non-negative integer.");
+  }
+  if (!config.payeeAddress && accepts.some((a) => !a.payTo)) {
+    push(
+      "missing_x402_payee",
+      "x402 requires payeeAddress in router config or payTo on every x402 accept."
+    );
+  }
+  const placeholder = [
     config.payeeAddress,
-    ...accepts.map((accept) => typeof accept.payTo === "string" ? accept.payTo : void 0)
-  ]);
-  if (!placeholder) return null;
-  return {
-    code: "placeholder_payee",
-    protocol: "x402",
-    message: `x402 payee '${placeholder}' is a placeholder address and cannot receive payments.`
-  };
-}
-function checkCdpKeys({ config, env, options }) {
-  if (options.requireCdpKeys === false) return null;
-  if (!usesDefaultEvmFacilitator(config)) return null;
-  const missing = [
-    env.CDP_API_KEY_ID ? null : "CDP_API_KEY_ID",
-    env.CDP_API_KEY_SECRET ? null : "CDP_API_KEY_SECRET"
-  ].filter(Boolean);
-  if (missing.length === 0) return null;
-  return {
-    code: "missing_cdp_keys",
-    protocol: "x402",
-    message: `default EVM x402 facilitator requires ${missing.join(" and ")}.`
-  };
+    ...accepts.map((a) => typeof a.payTo === "string" ? a.payTo : void 0)
+  ].find((v) => v !== void 0 && isPlaceholderEvm(v));
+  if (placeholder) {
+    push(
+      "placeholder_payee",
+      `x402 payee '${placeholder}' is a placeholder address and cannot receive payments.`
+    );
+  }
+  if (options.requireCdpKeys !== false) {
+    const hasEvm = accepts.some(
+      (a) => typeof a.network === "string" && a.network.startsWith("eip155:")
+    );
+    if (hasEvm) {
+      const missing = ["CDP_API_KEY_ID", "CDP_API_KEY_SECRET"].filter((k) => !env[k]);
+      if (missing.length > 0) {
+        push(
+          "missing_cdp_keys",
+          `x402 EVM facilitator (Coinbase) requires ${missing.join(" and ")}.`
+        );
+      }
+    }
+  }
+  return issues;
 }
-
-// src/config/validators/mpp.ts
-var import_accounts = require("viem/accounts");
-var CHECKS2 = [
-  checkSecretKey,
-  checkCurrency,
-  checkRecipient,
-  checkPlaceholderRecipient,
-  checkRpcUrl,
-  checkFeePayerKey,
-  checkOperatorKey,
-  checkOperatorMatchesFeePayer
-];
-function validateMppConfig(config, env) {
-  const mpp = config.mpp;
-  if (!mpp) {
+function validateMppConfig(config) {
+  const m = config.mpp;
+  if (!m) {
     return [
       {
         code: "missing_mpp_config",
@@ -4191,109 +4360,184 @@ function validateMppConfig(config, env) {
       }
     ];
   }
-  const args = { config, mpp, env };
-  return CHECKS2.map((check) => check(args)).filter(
-    (issue) => issue !== null
+  const issues = [];
+  const push = (code, message) => issues.push({ code, protocol: "mpp", message });
+  if (!m.secretKey) {
+    push(
+      "missing_mpp_secret_key",
+      "MPP requires secretKey. Set MPP_SECRET_KEY or pass mpp.secretKey."
+    );
+  }
+  if (!m.currency) {
+    push("missing_mpp_currency", "MPP requires currency. Set MPP_CURRENCY or pass mpp.currency.");
+  } else if (!isEvmAddress(m.currency)) {
+    push(
+      "invalid_mpp_currency",
+      "MPP currency must be a 0x-prefixed 20-byte Tempo currency address. Use TEMPO_USDC_ADDRESS for Tempo USDC."
+    );
+  }
+  const recipient = m.recipient ?? config.payeeAddress;
+  if (!recipient) {
+    push(
+      "missing_mpp_recipient",
+      "MPP requires a recipient address. Set mpp.recipient or payeeAddress in your router config."
+    );
+  } else if (!isEvmAddress(recipient)) {
+    push(
+      "invalid_mpp_recipient",
+      "MPP recipient must be a 0x-prefixed EVM address. Solana recipients require x402."
+    );
+  }
+  const placeholder = [m.recipient, config.payeeAddress].find(
+    (v) => typeof v === "string" && isPlaceholderEvm(v)
   );
-}
-function checkSecretKey({ mpp }) {
-  if (mpp.secretKey) return null;
-  return {
-    code: "missing_mpp_secret_key",
-    protocol: "mpp",
-    message: "MPP requires secretKey. Set MPP_SECRET_KEY or pass mpp.secretKey."
-  };
-}
-function checkCurrency({ mpp }) {
-  if (!mpp.currency) {
-    return {
-      code: "missing_mpp_currency",
-      protocol: "mpp",
-      message: "MPP requires currency. Set MPP_CURRENCY or pass mpp.currency."
-    };
+  if (placeholder) {
+    push(
+      "placeholder_payee",
+      `MPP recipient '${placeholder}' is a placeholder address and cannot receive payments.`
+    );
   }
-  if (!isEvmAddress(mpp.currency)) {
-    return {
-      code: "invalid_mpp_currency",
-      protocol: "mpp",
-      message: "MPP currency must be a 0x-prefixed 20-byte Tempo currency address. Use TEMPO_USDC_CURRENCY for Tempo USDC."
-    };
+  if (!m.rpcUrl) {
+    push(
+      "missing_mpp_rpc_url",
+      "MPP requires an authenticated Tempo RPC URL. Set TEMPO_RPC_URL env var or pass rpcUrl in the mpp config object."
+    );
   }
-  return null;
+  if (m.feePayerKey && !isEvmPrivateKey(m.feePayerKey)) {
+    push(
+      "invalid_mpp_fee_payer_key",
+      "MPP feePayerKey must be a 0x-prefixed 32-byte EVM private key."
+    );
+  }
+  if (m.operatorKey && !isEvmPrivateKey(m.operatorKey)) {
+    push(
+      "invalid_mpp_operator_key",
+      "MPP operatorKey must be a 0x-prefixed 32-byte EVM private key."
+    );
+  }
+  const collision = operatorAddressesCollide(m.operatorKey, m.feePayerKey);
+  if (collision) {
+    push(
+      "mpp_operator_equals_fee_payer",
+      `MPP operatorKey and feePayerKey resolve to the same address (${collision}). Tempo rejects fee-delegated txs with sender === feePayer, so channel close/settle would fail at runtime. Either use two distinct wallets, or omit feePayerKey to disable gas sponsorship (clients then pay their own gas).`
+    );
+  }
+  return issues;
 }
-function checkRecipient({ config, mpp }) {
-  const recipient = mpp.recipient ?? config.payeeAddress;
-  if (!recipient) {
+function translateZodIssues(error) {
+  return error.issues.map((issue) => {
+    const params = issue.params;
+    if (!params?.code) {
+      throw new Error(
+        `[router] schema issue missing params.code (path=${issue.path.join(".")}, message=${issue.message}). Every refinement / addIssue call must set params.code.`
+      );
+    }
     return {
-      code: "missing_mpp_recipient",
-      protocol: "mpp",
-      message: "MPP requires a recipient address. Set mpp.recipient or payeeAddress in your router config."
+      code: params.code,
+      message: issue.message,
+      ...params.protocol ? { protocol: params.protocol } : {},
+      ...params.severity ? { severity: params.severity } : {}
     };
+  });
+}
+function routerConfigFromEnv(options) {
+  const rawEnv = options.env ?? process.env;
+  const env = trimAll(rawEnv);
+  const optionIssues = [];
+  if (!options.title?.trim()) {
+    optionIssues.push({
+      code: "missing_discovery_title",
+      message: "discovery `title` is required. Pass a short product name."
+    });
   }
-  if (!isEvmAddress(recipient)) {
-    return {
-      code: "invalid_mpp_recipient",
-      protocol: "mpp",
-      message: "MPP recipient must be a 0x-prefixed EVM address. Solana recipients require x402."
-    };
+  if (!options.description?.trim()) {
+    optionIssues.push({
+      code: "missing_discovery_description",
+      message: "discovery `description` is required. One sentence is enough."
+    });
   }
-  return null;
-}
-function checkPlaceholderRecipient({ config, mpp }) {
-  const placeholder = findPlaceholderPayee([mpp.recipient, config.payeeAddress]);
-  if (!placeholder) return null;
-  return {
-    code: "placeholder_payee",
-    protocol: "mpp",
-    message: `MPP recipient '${placeholder}' is a placeholder address and cannot receive payments.`
-  };
-}
-function checkRpcUrl({ mpp, env }) {
-  if (mpp.rpcUrl ?? env.TEMPO_RPC_URL) return null;
-  return {
-    code: "missing_mpp_rpc_url",
-    protocol: "mpp",
-    message: "MPP requires an authenticated Tempo RPC URL. Set TEMPO_RPC_URL env var or pass rpcUrl in the mpp config object."
-  };
-}
-function checkFeePayerKey({ mpp }) {
-  if (!mpp.feePayerKey || isEvmPrivateKey(mpp.feePayerKey)) return null;
-  return {
-    code: "invalid_mpp_fee_payer_key",
-    protocol: "mpp",
-    message: "MPP feePayerKey must be a 0x-prefixed 32-byte EVM private key."
-  };
-}
-function checkOperatorKey({ mpp }) {
-  if (!mpp.operatorKey || isEvmPrivateKey(mpp.operatorKey)) return null;
-  return {
-    code: "invalid_mpp_operator_key",
-    protocol: "mpp",
-    message: "MPP operatorKey must be a 0x-prefixed 32-byte EVM private key."
-  };
-}
-function checkOperatorMatchesFeePayer({ mpp }) {
-  if (!mpp.operatorKey || !mpp.feePayerKey) return null;
-  if (!isEvmPrivateKey(mpp.operatorKey) || !isEvmPrivateKey(mpp.feePayerKey)) return null;
-  const opAddr = (0, import_accounts.privateKeyToAccount)(mpp.operatorKey).address.toLowerCase();
-  const fpAddr = (0, import_accounts.privateKeyToAccount)(mpp.feePayerKey).address.toLowerCase();
-  if (opAddr !== fpAddr) return null;
+  if (options.guidance === void 0) {
+    optionIssues.push({
+      code: "missing_discovery_guidance",
+      message: "discovery `guidance` is required. Provide an empty string to opt out of `/llms.txt`."
+    });
+  }
+  if (options.serverUrl !== void 0 && !isUrl(options.serverUrl)) {
+    optionIssues.push({
+      code: "invalid_server_url",
+      message: `discovery \`serverUrl\` must be a valid URL. Got: ${options.serverUrl}`
+    });
+  }
+  const parsed = EnvInputSchema.safeParse(env);
+  const envIssues = parsed.success ? [] : translateZodIssues(parsed.error);
+  const issues = [...envIssues, ...optionIssues];
+  if (issues.length > 0) throw new RouterConfigError(issues);
+  for (const warning of collectKvWarnings(env, options.kvStore !== void 0)) {
+    console.warn(`[router] ${warning.message}`);
+  }
+  const payeeAddress = canonicalizeEvm(env.EVM_PAYEE_ADDRESS);
+  const accepts = [
+    { scheme: "exact", network: BASE_MAINNET_NETWORK, payTo: payeeAddress },
+    {
+      scheme: "upto",
+      network: BASE_MAINNET_NETWORK,
+      payTo: payeeAddress,
+      asset: BASE_USDC_ADDRESS,
+      decimals: BASE_USDC_DECIMALS
+    }
+  ];
+  if (env.SOLANA_PAYEE_ADDRESS) {
+    accepts.push({
+      scheme: "exact",
+      network: SOLANA_MAINNET_NETWORK,
+      payTo: env.SOLANA_PAYEE_ADDRESS
+    });
+  }
+  const configuredSolanaFacilitator = options.x402Facilitators?.solana;
+  const solanaFacilitator = typeof configuredSolanaFacilitator === "string" ? configuredSolanaFacilitator : configuredSolanaFacilitator ?? env.SOLANA_FACILITATOR_URL ?? DEFAULT_SOLANA_FACILITATOR_URL;
+  const mppEnabled = options.protocols?.includes("mpp") ?? Boolean(env.MPP_SECRET_KEY);
+  const protocols = options.protocols ? [...options.protocols] : mppEnabled ? ["x402", "mpp"] : ["x402"];
+  const mppConfig = mppEnabled ? {
+    secretKey: env.MPP_SECRET_KEY,
+    currency: canonicalizeEvm(env.MPP_CURRENCY),
+    rpcUrl: env.TEMPO_RPC_URL,
+    recipient: payeeAddress,
+    ...env.MPP_FEE_PAYER_KEY ? { feePayerKey: env.MPP_FEE_PAYER_KEY } : {},
+    ...env.MPP_OPERATOR_KEY ? { operatorKey: env.MPP_OPERATOR_KEY, session: {} } : {}
+  } : void 0;
   return {
-    code: "mpp_operator_equals_fee_payer",
-    protocol: "mpp",
-    message: `MPP operatorKey and feePayerKey resolve to the same address (${opAddr}). Tempo rejects fee-delegated txs with sender === feePayer, so channel close/settle would fail at runtime. Either use two distinct wallets, or omit feePayerKey to disable gas sponsorship (clients then pay their own gas).`
+    payeeAddress,
+    baseUrl: env.BASE_URL,
+    network: BASE_MAINNET_NETWORK,
+    protocols,
+    x402: {
+      accepts,
+      facilitators: {
+        ...options.x402Facilitators,
+        solana: solanaFacilitator
+      }
+    },
+    ...mppConfig ? { mpp: mppConfig } : {},
+    discovery: {
+      title: options.title,
+      version: options.version ?? "1.0.0",
+      description: options.description,
+      guidance: options.guidance,
+      ...options.contact ? { contact: options.contact } : {},
+      ...options.ownershipProofs ? { ownershipProofs: options.ownershipProofs } : {},
+      ...options.methodHints ? { methodHints: options.methodHints } : {},
+      ...options.serverUrl ? { serverUrl: options.serverUrl } : {}
+    },
+    ...options.prices ? { prices: options.prices } : {},
+    ...options.plugin ? { plugin: options.plugin } : {},
+    ...options.kvStore ? { kvStore: options.kvStore } : {},
+    strictRoutes: options.strictRoutes ?? false
   };
 }
-
-// src/config/validate.ts
-function validateRouterConfig(config, options = {}) {
-  const issues = getRouterConfigIssues(config, options);
-  if (issues.length > 0) throw new RouterConfigError(issues);
-}
 function getRouterConfigIssues(config, options = {}) {
-  const env = options.env ?? process.env;
-  const issues = [];
+  const env = options.env ?? {};
   const protocols = config.protocols ?? ["x402"];
+  const issues = [];
   if (!config.baseUrl) {
     issues.push({
       code: "missing_base_url",
@@ -4306,84 +4550,17 @@ function getRouterConfigIssues(config, options = {}) {
       message: "RouterConfig.protocols cannot be empty. Omit the field to use default ['x402'] or specify protocols explicitly."
     });
   }
-  if (protocols.includes("x402")) {
-    issues.push(...validateX402Config(config, env, options));
-  }
-  if (protocols.includes("mpp")) {
-    issues.push(...validateMppConfig(config, env));
-  }
+  if (protocols.includes("x402")) issues.push(...validateX402Config(config, env, options));
+  if (protocols.includes("mpp")) issues.push(...validateMppConfig(config));
   return issues;
 }
 
-// src/config/env.ts
-init_constants();
-function mppFromEnv(env, options = {}) {
-  const secretKey = env.MPP_SECRET_KEY;
-  const currency = env.MPP_CURRENCY;
-  const rpcUrl = env.TEMPO_RPC_URL;
-  const feePayerKey = options.feePayerKey ?? env.MPP_FEE_PAYER_KEY;
-  const feePayerKeySource = options.feePayerKey !== void 0 ? "feePayerKey" : "MPP_FEE_PAYER_KEY";
-  const hasAnyMppEnv = Boolean(secretKey || currency || rpcUrl || options.require);
-  if (!hasAnyMppEnv) return void 0;
-  const missing = [
-    secretKey ? null : "MPP_SECRET_KEY",
-    currency ? null : "MPP_CURRENCY",
-    rpcUrl ? null : "TEMPO_RPC_URL"
-  ].filter(Boolean);
-  if (missing.length > 0) {
-    throw new Error(`MPP env is incomplete. Missing: ${missing.join(", ")}`);
-  }
-  if (!isEvmAddress(currency)) {
-    throw new Error("MPP_CURRENCY must be a 0x-prefixed 20-byte Tempo currency address");
-  }
-  if (options.recipient && !isEvmAddress(options.recipient)) {
-    throw new Error("MPP recipient must be a 0x-prefixed EVM address");
-  }
-  if (feePayerKey && !isEvmPrivateKey(feePayerKey)) {
-    throw new Error(`${feePayerKeySource} must be a 0x-prefixed 32-byte EVM private key`);
-  }
-  return {
-    secretKey,
-    currency,
-    rpcUrl,
-    ...options.recipient ? { recipient: options.recipient } : {},
-    ...feePayerKey ? { feePayerKey } : {}
-  };
-}
-function x402AcceptsFromEnv(env, options = {}) {
-  const payeeEnv = options.payeeEnv ?? "X402_WALLET_ADDRESS";
-  const solanaPayeeEnv = options.solanaPayeeEnv ?? "SOLANA_PAYEE_ADDRESS";
-  const payeeAddress = options.payeeAddress ?? env[payeeEnv];
-  if (!payeeAddress) {
-    throw new Error(`${payeeEnv} is required to build x402 accepts`);
-  }
-  const accepts = [
-    {
-      scheme: "exact",
-      network: options.network ?? BASE_NETWORK,
-      payTo: payeeAddress
-    }
-  ];
-  const solanaPayeeAddress = options.solanaPayeeAddress ?? env[solanaPayeeEnv];
-  if (solanaPayeeAddress) {
-    accepts.push({
-      scheme: "exact",
-      network: SOLANA_MAINNET_NETWORK,
-      payTo: solanaPayeeAddress
-    });
-  }
-  return accepts;
-}
-function paidOptionsForProtocols(protocols) {
-  return { protocols: [...protocols] };
-}
-
 // 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_server(), server_exports));
-    const result = await createX402Server2(config);
+    const { createX402Server: createX402Server2 } = await Promise.resolve().then(() => (init_x402_server(), x402_server_exports));
+    const result = await createX402Server2(config, kvStore);
     await result.initPromise;
     return {
       server: result.server,
@@ -4394,7 +4571,7 @@ async function initX402(config, configError) {
   }
 }
 
-// src/mppx-init.ts
+// src/init/mppx.ts
 function getMppxRequestContext(args) {
   const {
     Mppx,
@@ -4516,9 +4693,10 @@ function createRouter(config) {
   const kvStore = resolveKvStore(config.kvStore);
   const nonceStore = kvStore ? createKvNonceStore(kvStore) : new MemoryNonceStore();
   const entitlementStore = kvStore ? createKvEntitlementStore(kvStore) : new MemoryEntitlementStore();
-  const network = config.network ?? BASE_NETWORK;
+  const network = config.network ?? BASE_MAINNET_NETWORK;
   const x402Accepts = getConfiguredX402Accepts(config);
   const configIssues = getRouterConfigIssues(config, {
+    env: process.env,
     requireCdpKeys: process.env.NODE_ENV === "production"
   });
   const baseUrlIssue = configIssues.find((issue) => issue.code === "missing_base_url");
@@ -4565,7 +4743,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;
@@ -4594,11 +4772,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);
       }
@@ -4641,30 +4818,22 @@ function normalizePath(path) {
   normalized = normalized.replace(/^api\/+/, "");
   return normalized.replace(/\/+$/, "");
 }
+function createRouterFromEnv(options) {
+  return createRouter(routerConfigFromEnv(options));
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  BASE_NETWORK,
+  BASE_MAINNET_NETWORK,
+  BASE_USDC_ADDRESS,
+  BASE_USDC_DECIMALS,
+  DEFAULT_SOLANA_FACILITATOR_URL,
   HttpError,
-  MemoryEntitlementStore,
-  MemoryNonceStore,
-  RouteBuilder,
-  RouteRegistry,
   RouterConfigError,
-  SIWX_CHALLENGE_EXPIRY_MS,
-  SIWX_ERROR_MESSAGES,
   SOLANA_MAINNET_NETWORK,
-  TEMPO_USDC_CURRENCY,
+  TEMPO_USDC_ADDRESS,
+  TEMPO_USDC_DECIMALS,
   ZERO_EVM_ADDRESS,
-  consolePlugin,
-  createKvEntitlementStore,
-  createKvMppStore,
-  createKvNonceStore,
   createRouter,
-  formatRouterConfigIssues,
-  getRouterConfigIssues,
-  mppFromEnv,
-  paidOptionsForProtocols,
-  validateRouterConfig,
-  withPrefix,
-  x402AcceptsFromEnv
+  createRouterFromEnv,
+  routerConfigFromEnv
 });