@dexterai/x402 1.6.6 → 1.7.0

package/dist/server/index.d.cts

@@ -1,5 +1,5 @@
-import { P as PaymentAccept, V as VerifyResponse, S as SettleResponse, c as PaymentRequired } from '../types-CcVAaoro.cjs';
-export { d as AccessPassClaims, A as AccessPassClientConfig, b as AccessPassInfo, a as AccessPassTier, B as BASE_MAINNET_NETWORK, D as DEXTER_FACILITATOR_URL, e as SOLANA_MAINNET_NETWORK, f as USDC_BASE, U as USDC_MINT } from '../types-CcVAaoro.cjs';
+import { P as PaymentAccept, V as VerifyResponse, S as SettleResponse, c as PayToProvider, d as PaymentRequired } from '../types-C6ty4U6C.cjs';
+export { g as AccessPassClaims, A as AccessPassClientConfig, b as AccessPassInfo, a as AccessPassTier, B as BASE_MAINNET_NETWORK, D as DEXTER_FACILITATOR_URL, e as PayToContext, f as PayToProviderDefaults, h as SOLANA_MAINNET_NETWORK, i as USDC_BASE, U as USDC_MINT } from '../types-C6ty4U6C.cjs';
 import { Request, RequestHandler } from 'express';
 
 /**
@@ -131,8 +131,12 @@ interface AssetConfig {
  * Server configuration
  */
 interface X402ServerConfig {
-    /** Address to receive payments */
-    payTo: string;
+    /**
+     * Address to receive payments, or a dynamic provider function.
+     * Use a string for static wallet addresses.
+     * Use a PayToProvider (e.g., stripePayTo) for per-request addresses.
+     */
+    payTo: string | PayToProvider;
     /** Facilitator URL (defaults to Dexter) */
     facilitatorUrl?: string;
     /** CAIP-2 network identifier */
@@ -221,9 +225,22 @@ declare function createX402Server(config: X402ServerConfig): X402Server;
  */
 interface X402MiddlewareConfig {
     /**
-     * Address to receive payments (Solana pubkey or EVM address)
+     * Address to receive payments, or a dynamic provider function.
+     *
+     * - **Static address**: Pass a Solana pubkey or EVM address string.
+     * - **Stripe**: Use `stripePayTo(process.env.STRIPE_SECRET_KEY)` to generate
+     *   per-request deposit addresses. Payments land in your Stripe Dashboard.
+     *
+     * @example
+     * ```typescript
+     * // Static address
+     * payTo: '0xYourAddress...'
+     *
+     * // Stripe machine payments
+     * payTo: stripePayTo(process.env.STRIPE_SECRET_KEY)
+     * ```
      */
-    payTo: string;
+    payTo: string | PayToProvider;
     /**
      * Payment amount in USD (e.g., '0.01' for 1 cent)
      * Will be converted to atomic units automatically.
@@ -903,4 +920,69 @@ declare const MODEL_PRICING_MAP: Record<string, {
     tier: string;
 }>;
 
-export { type AssetConfig, type BuildRequirementsOptions, type DynamicPricing, type DynamicPricingConfig, FacilitatorClient, MODEL_PRICING, MODEL_PRICING_MAP, MODEL_REGISTRY, type ModelApiType, type ModelDefinition, type ModelModality, type ModelParameters, type ModelPricing$1 as ModelPricing, type ModelTier, PaymentAccept, PaymentRequired, type PriceQuote, type ModelPricing as RegistryModelPricing, SettleResponse, type SupportedKind, type SupportedResponse, type TokenPriceQuote, type TokenPricing, type TokenPricingConfig, VerifyResponse, type X402AccessPassConfig, type X402AccessPassRequest, type X402BrowserSupportConfig, type X402MiddlewareConfig, type X402Request, type X402Server, type X402ServerConfig, countTokens, createDynamicPricing, createTokenPricing, createX402Server, estimateCost, findModel, formatModelPricing, formatPricing, formatTokenPricing, getActiveModels, getAvailableModelIds, getAvailableModels, getCheapestModel, getModel, getModelsByFamily, getModelsByTier, getTextModels, isValidModel, isValidModelId, x402AccessPass, x402BrowserSupport, x402Middleware };
+/**
+ * Stripe Machine Payments — PayTo Provider
+ *
+ * Generates per-request Stripe deposit addresses via PaymentIntents.
+ * Payments land in your Stripe Dashboard with full reporting, taxes, and refunds.
+ *
+ * Requires `stripe` npm package as a peer dependency.
+ *
+ * @example
+ * ```typescript
+ * import { x402Middleware, stripePayTo } from '@dexterai/x402/server';
+ *
+ * app.use('/api/data', x402Middleware({
+ *   amount: '0.01',
+ *   payTo: stripePayTo(process.env.STRIPE_SECRET_KEY),
+ * }));
+ * ```
+ *
+ * @see https://docs.stripe.com/payments/machine
+ */
+
+/**
+ * Configuration for the Stripe PayTo provider.
+ */
+interface StripePayToConfig {
+    /** Stripe secret key (sk_test_... or sk_live_...) */
+    secretKey: string;
+    /**
+     * Stripe API version to use.
+     * @default '2026-01-28.clover'
+     */
+    apiVersion?: string;
+    /**
+     * Target network for deposit addresses.
+     * - 'base' → Base mainnet (eip155:8453)
+     * - 'base-sepolia' → Base Sepolia testnet (eip155:84532)
+     * @default 'base'
+     */
+    network?: 'base' | 'base-sepolia';
+}
+/**
+ * Create a Stripe-backed PayTo provider for x402 machine payments.
+ *
+ * On each new request, creates a Stripe PaymentIntent with a crypto deposit address.
+ * When the agent sends USDC to that address, Stripe auto-captures the payment.
+ * Payments appear in your Stripe Dashboard like any other transaction.
+ *
+ * @param secretKeyOrConfig - Stripe secret key string, or full config object
+ * @returns A PayToProvider function with auto-configuration defaults
+ *
+ * @example Minimal usage
+ * ```typescript
+ * const provider = stripePayTo('sk_test_...');
+ * ```
+ *
+ * @example With config
+ * ```typescript
+ * const provider = stripePayTo({
+ *   secretKey: 'sk_test_...',
+ *   network: 'base-sepolia',  // testnet
+ * });
+ * ```
+ */
+declare function stripePayTo(secretKeyOrConfig: string | StripePayToConfig): PayToProvider;
+
+export { type AssetConfig, type BuildRequirementsOptions, type DynamicPricing, type DynamicPricingConfig, FacilitatorClient, MODEL_PRICING, MODEL_PRICING_MAP, MODEL_REGISTRY, type ModelApiType, type ModelDefinition, type ModelModality, type ModelParameters, type ModelPricing$1 as ModelPricing, type ModelTier, PayToProvider, PaymentAccept, PaymentRequired, type PriceQuote, type ModelPricing as RegistryModelPricing, SettleResponse, type StripePayToConfig, type SupportedKind, type SupportedResponse, type TokenPriceQuote, type TokenPricing, type TokenPricingConfig, VerifyResponse, type X402AccessPassConfig, type X402AccessPassRequest, type X402BrowserSupportConfig, type X402MiddlewareConfig, type X402Request, type X402Server, type X402ServerConfig, countTokens, createDynamicPricing, createTokenPricing, createX402Server, estimateCost, findModel, formatModelPricing, formatPricing, formatTokenPricing, getActiveModels, getAvailableModelIds, getAvailableModels, getCheapestModel, getModel, getModelsByFamily, getModelsByTier, getTextModels, isValidModel, isValidModelId, stripePayTo, x402AccessPass, x402BrowserSupport, x402Middleware };

package/dist/server/index.d.ts

@@ -1,5 +1,5 @@
-import { P as PaymentAccept, V as VerifyResponse, S as SettleResponse, c as PaymentRequired } from '../types-CcVAaoro.js';
-export { d as AccessPassClaims, A as AccessPassClientConfig, b as AccessPassInfo, a as AccessPassTier, B as BASE_MAINNET_NETWORK, D as DEXTER_FACILITATOR_URL, e as SOLANA_MAINNET_NETWORK, f as USDC_BASE, U as USDC_MINT } from '../types-CcVAaoro.js';
+import { P as PaymentAccept, V as VerifyResponse, S as SettleResponse, c as PayToProvider, d as PaymentRequired } from '../types-C6ty4U6C.js';
+export { g as AccessPassClaims, A as AccessPassClientConfig, b as AccessPassInfo, a as AccessPassTier, B as BASE_MAINNET_NETWORK, D as DEXTER_FACILITATOR_URL, e as PayToContext, f as PayToProviderDefaults, h as SOLANA_MAINNET_NETWORK, i as USDC_BASE, U as USDC_MINT } from '../types-C6ty4U6C.js';
 import { Request, RequestHandler } from 'express';
 
 /**
@@ -131,8 +131,12 @@ interface AssetConfig {
  * Server configuration
  */
 interface X402ServerConfig {
-    /** Address to receive payments */
-    payTo: string;
+    /**
+     * Address to receive payments, or a dynamic provider function.
+     * Use a string for static wallet addresses.
+     * Use a PayToProvider (e.g., stripePayTo) for per-request addresses.
+     */
+    payTo: string | PayToProvider;
     /** Facilitator URL (defaults to Dexter) */
     facilitatorUrl?: string;
     /** CAIP-2 network identifier */
@@ -221,9 +225,22 @@ declare function createX402Server(config: X402ServerConfig): X402Server;
  */
 interface X402MiddlewareConfig {
     /**
-     * Address to receive payments (Solana pubkey or EVM address)
+     * Address to receive payments, or a dynamic provider function.
+     *
+     * - **Static address**: Pass a Solana pubkey or EVM address string.
+     * - **Stripe**: Use `stripePayTo(process.env.STRIPE_SECRET_KEY)` to generate
+     *   per-request deposit addresses. Payments land in your Stripe Dashboard.
+     *
+     * @example
+     * ```typescript
+     * // Static address
+     * payTo: '0xYourAddress...'
+     *
+     * // Stripe machine payments
+     * payTo: stripePayTo(process.env.STRIPE_SECRET_KEY)
+     * ```
      */
-    payTo: string;
+    payTo: string | PayToProvider;
     /**
      * Payment amount in USD (e.g., '0.01' for 1 cent)
      * Will be converted to atomic units automatically.
@@ -903,4 +920,69 @@ declare const MODEL_PRICING_MAP: Record<string, {
     tier: string;
 }>;
 
-export { type AssetConfig, type BuildRequirementsOptions, type DynamicPricing, type DynamicPricingConfig, FacilitatorClient, MODEL_PRICING, MODEL_PRICING_MAP, MODEL_REGISTRY, type ModelApiType, type ModelDefinition, type ModelModality, type ModelParameters, type ModelPricing$1 as ModelPricing, type ModelTier, PaymentAccept, PaymentRequired, type PriceQuote, type ModelPricing as RegistryModelPricing, SettleResponse, type SupportedKind, type SupportedResponse, type TokenPriceQuote, type TokenPricing, type TokenPricingConfig, VerifyResponse, type X402AccessPassConfig, type X402AccessPassRequest, type X402BrowserSupportConfig, type X402MiddlewareConfig, type X402Request, type X402Server, type X402ServerConfig, countTokens, createDynamicPricing, createTokenPricing, createX402Server, estimateCost, findModel, formatModelPricing, formatPricing, formatTokenPricing, getActiveModels, getAvailableModelIds, getAvailableModels, getCheapestModel, getModel, getModelsByFamily, getModelsByTier, getTextModels, isValidModel, isValidModelId, x402AccessPass, x402BrowserSupport, x402Middleware };
+/**
+ * Stripe Machine Payments — PayTo Provider
+ *
+ * Generates per-request Stripe deposit addresses via PaymentIntents.
+ * Payments land in your Stripe Dashboard with full reporting, taxes, and refunds.
+ *
+ * Requires `stripe` npm package as a peer dependency.
+ *
+ * @example
+ * ```typescript
+ * import { x402Middleware, stripePayTo } from '@dexterai/x402/server';
+ *
+ * app.use('/api/data', x402Middleware({
+ *   amount: '0.01',
+ *   payTo: stripePayTo(process.env.STRIPE_SECRET_KEY),
+ * }));
+ * ```
+ *
+ * @see https://docs.stripe.com/payments/machine
+ */
+
+/**
+ * Configuration for the Stripe PayTo provider.
+ */
+interface StripePayToConfig {
+    /** Stripe secret key (sk_test_... or sk_live_...) */
+    secretKey: string;
+    /**
+     * Stripe API version to use.
+     * @default '2026-01-28.clover'
+     */
+    apiVersion?: string;
+    /**
+     * Target network for deposit addresses.
+     * - 'base' → Base mainnet (eip155:8453)
+     * - 'base-sepolia' → Base Sepolia testnet (eip155:84532)
+     * @default 'base'
+     */
+    network?: 'base' | 'base-sepolia';
+}
+/**
+ * Create a Stripe-backed PayTo provider for x402 machine payments.
+ *
+ * On each new request, creates a Stripe PaymentIntent with a crypto deposit address.
+ * When the agent sends USDC to that address, Stripe auto-captures the payment.
+ * Payments appear in your Stripe Dashboard like any other transaction.
+ *
+ * @param secretKeyOrConfig - Stripe secret key string, or full config object
+ * @returns A PayToProvider function with auto-configuration defaults
+ *
+ * @example Minimal usage
+ * ```typescript
+ * const provider = stripePayTo('sk_test_...');
+ * ```
+ *
+ * @example With config
+ * ```typescript
+ * const provider = stripePayTo({
+ *   secretKey: 'sk_test_...',
+ *   network: 'base-sepolia',  // testnet
+ * });
+ * ```
+ */
+declare function stripePayTo(secretKeyOrConfig: string | StripePayToConfig): PayToProvider;
+
+export { type AssetConfig, type BuildRequirementsOptions, type DynamicPricing, type DynamicPricingConfig, FacilitatorClient, MODEL_PRICING, MODEL_PRICING_MAP, MODEL_REGISTRY, type ModelApiType, type ModelDefinition, type ModelModality, type ModelParameters, type ModelPricing$1 as ModelPricing, type ModelTier, PayToProvider, PaymentAccept, PaymentRequired, type PriceQuote, type ModelPricing as RegistryModelPricing, SettleResponse, type StripePayToConfig, type SupportedKind, type SupportedResponse, type TokenPriceQuote, type TokenPricing, type TokenPricingConfig, VerifyResponse, type X402AccessPassConfig, type X402AccessPassRequest, type X402BrowserSupportConfig, type X402MiddlewareConfig, type X402Request, type X402Server, type X402ServerConfig, countTokens, createDynamicPricing, createTokenPricing, createX402Server, estimateCost, findModel, formatModelPricing, formatPricing, formatTokenPricing, getActiveModels, getAvailableModelIds, getAvailableModels, getCheapestModel, getModel, getModelsByFamily, getModelsByTier, getTextModels, isValidModel, isValidModelId, stripePayTo, x402AccessPass, x402BrowserSupport, x402Middleware };

package/dist/server/index.js

@@ -194,6 +194,10 @@ function createX402Server(config) {
   } = config;
   const facilitator = new FacilitatorClient(facilitatorUrl);
   let cachedExtra = null;
+  async function resolvePayTo(context) {
+    if (typeof payTo === "string") return payTo;
+    return payTo(context || {});
+  }
   async function getNetworkExtra() {
     if (!cachedExtra) {
       cachedExtra = await facilitator.getNetworkExtra(network);
@@ -209,7 +213,7 @@ function createX402Server(config) {
       version: cachedExtra.version
     };
   }
-  async function getPaymentAccept(options) {
+  async function buildPaymentAccept(resolvedPayTo, options) {
     const {
       amountAtomic,
       timeoutSeconds = defaultTimeoutSeconds
@@ -221,11 +225,18 @@ function createX402Server(config) {
       amount: amountAtomic,
       maxAmountRequired: amountAtomic,
       asset: asset.address,
-      payTo,
+      payTo: resolvedPayTo,
       maxTimeoutSeconds: timeoutSeconds,
       extra
     };
   }
+  async function getPaymentAccept(options) {
+    const address = await resolvePayTo({
+      amountAtomic: options.amountAtomic,
+      resourceUrl: options.resourceUrl
+    });
+    return buildPaymentAccept(address, options);
+  }
   async function buildRequirements(options) {
     const {
       resourceUrl,
@@ -258,18 +269,18 @@ function createX402Server(config) {
     };
   }
   async function verifyPayment(paymentSignatureHeader, requirements) {
-    const req = requirements || await getPaymentAccept({
-      amountAtomic: "0",
-      resourceUrl: ""
-    });
-    return facilitator.verifyPayment(paymentSignatureHeader, req);
+    if (!requirements) {
+      const address = await resolvePayTo({ paymentHeader: paymentSignatureHeader });
+      requirements = await buildPaymentAccept(address, { amountAtomic: "0", resourceUrl: "" });
+    }
+    return facilitator.verifyPayment(paymentSignatureHeader, requirements);
   }
   async function settlePayment(paymentSignatureHeader, requirements) {
-    const req = requirements || await getPaymentAccept({
-      amountAtomic: "0",
-      resourceUrl: ""
-    });
-    return facilitator.settlePayment(paymentSignatureHeader, req);
+    if (!requirements) {
+      const address = await resolvePayTo({ paymentHeader: paymentSignatureHeader });
+      requirements = await buildPaymentAccept(address, { amountAtomic: "0", resourceUrl: "" });
+    }
+    return facilitator.settlePayment(paymentSignatureHeader, requirements);
   }
   return {
     buildRequirements,
@@ -290,9 +301,7 @@ function x402Middleware(config) {
   const {
     payTo,
     amount,
-    network = DEFAULT_NETWORK,
     asset,
-    facilitatorUrl,
     description,
     resourceUrl: staticResourceUrl,
     mimeType,
@@ -302,6 +311,9 @@ function x402Middleware(config) {
     getAmount,
     getDescription
   } = config;
+  const providerDefaults = typeof payTo !== "string" ? payTo._x402Defaults : void 0;
+  const network = config.network ?? providerDefaults?.network ?? DEFAULT_NETWORK;
+  const facilitatorUrl = config.facilitatorUrl ?? providerDefaults?.facilitatorUrl;
   const log = verbose ? console.log.bind(console, "[x402:middleware]") : () => {
   };
   const server = createX402Server({
@@ -1741,6 +1753,100 @@ function formatTokenPricing(model = DEFAULT_MODEL) {
   const actualModel = MODEL_PRICING[model] ? model : DEFAULT_MODEL;
   return `$${pricing.input.toFixed(2)} per 1M tokens (${actualModel})`;
 }
+
+// src/server/stripe-payto.ts
+var STRIPE_NETWORK_KEYS = {
+  "base": "base",
+  "base-sepolia": "base_sepolia"
+};
+var CAIP2_NETWORKS = {
+  "base": "eip155:8453",
+  "base-sepolia": "eip155:84532"
+};
+var USDC_DECIMALS3 = 6;
+function stripePayTo(secretKeyOrConfig) {
+  const config = typeof secretKeyOrConfig === "string" ? { secretKey: secretKeyOrConfig } : secretKeyOrConfig;
+  const networkName = config.network ?? "base";
+  const stripeNetworkKey = STRIPE_NETWORK_KEYS[networkName] ?? "base";
+  const caip2Network = CAIP2_NETWORKS[networkName] ?? "eip155:8453";
+  const apiVersion = config.apiVersion ?? "2026-01-28.clover";
+  let stripeClient = null;
+  async function getStripe() {
+    if (stripeClient) return stripeClient;
+    try {
+      const { default: Stripe } = await import("stripe");
+      stripeClient = new Stripe(config.secretKey, {
+        apiVersion,
+        appInfo: {
+          name: "@dexterai/x402",
+          url: "https://dexter.cash/sdk"
+        }
+      });
+      return stripeClient;
+    } catch {
+      throw new Error(
+        'The "stripe" package is required for stripePayTo(). Install it with: npm install stripe'
+      );
+    }
+  }
+  const provider = async (context) => {
+    if (context.paymentHeader) {
+      try {
+        const decoded = JSON.parse(
+          Buffer.from(context.paymentHeader, "base64").toString()
+        );
+        const toAddress = decoded.payload?.authorization?.to;
+        if (toAddress && typeof toAddress === "string") {
+          return toAddress;
+        }
+        const acceptedPayTo = decoded.accepted?.payTo;
+        if (acceptedPayTo && typeof acceptedPayTo === "string") {
+          return acceptedPayTo;
+        }
+      } catch {
+      }
+      throw new Error(
+        "Could not extract deposit address from payment header. Ensure the client is sending a valid x402 PAYMENT-SIGNATURE."
+      );
+    }
+    const stripe = await getStripe();
+    const amountAtomic = context.amountAtomic ? parseInt(context.amountAtomic, 10) : 1e4;
+    const amountInCents = Math.max(1, Math.round(amountAtomic / Math.pow(10, USDC_DECIMALS3 - 2)));
+    const paymentIntent = await stripe.paymentIntents.create({
+      amount: amountInCents,
+      currency: "usd",
+      payment_method_types: ["crypto"],
+      payment_method_data: {
+        type: "crypto"
+      },
+      payment_method_options: {
+        crypto: {
+          mode: "custom"
+        }
+      },
+      confirm: true
+    });
+    const nextAction = paymentIntent.next_action;
+    if (!nextAction?.crypto_collect_deposit_details) {
+      throw new Error(
+        "Stripe PaymentIntent did not return crypto deposit details. Ensure your Stripe account has crypto payins enabled: https://support.stripe.com/questions/get-started-with-pay-with-crypto"
+      );
+    }
+    const depositDetails = nextAction.crypto_collect_deposit_details;
+    const payToAddress = depositDetails.deposit_addresses?.[stripeNetworkKey]?.address;
+    if (!payToAddress) {
+      throw new Error(
+        `No deposit address found for network "${stripeNetworkKey}". Available networks: ${Object.keys(depositDetails.deposit_addresses || {}).join(", ")}`
+      );
+    }
+    return payToAddress;
+  };
+  provider._x402Defaults = {
+    network: caip2Network,
+    facilitatorUrl: "https://x402.dexter.cash"
+  };
+  return provider;
+}
 export {
   BASE_MAINNET_NETWORK,
   DEXTER_FACILITATOR_URL,
@@ -1770,6 +1876,7 @@ export {
   getTextModels,
   isValidModel,
   isValidModelId,
+  stripePayTo,
   x402AccessPass,
   x402BrowserSupport,
   x402Middleware