@seedhape/x402-merchant-sdk 0.3.5 → 0.5.0

package/README.md

@@ -1,5 +1,72 @@
 # @seedhape/x402-merchant-sdk
 
+## One catalog for agent commerce
+
+Use `createMerchantCommerce` to define products once. The same product
+definitions can feed the SDK's current x402 paywall and future ACP/UCP/MPP
+adapters; merchants do not maintain protocol-specific catalogs.
+
+```ts
+const commerce = createMerchantCommerce({
+  paywall: { payTo, ...base, facilitator: base.facilitator },
+  products: [{
+    id: "weather", name: "Weather API", description: "Current weather",
+    endpoint: "/weather",
+    price: { amount: 50_000n, ...base },
+  }],
+});
+
+commerce.catalog();       // publish to your agent-facing catalog
+commerce.paywallFor("weather"); // pass to existing paywall middleware
+```
+
+The helper normalizes discovery metadata and product lookup. Fulfillment and
+refunds remain merchant-owned and should use the purchase ID as their durable
+idempotency key.
+
+## Unified seller facade (preview)
+
+`createSeedhapeSeller` is the single-drop-in entry point for a server-side
+Express route. Define each product once and keep provider credentials in the
+server environment:
+
+```ts
+import { base, createSeedhapeSeller } from "@seedhape/x402-merchant-sdk";
+
+const seller = createSeedhapeSeller({
+  products: [{
+    id: "weather",
+    name: "Weather API",
+    description: "Current weather data",
+    endpoint: "/weather",
+    price: "0.50",
+    fulfill: async () => ({ temperature: 24 }),
+  }],
+  payments: {
+    x402: {
+      payTo: process.env.MERCHANT_WALLET!,
+      network: base.network,
+      asset: base.asset,
+      decimals: base.decimals,
+      facilitator: base.facilitator,
+    },
+    stripeMpp: {
+      stripeSecretKey: process.env.STRIPE_SECRET_KEY!,
+      profileId: process.env.STRIPE_PROFILE_ID!,
+      mppSecretKey: process.env.MPP_SECRET_KEY!,
+    },
+  },
+});
+
+app.all("/weather", seller.route("weather"));
+```
+
+The facade preserves the existing x402 Bazaar discovery challenge. It selects
+Stripe MPP when a client advertises the MPP payment scheme and selects x402
+otherwise. ACP/UCP checkout remains a separate integration gate; it will
+consume the same catalog rather than requiring another merchant catalog or
+middleware stack.
+
 Add an x402 payment gate to an existing Express, Hono, or `node:http` service. The SDK returns a standard `402 Payment Required` challenge, verifies the buyer's payment through an x402 facilitator, settles USDC directly to the merchant wallet, and exposes a receipt for your application ledger.
 
 ## Install
@@ -8,6 +75,44 @@ Add an x402 payment gate to an existing Express, Hono, or `node:http` service. T
 npm install @seedhape/x402-merchant-sdk
 ```
 
+## Stripe machine payments (MPP)
+
+Install the optional MPP runtime when you want agents to pay with Stripe cards
+or Shared Payment Tokens:
+
+```bash
+npm install mppx
+```
+
+Create one Stripe MPP paywall per seller endpoint. The seller keeps the Stripe
+secret key and `profile_test_...` profile ID on the server; the SDK returns the
+payment challenge and settles the credential without exposing either value:
+
+```ts
+import { createStripeMppPaywall } from "@seedhape/x402-merchant-sdk";
+
+const mpp = await createStripeMppPaywall({
+  stripeSecretKey: process.env.STRIPE_SECRET_KEY!,
+  profileId: process.env.STRIPE_PROFILE_ID!,
+  mppSecretKey: process.env.MPP_SECRET_KEY!,
+  amount: "0.50",
+  currency: "usd",
+  description: "Weather API request",
+});
+
+export async function weather(request: Request) {
+  return mpp.handle(request, async () =>
+    Response.json({ temperature: 24, conditions: "clear" }),
+  );
+}
+```
+
+An unpaid agent receives HTTP `402`; a valid credential is verified and
+settled before the fulfillment callback runs. For a Stripe Connect direct
+charge, pass `connect: { stripeAccount: "acct_..." }`. To enable Stripe's
+stablecoin MPP rail as well, supply a Stripe SDK client and a test Tempo deposit
+address. Use `profile_test_...` and `sk_test_...` in a Stripe Sandbox.
+
 ## Express
 
 ```ts
