@relai-fi/x402 0.1.0

package/dist/server.cjs

@@ -0,0 +1,171 @@
+"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/server.ts
+var server_exports = {};
+__export(server_exports, {
+  Relai: () => Relai,
+  default: () => server_default
+});
+module.exports = __toCommonJS(server_exports);
+var import_axios = __toESM(require("axios"), 1);
+
+// src/types.ts
+var RELAI_FACILITATOR_URL = "https://facilitator.x402.fi";
+var NETWORK_CAIP2 = {
+  "solana": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
+  "base": "eip155:8453",
+  "avalanche": "eip155:43114",
+  "skale-base": "eip155:1187947933"
+};
+var CAIP2_TO_NETWORK = Object.fromEntries(
+  Object.entries(NETWORK_CAIP2).map(([k, v]) => [v, k])
+);
+var USDC_ADDRESSES = {
+  "solana": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
+  "base": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
+  "avalanche": "0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E",
+  "skale-base": "0x85889c8c714505E0c94b30fcfcF64fE3Ac8FCb20"
+};
+var SOLANA_MAINNET_NETWORK = NETWORK_CAIP2["solana"];
+var BASE_MAINNET_NETWORK = NETWORK_CAIP2["base"];
+var USDC_SOLANA = USDC_ADDRESSES["solana"];
+var USDC_BASE = USDC_ADDRESSES["base"];
+
+// src/server.ts
+var Relai = class {
+  constructor(config) {
+    this.config = {
+      network: "solana",
+      apiBaseUrl: "https://relai.fi/api",
+      facilitatorUrl: RELAI_FACILITATOR_URL,
+      ...config
+    };
+    if (!this.config.apiKey || typeof this.config.apiKey !== "string") {
+      throw new Error("[Relai] Missing required apiKey in configuration");
+    }
+    this.client = import_axios.default.create({
+      baseURL: this.config.apiBaseUrl,
+      timeout: 1e4,
+      headers: {
+        "Authorization": `Bearer ${this.config.apiKey}`,
+        "Content-Type": "application/json"
+      }
+    });
+  }
+  /**
+   * Express middleware to protect an endpoint with x402 micropayments.
+   * Returns a 402 with `accepts` for the configured network.
+   * Supports: Solana, Base, Avalanche, SKALE Base.
+   */
+  protect(options) {
+    return async (req, res, next) => {
+      try {
+        const resolvedPrice = typeof options.price === "function" ? await options.price(req) : options.price;
+        if (typeof resolvedPrice !== "number" || !isFinite(resolvedPrice) || resolvedPrice <= 0) {
+          return res.status(400).json({ error: "Invalid price configuration", code: "INVALID_PRICE" });
+        }
+        const paymentSignature = req.headers["x-payment-signature"] || req.headers["x-relai-payment"];
+        if (!paymentSignature) {
+          const network = this.config.network;
+          const caip2 = NETWORK_CAIP2[network] || NETWORK_CAIP2["solana"];
+          const asset = USDC_ADDRESSES[network] || USDC_ADDRESSES["solana"];
+          return res.status(402).json({
+            x402Version: 2,
+            error: "Payment required",
+            resource: {
+              url: `${req.protocol}://${req.get("host")}${req.originalUrl}`,
+              description: options.description || "API access",
+              mimeType: "application/json"
+            },
+            accepts: [{
+              scheme: "exact",
+              network: caip2,
+              maxAmountRequired: String(Math.floor(resolvedPrice * 1e6)),
+              asset,
+              payTo: options.payTo,
+              maxTimeoutSeconds: 60,
+              extra: {
+                name: "USD Coin",
+                version: "2",
+                decimals: 6,
+                facilitatorUrl: this.config.facilitatorUrl
+              }
+            }]
+          });
+        }
+        const verification = await this.verifyPayment(paymentSignature, resolvedPrice, options.maxTimeout);
+        if (!verification.verified) {
+          return res.status(402).json({
+            error: "Payment verification failed",
+            code: "PAYMENT_INVALID",
+            details: verification.error
+          });
+        }
+        req.payment = verification;
+        if (options.customRules) {
+          const customValid = await options.customRules(req);
+          if (!customValid) {
+            return res.status(403).json({ error: "Custom validation failed", code: "VALIDATION_FAILED" });
+          }
+        }
+        next();
+      } catch (error) {
+        console.error("Relai protection error:", error);
+        res.status(500).json({ error: "Internal server error", code: "SERVER_ERROR" });
+      }
+    };
+  }
+  async verifyPayment(signature, expectedPrice, timeoutMs) {
+    try {
+      const response = await this.client.post(
+        "/verify-payment",
+        { signature, expectedPrice, network: this.config.network },
+        { timeout: typeof timeoutMs === "number" ? Math.max(1, timeoutMs) : void 0 }
+      );
+      return response.data;
+    } catch (error) {
+      return { verified: false, error: error.response?.data?.error || "Verification failed" };
+    }
+  }
+  async getStats(apiId) {
+    const params = apiId ? { apiId } : {};
+    const response = await this.client.get("/stats", { params });
+    return response.data;
+  }
+  createProtectedEndpoint(options) {
+    return this.protect(options);
+  }
+};
+var server_default = Relai;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Relai
+});
+//# sourceMappingURL=server.cjs.map

