@relai-fi/x402 0.6.1 → 0.6.3

package/dist/index.d.cts

@@ -1,6 +1,84 @@
-export { B as BridgePluginConfig, D as DynamicPrice, j as FeedbackPluginConfig, F as FreeTierPluginConfig, b as PaymentInfo, g as PluginContext, h as PluginResult, P as ProtectOptions, R as Relai, d as RelaiIntegritasFlow, e as RelaiIntegritasOptions, f as RelaiPlugin, a as RelaiServerConfig, i as ScorePluginConfig, S as SettleResult, k as SolanaFeedbackPluginConfig, c as StripePayTo, R as default, s as stripePayTo } from './server-8gWh9oky.cjs';
-export { RelayWebSocketFactory, RelayWebSocketLike, X402Client, X402ClientConfig, X402FetchInit, X402IntegritasConfig, X402IntegritasFlow, X402NetworkSelectionMode, X402RelayWsConfig, X402RelayWsError, X402RelayWsResponse, X402RequestOptions, default as createX402Client } from './client.cjs';
+export { B as BridgePluginConfig, D as DynamicPrice, j as FeedbackPluginConfig, F as FreeTierPluginConfig, M as MppServerHandler, b as PaymentInfo, g as PluginContext, h as PluginResult, P as ProtectOptions, R as Relai, d as RelaiIntegritasFlow, e as RelaiIntegritasOptions, f as RelaiPlugin, a as RelaiServerConfig, i as ScorePluginConfig, S as SettleResult, k as SolanaFeedbackPluginConfig, c as StripePayTo, R as default, s as stripePayTo } from './server-CBZ2RjEP.cjs';
+export { MppHandler, RelayWebSocketFactory, RelayWebSocketLike, X402Client, X402ClientConfig, X402FetchInit, X402IntegritasConfig, X402IntegritasFlow, X402NetworkSelectionMode, X402RelayWsConfig, X402RelayWsError, X402RelayWsResponse, X402RequestOptions, default as createX402Client } from './client.cjs';
 export { RelayFeedbackConfig, submitRelayFeedback } from './relay-feedback.cjs';
 export { A as AcceptsExtra, B as BASE_MAINNET_NETWORK, C as CAIP2_TO_NETWORK, b as CHAIN_IDS, E as EXPLORER_TX_URL, l as EvmWallet, N as NETWORK_CAIP2, e as NETWORK_LABELS, d as NETWORK_TOKENS, c as NetworkToken, P as PaymentAccept, o as PaymentRequired, R as RELAI_FACILITATOR_URL, h as RELAI_NETWORKS, a as RelaiNetwork, m as ResourceInfo, S as SOLANA_MAINNET_NETWORK, k as SolanaWallet, U as USDC_ADDRESSES, g as USDC_BASE, f as USDC_SOLANA, W as WalletSet, j as isEvm, i as isSolana, n as normalizeNetwork, r as resolveToken } from './types-Y9ni5XwY.cjs';
 export { BridgeBalances, BridgeQuoteResult, BridgeResult } from './management.cjs';
 export { NETWORK_V1_TO_V2, NETWORK_V2_TO_V1, convertPayloadToVersion, convertV1ToV2, convertV2ToV1, detectPayloadVersion, formatUsd, fromAtomicUnits, isEvmNetwork, isSolanaNetwork, networkV1ToV2, networkV2ToV1, normalizePaymentHeader, toAtomicUnits } from './utils/index.cjs';
