@4mica/x402 1.2.4 → 2.0.0-alpha.2

package/dist/server/express/index.d.ts

@@ -1,27 +1,6 @@
-import { PaywallConfig, PaywallProvider, x402HTTPResourceServer, x402ResourceServer, RoutesConfig, FacilitatorClient } from '@x402/core/server';
-import { SchemeNetworkServer, Network } from '@x402/core/types';
-import { NextFunction, Request, Response } from 'express';
-/**
- * Configuration for payment tab handling
- */
-interface TabConfig {
-    /**
-     * The full URL endpoint for opening payment tabs. This URL is injected into
-     * paymentRequirements.extra and clients use it to open a payment tab.
-     * When a request matches this endpoint's path, the middleware will parse
-     * the request body and call the 4mica facilitator to open a tab.
-     *
-     * @example "https://api.example.com/x402/tab"
-     */
-    advertisedEndpoint: string;
-    /**
-     * The lifetime of the payment tab in seconds. Defines how long the tab
-     * remains valid before expiring.
-     *
-     * @example 3600 // 1 hour
-     */
-    ttlSeconds?: number;
-}
+import { type FacilitatorClient, type PaywallConfig, type PaywallProvider, type RoutesConfig, x402HTTPResourceServer, x402ResourceServer } from '@x402/core/server';
+import type { Network, SchemeNetworkServer } from '@x402/core/types';
+import type { NextFunction, Request, Response } from 'express';
 /**
  * Configuration for registering a payment scheme with a specific network
  */
