@moneymq/x402 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 MoneyMQ
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,240 @@
+# @moneymq/x402
+
+x402 payment protocol utilities for MoneyMQ. Enables HTTP 402 Payment Required flows for micropayments.
+
+## Installation
+
+```bash
+npm install @moneymq/x402
+# or
+pnpm add @moneymq/x402
+# or
+yarn add @moneymq/x402
+```
+
+## What is x402?
+
+The x402 protocol enables native micropayments over HTTP using the `402 Payment Required` status code. When a server returns 402, it includes payment requirements that clients can fulfill to access the resource.
+
+## Usage
+
+### Client-side: Automatic Payment Handling
+
+Use `payUpon402` to wrap HTTP calls with automatic payment handling:
+
+```typescript
+import { payUpon402 } from '@moneymq/x402';
+
+// Basic usage - will handle 402 with mock payment (for testing)
+const data = await payUpon402(() =>
+  fetch('https://api.example.com/premium-data')
+);
+
+// With a wallet client for real payments
+import { createSigner } from '@moneymq/x402';
+
+const signer = createSigner(privateKey);
+const data = await payUpon402(
+  () => fetch('https://api.example.com/premium-data'),
+  signer,
+);
+
+// With custom max value (default: 0.1 USDC)
+const data = await payUpon402(
+  () => fetch('https://api.example.com/expensive-data'),
+  signer,
+  BigInt(1_000_000), // 1 USDC max
+);
+```
+
+### Server-side: Express Middleware
+
+Protect your API endpoints with payment requirements:
+
+```typescript
+import express from 'express';
+import { createX402Handler, requirePayment } from '@moneymq/x402';
+
+const app = express();
+
+// Full configuration
+app.use('/api/premium', createX402Handler({
+  price: 100,          // Amount in smallest units (0.0001 USDC)
+  currency: 'USDC',
+  recipient: 'YourWalletAddress...',
+  network: 'solana',   // Optional, defaults to 'solana'
+  onPayment: async (payment) => {
+    // Called when payment is received
+    console.log(`Payment from ${payment.payer}: ${payment.amount}`);
+    console.log(`Transaction: ${payment.signature}`);
+
+    // Track usage, update database, etc.
+    await trackPayment(payment);
+  },
+}));
+
+app.get('/api/premium/data', (req, res) => {
+  // Only reached after payment is verified
+  res.json({ secret: 'Premium content!' });
+});
+
+// Shorthand for simple routes
+app.get('/api/data',
+  requirePayment({
+    amount: 50,
+    currency: 'USDC',
+    recipient: 'YourWallet...',
+  }),
+  (req, res) => {
+    res.json({ data: 'Paid content' });
+  }
+);
+```
+
+### Stripe Integration
+
+Use x402 with Stripe's SDK for a familiar payment experience:
+
+```typescript
+import { createStripeClient } from '@moneymq/x402';
+import { createSigner } from '@moneymq/x402';
+
+// Create signer from private key
+const signer = createSigner(process.env.WALLET_PRIVATE_KEY);
+
+// Create Stripe client with x402 payment handling
+const stripe = createStripeClient(
+  process.env.STRIPE_API_KEY,
+  signer,
+);
+
+// Now any Stripe API call that returns 402 will be
+// automatically handled with x402 payments
+const paymentIntent = await stripe.paymentIntents.create({
+  amount: 1000,
+  currency: 'usd',
+});
+```
+
+## API Reference
+
+### payUpon402
+
+Wraps an HTTP call with automatic 402 payment handling.
+
+```typescript
+function payUpon402<T>(
+  promiseOrFn: Promise<T> | (() => Promise<T>),
+  walletClient?: Signer | MultiNetworkSigner,
+  maxValue?: bigint,
+  config?: X402Config,
+): Promise<T>
+```
+
+**Parameters:**
+
+- `promiseOrFn` - Either a Promise or a function returning a Promise. Using a function allows retrying after payment.
+- `walletClient` - Optional wallet signer for creating payments. Without this, mock payments are used.
+- `maxValue` - Maximum payment amount allowed (default: 0.1 USDC = 100000)
+- `config` - Optional x402 configuration
+
+**Example:**
+
+```typescript
+// Use function syntax for retry support
+const data = await payUpon402(() => fetch('/api/data'), signer);
+
+// Promise syntax (no retry on 402)
+const data = await payUpon402(fetch('/api/data'));
+```
+
+### createX402Handler
+
+Creates Express middleware for handling x402 payments.
+
+```typescript
+function createX402Handler(config: X402HandlerConfig): RequestHandler
+```
+
+**Config options:**
+
+```typescript
+interface X402HandlerConfig {
+  price: number;           // Amount in smallest units
+  currency: string;        // e.g., 'USDC'
+  recipient: string;       // Recipient wallet address
+  network?: string;        // Network (default: 'solana')
+  onPayment?: (payment: {
+    amount: number;
+    payer: string;
+    signature?: string;
+  }) => void | Promise<void>;
+}
+```
+
+### requirePayment
+
+Shorthand for creating x402 middleware.
+
+```typescript
+function requirePayment(options: {
+  amount: number;
+  currency: string;
+  recipient: string;
+  network?: string;
+}): RequestHandler
+```
+
+### createStripeClient
+
+Creates a Stripe client with x402 payment interception.
+
+```typescript
+function createStripeClient(
+  apiKey: string,
+  walletClient?: Signer | MultiNetworkSigner,
+  config?: Stripe.StripeConfig,
+  x402Config?: X402Config,
+): Stripe
+```
+
+### createSigner
+
+Re-exported from `x402-fetch` for convenience.
+
+```typescript
+import { createSigner } from '@moneymq/x402';
+
+const signer = createSigner(privateKeyBytes);
+```
+
+## Types
+
+All x402 types are re-exported:
+
+```typescript
+import type {
+  PaymentRequirements,
+  Signer,
+  MultiNetworkSigner,
+  X402Config,
+} from '@moneymq/x402';
+```
+
+## How it Works
+
+1. Client makes request to protected endpoint
+2. Server returns `402 Payment Required` with payment requirements in headers/body
+3. Client parses requirements and creates payment transaction
+4. Client signs transaction with wallet
+5. Client retries request with `X-Payment` header containing signed transaction
+6. Server verifies payment and grants access
+
+## Supported Networks
+
+- Solana (mainnet, devnet, testnet)
+- More coming soon
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,117 @@
+import { Signer, MultiNetworkSigner, X402Config } from 'x402/types';
+export { MultiNetworkSigner, PaymentRequirements, Signer, X402Config } from 'x402/types';
+import Stripe from 'stripe';
+export { createSigner } from 'x402-fetch';
+export { createPaymentHeader, selectPaymentRequirements } from 'x402/client';
+
+type PromiseOrFn<T> = Promise<T> | (() => Promise<T>);
+/**
+ * Wrap an HTTP call with automatic 402 Payment Required handling
+ *
+ * This utility works with any HTTP API that returns 402 status codes for
+ * payment-required scenarios. It uses the Coinbase x402 protocol to
+ * automatically handle payment flows and retry the request.
+ *
+ * Works with any API client (fetch, axios, Stripe SDK, custom clients, etc.)
+ * that throws errors with a statusCode property.
+ *
+ * @example
+ * // With a wallet client for automatic payment:
+ * await payUpon402(() => fetch('/api/endpoint', { method: 'POST' }), walletClient)
+ *
+ * // Without wallet client (will fail on 402):
+ * await payUpon402(() => apiClient.post('/resource'))
+ */
+declare function payUpon402<T>(promiseOrFn: PromiseOrFn<T>, walletClient?: Signer | MultiNetworkSigner, maxValue?: bigint, config?: X402Config): Promise<T>;
+
+/**
+ * Creates a Stripe client with automatic X402 payment handling
+ *
+ * @param apiKey - Stripe API key
+ * @param walletClient - Optional wallet client for creating payments
+ * @param config - Stripe configuration options
+ * @param x402Config - Optional X402 configuration
+ * @returns A Stripe client instance with payment middleware
+ */
+declare function createStripeClient(apiKey: string, walletClient?: Signer | MultiNetworkSigner, config?: Stripe.StripeConfig, x402Config?: X402Config): Stripe;
+
+/**
+ * Configuration for x402 handler
+ */
+interface X402HandlerConfig {
+    /** Price in smallest unit (e.g., 100 = 0.0001 USDC) */
+    price: number;
+    /** Currency code */
+    currency: string;
+    /** Recipient wallet address */
+    recipient: string;
+    /** Network (defaults to 'solana-mainnet') */
+    network?: string;
+    /** Callback when payment is received */
+    onPayment?: (payment: {
+        amount: number;
+        payer: string;
+        signature?: string;
+    }) => void | Promise<void>;
+}
+/**
+ * Express-compatible request type
+ */
+interface Request {
+    headers: Record<string, string | string[] | undefined>;
+    method?: string;
+    path?: string;
+}
+/**
+ * Express-compatible response type
+ */
+interface Response {
+    status: (code: number) => Response;
+    json: (body: unknown) => void;
+    setHeader: (name: string, value: string) => void;
+}
+/**
+ * Express-compatible next function
+ */
+type NextFunction = (err?: unknown) => void;
+/**
+ * Create an Express middleware handler for x402 payments
+ *
+ * @example
+ * ```typescript
+ * import { createX402Handler } from '@moneymq/x402';
+ *
+ * app.use('/api/protected', createX402Handler({
+ *   price: 100, // 0.0001 USDC
+ *   currency: 'USDC',
+ *   recipient: 'YourWalletAddress...',
+ *   onPayment: async (payment) => {
+ *     console.log(`Received payment from ${payment.payer}`);
+ *   },
+ * }));
+ * ```
+ */
+declare function createX402Handler(config: X402HandlerConfig): (req: Request, res: Response, next: NextFunction) => Promise<void>;
+/**
+ * Shorthand middleware for requiring payment on a route
+ *
+ * @example
+ * ```typescript
+ * import { requirePayment } from '@moneymq/x402';
+ *
+ * app.get('/api/premium',
+ *   requirePayment({ amount: 50, currency: 'USDC' }),
+ *   (req, res) => {
+ *     res.json({ data: 'Premium content' });
+ *   }
+ * );
+ * ```
+ */
+declare function requirePayment(options: {
+    amount: number;
+    currency: string;
+    recipient?: string;
+    network?: string;
+}): (req: Request, res: Response, next: NextFunction) => Promise<void>;
+
+export { createStripeClient, createX402Handler, payUpon402, requirePayment };