@@ -43,7 +148,7 @@ app.get("/weather", (req, res) => {
 
 ## Network presets and payment methods
 
-Use `base` or `baseSepolia` to preconfigure the CAIP-2 network, USDC contract, decimals, and default facilitator:
+Use `base`, `baseSepolia`, `solana`, or `solanaDevnet` to preconfigure the CAIP-2 network, USDC mint/contract, decimals, and default facilitator:
 
 ```ts
 import { baseSepolia, expressPaywall, merchantConfig } from "@seedhape/x402-merchant-sdk";
@@ -59,6 +164,76 @@ app.use(expressPaywall(merchantConfig(baseSepolia, {
 
 `paymentMethods` defaults to `['eip3009']`, the broadly supported payment method. Set `['eip3009', 'erc7710']` to let the buyer/client choose both methods. Only advertise ERC-7710 when the configured facilitator supports it. If the methods use different facilitators, configure `facilitators: { eip3009: {...}, erc7710: {...} }`; the SDK selects the facilitator matching the buyer's selected method.
 
+### Base and Solana on one route
+
+Use `accepts` to expose both chains from the same resource. Bazaar and downstream catalogs such as Agentic Market treat these as payment choices on one service listing:
+
+```ts
+import { base, solana, expressPaywall, merchantConfig } from "@seedhape/x402-merchant-sdk";
+
+// Create cdpFacilitator with createCdpFacilitatorClient as shown below.
+
+app.use(expressPaywall(merchantConfig(base, {
+  accepts: [{
+    ...base,
+    payTo: process.env.BASE_MERCHANT_WALLET!,
+    paymentMethods: ["eip3009"],
+  }, {
+    ...solana,
+    payTo: process.env.SOLANA_MERCHANT_WALLET!,
+    feePayer: process.env.SOLANA_FEE_PAYER!,
+  }],
+  price: { amount: 10_000n, ...base },
+  facilitator: {
+    url: "https://api.cdp.coinbase.com/platform/v2/x402",
+    client: cdpFacilitator,
+  },
+  route: {
+    name: "Market Data",
+    description: "Paid market data on Base or Solana",
+    inputSchema: { type: "object", properties: { symbol: { type: "string" } } },
+    outputSchema: { type: "object" },
+  },
+})));
+```
+
+`feePayer` is the Solana facilitator signer advertised by its `/supported` response; it is not the merchant wallet. Use a facilitator that supports every advertised network, or set a per-option `facilitator`. Solana payments use the official x402 `exact` SVM scheme and a base64-encoded, partially signed versioned transaction in `PAYMENT-SIGNATURE`.
+
+The built-in Solana mainnet preset uses `solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp` and native USDC mint `EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v`. Solana addresses are case-sensitive.
+Its default facilitator is `https://facilitator.payai.network`; the devnet preset uses the test-only `https://x402.org/facilitator`.
+
+### Browser wallet paywall
+
+Install the optional official UI when people should be able to open the paid route directly and pay with an EVM or Solana browser wallet:
+
+```bash
+npm install @seedhape/x402-merchant-sdk @x402/paywall react react-dom
+```
+
+Then enable it on the same configuration:
+
+```ts
+const config = merchantConfig(base, {
+  accepts: [
+    { ...base, payTo: process.env.BASE_MERCHANT_WALLET! },
+    {
+      ...solana,
+      payTo: process.env.SOLANA_MERCHANT_WALLET!,
+      feePayer: process.env.SOLANA_FEE_PAYER!,
+    },
+  ],
+  price: { amount: 10_000n, ...base },
+  browserPaywall: {
+    appName: "Market Data",
+    appLogo: "https://api.example.com/icon-512.png",
+    testnet: false,
+  },
+  facilitator: { url: "https://facilitator.payai.network" },
+});
+```
+
+Express, Hono, and `node:http` adapters now return the official `@x402/paywall` HTML when the request accepts `text/html`. Programmatic callers continue receiving the normal JSON challenge and `PAYMENT-REQUIRED` header. The UI registers both official `evmPaywall` and `svmPaywall` handlers. Because `@x402/paywall` is an optional peer dependency, API-only installations do not pull its browser-wallet and React dependency tree.
+
 ### Coinbase CDP Facilitator and Bazaar
 
 For Coinbase Bazaar indexing, use Coinbase's authenticated facilitator client rather than passing the CDP API secret as a bearer token:
@@ -169,7 +344,7 @@ The HTTP route and MCP tool produce separate x402 resources, so each can have it
 
 Enable AP2 on an HTTP paywall to issue a signed merchant Checkout JWT with every unpaid or rejected `402` response. The SDK returns it in the `AP2-CHECKOUT-JWT` header; this does not change x402 verification or settlement.
 
-AP2 is optional. A route without the `ap2` option behaves exactly like a normal x402 route. AP2 adds signed checkout context for AP2-aware buyers and agents; the facilitator still verifies and settles the EIP-3009 or ERC-7710 payment.
+AP2 is optional. A route without the `ap2` option behaves exactly like a normal x402 route. AP2 adds signed checkout context for AP2-aware buyers and agents; the facilitator still verifies and settles the EIP-3009 or ERC-7710 payment. The current Checkout JWT binds one network, so SDK routes using `ap2` must configure a single payment option; multi-network Solana AP2 mandates are a separate follow-up.
 
 ```ts
 app.use(expressPaywall(merchantConfig(base, {
@@ -217,8 +392,8 @@ PAYMENT-REQUIRED: eyJ...
 
 ## Payment flow
 
-1. An unpaid request receives a v2 `402` challenge with a `PAYMENT-REQUIRED` header containing the merchant wallet, USDC asset, Base network, amount, and resource URL.
-2. The buyer creates an x402 payment using EIP-3009 or ERC-7710 and sends it in `PAYMENT-SIGNATURE`.
+1. An unpaid request receives a v2 `402` challenge with a `PAYMENT-REQUIRED` header containing one or more accepted networks, recipient wallets, USDC assets, the amount, and resource URL.
+2. The buyer selects an accepted option, creates an EVM authorization or Solana transaction, and sends it in `PAYMENT-SIGNATURE`.
 3. The facilitator verifies and settles the payment.
 4. USDC settles directly to `payTo`; Seedhape never holds merchant funds.
 5. The request continues and the settlement is returned in `PAYMENT-RESPONSE`.
@@ -227,7 +402,7 @@ The SDK emits the current x402 v2 challenge shape. For migration, it also accept
 
 ## Official x402 integrations
 
-The SDK is built on the official `@x402/core` and `@x402/evm` packages. EIP-3009 verification and settlement use `x402ResourceServer`, `HTTPFacilitatorClient`, and the official EVM exact scheme. Bazaar declarations use `@x402/extensions/bazaar` and are registered with the resource server.
+The SDK is built on the official `@x402/core`, `@x402/evm`, and `@x402/svm` packages. EIP-3009 and exact-SVM verification and settlement use `x402ResourceServer`, `HTTPFacilitatorClient`, and the official chain scheme. Bazaar declarations use `@x402/extensions/bazaar` and are registered with the resource server.
 
 ERC-7710 remains an opt-in Seedhape facilitator method because the official EVM exact server currently covers EIP-3009 and Permit2, not ERC-7710. When `erc7710` is selected, the SDK routes it to the configured facilitator override; it never silently sends an ERC-7710 payload through the EIP-3009 verifier.
 
@@ -250,7 +425,7 @@ Sonar listing does not replace Bazaar metadata. A merchant can publish Bazaar di
 ## Production checklist
 
 - Use a self-custodial merchant receiving address.
-- Use `eip155:8453` and Base USDC in production; use Base Sepolia only for testing.
+- Use Base mainnet or Solana mainnet presets in production and their testnet/devnet presets only for testing.
 - Configure a production facilitator URL and keep it server-side.
 - Keep health, documentation, and discovery metadata routes free.
 - Record the receipt ID, resource, payer, amount, network, and transaction hash.

package/dist/browser-paywall.d.ts

@@ -0,0 +1,50 @@
+/** Structural subset of the official renderer, kept local so server-only users do not need its types. */
+export interface BrowserPaywallProvider {
+    generateHtml(paymentRequired: BrowserPaymentRequired, config?: BrowserPaywallRuntimeConfig): string;
+}
+export interface BrowserPaywallRuntimeConfig {
+    appName?: string;
+    appLogo?: string;
+    currentUrl?: string;
+    testnet?: boolean;
+    faucetUrls?: Record<string, string>;
+}
+export interface BrowserPaymentRequired {
+    x402Version: number;
+    error?: string;
+    resource?: {
+        url: string;
+        description?: string;
+        mimeType?: string;
+    };
+    accepts: Array<{
+        scheme: string;
+        network: string;
+        asset: string;
+        payTo: string;
+        maxTimeoutSeconds: number;
+        extra?: Record<string, unknown>;
+        amount?: string;
+        maxAmountRequired?: string;
+        description?: string;
+        resource?: string;
+        mimeType?: string;
+    }>;
+    extensions?: Record<string, unknown>;
+}
+/** Runtime options passed to the official browser paywall renderer. */
+export interface BrowserPaywallConfig extends BrowserPaywallRuntimeConfig {
+    /** Inject a custom provider, primarily for custom themes or tests. */
+    provider?: BrowserPaywallProvider;
+}
+/**
+ * Build the official x402 browser paywall with handlers for both EVM and Solana.
+ * `@x402/paywall` is an optional peer so server-only SDK installs stay lean.
+ */
+export declare function createBrowserPaywallProvider(config?: BrowserPaywallRuntimeConfig): Promise<BrowserPaywallProvider>;
+export declare function renderBrowserPaywall(args: {
+    paymentRequired: unknown;
+    accept?: string | string[];
+    config: true | BrowserPaywallConfig;
+}): Promise<string | undefined>;
+//# sourceMappingURL=browser-paywall.d.ts.map

package/dist/browser-paywall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-paywall.d.ts","sourceRoot":"","sources":["../src/browser-paywall.ts"],"names":[],"mappings":"AAAA,yGAAyG;AACzG,MAAM,WAAW,sBAAsB;IACrC,YAAY,CAAC,eAAe,EAAE,sBAAsB,EAAE,MAAM,CAAC,EAAE,2BAA2B,GAAG,MAAM,CAAC;CACrG;AAED,MAAM,WAAW,2BAA2B;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACpE,OAAO,EAAE,KAAK,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,iBAAiB,EAAE,MAAM,CAAC;QAC1B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAChC,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,uEAAuE;AACvE,MAAM,WAAW,oBAAqB,SAAQ,2BAA2B;IACvE,sEAAsE;IACtE,QAAQ,CAAC,EAAE,sBAAsB,CAAC;CACnC;AAED;;;GAGG;AACH,wBAAsB,4BAA4B,CAChD,MAAM,GAAE,2BAAgC,GACvC,OAAO,CAAC,sBAAsB,CAAC,CAkBjC;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,eAAe,EAAE,OAAO,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC3B,MAAM,EAAE,IAAI,GAAG,oBAAoB,CAAC;CACrC,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAY9B"}

package/dist/browser-paywall.js

@@ -0,0 +1,35 @@
+/**
+ * Build the official x402 browser paywall with handlers for both EVM and Solana.
+ * `@x402/paywall` is an optional peer so server-only SDK installs stay lean.
+ */
+export async function createBrowserPaywallProvider(config = {}) {
+    try {
+        const [{ createPaywall }, { evmPaywall }, { svmPaywall }] = await Promise.all([
+            import("@x402/paywall"),
+            import("@x402/paywall/evm"),
+            import("@x402/paywall/svm"),
+        ]);
+        return createPaywall()
+            .withNetwork(evmPaywall)
+            .withNetwork(svmPaywall)
+            .withConfig(config)
+            .build();
+    }
+    catch (cause) {
+        throw new Error("Browser paywall support requires the optional @x402/paywall peer dependency (version 2.23.0 or newer).", { cause });
+    }
+}
+export async function renderBrowserPaywall(args) {
+    const accept = Array.isArray(args.accept) ? args.accept.join(",") : args.accept ?? "";
+    if (!accept.toLowerCase().includes("text/html"))
+        return undefined;
+    const configured = args.config === true ? {} : args.config;
+    const { provider, ...runtimeConfig } = configured;
+    const resolvedProvider = provider ?? await createBrowserPaywallProvider(runtimeConfig);
+    const paymentRequired = args.paymentRequired;
+    return resolvedProvider.generateHtml(paymentRequired, {
+        ...runtimeConfig,
+        currentUrl: runtimeConfig.currentUrl ?? paymentRequired.resource?.url,
+    });
+}
+//# sourceMappingURL=browser-paywall.js.map

package/dist/browser-paywall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-paywall.js","sourceRoot":"","sources":["../src/browser-paywall.ts"],"names":[],"mappings":"AAuCA;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,SAAsC,EAAE;IAExC,IAAI,CAAC;QACH,MAAM,CAAC,EAAE,aAAa,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAC5E,MAAM,CAAC,eAAe,CAAC;YACvB,MAAM,CAAC,mBAAmB,CAAC;YAC3B,MAAM,CAAC,mBAAmB,CAAC;SAC5B,CAAC,CAAC;QACH,OAAO,aAAa,EAAE;aACnB,WAAW,CAAC,UAAU,CAAC;aACvB,WAAW,CAAC,UAAU,CAAC;aACvB,UAAU,CAAC,MAAM,CAAC;aAClB,KAAK,EAAE,CAAC;IACb,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,wGAAwG,EACxG,EAAE,KAAK,EAAE,CACV,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,IAI1C;IACC,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC;IACtF,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC;QAAE,OAAO,SAAS,CAAC;IAElE,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;IAC3D,MAAM,EAAE,QAAQ,EAAE,GAAG,aAAa,EAAE,GAAG,UAAU,CAAC;IAClD,MAAM,gBAAgB,GAAG,QAAQ,IAAI,MAAM,4BAA4B,CAAC,aAAa,CAAC,CAAC;IACvF,MAAM,eAAe,GAAG,IAAI,CAAC,eAAyC,CAAC;IACvE,OAAO,gBAAgB,CAAC,YAAY,CAAC,eAAe,EAAE;QACpD,GAAG,aAAa;QAChB,UAAU,EAAE,aAAa,CAAC,UAAU,IAAI,eAAe,CAAC,QAAQ,EAAE,GAAG;KACtE,CAAC,CAAC;AACL,CAAC"}

package/dist/commerce.d.ts

@@ -0,0 +1,38 @@
+import type { Money, PaywallConfig, RouteMetadata } from "./middleware.js";
+/** A merchant's protocol-neutral, agent-readable product definition. */
+export interface MerchantProduct {
+    id: string;
+    name: string;
+    description: string;
+    price: Money;
+    endpoint: string;
+    /** A human-readable policy; fulfillment/refund behavior stays merchant-owned. */
+    refundPolicy?: string;
+    metadata?: RouteMetadata;
+}
+export interface MerchantCommerceConfig {
+    /** Base paywall/provider configuration shared by every product. */
+    paywall: Omit<PaywallConfig, "price">;
+    products: readonly MerchantProduct[];
+}
+export interface MerchantCatalogProduct extends Omit<MerchantProduct, "price"> {
+    price: {
+        amount: string;
+        asset: string;
+        network: string;
+        decimals: number;
+    };
+    capabilities: readonly ["quote", "purchase", "receipt"];
+}
+/**
+ * One merchant integration surface for catalogs and paid routes. Protocol
+ * adapters consume the same product definitions, so a merchant does not keep
+ * separate ACP/UCP/x402/MPP catalogs. The returned PaywallConfig remains
+ * compatible with the existing Express/Hono/node:http middleware.
+ */
+export declare function createMerchantCommerce(config: MerchantCommerceConfig): {
+    catalog(): MerchantCatalogProduct[];
+    product(id: string): MerchantProduct | null;
+    paywallFor(id: string): PaywallConfig;
+};
+//# sourceMappingURL=commerce.d.ts.map

package/dist/commerce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commerce.d.ts","sourceRoot":"","sources":["../src/commerce.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAE3E,wEAAwE;AACxE,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,KAAK,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,iFAAiF;IACjF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,aAAa,CAAC;CAC1B;AAED,MAAM,WAAW,sBAAsB;IACrC,mEAAmE;IACnE,OAAO,EAAE,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IACtC,QAAQ,EAAE,SAAS,eAAe,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,sBAAuB,SAAQ,IAAI,CAAC,eAAe,EAAE,OAAO,CAAC;IAC5E,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5E,YAAY,EAAE,SAAS,CAAC,OAAO,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;CACzD;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,sBAAsB;eAKtD,sBAAsB,EAAE;gBAOvB,MAAM,GAAG,eAAe,GAAG,IAAI;mBAG5B,MAAM,GAAG,aAAa;EAWxC"}

package/dist/commerce.js

@@ -0,0 +1,35 @@
+/**
+ * One merchant integration surface for catalogs and paid routes. Protocol
+ * adapters consume the same product definitions, so a merchant does not keep
+ * separate ACP/UCP/x402/MPP catalogs. The returned PaywallConfig remains
+ * compatible with the existing Express/Hono/node:http middleware.
+ */
+export function createMerchantCommerce(config) {
+    const byId = new Map(config.products.map((product) => [product.id, product]));
+    if (byId.size !== config.products.length)
+        throw new Error("Merchant product IDs must be unique.");
+    return {
+        catalog() {
+            return config.products.map((product) => ({
+                ...product,
+                price: { ...product.price, amount: product.price.amount.toString() },
+                capabilities: ["quote", "purchase", "receipt"],
+            }));
+        },
+        product(id) {
+            return byId.get(id) ?? null;
+        },
+        paywallFor(id) {
+            const product = byId.get(id);
+            if (!product)
+                throw new Error(`Unknown merchant product: ${id}`);
+            return {
+                ...config.paywall,
+                price: product.price,
+                description: product.description,
+                route: { ...product.metadata, name: product.metadata?.name ?? product.name, description: product.description },
+            };
+        },
+    };
+}
+//# sourceMappingURL=commerce.js.map

package/dist/commerce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commerce.js","sourceRoot":"","sources":["../src/commerce.ts"],"names":[],"mappings":"AAyBA;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAA8B;IACnE,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAC9E,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,QAAQ,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAElG,OAAO;QACL,OAAO;YACL,OAAO,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;gBACvC,GAAG,OAAO;gBACV,KAAK,EAAE,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE;gBACpE,YAAY,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,SAAS,CAAU;aACxD,CAAC,CAAC,CAAC;QACN,CAAC;QACD,OAAO,CAAC,EAAU;YAChB,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC;QAC9B,CAAC;QACD,UAAU,CAAC,EAAU;YACnB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC7B,IAAI,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,EAAE,EAAE,CAAC,CAAC;YACjE,OAAO;gBACL,GAAG,MAAM,CAAC,OAAO;gBACjB,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,WAAW,EAAE,OAAO,CAAC,WAAW;gBAChC,KAAK,EAAE,EAAE,GAAG,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE,IAAI,IAAI,OAAO,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE;aAC/G,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -1,4 +1,9 @@
 export * from "./middleware.js";
 export * from "./mcp.js";
 export * from "./ap2.js";
+export * from "./browser-paywall.js";
+export * from "./commerce.js";
+export * from "./mpp.js";
+export * from "./stripe-mpp.js";
+export * from "./seller.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC"}

package/dist/index.js

@@ -1,4 +1,9 @@
 export * from "./middleware.js";
 export * from "./mcp.js";
 export * from "./ap2.js";
+export * from "./browser-paywall.js";
+export * from "./commerce.js";
+export * from "./mpp.js";
+export * from "./stripe-mpp.js";
+export * from "./seller.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC"}

package/dist/mcp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,KAAK,CAAC;AACvC,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,UAAU,EACf,KAAK,aAAa,EACnB,MAAM,iBAAiB,CAAC;AAEzB,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,4CAA4C;IAC5C,eAAe,CAAC,EAAE,UAAU,CAAC;IAC7B,gBAAgB,CAAC,EAAE,UAAU,CAAC;IAC9B,iEAAiE;IACjE,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,gEAAgE;IAChE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,WAAW,CAAC,EAAE,iBAAiB,CAAC;CACjC;AAED,MAAM,MAAM,cAAc,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IACxF,CAAC,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;AAE9C;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrG,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,aAAa,EACtB,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE,cAAc,CAAC,KAAK,CAAC,GAC7B,OAAO,CAAC,IAAI,CAAC,CAmEf"}
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,KAAK,CAAC;AACvC,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,UAAU,EACf,KAAK,aAAa,EAEnB,MAAM,iBAAiB,CAAC;AAEzB,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,4CAA4C;IAC5C,eAAe,CAAC,EAAE,UAAU,CAAC;IAC7B,gBAAgB,CAAC,EAAE,UAAU,CAAC;IAC9B,iEAAiE;IACjE,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,gEAAgE;IAChE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,WAAW,CAAC,EAAE,iBAAiB,CAAC;CACjC;AAED,MAAM,MAAM,cAAc,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IACxF,CAAC,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;AAE9C;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrG,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,aAAa,EACtB,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE,cAAc,CAAC,KAAK,CAAC,GAC7B,OAAO,CAAC,IAAI,CAAC,CA4Ef"}

package/dist/mcp.js

@@ -1,7 +1,7 @@
 import { randomUUID } from "node:crypto";
 import { createPaymentWrapper } from "@x402/mcp";
 import { declareDiscoveryExtension } from "@x402/extensions/bazaar";
-import { createOfficialResourceServer, } from "./middleware.js";
+import { createOfficialResourceServer, resolvePaymentOptions, } from "./middleware.js";
 /**
  * Register a paid MCP tool using the same merchant configuration as HTTP routes.
  * The official @x402/mcp wrapper handles the MCP payment challenge, verification,
@@ -13,22 +13,29 @@ export async function createPaidMcpTool(server, paywall, tool, handler) {
     const price = typeof paywall.price === "function"
         ? (() => { throw new Error("MCP tools require a fixed price; configure per-call pricing in the MCP handler layer."); })()
         : paywall.price;
-    const accepts = await resourceServer.buildPaymentRequirements({
+    const paymentOptions = resolvePaymentOptions(paywall);
+    if (paymentOptions.some((option) => option.facilitator)) {
+        throw new Error("MCP multi-network tools currently require one shared facilitator.");
+    }
+    const accepts = (await Promise.all(paymentOptions.map((option) => resourceServer.buildPaymentRequirements({
         scheme: "exact",
-        network: paywall.network,
-        payTo: paywall.payTo,
+        network: option.network,
+        payTo: option.payTo,
         price: {
-            asset: paywall.asset,
+            asset: option.asset,
             amount: price.amount.toString(),
-            extra: {
-                name: "USD Coin",
-                version: "2",
-                decimals: paywall.decimals ?? 6,
-                assetTransferMethod: "eip3009",
-            },
+            extra: option.network.startsWith("solana:")
+                ? { ...(option.extra ?? {}), feePayer: option.feePayer ?? option.extra?.feePayer }
+                : {
+                    name: "USD Coin",
+                    version: "2",
+                    decimals: option.decimals ?? 6,
+                    assetTransferMethod: option.paymentMethods?.[0] ?? paywall.paymentMethods?.[0] ?? "eip3009",
+                    ...(option.extra ?? {}),
+                },
         },
         maxTimeoutSeconds: paywall.maxTimeoutSeconds,
-    });
+    })))).flat();
     const wrapped = createPaymentWrapper(resourceServer, {
         accepts,
         resource: {
@@ -51,18 +58,18 @@ export async function createPaidMcpTool(server, paywall, tool, handler) {
             onAfterSettlement: async ({ settlement, paymentPayload }) => {
                 if (!settlement.success)
                     return;
+                const accepted = paymentPayload.accepted;
                 await paywall.receipts?.record({
                     id: randomUUID(),
                     resource: tool.resourceUrl ?? `mcp://tool/${tool.name}`,
                     payer: settlement.payer,
-                    payTo: paywall.payTo,
+                    payTo: accepted.payTo,
                     amount: price.amount,
-                    asset: paywall.asset,
-                    network: paywall.network,
+                    asset: accepted.asset,
+                    network: accepted.network,
                     txHash: settlement.transaction,
                     settledAt: Math.floor(Date.now() / 1000),
                 });
