moltspay 0.7.2 → 0.8.1

package/dist/server/index.d.mts

@@ -69,11 +69,16 @@ interface MoltsPayServerOptions {
     port?: number;
     host?: string;
     chargeExpirySecs?: number;
+    /** x402 Facilitator URL (default: https://x402.org/facilitator) */
+    facilitatorUrl?: string;
 }
 
 /**
  * MoltsPay Server - Payment infrastructure for AI Agents
  *
+ * Uses x402 protocol with public facilitator (https://x402.org/facilitator).
+ * Server does NOT need private key - facilitator handles on-chain settlement.
+ *
  * Usage:
  *   const server = new MoltsPayServer('./moltspay.services.json');
  *   server.skill('text-to-video', async (params) => { ... });
@@ -83,36 +88,47 @@ interface MoltsPayServerOptions {
 declare class MoltsPayServer {
     private manifest;
     private skills;
-    private charges;
     private options;
+    private facilitatorUrl;
     constructor(servicesPath: string, options?: MoltsPayServerOptions);
     /**
      * Register a skill handler for a service
      */
     skill(serviceId: string, handler: SkillFunction): this;
     /**
-     * Start the server
+     * Start HTTP server
      */
     listen(port?: number): void;
+    /**
+     * Handle incoming request
+     */
     private handleRequest;
     /**
      * GET /services - List available services
      */
     private handleGetServices;
     /**
-     * POST /pay - Create payment request
+     * POST /execute - Execute service with x402 payment
      * Body: { service: string, params: object }
+     * Header: X-Payment (optional - if missing, returns 402)
+     */
+    private handleExecute;
+    /**
+     * Return 402 with x402 payment requirements
+     */
+    private sendPaymentRequired;
+    /**
+     * Basic payment validation (before calling facilitator)
      */
-    private handlePay;
+    private validatePayment;
     /**
-     * POST /verify - Verify payment and execute skill
-     * Body: { chargeId: string, txHash: string }
+     * Verify payment with facilitator
      */
-    private handleVerify;
+    private verifyWithFacilitator;
     /**
-     * GET /status/:chargeId - Check charge status
+     * Settle payment with facilitator (execute on-chain transfer)
      */
-    private handleStatus;
+    private settleWithFacilitator;
     private readBody;
     private sendJson;
 }

package/dist/server/index.d.ts

@@ -69,11 +69,16 @@ interface MoltsPayServerOptions {
     port?: number;
     host?: string;
     chargeExpirySecs?: number;
+    /** x402 Facilitator URL (default: https://x402.org/facilitator) */
+    facilitatorUrl?: string;
 }
 
 /**
  * MoltsPay Server - Payment infrastructure for AI Agents
  *
+ * Uses x402 protocol with public facilitator (https://x402.org/facilitator).
+ * Server does NOT need private key - facilitator handles on-chain settlement.
+ *
  * Usage:
  *   const server = new MoltsPayServer('./moltspay.services.json');
  *   server.skill('text-to-video', async (params) => { ... });
@@ -83,36 +88,47 @@ interface MoltsPayServerOptions {
 declare class MoltsPayServer {
     private manifest;
     private skills;
-    private charges;
     private options;
+    private facilitatorUrl;
     constructor(servicesPath: string, options?: MoltsPayServerOptions);
     /**
      * Register a skill handler for a service
      */
     skill(serviceId: string, handler: SkillFunction): this;
     /**
-     * Start the server
+     * Start HTTP server
      */
     listen(port?: number): void;
+    /**
+     * Handle incoming request
+     */
     private handleRequest;
     /**
      * GET /services - List available services
      */
     private handleGetServices;
     /**
-     * POST /pay - Create payment request
+     * POST /execute - Execute service with x402 payment
      * Body: { service: string, params: object }
+     * Header: X-Payment (optional - if missing, returns 402)
+     */
+    private handleExecute;
+    /**
+     * Return 402 with x402 payment requirements
+     */
+    private sendPaymentRequired;
+    /**
+     * Basic payment validation (before calling facilitator)
      */