package/dist/server.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/server.ts","../src/types.ts"],"sourcesContent":["// src/server.ts\nimport axios, { AxiosInstance } from 'axios';\nimport {\n  RelaiConfig,\n  ProtectOptions,\n  PaymentResult,\n  NETWORK_CAIP2,\n  USDC_ADDRESSES,\n  RELAI_FACILITATOR_URL,\n  type RelaiNetwork,\n} from './types';\n\nexport class Relai {\n  private config: Required<Pick<RelaiConfig, 'network' | 'facilitatorUrl' | 'apiBaseUrl'>> & RelaiConfig;\n  private client: AxiosInstance;\n\n  constructor(config: RelaiConfig) {\n    this.config = {\n      network: 'solana',\n      apiBaseUrl: 'https://relai.fi/api',\n      facilitatorUrl: RELAI_FACILITATOR_URL,\n      ...config,\n    };\n\n    if (!this.config.apiKey || typeof this.config.apiKey !== 'string') {\n      throw new Error('[Relai] Missing required apiKey in configuration');\n    }\n\n    this.client = axios.create({\n      baseURL: this.config.apiBaseUrl,\n      timeout: 10000,\n      headers: {\n        'Authorization': `Bearer ${this.config.apiKey}`,\n        'Content-Type': 'application/json',\n      },\n    });\n  }\n\n  /**\n   * Express middleware to protect an endpoint with x402 micropayments.\n   * Returns a 402 with `accepts` for the configured network.\n   * Supports: Solana, Base, Avalanche, SKALE Base.\n   */\n  protect(options: ProtectOptions) {\n    return async (req: any, res: any, next: any) => {\n      try {\n        const resolvedPrice = typeof options.price === 'function'\n          ? await options.price(req)\n          : options.price;\n\n        if (typeof resolvedPrice !== 'number' || !isFinite(resolvedPrice) || resolvedPrice <= 0) {\n          return res.status(400).json({ error: 'Invalid price configuration', code: 'INVALID_PRICE' });\n        }\n\n        // Check for payment header\n        const paymentSignature = req.headers['x-payment-signature'] || req.headers['x-relai-payment'];\n\n        if (!paymentSignature) {\n          const network = this.config.network as RelaiNetwork;\n          const caip2 = NETWORK_CAIP2[network] || NETWORK_CAIP2['solana'];\n          const asset = USDC_ADDRESSES[network] || USDC_ADDRESSES['solana'];\n\n          return res.status(402).json({\n            x402Version: 2,\n            error: 'Payment required',\n            resource: {\n              url: `${req.protocol}://${req.get('host')}${req.originalUrl}`,\n              description: options.description || 'API access',\n              mimeType: 'application/json',\n            },\n            accepts: [{\n              scheme: 'exact',\n              network: caip2,\n              maxAmountRequired: String(Math.floor(resolvedPrice * 1_000_000)),\n              asset,\n              payTo: options.payTo,\n              maxTimeoutSeconds: 60,\n              extra: {\n                name: 'USD Coin',\n                version: '2',\n                decimals: 6,\n                facilitatorUrl: this.config.facilitatorUrl,\n              },\n            }],\n          });\n        }\n\n        // Verify payment\n        const verification = await this.verifyPayment(paymentSignature, resolvedPrice, options.maxTimeout);\n\n        if (!verification.verified) {\n          return res.status(402).json({\n            error: 'Payment verification failed',\n            code: 'PAYMENT_INVALID',\n            details: verification.error,\n          });\n        }\n\n        req.payment = verification;\n\n        if (options.customRules) {\n          const customValid = await options.customRules(req);\n          if (!customValid) {\n            return res.status(403).json({ error: 'Custom validation failed', code: 'VALIDATION_FAILED' });\n          }\n        }\n\n        next();\n      } catch (error) {\n        console.error('Relai protection error:', error);\n        res.status(500).json({ error: 'Internal server error', code: 'SERVER_ERROR' });\n      }\n    };\n  }\n\n  private async verifyPayment(signature: string, expectedPrice: number, timeoutMs?: number): Promise<PaymentResult> {\n    try {\n      const response = await this.client.post(\n        '/verify-payment',\n        { signature, expectedPrice, network: this.config.network },\n        { timeout: typeof timeoutMs === 'number' ? Math.max(1, timeoutMs) : undefined },\n      );\n      return response.data;\n    } catch (error: any) {\n      return { verified: false, error: error.response?.data?.error || 'Verification failed' };\n    }\n  }\n\n  async getStats(apiId?: string) {\n    const params = apiId ? { apiId } : {};\n    const response = await this.client.get('/stats', { params });\n    return response.data;\n  }\n\n  createProtectedEndpoint(options: ProtectOptions) {\n    return this.protect(options);\n  }\n}\n\nexport default Relai;\n","// src/types.ts\n\n// ============================================================================\n// Constants\n// ============================================================================\n\n/** RelAI Facilitator URL */\nexport const RELAI_FACILITATOR_URL = 'https://facilitator.x402.fi';\n\n// ============================================================================\n// Supported Networks\n// ============================================================================\n\n/** All networks supported by RelAI facilitator */\nexport type RelaiNetwork = 'solana' | 'base' | 'avalanche' | 'skale-base';\n\n/** CAIP-2 network identifiers */\nexport const NETWORK_CAIP2: Record<RelaiNetwork, string> = {\n  'solana': 'solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp',\n  'base': 'eip155:8453',\n  'avalanche': 'eip155:43114',\n  'skale-base': 'eip155:1187947933',\n};\n\n/** Reverse lookup: CAIP-2 → simple network name */\nexport const CAIP2_TO_NETWORK: Record<string, RelaiNetwork> = Object.fromEntries(\n  Object.entries(NETWORK_CAIP2).map(([k, v]) => [v, k as RelaiNetwork])\n) as Record<string, RelaiNetwork>;\n\n/** Chain IDs for EVM networks */\nexport const CHAIN_IDS: Record<string, number> = {\n  'base': 8453,\n  'avalanche': 43114,\n  'skale-base': 1187947933,\n};\n\n/** USDC contract addresses per network */\nexport const USDC_ADDRESSES: Record<RelaiNetwork, string> = {\n  'solana': 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',\n  'base': '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',\n  'avalanche': '0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E',\n  'skale-base': '0x85889c8c714505E0c94b30fcfcF64fE3Ac8FCb20',\n};\n\n/** Explorer URLs per network */\nexport const EXPLORER_TX_URL: Record<RelaiNetwork, (tx: string) => string> = {\n  'solana': (tx) => `https://solscan.io/tx/${tx}`,\n  'base': (tx) => `https://basescan.org/tx/${tx}`,\n  'avalanche': (tx) => `https://snowtrace.io/tx/${tx}`,\n  'skale-base': (tx) => `https://skale-base-explorer.skalenodes.com/tx/${tx}`,\n};\n\n/** Human-readable network labels */\nexport const NETWORK_LABELS: Record<RelaiNetwork, string> = {\n  'solana': 'Solana',\n  'base': 'Base',\n  'avalanche': 'Avalanche',\n  'skale-base': 'SKALE Base',\n};\n\n/** Legacy CAIP-2 exports for backward compatibility */\nexport const SOLANA_MAINNET_NETWORK = NETWORK_CAIP2['solana'];\nexport const BASE_MAINNET_NETWORK = NETWORK_CAIP2['base'];\n\n/** Legacy USDC exports for backward compatibility */\nexport const USDC_SOLANA = USDC_ADDRESSES['solana'];\nexport const USDC_BASE = USDC_ADDRESSES['base'];\n\n/** All supported RelAI networks list */\nexport const RELAI_NETWORKS: RelaiNetwork[] = ['solana', 'base', 'avalanche', 'skale-base'];\n\n/** Check if a network is Solana-based */\nexport function isSolana(network: string): boolean {\n  return network === 'solana' || network.startsWith('solana:');\n}\n\n/** Check if a network is EVM-based */\nexport function isEvm(network: string): boolean {\n  return ['base', 'avalanche', 'skale-base'].includes(network) || network.startsWith('eip155:');\n}\n\n/** Normalize CAIP-2 or simple name to RelaiNetwork */\nexport function normalizeNetwork(network: string): RelaiNetwork | null {\n  if (RELAI_NETWORKS.includes(network as RelaiNetwork)) return network as RelaiNetwork;\n  const fromCaip2 = CAIP2_TO_NETWORK[network];\n  if (fromCaip2) return fromCaip2;\n  // Partial match\n  if (network.startsWith('solana:')) return 'solana';\n  if (network.startsWith('eip155:')) {\n    const chainId = parseInt(network.split(':')[1]);\n    const entry = Object.entries(CHAIN_IDS).find(([, id]) => id === chainId);\n    if (entry) return entry[0] as RelaiNetwork;\n  }\n  return null;\n}\n\n// ============================================================================\n// Wallet Types\n// ============================================================================\n\n/** Solana wallet interface */\nexport interface SolanaWallet {\n  publicKey: { toString(): string } | null;\n  signTransaction: ((tx: unknown) => Promise<unknown>) | null;\n  signAllTransactions?: ((txs: unknown[]) => Promise<unknown[]>) | null;\n}\n\n/** EVM wallet interface (viem-compatible) */\nexport interface EvmWallet {\n  address: string;\n  signTypedData: (params: unknown) => Promise<string>;\n  chain?: { id: number };\n}\n\n/** Wallet set for multi-chain support */\nexport interface WalletSet {\n  solana?: SolanaWallet;\n  evm?: EvmWallet;\n}\n\n// ============================================================================\n// Payment Types\n// ============================================================================\n\n/** Extra fields in payment requirements */\nexport interface AcceptsExtra {\n  feePayer?: string;\n  decimals?: number;\n  name?: string;\n  version?: string;\n  [key: string]: unknown;\n}\n\n/** A single payment option */\nexport interface PaymentAccept {\n  x402Version?: 1 | 2;\n  scheme: string;\n  network: string;\n  maxAmountRequired?: string;\n  amount?: string;\n  asset: string;\n  payTo: string;\n  maxTimeoutSeconds?: number;\n  extra?: AcceptsExtra;\n  resource?: string;\n  description?: string;\n  mimeType?: string;\n  outputSchema?: unknown;\n}\n\n/** Resource info for v2 */\nexport interface ResourceInfo {\n  url: string;\n  description?: string;\n  mimeType?: string;\n}\n\n/** Payment requirements (402 response) */\nexport interface PaymentRequired {\n  x402Version: 1 | 2;\n  error?: string;\n  accepts: PaymentAccept[];\n  resource?: ResourceInfo;\n  extensions?: Record<string, unknown>;\n}\n\n// ============================================================================\n// Config Types\n// ============================================================================\n\nexport interface RelaiConfig {\n  apiKey?: string;\n  network?: RelaiNetwork;\n  facilitatorUrl?: string;\n  apiBaseUrl?: string;\n}\n\nexport type DynamicPrice = number | ((req: unknown) => number | Promise<number>);\n\nexport interface ProtectOptions {\n  /** Price in USD (e.g., 0.01 for 1 cent) */\n  price: DynamicPrice;\n  /** Wallet address to receive payments */\n  payTo: string;\n  /** Description shown to payer */\n  description?: string;\n  /** Maximum timeout in seconds */\n  maxTimeout?: number;\n  /** Custom validation rules */\n  customRules?: (req: unknown) => boolean | Promise<boolean>;\n  onPaymentRequired?: (\n    req: unknown,\n    info: { price: number; description?: string; facilitatorUrl?: string }\n  ) => void;\n  onPaymentVerified?: (req: unknown, result: PaymentResult) => void;\n  onError?: (req: unknown, error: unknown) => void;\n}\n\nexport interface PaymentResult {\n  verified: boolean;\n  transactionId?: string;\n  amount?: number;\n  currency?: string;\n  error?: string;\n}\n"],"mappings":"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","names":["axios"]}

