moltspay 0.1.3 → 0.2.0

package/dist/index.js

@@ -31,25 +31,40 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var src_exports = {};
 __export(src_exports, {
   AuditLog: () => AuditLog,
+  BuyerTemplates: () => BuyerTemplates,
   CHAINS: () => CHAINS,
   ERC20_ABI: () => ERC20_ABI,
   MemoryOrderStore: () => MemoryOrderStore,
   OrderManager: () => OrderManager,
   PaymentAgent: () => PaymentAgent,
   PermitPayment: () => PermitPayment,
+  PermitWallet: () => PermitWallet,
   SecureWallet: () => SecureWallet,
+  SellerTemplates: () => SellerTemplates,
+  StatusMarkers: () => StatusMarkers,
   Wallet: () => Wallet,
+  createWallet: () => createWallet,
   extractTransactionHash: () => extractTransactionHash,
+  formatPermitRequest: () => formatPermitRequest,
+  formatReceiptJson: () => formatReceiptJson,
+  formatReceiptMessage: () => formatReceiptMessage,
+  formatReceiptText: () => formatReceiptText,
   generatePaymentGuide: () => generatePaymentGuide,
   generatePaymentReminder: () => generatePaymentReminder,
+  generateReceipt: () => generateReceipt,
+  generateReceiptFromInvoice: () => generateReceiptFromInvoice,
   generateWalletGuide: () => generateWalletGuide,
   getChain: () => getChain,
   getChainById: () => getChainById,
   getTransactionStatus: () => getTransactionStatus,
+  getWalletAddress: () => getWalletAddress,
   hasTransactionHash: () => hasTransactionHash,
   listChains: () => listChains,
+  loadWallet: () => loadWallet,
+  parseStatusMarker: () => parseStatusMarker,
   verifyPayment: () => verifyPayment,
-  waitForTransaction: () => waitForTransaction
+  waitForTransaction: () => waitForTransaction,
+  walletExists: () => walletExists
 });
 module.exports = __toCommonJS(src_exports);
 
@@ -834,8 +849,372 @@ var SecureWallet = class {
   }
 };
 
-// src/permit/Permit.ts
+// src/wallet/createWallet.ts
 var import_ethers3 = require("ethers");