-                void paymentPayload;
             },
         } : undefined,
     })(async (args) => ({

package/dist/mcp.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"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"}

package/dist/middleware.d.ts

@@ -12,6 +12,7 @@
 import type { IncomingMessage, ServerResponse } from "node:http";
 import { x402ResourceServer, type FacilitatorClient } from "@x402/core/server";
 import type { Ap2MerchantConfig } from "./ap2.js";
+import { type BrowserPaywallConfig } from "./browser-paywall.js";
 export interface Money {
     /** Base units of the asset. USDC has 6 decimals. */
     amount: bigint;
@@ -53,6 +54,21 @@ export interface FacilitatorConfig {
     client?: FacilitatorClient;
 }
 export type PaymentMethod = "eip3009" | "erc7710";
+/** One chain-specific way a buyer may pay for the same resource. */
+export interface MerchantPaymentOption {
+    network: string;
+    asset: string;
+    payTo: string;
+    decimals?: number;
+    /** EVM transfer methods. Solana always uses the x402 `exact` SVM scheme. */
+    paymentMethods?: PaymentMethod[];
+    /** Override the route-level facilitator for this network. */
+    facilitator?: FacilitatorConfig;
+    /** Required for Solana HTTP challenges unless supplied in `extra.feePayer`. */
+    feePayer?: string;
+    /** Additional scheme-specific payment requirement fields. */
+    extra?: Record<string, unknown>;
+}
 export interface JsonSchema {
     [key: string]: unknown;
 }
@@ -83,6 +99,8 @@ export interface MerchantNetworkConfig {
     decimals: number;
     facilitator: FacilitatorConfig;
 }
+export declare const SOLANA_MAINNET: MerchantNetworkConfig;
+export declare const SOLANA_DEVNET: MerchantNetworkConfig;
 /** Base mainnet + USDC defaults. Override any field for a custom facilitator. */
 export declare const BASE_MAINNET: MerchantNetworkConfig;
 /** Base Sepolia + USDC defaults for development and staging. */
@@ -90,16 +108,21 @@ export declare const BASE_SEPOLIA: MerchantNetworkConfig;
 /** Lowercase aliases make preset usage read naturally in route definitions. */
 export declare const base: MerchantNetworkConfig;
 export declare const baseSepolia: MerchantNetworkConfig;
+export declare const solana: MerchantNetworkConfig;
+export declare const solanaDevnet: MerchantNetworkConfig;
 export interface MerchantPresetConfig extends MerchantNetworkConfig {
     paymentMethods?: PaymentMethod[];
 }
 /** Compose a route configuration from a network preset without mutation. */
 export declare function merchantConfig(preset: MerchantPresetConfig, config: Omit<PaywallConfig, "network" | "asset" | "decimals" | "facilitator"> & Partial<Pick<PaywallConfig, "network" | "asset" | "decimals" | "facilitator">>): PaywallConfig;
 export interface PaywallConfig {
-    payTo: string;
-    network: string;
-    asset: string;
+    /** Legacy single-network fields. Omit these when `accepts` is provided. */
+    payTo?: string;
+    network?: string;
+    asset?: string;
     decimals?: number;
+    /** Multiple chain-specific payment choices shown in one Bazaar/Agentic Market listing. */
+    accepts?: MerchantPaymentOption[];
     /** Payment authorization methods advertised in the 402 response. */
     paymentMethods?: PaymentMethod[];
     /** Optional facilitator overrides for individual transfer methods. */
@@ -122,6 +145,8 @@ export interface PaywallConfig {
     bazaar?: boolean;
     /** Optional merchant AP2 issuer. Adds AP2-CHECKOUT-JWT to 402 responses. */
     ap2?: Ap2MerchantConfig;
+    /** Render the official EVM + Solana browser UI for requests accepting text/html. */
+    browserPaywall?: true | BrowserPaywallConfig;
     maxTimeoutSeconds?: number;
     /** Routes that never require payment, e.g. ["/health", "/.well-known/*"]. */
     free?: string[];
@@ -168,9 +193,10 @@ export interface PaywallOutcome {
 export declare class Paywall {
     private readonly cfg;
     private readonly facilitator;
-    private readonly decimals;
+    private readonly paymentOptions;
     constructor(cfg: PaywallConfig);
     priceFor(path: string, method: string, query: URLSearchParams): Money | null;
+    renderBrowserChallenge(challenge: unknown, accept?: string | string[]): Promise<string | undefined>;
     buildChallenge(price: Money, resource: string, method?: string): {
         x402Version: number;
         error: string;
@@ -195,6 +221,7 @@ export declare class Paywall {
     private facilitatorFor;
     private writeReceipt;
 }
+export declare function resolvePaymentOptions(cfg: PaywallConfig): MerchantPaymentOption[];
 export declare function expressPaywall(cfg: PaywallConfig): (req: any, res: any, next: any) => Promise<any>;
 export declare function honoPaywall(cfg: PaywallConfig): (c: any, next: any) => Promise<any>;
 export declare function nodePaywall(cfg: PaywallConfig): (req: IncomingMessage, res: ServerResponse) => Promise<Receipt | "free" | null>;