+
+/**
+ * Payment Code API — BLIK-style x402 payment codes
+ *
+ * generatePaymentCode() — sign EIP-3009 authorization and register on SKALE L3
+ * redeemPaymentCode()   — redeem a code (payee calls this, triggers Base L2 settlement)
+ * getPaymentCode()      — check code status
+ */
+interface PaymentCodeConfig {
+    facilitatorUrl?: string;
+}
+interface GeneratePaymentCodeParams {
+    /** EIP-3009 signer — must implement signTypedData */
+    signer: {
+        getAddress(): Promise<string>;
+        signTypedData(domain: object, types: object, value: object): Promise<string>;
+    };
+    /** Payee wallet address */
+    to: string;
+    /** Amount in USDC micro-units (6 decimals), e.g. 1000 = $0.001 */
+    value: string | bigint;
+    /** USDC contract address on Base L2 (defaults to Base mainnet USDC) */
+    usdcContract?: string;
+    /** TTL in seconds (default: 120) */
+    ttl?: number;
+}
+interface PaymentCode {
+    code: string;
+    validBefore: number;
+    expiresIn: number;
+}
+interface RedeemResult {
+    success: boolean;
+    code: string;
+    l3TxHash: string;
+    l2TxHash: string;
+    explorerUrl: string;
+    amount: string;
+    from: string;
+    to: string;
+}
+interface CodeStatus {
+    code: string;
+    from: string;
+    to: string;
+    value: string;
+    validBefore: number;
+    redeemed: boolean;
+    expired: boolean;
+    redeemable: boolean;
+}
+/**
+ * Generate a BLIK-style x402 payment code backed by EIP-3009.
+ *
+ * @example
+ * const { code } = await generatePaymentCode(config, {
+ *   signer: walletClient,
+ *   to: "0xMerchant...",
+ *   value: "1000",  // $0.001 USDC
+ *   ttl: 120,
+ * });
+ * // code = "X7K9P2AB"
+ */
+declare function generatePaymentCode(config: PaymentCodeConfig, params: GeneratePaymentCodeParams): Promise<PaymentCode>;
+/**
+ * Redeem a payment code. Triggers Base L2 settlement via relayer.
+ *
+ * @example
+ * const result = await redeemPaymentCode(config, "X7K9P2AB");
+ * // result.l2TxHash = "0x..."
+ */
+declare function redeemPaymentCode(config: PaymentCodeConfig, code: string): Promise<RedeemResult>;
+/**
+ * Get the status of a payment code.
+ */
+declare function getPaymentCode(config: PaymentCodeConfig, code: string): Promise<CodeStatus>;
+
+export { type CodeStatus, type GeneratePaymentCodeParams, type PaymentCode, type PaymentCodeConfig, type RedeemResult, generatePaymentCode, getPaymentCode, redeemPaymentCode };

package/dist/index.d.ts

@@ -1,6 +1,84 @@
-export { B as BridgePluginConfig, D as DynamicPrice, j as FeedbackPluginConfig, F as FreeTierPluginConfig, b as PaymentInfo, g as PluginContext, h as PluginResult, P as ProtectOptions, R as Relai, d as RelaiIntegritasFlow, e as RelaiIntegritasOptions, f as RelaiPlugin, a as RelaiServerConfig, i as ScorePluginConfig, S as SettleResult, k as SolanaFeedbackPluginConfig, c as StripePayTo, R as default, s as stripePayTo } from './server-JtlTglrW.js';
-export { RelayWebSocketFactory, RelayWebSocketLike, X402Client, X402ClientConfig, X402FetchInit, X402IntegritasConfig, X402IntegritasFlow, X402NetworkSelectionMode, X402RelayWsConfig, X402RelayWsError, X402RelayWsResponse, X402RequestOptions, default as createX402Client } from './client.js';
+export { B as BridgePluginConfig, D as DynamicPrice, j as FeedbackPluginConfig, F as FreeTierPluginConfig, M as MppServerHandler, b as PaymentInfo, g as PluginContext, h as PluginResult, P as ProtectOptions, R as Relai, d as RelaiIntegritasFlow, e as RelaiIntegritasOptions, f as RelaiPlugin, a as RelaiServerConfig, i as ScorePluginConfig, S as SettleResult, k as SolanaFeedbackPluginConfig, c as StripePayTo, R as default, s as stripePayTo } from './server-DaySqG5H.js';
+export { MppHandler, RelayWebSocketFactory, RelayWebSocketLike, X402Client, X402ClientConfig, X402FetchInit, X402IntegritasConfig, X402IntegritasFlow, X402NetworkSelectionMode, X402RelayWsConfig, X402RelayWsError, X402RelayWsResponse, X402RequestOptions, default as createX402Client } from './client.js';
 export { RelayFeedbackConfig, submitRelayFeedback } from './relay-feedback.js';
 export { A as AcceptsExtra, B as BASE_MAINNET_NETWORK, C as CAIP2_TO_NETWORK, b as CHAIN_IDS, E as EXPLORER_TX_URL, l as EvmWallet, N as NETWORK_CAIP2, e as NETWORK_LABELS, d as NETWORK_TOKENS, c as NetworkToken, P as PaymentAccept, o as PaymentRequired, R as RELAI_FACILITATOR_URL, h as RELAI_NETWORKS, a as RelaiNetwork, m as ResourceInfo, S as SOLANA_MAINNET_NETWORK, k as SolanaWallet, U as USDC_ADDRESSES, g as USDC_BASE, f as USDC_SOLANA, W as WalletSet, j as isEvm, i as isSolana, n as normalizeNetwork, r as resolveToken } from './types-Y9ni5XwY.js';
 export { BridgeBalances, BridgeQuoteResult, BridgeResult } from './management.js';
 export { NETWORK_V1_TO_V2, NETWORK_V2_TO_V1, convertPayloadToVersion, convertV1ToV2, convertV2ToV1, detectPayloadVersion, formatUsd, fromAtomicUnits, isEvmNetwork, isSolanaNetwork, networkV1ToV2, networkV2ToV1, normalizePaymentHeader, toAtomicUnits } from './utils/index.js';
