@agentcash/router 0.5.1 → 0.6.0

package/dist/index.cjs

@@ -43,25 +43,26 @@ async function createX402Server(config) {
   const { facilitator: defaultFacilitator } = await import("@coinbase/x402");
   const raw = config.facilitatorUrl ?? defaultFacilitator;
   const facilitatorConfig = typeof raw === "string" ? { url: raw } : raw;
-  const client = new HTTPFacilitatorClient(facilitatorConfig);
+  const httpClient = new HTTPFacilitatorClient(facilitatorConfig);
+  const network = config.network ?? "eip155:8453";
+  const client = cachedClient(httpClient, network);
   const server = new x402ResourceServer(client);
   registerExactEvmScheme(server);
   server.registerExtension(bazaarResourceServerExtension);
   server.registerExtension(siwxResourceServerExtension);
-  const initPromise = retryInit(server);
+  const initPromise = server.initialize();
   return { server, initPromise };
 }
-async function retryInit(server, maxAttempts = 3, backoff = [1e3, 2e3, 4e3]) {
-  for (let attempt = 0; attempt < maxAttempts; attempt++) {
-    try {
-      await server.initialize();
-      return;
-    } catch (err) {
-      const is429 = err instanceof Error && (err.message.includes("429") || err.message.includes("rate limit"));
-      if (!is429 || attempt === maxAttempts - 1) throw err;
-      await new Promise((r) => setTimeout(r, backoff[attempt] ?? 4e3));
-    }
-  }
+function cachedClient(inner, network) {
+  return {
+    verify: inner.verify.bind(inner),
+    settle: inner.settle.bind(inner),
+    getSupported: async () => ({
+      kinds: [{ x402Version: 2, scheme: "exact", network }],
+      extensions: [],
+      signers: {}
+    })
+  };
 }
 var init_server = __esm({
   "src/server.ts"() {
@@ -503,6 +504,11 @@ function extractBearerToken(header) {
 }
 
 // src/orchestrate.ts
+async function resolvePayTo(routeEntry, request, fallback) {
+  if (!routeEntry.payTo) return fallback;
+  if (typeof routeEntry.payTo === "string") return routeEntry.payTo;
+  return routeEntry.payTo(request);
+}
 function createRequestHandler(routeEntry, handler, deps) {
   async function invoke(request, meta, pluginCtx, wallet, account, parsedBody) {
     const ctx = {
@@ -765,12 +771,13 @@ function createRequestHandler(routeEntry, handler, deps) {
         console.error(`[router] ${routeEntry.key}: ${reason}`);
         return fail(500, reason, meta, pluginCtx);
       }
+      const payTo = await resolvePayTo(routeEntry, request, deps.payeeAddress);
       const verify = await verifyX402Payment(
         deps.x402Server,
         request,
         routeEntry,
         price,
-        deps.payeeAddress,
+        payTo,
         deps.network
       );
       if (!verify?.valid) return await build402(request, routeEntry, deps, meta, pluginCtx);
@@ -1008,22 +1015,27 @@ async function build402(request, routeEntry, deps, meta, pluginCtx, bodyData) {
   }
   if (routeEntry.protocols.includes("x402") && deps.x402Server) {
     try {
+      const payTo = await resolvePayTo(routeEntry, request, deps.payeeAddress);
       const { encoded } = await buildX402Challenge(
         deps.x402Server,
         routeEntry,
         request,
         challengePrice,
-        deps.payeeAddress,
+        payTo,
         deps.network,
         extensions
       );
       response.headers.set("PAYMENT-REQUIRED", encoded);
     } catch (err) {
+      const message = `x402 challenge build failed: ${err instanceof Error ? err.message : String(err)}`;
       firePluginHook(deps.plugin, "onAlert", pluginCtx, {
         level: "critical",
-        message: `x402 challenge build failed: ${err instanceof Error ? err.message : String(err)}`,
+        message,
         route: routeEntry.key
       });
+      const errorResponse = import_server2.NextResponse.json({ success: false, error: message }, { status: 500 });
+      firePluginResponse(deps, pluginCtx, meta, errorResponse);
+      return errorResponse;
     }
   }
   if (routeEntry.protocols.includes("mpp") && deps.mppx) {
@@ -1109,6 +1121,8 @@ var RouteBuilder = class {
   /** @internal */
   _minPrice;
   /** @internal */
+  _payTo;
+  /** @internal */
   _bodySchema;
   /** @internal */
   _querySchema;
@@ -1151,6 +1165,7 @@ var RouteBuilder = class {
     if (options?.protocols) next._protocols = options.protocols;
     if (options?.maxPrice) next._maxPrice = options.maxPrice;
     if (options?.minPrice) next._minPrice = options.minPrice;
+    if (options?.payTo) next._payTo = options.payTo;
     if (typeof pricing === "object" && "tiers" in pricing) {
       for (const [tierKey, tierConfig] of Object.entries(pricing.tiers)) {
         if (!tierKey) {
@@ -1288,6 +1303,7 @@ var RouteBuilder = class {
       method: this._method,
       maxPrice: this._maxPrice,
       minPrice: this._minPrice,
+      payTo: this._payTo,
       apiKeyResolver: this._apiKeyResolver,
       providerName: this._providerName,
       providerConfig: this._providerConfig,

package/dist/index.d.cts

@@ -171,6 +171,8 @@ interface PaidOptions {
     protocols?: ProtocolType[];
     maxPrice?: string;
     minPrice?: string;
+    /** Override the payment recipient. String for static, function for dynamic (receives the Request). */
+    payTo?: string | ((request: Request) => string | Promise<string>);
 }
 interface HandlerContext<TBody = undefined, TQuery = undefined> {
     body: TBody;
@@ -220,6 +222,7 @@ interface RouteEntry {
     method: 'GET' | 'POST' | 'DELETE' | 'PUT' | 'PATCH';
     maxPrice?: string;
     minPrice?: string;
+    payTo?: string | ((request: Request) => string | Promise<string>);
     apiKeyResolver?: (key: string) => unknown | Promise<unknown>;
     providerName?: string;
     providerConfig?: ProviderConfig;
@@ -325,6 +328,7 @@ declare class RouteBuilder<TBody = undefined, TQuery = undefined, HasAuth extend
     /** @internal */ _protocols: ProtocolType[];
     /** @internal */ _maxPrice: string | undefined;
     /** @internal */ _minPrice: string | undefined;
+    /** @internal */ _payTo: string | ((request: Request) => string | Promise<string>) | undefined;
     /** @internal */ _bodySchema: ZodType | undefined;
     /** @internal */ _querySchema: ZodType | undefined;
     /** @internal */ _outputSchema: ZodType | undefined;

package/dist/index.d.ts

@@ -171,6 +171,8 @@ interface PaidOptions {
     protocols?: ProtocolType[];
     maxPrice?: string;
     minPrice?: string;
+    /** Override the payment recipient. String for static, function for dynamic (receives the Request). */
+    payTo?: string | ((request: Request) => string | Promise<string>);
 }
 interface HandlerContext<TBody = undefined, TQuery = undefined> {
     body: TBody;
@@ -220,6 +222,7 @@ interface RouteEntry {
     method: 'GET' | 'POST' | 'DELETE' | 'PUT' | 'PATCH';
     maxPrice?: string;
     minPrice?: string;
+    payTo?: string | ((request: Request) => string | Promise<string>);
     apiKeyResolver?: (key: string) => unknown | Promise<unknown>;
     providerName?: string;
     providerConfig?: ProviderConfig;
@@ -325,6 +328,7 @@ declare class RouteBuilder<TBody = undefined, TQuery = undefined, HasAuth extend
     /** @internal */ _protocols: ProtocolType[];
     /** @internal */ _maxPrice: string | undefined;
     /** @internal */ _minPrice: string | undefined;
+    /** @internal */ _payTo: string | ((request: Request) => string | Promise<string>) | undefined;
     /** @internal */ _bodySchema: ZodType | undefined;
     /** @internal */ _querySchema: ZodType | undefined;
     /** @internal */ _outputSchema: ZodType | undefined;

package/dist/index.js

@@ -21,25 +21,26 @@ async function createX402Server(config) {
   const { facilitator: defaultFacilitator } = await import("@coinbase/x402");
   const raw = config.facilitatorUrl ?? defaultFacilitator;
   const facilitatorConfig = typeof raw === "string" ? { url: raw } : raw;
-  const client = new HTTPFacilitatorClient(facilitatorConfig);
+  const httpClient = new HTTPFacilitatorClient(facilitatorConfig);
+  const network = config.network ?? "eip155:8453";
+  const client = cachedClient(httpClient, network);
   const server = new x402ResourceServer(client);
   registerExactEvmScheme(server);
   server.registerExtension(bazaarResourceServerExtension);
   server.registerExtension(siwxResourceServerExtension);
-  const initPromise = retryInit(server);
+  const initPromise = server.initialize();
   return { server, initPromise };
 }
-async function retryInit(server, maxAttempts = 3, backoff = [1e3, 2e3, 4e3]) {
-  for (let attempt = 0; attempt < maxAttempts; attempt++) {
-    try {
-      await server.initialize();
-      return;
-    } catch (err) {
-      const is429 = err instanceof Error && (err.message.includes("429") || err.message.includes("rate limit"));
-      if (!is429 || attempt === maxAttempts - 1) throw err;
-      await new Promise((r) => setTimeout(r, backoff[attempt] ?? 4e3));
-    }
-  }
+function cachedClient(inner, network) {
+  return {
+    verify: inner.verify.bind(inner),
+    settle: inner.settle.bind(inner),
+    getSupported: async () => ({
+      kinds: [{ x402Version: 2, scheme: "exact", network }],
+      extensions: [],
+      signers: {}
+    })
+  };
 }
 var init_server = __esm({
   "src/server.ts"() {
@@ -466,6 +467,11 @@ function extractBearerToken(header) {
 }
 
 // src/orchestrate.ts
+async function resolvePayTo(routeEntry, request, fallback) {
+  if (!routeEntry.payTo) return fallback;
+  if (typeof routeEntry.payTo === "string") return routeEntry.payTo;
+  return routeEntry.payTo(request);
+}
 function createRequestHandler(routeEntry, handler, deps) {
   async function invoke(request, meta, pluginCtx, wallet, account, parsedBody) {
     const ctx = {
@@ -728,12 +734,13 @@ function createRequestHandler(routeEntry, handler, deps) {
         console.error(`[router] ${routeEntry.key}: ${reason}`);
         return fail(500, reason, meta, pluginCtx);
       }
+      const payTo = await resolvePayTo(routeEntry, request, deps.payeeAddress);
       const verify = await verifyX402Payment(
         deps.x402Server,
         request,
         routeEntry,
         price,
-        deps.payeeAddress,
+        payTo,
         deps.network
       );
       if (!verify?.valid) return await build402(request, routeEntry, deps, meta, pluginCtx);
@@ -971,22 +978,27 @@ async function build402(request, routeEntry, deps, meta, pluginCtx, bodyData) {
   }
   if (routeEntry.protocols.includes("x402") && deps.x402Server) {
     try {
+      const payTo = await resolvePayTo(routeEntry, request, deps.payeeAddress);
       const { encoded } = await buildX402Challenge(
         deps.x402Server,
         routeEntry,
         request,
         challengePrice,
-        deps.payeeAddress,
+        payTo,
         deps.network,
         extensions
       );
       response.headers.set("PAYMENT-REQUIRED", encoded);
     } catch (err) {
+      const message = `x402 challenge build failed: ${err instanceof Error ? err.message : String(err)}`;
       firePluginHook(deps.plugin, "onAlert", pluginCtx, {
         level: "critical",
-        message: `x402 challenge build failed: ${err instanceof Error ? err.message : String(err)}`,
+        message,
         route: routeEntry.key
       });
+      const errorResponse = NextResponse2.json({ success: false, error: message }, { status: 500 });
+      firePluginResponse(deps, pluginCtx, meta, errorResponse);
+      return errorResponse;
     }
   }
   if (routeEntry.protocols.includes("mpp") && deps.mppx) {
@@ -1072,6 +1084,8 @@ var RouteBuilder = class {
   /** @internal */
   _minPrice;
   /** @internal */
+  _payTo;
+  /** @internal */
   _bodySchema;
   /** @internal */
   _querySchema;
@@ -1114,6 +1128,7 @@ var RouteBuilder = class {
     if (options?.protocols) next._protocols = options.protocols;
     if (options?.maxPrice) next._maxPrice = options.maxPrice;
     if (options?.minPrice) next._minPrice = options.minPrice;
+    if (options?.payTo) next._payTo = options.payTo;
     if (typeof pricing === "object" && "tiers" in pricing) {
       for (const [tierKey, tierConfig] of Object.entries(pricing.tiers)) {
         if (!tierKey) {
@@ -1251,6 +1266,7 @@ var RouteBuilder = class {
       method: this._method,
       maxPrice: this._maxPrice,
       minPrice: this._minPrice,
+      payTo: this._payTo,
       apiKeyResolver: this._apiKeyResolver,
       providerName: this._providerName,
       providerConfig: this._providerConfig,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentcash/router",
-  "version": "0.5.1",
+  "version": "0.6.0",
   "description": "Unified route builder for Next.js App Router APIs with x402, MPP, SIWX, and API key auth",
   "type": "module",
   "exports": {