package/dist/index.d.ts

@@ -0,0 +1,117 @@
+import { Signer, MultiNetworkSigner, X402Config } from 'x402/types';
+export { MultiNetworkSigner, PaymentRequirements, Signer, X402Config } from 'x402/types';
+import Stripe from 'stripe';
+export { createSigner } from 'x402-fetch';
+export { createPaymentHeader, selectPaymentRequirements } from 'x402/client';
+
+type PromiseOrFn<T> = Promise<T> | (() => Promise<T>);
+/**
+ * Wrap an HTTP call with automatic 402 Payment Required handling
+ *
+ * This utility works with any HTTP API that returns 402 status codes for
+ * payment-required scenarios. It uses the Coinbase x402 protocol to
+ * automatically handle payment flows and retry the request.
+ *
+ * Works with any API client (fetch, axios, Stripe SDK, custom clients, etc.)
+ * that throws errors with a statusCode property.
+ *
+ * @example
+ * // With a wallet client for automatic payment:
+ * await payUpon402(() => fetch('/api/endpoint', { method: 'POST' }), walletClient)
+ *
+ * // Without wallet client (will fail on 402):
+ * await payUpon402(() => apiClient.post('/resource'))
+ */
+declare function payUpon402<T>(promiseOrFn: PromiseOrFn<T>, walletClient?: Signer | MultiNetworkSigner, maxValue?: bigint, config?: X402Config): Promise<T>;
+
+/**
+ * Creates a Stripe client with automatic X402 payment handling
+ *
+ * @param apiKey - Stripe API key
+ * @param walletClient - Optional wallet client for creating payments
+ * @param config - Stripe configuration options
+ * @param x402Config - Optional X402 configuration
+ * @returns A Stripe client instance with payment middleware
+ */
+declare function createStripeClient(apiKey: string, walletClient?: Signer | MultiNetworkSigner, config?: Stripe.StripeConfig, x402Config?: X402Config): Stripe;
+
+/**
+ * Configuration for x402 handler
+ */
+interface X402HandlerConfig {
+    /** Price in smallest unit (e.g., 100 = 0.0001 USDC) */
+    price: number;
+    /** Currency code */
+    currency: string;
+    /** Recipient wallet address */
+    recipient: string;
+    /** Network (defaults to 'solana-mainnet') */
+    network?: string;
+    /** Callback when payment is received */
+    onPayment?: (payment: {
+        amount: number;
+        payer: string;
+        signature?: string;
+    }) => void | Promise<void>;
+}
+/**
+ * Express-compatible request type
+ */
+interface Request {
+    headers: Record<string, string | string[] | undefined>;
+    method?: string;
+    path?: string;
+}
+/**
+ * Express-compatible response type
+ */
+interface Response {
+    status: (code: number) => Response;
+    json: (body: unknown) => void;
+    setHeader: (name: string, value: string) => void;
+}
+/**
+ * Express-compatible next function
+ */
+type NextFunction = (err?: unknown) => void;
+/**
+ * Create an Express middleware handler for x402 payments
+ *
+ * @example
+ * ```typescript
+ * import { createX402Handler } from '@moneymq/x402';
+ *
+ * app.use('/api/protected', createX402Handler({
+ *   price: 100, // 0.0001 USDC
+ *   currency: 'USDC',
+ *   recipient: 'YourWalletAddress...',
+ *   onPayment: async (payment) => {
+ *     console.log(`Received payment from ${payment.payer}`);
+ *   },
+ * }));
+ * ```
+ */
+declare function createX402Handler(config: X402HandlerConfig): (req: Request, res: Response, next: NextFunction) => Promise<void>;
+/**
+ * Shorthand middleware for requiring payment on a route
+ *
+ * @example
+ * ```typescript
+ * import { requirePayment } from '@moneymq/x402';
+ *
+ * app.get('/api/premium',
+ *   requirePayment({ amount: 50, currency: 'USDC' }),
+ *   (req, res) => {
+ *     res.json({ data: 'Premium content' });
+ *   }
+ * );
+ * ```
+ */
+declare function requirePayment(options: {
+    amount: number;
+    currency: string;
+    recipient?: string;
+    network?: string;
+}): (req: Request, res: Response, next: NextFunction) => Promise<void>;
+
+export { createStripeClient, createX402Handler, payUpon402, requirePayment };

package/dist/index.js