package/dist/server.d.cts

@@ -0,0 +1,18 @@
+import { m as RelaiConfig, o as ProtectOptions } from './types-DGRfrYd3.cjs';
+
+declare class Relai {
+    private config;
+    private client;
+    constructor(config: RelaiConfig);
+    /**
+     * Express middleware to protect an endpoint with x402 micropayments.
+     * Returns a 402 with `accepts` for the configured network.
+     * Supports: Solana, Base, Avalanche, SKALE Base.
+     */
+    protect(options: ProtectOptions): (req: any, res: any, next: any) => Promise<any>;
+    private verifyPayment;
+    getStats(apiId?: string): Promise<any>;
+    createProtectedEndpoint(options: ProtectOptions): (req: any, res: any, next: any) => Promise<any>;
+}
+
+export { Relai, Relai as default };

package/dist/server.d.ts

@@ -0,0 +1,18 @@
+import { m as RelaiConfig, o as ProtectOptions } from './types-DGRfrYd3.js';
+
+declare class Relai {
+    private config;
+    private client;
+    constructor(config: RelaiConfig);
+    /**
+     * Express middleware to protect an endpoint with x402 micropayments.
+     * Returns a 402 with `accepts` for the configured network.
+     * Supports: Solana, Base, Avalanche, SKALE Base.
+     */
+    protect(options: ProtectOptions): (req: any, res: any, next: any) => Promise<any>;
+    private verifyPayment;
+    getStats(apiId?: string): Promise<any>;
+    createProtectedEndpoint(options: ProtectOptions): (req: any, res: any, next: any) => Promise<any>;
+}
+
+export { Relai, Relai as default };