+
+/**
+ * Payment Code API — BLIK-style x402 payment codes
+ *
+ * generatePaymentCode() — sign EIP-3009 authorization and register on SKALE L3
+ * redeemPaymentCode()   — redeem a code (payee calls this, triggers Base L2 settlement)
+ * getPaymentCode()      — check code status
+ */
+interface PaymentCodeConfig {
+    facilitatorUrl?: string;
+}
+interface GeneratePaymentCodeParams {
+    /** EIP-3009 signer — must implement signTypedData */
+    signer: {
+        getAddress(): Promise<string>;
+        signTypedData(domain: object, types: object, value: object): Promise<string>;
+    };
+    /** Payee wallet address */
+    to: string;
+    /** Amount in USDC micro-units (6 decimals), e.g. 1000 = $0.001 */
+    value: string | bigint;
+    /** USDC contract address on Base L2 (defaults to Base mainnet USDC) */
+    usdcContract?: string;
+    /** TTL in seconds (default: 120) */
+    ttl?: number;
+}
+interface PaymentCode {
+    code: string;
+    validBefore: number;
+    expiresIn: number;
+}
+interface RedeemResult {
+    success: boolean;
+    code: string;
+    l3TxHash: string;
+    l2TxHash: string;
+    explorerUrl: string;
+    amount: string;
+    from: string;
+    to: string;
+}
+interface CodeStatus {
+    code: string;
+    from: string;
+    to: string;
+    value: string;
+    validBefore: number;
+    redeemed: boolean;
+    expired: boolean;
+    redeemable: boolean;
+}
+/**
+ * Generate a BLIK-style x402 payment code backed by EIP-3009.
+ *
+ * @example
+ * const { code } = await generatePaymentCode(config, {
+ *   signer: walletClient,
+ *   to: "0xMerchant...",
+ *   value: "1000",  // $0.001 USDC
+ *   ttl: 120,
+ * });
+ * // code = "X7K9P2AB"
+ */
+declare function generatePaymentCode(config: PaymentCodeConfig, params: GeneratePaymentCodeParams): Promise<PaymentCode>;
+/**
+ * Redeem a payment code. Triggers Base L2 settlement via relayer.
+ *
+ * @example
+ * const result = await redeemPaymentCode(config, "X7K9P2AB");
+ * // result.l2TxHash = "0x..."
+ */
+declare function redeemPaymentCode(config: PaymentCodeConfig, code: string): Promise<RedeemResult>;
+/**
+ * Get the status of a payment code.
+ */
+declare function getPaymentCode(config: PaymentCodeConfig, code: string): Promise<CodeStatus>;
+
+export { type CodeStatus, type GeneratePaymentCodeParams, type PaymentCode, type PaymentCodeConfig, type RedeemResult, generatePaymentCode, getPaymentCode, redeemPaymentCode };

package/dist/index.js