@@ -0,0 +1,334 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  createPaymentHeader: () => import_client3.createPaymentHeader,
+  createSigner: () => import_x402_fetch.createSigner,
+  createStripeClient: () => createStripeClient,
+  createX402Handler: () => createX402Handler,
+  payUpon402: () => payUpon402,
+  requirePayment: () => requirePayment,
+  selectPaymentRequirements: () => import_client3.selectPaymentRequirements
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/payUpon402.ts
+var import_client = require("x402/client");
+async function payUpon402(promiseOrFn, walletClient, maxValue = BigInt(0.1 * 10 ** 6), config) {
+  const isFunction = typeof promiseOrFn === "function";
+  const execute = async (_paymentHeader) => {
+    return isFunction ? await promiseOrFn() : await promiseOrFn;
+  };
+  try {
+    return await execute();
+  } catch (error) {
+    const is402 = error?.statusCode === 402 || error?.status === 402 || error?.raw?.statusCode === 402;
+    if (!is402) throw error;
+    console.log("\u{1F4B3} 402 Payment Required - processing payment...");
+    if (!isFunction) {
+      console.warn(
+        "\u26A0\uFE0F  Cannot retry - promise already executed. Use () => syntax for retry support."
+      );
+      throw error;
+    }
+    if (!walletClient) {
+      console.warn("\u26A0\uFE0F  No wallet client provided. Using mock payment (will not actually pay).");
+    }
+    let x402Response;
+    try {
+      if (error?.raw?.payment_requirements !== void 0) {
+        console.log("\u2713 Found payment requirements in Stripe error format");
+        x402Response = {
+          x402Version: 1,
+          // Default to version 1
+          accepts: error.raw.payment_requirements,
+          error: {
+            code: error.raw.code || "payment_required",
+            message: error.raw.message || "Payment required",
+            type: error.raw.type || "invalid_request_error"
+          }
+        };
+      } else if (error?.raw?.body) {
+        console.log("Attempting to parse from error.raw.body");
+        x402Response = typeof error.raw.body === "string" ? JSON.parse(error.raw.body) : error.raw.body;
+      } else if (error?.response?.data) {
+        console.log("Attempting to parse from error.response.data");
+        x402Response = error.response.data;
+      } else if (error?.error) {
+        console.log("Attempting to parse from error.error");
+        x402Response = error.error;
+      } else {
+        throw new Error("Cannot parse 402 response");
+      }
+    } catch (parseError) {
+      console.warn("\u26A0\uFE0F  Failed to parse payment requirements from 402 response");
+      console.error(parseError);
+      throw error;
+    }
+    const { x402Version, accepts } = x402Response;
+    if (!accepts || accepts.length === 0) {
+      console.warn("\u26A0\uFE0F  No payment requirements found in 402 response");
+      throw error;
+    }
+    try {
+      let paymentHeaderValue;
+      if (!walletClient) {
+        console.log("\u{1F4B0} Creating mock payment header...");
+        const mockPayload = {
+          x402Version,
+          scheme: "exact",
+          network: "solana-surfnet",
+          payload: {
+            transaction: "mock_base58_encoded_transaction"
+          }
+        };
+        paymentHeaderValue = Buffer.from(JSON.stringify(mockPayload)).toString("base64");
+      } else {
+        const selectedPaymentRequirement = (0, import_client.selectPaymentRequirements)(
+          accepts,
+          void 0,
+          // Let the selector determine network from wallet
+          "exact"
+        );
+        if (BigInt(selectedPaymentRequirement.maxAmountRequired) > maxValue) {
+          throw new Error(
+            `Payment amount ${selectedPaymentRequirement.maxAmountRequired} exceeds maximum allowed ${maxValue}`
+          );
+        }
+        console.log(`\u{1F4B0} Creating payment for ${selectedPaymentRequirement.network}...`);
+        paymentHeaderValue = await (0, import_client.createPaymentHeader)(
+          walletClient,
+          x402Version,
+          selectedPaymentRequirement,
+          config
+        );
+      }
+      console.log("\u2705 Payment header created, retrying request...");
+      return await execute(paymentHeaderValue);
+    } catch (paymentError) {
+      console.warn("\u26A0\uFE0F  Payment creation failed");
+      console.error(paymentError);
+      throw error;
+    }
+  }
+}
+
+// src/createStripeClient.ts
+var import_stripe = __toESM(require("stripe"));
+var import_client2 = require("x402/client");
+function createStripeClient(apiKey, walletClient, config, x402Config) {
+  const customHttpClient = import_stripe.default.createFetchHttpClient();
+  const originalMakeRequest = customHttpClient.makeRequest.bind(customHttpClient);
+  customHttpClient.makeRequest = async (host, port, path, method, headers, requestData, protocol, timeout) => {
+    console.log(`\u{1F50D} Making request to ${method} ${host}:${port}${path}`);
+    const response = await originalMakeRequest(
+      host,
+      port,
+      path,
+      method,
+      headers,
+      requestData,
+      protocol,
+      timeout
+    );
+    const statusCode = response.getStatusCode();
+    console.log(`\u{1F4E5} Response status: ${statusCode}`);
+    if (statusCode === 402) {
+      console.log("\u{1F4B3} 402 Payment Required - processing payment...");
+      const responseBody = await response.toJSON();
+      console.log("\u{1F4C4} Response body:", JSON.stringify(responseBody, null, 2));
+      const paymentRequirements = responseBody?.payment_requirements || responseBody?.error?.payment_requirements || [];
+      if (paymentRequirements.length === 0) {
+        console.warn("\u26A0\uFE0F  No payment requirements found in 402 response");
+        return response;
+      }
+      let paymentHeaderValue;
+      if (!walletClient) {
+        console.warn("\u26A0\uFE0F  No wallet client provided. Using mock payment (will not actually pay).");
+        const mockPayload = {
+          x402Version: 1,
+          scheme: "exact",
+          network: "solana-surfnet",
+          payload: {
+            transaction: "mock_base58_encoded_transaction"
+          }
+        };
+        paymentHeaderValue = Buffer.from(JSON.stringify(mockPayload)).toString("base64");
+      } else {
+        const selectedPaymentRequirement = (0, import_client2.selectPaymentRequirements)(
+          paymentRequirements,
+          void 0,
+          "exact"
+        );
+        console.log(`\u{1F4B0} Creating payment for ${selectedPaymentRequirement.network}...`);
+        let signer;
+        if ("svm" in walletClient) {
+          signer = walletClient.svm;
+        } else {
+          signer = walletClient;
+        }
+        const effectiveX402Config = {
+          ...x402Config,
+          svmConfig: {
+            rpcUrl: "http://localhost:8899"
+          }
+        };
+        console.log(effectiveX402Config);
+        paymentHeaderValue = await (0, import_client2.createPaymentHeader)(
+          signer,
+          1,
+          // x402Version
+          selectedPaymentRequirement,
+          effectiveX402Config
+        );
+      }
+      console.log("\u2705 Payment header created, retrying request...");
+      const headersWithPayment = {
+        ...headers,
+        "X-Payment": paymentHeaderValue
+      };
+      console.log("\u{1F4E4} Retrying with X-Payment header");
+      return await originalMakeRequest(
+        host,
+        port,
+        path,
+        method,
+        headersWithPayment,
+        requestData,
+        protocol,
+        timeout
+      );
+    }
+    return response;
+  };
+  return new import_stripe.default(apiKey, {
+    ...config,
+    httpClient: customHttpClient,
+    maxNetworkRetries: 0
+    // Disable Stripe's automatic retries so we can handle 402
+  });
+}
+
+// src/middleware.ts
+function createPaymentRequirements(config) {
+  return {
+    scheme: "exact",
+    network: config.network ?? "solana",
+    maxAmountRequired: String(config.price),
+    resource: config.recipient,
+    description: `Payment of ${config.price} ${config.currency}`,
+    mimeType: "application/json",
+    payTo: config.recipient,
+    maxTimeoutSeconds: 60,
+    asset: config.currency,
+    extra: {}
+  };
+}
+async function verifyPaymentHeader(header, _config) {
+  try {
+    const decoded = JSON.parse(Buffer.from(header, "base64").toString("utf-8"));
+    if (!decoded.payload?.transaction) {
+      return { valid: false };
+    }
+    return {
+      valid: true,
+      payer: decoded.payload?.payer ?? "unknown",
+      signature: decoded.payload?.transaction
+    };
+  } catch {
+    return { valid: false };
+  }
+}
+function createX402Handler(config) {
+  return async (req, res, next) => {
+    const paymentHeader = req.headers["x-payment"];
+    if (!paymentHeader) {
+      const requirements = createPaymentRequirements(config);
+      res.status(402);
+      res.setHeader("X-Payment-Requirements", JSON.stringify([requirements]));
+      res.json({
+        error: {
+          code: "payment_required",
+          message: "Payment required to access this resource",
+          type: "invalid_request_error"
+        },
+        payment_requirements: [requirements]
+      });
+      return;
+    }
+    const verification = await verifyPaymentHeader(paymentHeader, config);
+    if (!verification.valid) {
+      res.status(402);
+      res.json({
+        error: {
+          code: "invalid_payment",
+          message: "Invalid payment header",
+          type: "invalid_request_error"
+        }
+      });
+      return;
+    }
+    if (config.onPayment) {
+      await config.onPayment({
+        amount: config.price,
+        payer: verification.payer,
+        signature: verification.signature
+      });
+    }
+    next();
+  };
+}
+function requirePayment(options) {
+  if (!options.recipient) {
+    throw new Error("requirePayment: recipient wallet address is required");
+  }
+  return createX402Handler({
+    price: options.amount,
+    currency: options.currency,
+    recipient: options.recipient,
+    network: options.network
+  });
+}
+
+// src/index.ts
+var import_x402_fetch = require("x402-fetch");
+var import_client3 = require("x402/client");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createPaymentHeader,
+  createSigner,
+  createStripeClient,
+  createX402Handler,
+  payUpon402,
+  requirePayment,
+  selectPaymentRequirements
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/payUpon402.ts","../src/createStripeClient.ts","../src/middleware.ts"],"sourcesContent":["// Main exports\nexport { payUpon402 } from './payUpon402';\nexport { createStripeClient } from './createStripeClient';\nexport { createX402Handler, requirePayment } from './middleware';\n\n// Re-export x402 utilities for convenience\nexport { createSigner } from 'x402-fetch';\nexport { createPaymentHeader, selectPaymentRequirements } from 'x402/client';\nexport type { PaymentRequirements, Signer, MultiNetworkSigner, X402Config } from 'x402/types';\n","import { createPaymentHeader, selectPaymentRequirements } from 'x402/client';\nimport type { Signer, MultiNetworkSigner, X402Config, PaymentRequirements } from 'x402/types';\n\ntype PromiseOrFn<T> = Promise<T> | (() => Promise<T>);\n\ninterface X402Response {\n  x402Version: number;\n  accepts: PaymentRequirements[];\n  error?: {\n    code: string;\n    message: string;\n    type: string;\n  };\n}\n\n/**\n * Wrap an HTTP call with automatic 402 Payment Required handling\n *\n * This utility works with any HTTP API that returns 402 status codes for\n * payment-required scenarios. It uses the Coinbase x402 protocol to\n * automatically handle payment flows and retry the request.\n *\n * Works with any API client (fetch, axios, Stripe SDK, custom clients, etc.)\n * that throws errors with a statusCode property.\n *\n * @example\n * // With a wallet client for automatic payment:\n * await payUpon402(() => fetch('/api/endpoint', { method: 'POST' }), walletClient)\n *\n * // Without wallet client (will fail on 402):\n * await payUpon402(() => apiClient.post('/resource'))\n */\nexport async function payUpon402<T>(\n  promiseOrFn: PromiseOrFn<T>,\n  walletClient?: Signer | MultiNetworkSigner,\n  maxValue: bigint = BigInt(0.1 * 10 ** 6),\n  config?: X402Config,\n): Promise<T> {\n  const isFunction = typeof promiseOrFn === 'function';\n\n  const execute = async (_paymentHeader?: string) => {\n    return isFunction ? await (promiseOrFn as () => Promise<T>)() : await promiseOrFn;\n  };\n\n  try {\n    return await execute();\n  } catch (error: any) {\n    const is402 =\n      error?.statusCode === 402 || error?.status === 402 || error?.raw?.statusCode === 402;\n\n    if (!is402) throw error;\n\n    console.log('💳 402 Payment Required - processing payment...');\n\n    if (!isFunction) {\n      console.warn(\n        '⚠️  Cannot retry - promise already executed. Use () => syntax for retry support.',\n      );\n      throw error;\n    }\n\n    // TODO: For now, use mock wallet client if none provided\n    if (!walletClient) {\n      console.warn('⚠️  No wallet client provided. Using mock payment (will not actually pay).');\n      // Don't throw, continue with mock payment header generation\n    }\n\n    // Extract x402 response from error\n    let x402Response: X402Response;\n    try {\n      // For Stripe SDK errors, the payment requirements are directly in error.raw\n      if (error?.raw?.payment_requirements !== undefined) {\n        console.log('✓ Found payment requirements in Stripe error format');\n        x402Response = {\n          x402Version: 1, // Default to version 1\n          accepts: error.raw.payment_requirements,\n          error: {\n            code: error.raw.code || 'payment_required',\n            message: error.raw.message || 'Payment required',\n            type: error.raw.type || 'invalid_request_error',\n          },\n        };\n      } else if (error?.raw?.body) {\n        console.log('Attempting to parse from error.raw.body');\n        x402Response =\n          typeof error.raw.body === 'string' ? JSON.parse(error.raw.body) : error.raw.body;\n      } else if (error?.response?.data) {\n        console.log('Attempting to parse from error.response.data');\n        x402Response = error.response.data;\n      } else if (error?.error) {\n        console.log('Attempting to parse from error.error');\n        x402Response = error.error;\n      } else {\n        throw new Error('Cannot parse 402 response');\n      }\n    } catch (parseError) {\n      console.warn('⚠️  Failed to parse payment requirements from 402 response');\n      console.error(parseError);\n      throw error;\n    }\n\n    const { x402Version, accepts } = x402Response;\n\n    if (!accepts || accepts.length === 0) {\n      console.warn('⚠️  No payment requirements found in 402 response');\n      throw error;\n    }\n\n    try {\n      let paymentHeaderValue: string;\n\n      if (!walletClient) {\n        // Create a mock payment header for testing\n        console.log('💰 Creating mock payment header...');\n        const mockPayload = {\n          x402Version,\n          scheme: 'exact',\n          network: 'solana-surfnet',\n          payload: {\n            transaction: 'mock_base58_encoded_transaction',\n          },\n        };\n        paymentHeaderValue = Buffer.from(JSON.stringify(mockPayload)).toString('base64');\n      } else {\n        // Select appropriate payment requirement\n        const selectedPaymentRequirement = selectPaymentRequirements(\n          accepts,\n          undefined, // Let the selector determine network from wallet\n          'exact',\n        );\n\n        // Check if payment amount exceeds maximum\n        if (BigInt(selectedPaymentRequirement.maxAmountRequired) > maxValue) {\n          throw new Error(\n            `Payment amount ${selectedPaymentRequirement.maxAmountRequired} exceeds maximum allowed ${maxValue}`,\n          );\n        }\n\n        console.log(`💰 Creating payment for ${selectedPaymentRequirement.network}...`);\n\n        // Create payment header using Coinbase x402 library\n        paymentHeaderValue = await createPaymentHeader(\n          walletClient,\n          x402Version,\n          selectedPaymentRequirement,\n          config,\n        );\n      }\n\n      console.log('✅ Payment header created, retrying request...');\n\n      // Retry the request - this is simplified, real implementation would\n      // need to inject the X-PAYMENT header into the original request\n      return await execute(paymentHeaderValue);\n    } catch (paymentError) {\n      console.warn('⚠️  Payment creation failed');\n      console.error(paymentError);\n      throw error;\n    }\n  }\n}\n","import Stripe from 'stripe';\nimport { createPaymentHeader, selectPaymentRequirements } from 'x402/client';\nimport type { Signer, MultiNetworkSigner, X402Config, PaymentRequirements } from 'x402/types';\n\n/**\n * Creates a Stripe client with automatic X402 payment handling\n *\n * @param apiKey - Stripe API key\n * @param walletClient - Optional wallet client for creating payments\n * @param config - Stripe configuration options\n * @param x402Config - Optional X402 configuration\n * @returns A Stripe client instance with payment middleware\n */\nexport function createStripeClient(\n  apiKey: string,\n  walletClient?: Signer | MultiNetworkSigner,\n  config?: Stripe.StripeConfig,\n  x402Config?: X402Config,\n): Stripe {\n  // Create a custom HTTP client that wraps fetch\n  const customHttpClient = Stripe.createFetchHttpClient();\n\n  // Wrap the makeRequest method to add X-Payment header on retry\n  const originalMakeRequest = customHttpClient.makeRequest.bind(customHttpClient);\n\n  customHttpClient.makeRequest = async (\n    host: string,\n    port: string | number,\n    path: string,\n    method: 'GET' | 'POST' | 'PUT' | 'DELETE',\n    headers: object,\n    requestData: string | null,\n    protocol: Stripe.HttpProtocol,\n    timeout: number,\n  ) => {\n    console.log(`🔍 Making request to ${method} ${host}:${port}${path}`);\n\n    // Make the initial request\n    const response = await originalMakeRequest(\n      host,\n      port,\n      path,\n      method,\n      headers,\n      requestData,\n      protocol,\n      timeout,\n    );\n\n    const statusCode = response.getStatusCode();\n    console.log(`📥 Response status: ${statusCode}`);\n\n    // Check if this is a 402 Payment Required response\n    if (statusCode === 402) {\n      console.log('💳 402 Payment Required - processing payment...');\n\n      // Parse the response body to get payment requirements\n      const responseBody = (await response.toJSON()) as any;\n      console.log('📄 Response body:', JSON.stringify(responseBody, null, 2));\n\n      const paymentRequirements: PaymentRequirements[] =\n        responseBody?.payment_requirements || responseBody?.error?.payment_requirements || [];\n\n      if (paymentRequirements.length === 0) {\n        console.warn('⚠️  No payment requirements found in 402 response');\n        return response;\n      }\n\n      let paymentHeaderValue: string;\n\n      if (!walletClient) {\n        // Create mock payment header\n        console.warn('⚠️  No wallet client provided. Using mock payment (will not actually pay).');\n        const mockPayload = {\n          x402Version: 1,\n          scheme: 'exact',\n          network: 'solana-surfnet',\n          payload: {\n            transaction: 'mock_base58_encoded_transaction',\n          },\n        };\n        paymentHeaderValue = Buffer.from(JSON.stringify(mockPayload)).toString('base64');\n      } else {\n        // Select appropriate payment requirement\n        const selectedPaymentRequirement = selectPaymentRequirements(\n          paymentRequirements,\n          undefined,\n          'exact',\n        );\n\n        console.log(`💰 Creating payment for ${selectedPaymentRequirement.network}...`);\n\n        // Extract the appropriate signer for the network\n        let signer: Signer;\n        if ('svm' in walletClient) {\n          // MultiNetworkSigner - extract the svm signer\n          signer = walletClient.svm;\n        } else {\n          // Already a Signer\n          signer = walletClient;\n        }\n\n        // Create payment header using Coinbase x402 library\n        // Add svmConfig with local RPC URL for local testing\n        const effectiveX402Config = {\n          ...x402Config,\n          svmConfig: {\n            rpcUrl: 'http://localhost:8899',\n          },\n        };\n        console.log(effectiveX402Config);\n\n        paymentHeaderValue = await createPaymentHeader(\n          signer,\n          1, // x402Version\n          selectedPaymentRequirement,\n          effectiveX402Config,\n        );\n      }\n\n      console.log('✅ Payment header created, retrying request...');\n\n      // Retry with X-Payment header\n      const headersWithPayment = {\n        ...(headers as Record<string, string>),\n        'X-Payment': paymentHeaderValue,\n      };\n\n      console.log('📤 Retrying with X-Payment header');\n\n      return await originalMakeRequest(\n        host,\n        port,\n        path,\n        method,\n        headersWithPayment,\n        requestData,\n        protocol,\n        timeout,\n      );\n    }\n\n    return response;\n  };\n\n  return new Stripe(apiKey, {\n    ...config,\n    httpClient: customHttpClient,\n    maxNetworkRetries: 0, // Disable Stripe's automatic retries so we can handle 402\n  });\n}\n","import type { PaymentRequirements } from 'x402/types';\n\n/**\n * Configuration for x402 handler\n */\nexport interface X402HandlerConfig {\n  /** Price in smallest unit (e.g., 100 = 0.0001 USDC) */\n  price: number;\n  /** Currency code */\n  currency: string;\n  /** Recipient wallet address */\n  recipient: string;\n  /** Network (defaults to 'solana-mainnet') */\n  network?: string;\n  /** Callback when payment is received */\n  onPayment?: (payment: {\n    amount: number;\n    payer: string;\n    signature?: string;\n  }) => void | Promise<void>;\n}\n\n/**\n * Express-compatible request type\n */\ninterface Request {\n  headers: Record<string, string | string[] | undefined>;\n  method?: string;\n  path?: string;\n}\n\n/**\n * Express-compatible response type\n */\ninterface Response {\n  status: (code: number) => Response;\n  json: (body: unknown) => void;\n  setHeader: (name: string, value: string) => void;\n}\n\n/**\n * Express-compatible next function\n */\ntype NextFunction = (err?: unknown) => void;\n\n/**\n * Create payment requirements for 402 response\n */\nfunction createPaymentRequirements(config: X402HandlerConfig): PaymentRequirements {\n  return {\n    scheme: 'exact',\n    network: (config.network ?? 'solana') as PaymentRequirements['network'],\n    maxAmountRequired: String(config.price),\n    resource: config.recipient,\n    description: `Payment of ${config.price} ${config.currency}`,\n    mimeType: 'application/json',\n    payTo: config.recipient,\n    maxTimeoutSeconds: 60,\n    asset: config.currency,\n    extra: {},\n  };\n}\n\n/**\n * Verify x402 payment header\n */\nasync function verifyPaymentHeader(\n  header: string,\n  _config: X402HandlerConfig,\n): Promise<{ valid: boolean; payer?: string; signature?: string }> {\n  try {\n    const decoded = JSON.parse(Buffer.from(header, 'base64').toString('utf-8'));\n\n    // Basic validation - in production, verify the actual transaction\n    if (!decoded.payload?.transaction) {\n      return { valid: false };\n    }\n\n    // TODO: Implement actual transaction verification\n    // For now, accept any properly formatted header\n    return {\n      valid: true,\n      payer: decoded.payload?.payer ?? 'unknown',\n      signature: decoded.payload?.transaction,\n    };\n  } catch {\n    return { valid: false };\n  }\n}\n\n/**\n * Create an Express middleware handler for x402 payments\n *\n * @example\n * ```typescript\n * import { createX402Handler } from '@moneymq/x402';\n *\n * app.use('/api/protected', createX402Handler({\n *   price: 100, // 0.0001 USDC\n *   currency: 'USDC',\n *   recipient: 'YourWalletAddress...',\n *   onPayment: async (payment) => {\n *     console.log(`Received payment from ${payment.payer}`);\n *   },\n * }));\n * ```\n */\nexport function createX402Handler(config: X402HandlerConfig) {\n  return async (req: Request, res: Response, next: NextFunction) => {\n    const paymentHeader = req.headers['x-payment'] as string | undefined;\n\n    if (!paymentHeader) {\n      // Return 402 Payment Required\n      const requirements = createPaymentRequirements(config);\n\n      res.status(402);\n      res.setHeader('X-Payment-Requirements', JSON.stringify([requirements]));\n      res.json({\n        error: {\n          code: 'payment_required',\n          message: 'Payment required to access this resource',\n          type: 'invalid_request_error',\n        },\n        payment_requirements: [requirements],\n      });\n      return;\n    }\n\n    // Verify payment\n    const verification = await verifyPaymentHeader(paymentHeader, config);\n\n    if (!verification.valid) {\n      res.status(402);\n      res.json({\n        error: {\n          code: 'invalid_payment',\n          message: 'Invalid payment header',\n          type: 'invalid_request_error',\n        },\n      });\n      return;\n    }\n\n    // Payment verified - call onPayment callback if provided\n    if (config.onPayment) {\n      await config.onPayment({\n        amount: config.price,\n        payer: verification.payer!,\n        signature: verification.signature,\n      });\n    }\n\n    // Continue to next handler\n    next();\n  };\n}\n\n/**\n * Shorthand middleware for requiring payment on a route\n *\n * @example\n * ```typescript\n * import { requirePayment } from '@moneymq/x402';\n *\n * app.get('/api/premium',\n *   requirePayment({ amount: 50, currency: 'USDC' }),\n *   (req, res) => {\n *     res.json({ data: 'Premium content' });\n *   }\n * );\n * ```\n */\nexport function requirePayment(options: {\n  amount: number;\n  currency: string;\n  recipient?: string;\n  network?: string;\n}) {\n  if (!options.recipient) {\n    throw new Error('requirePayment: recipient wallet address is required');\n  }\n\n  return createX402Handler({\n    price: options.amount,\n    currency: options.currency,\n    recipient: options.recipient,\n    network: options.network,\n  });\n}\n"],"mappings":"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","names":["import_client","Stripe","import_client"]}