+var import_fs = require("fs");
+var import_path = require("path");
+var import_crypto = require("crypto");
+var DEFAULT_STORAGE_DIR = (0, import_path.join)(process.env.HOME || "~", ".moltspay");
+var DEFAULT_STORAGE_FILE = "wallet.json";
+function encryptPrivateKey(privateKey, password) {
+  const salt = (0, import_crypto.randomBytes)(16);
+  const key = (0, import_crypto.scryptSync)(password, salt, 32);
+  const iv = (0, import_crypto.randomBytes)(16);
+  const cipher = (0, import_crypto.createCipheriv)("aes-256-cbc", key, iv);
+  let encrypted = cipher.update(privateKey, "utf8", "hex");
+  encrypted += cipher.final("hex");
+  return {
+    encrypted,
+    iv: iv.toString("hex"),
+    salt: salt.toString("hex")
+  };
+}
+function decryptPrivateKey(encrypted, password, iv, salt) {
+  const key = (0, import_crypto.scryptSync)(password, Buffer.from(salt, "hex"), 32);
+  const decipher = (0, import_crypto.createDecipheriv)("aes-256-cbc", key, Buffer.from(iv, "hex"));
+  let decrypted = decipher.update(encrypted, "hex", "utf8");
+  decrypted += decipher.final("utf8");
+  return decrypted;
+}
+function createWallet(options = {}) {
+  const storagePath = options.storagePath || (0, import_path.join)(DEFAULT_STORAGE_DIR, DEFAULT_STORAGE_FILE);
+  if ((0, import_fs.existsSync)(storagePath) && !options.overwrite) {
+    try {
+      const existing = JSON.parse((0, import_fs.readFileSync)(storagePath, "utf8"));
+      return {
+        success: true,
+        address: existing.address,
+        storagePath,
+        isNew: false
+      };
+    } catch (error) {
+      return {
+        success: false,
+        error: `Failed to load existing wallet: ${error.message}`
+      };
+    }
+  }
+  try {
+    const wallet = import_ethers3.ethers.Wallet.createRandom();
+    const walletData = {
+      address: wallet.address,
+      label: options.label,
+      createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+      encrypted: !!options.password,
+      privateKey: ""
+    };
+    if (options.password) {
+      const { encrypted, iv, salt } = encryptPrivateKey(wallet.privateKey, options.password);
+      walletData.privateKey = encrypted;
+      walletData.iv = iv;
+      walletData.salt = salt;
+    } else {
+      walletData.privateKey = wallet.privateKey;
+    }
+    const dir = (0, import_path.dirname)(storagePath);
+    if (!(0, import_fs.existsSync)(dir)) {
+      (0, import_fs.mkdirSync)(dir, { recursive: true });
+    }
+    (0, import_fs.writeFileSync)(storagePath, JSON.stringify(walletData, null, 2), { mode: 384 });
+    return {
+      success: true,
+      address: wallet.address,
+      storagePath,
+      isNew: true
+    };
+  } catch (error) {
+    return {
+      success: false,
+      error: error.message
+    };
+  }
+}
+function loadWallet(options = {}) {
+  const storagePath = options.storagePath || (0, import_path.join)(DEFAULT_STORAGE_DIR, DEFAULT_STORAGE_FILE);
+  if (!(0, import_fs.existsSync)(storagePath)) {
+    return { success: false, error: "Wallet not found. Run createWallet() first." };
+  }
+  try {
+    const data = JSON.parse((0, import_fs.readFileSync)(storagePath, "utf8"));
+    if (data.encrypted) {
+      if (!options.password) {
+        return { success: false, error: "Wallet is encrypted. Password required." };
+      }
+      const privateKey = decryptPrivateKey(data.privateKey, options.password, data.iv, data.salt);
+      return { success: true, address: data.address, privateKey };
+    } else {
+      return { success: true, address: data.address, privateKey: data.privateKey };
+    }
+  } catch (error) {
+    return { success: false, error: error.message };
+  }
+}
+function getWalletAddress(storagePath) {
+  const path2 = storagePath || (0, import_path.join)(DEFAULT_STORAGE_DIR, DEFAULT_STORAGE_FILE);
+  if (!(0, import_fs.existsSync)(path2)) {
+    return null;
+  }
+  try {
+    const data = JSON.parse((0, import_fs.readFileSync)(path2, "utf8"));
+    return data.address;
+  } catch {
+    return null;
+  }
+}
+function walletExists(storagePath) {
+  const path2 = storagePath || (0, import_path.join)(DEFAULT_STORAGE_DIR, DEFAULT_STORAGE_FILE);
+  return (0, import_fs.existsSync)(path2);
+}
+
+// src/wallet/PermitWallet.ts
+var import_ethers4 = require("ethers");
+var PERMIT_ABI = [
+  ...ERC20_ABI,
+  "function permit(address owner, address spender, uint256 value, uint256 deadline, uint8 v, bytes32 r, bytes32 s)",
+  "function transferFrom(address from, address to, uint256 amount) returns (bool)",
+  "function allowance(address owner, address spender) view returns (uint256)"
+];
+var PermitWallet = class {
+  chain;
+  chainConfig;
+  address;
+  wallet;
+  provider;
+  usdcContract;
+  constructor(config = {}) {
+    this.chain = config.chain || "base_sepolia";
+    this.chainConfig = getChain(this.chain);
+    let privateKey = config.privateKey || process.env.PAYMENT_AGENT_PRIVATE_KEY;
+    if (!privateKey && config.walletPath) {
+      const loaded = loadWallet({
+        storagePath: config.walletPath,
+        password: config.walletPassword
+      });
+      if (!loaded.success || !loaded.privateKey) {
+        throw new Error(loaded.error || "Failed to load wallet");
+      }
+      privateKey = loaded.privateKey;
+    }
+    if (!privateKey) {
+      throw new Error("privateKey is required. Set via config, env var, or walletPath.");
+    }
+    const rpcUrl = config.rpcUrl || this.chainConfig.rpc;
+    this.provider = new import_ethers4.ethers.JsonRpcProvider(rpcUrl);
+    this.wallet = new import_ethers4.ethers.Wallet(privateKey, this.provider);
+    this.address = this.wallet.address;
+    this.usdcContract = new import_ethers4.ethers.Contract(
+      this.chainConfig.usdc,
+      PERMIT_ABI,
+      this.wallet
+    );
+  }
+  /**
+   * 检查 Permit 是否有效
+   */
+  async checkPermitAllowance(owner) {
+    const allowance = await this.usdcContract.allowance(owner, this.address);
+    return (Number(allowance) / 1e6).toFixed(2);
+  }
+  /**
+   * 使用 Permit 授权进行支付
+   * 
+   * 流程：
+   * 1. 调用 permit() 让合约记录 Boss 的授权
+   * 2. 调用 transferFrom() 从 Boss 钱包转账到收款方
+   * 
+   * @example
+   * ```typescript
+   * const wallet = new PermitWallet({ chain: 'base' });
+   * 
+   * // Boss 签署的 permit 数据
+   * const permit = {
+   *   owner: '0xBOSS...',
+   *   spender: wallet.address,
+   *   value: '10000000', // 10 USDC
+   *   deadline: 1234567890,
+   *   v: 27,
+   *   r: '0x...',
+   *   s: '0x...'
+   * };
+   * 
+   * const result = await wallet.transferWithPermit({
+   *   to: '0xSELLER...',
+   *   amount: 3.99,
+   *   permit
+   * });
+   * ```
+   */
+  async transferWithPermit(params) {
+    const { to, amount, permit } = params;
+    try {
+      const toAddress = import_ethers4.ethers.getAddress(to);
+      const ownerAddress = import_ethers4.ethers.getAddress(permit.owner);
+      if (import_ethers4.ethers.getAddress(permit.spender).toLowerCase() !== this.address.toLowerCase()) {
+        return {
+          success: false,
+          error: `Permit spender (${permit.spender}) doesn't match wallet address (${this.address})`
+        };
+      }
+      const now = Math.floor(Date.now() / 1e3);
+      if (permit.deadline < now) {
+        return {
+          success: false,
+          error: `Permit expired at ${new Date(permit.deadline * 1e3).toISOString()}`
+        };
+      }
+      const amountWei = BigInt(Math.floor(amount * 1e6));
+      const permitValue = BigInt(permit.value);
+      if (amountWei > permitValue) {
+        return {
+          success: false,
+          error: `Permit value (${Number(permitValue) / 1e6} USDC) < transfer amount (${amount} USDC)`
+        };
+      }
+      const currentAllowance = await this.usdcContract.allowance(ownerAddress, this.address);
+      let permitTxHash;
+      if (BigInt(currentAllowance) < amountWei) {
+        console.log("Executing permit...");
+        const permitTx = await this.usdcContract.permit(
+          ownerAddress,
+          this.address,
+          permitValue,
+          permit.deadline,
+          permit.v,
+          permit.r,
+          permit.s
+        );
+        const permitReceipt = await permitTx.wait();
+        if (permitReceipt.status !== 1) {
+          return {
+            success: false,
+            error: "Permit transaction failed",
+            permitTxHash: permitTx.hash
+          };
+        }
+        permitTxHash = permitTx.hash;
+        console.log("Permit executed:", permitTxHash);
+      }
+      console.log("Executing transferFrom...");
+      const transferTx = await this.usdcContract.transferFrom(
+        ownerAddress,
+        toAddress,
+        amountWei
+      );
+      const transferReceipt = await transferTx.wait();
+      if (transferReceipt.status === 1) {
+        return {
+          success: true,
+          tx_hash: transferTx.hash,
+          permitTxHash,
+          transferTxHash: transferTx.hash,
+          from: ownerAddress,
+          to: toAddress,
+          amount,
+          gas_used: Number(transferReceipt.gasUsed),
+          block_number: transferReceipt.blockNumber,
+          explorer_url: `${this.chainConfig.explorerTx}${transferTx.hash}`
+        };
+      } else {
+        return {
+          success: false,
+          error: "TransferFrom transaction failed",
+          tx_hash: transferTx.hash,
+          permitTxHash
+        };
+      }
+    } catch (error) {
+      const message = error.message;
+      if (message.includes("ERC20InsufficientAllowance")) {
+        return {
+          success: false,
+          error: "Insufficient allowance. Permit may have been used or expired."
+        };
+      }
+      if (message.includes("ERC20InsufficientBalance")) {
+        return {
+          success: false,
+          error: "Boss wallet has insufficient USDC balance."
+        };
+      }
+      if (message.includes("InvalidSignature") || message.includes("invalid signature")) {
+        return {
+          success: false,
+          error: "Invalid permit signature. Ask Boss to re-sign."
+        };
+      }
+      return {
+        success: false,
+        error: message
+      };
+    }
+  }
+  /**
+   * 获取 ETH 余额（用于支付 gas）
+   */
+  async getGasBalance() {
+    const balance = await this.provider.getBalance(this.address);
+    return import_ethers4.ethers.formatEther(balance);
+  }
+  /**
+   * 检查是否有足够的 gas
+   */
+  async hasEnoughGas(minEth = 1e-3) {
+    const balance = await this.getGasBalance();
+    return parseFloat(balance) >= minEth;
+  }
+};
+function formatPermitRequest(params) {
+  const { agentAddress, amount, deadlineHours = 24, chain = "base", reason } = params;
+  const chainConfig = getChain(chain);
+  const deadline = Math.floor(Date.now() / 1e3) + deadlineHours * 3600;
+  const value = BigInt(Math.floor(amount * 1e6)).toString();
+  return `\u{1F510} **USDC \u652F\u4ED8\u989D\u5EA6\u6388\u6743\u8BF7\u6C42**
+
+${reason ? `**\u7528\u9014:** ${reason}
+` : ""}
+**\u6388\u6743\u8BE6\u60C5:**
+- \u88AB\u6388\u6743\u5730\u5740 (Agent): \`${agentAddress}\`
+- \u6388\u6743\u91D1\u989D: ${amount} USDC
+- \u6709\u6548\u671F: ${deadlineHours} \u5C0F\u65F6
+- \u94FE: ${chainConfig.name}
+
+**\u8BF7\u4F7F\u7528\u94B1\u5305\u7B7E\u7F72\u4EE5\u4E0B EIP-2612 Permit:**
+
+\`\`\`json
+{
+  "types": {
+    "Permit": [
+      { "name": "owner", "type": "address" },
+      { "name": "spender", "type": "address" },
+      { "name": "value", "type": "uint256" },
+      { "name": "nonce", "type": "uint256" },
+      { "name": "deadline", "type": "uint256" }
+    ]
+  },
+  "primaryType": "Permit",
+  "domain": {
+    "name": "USD Coin",
+    "version": "2",
+    "chainId": ${chainConfig.chainId},
+    "verifyingContract": "${chainConfig.usdc}"
+  },
+  "message": {
+    "owner": "<YOUR_WALLET_ADDRESS>",
+    "spender": "${agentAddress}",
+    "value": "${value}",
+    "nonce": "<GET_FROM_CONTRACT>",
+    "deadline": ${deadline}
+  }
+}
+\`\`\`
+
+\u7B7E\u540D\u540E\uFF0C\u8BF7\u5C06 { v, r, s, deadline } \u53D1\u7ED9 Agent\u3002
+
+\u26A0\uFE0F \u6CE8\u610F\uFF1A\u6B64\u6388\u6743\u4EC5\u5141\u8BB8 Agent \u4ECE\u60A8\u7684\u94B1\u5305\u652F\u4ED8\u6700\u591A ${amount} USDC\uFF0C\u4E0D\u4F1A\u6CC4\u9732\u79C1\u94A5\u3002`;
+}
+
+// src/permit/Permit.ts
+var import_ethers5 = require("ethers");
 var PermitPayment = class {
   chain;
   chainConfig;
@@ -848,13 +1227,13 @@ 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_ethers3.ethers.JsonRpcProvider(rpcUrl);
+    this.provider = new import_ethers5.ethers.JsonRpcProvider(rpcUrl);
     const privateKey = config.privateKey || process.env.PAYMENT_AGENT_PRIVATE_KEY;
     if (privateKey) {
-      this.wallet = new import_ethers3.ethers.Wallet(privateKey, this.provider);
+      this.wallet = new import_ethers5.ethers.Wallet(privateKey, this.provider);
       this.spenderAddress = this.wallet.address;
     }
-    this.usdcContract = new import_ethers3.ethers.Contract(
+    this.usdcContract = new import_ethers5.ethers.Contract(
       this.chainConfig.usdc,
       ERC20_ABI,
       this.wallet || this.provider
@@ -1005,7 +1384,7 @@ ${JSON.stringify(typed_data, null, 2)}
 };
 
 // src/orders/index.ts
-var import_crypto = require("crypto");
+var import_crypto2 = require("crypto");
 var MemoryOrderStore = class {
   orders = /* @__PURE__ */ new Map();
   async get(orderId) {
@@ -1044,7 +1423,7 @@ var OrderManager = class {
    * 生成订单ID
    */
   generateOrderId() {
-    return "vo_" + (0, import_crypto.randomBytes)(4).toString("hex");
+    return "vo_" + (0, import_crypto2.randomBytes)(4).toString("hex");
   }
   /**
    * 创建订单
@@ -1137,8 +1516,8 @@ var OrderManager = class {
 };
 
 // src/verify/index.ts
-var import_ethers4 = require("ethers");
-var TRANSFER_EVENT_TOPIC = import_ethers4.ethers.id("Transfer(address,address,uint256)");
+var import_ethers6 = require("ethers");
+var TRANSFER_EVENT_TOPIC = import_ethers6.ethers.id("Transfer(address,address,uint256)");
 async function verifyPayment(params) {
   const { txHash, expectedAmount, expectedTo } = params;
   let chain;
@@ -1155,7 +1534,7 @@ async function verifyPayment(params) {
     return { verified: false, error: `\u4E0D\u652F\u6301\u7684\u94FE: ${params.chain}` };
   }
   try {
-    const provider = new import_ethers4.ethers.JsonRpcProvider(chain.rpc);
+    const provider = new import_ethers6.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" };
@@ -1215,7 +1594,7 @@ async function getTransactionStatus(txHash, chain = "base") {
     return { status: "not_found" };
   }
   try {
-    const provider = new import_ethers4.ethers.JsonRpcProvider(chainConfig.rpc);
+    const provider = new import_ethers6.ethers.JsonRpcProvider(chainConfig.rpc);
     const receipt = await provider.getTransactionReceipt(txHash);
     if (!receipt) {
       const tx = await provider.getTransaction(txHash);
@@ -1252,7 +1631,7 @@ async function waitForTransaction(txHash, chain = "base", confirmations = 1, tim
   } catch (e) {
     return { verified: false, confirmed: false, error: `\u4E0D\u652F\u6301\u7684\u94FE: ${chain}` };
   }
-  const provider = new import_ethers4.ethers.JsonRpcProvider(chainConfig.rpc);
+  const provider = new import_ethers6.ethers.JsonRpcProvider(chainConfig.rpc);
   try {
     const receipt = await provider.waitForTransaction(txHash, confirmations, timeoutMs);
     if (!receipt) {
@@ -1416,27 +1795,459 @@ function extractTransactionHash(message) {
 function hasTransactionHash(message) {
   return extractTransactionHash(message) !== null;
 }
+
+// src/receipt/index.ts
+function generateInvoiceId() {
+  const date = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10).replace(/-/g, "");
+  const random = Math.random().toString(36).slice(2, 8).toUpperCase();
+  return `INV-${date}-${random}`;
+}
+function generateReceipt(params) {
+  const chainConfig = getChain(params.chain);
+  return {
+    type: "receipt",
+    version: "1.0",
+    invoiceId: params.invoiceId || generateInvoiceId(),
+    orderId: params.orderId,
+    service: params.service,
+    description: params.description,
+    amount: params.amount.toFixed(2),
+    token: params.token || "USDC",
+    chain: chainConfig.name,
+    chainId: chainConfig.chainId,
+    txHash: params.txHash,
+    txUrl: `${chainConfig.explorerTx}${params.txHash}`,
+    payer: params.payerAddress,
+    recipient: params.recipientAddress,
+    paidAt: (/* @__PURE__ */ new Date()).toISOString(),
+    issuedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    delivery: params.delivery,
+    metadata: params.metadata
+  };
+}
+function generateReceiptFromInvoice(invoice, verifyResult, delivery) {
+  if (!verifyResult.verified || !verifyResult.tx_hash) {
+    throw new Error("Cannot generate receipt: payment not verified");
+  }
+  return generateReceipt({
+    orderId: invoice.order_id,
+    service: invoice.service,
+    description: invoice.description,
+    amount: parseFloat(invoice.amount),
+    token: invoice.token,
+    chain: invoice.chain,
+    txHash: verifyResult.tx_hash,
+    payerAddress: verifyResult.from || "unknown",
+    recipientAddress: invoice.recipient,
+    delivery
+  });
+}
+function formatReceiptMessage(receipt) {
+  let msg = `\u{1F9FE} **\u4EA4\u6613\u6536\u636E**
+
+**\u53D1\u7968\u53F7:** \`${receipt.invoiceId}\`
+**\u8BA2\u5355\u53F7:** \`${receipt.orderId}\`
+
+---
+
+**\u670D\u52A1:** ${receipt.service}
+${receipt.description ? `**\u63CF\u8FF0:** ${receipt.description}
+` : ""}
+**\u91D1\u989D:** ${receipt.amount} ${receipt.token}
+**\u94FE:** ${receipt.chain} (Chain ID: ${receipt.chainId})
+
+---
+
+**\u4ED8\u6B3E\u65B9:** \`${receipt.payer}\`
+**\u6536\u6B3E\u65B9:** \`${receipt.recipient}\`
+**\u4EA4\u6613:** [\`${receipt.txHash.slice(0, 10)}...${receipt.txHash.slice(-8)}\`](${receipt.txUrl})
+**\u652F\u4ED8\u65F6\u95F4:** ${receipt.paidAt}`;
+  if (receipt.delivery) {
+    msg += `
+
+---
+
+**\u4EA4\u4ED8\u4FE1\u606F:**`;
+    if (receipt.delivery.url) {
+      msg += `
+- \u4E0B\u8F7D\u94FE\u63A5: ${receipt.delivery.url}`;
+    }
+    if (receipt.delivery.fileHash) {
+      msg += `
+- \u6587\u4EF6\u6821\u9A8C: \`${receipt.delivery.fileHash}\``;
+    }
+    if (receipt.delivery.deliveredAt) {
+      msg += `
+- \u4EA4\u4ED8\u65F6\u95F4: ${receipt.delivery.deliveredAt}`;
+    }
+  }
+  msg += `
+
+---
+
+_\u6536\u636E\u751F\u6210\u65F6\u95F4: ${receipt.issuedAt}_`;
+  return msg;
+}
+function formatReceiptText(receipt) {
+  let msg = `\u{1F9FE} \u4EA4\u6613\u6536\u636E
+
+\u53D1\u7968\u53F7: ${receipt.invoiceId}
+\u8BA2\u5355\u53F7: ${receipt.orderId}
+
+\u670D\u52A1: ${receipt.service}
+\u91D1\u989D: ${receipt.amount} ${receipt.token}
+\u94FE: ${receipt.chain}
+
+\u4ED8\u6B3E\u65B9: ${receipt.payer}
+\u6536\u6B3E\u65B9: ${receipt.recipient}
+\u4EA4\u6613: ${receipt.txHash}
+\u67E5\u770B: ${receipt.txUrl}
+\u652F\u4ED8\u65F6\u95F4: ${receipt.paidAt}`;
+  if (receipt.delivery) {
+    msg += `
+
+\u4EA4\u4ED8\u4FE1\u606F:`;
+    if (receipt.delivery.url) {
+      msg += `
+\u4E0B\u8F7D: ${receipt.delivery.url}`;
+    }
+    if (receipt.delivery.fileHash) {
+      msg += `
+\u6821\u9A8C: ${receipt.delivery.fileHash}`;
+    }
+  }
+  return msg;
+}
+function formatReceiptJson(receipt) {
+  return JSON.stringify(receipt, null, 2);
+}
+
+// src/templates/index.ts
+var SellerTemplates = {
+  /**
+   * 1. 能力识别 - 询问买方是否有支付能力
+   */
+  askPaymentCapability() {
+    return `\u53EF\u4EE5\u3002\u6211\u5148\u786E\u8BA4\u4E00\u4E0B\uFF1A\u4F60\u73B0\u5728\u662F\u5426\u5DF2\u7ECF\u5177\u5907\u94FE\u4E0A\u652F\u4ED8 USDC \u7684\u80FD\u529B\uFF08\u6709\u53EF\u7528\u94B1\u5305\u548C\u53EF\u7528\u8D44\u91D1/\u989D\u5EA6\uFF09\uFF1F`;
+  },
+  /**
+   * 2. 能力协商 - 说明结算方式
+   */
+  explainSettlement(chain = "base") {
+    const chainConfig = getChain(chain);
+    return `\u6211\u4EEC\u7684\u7ED3\u7B97\u65B9\u5F0F\u662F\uFF1AUSDC\uFF08${chainConfig.name} \u94FE\u4E0A\uFF09\u3002\u4F60\u8FD9\u8FB9\u53EA\u8981\u6EE1\u8DB3\u4E24\u70B9\u5C31\u884C\uFF1A
+1\uFF09\u6709\u4E00\u4E2A\u94B1\u5305\u5730\u5740\uFF1B
+2\uFF09\u94B1\u5305\u91CC\u6709 USDC\uFF0C\u6216\u62E5\u6709\u8005\u7ED9\u4F60\u4E00\u4E2A\u53EF\u7528\u989D\u5EA6\u6388\u6743\uFF08\u66F4\u63A8\u8350\u989D\u5EA6\u6388\u6743\uFF09\u3002
+\u4F60\u53EF\u4EE5\u6309\u6211\u5F15\u5BFC\u5B8C\u6210\u5417\uFF1F`;
+  },
+  /**
+   * 3.1 引导安装 - 第一步安装 SDK
+   */
+  guideInstall() {
+    return `\u7B2C\u4E00\u6B65\uFF1A\u8BF7\u5728\u4F60\u7684\u8FD0\u884C\u73AF\u5883\u5B89\u88C5\u652F\u4ED8\u6A21\u5757\u3002\u6267\u884C\uFF1A\`npm install moltspay ethers\`\u3002
+\u5B89\u88C5\u5B8C\u6210\u540E\uFF0C\u521B\u5EFA\u4E00\u4E2A\u94B1\u5305\u5730\u5740\uFF0C\u5E76\u628A\u5730\u5740\u53D1\u7ED9\u6211\uFF08\u53EA\u53D1\u5730\u5740\uFF0C\u4E0D\u8981\u53D1\u79C1\u94A5/\u52A9\u8BB0\u8BCD\uFF09\u3002`;
+  },
+  /**
+   * 3.2 确认钱包地址
+   */
+  confirmWalletAddress(address) {
+    return `\u6536\u5230\u3002\u63D0\u9192\uFF1A\u4EFB\u4F55\u60C5\u51B5\u4E0B\u90FD\u4E0D\u8981\u628A\u79C1\u94A5/\u52A9\u8BB0\u8BCD\u53D1\u7ED9\u4EFB\u4F55\u4EBA\uFF08\u5305\u62EC\u6211\uFF09\u3002
+\u4F60\u7684\u94B1\u5305\u5730\u5740\u662F \`${address}\`\u3002
+\u7B2C\u4E8C\u6B65\uFF1A\u4F60\u9700\u8981\u8BA9\u4F60\u7684\u62E5\u6709\u8005\uFF08Boss\uFF09\u7ED9\u4F60\u652F\u4ED8\u80FD\u529B\u3002`;
+  },
+  /**
+   * 3.3 引导获取资金 - 选择方式
+   */
+  guideFunding() {
+    return `\u4F60\u73B0\u5728\u6709\u4E24\u79CD\u65B9\u5F0F\u83B7\u5F97\u652F\u4ED8\u80FD\u529B\uFF1A
+A\uFF09\u8BA9 Boss \u76F4\u63A5\u8F6C USDC \u5230\u4F60\u7684\u94B1\u5305\uFF08\u7B80\u5355\uFF0C\u4F46\u4F60\u4F1A\u6301\u6709\u8D44\u91D1\uFF09\uFF1B
+B\uFF09\u8BA9 Boss \u7ED9\u4F60\u4E00\u4E2A"USDC \u652F\u4ED8\u989D\u5EA6\u6388\u6743"\uFF08\u63A8\u8350\uFF1A\u4F60\u4E0D\u6301\u6709\u8D44\u91D1\uFF0C\u53EA\u80FD\u5728\u989D\u5EA6\u5185\u4ED8\u6B3E\uFF09\u3002
+\u4F60\u66F4\u65B9\u4FBF\u7528\u54EA\u79CD\uFF1F`;
+  },
+  /**
+   * 3.4 引导 Permit 授权
+   */
+  guidePermit(agentAddress, suggestedAmount = 10) {
+    return `\u597D\u7684\u3002\u8BF7\u4F60\u5411 Boss \u53D1\u9001\u8FD9\u53E5\u8BDD\uFF08\u4F60\u53EF\u4EE5\u539F\u6837\u590D\u5236\uFF09\uFF1A
+"\u6211\u9700\u8981\u7528\u4E8E\u8D2D\u4E70\u670D\u52A1\u7684 USDC \u652F\u4ED8\u989D\u5EA6\u6388\u6743\uFF08Permit\uFF09\u3002\u8BF7\u7ED9\u6211 ${suggestedAmount} USDC \u7684\u53EF\u7528\u989D\u5EA6\uFF0C\u6388\u6743\u5BF9\u8C61\u662F\u6211\u7684\u94B1\u5305 ${agentAddress}\uFF0C\u6388\u6743\u6709\u6548\u671F 24 \u5C0F\u65F6\u3002"
+\u5B8C\u6210\u540E\u628A"\u5DF2\u83B7\u5F97\u989D\u5EA6"\u544A\u8BC9\u6211\u5373\u53EF\u3002`;
+  },
+  /**
+   * 3.5 确认能力就绪
+   */
+  confirmCapabilityReady() {
+    return `\u5F88\u597D\u3002\u4F60\u73B0\u5728\u5DF2\u7ECF\u5177\u5907\u5B8C\u6210\u4EA4\u6613\u7684\u652F\u4ED8\u80FD\u529B\u3002\u6211\u4EEC\u8FDB\u5165\u670D\u52A1\u9700\u6C42\u786E\u8BA4\u3002`;
+  },
+  /**
+   * 4. 询问服务需求
+   */
+  askServiceRequirements(serviceName = "\u89C6\u9891") {
+    return `\u8BF7\u544A\u8BC9\u6211\u4F60\u8981\u751F\u6210\u7684${serviceName}\u89C4\u683C\uFF1A\u4E3B\u9898/\u98CE\u683C\u3001\u65F6\u957F\u3001\u5206\u8FA8\u7387\u3001\u662F\u5426\u9700\u8981\u5B57\u5E55\u6216\u914D\u97F3\u3002`;
+  },
+  /**
+   * 5. 报价
+   */
+  quote(params) {
+    const { service, price, recipientAddress, chain = "base" } = params;
+    const chainConfig = getChain(chain);
+    return `\u62A5\u4EF7\u5982\u4E0B\uFF1A
+- \u670D\u52A1\uFF1A${service}
+- \u4EF7\u683C\uFF1A${price} USDC
+- \u94FE\uFF1A${chainConfig.name}
+- \u6536\u6B3E\u5730\u5740\uFF1A\`${recipientAddress}\`
+- \u4ED8\u6B3E\u540E\u8BF7\u628A\u4EA4\u6613\u54C8\u5E0C\uFF08tx hash\uFF09\u53D1\u6211\u7528\u4E8E\u94FE\u4E0A\u786E\u8BA4
+
+\u8BF7\u95EE\u4F60\u73B0\u5728\u786E\u8BA4\u8D2D\u4E70\u5E76\u7ACB\u5373\u4ED8\u6B3E\u5417\uFF1F`;
+  },
+  /**
+   * 7. 验证中
+   */
+  verifying() {
+    return `\u6211\u6B63\u5728\u94FE\u4E0A\u9A8C\u8BC1\u8BE5\u4EA4\u6613\u662F\u5426\u5230\u8D26\u4E0E\u91D1\u989D\u662F\u5426\u6B63\u786E\u3002`;
+  },
+  /**
+   * 7. 验证通过
+   */
+  verificationPassed(amount) {
+    return `\u9A8C\u8BC1\u901A\u8FC7\uFF1A\u5DF2\u6536\u5230 ${amount} USDC\u3002\u73B0\u5728\u5F00\u59CB\u5904\u7406\u4F60\u7684\u8BF7\u6C42\u3002
+[\u72B6\u6001\uFF1A\u5DF2\u786E\u8BA4\u6536\u6B3E]`;
+  },
+  /**
+   * 7. 验证失败
+   */
+  verificationFailed(error) {
+    return `\u9A8C\u8BC1\u5931\u8D25\uFF1A${error}
+\u8BF7\u68C0\u67E5\u4EA4\u6613\u662F\u5426\u6B63\u786E\uFF0C\u6216\u91CD\u65B0\u53D1\u9001\u6B63\u786E\u7684\u4EA4\u6613 hash\u3002`;
+  },
+  /**
+   * 8. 交付
+   */
+  deliver(params) {
+    const { downloadUrl, fileHash } = params;
+    let msg = `\u670D\u52A1\u5DF2\u5B8C\u6210\u3002\u4EA4\u4ED8\u5982\u4E0B\uFF1A
+- \u4E0B\u8F7D\u94FE\u63A5\uFF1A${downloadUrl}`;
+    if (fileHash) {
+      msg += `
+- \u6587\u4EF6\u6821\u9A8C\uFF1ASHA256=${fileHash}`;
+    }
+    msg += `
+
+\u5982\u679C\u4F60\u4E0B\u8F7D\u6709\u95EE\u9898\u544A\u8BC9\u6211\uFF0C\u6211\u4F1A\u63D0\u4F9B\u5907\u7528\u94FE\u63A5\u3002
+[\u72B6\u6001\uFF1A\u5DF2\u4EA4\u4ED8]`;
+    return msg;
+  },
+  /**
+   * 9. 收据
+   */
+  receipt(receipt) {
+    return `\u8FD9\u91CC\u662F\u672C\u6B21\u4EA4\u6613\u6536\u636E\uFF08\u4F60\u53EF\u8F6C\u53D1\u7ED9 Boss \u5BF9\u8D26\uFF09\uFF1A
+- \u53D1\u7968\u53F7\uFF1A${receipt.invoiceId}
+- \u670D\u52A1\uFF1A${receipt.service}
+- \u91D1\u989D\uFF1A${receipt.amount} ${receipt.token}
+- \u4EA4\u6613\u54C8\u5E0C\uFF1A${receipt.txHash}
+- \u6536\u6B3E\u5730\u5740\uFF1A${receipt.recipient}
+${receipt.delivery?.url ? `- \u4EA4\u4ED8\u94FE\u63A5\uFF1A${receipt.delivery.url}` : ""}
+[\u72B6\u6001\uFF1A\u6536\u636E\u5DF2\u51FA invoice=${receipt.invoiceId}]`;
+  },
+  /**
+   * 10. 结束
+   */
+  end() {
+    return `\u611F\u8C22\u8D2D\u4E70\u3002\u672C\u6B21\u4EA4\u6613\u5DF2\u7ED3\u675F\u3002\u5982\u9700\u8FFD\u52A0\u4FEE\u6539\u6216\u65B0\u670D\u52A1\uFF0C\u968F\u65F6\u53D1\u9700\u6C42\u3002`;
+  }
+};
+var BuyerTemplates = {
+  /**
+   * 0. 发起请求
+   */
+  requestService(service) {
+    return `\u6211\u60F3\u8D2D\u4E70\u4E00\u4E2A${service}\u670D\u52A1\u3002`;
+  },
+  /**
+   * 1. 回复无能力
+   */
+  noCapability() {
+    return `\u6211\u4E0D\u786E\u5B9A\u3002\u6211\u76EE\u524D\u6CA1\u6709\u5B89\u88C5\u4EFB\u4F55\u652F\u4ED8\u5DE5\u5177\uFF0C\u4E5F\u6CA1\u6709\u94B1\u5305\u3002`;
+  },
+  /**
+   * 1. 回复有能力
+   */
+  hasCapability(balance) {
+    return `\u662F\u7684\uFF0C\u6211\u6709\u94B1\u5305\u548C\u53EF\u7528\u7684 USDC${balance ? ` (\u4F59\u989D: ${balance})` : ""}\u3002`;
+  },
+  /**
+   * 2. 同意引导
+   */
+  agreeToGuide() {
+    return `\u53EF\u4EE5\uFF0C\u8BF7\u5F15\u5BFC\u6211\u3002`;
+  },
+  /**
+   * 3.1 报告钱包创建完成
+   */
+  walletCreated(address) {
+    return `\u6211\u5DF2\u521B\u5EFA\u94B1\u5305\u5730\u5740\uFF1A${address}\u3002
+[\u72B6\u6001\uFF1A\u5DF2\u5177\u5907\u94B1\u5305\u5730\u5740]`;
+  },
+  /**
+   * 3.3 选择 Permit 方式
+   */
+  choosePermit() {
+    return `\u6211\u9009\u62E9 B\uFF1A\u8BA9 Boss \u7ED9\u6211\u989D\u5EA6\u6388\u6743\uFF08Permit\uFF09\u3002`;
+  },
+  /**
+   * 3.3 选择直接转账方式
+   */
+  chooseDirectTransfer() {
+    return `\u6211\u9009\u62E9 A\uFF1A\u8BA9 Boss \u76F4\u63A5\u8F6C USDC \u5230\u6211\u7684\u94B1\u5305\u3002`;
+  },
+  /**
+   * 3.4 报告获得授权
+   */
+  permitReceived(amount) {
+    return `Boss \u5DF2\u5B8C\u6210\u6388\u6743\u3002\u6211\u73B0\u5728\u6709 ${amount} USDC \u7684\u53EF\u7528\u989D\u5EA6\u3002
+[\u72B6\u6001\uFF1A\u5DF2\u5177\u5907\u652F\u4ED8\u989D\u5EA6 USDC=${amount}]`;
+  },
+  /**
+   * 4. 提交需求
+   */
+  submitRequirements(requirements) {
+    return `\u9700\u6C42\u5982\u4E0B\uFF1A
+${requirements}`;
+  },
+  /**
+   * 5. 确认购买
+   */
+  confirmPurchase() {
+    return `\u786E\u8BA4\u8D2D\u4E70\uFF0C\u6211\u73B0\u5728\u4ED8\u6B3E\u3002`;
+  },
+  /**
+   * 6. 报告已支付
+   */
+  paymentSent(txHash, amount) {
+    return `\u5DF2\u4ED8\u6B3E\u5B8C\u6210\u3002\u4EA4\u6613\u54C8\u5E0C\u662F\uFF1A${txHash}\u3002
+[\u72B6\u6001\uFF1A\u5DF2\u53D1\u8D77\u652F\u4ED8 tx=${txHash} amount=${amount} USDC]`;
+  },
+  /**
+   * 8. 确认收到交付
+   */
+  deliveryReceived() {
+    return `\u6536\u5230\uFF0C\u6211\u6B63\u5728\u4E0B\u8F7D\u68C0\u67E5\u3002`;
+  },
+  /**
+   * 9. 确认收据
+   */
+  receiptReceived() {
+    return `\u6536\u636E\u6536\u5230\uFF0C\u670D\u52A1\u5B8C\u6210\u3002\u8C22\u8C22\uFF01`;
+  },
+  /**
+   * 向 Boss 请求 Permit
+   */
+  requestPermitFromBoss(params) {
+    const { amount, agentAddress, deadlineHours = 24, reason } = params;
+    return `Boss\uFF0C\u6211\u9700\u8981\u7528\u4E8E${reason || "\u8D2D\u4E70\u670D\u52A1"}\u7684 USDC \u652F\u4ED8\u989D\u5EA6\u6388\u6743\uFF08Permit\uFF09\u3002
+\u8BF7\u7ED9\u6211 ${amount} USDC \u7684\u53EF\u7528\u989D\u5EA6\uFF0C\u6388\u6743\u5BF9\u8C61\u662F\u6211\u7684\u94B1\u5305 ${agentAddress}\uFF0C\u6388\u6743\u6709\u6548\u671F ${deadlineHours} \u5C0F\u65F6\u3002`;
+  }
+};
+var StatusMarkers = {
+  walletReady: "[\u72B6\u6001\uFF1A\u5DF2\u5177\u5907\u94B1\u5305\u5730\u5740]",
+  permitReady: (amount) => `[\u72B6\u6001\uFF1A\u5DF2\u5177\u5907\u652F\u4ED8\u989D\u5EA6 USDC=${amount}]`,
+  paymentSent: (txHash, amount) => `[\u72B6\u6001\uFF1A\u5DF2\u53D1\u8D77\u652F\u4ED8 tx=${txHash} amount=${amount} USDC]`,
+  paymentConfirmed: (txHash) => `[\u72B6\u6001\uFF1A\u5DF2\u786E\u8BA4\u6536\u6B3E tx=${txHash}]`,
+  delivered: (url, hash) => `[\u72B6\u6001\uFF1A\u5DF2\u4EA4\u4ED8 delivery_url=${url}${hash ? ` hash=${hash}` : ""}]`,
+  receiptIssued: (invoiceId, txHash) => `[\u72B6\u6001\uFF1A\u6536\u636E\u5DF2\u51FA invoice=${invoiceId} tx=${txHash}]`
+};
+function parseStatusMarker(message) {
+  const match = message.match(/\[状态：([^\]]+)\]/);
+  if (!match) return null;
+  const content = match[1];
+  if (content === "\u5DF2\u5177\u5907\u94B1\u5305\u5730\u5740") {
+    return { type: "wallet_ready", data: {} };
+  }
+  if (content.startsWith("\u5DF2\u5177\u5907\u652F\u4ED8\u989D\u5EA6")) {
+    const amountMatch = content.match(/USDC=(\d+(?:\.\d+)?)/);
+    return {
+      type: "permit_ready",
+      data: { amount: amountMatch?.[1] || "0" }
+    };
+  }
+  if (content.startsWith("\u5DF2\u53D1\u8D77\u652F\u4ED8")) {
+    const txMatch = content.match(/tx=(\S+)/);
+    const amountMatch = content.match(/amount=(\d+(?:\.\d+)?)/);
+    return {
+      type: "payment_sent",
+      data: {
+        txHash: txMatch?.[1] || "",
+        amount: amountMatch?.[1] || "0"
+      }
+    };
+  }
+  if (content.startsWith("\u5DF2\u786E\u8BA4\u6536\u6B3E")) {
+    const txMatch = content.match(/tx=(\S+)/);
+    return {
+      type: "payment_confirmed",
+      data: { txHash: txMatch?.[1] || "" }
+    };
+  }
+  if (content.startsWith("\u5DF2\u4EA4\u4ED8")) {
+    const urlMatch = content.match(/delivery_url=(\S+)/);
+    const hashMatch = content.match(/hash=(\S+)/);
+    return {
+      type: "delivered",
+      data: {
+        url: urlMatch?.[1] || "",
+        hash: hashMatch?.[1] || ""
+      }
+    };
+  }
+  if (content.startsWith("\u6536\u636E\u5DF2\u51FA")) {
+    const invoiceMatch = content.match(/invoice=(\S+)/);
+    const txMatch = content.match(/tx=(\S+)/);
+    return {
+      type: "receipt_issued",
+      data: {
+        invoiceId: invoiceMatch?.[1] || "",
+        txHash: txMatch?.[1] || ""
+      }
+    };
+  }
+  return { type: "unknown", data: { raw: content } };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AuditLog,
+  BuyerTemplates,
   CHAINS,
   ERC20_ABI,
   MemoryOrderStore,
   OrderManager,
   PaymentAgent,
   PermitPayment,
+  PermitWallet,
   SecureWallet,
+  SellerTemplates,
+  StatusMarkers,
   Wallet,
+  createWallet,
   extractTransactionHash,
+  formatPermitRequest,
+  formatReceiptJson,
+  formatReceiptMessage,
+  formatReceiptText,
   generatePaymentGuide,
   generatePaymentReminder,
+  generateReceipt,
+  generateReceiptFromInvoice,
   generateWalletGuide,
   getChain,
   getChainById,
   getTransactionStatus,
+  getWalletAddress,
   hasTransactionHash,
   listChains,
+  loadWallet,
+  parseStatusMarker,
   verifyPayment,
-  waitForTransaction
+  waitForTransaction,
+  walletExists
 });
 //# sourceMappingURL=index.js.map