@@ -1,3 +1,10 @@
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
 // src/types.ts
 var RELAI_FACILITATOR_URL = "https://facilitator.x402.fi";
 var NETWORK_CAIP2 = {
@@ -454,6 +461,7 @@ var Relai = class {
     this.network = config.network;
     this.facilitatorUrl = config.facilitatorUrl || RELAI_FACILITATOR_URL;
     this.plugins = config.plugins ?? [];
+    this.mpp = config.mpp;
   }
   async runPluginInit() {
     for (const plugin of this.plugins) {
@@ -558,6 +566,119 @@ var Relai = class {
         const integritasFlow = headerIntegritasFlow || configuredIntegritas.flow;
         const integritasMode = integritasFlow === "single" ? "single_signature_fee_included" : integritasFlow === "dual" ? "dual_signature_split" : void 0;
         const paymentHeader = req.headers["x-payment"] || req.headers["payment-signature"] || req.headers["x-payment-signature"];
+        const authHeader = req.headers["authorization"] || "";
+        console.log(`[Relai] MPP check: paymentHeader=${!!paymentHeader}, hasMpp=${!!self.mpp}, authHeader=${authHeader?.slice(0, 30)}`);
+        if (!paymentHeader && self.mpp && /^Payment\s+/i.test(authHeader)) {
+          try {
+            const mppAmount = resolvedPrice.toFixed(6);
+            const mppUrl = `${req.protocol}://${req.get("host")}${req.originalUrl}`;
+            const mppHeaders = new Headers();
+            for (const [k, v] of Object.entries(req.headers)) {
+              if (typeof v === "string") mppHeaders.set(k, v);
+            }
+            const mppRequest = new Request(mppUrl, { method: req.method, headers: mppHeaders });
+            const chargeHandler = self.mpp.charge({ amount: mppAmount });
+            const mppResult = await chargeHandler(mppRequest);
+            console.log(`[Relai] MPP charge result: status=${mppResult.status}, keys=${Object.keys(mppResult)}, hasChallenge=${!!mppResult.challenge}, hasWithReceipt=${!!mppResult.withReceipt}`);
+            if (mppResult.status === 402 && mppResult.challenge instanceof Response) {
+              const retryAuth = mppResult.challenge.headers.get("www-authenticate");
+              console.log(`[Relai] MPP re-challenged (credential not accepted). New WWW-Auth: ${retryAuth?.slice(0, 60)}`);
+            }
+            if (mppResult.status !== 200 && !mppResult.withReceipt && mppResult.status !== 402) {
+              if (self.plugins.length > 0) {
+                const mppFailCtx = {
+                  network,
+                  price: resolvedPrice,
+                  path: req.path || req.originalUrl || "/",
+                  method: (req.method || "GET").toUpperCase()
+                };
+                const mppFailResult = {
+                  success: false,
+                  payer: "mpp",
+                  error: `MPP charge failed with status ${mppResult.status}`
+                };
+                for (const plugin of self.plugins) {
+                  if (!plugin.afterSettled) continue;
+                  try {
+                    await plugin.afterSettled(req, mppFailResult, mppFailCtx);
+                  } catch (pluginErr) {
+                    console.warn(`[Relai] Plugin '${plugin.name}' afterSettled error (non-blocking):`, pluginErr);
+                  }
+                }
+              }
+            }
+            if (mppResult.status === 200 || mppResult.withReceipt) {
+              const receipt = mppResult.receipt || {};
+              const paymentInfo2 = {
+                verified: true,
+                transactionId: receipt.reference || "",
+                payer: receipt.method || "mpp",
+                network,
+                amount: resolvedPrice
+              };
+              req.payment = paymentInfo2;
+              req.x402Payer = receipt.method ? `${receipt.method}-mpp` : "mpp";
+              req.x402Paid = true;
+              req.x402Transaction = receipt.reference || "";
+              req.x402Network = network;
+              if (mppResult.withReceipt) {
+                const dummyResponse = new Response(null);
+                const receiptResponse = mppResult.withReceipt(dummyResponse);
+                const receiptHeader = receiptResponse.headers.get("payment-receipt");
+                if (receiptHeader) res.setHeader("Payment-Receipt", receiptHeader);
+              }
+              options.onPaymentSettled?.(req, {
+                success: true,
+                transaction: receipt.reference,
+                payer: req.x402Payer
+              });
+              if (self.plugins.length > 0) {
+                const settleCtx = {
+                  network,
+                  price: resolvedPrice,
+                  path: req.path || req.originalUrl || "/",
+                  method: (req.method || "GET").toUpperCase()
+                };
+                for (const plugin of self.plugins) {
+                  if (!plugin.afterSettled) continue;
+                  try {
+                    await plugin.afterSettled(req, {
+                      success: true,
+                      transaction: receipt.reference,
+                      payer: req.x402Payer
+                    }, settleCtx);
+                  } catch (pluginErr) {
+                    console.warn(`[Relai] Plugin '${plugin.name}' afterSettled error (non-blocking):`, pluginErr);
+                  }
+                }
+              }
+              return next();
+            }
+          } catch (mppErr) {
+            console.warn(`[Relai] MPP verification failed (${mppErr instanceof Error ? mppErr.message : mppErr}), falling through to x402`);
+            if (self.plugins.length > 0) {
+              const mppErrCtx = {
+                network,
+                price: resolvedPrice,
+                path: req.path || req.originalUrl || "/",
+                method: (req.method || "GET").toUpperCase()
+              };
+              const mppErrResult = {
+                success: false,
+                payer: "mpp",
+                error: mppErr instanceof Error ? mppErr.message : String(mppErr)
+              };
+              for (const plugin of self.plugins) {
+                if (!plugin.afterSettled) continue;
+                try {
+                  await plugin.afterSettled(req, mppErrResult, mppErrCtx);
+                } catch (pluginErr) {
+                  console.warn(`[Relai] Plugin '${plugin.name}' afterSettled error (non-blocking):`, pluginErr);
+                }
+              }
+            }
+          }
+        }
         if (!paymentHeader && self.plugins.length > 0) {
           if (!self.pluginInitPromise) {
             self.pluginInitPromise = self.runPluginInit();
@@ -712,6 +833,21 @@ var Relai = class {
               }
             }
           }
+          if (self.mpp?.charge) {
+            try {
+              const mppAmount = resolvedPrice.toFixed(6);
+              const chargeHandler = self.mpp.charge({ amount: mppAmount });
+              const mockReq = new Request(`${req.protocol}://${req.get("host")}${req.originalUrl}`);
+              const mppResult = await chargeHandler(mockReq);
+              if (mppResult?.challenge instanceof Response) {
+                const wwwAuth = mppResult.challenge.headers.get("www-authenticate");
+                if (wwwAuth) {
+                  res.setHeader("WWW-Authenticate", wwwAuth);
+                }
+              }
+            } catch {
+            }
+          }
           return res.status(402).json(paymentRequiredResponse);
         }
         let paymentProof;
@@ -802,6 +938,22 @@ var Relai = class {
         });
         const result = await settleRes.json();
         if (!result.success) {
+          if (self.plugins.length > 0) {
+            const failCtx = {
+              network,
+              price: resolvedPrice,
+              path: req.path || req.originalUrl || "/",
+              method: (req.method || "GET").toUpperCase()
+            };
+            for (const plugin of self.plugins) {
+              if (!plugin.afterSettled) continue;
+              try {
+                await plugin.afterSettled(req, result, failCtx);
+              } catch (pluginErr) {
+                console.warn(`[Relai] Plugin '${plugin.name}' afterSettled error (non-blocking):`, pluginErr);
+              }
+            }
+          }
           return res.status(402).json({
             x402Version: 2,
             error: result.errorReason || result.error || "Payment settlement failed"
@@ -926,7 +1078,8 @@ function createX402Client(config) {
     maxAmountAtomic,
     integritas,
     verbose = false,
-    defaultHeaders = {}
+    defaultHeaders = {},
+    mpp
   } = config;
   const relayWsEnabled = relayWs?.enabled === true;
   const relayWsPreflightTimeoutMs = relayWs?.preflightTimeoutMs ?? 5e3;
@@ -1906,6 +2059,31 @@ function createX402Client(config) {
     const response = await fetch(input, requestInitWithHeaders);
     if (response.status !== 402) return response;
     log("Got 402 Payment Required");
+    if (mpp) {
+      const wwwAuth = response.headers.get("www-authenticate");
+      if (wwwAuth && /^Payment\s+/i.test(wwwAuth.trim())) {
+        log("MPP challenge detected in WWW-Authenticate header");
+        try {
+          const credential = await mpp.createCredential(response);
+          if (credential) {
+            log("MPP credential created, retrying with Authorization: Payment");
+            const mppRetry = await fetch(input, {
+              ...requestInitWithHeaders,
+              headers: {
+                ...requestHeaders,
+                "Authorization": credential.startsWith("Payment ") ? credential : `Payment ${credential}`
+              }
+            });
+            if (mppRetry.status !== 402) {
+              return mppRetry;
+            }
+            log("MPP retry still returned 402, falling through to x402");
+          }
+        } catch (mppErr) {
+          log(`MPP payment failed (${mppErr instanceof Error ? mppErr.message : mppErr}), falling through to x402`);
+        }
+      }
+    }
     let requirementsFromBody = null;
     try {
       requirementsFromBody = await response.clone().json();
@@ -2033,6 +2211,96 @@ function submitRelayFeedback(config) {
   })();
 }
 
+// src/payment-codes.ts
+var DEFAULT_FACILITATOR = "https://relai.fi/facilitator";
+var DEFAULT_USDC_BASE = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
+var EIP3009_TYPES = {
+  TransferWithAuthorization: [
+    { name: "from", type: "address" },
+    { name: "to", type: "address" },
+    { name: "value", type: "uint256" },
+    { name: "validAfter", type: "uint256" },
+    { name: "validBefore", type: "uint256" },
+    { name: "nonce", type: "bytes32" }
+  ]
+};
+function randomBytes32() {
+  const bytes = new Uint8Array(32);
+  if (typeof globalThis.crypto !== "undefined") {
+    globalThis.crypto.getRandomValues(bytes);
+  } else {
+    const { randomBytes } = __require("crypto");
+    randomBytes(32).copy(Buffer.from(bytes.buffer));
+  }
+  return "0x" + Array.from(bytes).map((b) => b.toString(16).padStart(2, "0")).join("");
+}
+async function generatePaymentCode(config, params) {
+  const { signer, to, value, usdcContract, ttl = 120 } = params;
+  const facilitatorUrl = config.facilitatorUrl || DEFAULT_FACILITATOR;
+  const usdc = usdcContract || DEFAULT_USDC_BASE;
+  const from = await signer.getAddress();
+  const now = Math.floor(Date.now() / 1e3);
+  const validAfter = 0;
+  const validBefore = now + ttl;
+  const nonce = randomBytes32();
+  const domain = {
+    name: "USD Coin",
+    version: "2",
+    chainId: 8453,
+    // Base mainnet
+    verifyingContract: usdc
+  };
+  const message = {
+    from,
+    to,
+    value: BigInt(value).toString(),
+    validAfter,
+    validBefore,
+    nonce
+  };
+  const signature = await signer.signTypedData(domain, EIP3009_TYPES, message);
+  const res = await fetch(`${facilitatorUrl}/payment-codes`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({
+      from,
+      to,
+      value: BigInt(value).toString(),
+      validAfter,
+      validBefore,
+      nonce,
+      signature,
+      usdcContract: usdc
+    })
+  });
+  if (!res.ok) {
+    const err = await res.json().catch(() => ({}));
+    throw new Error(`Failed to register payment code: ${err.error || res.status}`);
+  }
+  return res.json();
+}
+async function redeemPaymentCode(config, code) {
+  const facilitatorUrl = config.facilitatorUrl || DEFAULT_FACILITATOR;
+  const res = await fetch(`${facilitatorUrl}/payment-codes/${code.toUpperCase()}/redeem`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" }
+  });
+  if (!res.ok) {
+    const err = await res.json().catch(() => ({}));
+    throw new Error(`Failed to redeem payment code: ${err.error || res.status}`);
+  }
+  return res.json();
+}
+async function getPaymentCode(config, code) {
+  const facilitatorUrl = config.facilitatorUrl || DEFAULT_FACILITATOR;
+  const res = await fetch(`${facilitatorUrl}/payment-codes/${code.toUpperCase()}`);
+  if (!res.ok) {
+    const err = await res.json().catch(() => ({}));
+    throw new Error(`Payment code not found: ${err.error || res.status}`);
+  }
+  return res.json();
+}
+
 // src/utils/payload-converter.ts
 var NETWORK_V1_TO_V2 = {
   "solana": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
@@ -2197,6 +2465,8 @@ export {
   detectPayloadVersion,
   formatUsd,
   fromAtomicUnits,
+  generatePaymentCode,
+  getPaymentCode,
   isEvm,
   isEvmNetwork,
   isSolana,
@@ -2205,6 +2475,7 @@ export {
   networkV2ToV1,
   normalizeNetwork,
   normalizePaymentHeader,
+  redeemPaymentCode,
   resolveToken,
   stripePayTo,
   submitRelayFeedback,