package/dist/index.mjs

@@ -0,0 +1,291 @@
+// src/payUpon402.ts
+import { createPaymentHeader, selectPaymentRequirements } from "x402/client";
+async function payUpon402(promiseOrFn, walletClient, maxValue = BigInt(0.1 * 10 ** 6), config) {
+  const isFunction = typeof promiseOrFn === "function";
+  const execute = async (_paymentHeader) => {
+    return isFunction ? await promiseOrFn() : await promiseOrFn;
+  };
+  try {
+    return await execute();
+  } catch (error) {
+    const is402 = error?.statusCode === 402 || error?.status === 402 || error?.raw?.statusCode === 402;
+    if (!is402) throw error;
+    console.log("\u{1F4B3} 402 Payment Required - processing payment...");
+    if (!isFunction) {
+      console.warn(
+        "\u26A0\uFE0F  Cannot retry - promise already executed. Use () => syntax for retry support."
+      );
+      throw error;
+    }
+    if (!walletClient) {
+      console.warn("\u26A0\uFE0F  No wallet client provided. Using mock payment (will not actually pay).");
+    }
+    let x402Response;
+    try {
+      if (error?.raw?.payment_requirements !== void 0) {
+        console.log("\u2713 Found payment requirements in Stripe error format");
+        x402Response = {
+          x402Version: 1,
+          // Default to version 1
+          accepts: error.raw.payment_requirements,
+          error: {
+            code: error.raw.code || "payment_required",
+            message: error.raw.message || "Payment required",
+            type: error.raw.type || "invalid_request_error"
+          }
+        };
+      } else if (error?.raw?.body) {
+        console.log("Attempting to parse from error.raw.body");
+        x402Response = typeof error.raw.body === "string" ? JSON.parse(error.raw.body) : error.raw.body;
+      } else if (error?.response?.data) {
+        console.log("Attempting to parse from error.response.data");
+        x402Response = error.response.data;
+      } else if (error?.error) {
+        console.log("Attempting to parse from error.error");
+        x402Response = error.error;
+      } else {
+        throw new Error("Cannot parse 402 response");
+      }
+    } catch (parseError) {
+      console.warn("\u26A0\uFE0F  Failed to parse payment requirements from 402 response");
+      console.error(parseError);
+      throw error;
+    }
+    const { x402Version, accepts } = x402Response;
+    if (!accepts || accepts.length === 0) {
+      console.warn("\u26A0\uFE0F  No payment requirements found in 402 response");
+      throw error;
+    }
+    try {
+      let paymentHeaderValue;
+      if (!walletClient) {
+        console.log("\u{1F4B0} Creating mock payment header...");
+        const mockPayload = {
+          x402Version,
+          scheme: "exact",
+          network: "solana-surfnet",
+          payload: {
+            transaction: "mock_base58_encoded_transaction"
+          }
+        };
+        paymentHeaderValue = Buffer.from(JSON.stringify(mockPayload)).toString("base64");
+      } else {
+        const selectedPaymentRequirement = selectPaymentRequirements(
+          accepts,
+          void 0,
+          // Let the selector determine network from wallet
+          "exact"
+        );
+        if (BigInt(selectedPaymentRequirement.maxAmountRequired) > maxValue) {
+          throw new Error(
+            `Payment amount ${selectedPaymentRequirement.maxAmountRequired} exceeds maximum allowed ${maxValue}`
+          );
+        }
+        console.log(`\u{1F4B0} Creating payment for ${selectedPaymentRequirement.network}...`);
+        paymentHeaderValue = await createPaymentHeader(
+          walletClient,
+          x402Version,
+          selectedPaymentRequirement,
+          config
+        );
+      }
+      console.log("\u2705 Payment header created, retrying request...");
+      return await execute(paymentHeaderValue);
+    } catch (paymentError) {
+      console.warn("\u26A0\uFE0F  Payment creation failed");
+      console.error(paymentError);
+      throw error;
+    }
+  }
+}
+
+// src/createStripeClient.ts
+import Stripe from "stripe";
+import { createPaymentHeader as createPaymentHeader2, selectPaymentRequirements as selectPaymentRequirements2 } from "x402/client";
+function createStripeClient(apiKey, walletClient, config, x402Config) {
+  const customHttpClient = Stripe.createFetchHttpClient();
+  const originalMakeRequest = customHttpClient.makeRequest.bind(customHttpClient);
+  customHttpClient.makeRequest = async (host, port, path, method, headers, requestData, protocol, timeout) => {
+    console.log(`\u{1F50D} Making request to ${method} ${host}:${port}${path}`);
+    const response = await originalMakeRequest(
+      host,
+      port,
+      path,
+      method,
+      headers,
+      requestData,
+      protocol,
+      timeout
+    );
+    const statusCode = response.getStatusCode();
+    console.log(`\u{1F4E5} Response status: ${statusCode}`);
+    if (statusCode === 402) {
+      console.log("\u{1F4B3} 402 Payment Required - processing payment...");
+      const responseBody = await response.toJSON();
+      console.log("\u{1F4C4} Response body:", JSON.stringify(responseBody, null, 2));
+      const paymentRequirements = responseBody?.payment_requirements || responseBody?.error?.payment_requirements || [];
+      if (paymentRequirements.length === 0) {
+        console.warn("\u26A0\uFE0F  No payment requirements found in 402 response");
+        return response;
+      }
+      let paymentHeaderValue;
+      if (!walletClient) {
+        console.warn("\u26A0\uFE0F  No wallet client provided. Using mock payment (will not actually pay).");
+        const mockPayload = {
+          x402Version: 1,
+          scheme: "exact",
+          network: "solana-surfnet",
+          payload: {
+            transaction: "mock_base58_encoded_transaction"
+          }
+        };
+        paymentHeaderValue = Buffer.from(JSON.stringify(mockPayload)).toString("base64");
+      } else {
+        const selectedPaymentRequirement = selectPaymentRequirements2(
+          paymentRequirements,
+          void 0,
+          "exact"
+        );
+        console.log(`\u{1F4B0} Creating payment for ${selectedPaymentRequirement.network}...`);
+        let signer;
+        if ("svm" in walletClient) {
+          signer = walletClient.svm;
+        } else {
+          signer = walletClient;
+        }
+        const effectiveX402Config = {
+          ...x402Config,
+          svmConfig: {
+            rpcUrl: "http://localhost:8899"
+          }
+        };
+        console.log(effectiveX402Config);
+        paymentHeaderValue = await createPaymentHeader2(
+          signer,
+          1,
+          // x402Version
+          selectedPaymentRequirement,
+          effectiveX402Config
+        );
+      }
+      console.log("\u2705 Payment header created, retrying request...");
+      const headersWithPayment = {
+        ...headers,
+        "X-Payment": paymentHeaderValue
+      };
+      console.log("\u{1F4E4} Retrying with X-Payment header");
+      return await originalMakeRequest(
+        host,
+        port,
+        path,
+        method,
+        headersWithPayment,
+        requestData,
+        protocol,
+        timeout
+      );
+    }
+    return response;
+  };
+  return new Stripe(apiKey, {
+    ...config,
+    httpClient: customHttpClient,
+    maxNetworkRetries: 0
+    // Disable Stripe's automatic retries so we can handle 402
+  });
+}
+
+// src/middleware.ts
+function createPaymentRequirements(config) {
+  return {
+    scheme: "exact",
+    network: config.network ?? "solana",
+    maxAmountRequired: String(config.price),
+    resource: config.recipient,
+    description: `Payment of ${config.price} ${config.currency}`,
+    mimeType: "application/json",
+    payTo: config.recipient,
+    maxTimeoutSeconds: 60,
+    asset: config.currency,
+    extra: {}
+  };
+}
+async function verifyPaymentHeader(header, _config) {
+  try {
+    const decoded = JSON.parse(Buffer.from(header, "base64").toString("utf-8"));
+    if (!decoded.payload?.transaction) {
+      return { valid: false };
+    }
+    return {
+      valid: true,
+      payer: decoded.payload?.payer ?? "unknown",
+      signature: decoded.payload?.transaction
+    };
+  } catch {
+    return { valid: false };
+  }
+}
+function createX402Handler(config) {
+  return async (req, res, next) => {
+    const paymentHeader = req.headers["x-payment"];
+    if (!paymentHeader) {
+      const requirements = createPaymentRequirements(config);
+      res.status(402);
+      res.setHeader("X-Payment-Requirements", JSON.stringify([requirements]));
+      res.json({
+        error: {
+          code: "payment_required",
+          message: "Payment required to access this resource",
+          type: "invalid_request_error"
+        },
+        payment_requirements: [requirements]
+      });
+      return;
+    }
+    const verification = await verifyPaymentHeader(paymentHeader, config);
+    if (!verification.valid) {
+      res.status(402);
+      res.json({
+        error: {
+          code: "invalid_payment",
+          message: "Invalid payment header",
+          type: "invalid_request_error"
+        }
+      });
+      return;
+    }
+    if (config.onPayment) {
+      await config.onPayment({
+        amount: config.price,
+        payer: verification.payer,
+        signature: verification.signature
+      });
+    }
+    next();
+  };
+}
+function requirePayment(options) {
+  if (!options.recipient) {
+    throw new Error("requirePayment: recipient wallet address is required");
+  }
+  return createX402Handler({
+    price: options.amount,
+    currency: options.currency,
+    recipient: options.recipient,
+    network: options.network
+  });
+}
+
+// src/index.ts
+import { createSigner } from "x402-fetch";
+import { createPaymentHeader as createPaymentHeader3, selectPaymentRequirements as selectPaymentRequirements3 } from "x402/client";
+export {
+  createPaymentHeader3 as createPaymentHeader,
+  createSigner,
+  createStripeClient,
+  createX402Handler,
+  payUpon402,
+  requirePayment,
+  selectPaymentRequirements3 as selectPaymentRequirements
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/payUpon402.ts","../src/createStripeClient.ts","../src/middleware.ts","../src/index.ts"],"sourcesContent":["import { createPaymentHeader, selectPaymentRequirements } from 'x402/client';\nimport type { Signer, MultiNetworkSigner, X402Config, PaymentRequirements } from 'x402/types';\n\ntype PromiseOrFn<T> = Promise<T> | (() => Promise<T>);\n\ninterface X402Response {\n  x402Version: number;\n  accepts: PaymentRequirements[];\n  error?: {\n    code: string;\n    message: string;\n    type: string;\n  };\n}\n\n/**\n * Wrap an HTTP call with automatic 402 Payment Required handling\n *\n * This utility works with any HTTP API that returns 402 status codes for\n * payment-required scenarios. It uses the Coinbase x402 protocol to\n * automatically handle payment flows and retry the request.\n *\n * Works with any API client (fetch, axios, Stripe SDK, custom clients, etc.)\n * that throws errors with a statusCode property.\n *\n * @example\n * // With a wallet client for automatic payment:\n * await payUpon402(() => fetch('/api/endpoint', { method: 'POST' }), walletClient)\n *\n * // Without wallet client (will fail on 402):\n * await payUpon402(() => apiClient.post('/resource'))\n */\nexport async function payUpon402<T>(\n  promiseOrFn: PromiseOrFn<T>,\n  walletClient?: Signer | MultiNetworkSigner,\n  maxValue: bigint = BigInt(0.1 * 10 ** 6),\n  config?: X402Config,\n): Promise<T> {\n  const isFunction = typeof promiseOrFn === 'function';\n\n  const execute = async (_paymentHeader?: string) => {\n    return isFunction ? await (promiseOrFn as () => Promise<T>)() : await promiseOrFn;\n  };\n\n  try {\n    return await execute();\n  } catch (error: any) {\n    const is402 =\n      error?.statusCode === 402 || error?.status === 402 || error?.raw?.statusCode === 402;\n\n    if (!is402) throw error;\n\n    console.log('💳 402 Payment Required - processing payment...');\n\n    if (!isFunction) {\n      console.warn(\n        '⚠️  Cannot retry - promise already executed. Use () => syntax for retry support.',\n      );\n      throw error;\n    }\n\n    // TODO: For now, use mock wallet client if none provided\n    if (!walletClient) {\n      console.warn('⚠️  No wallet client provided. Using mock payment (will not actually pay).');\n      // Don't throw, continue with mock payment header generation\n    }\n\n    // Extract x402 response from error\n    let x402Response: X402Response;\n    try {\n      // For Stripe SDK errors, the payment requirements are directly in error.raw\n      if (error?.raw?.payment_requirements !== undefined) {\n        console.log('✓ Found payment requirements in Stripe error format');\n        x402Response = {\n          x402Version: 1, // Default to version 1\n          accepts: error.raw.payment_requirements,\n          error: {\n            code: error.raw.code || 'payment_required',\n            message: error.raw.message || 'Payment required',\n            type: error.raw.type || 'invalid_request_error',\n          },\n        };\n      } else if (error?.raw?.body) {\n        console.log('Attempting to parse from error.raw.body');\n        x402Response =\n          typeof error.raw.body === 'string' ? JSON.parse(error.raw.body) : error.raw.body;\n      } else if (error?.response?.data) {\n        console.log('Attempting to parse from error.response.data');\n        x402Response = error.response.data;\n      } else if (error?.error) {\n        console.log('Attempting to parse from error.error');\n        x402Response = error.error;\n      } else {\n        throw new Error('Cannot parse 402 response');\n      }\n    } catch (parseError) {\n      console.warn('⚠️  Failed to parse payment requirements from 402 response');\n      console.error(parseError);\n      throw error;\n    }\n\n    const { x402Version, accepts } = x402Response;\n\n    if (!accepts || accepts.length === 0) {\n      console.warn('⚠️  No payment requirements found in 402 response');\n      throw error;\n    }\n\n    try {\n      let paymentHeaderValue: string;\n\n      if (!walletClient) {\n        // Create a mock payment header for testing\n        console.log('💰 Creating mock payment header...');\n        const mockPayload = {\n          x402Version,\n          scheme: 'exact',\n          network: 'solana-surfnet',\n          payload: {\n            transaction: 'mock_base58_encoded_transaction',\n          },\n        };\n        paymentHeaderValue = Buffer.from(JSON.stringify(mockPayload)).toString('base64');\n      } else {\n        // Select appropriate payment requirement\n        const selectedPaymentRequirement = selectPaymentRequirements(\n          accepts,\n          undefined, // Let the selector determine network from wallet\n          'exact',\n        );\n\n        // Check if payment amount exceeds maximum\n        if (BigInt(selectedPaymentRequirement.maxAmountRequired) > maxValue) {\n          throw new Error(\n            `Payment amount ${selectedPaymentRequirement.maxAmountRequired} exceeds maximum allowed ${maxValue}`,\n          );\n        }\n\n        console.log(`💰 Creating payment for ${selectedPaymentRequirement.network}...`);\n\n        // Create payment header using Coinbase x402 library\n        paymentHeaderValue = await createPaymentHeader(\n          walletClient,\n          x402Version,\n          selectedPaymentRequirement,\n          config,\n        );\n      }\n\n      console.log('✅ Payment header created, retrying request...');\n\n      // Retry the request - this is simplified, real implementation would\n      // need to inject the X-PAYMENT header into the original request\n      return await execute(paymentHeaderValue);\n    } catch (paymentError) {\n      console.warn('⚠️  Payment creation failed');\n      console.error(paymentError);\n      throw error;\n    }\n  }\n}\n","import Stripe from 'stripe';\nimport { createPaymentHeader, selectPaymentRequirements } from 'x402/client';\nimport type { Signer, MultiNetworkSigner, X402Config, PaymentRequirements } from 'x402/types';\n\n/**\n * Creates a Stripe client with automatic X402 payment handling\n *\n * @param apiKey - Stripe API key\n * @param walletClient - Optional wallet client for creating payments\n * @param config - Stripe configuration options\n * @param x402Config - Optional X402 configuration\n * @returns A Stripe client instance with payment middleware\n */\nexport function createStripeClient(\n  apiKey: string,\n  walletClient?: Signer | MultiNetworkSigner,\n  config?: Stripe.StripeConfig,\n  x402Config?: X402Config,\n): Stripe {\n  // Create a custom HTTP client that wraps fetch\n  const customHttpClient = Stripe.createFetchHttpClient();\n\n  // Wrap the makeRequest method to add X-Payment header on retry\n  const originalMakeRequest = customHttpClient.makeRequest.bind(customHttpClient);\n\n  customHttpClient.makeRequest = async (\n    host: string,\n    port: string | number,\n    path: string,\n    method: 'GET' | 'POST' | 'PUT' | 'DELETE',\n    headers: object,\n    requestData: string | null,\n    protocol: Stripe.HttpProtocol,\n    timeout: number,\n  ) => {\n    console.log(`🔍 Making request to ${method} ${host}:${port}${path}`);\n\n    // Make the initial request\n    const response = await originalMakeRequest(\n      host,\n      port,\n      path,\n      method,\n      headers,\n      requestData,\n      protocol,\n      timeout,\n    );\n\n    const statusCode = response.getStatusCode();\n    console.log(`📥 Response status: ${statusCode}`);\n\n    // Check if this is a 402 Payment Required response\n    if (statusCode === 402) {\n      console.log('💳 402 Payment Required - processing payment...');\n\n      // Parse the response body to get payment requirements\n      const responseBody = (await response.toJSON()) as any;\n      console.log('📄 Response body:', JSON.stringify(responseBody, null, 2));\n\n      const paymentRequirements: PaymentRequirements[] =\n        responseBody?.payment_requirements || responseBody?.error?.payment_requirements || [];\n\n      if (paymentRequirements.length === 0) {\n        console.warn('⚠️  No payment requirements found in 402 response');\n        return response;\n      }\n\n      let paymentHeaderValue: string;\n\n      if (!walletClient) {\n        // Create mock payment header\n        console.warn('⚠️  No wallet client provided. Using mock payment (will not actually pay).');\n        const mockPayload = {\n          x402Version: 1,\n          scheme: 'exact',\n          network: 'solana-surfnet',\n          payload: {\n            transaction: 'mock_base58_encoded_transaction',\n          },\n        };\n        paymentHeaderValue = Buffer.from(JSON.stringify(mockPayload)).toString('base64');\n      } else {\n        // Select appropriate payment requirement\n        const selectedPaymentRequirement = selectPaymentRequirements(\n          paymentRequirements,\n          undefined,\n          'exact',\n        );\n\n        console.log(`💰 Creating payment for ${selectedPaymentRequirement.network}...`);\n\n        // Extract the appropriate signer for the network\n        let signer: Signer;\n        if ('svm' in walletClient) {\n          // MultiNetworkSigner - extract the svm signer\n          signer = walletClient.svm;\n        } else {\n          // Already a Signer\n          signer = walletClient;\n        }\n\n        // Create payment header using Coinbase x402 library\n        // Add svmConfig with local RPC URL for local testing\n        const effectiveX402Config = {\n          ...x402Config,\n          svmConfig: {\n            rpcUrl: 'http://localhost:8899',\n          },\n        };\n        console.log(effectiveX402Config);\n\n        paymentHeaderValue = await createPaymentHeader(\n          signer,\n          1, // x402Version\n          selectedPaymentRequirement,\n          effectiveX402Config,\n        );\n      }\n\n      console.log('✅ Payment header created, retrying request...');\n\n      // Retry with X-Payment header\n      const headersWithPayment = {\n        ...(headers as Record<string, string>),\n        'X-Payment': paymentHeaderValue,\n      };\n\n      console.log('📤 Retrying with X-Payment header');\n\n      return await originalMakeRequest(\n        host,\n        port,\n        path,\n        method,\n        headersWithPayment,\n        requestData,\n        protocol,\n        timeout,\n      );\n    }\n\n    return response;\n  };\n\n  return new Stripe(apiKey, {\n    ...config,\n    httpClient: customHttpClient,\n    maxNetworkRetries: 0, // Disable Stripe's automatic retries so we can handle 402\n  });\n}\n","import type { PaymentRequirements } from 'x402/types';\n\n/**\n * Configuration for x402 handler\n */\nexport interface X402HandlerConfig {\n  /** Price in smallest unit (e.g., 100 = 0.0001 USDC) */\n  price: number;\n  /** Currency code */\n  currency: string;\n  /** Recipient wallet address */\n  recipient: string;\n  /** Network (defaults to 'solana-mainnet') */\n  network?: string;\n  /** Callback when payment is received */\n  onPayment?: (payment: {\n    amount: number;\n    payer: string;\n    signature?: string;\n  }) => void | Promise<void>;\n}\n\n/**\n * Express-compatible request type\n */\ninterface Request {\n  headers: Record<string, string | string[] | undefined>;\n  method?: string;\n  path?: string;\n}\n\n/**\n * Express-compatible response type\n */\ninterface Response {\n  status: (code: number) => Response;\n  json: (body: unknown) => void;\n  setHeader: (name: string, value: string) => void;\n}\n\n/**\n * Express-compatible next function\n */\ntype NextFunction = (err?: unknown) => void;\n\n/**\n * Create payment requirements for 402 response\n */\nfunction createPaymentRequirements(config: X402HandlerConfig): PaymentRequirements {\n  return {\n    scheme: 'exact',\n    network: (config.network ?? 'solana') as PaymentRequirements['network'],\n    maxAmountRequired: String(config.price),\n    resource: config.recipient,\n    description: `Payment of ${config.price} ${config.currency}`,\n    mimeType: 'application/json',\n    payTo: config.recipient,\n    maxTimeoutSeconds: 60,\n    asset: config.currency,\n    extra: {},\n  };\n}\n\n/**\n * Verify x402 payment header\n */\nasync function verifyPaymentHeader(\n  header: string,\n  _config: X402HandlerConfig,\n): Promise<{ valid: boolean; payer?: string; signature?: string }> {\n  try {\n    const decoded = JSON.parse(Buffer.from(header, 'base64').toString('utf-8'));\n\n    // Basic validation - in production, verify the actual transaction\n    if (!decoded.payload?.transaction) {\n      return { valid: false };\n    }\n\n    // TODO: Implement actual transaction verification\n    // For now, accept any properly formatted header\n    return {\n      valid: true,\n      payer: decoded.payload?.payer ?? 'unknown',\n      signature: decoded.payload?.transaction,\n    };\n  } catch {\n    return { valid: false };\n  }\n}\n\n/**\n * Create an Express middleware handler for x402 payments\n *\n * @example\n * ```typescript\n * import { createX402Handler } from '@moneymq/x402';\n *\n * app.use('/api/protected', createX402Handler({\n *   price: 100, // 0.0001 USDC\n *   currency: 'USDC',\n *   recipient: 'YourWalletAddress...',\n *   onPayment: async (payment) => {\n *     console.log(`Received payment from ${payment.payer}`);\n *   },\n * }));\n * ```\n */\nexport function createX402Handler(config: X402HandlerConfig) {\n  return async (req: Request, res: Response, next: NextFunction) => {\n    const paymentHeader = req.headers['x-payment'] as string | undefined;\n\n    if (!paymentHeader) {\n      // Return 402 Payment Required\n      const requirements = createPaymentRequirements(config);\n\n      res.status(402);\n      res.setHeader('X-Payment-Requirements', JSON.stringify([requirements]));\n      res.json({\n        error: {\n          code: 'payment_required',\n          message: 'Payment required to access this resource',\n          type: 'invalid_request_error',\n        },\n        payment_requirements: [requirements],\n      });\n      return;\n    }\n\n    // Verify payment\n    const verification = await verifyPaymentHeader(paymentHeader, config);\n\n    if (!verification.valid) {\n      res.status(402);\n      res.json({\n        error: {\n          code: 'invalid_payment',\n          message: 'Invalid payment header',\n          type: 'invalid_request_error',\n        },\n      });\n      return;\n    }\n\n    // Payment verified - call onPayment callback if provided\n    if (config.onPayment) {\n      await config.onPayment({\n        amount: config.price,\n        payer: verification.payer!,\n        signature: verification.signature,\n      });\n    }\n\n    // Continue to next handler\n    next();\n  };\n}\n\n/**\n * Shorthand middleware for requiring payment on a route\n *\n * @example\n * ```typescript\n * import { requirePayment } from '@moneymq/x402';\n *\n * app.get('/api/premium',\n *   requirePayment({ amount: 50, currency: 'USDC' }),\n *   (req, res) => {\n *     res.json({ data: 'Premium content' });\n *   }\n * );\n * ```\n */\nexport function requirePayment(options: {\n  amount: number;\n  currency: string;\n  recipient?: string;\n  network?: string;\n}) {\n  if (!options.recipient) {\n    throw new Error('requirePayment: recipient wallet address is required');\n  }\n\n  return createX402Handler({\n    price: options.amount,\n    currency: options.currency,\n    recipient: options.recipient,\n    network: options.network,\n  });\n}\n","// Main exports\nexport { payUpon402 } from './payUpon402';\nexport { createStripeClient } from './createStripeClient';\nexport { createX402Handler, requirePayment } from './middleware';\n\n// Re-export x402 utilities for convenience\nexport { createSigner } from 'x402-fetch';\nexport { createPaymentHeader, selectPaymentRequirements } from 'x402/client';\nexport type { PaymentRequirements, Signer, MultiNetworkSigner, X402Config } from 'x402/types';\n"],"mappings":"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","names":["createPaymentHeader","selectPaymentRequirements","createPaymentHeader","selectPaymentRequirements"]}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@moneymq/x402",
+  "version": "0.1.0",
+  "description": "x402 protocol integration for MoneyMQ",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/txtx/moneymq-js.git",
+    "directory": "packages/x402"
+  },
+  "keywords": [
+    "moneymq",
+    "x402",
+    "payments",
+    "micropayments",
+    "stablecoin"
+  ],
+  "author": "MoneyMQ",
+  "license": "MIT",
+  "dependencies": {
+    "x402": "^0.7.1",
+    "x402-fetch": "^0.7.0"
+  },
+  "peerDependencies": {
+    "stripe": "^19.0.0"
+  },
+  "peerDependenciesMeta": {
+    "stripe": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^20",
+    "stripe": "^19.2.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist .turbo node_modules"
+  }
+}