-    private handlePay;
+    private validatePayment;
     /**
-     * POST /verify - Verify payment and execute skill
-     * Body: { chargeId: string, txHash: string }
+     * Verify payment with facilitator
      */
-    private handleVerify;
+    private verifyWithFacilitator;
     /**
-     * GET /status/:chargeId - Check charge status
+     * Settle payment with facilitator (execute on-chain transfer)
      */
-    private handleStatus;
+    private settleWithFacilitator;
     private readBody;
     private sendJson;
 }

package/dist/server/index.js

@@ -26,9 +26,6 @@ module.exports = __toCommonJS(server_exports);
 var import_fs = require("fs");
 var import_http = require("http");
 
-// src/verify/index.ts
-var import_ethers = require("ethers");
-
 // src/chains/index.ts
 var CHAINS = {
   // ============ Mainnet ============
@@ -86,101 +83,31 @@ function getChain(name) {
   }
   return config;
 }
-function getChainById(chainId) {
-  return Object.values(CHAINS).find((c) => c.chainId === chainId);
-}
-
-// src/verify/index.ts
-var TRANSFER_EVENT_TOPIC = import_ethers.ethers.id("Transfer(address,address,uint256)");
-async function verifyPayment(params) {
-  const { txHash, expectedAmount, expectedTo } = params;
-  let chain;
-  try {
-    if (typeof params.chain === "number") {
-      chain = getChainById(params.chain);
-    } else {
-      chain = getChain(params.chain || "base");
-    }
-    if (!chain) {
-      return { verified: false, error: `Unsupported chain: ${params.chain}` };
-    }
-  } catch (e) {
-    return { verified: false, error: `Unsupported chain: ${params.chain}` };
-  }
-  try {
-    const provider = new import_ethers.ethers.JsonRpcProvider(chain.rpc);
-    const receipt = await provider.getTransactionReceipt(txHash);
-    if (!receipt) {
-      return { verified: false, error: "Transaction not found or not confirmed" };
-    }
-    if (receipt.status !== 1) {
-      return { verified: false, error: "Transaction failed" };
-    }
-    const usdcAddress = chain.usdc?.toLowerCase();
-    if (!usdcAddress) {
-      return { verified: false, error: `Chain ${chain.name} USDC address not configured` };
-    }
-    for (const log of receipt.logs) {
-      if (log.address.toLowerCase() !== usdcAddress) {
-        continue;
-      }
-      if (log.topics.length < 3 || log.topics[0] !== TRANSFER_EVENT_TOPIC) {
-        continue;
-      }
-      const from = "0x" + log.topics[1].slice(-40);
-      const to = "0x" + log.topics[2].slice(-40);
-      const amountRaw = BigInt(log.data);
-      const amount = Number(amountRaw) / 1e6;
-      if (expectedTo && to.toLowerCase() !== expectedTo.toLowerCase()) {
-        continue;
-      }
-      if (amount < expectedAmount) {
-        return {
-          verified: false,
-          error: `Insufficient amount: received ${amount} USDC, expected ${expectedAmount} USDC`,
-          amount,
-          from,
-          to,
-          txHash,
-          blockNumber: receipt.blockNumber
-        };
-      }
-      return {
-        verified: true,
-        amount,
-        from,
-        to,
-        txHash,
-        blockNumber: receipt.blockNumber
-      };
-    }
-    return { verified: false, error: "No USDC transfer found" };
-  } catch (e) {
-    return { verified: false, error: e.message || String(e) };
-  }
-}
 
 // src/server/index.ts