package/dist/server.js

@@ -0,0 +1,136 @@
+// src/server.ts
+import axios from "axios";
+
+// src/types.ts
+var RELAI_FACILITATOR_URL = "https://facilitator.x402.fi";
+var NETWORK_CAIP2 = {
+  "solana": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
+  "base": "eip155:8453",
+  "avalanche": "eip155:43114",
+  "skale-base": "eip155:1187947933"
+};
+var CAIP2_TO_NETWORK = Object.fromEntries(
+  Object.entries(NETWORK_CAIP2).map(([k, v]) => [v, k])
+);
+var USDC_ADDRESSES = {
+  "solana": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
+  "base": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
+  "avalanche": "0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E",
+  "skale-base": "0x85889c8c714505E0c94b30fcfcF64fE3Ac8FCb20"
+};
+var SOLANA_MAINNET_NETWORK = NETWORK_CAIP2["solana"];
+var BASE_MAINNET_NETWORK = NETWORK_CAIP2["base"];
+var USDC_SOLANA = USDC_ADDRESSES["solana"];
+var USDC_BASE = USDC_ADDRESSES["base"];
+
+// src/server.ts
+var Relai = class {
+  constructor(config) {
+    this.config = {
+      network: "solana",
+      apiBaseUrl: "https://relai.fi/api",
+      facilitatorUrl: RELAI_FACILITATOR_URL,
+      ...config
+    };
+    if (!this.config.apiKey || typeof this.config.apiKey !== "string") {
+      throw new Error("[Relai] Missing required apiKey in configuration");
+    }
+    this.client = axios.create({
+      baseURL: this.config.apiBaseUrl,
+      timeout: 1e4,
+      headers: {
+        "Authorization": `Bearer ${this.config.apiKey}`,
+        "Content-Type": "application/json"
+      }
+    });
+  }
+  /**
+   * Express middleware to protect an endpoint with x402 micropayments.
+   * Returns a 402 with `accepts` for the configured network.
+   * Supports: Solana, Base, Avalanche, SKALE Base.
+   */
+  protect(options) {
+    return async (req, res, next) => {
+      try {
+        const resolvedPrice = typeof options.price === "function" ? await options.price(req) : options.price;
+        if (typeof resolvedPrice !== "number" || !isFinite(resolvedPrice) || resolvedPrice <= 0) {
+          return res.status(400).json({ error: "Invalid price configuration", code: "INVALID_PRICE" });
+        }
+        const paymentSignature = req.headers["x-payment-signature"] || req.headers["x-relai-payment"];
+        if (!paymentSignature) {
+          const network = this.config.network;
+          const caip2 = NETWORK_CAIP2[network] || NETWORK_CAIP2["solana"];
+          const asset = USDC_ADDRESSES[network] || USDC_ADDRESSES["solana"];
+          return res.status(402).json({
+            x402Version: 2,
+            error: "Payment required",
+            resource: {
+              url: `${req.protocol}://${req.get("host")}${req.originalUrl}`,
+              description: options.description || "API access",
+              mimeType: "application/json"
+            },
+            accepts: [{
+              scheme: "exact",
+              network: caip2,
+              maxAmountRequired: String(Math.floor(resolvedPrice * 1e6)),
+              asset,
+              payTo: options.payTo,
+              maxTimeoutSeconds: 60,
+              extra: {
+                name: "USD Coin",
+                version: "2",
+                decimals: 6,
+                facilitatorUrl: this.config.facilitatorUrl
+              }
+            }]
+          });
+        }
+        const verification = await this.verifyPayment(paymentSignature, resolvedPrice, options.maxTimeout);
+        if (!verification.verified) {
+          return res.status(402).json({
+            error: "Payment verification failed",
+            code: "PAYMENT_INVALID",
+            details: verification.error
+          });
+        }
+        req.payment = verification;
+        if (options.customRules) {
+          const customValid = await options.customRules(req);
+          if (!customValid) {
+            return res.status(403).json({ error: "Custom validation failed", code: "VALIDATION_FAILED" });
+          }
+        }
+        next();
+      } catch (error) {
+        console.error("Relai protection error:", error);
+        res.status(500).json({ error: "Internal server error", code: "SERVER_ERROR" });
+      }
+    };
+  }
+  async verifyPayment(signature, expectedPrice, timeoutMs) {
+    try {
+      const response = await this.client.post(
+        "/verify-payment",
+        { signature, expectedPrice, network: this.config.network },
+        { timeout: typeof timeoutMs === "number" ? Math.max(1, timeoutMs) : void 0 }
+      );
+      return response.data;
+    } catch (error) {
+      return { verified: false, error: error.response?.data?.error || "Verification failed" };
+    }
+  }
+  async getStats(apiId) {
+    const params = apiId ? { apiId } : {};
+    const response = await this.client.get("/stats", { params });
+    return response.data;
+  }
+  createProtectedEndpoint(options) {
+    return this.protect(options);
+  }
+};
+var server_default = Relai;
+export {
+  Relai,
+  server_default as default
+};
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/server.ts","../src/types.ts"],"sourcesContent":["// src/server.ts\nimport axios, { AxiosInstance } from 'axios';\nimport {\n  RelaiConfig,\n  ProtectOptions,\n  PaymentResult,\n  NETWORK_CAIP2,\n  USDC_ADDRESSES,\n  RELAI_FACILITATOR_URL,\n  type RelaiNetwork,\n} from './types';\n\nexport class Relai {\n  private config: Required<Pick<RelaiConfig, 'network' | 'facilitatorUrl' | 'apiBaseUrl'>> & RelaiConfig;\n  private client: AxiosInstance;\n\n  constructor(config: RelaiConfig) {\n    this.config = {\n      network: 'solana',\n      apiBaseUrl: 'https://relai.fi/api',\n      facilitatorUrl: RELAI_FACILITATOR_URL,\n      ...config,\n    };\n\n    if (!this.config.apiKey || typeof this.config.apiKey !== 'string') {\n      throw new Error('[Relai] Missing required apiKey in configuration');\n    }\n\n    this.client = axios.create({\n      baseURL: this.config.apiBaseUrl,\n      timeout: 10000,\n      headers: {\n        'Authorization': `Bearer ${this.config.apiKey}`,\n        'Content-Type': 'application/json',\n      },\n    });\n  }\n\n  /**\n   * Express middleware to protect an endpoint with x402 micropayments.\n   * Returns a 402 with `accepts` for the configured network.\n   * Supports: Solana, Base, Avalanche, SKALE Base.\n   */\n  protect(options: ProtectOptions) {\n    return async (req: any, res: any, next: any) => {\n      try {\n        const resolvedPrice = typeof options.price === 'function'\n          ? await options.price(req)\n          : options.price;\n\n        if (typeof resolvedPrice !== 'number' || !isFinite(resolvedPrice) || resolvedPrice <= 0) {\n          return res.status(400).json({ error: 'Invalid price configuration', code: 'INVALID_PRICE' });\n        }\n\n        // Check for payment header\n        const paymentSignature = req.headers['x-payment-signature'] || req.headers['x-relai-payment'];\n\n        if (!paymentSignature) {\n          const network = this.config.network as RelaiNetwork;\n          const caip2 = NETWORK_CAIP2[network] || NETWORK_CAIP2['solana'];\n          const asset = USDC_ADDRESSES[network] || USDC_ADDRESSES['solana'];\n\n          return res.status(402).json({\n            x402Version: 2,\n            error: 'Payment required',\n            resource: {\n              url: `${req.protocol}://${req.get('host')}${req.originalUrl}`,\n              description: options.description || 'API access',\n              mimeType: 'application/json',\n            },\n            accepts: [{\n              scheme: 'exact',\n              network: caip2,\n              maxAmountRequired: String(Math.floor(resolvedPrice * 1_000_000)),\n              asset,\n              payTo: options.payTo,\n              maxTimeoutSeconds: 60,\n              extra: {\n                name: 'USD Coin',\n                version: '2',\n                decimals: 6,\n                facilitatorUrl: this.config.facilitatorUrl,\n              },\n            }],\n          });\n        }\n\n        // Verify payment\n        const verification = await this.verifyPayment(paymentSignature, resolvedPrice, options.maxTimeout);\n\n        if (!verification.verified) {\n          return res.status(402).json({\n            error: 'Payment verification failed',\n            code: 'PAYMENT_INVALID',\n            details: verification.error,\n          });\n        }\n\n        req.payment = verification;\n\n        if (options.customRules) {\n          const customValid = await options.customRules(req);\n          if (!customValid) {\n            return res.status(403).json({ error: 'Custom validation failed', code: 'VALIDATION_FAILED' });\n          }\n        }\n\n        next();\n      } catch (error) {\n        console.error('Relai protection error:', error);\n        res.status(500).json({ error: 'Internal server error', code: 'SERVER_ERROR' });\n      }\n    };\n  }\n\n  private async verifyPayment(signature: string, expectedPrice: number, timeoutMs?: number): Promise<PaymentResult> {\n    try {\n      const response = await this.client.post(\n        '/verify-payment',\n        { signature, expectedPrice, network: this.config.network },\n        { timeout: typeof timeoutMs === 'number' ? Math.max(1, timeoutMs) : undefined },\n      );\n      return response.data;\n    } catch (error: any) {\n      return { verified: false, error: error.response?.data?.error || 'Verification failed' };\n    }\n  }\n\n  async getStats(apiId?: string) {\n    const params = apiId ? { apiId } : {};\n    const response = await this.client.get('/stats', { params });\n    return response.data;\n  }\n\n  createProtectedEndpoint(options: ProtectOptions) {\n    return this.protect(options);\n  }\n}\n\nexport default Relai;\n","// src/types.ts\n\n// ============================================================================\n// Constants\n// ============================================================================\n\n/** RelAI Facilitator URL */\nexport const RELAI_FACILITATOR_URL = 'https://facilitator.x402.fi';\n\n// ============================================================================\n// Supported Networks\n// ============================================================================\n\n/** All networks supported by RelAI facilitator */\nexport type RelaiNetwork = 'solana' | 'base' | 'avalanche' | 'skale-base';\n\n/** CAIP-2 network identifiers */\nexport const NETWORK_CAIP2: Record<RelaiNetwork, string> = {\n  'solana': 'solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp',\n  'base': 'eip155:8453',\n  'avalanche': 'eip155:43114',\n  'skale-base': 'eip155:1187947933',\n};\n\n/** Reverse lookup: CAIP-2 → simple network name */\nexport const CAIP2_TO_NETWORK: Record<string, RelaiNetwork> = Object.fromEntries(\n  Object.entries(NETWORK_CAIP2).map(([k, v]) => [v, k as RelaiNetwork])\n) as Record<string, RelaiNetwork>;\n\n/** Chain IDs for EVM networks */\nexport const CHAIN_IDS: Record<string, number> = {\n  'base': 8453,\n  'avalanche': 43114,\n  'skale-base': 1187947933,\n};\n\n/** USDC contract addresses per network */\nexport const USDC_ADDRESSES: Record<RelaiNetwork, string> = {\n  'solana': 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',\n  'base': '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',\n  'avalanche': '0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E',\n  'skale-base': '0x85889c8c714505E0c94b30fcfcF64fE3Ac8FCb20',\n};\n\n/** Explorer URLs per network */\nexport const EXPLORER_TX_URL: Record<RelaiNetwork, (tx: string) => string> = {\n  'solana': (tx) => `https://solscan.io/tx/${tx}`,\n  'base': (tx) => `https://basescan.org/tx/${tx}`,\n  'avalanche': (tx) => `https://snowtrace.io/tx/${tx}`,\n  'skale-base': (tx) => `https://skale-base-explorer.skalenodes.com/tx/${tx}`,\n};\n\n/** Human-readable network labels */\nexport const NETWORK_LABELS: Record<RelaiNetwork, string> = {\n  'solana': 'Solana',\n  'base': 'Base',\n  'avalanche': 'Avalanche',\n  'skale-base': 'SKALE Base',\n};\n\n/** Legacy CAIP-2 exports for backward compatibility */\nexport const SOLANA_MAINNET_NETWORK = NETWORK_CAIP2['solana'];\nexport const BASE_MAINNET_NETWORK = NETWORK_CAIP2['base'];\n\n/** Legacy USDC exports for backward compatibility */\nexport const USDC_SOLANA = USDC_ADDRESSES['solana'];\nexport const USDC_BASE = USDC_ADDRESSES['base'];\n\n/** All supported RelAI networks list */\nexport const RELAI_NETWORKS: RelaiNetwork[] = ['solana', 'base', 'avalanche', 'skale-base'];\n\n/** Check if a network is Solana-based */\nexport function isSolana(network: string): boolean {\n  return network === 'solana' || network.startsWith('solana:');\n}\n\n/** Check if a network is EVM-based */\nexport function isEvm(network: string): boolean {\n  return ['base', 'avalanche', 'skale-base'].includes(network) || network.startsWith('eip155:');\n}\n\n/** Normalize CAIP-2 or simple name to RelaiNetwork */\nexport function normalizeNetwork(network: string): RelaiNetwork | null {\n  if (RELAI_NETWORKS.includes(network as RelaiNetwork)) return network as RelaiNetwork;\n  const fromCaip2 = CAIP2_TO_NETWORK[network];\n  if (fromCaip2) return fromCaip2;\n  // Partial match\n  if (network.startsWith('solana:')) return 'solana';\n  if (network.startsWith('eip155:')) {\n    const chainId = parseInt(network.split(':')[1]);\n    const entry = Object.entries(CHAIN_IDS).find(([, id]) => id === chainId);\n    if (entry) return entry[0] as RelaiNetwork;\n  }\n  return null;\n}\n\n// ============================================================================\n// Wallet Types\n// ============================================================================\n\n/** Solana wallet interface */\nexport interface SolanaWallet {\n  publicKey: { toString(): string } | null;\n  signTransaction: ((tx: unknown) => Promise<unknown>) | null;\n  signAllTransactions?: ((txs: unknown[]) => Promise<unknown[]>) | null;\n}\n\n/** EVM wallet interface (viem-compatible) */\nexport interface EvmWallet {\n  address: string;\n  signTypedData: (params: unknown) => Promise<string>;\n  chain?: { id: number };\n}\n\n/** Wallet set for multi-chain support */\nexport interface WalletSet {\n  solana?: SolanaWallet;\n  evm?: EvmWallet;\n}\n\n// ============================================================================\n// Payment Types\n// ============================================================================\n\n/** Extra fields in payment requirements */\nexport interface AcceptsExtra {\n  feePayer?: string;\n  decimals?: number;\n  name?: string;\n  version?: string;\n  [key: string]: unknown;\n}\n\n/** A single payment option */\nexport interface PaymentAccept {\n  x402Version?: 1 | 2;\n  scheme: string;\n  network: string;\n  maxAmountRequired?: string;\n  amount?: string;\n  asset: string;\n  payTo: string;\n  maxTimeoutSeconds?: number;\n  extra?: AcceptsExtra;\n  resource?: string;\n  description?: string;\n  mimeType?: string;\n  outputSchema?: unknown;\n}\n\n/** Resource info for v2 */\nexport interface ResourceInfo {\n  url: string;\n  description?: string;\n  mimeType?: string;\n}\n\n/** Payment requirements (402 response) */\nexport interface PaymentRequired {\n  x402Version: 1 | 2;\n  error?: string;\n  accepts: PaymentAccept[];\n  resource?: ResourceInfo;\n  extensions?: Record<string, unknown>;\n}\n\n// ============================================================================\n// Config Types\n// ============================================================================\n\nexport interface RelaiConfig {\n  apiKey?: string;\n  network?: RelaiNetwork;\n  facilitatorUrl?: string;\n  apiBaseUrl?: string;\n}\n\nexport type DynamicPrice = number | ((req: unknown) => number | Promise<number>);\n\nexport interface ProtectOptions {\n  /** Price in USD (e.g., 0.01 for 1 cent) */\n  price: DynamicPrice;\n  /** Wallet address to receive payments */\n  payTo: string;\n  /** Description shown to payer */\n  description?: string;\n  /** Maximum timeout in seconds */\n  maxTimeout?: number;\n  /** Custom validation rules */\n  customRules?: (req: unknown) => boolean | Promise<boolean>;\n  onPaymentRequired?: (\n    req: unknown,\n    info: { price: number; description?: string; facilitatorUrl?: string }\n  ) => void;\n  onPaymentVerified?: (req: unknown, result: PaymentResult) => void;\n  onError?: (req: unknown, error: unknown) => void;\n}\n\nexport interface PaymentResult {\n  verified: boolean;\n  transactionId?: string;\n  amount?: number;\n  currency?: string;\n  error?: string;\n}\n"],"mappings":"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","names":[]}

