moltspay 0.2.1 → 0.2.3

package/dist/index.js

@@ -38,6 +38,7 @@ __export(src_exports, {
   OrderManager: () => OrderManager,
   PaymentAgent: () => PaymentAgent,
   PermitPayment: () => PermitPayment,
+  PermitSigner: () => PermitSigner,
   PermitWallet: () => PermitWallet,
   SecureWallet: () => SecureWallet,
   SellerTemplates: () => SellerTemplates,
@@ -62,6 +63,7 @@ __export(src_exports, {
   listChains: () => listChains,
   loadWallet: () => loadWallet,
   parseStatusMarker: () => parseStatusMarker,
+  signPermit: () => signPermit,
   verifyPayment: () => verifyPayment,
   waitForTransaction: () => waitForTransaction,
   walletExists: () => walletExists
@@ -73,7 +75,7 @@ var import_ethers = require("ethers");
 
 // src/chains/index.ts
 var CHAINS = {
-  // ============ 主网 ============
+  // ============ Mainnet ============
   base: {
     name: "Base",
     chainId: 8453,
@@ -101,7 +103,7 @@ var CHAINS = {
     explorerTx: "https://etherscan.io/tx/",
     avgBlockTime: 12
   },
-  // ============ 测试网 ============
+  // ============ Testnet ============
   base_sepolia: {
     name: "Base Sepolia",
     chainId: 84532,
@@ -172,7 +174,7 @@ var PaymentAgent = class _PaymentAgent {
     );
   }
   /**
-   * 生成支付请求（Invoice）
+   * Generate payment request（Invoice）
    */
   createInvoice(params) {
     const expiresMinutes = params.expiresMinutes || 30;
@@ -199,14 +201,14 @@ var PaymentAgent = class _PaymentAgent {
     return invoice;
   }
   /**
-   * 生成钱包深度链接（支持 MetaMask 等）
+   * Generate wallet deep link（supports MetaMask etc）
    */
   generateDeepLink(amount, memo) {
     const amountWei = Math.floor(amount * 1e6);
     return `https://metamask.app.link/send/${this.chainConfig.usdc}@${this.chainConfig.chainId}/transfer?address=${this.walletAddress}&uint256=${amountWei}`;
   }
   /**
-   * 验证链上支付
+   * Verify on-chain payment
    */
   async verifyPayment(txHash, options = {}) {
     try {
@@ -261,7 +263,7 @@ var PaymentAgent = class _PaymentAgent {
     }
   }
   /**
-   * 扫描最近转账（按金额匹配）
+   * Scan recent transfers (match by amount)
    */
   async scanRecentTransfers(expectedAmount, timeoutMinutes = 30) {
     try {
@@ -299,7 +301,7 @@ var PaymentAgent = class _PaymentAgent {
     }
   }
   /**
-   * 获取钱包余额
+   * Get wallet balance
    */
   async getBalance(address) {
     const addr = address || this.walletAddress;
@@ -315,7 +317,7 @@ var PaymentAgent = class _PaymentAgent {
     };
   }
   /**
-   * 格式化 Invoice 为人类可读消息
+   * Format Invoice as human-readable message
    */
   formatInvoiceMessage(invoice, includeJson = true) {
     let msg = `\u{1F3AC} **Payment Request**
@@ -377,7 +379,7 @@ var Wallet = class {
     );
   }
   /**
-   * 获取钱包余额
+   * Get wallet balance
    */
   async getBalance() {
     const [ethBalance, usdcBalance] = await Promise.all([
@@ -392,7 +394,7 @@ var Wallet = class {
     };
   }
   /**
-   * 发送 USDC 转账
+   * Send USDC transfer
    */
   async transfer(to, amount) {
     try {
@@ -433,14 +435,14 @@ var Wallet = class {
     }
   }
   /**
-   * 获取 ETH 余额
+   * Get ETH balance
    */
   async getEthBalance() {
     const balance = await this.provider.getBalance(this.address);
     return import_ethers2.ethers.formatEther(balance);
   }
   /**
-   * 获取 USDC 余额
+   * Get USDC balance
    */
   async getUsdcBalance() {
     const balance = await this.usdcContract.balanceOf(this.address);
@@ -461,7 +463,7 @@ var AuditLog = class {
     this.loadLastHash();
   }
   /**
-   * 记录审计日志
+   * Record audit log
    */
   async log(params) {
     const now = /* @__PURE__ */ new Date();
@@ -478,7 +480,7 @@ var AuditLog = class {
       requester: params.requester,
       prev_hash: this.lastHash,
       hash: "",
-      // 计算后填充
+      // Filled after calculation
       metadata: params.metadata
     };
     entry.hash = this.calculateHash(entry);
@@ -489,7 +491,7 @@ var AuditLog = class {
     return entry;
   }
   /**
-   * 读取指定日期的日志
+   * Read logs for specified date
    */
   read(date) {
     const filePath = this.getFilePath(date || /* @__PURE__ */ new Date());
@@ -501,7 +503,7 @@ var AuditLog = class {
     return lines.map((line) => JSON.parse(line));
   }
   /**
-   * 验证日志完整性
+   * Verify log integrity
    */
   verify(date) {
     const entries = this.read(date);
@@ -519,7 +521,7 @@ var AuditLog = class {
     return { valid: errors.length === 0, errors };
   }
   /**
-   * 搜索日志
+   * Search logs
    */
   search(filter) {
     const results = [];
@@ -543,14 +545,14 @@ var AuditLog = class {
     return results;
   }
   /**
-   * 获取日志文件路径
+   * Get log file path
    */
   getFilePath(date) {
     const dateStr = date.toISOString().slice(0, 10);
     return path.join(this.basePath, `audit_${dateStr}.jsonl`);
   }
   /**
-   * 计算条目哈希
+   * Calculate entry hash
    */
   calculateHash(entry) {
     const data = {
@@ -567,7 +569,7 @@ var AuditLog = class {
     return crypto.createHash("sha256").update(str).digest("hex").slice(0, 16);
   }
   /**
-   * 加载最后一条日志的哈希
+   * Load last log entry hash
    */
   loadLastHash() {
     const today = /* @__PURE__ */ new Date();
@@ -582,7 +584,7 @@ var AuditLog = class {
     }
   }
   /**
-   * 确保目录存在
+   * Ensure directory exists
    */
   ensureDir() {
     if (!fs.existsSync(this.basePath)) {
@@ -594,9 +596,9 @@ var AuditLog = class {
 // src/wallet/SecureWallet.ts
 var DEFAULT_LIMITS = {
   singleMax: 100,
-  // 单笔最大 $100
+  // Single max $100
   dailyMax: 1e3,
-  // 日最大 $1000
+  // Daily max $1000
   requireWhitelist: true
 };
 var SecureWallet = class {
@@ -617,21 +619,21 @@ var SecureWallet = class {
     this.auditLog = new AuditLog(config.auditPath);
   }
   /**
-   * 获取钱包地址
+   * Get wallet address
    */
   get address() {
     return this.wallet.address;
   }
   /**
-   * 获取余额
+   * Get balance
    */
   async getBalance() {
     return this.wallet.getBalance();
   }
   /**
-   * 安全转账（带限额和白名单检查）
+   * Secure transfer (with limit and whitelist checks)
    * 
-   * 支持两种调用方式:
+   * Supports two calling methods:
    * - transfer({ to, amount, reason?, requester? })
    * - transfer(to, amount)
    */
@@ -731,7 +733,7 @@ var SecureWallet = class {
     return result;
   }
   /**
-   * 审批待处理转账
+   * Approve pending transfer
    */
   async approve(requestId, approver) {
     const pending = this.pendingTransfers.get(requestId);
@@ -772,7 +774,7 @@ var SecureWallet = class {
     return result;
   }
   /**
-   * 拒绝待处理转账
+   * Reject pending transfer
    */
   async reject(requestId, rejecter, reason) {
     const pending = this.pendingTransfers.get(requestId);
@@ -787,7 +789,7 @@ var SecureWallet = class {
     });
   }
   /**
-   * 添加白名单地址
+   * Add to whitelist
    */
   async addToWhitelist(address, addedBy) {
     const addr = address.toLowerCase();
@@ -800,7 +802,7 @@ var SecureWallet = class {
     });
   }
   /**
-   * 移除白名单地址
+   * Remove from whitelist
    */
   async removeFromWhitelist(address, removedBy) {
     const addr = address.toLowerCase();
@@ -813,32 +815,32 @@ var SecureWallet = class {
     });
   }
   /**
-   * 检查地址是否在白名单
+   * Check if address is whitelisted
    */
   isWhitelisted(address) {
     return this.whitelist.has(address.toLowerCase());
   }
   /**
-   * 获取待处理转账列表
+   * Get pending transfers list
    */
   getPendingTransfers() {
     return Array.from(this.pendingTransfers.values()).filter((p) => p.status === "pending");
   }
   /**
-   * 获取当前限额配置
+   * Get current limit config
    */
   getLimits() {
     return { ...this.limits };
   }
   /**
-   * 获取今日已用额度
+   * Get daily used amount
    */
   getDailyUsed() {
     this.updateDailyTotal();
     return this.dailyTotal;
   }
   /**
-   * 更新日限额计数器
+   * Update daily limit counter
    */
   updateDailyTotal() {
     const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
@@ -1213,8 +1215,76 @@ After signing, send { v, r, s, deadline } to the Agent.
 \u26A0\uFE0F Note: This authorization only allows the Agent to spend up to ${amount} USDC from your wallet. Your private key is never exposed.`;
 }
 
-// src/permit/Permit.ts
+// src/wallet/signPermit.ts
 var import_ethers5 = require("ethers");
+async function signPermit(config, params) {
+  const chain = config.chain || "base";
+  const chainConfig = getChain(chain);
+  const privateKey = config.privateKey || process.env.PAYMENT_AGENT_PRIVATE_KEY;
+  if (!privateKey) {
+    throw new Error("privateKey is required");
+  }
+  const rpcUrl = config.rpcUrl || chainConfig.rpc;
+  const provider = new import_ethers5.ethers.JsonRpcProvider(rpcUrl);
+  const wallet = new import_ethers5.ethers.Wallet(privateKey, provider);
+  const usdcContract = new import_ethers5.ethers.Contract(chainConfig.usdc, ERC20_ABI, provider);
+  const nonce = Number(await usdcContract.nonces(wallet.address));
+  let deadline;
+  if (!params.deadline) {
+    deadline = Math.floor(Date.now() / 1e3) + 30 * 60;
+  } else if (params.deadline < 1e6) {
+    deadline = Math.floor(Date.now() / 1e3) + params.deadline * 60;
+  } else {
+    deadline = params.deadline;
+  }
+  const value = BigInt(Math.floor(params.amount * 1e6)).toString();
+  const domain = {
+    name: "USD Coin",
+    version: "2",
+    chainId: chainConfig.chainId,
+    verifyingContract: chainConfig.usdc
+  };
+  const types = {
+    Permit: [
+      { name: "owner", type: "address" },
+      { name: "spender", type: "address" },
+      { name: "value", type: "uint256" },
+      { name: "nonce", type: "uint256" },
+      { name: "deadline", type: "uint256" }
+    ]
+  };
+  const message = {
+    owner: wallet.address,
+    spender: params.spender,
+    value,
+    nonce,
+    deadline
+  };
+  const signature = await wallet.signTypedData(domain, types, message);
+  const sig = import_ethers5.ethers.Signature.from(signature);
+  return {
+    owner: wallet.address,
+    spender: params.spender,
+    value,
+    deadline,
+    nonce,
+    v: sig.v,
+    r: sig.r,
+    s: sig.s
+  };
+}
+var PermitSigner = class {
+  config;
+  constructor(config) {
+    this.config = config;
+  }
+  async sign(params) {
+    return signPermit(this.config, params);
+  }
+};
+
+// src/permit/Permit.ts
+var import_ethers6 = require("ethers");
 var PermitPayment = class {
   chain;
   chainConfig;
@@ -1227,26 +1297,26 @@ var PermitPayment = class {
     this.chainConfig = getChain(this.chain);
     this.spenderAddress = config.spenderAddress || process.env.PAYMENT_AGENT_WALLET || "";
     const rpcUrl = config.rpcUrl || this.chainConfig.rpc;
-    this.provider = new import_ethers5.ethers.JsonRpcProvider(rpcUrl);
+    this.provider = new import_ethers6.ethers.JsonRpcProvider(rpcUrl);
     const privateKey = config.privateKey || process.env.PAYMENT_AGENT_PRIVATE_KEY;
     if (privateKey) {
-      this.wallet = new import_ethers5.ethers.Wallet(privateKey, this.provider);
+      this.wallet = new import_ethers6.ethers.Wallet(privateKey, this.provider);
       this.spenderAddress = this.wallet.address;
     }
-    this.usdcContract = new import_ethers5.ethers.Contract(
+    this.usdcContract = new import_ethers6.ethers.Contract(
       this.chainConfig.usdc,
       ERC20_ABI,
       this.wallet || this.provider
     );
   }
   /**
-   * 获取用户当前 nonce
+   * Get user current nonce
    */
   async getNonce(owner) {
     return Number(await this.usdcContract.nonces(owner));
   }
   /**
-   * 生成 EIP-712 签名请求（发给前端/用户钱包）
+   * Generate EIP-712 signing request (for frontend/user wallet)
    */
   async createPermitRequest(owner, amount, orderId, deadlineMinutes = 30) {
     const nonce = await this.getNonce(owner);
@@ -1294,11 +1364,11 @@ var PermitPayment = class {
     };
   }
   /**
-   * 执行 permit + transferFrom
+   * Execute permit + transferFrom
    * 
-   * @param owner 用户地址
-   * @param amount 金额
-   * @param signature 用户签名 {v, r, s, deadline}
+   * @param owner User address
+   * @param amount Amount
+   * @param signature User signature {v, r, s, deadline}
    */
   async executePermitAndTransfer(owner, amount, signature) {
     if (!this.wallet) {
@@ -1330,7 +1400,7 @@ var PermitPayment = class {
     }
   }
   /**
-   * 仅执行 permit（不 transfer）
+   * Execute permit only (no transfer)
    */
   async executePermit(owner, amount, signature) {
     if (!this.wallet) {
@@ -1360,22 +1430,22 @@ var PermitPayment = class {
     }
   }
   /**
-   * 格式化 Permit 请求为用户消息
+   * Format Permit request as user message
    */
   formatPermitMessage(request) {
     const { typed_data } = request;
     const { message } = typed_data;
-    return `\u{1F510} **\u7B7E\u540D\u6388\u6743\u8BF7\u6C42**
+    return `\u{1F510} **Signature Authorization Request**
 
-\u6388\u6743 \`${(Number(message.value) / 1e6).toFixed(2)} USDC\` \u7ED9\u670D\u52A1\u65B9
+Authorize \`${(Number(message.value) / 1e6).toFixed(2)} USDC\` to service provider
 
-**\u7B7E\u540D\u4FE1\u606F\uFF1A**
+**Signature Details:**
 - Owner: \`${message.owner}\`
 - Spender: \`${message.spender}\`
 - Amount: ${(Number(message.value) / 1e6).toFixed(2)} USDC
 - Deadline: ${new Date(message.deadline * 1e3).toISOString()}
 
-\u8BF7\u5728\u94B1\u5305\u4E2D\u7B7E\u540D\u6B64\u8BF7\u6C42\uFF08\u4E0D\u6D88\u8017 Gas\uFF09\u3002
+Please sign this request in your wallet (no gas required).
 
 \`\`\`json
 ${JSON.stringify(typed_data, null, 2)}
@@ -1420,13 +1490,13 @@ var OrderManager = class {
     this.defaultChain = options.defaultChain || "base";
   }
   /**
-   * 生成订单ID
+   * Generate order ID
    */
   generateOrderId() {
     return "vo_" + (0, import_crypto2.randomBytes)(4).toString("hex");
   }
   /**
-   * 创建订单
+   * Create order
    */
   async createOrder(params) {
     const order = {
@@ -1443,13 +1513,13 @@ var OrderManager = class {
     return order;
   }
   /**
-   * 获取订单
+   * Get order
    */
   async getOrder(orderId) {
     return this.store.get(orderId);
   }
   /**
-   * 更新订单
+   * Update order
    */
   async updateOrder(orderId, updates) {
     const order = await this.store.get(orderId);
@@ -1459,7 +1529,7 @@ var OrderManager = class {
     return updated;
   }
   /**
-   * 查找用户的待支付订单
+   * Find user pending orders
    */
   async findPendingOrder(userId) {
     const orders = await this.store.findByUser(userId, "pending");
@@ -1473,7 +1543,7 @@ var OrderManager = class {
     return null;
   }
   /**
-   * 标记订单为已支付
+   * Mark order as paid
    */
   async markAsPaid(orderId, txHash, payerAddress) {
     return this.updateOrder(orderId, {
@@ -1484,13 +1554,13 @@ var OrderManager = class {
     });
   }
   /**
-   * 标记订单为生成中
+   * Mark order as generating
    */
   async markAsGenerating(orderId) {
     return this.updateOrder(orderId, { status: "generating" });
   }
   /**
-   * 标记订单为完成
+   * Mark order as completed
    */
   async markAsCompleted(orderId, videoPath) {
     return this.updateOrder(orderId, {
@@ -1499,7 +1569,7 @@ var OrderManager = class {
     });
   }
   /**
-   * 标记订单为失败
+   * Mark order as failed
    */
   async markAsFailed(orderId, error) {
     return this.updateOrder(orderId, {
@@ -1508,7 +1578,7 @@ var OrderManager = class {
     });
   }
   /**
-   * 取消订单
+   * Cancel order
    */
   async cancelOrder(orderId) {
     return this.updateOrder(orderId, { status: "cancelled" });
@@ -1516,8 +1586,8 @@ var OrderManager = class {
 };
 
 // src/verify/index.ts
-var import_ethers6 = require("ethers");
-var TRANSFER_EVENT_TOPIC = import_ethers6.ethers.id("Transfer(address,address,uint256)");
+var import_ethers7 = require("ethers");
+var TRANSFER_EVENT_TOPIC = import_ethers7.ethers.id("Transfer(address,address,uint256)");
 async function verifyPayment(params) {
   const { txHash, expectedAmount, expectedTo } = params;
   let chain;
@@ -1528,23 +1598,23 @@ async function verifyPayment(params) {
       chain = getChain(params.chain || "base");
     }
     if (!chain) {
-      return { verified: false, error: `\u4E0D\u652F\u6301\u7684\u94FE: ${params.chain}` };
+      return { verified: false, error: `Unsupported chain: ${params.chain}` };
     }
   } catch (e) {
-    return { verified: false, error: `\u4E0D\u652F\u6301\u7684\u94FE: ${params.chain}` };
+    return { verified: false, error: `Unsupported chain: ${params.chain}` };
   }
   try {
-    const provider = new import_ethers6.ethers.JsonRpcProvider(chain.rpc);
+    const provider = new import_ethers7.ethers.JsonRpcProvider(chain.rpc);
     const receipt = await provider.getTransactionReceipt(txHash);
     if (!receipt) {
-      return { verified: false, error: "\u4EA4\u6613\u672A\u627E\u5230\u6216\u672A\u786E\u8BA4" };
+      return { verified: false, error: "Transaction not found or not confirmed" };
     }
     if (receipt.status !== 1) {
-      return { verified: false, error: "\u4EA4\u6613\u5931\u8D25" };
+      return { verified: false, error: "Transaction failed" };
     }
     const usdcAddress = chain.usdc?.toLowerCase();
     if (!usdcAddress) {
-      return { verified: false, error: `\u94FE ${chain.name} \u672A\u914D\u7F6EUSDC\u5730\u5740` };
+      return { verified: false, error: `Chain ${chain.name} USDC address not configured` };
     }
     for (const log of receipt.logs) {
       if (log.address.toLowerCase() !== usdcAddress) {
@@ -1563,7 +1633,7 @@ async function verifyPayment(params) {
       if (amount < expectedAmount) {
         return {
           verified: false,
-          error: `\u91D1\u989D\u4E0D\u8DB3: \u6536\u5230 ${amount} USDC, \u9700\u8981 ${expectedAmount} USDC`,
+          error: `Insufficient amount: received ${amount} USDC, expected ${expectedAmount} USDC`,
           amount,
           from,
           to,
@@ -1580,7 +1650,7 @@ async function verifyPayment(params) {
         blockNumber: receipt.blockNumber
       };
     }
-    return { verified: false, error: "\u672A\u627E\u5230USDC\u8F6C\u8D26\u8BB0\u5F55" };
+    return { verified: false, error: "No USDC transfer found" };
   } catch (e) {
     return { verified: false, error: e.message || String(e) };
   }
@@ -1594,7 +1664,7 @@ async function getTransactionStatus(txHash, chain = "base") {
     return { status: "not_found" };
   }
   try {
-    const provider = new import_ethers6.ethers.JsonRpcProvider(chainConfig.rpc);
+    const provider = new import_ethers7.ethers.JsonRpcProvider(chainConfig.rpc);
     const receipt = await provider.getTransactionReceipt(txHash);
     if (!receipt) {
       const tx = await provider.getTransaction(txHash);
@@ -1626,19 +1696,19 @@ async function waitForTransaction(txHash, chain = "base", confirmations = 1, tim
   try {
     chainConfig = typeof chain === "number" ? getChainById(chain) : getChain(chain);
     if (!chainConfig) {
-      return { verified: false, confirmed: false, error: `\u4E0D\u652F\u6301\u7684\u94FE: ${chain}` };
+      return { verified: false, confirmed: false, error: `Unsupported chain: ${chain}` };
     }
   } catch (e) {
-    return { verified: false, confirmed: false, error: `\u4E0D\u652F\u6301\u7684\u94FE: ${chain}` };
+    return { verified: false, confirmed: false, error: `Unsupported chain: ${chain}` };
   }
-  const provider = new import_ethers6.ethers.JsonRpcProvider(chainConfig.rpc);
+  const provider = new import_ethers7.ethers.JsonRpcProvider(chainConfig.rpc);
   try {
     const receipt = await provider.waitForTransaction(txHash, confirmations, timeoutMs);
     if (!receipt) {
-      return { verified: false, confirmed: false, error: "\u7B49\u5F85\u8D85\u65F6" };
+      return { verified: false, confirmed: false, error: "Timeout waiting" };
     }
     if (receipt.status !== 1) {
-      return { verified: false, confirmed: true, error: "\u4EA4\u6613\u5931\u8D25" };
+      return { verified: false, confirmed: true, error: "Transaction failed" };
     }
     return {
       verified: true,
@@ -2054,6 +2124,58 @@ ${receipt.delivery?.url ? `- Delivery: ${receipt.delivery.url}` : ""}
    */
   end() {
     return `Thank you for your purchase. This transaction is complete. Feel free to reach out if you need modifications or new services.`;
+  },
+  // ============ Permit Payment (Seller receives Permit from Client) ============
+  /**
+   * Offer Permit payment option
+   */
+  offerPermitPayment(params) {
+    const { service, price, sellerAddress, chain = "base", invoiceId } = params;
+    const chainConfig = getChain(chain);
+    return `Quote:
+- Service: ${service}
+- Price: ${price} USDC
+- Chain: ${chainConfig.name}
+- Invoice: ${invoiceId}
+
+You can pay by signing a Permit authorizing my wallet to collect payment:
+- Spender (me): \`${sellerAddress}\`
+- Amount: ${price} USDC
+
+Sign the Permit and send me the data. I'll then execute the collection.
+[status:awaiting_permit invoice=${invoiceId}]`;
+  },
+  /**
+   * Confirm Permit received, executing payment
+   */
+  executingPermit(invoiceId) {
+    return `Permit received for invoice ${invoiceId}. Executing payment collection now...`;
+  },
+  /**
+   * Permit payment successful
+   */
+  permitPaymentReceived(params) {
+    const { amount, txHash, invoiceId } = params;
+    return `Payment collected successfully!
+- Invoice: ${invoiceId}
+- Amount: ${amount} USDC
+- Tx Hash: \`${txHash}\`
+
+Starting to process your request now.
+[status:payment_confirmed tx=${txHash}]`;
+  },
+  /**
+   * Permit payment failed
+   */
+  permitPaymentFailed(error, invoiceId) {
+    return `Failed to collect payment for invoice ${invoiceId}: ${error}
+
+Please check:
+- Permit signature is valid
+- Permit hasn't expired
+- Your wallet has sufficient USDC balance
+
+You can re-sign and send a new Permit.`;
   }
 };
 var BuyerTemplates = {
@@ -2146,11 +2268,46 @@ ${requirements}`;
     const { amount, agentAddress, deadlineHours = 24, reason } = params;
     return `Boss, I need a USDC spending allowance (Permit) for ${reason || "purchasing services"}.
 Please authorize ${amount} USDC to my wallet ${agentAddress}, valid for ${deadlineHours} hours.`;
+  },
+  // ============ Permit Payment (Client signs Permit to Seller) ============
+  /**
+   * Confirm willing to pay via Permit
+   */
+  confirmPermitPayment() {
+    return `Confirmed. I'll sign a Permit authorizing you to collect the payment.`;
+  },
+  /**
+   * Send signed Permit to Seller
+   */
+  sendPermit(params) {
+    const { permit, invoiceId, amount } = params;
+    return `Payment authorized via Permit.
+
+Invoice: ${invoiceId}
+Amount: ${amount} USDC
+
+Permit Data:
+\`\`\`json
+${JSON.stringify(permit, null, 2)}
+\`\`\`
+
+[status:permit_sent invoice=${invoiceId} amount=${amount}]`;
+  },
+  /**
+   * Simplified Permit message (compact JSON for agent parsing)
+   */
+  sendPermitCompact(params) {
+    const { permit, invoiceId } = params;
+    return `Permit signed for invoice ${invoiceId}:
+${JSON.stringify(permit)}
+[status:permit_sent invoice=${invoiceId}]`;
   }
 };
 var StatusMarkers = {
   walletReady: "[status:wallet_ready]",
   permitReady: (amount) => `[status:permit_ready USDC=${amount}]`,
+  permitSent: (invoiceId, amount) => `[status:permit_sent invoice=${invoiceId} amount=${amount}]`,
+  awaitingPermit: (invoiceId) => `[status:awaiting_permit invoice=${invoiceId}]`,
   paymentSent: (txHash, amount) => `[status:payment_sent tx=${txHash} amount=${amount} USDC]`,
   paymentConfirmed: (txHash) => `[status:payment_confirmed tx=${txHash}]`,
   delivered: (url, hash) => `[status:delivered url=${url}${hash ? ` hash=${hash}` : ""}]`,
@@ -2170,6 +2327,24 @@ function parseStatusMarker(message) {
       data: { amount: amountMatch?.[1] || "0" }
     };
   }
+  if (content.startsWith("permit_sent")) {
+    const invoiceMatch = content.match(/invoice=(\S+)/);
+    const amountMatch = content.match(/amount=(\d+(?:\.\d+)?)/);
+    return {
+      type: "permit_sent",
+      data: {
+        invoiceId: invoiceMatch?.[1] || "",
+        amount: amountMatch?.[1] || "0"
+      }
+    };
+  }
+  if (content.startsWith("awaiting_permit")) {
+    const invoiceMatch = content.match(/invoice=(\S+)/);
+    return {
+      type: "awaiting_permit",
+      data: { invoiceId: invoiceMatch?.[1] || "" }
+    };
+  }
   if (content.startsWith("payment_sent")) {
     const txMatch = content.match(/tx=(\S+)/);
     const amountMatch = content.match(/amount=(\d+(?:\.\d+)?)/);
@@ -2222,6 +2397,7 @@ function parseStatusMarker(message) {
   OrderManager,
   PaymentAgent,
   PermitPayment,
+  PermitSigner,
   PermitWallet,
   SecureWallet,
   SellerTemplates,
@@ -2246,6 +2422,7 @@ function parseStatusMarker(message) {
   listChains,
   loadWallet,
   parseStatusMarker,
+  signPermit,
   verifyPayment,
   waitForTransaction,
   walletExists