-function generateChargeId() {
-  return "ch_" + Math.random().toString(36).substring(2, 15);
-}
+var X402_VERSION = 2;
+var PAYMENT_REQUIRED_HEADER = "x-payment-required";
+var PAYMENT_HEADER = "x-payment";
+var PAYMENT_RESPONSE_HEADER = "x-payment-response";
+var DEFAULT_FACILITATOR_URL = "https://x402.org/facilitator";
 var MoltsPayServer = class {
   manifest;
   skills = /* @__PURE__ */ new Map();
-  charges = /* @__PURE__ */ new Map();
   options;
+  facilitatorUrl;
   constructor(servicesPath, options = {}) {
     const content = (0, import_fs.readFileSync)(servicesPath, "utf-8");
     this.manifest = JSON.parse(content);
     this.options = {
       port: options.port || 3e3,
-      host: options.host || "0.0.0.0",
-      chargeExpirySecs: options.chargeExpirySecs || 300
-      // 5 minutes
+      host: options.host || "0.0.0.0"
     };
+    this.facilitatorUrl = options.facilitatorUrl || DEFAULT_FACILITATOR_URL;
     console.log(`[MoltsPay] Loaded ${this.manifest.services.length} services from ${servicesPath}`);
     console.log(`[MoltsPay] Provider: ${this.manifest.provider.name}`);
-    console.log(`[MoltsPay] Wallet: ${this.manifest.provider.wallet}`);
+    console.log(`[MoltsPay] Receive wallet: ${this.manifest.provider.wallet}`);
+    console.log(`[MoltsPay] Facilitator: ${this.facilitatorUrl}`);
+    console.log(`[MoltsPay] Protocol: x402 (gasless for both client AND server)`);
   }
   /**
    * Register a skill handler for a service
@@ -190,56 +117,45 @@ var MoltsPayServer = class {
     if (!config) {
       throw new Error(`Service '${serviceId}' not found in manifest`);
     }
-    this.skills.set(serviceId, {
-      id: serviceId,
-      config,
-      handler
-    });
-    console.log(`[MoltsPay] Registered skill: ${serviceId} ($${config.price} ${config.currency})`);
+    this.skills.set(serviceId, { id: serviceId, config, handler });
     return this;
   }
   /**
-   * Start the server
+   * Start HTTP server
    */
   listen(port) {
-    const p = port || this.options.port;
+    const p = port || this.options.port || 3e3;
+    const host = this.options.host || "0.0.0.0";
     const server = (0, import_http.createServer)((req, res) => this.handleRequest(req, res));
-    server.listen(p, this.options.host, () => {
-      console.log(`[MoltsPay] Server listening on http://${this.options.host}:${p}`);
+    server.listen(p, host, () => {
+      console.log(`[MoltsPay] Server listening on http://${host}:${p}`);
       console.log(`[MoltsPay] Endpoints:`);
-      console.log(`  GET  /services  - List available services`);
-      console.log(`  POST /pay       - Create payment & execute service`);
-      console.log(`  POST /verify    - Verify payment & get result`);
-      console.log(`  GET  /status/:id - Check charge status`);
+      console.log(`  GET  /services     - List available services`);
+      console.log(`  POST /execute      - Execute service (x402 payment)`);
     });
   }
+  /**
+   * Handle incoming request
+   */
   async handleRequest(req, res) {
-    const url = new URL(req.url || "/", `http://${req.headers.host}`);
-    const path = url.pathname;
-    const method = req.method || "GET";
     res.setHeader("Access-Control-Allow-Origin", "*");
     res.setHeader("Access-Control-Allow-Methods", "GET, POST, OPTIONS");
-    res.setHeader("Access-Control-Allow-Headers", "Content-Type");
-    if (method === "OPTIONS") {
+    res.setHeader("Access-Control-Allow-Headers", "Content-Type, X-Payment");
+    res.setHeader("Access-Control-Expose-Headers", "X-Payment-Required, X-Payment-Response");
+    if (req.method === "OPTIONS") {
       res.writeHead(204);
       res.end();
       return;
     }
     try {
-      if (method === "GET" && path === "/services") {
+      const url = new URL(req.url || "/", `http://${req.headers.host}`);
+      if (url.pathname === "/services" && req.method === "GET") {
         return this.handleGetServices(res);
       }
-      if (method === "POST" && path === "/pay") {
-        const body = await this.readBody(req);
-        return this.handlePay(body, res);
-      }
-      if (method === "POST" && path === "/verify") {
+      if (url.pathname === "/execute" && req.method === "POST") {
         const body = await this.readBody(req);
-        return this.handleVerify(body, res);
-      }
-      if (method === "GET" && path.startsWith("/status/")) {
-        const chargeId = path.replace("/status/", "");
-        return this.handleStatus(chargeId, res);
+        const paymentHeader = req.headers[PAYMENT_HEADER];
+        return await this.handleExecute(body, paymentHeader, res);
       }
       this.sendJson(res, 404, { error: "Not found" });
     } catch (err) {
@@ -251,6 +167,7 @@ var MoltsPayServer = class {
    * GET /services - List available services
    */
   handleGetServices(res) {
+    const chain = getChain(this.manifest.provider.chain);
     const services = this.manifest.services.map((s) => ({
       id: s.id,
       name: s.name,
@@ -263,14 +180,21 @@ var MoltsPayServer = class {
     }));
     this.sendJson(res, 200, {
       provider: this.manifest.provider,
-      services
+      services,
+      x402: {
+        version: X402_VERSION,
+        network: `eip155:${chain.chainId}`,
+        schemes: ["exact"],
+        facilitator: this.facilitatorUrl
+      }
     });
   }
   /**
-   * POST /pay - Create payment request
+   * POST /execute - Execute service with x402 payment
    * Body: { service: string, params: object }
+   * Header: X-Payment (optional - if missing, returns 402)
    */
-  handlePay(body, res) {
+  async handleExecute(body, paymentHeader, res) {
     const { service, params } = body;
     if (!service) {
       return this.sendJson(res, 400, { error: "Missing service" });
@@ -284,113 +208,162 @@ var MoltsPayServer = class {
         return this.sendJson(res, 400, { error: `Missing required param: ${key}` });
       }
     }
-    const chargeId = generateChargeId();
-    const now = Date.now();
-    const charge = {
-      id: chargeId,
-      service,
-      params: params || {},
-      amount: skill.config.price,
-      currency: skill.config.currency,
-      status: "pending",
-      createdAt: now,
-      expiresAt: now + this.options.chargeExpirySecs * 1e3
-    };
-    this.charges.set(chargeId, charge);
-    const paymentRequest = {
-      chargeId,
-      service,
-      amount: charge.amount,
-      currency: charge.currency,
-      wallet: this.manifest.provider.wallet,
-      chain: this.manifest.provider.chain,
-      expiresAt: charge.expiresAt
-    };
-    this.sendJson(res, 402, {
-      message: "Payment required",
-      payment: paymentRequest
+    if (!paymentHeader) {
+      return this.sendPaymentRequired(skill.config, res);
+    }
+    let payment;
+    try {
+      const decoded = Buffer.from(paymentHeader, "base64").toString("utf-8");
+      payment = JSON.parse(decoded);
+    } catch {
+      return this.sendJson(res, 400, { error: "Invalid X-Payment header" });
+    }
+    const validation = this.validatePayment(payment, skill.config);
+    if (!validation.valid) {
+      return this.sendJson(res, 402, { error: validation.error });
+    }
+    console.log(`[MoltsPay] Verifying payment with facilitator...`);
+    const verifyResult = await this.verifyWithFacilitator(payment, skill.config);
+    if (!verifyResult.valid) {
+      return this.sendJson(res, 402, { error: `Payment verification failed: ${verifyResult.error}` });
+    }
+    console.log(`[MoltsPay] Executing skill: ${service}`);
+    let result;
+    try {
+      result = await skill.handler(params || {});
+    } catch (err) {
+      console.error("[MoltsPay] Skill execution failed:", err.message);
+      return this.sendJson(res, 500, {
+        error: "Service execution failed",
+        message: err.message
+      });
+    }
+    console.log(`[MoltsPay] Skill succeeded, settling payment...`);
+    let settlement = null;
+    try {
+      settlement = await this.settleWithFacilitator(payment, skill.config);
+      console.log(`[MoltsPay] Payment settled: ${settlement.transaction || "pending"}`);
+    } catch (err) {
+      console.error("[MoltsPay] Settlement failed:", err.message);
+    }
+    const responseHeaders = {};
+    if (settlement) {
+      const responsePayload = {
+        success: true,
+        transaction: settlement.transaction,
+        network: payment.network
+      };
+      responseHeaders[PAYMENT_RESPONSE_HEADER] = Buffer.from(
+        JSON.stringify(responsePayload)
+      ).toString("base64");
+    }
+    this.sendJson(res, 200, {
+      success: true,
+      result,
+      payment: settlement ? { transaction: settlement.transaction, status: "settled" } : { status: "pending" }
+    }, responseHeaders);
+  }
+  /**
+   * Return 402 with x402 payment requirements
+   */
+  sendPaymentRequired(config, res) {
+    const chain = getChain(this.manifest.provider.chain);
+    const amountInUnits = Math.floor(config.price * 1e6).toString();
+    const requirements = [{
+      scheme: "exact",
+      network: `eip155:${chain.chainId}`,
+      maxAmountRequired: amountInUnits,
+      resource: this.manifest.provider.wallet,
+      description: `${config.name} - $${config.price} ${config.currency}`,
+      // Include facilitator info for client
+      extra: JSON.stringify({ facilitator: this.facilitatorUrl })
+    }];
+    const encoded = Buffer.from(JSON.stringify(requirements)).toString("base64");
+    res.writeHead(402, {
+      "Content-Type": "application/json",
+      [PAYMENT_REQUIRED_HEADER]: encoded
     });
+    res.end(JSON.stringify({
+      error: "Payment required",
+      message: `Service requires $${config.price} ${config.currency}`,
+      x402: requirements[0]
+    }, null, 2));
   }
   /**
-   * POST /verify - Verify payment and execute skill
-   * Body: { chargeId: string, txHash: string }
+   * Basic payment validation (before calling facilitator)
    */
-  async handleVerify(body, res) {
-    const { chargeId, txHash } = body;
-    if (!chargeId || !txHash) {
-      return this.sendJson(res, 400, { error: "Missing chargeId or txHash" });
+  validatePayment(payment, config) {
+    if (payment.x402Version !== X402_VERSION) {
+      return { valid: false, error: `Unsupported x402 version: ${payment.x402Version}` };
     }
-    const charge = this.charges.get(chargeId);
-    if (!charge) {
-      return this.sendJson(res, 404, { error: "Charge not found" });
+    if (payment.scheme !== "exact") {
+      return { valid: false, error: `Unsupported scheme: ${payment.scheme}` };
     }
-    if (Date.now() > charge.expiresAt) {
-      charge.status = "expired";
-      return this.sendJson(res, 400, { error: "Charge expired" });
-    }
-    if (charge.status === "completed") {
-      return this.sendJson(res, 200, {
-        status: "completed",
-        result: charge.result
-      });
+    const chain = getChain(this.manifest.provider.chain);
+    const expectedNetwork = `eip155:${chain.chainId}`;
+    if (payment.network !== expectedNetwork) {
+      return { valid: false, error: `Network mismatch: expected ${expectedNetwork}` };
     }
+    return { valid: true };
+  }
+  /**
+   * Verify payment with facilitator
+   */
+  async verifyWithFacilitator(payment, config) {
     try {
-      const verification = await verifyPayment({
-        txHash,
-        expectedTo: this.manifest.provider.wallet,
-        expectedAmount: charge.amount,
-        chain: this.manifest.provider.chain
+      const chain = getChain(this.manifest.provider.chain);
+      const amountInUnits = Math.floor(config.price * 1e6).toString();
+      const requirements = {
+        scheme: "exact",
+        network: `eip155:${chain.chainId}`,
+        maxAmountRequired: amountInUnits,
+        resource: this.manifest.provider.wallet
+      };
+      const response = await fetch(`${this.facilitatorUrl}/verify`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+          paymentPayload: payment,
+          paymentRequirements: requirements
+        })
       });
-      if (!verification.verified) {
-        charge.status = "failed";
-        return this.sendJson(res, 400, {
-          error: "Payment verification failed",
-          reason: verification.error
-        });
+      const result = await response.json();
+      if (!response.ok || !result.isValid) {
+        return { valid: false, error: result.invalidReason || "Verification failed" };
       }
-      charge.status = "paid";
-      charge.txHash = txHash;
-      charge.paidAt = Date.now();
-      const skill = this.skills.get(charge.service);
-      console.log(`[MoltsPay] Executing skill: ${charge.service}`);
-      const result = await skill.handler(charge.params);
-      charge.status = "completed";
-      charge.result = result;
-      charge.completedAt = Date.now();
-      this.sendJson(res, 200, {
-        status: "completed",
-        chargeId,
-        txHash,
-        result
-      });
+      return { valid: true };
     } catch (err) {
-      console.error("[MoltsPay] Skill execution error:", err);
-      charge.status = "failed";
-      this.sendJson(res, 500, {
-        error: "Skill execution failed",
-        message: err.message
-      });
+      return { valid: false, error: `Facilitator error: ${err.message}` };
     }
   }
   /**
-   * GET /status/:chargeId - Check charge status
+   * Settle payment with facilitator (execute on-chain transfer)
    */
-  handleStatus(chargeId, res) {
-    const charge = this.charges.get(chargeId);
-    if (!charge) {
-      return this.sendJson(res, 404, { error: "Charge not found" });
-    }
-    this.sendJson(res, 200, {
-      chargeId: charge.id,
-      service: charge.service,
-      amount: charge.amount,
-      currency: charge.currency,
-      status: charge.status,
-      txHash: charge.txHash,
-      result: charge.status === "completed" ? charge.result : void 0,
-      createdAt: charge.createdAt,
-      expiresAt: charge.expiresAt
+  async settleWithFacilitator(payment, config) {
+    const chain = getChain(this.manifest.provider.chain);
+    const amountInUnits = Math.floor(config.price * 1e6).toString();
+    const requirements = {
+      scheme: "exact",
+      network: `eip155:${chain.chainId}`,
+      maxAmountRequired: amountInUnits,
+      resource: this.manifest.provider.wallet
+    };
+    const response = await fetch(`${this.facilitatorUrl}/settle`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        paymentPayload: payment,
+        paymentRequirements: requirements
+      })
     });
+    const result = await response.json();
+    if (!response.ok) {
+      throw new Error(result.error || "Settlement failed");
+    }
+    return {
+      transaction: result.transaction,
+      status: result.status || "settled"
+    };
   }
   async readBody(req) {
     return new Promise((resolve, reject) => {
@@ -406,8 +379,12 @@ var MoltsPayServer = class {
       req.on("error", reject);
     });
   }
-  sendJson(res, status, data) {
-    res.writeHead(status, { "Content-Type": "application/json" });
+  sendJson(res, status, data, extraHeaders) {
+    const headers = { "Content-Type": "application/json" };
+    if (extraHeaders) {
+      Object.assign(headers, extraHeaders);
+    }
+    res.writeHead(status, headers);
     res.end(JSON.stringify(data, null, 2));
   }
 };