package/dist/types-DGRfrYd3.d.cts

@@ -0,0 +1,124 @@
+/** RelAI Facilitator URL */
+declare const RELAI_FACILITATOR_URL = "https://facilitator.x402.fi";
+/** All networks supported by RelAI facilitator */
+type RelaiNetwork = 'solana' | 'base' | 'avalanche' | 'skale-base';
+/** CAIP-2 network identifiers */
+declare const NETWORK_CAIP2: Record<RelaiNetwork, string>;
+/** Reverse lookup: CAIP-2 → simple network name */
+declare const CAIP2_TO_NETWORK: Record<string, RelaiNetwork>;
+/** Chain IDs for EVM networks */
+declare const CHAIN_IDS: Record<string, number>;
+/** USDC contract addresses per network */
+declare const USDC_ADDRESSES: Record<RelaiNetwork, string>;
+/** Explorer URLs per network */
+declare const EXPLORER_TX_URL: Record<RelaiNetwork, (tx: string) => string>;
+/** Human-readable network labels */
+declare const NETWORK_LABELS: Record<RelaiNetwork, string>;
+/** Legacy CAIP-2 exports for backward compatibility */
+declare const SOLANA_MAINNET_NETWORK: string;
+declare const BASE_MAINNET_NETWORK: string;
+/** Legacy USDC exports for backward compatibility */
+declare const USDC_SOLANA: string;
+declare const USDC_BASE: string;
+/** All supported RelAI networks list */
+declare const RELAI_NETWORKS: RelaiNetwork[];
+/** Check if a network is Solana-based */
+declare function isSolana(network: string): boolean;
+/** Check if a network is EVM-based */
+declare function isEvm(network: string): boolean;
+/** Normalize CAIP-2 or simple name to RelaiNetwork */
+declare function normalizeNetwork(network: string): RelaiNetwork | null;
+/** Solana wallet interface */
+interface SolanaWallet {
+    publicKey: {
+        toString(): string;
+    } | null;
+    signTransaction: ((tx: unknown) => Promise<unknown>) | null;
+    signAllTransactions?: ((txs: unknown[]) => Promise<unknown[]>) | null;
+}
+/** EVM wallet interface (viem-compatible) */
+interface EvmWallet {
+    address: string;
+    signTypedData: (params: unknown) => Promise<string>;
+    chain?: {
+        id: number;
+    };
+}
+/** Wallet set for multi-chain support */
+interface WalletSet {
+    solana?: SolanaWallet;
+    evm?: EvmWallet;
+}
+/** Extra fields in payment requirements */
+interface AcceptsExtra {
+    feePayer?: string;
+    decimals?: number;
+    name?: string;
+    version?: string;
+    [key: string]: unknown;
+}
+/** A single payment option */
+interface PaymentAccept {
+    x402Version?: 1 | 2;
+    scheme: string;
+    network: string;
+    maxAmountRequired?: string;
+    amount?: string;
+    asset: string;
+    payTo: string;
+    maxTimeoutSeconds?: number;
+    extra?: AcceptsExtra;
+    resource?: string;
+    description?: string;
+    mimeType?: string;
+    outputSchema?: unknown;
+}
+/** Resource info for v2 */
+interface ResourceInfo {
+    url: string;
+    description?: string;
+    mimeType?: string;
+}
+/** Payment requirements (402 response) */
+interface PaymentRequired {
+    x402Version: 1 | 2;
+    error?: string;
+    accepts: PaymentAccept[];
+    resource?: ResourceInfo;
+    extensions?: Record<string, unknown>;
+}
+interface RelaiConfig {
+    apiKey?: string;
+    network?: RelaiNetwork;
+    facilitatorUrl?: string;
+    apiBaseUrl?: string;
+}
+type DynamicPrice = number | ((req: unknown) => number | Promise<number>);
+interface ProtectOptions {
+    /** Price in USD (e.g., 0.01 for 1 cent) */
+    price: DynamicPrice;
+    /** Wallet address to receive payments */
+    payTo: string;
+    /** Description shown to payer */
+    description?: string;
+    /** Maximum timeout in seconds */
+    maxTimeout?: number;
+    /** Custom validation rules */
+    customRules?: (req: unknown) => boolean | Promise<boolean>;
+    onPaymentRequired?: (req: unknown, info: {
+        price: number;
+        description?: string;
+        facilitatorUrl?: string;
+    }) => void;
+    onPaymentVerified?: (req: unknown, result: PaymentResult) => void;
+    onError?: (req: unknown, error: unknown) => void;
+}
+interface PaymentResult {
+    verified: boolean;
+    transactionId?: string;
+    amount?: number;
+    currency?: string;
+    error?: string;
+}
+
+export { type AcceptsExtra as A, BASE_MAINNET_NETWORK as B, CAIP2_TO_NETWORK as C, type DynamicPrice as D, EXPLORER_TX_URL as E, NETWORK_CAIP2 as N, type PaymentAccept as P, RELAI_FACILITATOR_URL as R, SOLANA_MAINNET_NETWORK as S, USDC_ADDRESSES as U, type WalletSet as W, type RelaiNetwork as a, CHAIN_IDS as b, NETWORK_LABELS as c, USDC_SOLANA as d, USDC_BASE as e, RELAI_NETWORKS as f, isEvm as g, type SolanaWallet as h, isSolana as i, type EvmWallet as j, type ResourceInfo as k, type PaymentRequired as l, type RelaiConfig as m, normalizeNetwork as n, type ProtectOptions as o, type PaymentResult as p };