@@ -41,7 +20,6 @@ export interface SchemeRegistration {
  * Use this when you need to configure HTTP-level hooks.
  *
  * @param httpServer - Pre-configured x402HTTPResourceServer instance
- * @param tabConfig - Configuration for payment tab handling (endpoint URL and TTL)
  * @param paywallConfig - Optional configuration for the built-in paywall UI
  * @param paywall - Optional custom paywall provider (overrides default)
  * @param syncFacilitatorOnStart - Whether to sync with the facilitator on startup (defaults to true)
@@ -49,7 +27,7 @@ export interface SchemeRegistration {
  *
  * @example
  * ```typescript
- * import { paymentMiddlewareFromHTTPServer, x402ResourceServer, x402HTTPResourceServer } from "@x402/express";
+ * import { paymentMiddlewareFromHTTPServer, x402ResourceServer, x402HTTPResourceServer } from "@4mica/x402/server/express";
  *
  * const resourceServer = new x402ResourceServer(facilitatorClient)
  *   .register(NETWORK, new ExactEvmScheme())
@@ -57,12 +35,10 @@ export interface SchemeRegistration {
  * const httpServer = new x402HTTPResourceServer(resourceServer, routes)
  *   .onProtectedRequest(requestHook);
  *
- * app.use(paymentMiddlewareFromHTTPServer(
- *   httpServer,
- *   { advertisedEndpoint: "https://api.example.com/x402/tab" },
- * )); * ```
+ * app.use(paymentMiddlewareFromHTTPServer(httpServer));
+ * ```
  */
-export declare function paymentMiddlewareFromHTTPServer(httpServer: x402HTTPResourceServer, tabConfig: TabConfig, paywallConfig?: PaywallConfig, paywall?: PaywallProvider, syncFacilitatorOnStart?: boolean): (req: Request, res: Response, next: NextFunction) => Promise<void | Response<any, Record<string, any>>>;
+export declare function paymentMiddlewareFromHTTPServer(httpServer: x402HTTPResourceServer, paywallConfig?: PaywallConfig, paywall?: PaywallProvider, syncFacilitatorOnStart?: boolean): (req: Request, res: Response, next: NextFunction) => Promise<void>;
 /**
  * Express payment middleware for x402 protocol (direct server instance).
  *
@@ -72,7 +48,6 @@ export declare function paymentMiddlewareFromHTTPServer(httpServer: x402HTTPReso
  *
  * @param routes - Route configurations for protected endpoints
  * @param server - Pre-configured x402ResourceServer instance
- * @param tabConfig - Configuration for payment tab handling (endpoint URL and TTL)
  * @param paywallConfig - Optional configuration for the built-in paywall UI
  * @param paywall - Optional custom paywall provider (overrides default)
  * @param syncFacilitatorOnStart - Whether to sync with the facilitator on startup (defaults to true)
@@ -80,19 +55,15 @@ export declare function paymentMiddlewareFromHTTPServer(httpServer: x402HTTPReso
  *
  * @example
  * ```typescript
- * import { paymentMiddleware } from "@x402/express";
+ * import { paymentMiddleware } from "@4mica/x402/server/express";
  *
  * const server = new x402ResourceServer(myFacilitatorClient)
  *   .register(NETWORK, new ExactEvmScheme());
  *
- * app.use(paymentMiddleware(
- *   routes,
- *   server,
- *   { advertisedEndpoint: "https://api.example.com/x402/tab" },
- * ));
+ * app.use(paymentMiddleware(routes, server));
  * ```
  */
-export declare function paymentMiddleware(routes: RoutesConfig, server: x402ResourceServer, tabConfig: TabConfig, paywallConfig?: PaywallConfig, paywall?: PaywallProvider, syncFacilitatorOnStart?: boolean): (req: Request, res: Response, next: NextFunction) => Promise<void | Response<any, Record<string, any>>>;
+export declare function paymentMiddleware(routes: RoutesConfig, server: x402ResourceServer, paywallConfig?: PaywallConfig, paywall?: PaywallProvider, syncFacilitatorOnStart?: boolean): (req: Request, res: Response, next: NextFunction) => Promise<void>;
 /**
  * Express payment middleware for x402 protocol (configuration-based).
  *
@@ -100,7 +71,6 @@ export declare function paymentMiddleware(routes: RoutesConfig, server: x402Reso
  * This function creates and configures the x402ResourceServer internally.
  *
  * @param routes - Route configurations for protected endpoints
- * @param tabConfig - Configuration for payment tab handling
  * @param facilitatorClients - Optional facilitator client(s) for payment processing
  * @param schemes - Optional array of scheme registrations for server-side payment processing
  * @param paywallConfig - Optional configuration for the built-in paywall UI
@@ -110,13 +80,10 @@ export declare function paymentMiddleware(routes: RoutesConfig, server: x402Reso
  *
  * @example
  * ```typescript
- * import { paymentMiddlewareFromConfig } from "@x402/express";
+ * import { paymentMiddlewareFromConfig } from "@4mica/x402/server/express";
  *
- * app.use(paymentMiddlewareFromConfig(
- *   routes,
- *   { advertisedEndpoint: "https://api.example.com/x402/tab" },
- * ));
+ * app.use(paymentMiddlewareFromConfig(routes));
  * ```
  */
-export declare function paymentMiddlewareFromConfig(routes: RoutesConfig, tabConfig: TabConfig, facilitatorClients?: FacilitatorClient | FacilitatorClient[], schemes?: SchemeRegistration[], paywallConfig?: PaywallConfig, paywall?: PaywallProvider, syncFacilitatorOnStart?: boolean): (req: Request, res: Response, next: NextFunction) => Promise<void | Response<any, Record<string, any>>>;
+export declare function paymentMiddlewareFromConfig(routes: RoutesConfig, facilitatorClients?: FacilitatorClient | FacilitatorClient[], schemes?: SchemeRegistration[], paywallConfig?: PaywallConfig, paywall?: PaywallProvider, syncFacilitatorOnStart?: boolean): (req: Request, res: Response, next: NextFunction) => Promise<void>;
 export { ExpressAdapter } from './adapter.js';

package/dist/server/express/index.js

@@ -1,14 +1,22 @@
 import { x402HTTPResourceServer, x402ResourceServer, } from '@x402/core/server';
-import { ExpressAdapter } from './adapter.js';
-import { FourMicaEvmScheme, SUPPORTED_NETWORKS } from '../scheme.js';
 import { FourMicaFacilitatorClient } from '../facilitator.js';
+import { FourMicaEvmScheme, SUPPORTED_NETWORKS } from '../scheme.js';
+import { ExpressAdapter } from './adapter.js';
 function getHTTPServerInternals(httpServer) {
     return httpServer;
 }
-function registerNetworkServers(httpServer, tabEndpoint) {
-    const schemeServer = new FourMicaEvmScheme(tabEndpoint);
+/**
+ * Register the default 4mica scheme server for every hosted network, leaving
+ * alone any network the caller already registered one for (for example a
+ * `FourMicaEvmScheme` pointed at a self-hosted core).
+ */
+function registerNetworkServers(httpServer) {
+    const schemeServer = new FourMicaEvmScheme();
     const server = getHTTPServerInternals(httpServer);
     SUPPORTED_NETWORKS.forEach((network) => {
+        const registered = server.ResourceServer.registeredServerSchemes?.get(network);
+        if (registered?.has(schemeServer.scheme))
+            return;
         server.ResourceServer.register(network, schemeServer);
     });
 }
@@ -20,20 +28,12 @@ function checkIfBazaarNeeded(routes) {
         return !!(routeConfig.extensions && 'bazaar' in routeConfig.extensions);
     });
 }
-function isOpenTabHttpError(error) {
-    if (typeof error !== 'object' || error === null) {
-        return false;
-    }
-    const candidate = error;
-    return typeof candidate.status === 'number' && 'response' in candidate;
-}
 /**
  * Express payment middleware for x402 protocol (direct HTTP server instance).
  *
  * Use this when you need to configure HTTP-level hooks.
  *
  * @param httpServer - Pre-configured x402HTTPResourceServer instance
- * @param tabConfig - Configuration for payment tab handling (endpoint URL and TTL)
  * @param paywallConfig - Optional configuration for the built-in paywall UI
  * @param paywall - Optional custom paywall provider (overrides default)
  * @param syncFacilitatorOnStart - Whether to sync with the facilitator on startup (defaults to true)
@@ -41,7 +41,7 @@ function isOpenTabHttpError(error) {
  *
  * @example
  * ```typescript
- * import { paymentMiddlewareFromHTTPServer, x402ResourceServer, x402HTTPResourceServer } from "@x402/express";
+ * import { paymentMiddlewareFromHTTPServer, x402ResourceServer, x402HTTPResourceServer } from "@4mica/x402/server/express";
  *
  * const resourceServer = new x402ResourceServer(facilitatorClient)
  *   .register(NETWORK, new ExactEvmScheme())
@@ -49,14 +49,11 @@ function isOpenTabHttpError(error) {
  * const httpServer = new x402HTTPResourceServer(resourceServer, routes)
  *   .onProtectedRequest(requestHook);
  *
- * app.use(paymentMiddlewareFromHTTPServer(
- *   httpServer,
- *   { advertisedEndpoint: "https://api.example.com/x402/tab" },
- * )); * ```
+ * app.use(paymentMiddlewareFromHTTPServer(httpServer));
+ * ```
  */
-export function paymentMiddlewareFromHTTPServer(httpServer, tabConfig, paywallConfig, paywall, syncFacilitatorOnStart = true) {
-    const facilitatorClient = new FourMicaFacilitatorClient();
-    registerNetworkServers(httpServer, tabConfig.advertisedEndpoint);
+export function paymentMiddlewareFromHTTPServer(httpServer, paywallConfig, paywall, syncFacilitatorOnStart = true) {
+    registerNetworkServers(httpServer);
     // Register custom paywall provider if provided
     if (paywall) {
         httpServer.registerPaywallProvider(paywall);
@@ -79,33 +76,6 @@ export function paymentMiddlewareFromHTTPServer(httpServer, tabConfig, paywallCo
         });
     }
     return async (req, res, next) => {
-        // Check if this request is for the tab opening endpoint
-        try {
-            const advertisedUrl = new URL(tabConfig.advertisedEndpoint);
-            if (req.path === advertisedUrl.pathname) {
-                // Parse the request body
-                const { userAddress, paymentRequirements, x402Version } = req.body;
-                try {
-                    // Call the facilitator to open the tab
-                    const openTabResponse = await facilitatorClient.openTab(userAddress, paymentRequirements, tabConfig.ttlSeconds, x402Version);
-                    // Return the response
-                    return res.json(openTabResponse);
-                }
-                catch (error) {
-                    if (isOpenTabHttpError(error)) {
-                        return res.status(error.status).json(error.response);
-                    }
-                    console.error('Failed to open tab:', error);
-                    return res.status(500).json({
-                        error: 'Failed to open tab',
-                        details: error instanceof Error ? error.message : 'Unknown error',
-                    });
-                }
-            }
-        }
-        catch (urlError) {
-            console.error('Invalid advertisedEndpoint URL:', urlError);
-        }
         // Create adapter and context
         const adapter = new ExpressAdapter(req);
         const context = {
@@ -165,21 +135,21 @@ export function paymentMiddlewareFromHTTPServer(httpServer, tabConfig, paywallCo
                 const endPromise = new Promise((resolve) => {
                     endCalled = resolve;
                 });
-                res.writeHead = function (...args) {
+                res.writeHead = ((...args) => {
                     if (!settled) {
                         bufferedCalls.push(['writeHead', args]);
                         return res;
                     }
                     return originalWriteHead(...args);
-                };
-                res.write = function (...args) {
+                });
+                res.write = ((...args) => {
                     if (!settled) {
                         bufferedCalls.push(['write', args]);
                         return true;
                     }
                     return originalWrite(...args);
-                };
-                res.end = function (...args) {
+                });
+                res.end = ((...args) => {
                     if (!settled) {
                         bufferedCalls.push(['end', args]);
                         // Signal that the handler has finished
@@ -187,8 +157,8 @@ export function paymentMiddlewareFromHTTPServer(httpServer, tabConfig, paywallCo
                         return res;
                     }
                     return originalEnd(...args);
-                };
-                res.flushHeaders = function () {
+                });
+                res.flushHeaders = () => {
                     if (!settled) {
                         bufferedCalls.push(['flushHeaders', []]);
                         return;
@@ -279,7 +249,6 @@ export function paymentMiddlewareFromHTTPServer(httpServer, tabConfig, paywallCo
  *
  * @param routes - Route configurations for protected endpoints
  * @param server - Pre-configured x402ResourceServer instance
- * @param tabConfig - Configuration for payment tab handling (endpoint URL and TTL)
  * @param paywallConfig - Optional configuration for the built-in paywall UI
  * @param paywall - Optional custom paywall provider (overrides default)
  * @param syncFacilitatorOnStart - Whether to sync with the facilitator on startup (defaults to true)
@@ -287,22 +256,18 @@ export function paymentMiddlewareFromHTTPServer(httpServer, tabConfig, paywallCo
  *
  * @example
  * ```typescript
- * import { paymentMiddleware } from "@x402/express";
+ * import { paymentMiddleware } from "@4mica/x402/server/express";
  *
  * const server = new x402ResourceServer(myFacilitatorClient)
  *   .register(NETWORK, new ExactEvmScheme());
  *
- * app.use(paymentMiddleware(
- *   routes,
- *   server,
- *   { advertisedEndpoint: "https://api.example.com/x402/tab" },
- * ));
+ * app.use(paymentMiddleware(routes, server));
  * ```
  */
-export function paymentMiddleware(routes, server, tabConfig, paywallConfig, paywall, syncFacilitatorOnStart = true) {
+export function paymentMiddleware(routes, server, paywallConfig, paywall, syncFacilitatorOnStart = true) {
     // Create the x402 HTTP server instance with the resource server
     const httpServer = new x402HTTPResourceServer(server, routes);
-    return paymentMiddlewareFromHTTPServer(httpServer, tabConfig, paywallConfig, paywall, syncFacilitatorOnStart);
+    return paymentMiddlewareFromHTTPServer(httpServer, paywallConfig, paywall, syncFacilitatorOnStart);
 }
 /**
  * Express payment middleware for x402 protocol (configuration-based).
@@ -311,7 +276,6 @@ export function paymentMiddleware(routes, server, tabConfig, paywallConfig, payw
  * This function creates and configures the x402ResourceServer internally.
  *
  * @param routes - Route configurations for protected endpoints
- * @param tabConfig - Configuration for payment tab handling
  * @param facilitatorClients - Optional facilitator client(s) for payment processing
  * @param schemes - Optional array of scheme registrations for server-side payment processing
  * @param paywallConfig - Optional configuration for the built-in paywall UI
@@ -321,15 +285,12 @@ export function paymentMiddleware(routes, server, tabConfig, paywallConfig, payw
  *
  * @example
  * ```typescript
- * import { paymentMiddlewareFromConfig } from "@x402/express";
+ * import { paymentMiddlewareFromConfig } from "@4mica/x402/server/express";
  *
- * app.use(paymentMiddlewareFromConfig(
- *   routes,
- *   { advertisedEndpoint: "https://api.example.com/x402/tab" },
- * ));
+ * app.use(paymentMiddlewareFromConfig(routes));
  * ```
  */
-export function paymentMiddlewareFromConfig(routes, tabConfig, facilitatorClients, schemes, paywallConfig, paywall, syncFacilitatorOnStart = true) {
+export function paymentMiddlewareFromConfig(routes, facilitatorClients, schemes, paywallConfig, paywall, syncFacilitatorOnStart = true) {
     const facilitators = facilitatorClients
         ? Array.isArray(facilitatorClients)
             ? facilitatorClients
@@ -346,6 +307,6 @@ export function paymentMiddlewareFromConfig(routes, tabConfig, facilitatorClient
     }
     // Use the direct paymentMiddleware with the configured server
     // Note: paymentMiddleware handles dynamic bazaar registration
-    return paymentMiddleware(routes, ResourceServer, tabConfig, paywallConfig, paywall, syncFacilitatorOnStart);
+    return paymentMiddleware(routes, ResourceServer, paywallConfig, paywall, syncFacilitatorOnStart);
 }
 export { ExpressAdapter } from './adapter.js';

package/dist/server/facilitator.d.ts

@@ -1,21 +1,5 @@
-import { FacilitatorConfig, HTTPFacilitatorClient } from '@x402/core/server';
-import { Network, PaymentPayload, PaymentRequirements, SettleResponse } from '@x402/core/types';
-export interface OpenTabRequest {
-    userAddress: string;
-    recipientAddress: string;
-    network?: Network;
-    erc20Token?: string;
-    ttlSeconds?: number;
-}
-export interface OpenTabResponse {
-    tabId: string;
-    userAddress: string;
-    recipientAddress: string;
-    assetAddress: string;
-    startTimestamp: number;
-    ttlSeconds: number;
-    nextReqId: string;
-}
+import { type FacilitatorConfig, HTTPFacilitatorClient } from '@x402/core/server';
+import type { PaymentPayload, PaymentRequirements, SettleResponse } from '@x402/core/types';
 export interface CertificateResponse {
     claims: string;
     signature: string;
@@ -26,14 +10,8 @@ export type FourMicaSettleResponse = SettleResponse & {
     networkId?: string;
     error?: string;
 };
-export declare class OpenTabError extends Error {
-    readonly status: number;
-    readonly response: OpenTabResponse;
-    constructor(status: number, response: OpenTabResponse);
-}
 export declare class FourMicaFacilitatorClient extends HTTPFacilitatorClient {
     constructor(config?: FacilitatorConfig);
-    openTab(userAddress: string, paymentRequirements: PaymentRequirements, ttlSeconds?: number, guaranteeVersion?: number): Promise<OpenTabResponse>;
     settle(paymentPayload: PaymentPayload, paymentRequirements: PaymentRequirements): Promise<FourMicaSettleResponse>;
     /**
      * Helper to convert objects to JSON-safe format.

package/dist/server/facilitator.js

@@ -1,45 +1,9 @@
 import { HTTPFacilitatorClient } from '@x402/core/server';
 const DEFAULT_FACILITATOR_URL = 'https://x402.4mica.xyz';
-export class OpenTabError extends Error {
-    constructor(status, response) {
-        super(`OpenTab failed with status ${status}`);
-        this.status = status;
-        this.response = response;
-        this.name = 'OpenTabError';
-    }
-}
 export class FourMicaFacilitatorClient extends HTTPFacilitatorClient {
     constructor(config) {
         super({ ...config, url: config?.url ?? DEFAULT_FACILITATOR_URL });
     }
-    async openTab(userAddress, paymentRequirements, ttlSeconds, guaranteeVersion) {
-        let headers = {
-            'Content-Type': 'application/json',
-        };
-        const authHeaders = await this.createAuthHeaders('tabs');
-        headers = { ...headers, ...authHeaders.headers };
-        const response = await fetch(`${this.url}/tabs`, {
-            method: 'POST',
-            headers,
-            body: JSON.stringify(this.safeJson({
-                userAddress,
-                recipientAddress: paymentRequirements.payTo,
-                network: paymentRequirements.network,
-                erc20Token: paymentRequirements.asset,
-                ttlSeconds,
-                guaranteeVersion: guaranteeVersion ?? 1,
-            })),
-        });
-        const data = await response.json();
-        if (typeof data === 'object' && data !== null && 'tabId' in data) {
-            const openTabResponse = data;
-            if (!response.ok) {
-                throw new OpenTabError(response.status, openTabResponse);
-            }
-            return openTabResponse;
-        }
-        throw new Error(`Facilitator openTab failed (${response.status}): ${JSON.stringify(data)}`);
-    }
     async settle(paymentPayload, paymentRequirements) {
         let headers = {
             'Content-Type': 'application/json',

package/dist/server/index.d.ts

@@ -1,6 +1,4 @@
+export type { PaywallConfig, PaywallProvider, RouteValidationError } from '@x402/core/server';
+export { RouteConfigurationError, x402HTTPResourceServer, x402ResourceServer, } from '@x402/core/server';
 export * from './facilitator.js';
 export * from './scheme.js';
-export { x402ResourceServer, x402HTTPResourceServer } from '@x402/core/server';
-export type { PaywallProvider, PaywallConfig } from '@x402/core/server';
-export { RouteConfigurationError } from '@x402/core/server';
-export type { RouteValidationError } from '@x402/core/server';

package/dist/server/index.js

@@ -1,4 +1,3 @@
+export { RouteConfigurationError, x402HTTPResourceServer, x402ResourceServer, } from '@x402/core/server';
 export * from './facilitator.js';
 export * from './scheme.js';
-export { x402ResourceServer, x402HTTPResourceServer } from '@x402/core/server';
-export { RouteConfigurationError } from '@x402/core/server';

package/dist/server/scheme.d.ts

@@ -1,13 +1,46 @@
-import { AssetAmount, Network, PaymentRequirements, Price, SchemeNetworkServer, MoneyParser } from '@x402/core/types';
+import type { AssetAmount, MoneyParser, Network, PaymentFlowConfig, PaymentRequirements, Price, SchemeNetworkServer } from '@x402/core/types';
 export declare const SUPPORTED_NETWORKS: Network[];
+/** The token a `Money` price resolves to, as core lists it for the network. */
+export interface DefaultAsset {
+    address: string;
+    decimals: number;
+}
+export interface FourMicaEvmSchemeOptions {
+    /**
+     * Core API URL per network. Defaults to the hosted deployments in `@4mica/sdk`'s
+     * `NETWORKS`; set an entry to point a network at a self-hosted core.
+     */
+    coreUrls?: Partial<Record<Network, string>>;
+    /**
+     * Symbol of the token a `Money` price (`"$0.10"`) is denominated in, matched
+     * case-insensitively against core's token list. Defaults to `USDC`.
+     */
+    stablecoinSymbol?: string;
+}
 /**
  * EVM server implementation for the 4mica payment scheme.
+ *
+ * A `Money` price resolves to the stablecoin core lists for the network
+ * (`GET /core/tokens`), so the advertised `asset` is always one core accepts a
+ * guarantee against. Every requirement also carries core's EIP-712 domain in
+ * `extra` (`name`, `version`, `verifyingContract`, from
+ * `GET /core/public-params`), so a payer can sign without calling core. Both
+ * are fetched once per network and cached for the life of the instance.
  */
 export declare class FourMicaEvmScheme implements SchemeNetworkServer {
-    readonly advertisedTabEndpoint: string;
     readonly scheme = "4mica-credit";
+    readonly defaultAssetTransferMethod = "default";
+    readonly paymentFlows: Readonly<Record<string, PaymentFlowConfig>>;
     private moneyParsers;
-    constructor(advertisedTabEndpoint: string);
+    private readonly coreUrls;
+    private readonly stablecoinSymbol;
+    private readonly defaultAssets;
+    private readonly domains;
+    constructor(options?: FourMicaEvmSchemeOptions);
+    /** Core's token list. Private static so tests can stub the network call. */
+    private static loadSupportedTokens;
+    /** Core's public parameters. Private static so tests can stub the network call. */
+    private static loadPublicParams;
     /**
      * Register a custom money parser in the parser chain.
      * Multiple parsers can be registered - they will be tried in registration order.
@@ -33,7 +66,7 @@ export declare class FourMicaEvmScheme implements SchemeNetworkServer {
      * Parses a price into an asset amount.
      * If price is already an AssetAmount, returns it directly.
      * If price is Money (string | number), parses to decimal and tries custom parsers.
-     * Falls back to default conversion if all custom parsers return null.
+     * Falls back to the stablecoin core lists for the network if all custom parsers return null.
      *
      * @param price - The price to parse
      * @param network - The network to use
@@ -41,7 +74,12 @@ export declare class FourMicaEvmScheme implements SchemeNetworkServer {
      */
     parsePrice(price: Price, network: Network): Promise<AssetAmount>;
     /**
-     * Build payment requirements for this scheme/network combination
+     * Build payment requirements for this scheme/network combination.
+     *
+     * Adds core's EIP-712 domain to `extra` so the payer can sign without a
+     * round trip to core. A domain the resource server set itself is kept; only
+     * the missing keys are filled in. The chain id is not added: a client takes
+     * it from `network`.
      *
      * @param paymentRequirements - The base payment requirements
      * @param supportedKind - The supported kind from facilitator (unused)
@@ -68,7 +106,7 @@ export declare class FourMicaEvmScheme implements SchemeNetworkServer {
     private parseMoneyToDecimal;
     /**
      * Default money conversion implementation.
-     * Converts decimal amount to the default stablecoin on the specified network.
+     * Converts a decimal amount to the stablecoin core lists for the network.
      *
      * @param amount - The decimal amount (e.g., 1.50)
      * @param network - The network to use
@@ -83,11 +121,17 @@ export declare class FourMicaEvmScheme implements SchemeNetworkServer {
      * @returns The token amount as a string
      */
     private convertToTokenAmount;
+    private coreUrlFor;
     /**
-     * Get the default asset info for a network (typically USDC)
-     *
-     * @param network - The network to get asset info for
-     * @returns The asset information including address, name, version, and decimals
+     * The stablecoin core lists for `network`, fetched once and cached. A failed
+     * lookup is not cached, so the next price parse retries.
      */
     private getDefaultAsset;
+    private resolveDefaultAsset;
+    /**
+     * Core's EIP-712 domain for `network`, fetched once and cached. A failed
+     * lookup is not cached, so the next 402 retries.
+     */
+    private getDomain;
+    private resolveDomain;
 }