@sly_ai/sdk 0.1.0

package/dist/x402.mjs

@@ -0,0 +1,471 @@
+// src/config.ts
+var ENVIRONMENT_CONFIGS = {
+  sandbox: {
+    apiUrl: "https://sandbox.getsly.ai",
+    facilitatorUrl: "https://facilitator.x402.org"
+    // x402.org Base Sepolia
+  },
+  testnet: {
+    apiUrl: "https://sandbox.getsly.ai",
+    facilitatorUrl: "https://facilitator.x402.org"
+    // x402.org Base Sepolia
+  },
+  production: {
+    apiUrl: "https://api.getsly.ai",
+    facilitatorUrl: "https://facilitator.coinbase.com"
+    // Coinbase CDP Base mainnet
+  }
+};
+function getEnvironmentConfig(environment) {
+  return ENVIRONMENT_CONFIGS[environment];
+}
+function validateEnvironment(environment, evmPrivateKey) {
+  if (environment !== "sandbox" && !evmPrivateKey) {
+    throw new Error(
+      `EVM private key is required for ${environment} environment. Use sandbox mode for local development without blockchain.`
+    );
+  }
+}
+
+// src/facilitator/sandbox-facilitator.ts
+var SandboxFacilitator = class {
+  constructor(config) {
+    this.config = {
+      apiUrl: config.apiUrl,
+      apiKey: config.apiKey,
+      settlementDelayMs: config.settlementDelayMs ?? 0,
+      failureRate: config.failureRate ?? 0,
+      debug: config.debug ?? false,
+      supportedSchemes: config.supportedSchemes ?? [
+        {
+          scheme: "exact-evm",
+          networks: ["eip155:8453", "eip155:84532"]
+          // Base mainnet and Sepolia
+        }
+      ]
+    };
+    if (this.config.debug) {
+      console.log("[SandboxFacilitator] Initialized with config:", {
+        apiUrl: this.config.apiUrl,
+        settlementDelayMs: this.config.settlementDelayMs,
+        failureRate: this.config.failureRate
+      });
+    }
+  }
+  /**
+   * Verify a payment payload
+   * 
+   * In sandbox mode, this validates the structure but skips signature verification
+   */
+  async verify(request) {
+    const { payment } = request;
+    if (this.config.debug) {
+      console.log("[SandboxFacilitator] Verifying payment:", payment);
+    }
+    const requiredFields = ["scheme", "network", "amount", "token", "from", "to"];
+    for (const field of requiredFields) {
+      if (!payment[field]) {
+        return {
+          valid: false,
+          reason: `Missing required field: ${field}`
+        };
+      }
+    }
+    const schemeSupported = this.config.supportedSchemes.some(
+      (s) => s.scheme === payment.scheme
+    );
+    if (!schemeSupported) {
+      return {
+        valid: false,
+        reason: `Unsupported scheme: ${payment.scheme}`,
+        details: {
+          supportedSchemes: this.config.supportedSchemes.map((s) => s.scheme)
+        }
+      };
+    }
+    const scheme = this.config.supportedSchemes.find(
+      (s) => s.scheme === payment.scheme
+    );
+    if (scheme && !scheme.networks.includes(payment.network)) {
+      return {
+        valid: false,
+        reason: `Unsupported network: ${payment.network} for scheme: ${payment.scheme}`,
+        details: {
+          supportedNetworks: scheme.networks
+        }
+      };
+    }
+    const amount = parseFloat(payment.amount);
+    if (isNaN(amount) || amount <= 0) {
+      return {
+        valid: false,
+        reason: `Invalid amount: ${payment.amount}`
+      };
+    }
+    return {
+      valid: true
+    };
+  }
+  /**
+   * Settle a payment
+   * 
+   * In sandbox mode, this generates a mock transaction hash and
+   * optionally records the payment in PayOS
+   */
+  async settle(request) {
+    const { payment } = request;
+    if (this.config.debug) {
+      console.log("[SandboxFacilitator] Settling payment:", payment);
+    }
+    const verification = await this.verify({ payment });
+    if (!verification.valid) {
+      throw new Error(`Payment verification failed: ${verification.reason}`);
+    }
+    if (this.config.failureRate > 0) {
+      const random = Math.random() * 100;
+      if (random < this.config.failureRate) {
+        throw new Error("Simulated settlement failure");
+      }
+    }
+    if (this.config.settlementDelayMs > 0) {
+      await new Promise(
+        (resolve) => setTimeout(resolve, this.config.settlementDelayMs)
+      );
+    }
+    const txHash = this.generateMockTxHash();
+    if (this.config.debug) {
+      console.log("[SandboxFacilitator] Settlement complete:", {
+        txHash,
+        amount: payment.amount,
+        from: payment.from,
+        to: payment.to
+      });
+    }
+    return {
+      transactionHash: txHash,
+      settled: true,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString()
+    };
+  }
+  /**
+   * Get supported schemes and networks
+   */
+  async supported() {
+    return {
+      schemes: this.config.supportedSchemes
+    };
+  }
+  /**
+   * Generate a realistic-looking mock transaction hash
+   */
+  generateMockTxHash() {
+    const chars = "0123456789abcdef";
+    let hash = "0x";
+    for (let i = 0; i < 64; i++) {
+      hash += chars[Math.floor(Math.random() * chars.length)];
+    }
+    return hash;
+  }
+};
+
+// src/protocols/x402/client.ts
+var SlyX402Client = class {
+  constructor(config) {
+    this.dailySpent = 0;
+    validateEnvironment(config.environment, config.evmPrivateKey);
+    const envConfig = getEnvironmentConfig(config.environment);
+    this.config = {
+      apiKey: config.apiKey,
+      environment: config.environment,
+      evmPrivateKey: config.evmPrivateKey,
+      facilitatorUrl: config.facilitatorUrl || envConfig.facilitatorUrl || "",
+      maxAutoPayAmount: config.maxAutoPayAmount || "1.00",
+      maxDailySpend: config.maxDailySpend || "100.00",
+      onPayment: config.onPayment,
+      onSettlement: config.onSettlement,
+      settleToRail: config.settleToRail
+    };
+    this.lastResetDate = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+    if (this.config.environment === "sandbox") {
+      this.sandboxFacilitator = new SandboxFacilitator({
+        apiUrl: envConfig.apiUrl,
+        apiKey: this.config.apiKey
+      });
+    }
+  }
+  /**
+   * Fetch a resource with automatic 402 payment handling
+   */
+  async fetch(url, options = {}) {
+    const { maxPayment, ...fetchOptions } = options;
+    let response = await fetch(url, fetchOptions);
+    if (response.status !== 402) {
+      return response;
+    }
+    const paymentRequired = await this.parse402Response(response);
+    const acceptedOption = paymentRequired.accepts[0];
+    if (!acceptedOption) {
+      throw new Error("No acceptable payment options in 402 response");
+    }
+    const amount = parseFloat(acceptedOption.amount);
+    const maxAmount = parseFloat(maxPayment || this.config.maxAutoPayAmount);
+    if (amount > maxAmount) {
+      throw new Error(
+        `Payment amount ${acceptedOption.amount} exceeds max auto-pay amount ${maxPayment || this.config.maxAutoPayAmount}`
+      );
+    }
+    this.resetDailySpendIfNeeded();
+    if (this.dailySpent + amount > parseFloat(this.config.maxDailySpend)) {
+      throw new Error(
+        `Payment would exceed daily limit. Spent: ${this.dailySpent}, Limit: ${this.config.maxDailySpend}`
+      );
+    }
+    const payment = await this.createPayment(acceptedOption);
+    if (this.config.onPayment) {
+      await this.config.onPayment({
+        amount: acceptedOption.amount,
+        currency: acceptedOption.token,
+        from: payment.from,
+        to: payment.to,
+        scheme: acceptedOption.scheme,
+        network: acceptedOption.network,
+        timestamp: (/* @__PURE__ */ new Date()).toISOString()
+      });
+    }
+    this.dailySpent += amount;
+    response = await fetch(url, {
+      ...fetchOptions,
+      headers: {
+        ...fetchOptions.headers,
+        "X-Payment": JSON.stringify(payment)
+      }
+    });
+    if (this.config.onSettlement && payment.transactionHash) {
+      await this.config.onSettlement({
+        transactionHash: payment.transactionHash,
+        amount: acceptedOption.amount,
+        currency: acceptedOption.token,
+        timestamp: (/* @__PURE__ */ new Date()).toISOString()
+      });
+    }
+    return response;
+  }
+  /**
+   * Get client status
+   */
+  getStatus() {
+    this.resetDailySpendIfNeeded();
+    return {
+      environment: this.config.environment,
+      dailySpent: this.dailySpent.toFixed(2),
+      dailyLimit: this.config.maxDailySpend,
+      walletAddress: this.getWalletAddress()
+    };
+  }
+  /**
+   * Parse 402 response
+   */
+  async parse402Response(response) {
+    const body = await response.json();
+    if (!body.accepts || !Array.isArray(body.accepts)) {
+      throw new Error("Invalid 402 response: missing accepts array");
+    }
+    return {
+      statusCode: 402,
+      accepts: body.accepts
+    };
+  }
+  /**
+   * Create payment based on environment
+   */
+  async createPayment(option) {
+    if (this.config.environment === "sandbox") {
+      return this.createSandboxPayment(option);
+    } else {
+      return this.createBlockchainPayment(option);
+    }
+  }
+  /**
+   * Create sandbox payment (mock)
+   */
+  async createSandboxPayment(option) {
+    if (!this.sandboxFacilitator) {
+      throw new Error("Sandbox facilitator not initialized");
+    }
+    const payment = {
+      scheme: option.scheme,
+      network: option.network,
+      amount: option.amount,
+      token: option.token,
+      from: "0x0000000000000000000000000000000000000001",
+      // Mock address
+      to: "0x0000000000000000000000000000000000000002"
+      // Mock address
+    };
+    const settlement = await this.sandboxFacilitator.settle({ payment });
+    return {
+      ...payment,
+      transactionHash: settlement.transactionHash
+    };
+  }
+  /**
+   * Create blockchain payment (real EVM)
+   */
+  async createBlockchainPayment(_option) {
+    if (!this.config.evmPrivateKey) {
+      throw new Error("EVM private key required for blockchain payments");
+    }
+    throw new Error("Blockchain payments not yet implemented - use sandbox mode");
+  }
+  /**
+   * Get wallet address based on environment
+   */
+  getWalletAddress() {
+    if (this.config.environment === "sandbox") {
+      return "0x0000000000000000000000000000000000000001";
+    }
+    return void 0;
+  }
+  /**
+   * Reset daily spend if date has changed
+   */
+  resetDailySpendIfNeeded() {
+    const today = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+    if (today !== this.lastResetDate) {
+      this.dailySpent = 0;
+      this.lastResetDate = today;
+    }
+  }
+};
+
+// src/protocols/x402/provider.ts
+var SlyX402Provider = class {
+  constructor(config) {
+    const envConfig = getEnvironmentConfig(config.environment);
+    this.config = {
+      apiKey: config.apiKey,
+      environment: config.environment,
+      routes: config.routes,
+      facilitatorUrl: config.facilitatorUrl || envConfig.facilitatorUrl
+    };
+    if (this.config.environment === "sandbox") {
+      this.sandboxFacilitator = new SandboxFacilitator({
+        apiUrl: envConfig.apiUrl,
+        apiKey: this.config.apiKey
+      });
+    }
+  }
+  /**
+   * Create Express middleware
+   */
+  middleware() {
+    return async (req, res, next) => {
+      try {
+        const routeConfig = this.getRouteConfig(req);
+        if (!routeConfig) {
+          return next();
+        }
+        const paymentHeader = req.headers["x-payment"];
+        if (!paymentHeader) {
+          return this.return402(req, res, routeConfig);
+        }
+        const isValid = await this.verifyPayment(paymentHeader, routeConfig);
+        if (!isValid) {
+          return this.return402(req, res, routeConfig);
+        }
+        next();
+      } catch (error) {
+        res.status(500).json({
+          error: "Payment verification failed",
+          message: error.message
+        });
+      }
+    };
+  }
+  /**
+   * Get route configuration for request
+   */
+  getRouteConfig(req) {
+    const routeKey = `${req.method} ${req.path}`;
+    if (this.config.routes[routeKey]) {
+      return this.config.routes[routeKey];
+    }
+    for (const [pattern, config] of Object.entries(this.config.routes)) {
+      if (this.matchRoute(pattern, routeKey)) {
+        return config;
+      }
+    }
+    return null;
+  }
+  /**
+   * Simple route pattern matching
+   */
+  matchRoute(pattern, route) {
+    const regexPattern = pattern.replace(/\*/g, ".*").replace(/\//g, "\\/");
+    const regex = new RegExp(`^${regexPattern}$`);
+    return regex.test(route);
+  }
+  /**
+   * Return 402 Payment Required response
+   */
+  return402(_req, res, routeConfig) {
+    const scheme = "exact-evm";
+    const network = this.config.environment === "sandbox" ? "eip155:8453" : "eip155:8453";
+    res.status(402).json({
+      statusCode: 402,
+      message: "Payment Required",
+      accepts: [
+        {
+          scheme,
+          network,
+          token: routeConfig.token || "USDC",
+          amount: routeConfig.price,
+          facilitator: this.config.facilitatorUrl,
+          description: routeConfig.description
+        }
+      ]
+    });
+  }
+  /**
+   * Verify payment
+   */
+  async verifyPayment(paymentHeader, routeConfig) {
+    try {
+      const payment = JSON.parse(paymentHeader);
+      if (payment.amount !== routeConfig.price) {
+        return false;
+      }
+      const expectedToken = routeConfig.token || "USDC";
+      if (payment.token !== expectedToken) {
+        return false;
+      }
+      if (this.config.environment === "sandbox") {
+        return this.verifySandboxPayment(payment);
+      } else {
+        return this.verifyBlockchainPayment(payment);
+      }
+    } catch (error) {
+      return false;
+    }
+  }
+  /**
+   * Verify sandbox payment
+   */
+  async verifySandboxPayment(payment) {
+    if (!this.sandboxFacilitator) {
+      return false;
+    }
+    const result = await this.sandboxFacilitator.verify({ payment });
+    return result.valid;
+  }
+  /**
+   * Verify blockchain payment
+   */
+  async verifyBlockchainPayment(_payment) {
+    throw new Error("Blockchain payment verification not yet implemented - use sandbox mode");
+  }
+};
+
+export { SlyX402Client as PayOSX402Client, SlyX402Provider as PayOSX402Provider, SlyX402Client, SlyX402Provider };
+//# sourceMappingURL=x402.mjs.map
+//# sourceMappingURL=x402.mjs.map

package/dist/x402.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/config.ts","../src/facilitator/sandbox-facilitator.ts","../src/protocols/x402/client.ts","../src/protocols/x402/provider.ts"],"names":[],"mappings":"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","file":"x402.mjs","sourcesContent":["import type { PayOSEnvironment, EnvironmentConfig } from './types';\n\n/**\n * Environment-specific configuration\n */\nexport const ENVIRONMENT_CONFIGS: Record<PayOSEnvironment, EnvironmentConfig> = {\n  sandbox: {\n    apiUrl: 'https://sandbox.getsly.ai',\n    facilitatorUrl: 'https://facilitator.x402.org', // x402.org Base Sepolia\n  },\n  testnet: {\n    apiUrl: 'https://sandbox.getsly.ai',\n    facilitatorUrl: 'https://facilitator.x402.org', // x402.org Base Sepolia\n  },\n  production: {\n    apiUrl: 'https://api.getsly.ai',\n    facilitatorUrl: 'https://facilitator.coinbase.com', // Coinbase CDP Base mainnet\n  },\n};\n\n/**\n * Infer environment from API key prefix\n * - pk_test_* or pk_sandbox_* → sandbox\n * - pk_live_* → production\n */\nexport function inferEnvironmentFromKey(apiKey: string): PayOSEnvironment | undefined {\n  if (apiKey.startsWith('pk_test_') || apiKey.startsWith('pk_sandbox_')) {\n    return 'sandbox';\n  }\n  if (apiKey.startsWith('pk_live_')) {\n    return 'production';\n  }\n  return undefined;\n}\n\n/**\n * Get configuration for an environment\n */\nexport function getEnvironmentConfig(environment: PayOSEnvironment): EnvironmentConfig {\n  return ENVIRONMENT_CONFIGS[environment];\n}\n\n/**\n * Validate environment configuration\n */\nexport function validateEnvironment(\n  environment: PayOSEnvironment,\n  evmPrivateKey?: string\n): void {\n  if (environment !== 'sandbox' && !evmPrivateKey) {\n    throw new Error(\n      `EVM private key is required for ${environment} environment. ` +\n      'Use sandbox mode for local development without blockchain.'\n    );\n  }\n}\n\n","import type {\n  SandboxFacilitatorConfig,\n  X402Payment,\n  VerifyRequest,\n  VerifyResponse,\n  SettleRequest,\n  SettleResponse,\n  SupportedResponse,\n} from './types';\n\n/**\n * Sandbox Facilitator for x402 protocol\n * \n * Provides a mock blockchain facilitator that implements the x402\n * facilitator interface but skips actual blockchain verification.\n * \n * This enables local development and testing without:\n * - Gas fees\n * - Real USDC\n * - Network delays\n * - EVM private keys\n */\nexport class SandboxFacilitator {\n  private config: Required<SandboxFacilitatorConfig>;\n\n  constructor(config: SandboxFacilitatorConfig) {\n    this.config = {\n      apiUrl: config.apiUrl,\n      apiKey: config.apiKey,\n      settlementDelayMs: config.settlementDelayMs ?? 0,\n      failureRate: config.failureRate ?? 0,\n      debug: config.debug ?? false,\n      supportedSchemes: config.supportedSchemes ?? [\n        {\n          scheme: 'exact-evm',\n          networks: ['eip155:8453', 'eip155:84532'], // Base mainnet and Sepolia\n        },\n      ],\n    };\n\n    if (this.config.debug) {\n      console.log('[SandboxFacilitator] Initialized with config:', {\n        apiUrl: this.config.apiUrl,\n        settlementDelayMs: this.config.settlementDelayMs,\n        failureRate: this.config.failureRate,\n      });\n    }\n  }\n\n  /**\n   * Verify a payment payload\n   * \n   * In sandbox mode, this validates the structure but skips signature verification\n   */\n  async verify(request: VerifyRequest): Promise<VerifyResponse> {\n    const { payment } = request;\n\n    if (this.config.debug) {\n      console.log('[SandboxFacilitator] Verifying payment:', payment);\n    }\n\n    // Validate required fields\n    const requiredFields = ['scheme', 'network', 'amount', 'token', 'from', 'to'];\n    for (const field of requiredFields) {\n      if (!payment[field]) {\n        return {\n          valid: false,\n          reason: `Missing required field: ${field}`,\n        };\n      }\n    }\n\n    // Validate scheme is supported\n    const schemeSupported = this.config.supportedSchemes.some(\n      (s) => s.scheme === payment.scheme\n    );\n    if (!schemeSupported) {\n      return {\n        valid: false,\n        reason: `Unsupported scheme: ${payment.scheme}`,\n        details: {\n          supportedSchemes: this.config.supportedSchemes.map((s) => s.scheme),\n        },\n      };\n    }\n\n    // Validate network is supported for scheme\n    const scheme = this.config.supportedSchemes.find(\n      (s) => s.scheme === payment.scheme\n    );\n    if (scheme && !scheme.networks.includes(payment.network)) {\n      return {\n        valid: false,\n        reason: `Unsupported network: ${payment.network} for scheme: ${payment.scheme}`,\n        details: {\n          supportedNetworks: scheme.networks,\n        },\n      };\n    }\n\n    // Validate amount is a valid number\n    const amount = parseFloat(payment.amount);\n    if (isNaN(amount) || amount <= 0) {\n      return {\n        valid: false,\n        reason: `Invalid amount: ${payment.amount}`,\n      };\n    }\n\n    // In sandbox mode, we skip signature verification\n    // In production, this would verify the EIP-3009 signature\n\n    return {\n      valid: true,\n    };\n  }\n\n  /**\n   * Settle a payment\n   * \n   * In sandbox mode, this generates a mock transaction hash and\n   * optionally records the payment in PayOS\n   */\n  async settle(request: SettleRequest): Promise<SettleResponse> {\n    const { payment } = request;\n\n    if (this.config.debug) {\n      console.log('[SandboxFacilitator] Settling payment:', payment);\n    }\n\n    // First verify the payment\n    const verification = await this.verify({ payment });\n    if (!verification.valid) {\n      throw new Error(`Payment verification failed: ${verification.reason}`);\n    }\n\n    // Simulate random failures if configured\n    if (this.config.failureRate > 0) {\n      const random = Math.random() * 100;\n      if (random < this.config.failureRate) {\n        throw new Error('Simulated settlement failure');\n      }\n    }\n\n    // Simulate settlement delay if configured\n    if (this.config.settlementDelayMs > 0) {\n      await new Promise((resolve) =>\n        setTimeout(resolve, this.config.settlementDelayMs)\n      );\n    }\n\n    // Generate mock transaction hash\n    const txHash = this.generateMockTxHash();\n\n    // Record payment in PayOS (optional - may not be needed in pure sandbox)\n    // This would call the PayOS API to create a transfer record\n    // For now, we'll skip this to keep the facilitator independent\n\n    if (this.config.debug) {\n      console.log('[SandboxFacilitator] Settlement complete:', {\n        txHash,\n        amount: payment.amount,\n        from: payment.from,\n        to: payment.to,\n      });\n    }\n\n    return {\n      transactionHash: txHash,\n      settled: true,\n      timestamp: new Date().toISOString(),\n    };\n  }\n\n  /**\n   * Get supported schemes and networks\n   */\n  async supported(): Promise<SupportedResponse> {\n    return {\n      schemes: this.config.supportedSchemes,\n    };\n  }\n\n  /**\n   * Generate a realistic-looking mock transaction hash\n   */\n  private generateMockTxHash(): string {\n    const chars = '0123456789abcdef';\n    let hash = '0x';\n    for (let i = 0; i < 64; i++) {\n      hash += chars[Math.floor(Math.random() * chars.length)];\n    }\n    return hash;\n  }\n}\n\n","import type {\n  X402ClientConfig,\n  X402ClientStatus,\n  X402PaymentInfo,\n  X402SettlementInfo,\n  X402Response,\n} from './types';\nimport { getEnvironmentConfig, validateEnvironment } from '../../config';\nimport { SandboxFacilitator } from '../../facilitator/sandbox-facilitator';\n\n/**\n * x402 Client for making payments\n *\n * Automatically handles 402 responses by creating payments and retrying.\n * Supports sandbox mode (no blockchain) and production mode (real EVM).\n */\nexport class SlyX402Client {\n  private config: Required<Omit<X402ClientConfig, 'evmPrivateKey' | 'onPayment' | 'onSettlement' | 'settleToRail'>> & {\n    evmPrivateKey?: string;\n    onPayment?: (payment: X402PaymentInfo) => void | Promise<void>;\n    onSettlement?: (settlement: X402SettlementInfo) => void | Promise<void>;\n    settleToRail?: 'pix' | 'spei' | 'none';\n  };\n  private dailySpent: number = 0;\n  private lastResetDate: string;\n  private sandboxFacilitator?: SandboxFacilitator;\n\n  constructor(config: X402ClientConfig) {\n    validateEnvironment(config.environment, config.evmPrivateKey);\n\n    const envConfig = getEnvironmentConfig(config.environment);\n\n    this.config = {\n      apiKey: config.apiKey,\n      environment: config.environment,\n      evmPrivateKey: config.evmPrivateKey,\n      facilitatorUrl: config.facilitatorUrl || envConfig.facilitatorUrl || '',\n      maxAutoPayAmount: config.maxAutoPayAmount || '1.00',\n      maxDailySpend: config.maxDailySpend || '100.00',\n      onPayment: config.onPayment,\n      onSettlement: config.onSettlement,\n      settleToRail: config.settleToRail,\n    };\n\n    this.lastResetDate = new Date().toISOString().split('T')[0];\n\n    // Initialize sandbox facilitator if in sandbox mode\n    if (this.config.environment === 'sandbox') {\n      this.sandboxFacilitator = new SandboxFacilitator({\n        apiUrl: envConfig.apiUrl,\n        apiKey: this.config.apiKey,\n      });\n    }\n  }\n\n  /**\n   * Fetch a resource with automatic 402 payment handling\n   */\n  async fetch(url: string, options: RequestInit & { maxPayment?: string } = {}): Promise<Response> {\n    const { maxPayment, ...fetchOptions } = options;\n\n    // Make initial request\n    let response = await fetch(url, fetchOptions);\n\n    // If not 402, return response\n    if (response.status !== 402) {\n      return response;\n    }\n\n    // Parse 402 response\n    const paymentRequired = await this.parse402Response(response);\n\n    // Find acceptable payment option\n    const acceptedOption = paymentRequired.accepts[0];\n    if (!acceptedOption) {\n      throw new Error('No acceptable payment options in 402 response');\n    }\n\n    // Check payment amount against limits\n    const amount = parseFloat(acceptedOption.amount);\n    const maxAmount = parseFloat(maxPayment || this.config.maxAutoPayAmount);\n\n    if (amount > maxAmount) {\n      throw new Error(\n        `Payment amount ${acceptedOption.amount} exceeds max auto-pay amount ${maxPayment || this.config.maxAutoPayAmount}`\n      );\n    }\n\n    // Check daily limit\n    this.resetDailySpendIfNeeded();\n    if (this.dailySpent + amount > parseFloat(this.config.maxDailySpend)) {\n      throw new Error(\n        `Payment would exceed daily limit. Spent: ${this.dailySpent}, Limit: ${this.config.maxDailySpend}`\n      );\n    }\n\n    // Create payment\n    const payment = await this.createPayment(acceptedOption);\n\n    // Fire onPayment callback\n    if (this.config.onPayment) {\n      await this.config.onPayment({\n        amount: acceptedOption.amount,\n        currency: acceptedOption.token,\n        from: payment.from,\n        to: payment.to,\n        scheme: acceptedOption.scheme,\n        network: acceptedOption.network,\n        timestamp: new Date().toISOString(),\n      });\n    }\n\n    // Update daily spend\n    this.dailySpent += amount;\n\n    // Retry request with payment header\n    response = await fetch(url, {\n      ...fetchOptions,\n      headers: {\n        ...fetchOptions.headers,\n        'X-Payment': JSON.stringify(payment),\n      },\n    });\n\n    // Fire onSettlement callback\n    if (this.config.onSettlement && payment.transactionHash) {\n      await this.config.onSettlement({\n        transactionHash: payment.transactionHash,\n        amount: acceptedOption.amount,\n        currency: acceptedOption.token,\n        timestamp: new Date().toISOString(),\n      });\n    }\n\n    return response;\n  }\n\n  /**\n   * Get client status\n   */\n  getStatus(): X402ClientStatus {\n    this.resetDailySpendIfNeeded();\n\n    return {\n      environment: this.config.environment,\n      dailySpent: this.dailySpent.toFixed(2),\n      dailyLimit: this.config.maxDailySpend,\n      walletAddress: this.getWalletAddress(),\n    };\n  }\n\n  /**\n   * Parse 402 response\n   */\n  private async parse402Response(response: Response): Promise<X402Response> {\n    const body: any = await response.json();\n    \n    if (!body.accepts || !Array.isArray(body.accepts)) {\n      throw new Error('Invalid 402 response: missing accepts array');\n    }\n\n    return {\n      statusCode: 402,\n      accepts: body.accepts,\n    };\n  }\n\n  /**\n   * Create payment based on environment\n   */\n  private async createPayment(option: X402Response['accepts'][0]): Promise<any> {\n    if (this.config.environment === 'sandbox') {\n      return this.createSandboxPayment(option);\n    } else {\n      return this.createBlockchainPayment(option);\n    }\n  }\n\n  /**\n   * Create sandbox payment (mock)\n   */\n  private async createSandboxPayment(option: X402Response['accepts'][0]): Promise<any> {\n    if (!this.sandboxFacilitator) {\n      throw new Error('Sandbox facilitator not initialized');\n    }\n\n    const payment = {\n      scheme: option.scheme,\n      network: option.network,\n      amount: option.amount,\n      token: option.token,\n      from: '0x0000000000000000000000000000000000000001', // Mock address\n      to: '0x0000000000000000000000000000000000000002', // Mock address\n    };\n\n    // Settle through sandbox facilitator\n    const settlement = await this.sandboxFacilitator.settle({ payment });\n\n    return {\n      ...payment,\n      transactionHash: settlement.transactionHash,\n    };\n  }\n\n  /**\n   * Create blockchain payment (real EVM)\n   */\n  private async createBlockchainPayment(_option: X402Response['accepts'][0]): Promise<any> {\n    if (!this.config.evmPrivateKey) {\n      throw new Error('EVM private key required for blockchain payments');\n    }\n\n    // In a real implementation, this would:\n    // 1. Use @x402/evm to create an EIP-3009 transfer\n    // 2. Sign with the private key\n    // 3. Submit to the facilitator\n    // 4. Return the payment proof\n\n    // For now, throw an error as this requires the full @x402 integration\n    throw new Error('Blockchain payments not yet implemented - use sandbox mode');\n  }\n\n  /**\n   * Get wallet address based on environment\n   */\n  private getWalletAddress(): string | undefined {\n    if (this.config.environment === 'sandbox') {\n      return '0x0000000000000000000000000000000000000001';\n    }\n\n    // In production, derive from private key\n    return undefined;\n  }\n\n  /**\n   * Reset daily spend if date has changed\n   */\n  private resetDailySpendIfNeeded(): void {\n    const today = new Date().toISOString().split('T')[0];\n    if (today !== this.lastResetDate) {\n      this.dailySpent = 0;\n      this.lastResetDate = today;\n    }\n  }\n}\n\n// Backward compatibility alias\nexport { SlyX402Client as PayOSX402Client };\n\n","import type { Request, Response, NextFunction, RequestHandler } from 'express';\nimport type { SlyEnvironment } from '../../types';\nimport { getEnvironmentConfig } from '../../config';\nimport { SandboxFacilitator } from '../../facilitator/sandbox-facilitator';\n\n/**\n * x402 Provider configuration\n */\nexport interface X402ProviderConfig {\n  /**\n   * Sly API key\n   */\n  apiKey: string;\n\n  /**\n   * Environment (sandbox, testnet, production)\n   */\n  environment: SlyEnvironment;\n\n  /**\n   * Route configuration\n   * Maps route patterns to prices\n   */\n  routes: Record<string, {\n    price: string;\n    description?: string;\n    token?: string;\n  }>;\n\n  /**\n   * Custom facilitator URL (overrides environment default)\n   */\n  facilitatorUrl?: string;\n}\n\n/**\n * x402 Provider for accepting payments\n *\n * Express middleware that returns 402 responses for protected routes\n * and verifies payments before serving content.\n */\nexport class SlyX402Provider {\n  private config: Required<Omit<X402ProviderConfig, 'facilitatorUrl'>> & {\n    facilitatorUrl?: string;\n  };\n  private sandboxFacilitator?: SandboxFacilitator;\n\n  constructor(config: X402ProviderConfig) {\n    const envConfig = getEnvironmentConfig(config.environment);\n\n    this.config = {\n      apiKey: config.apiKey,\n      environment: config.environment,\n      routes: config.routes,\n      facilitatorUrl: config.facilitatorUrl || envConfig.facilitatorUrl,\n    };\n\n    // Initialize sandbox facilitator if in sandbox mode\n    if (this.config.environment === 'sandbox') {\n      this.sandboxFacilitator = new SandboxFacilitator({\n        apiUrl: envConfig.apiUrl,\n        apiKey: this.config.apiKey,\n      });\n    }\n  }\n\n  /**\n   * Create Express middleware\n   */\n  middleware(): RequestHandler {\n    return async (req: Request, res: Response, next: NextFunction) => {\n      try {\n        // Check if route is protected\n        const routeConfig = this.getRouteConfig(req);\n        if (!routeConfig) {\n          // Route not protected, continue\n          return next();\n        }\n\n        // Check for payment header\n        const paymentHeader = req.headers['x-payment'] as string | undefined;\n\n        if (!paymentHeader) {\n          // No payment, return 402\n          return this.return402(req, res, routeConfig);\n        }\n\n        // Verify payment\n        const isValid = await this.verifyPayment(paymentHeader, routeConfig);\n\n        if (!isValid) {\n          // Invalid payment, return 402\n          return this.return402(req, res, routeConfig);\n        }\n\n        // Payment valid, continue to route handler\n        next();\n      } catch (error: any) {\n        res.status(500).json({\n          error: 'Payment verification failed',\n          message: error.message,\n        });\n      }\n    };\n  }\n\n  /**\n   * Get route configuration for request\n   */\n  private getRouteConfig(req: Request): X402ProviderConfig['routes'][string] | null {\n    const routeKey = `${req.method} ${req.path}`;\n    \n    // Exact match\n    if (this.config.routes[routeKey]) {\n      return this.config.routes[routeKey];\n    }\n\n    // Pattern match (simple wildcard support)\n    for (const [pattern, config] of Object.entries(this.config.routes)) {\n      if (this.matchRoute(pattern, routeKey)) {\n        return config;\n      }\n    }\n\n    return null;\n  }\n\n  /**\n   * Simple route pattern matching\n   */\n  private matchRoute(pattern: string, route: string): boolean {\n    // Convert pattern to regex\n    const regexPattern = pattern\n      .replace(/\\*/g, '.*')\n      .replace(/\\//g, '\\\\/');\n    \n    const regex = new RegExp(`^${regexPattern}$`);\n    return regex.test(route);\n  }\n\n  /**\n   * Return 402 Payment Required response\n   */\n  private return402(\n    _req: Request,\n    res: Response,\n    routeConfig: X402ProviderConfig['routes'][string]\n  ): void {\n    const scheme = 'exact-evm';\n    const network = this.config.environment === 'sandbox' \n      ? 'eip155:8453'  // Base mainnet (mock)\n      : 'eip155:8453'; // Base mainnet (real)\n\n    res.status(402).json({\n      statusCode: 402,\n      message: 'Payment Required',\n      accepts: [\n        {\n          scheme,\n          network,\n          token: routeConfig.token || 'USDC',\n          amount: routeConfig.price,\n          facilitator: this.config.facilitatorUrl,\n          description: routeConfig.description,\n        },\n      ],\n    });\n  }\n\n  /**\n   * Verify payment\n   */\n  private async verifyPayment(\n    paymentHeader: string,\n    routeConfig: X402ProviderConfig['routes'][string]\n  ): Promise<boolean> {\n    try {\n      const payment = JSON.parse(paymentHeader);\n\n      // Check amount matches\n      if (payment.amount !== routeConfig.price) {\n        return false;\n      }\n\n      // Check token matches\n      const expectedToken = routeConfig.token || 'USDC';\n      if (payment.token !== expectedToken) {\n        return false;\n      }\n\n      // Verify with facilitator\n      if (this.config.environment === 'sandbox') {\n        return this.verifySandboxPayment(payment);\n      } else {\n        return this.verifyBlockchainPayment(payment);\n      }\n    } catch (error) {\n      return false;\n    }\n  }\n\n  /**\n   * Verify sandbox payment\n   */\n  private async verifySandboxPayment(payment: any): Promise<boolean> {\n    if (!this.sandboxFacilitator) {\n      return false;\n    }\n\n    const result = await this.sandboxFacilitator.verify({ payment });\n    return result.valid;\n  }\n\n  /**\n   * Verify blockchain payment\n   */\n  private async verifyBlockchainPayment(_payment: any): Promise<boolean> {\n    // In production, this would:\n    // 1. Call the real facilitator to verify the payment\n    // 2. Check the signature\n    // 3. Verify the transaction on-chain\n\n    // For now, throw an error as this requires full @x402 integration\n    throw new Error('Blockchain payment verification not yet implemented - use sandbox mode');\n  }\n}\n\n// Backward compatibility alias\nexport { SlyX402Provider as PayOSX402Provider };\n\n"]}

package/package.json

@@ -0,0 +1,118 @@
+{
+  "name": "@sly_ai/sdk",
+  "version": "0.1.0",
+  "description": "Unified PayOS SDK for multi-protocol settlement in LATAM",
+  "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"
+    },
+    "./x402": {
+      "types": "./dist/x402.d.ts",
+      "import": "./dist/x402.mjs",
+      "require": "./dist/x402.js"
+    },
+    "./ap2": {
+      "types": "./dist/ap2.d.ts",
+      "import": "./dist/ap2.mjs",
+      "require": "./dist/ap2.js"
+    },
+    "./acp": {
+      "types": "./dist/acp.d.ts",
+      "import": "./dist/acp.mjs",
+      "require": "./dist/acp.js"
+    },
+    "./ucp": {
+      "types": "./dist/ucp.d.ts",
+      "import": "./dist/ucp.mjs",
+      "require": "./dist/ucp.js"
+    },
+    "./langchain": {
+      "types": "./dist/langchain.d.ts",
+      "import": "./dist/langchain.mjs",
+      "require": "./dist/langchain.js"
+    },
+    "./vercel": {
+      "types": "./dist/vercel.d.ts",
+      "import": "./dist/vercel.mjs",
+      "require": "./dist/vercel.js"
+    },
+    "./cards": {
+      "types": "./dist/cards.d.ts",
+      "import": "./dist/cards.mjs",
+      "require": "./dist/cards.js"
+    },
+    "./a2a": {
+      "types": "./dist/a2a.d.ts",
+      "import": "./dist/a2a.mjs",
+      "require": "./dist/a2a.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "clean": "rm -rf dist"
+  },
+  "keywords": [
+    "payos",
+    "payments",
+    "settlement",
+    "x402",
+    "ap2",
+    "acp",
+    "ucp",
+    "latam",
+    "pix",
+    "spei",
+    "stablecoin",
+    "usdc",
+    "agentic-commerce"
+  ],
+  "dependencies": {
+    "@sly/types": "workspace:*",
+    "@x402/core": "^2.1.0",
+    "@x402/evm": "^2.1.0",
+    "@x402/express": "^2.1.0",
+    "@x402/fetch": "^2.1.0",
+    "ai": "^3.0.0",
+    "zod": "^3.22.4"
+  },
+  "devDependencies": {
+    "@types/express": "^4.17.21",
+    "@types/node": "^20.10.0",
+    "@vitest/coverage-v8": "^2.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.3",
+    "vitest": "^2.0.0"
+  },
+  "peerDependencies": {
+    "express": "^4.18.0"
+  },
+  "peerDependenciesMeta": {
+    "express": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/payos/payos",
+    "directory": "packages/sdk"
+  },
+  "author": "PayOS",
+  "license": "MIT"
+}