package/dist/types-DGRfrYd3.d.ts

@@ -0,0 +1,124 @@
+/** RelAI Facilitator URL */
+declare const RELAI_FACILITATOR_URL = "https://facilitator.x402.fi";
+/** All networks supported by RelAI facilitator */
+type RelaiNetwork = 'solana' | 'base' | 'avalanche' | 'skale-base';
+/** CAIP-2 network identifiers */
+declare const NETWORK_CAIP2: Record<RelaiNetwork, string>;
+/** Reverse lookup: CAIP-2 → simple network name */
+declare const CAIP2_TO_NETWORK: Record<string, RelaiNetwork>;
+/** Chain IDs for EVM networks */
+declare const CHAIN_IDS: Record<string, number>;
+/** USDC contract addresses per network */
+declare const USDC_ADDRESSES: Record<RelaiNetwork, string>;
+/** Explorer URLs per network */
+declare const EXPLORER_TX_URL: Record<RelaiNetwork, (tx: string) => string>;
+/** Human-readable network labels */
+declare const NETWORK_LABELS: Record<RelaiNetwork, string>;
+/** Legacy CAIP-2 exports for backward compatibility */
+declare const SOLANA_MAINNET_NETWORK: string;
+declare const BASE_MAINNET_NETWORK: string;
+/** Legacy USDC exports for backward compatibility */
+declare const USDC_SOLANA: string;
+declare const USDC_BASE: string;
+/** All supported RelAI networks list */
+declare const RELAI_NETWORKS: RelaiNetwork[];
+/** Check if a network is Solana-based */
+declare function isSolana(network: string): boolean;
+/** Check if a network is EVM-based */
+declare function isEvm(network: string): boolean;
+/** Normalize CAIP-2 or simple name to RelaiNetwork */
+declare function normalizeNetwork(network: string): RelaiNetwork | null;
+/** Solana wallet interface */
+interface SolanaWallet {
+    publicKey: {
+        toString(): string;
+    } | null;
+    signTransaction: ((tx: unknown) => Promise<unknown>) | null;
+    signAllTransactions?: ((txs: unknown[]) => Promise<unknown[]>) | null;
+}
+/** EVM wallet interface (viem-compatible) */
+interface EvmWallet {
+    address: string;
+    signTypedData: (params: unknown) => Promise<string>;
+    chain?: {
+        id: number;
+    };
+}
+/** Wallet set for multi-chain support */
+interface WalletSet {
+    solana?: SolanaWallet;
+    evm?: EvmWallet;
+}
+/** Extra fields in payment requirements */
+interface AcceptsExtra {
+    feePayer?: string;
+    decimals?: number;
+    name?: string;
+    version?: string;
+    [key: string]: unknown;
+}
+/** A single payment option */
+interface PaymentAccept {
+    x402Version?: 1 | 2;
+    scheme: string;
+    network: string;
+    maxAmountRequired?: string;
+    amount?: string;
+    asset: string;
+    payTo: string;
+    maxTimeoutSeconds?: number;
+    extra?: AcceptsExtra;
+    resource?: string;
+    description?: string;
+    mimeType?: string;
+    outputSchema?: unknown;
+}
+/** Resource info for v2 */
+interface ResourceInfo {
+    url: string;
+    description?: string;
+    mimeType?: string;
+}
+/** Payment requirements (402 response) */
+interface PaymentRequired {
+    x402Version: 1 | 2;
+    error?: string;
+    accepts: PaymentAccept[];
+    resource?: ResourceInfo;
+    extensions?: Record<string, unknown>;
+}
+interface RelaiConfig {
+    apiKey?: string;
+    network?: RelaiNetwork;
+    facilitatorUrl?: string;
+    apiBaseUrl?: string;
+}
+type DynamicPrice = number | ((req: unknown) => number | Promise<number>);
+interface ProtectOptions {
+    /** Price in USD (e.g., 0.01 for 1 cent) */
+    price: DynamicPrice;
+    /** Wallet address to receive payments */
+    payTo: string;
+    /** Description shown to payer */
+    description?: string;
+    /** Maximum timeout in seconds */
+    maxTimeout?: number;
+    /** Custom validation rules */
+    customRules?: (req: unknown) => boolean | Promise<boolean>;
+    onPaymentRequired?: (req: unknown, info: {
+        price: number;
+        description?: string;
+        facilitatorUrl?: string;
+    }) => void;
+    onPaymentVerified?: (req: unknown, result: PaymentResult) => void;
+    onError?: (req: unknown, error: unknown) => void;
+}
+interface PaymentResult {
+    verified: boolean;
+    transactionId?: string;
+    amount?: number;
+    currency?: string;
+    error?: string;
+}
+
+export { type AcceptsExtra as A, BASE_MAINNET_NETWORK as B, CAIP2_TO_NETWORK as C, type DynamicPrice as D, EXPLORER_TX_URL as E, NETWORK_CAIP2 as N, type PaymentAccept as P, RELAI_FACILITATOR_URL as R, SOLANA_MAINNET_NETWORK as S, USDC_ADDRESSES as U, type WalletSet as W, type RelaiNetwork as a, CHAIN_IDS as b, NETWORK_LABELS as c, USDC_SOLANA as d, USDC_BASE as e, RELAI_NETWORKS as f, isEvm as g, type SolanaWallet as h, isSolana as i, type EvmWallet as j, type ResourceInfo as k, type PaymentRequired as l, type RelaiConfig as m, normalizeNetwork as n, type ProtectOptions as o, type PaymentResult as p };