moltspay 0.2.0 → 0.2.2

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { C as ChainName, a as ChainConfig, P as PaymentAgentConfig, b as CreateInvoiceParams, I as Invoice, V as VerifyOptions, c as VerifyResult, W as WalletBalance, A as AuditAction, d as AuditEntry } from './index-CZzgdtin.js';
-export { E as EIP712TypedData, e as PendingTransfer, f as PermitExecuteResult, g as PermitRequest, h as PermitSignature, S as SecureWalletConfig, i as SecurityLimits, T as TransferParams, j as TransferResult } from './index-CZzgdtin.js';
+import { C as ChainName, a as ChainConfig, P as PaymentAgentConfig, b as CreateInvoiceParams, I as Invoice, V as VerifyOptions, c as VerifyResult, W as WalletBalance, A as AuditAction, d as AuditEntry } from './index-CyFg9s2m.js';
+export { E as EIP712TypedData, e as PendingTransfer, f as PermitExecuteResult, g as PermitRequest, h as PermitSignature, S as SecureWalletConfig, i as SecurityLimits, T as TransferParams, j as TransferResult } from './index-CyFg9s2m.js';
 export { CreateWalletOptions, CreateWalletResult, PermitData, PermitWallet, PermitWalletConfig, SecureWallet, TransferWithPermitParams, TransferWithPermitResult, Wallet, WalletData, createWallet, formatPermitRequest, getWalletAddress, loadWallet, walletExists } from './wallet/index.js';
 export { PermitPayment } from './permit/index.js';
 export { CreateOrderParams, MemoryOrderStore, Order, OrderManager, OrderStatus, OrderStore } from './orders/index.js';
@@ -8,12 +8,12 @@ export { PaymentGuideParams, extractTransactionHash, generatePaymentGuide, gener
 export { CHAINS, ERC20_ABI, getChain, getChainById, listChains } from './chains/index.js';
 
 /**
- * PaymentAgent - 核心支付代理
+ * PaymentAgent - Core Payment Agent
  *
- * 功能：
- * - 生成 Invoice（支付请求）
- * - 验证链上支付
- * - 生成钱包深度链接
+ * Features:
+ * - Generate Invoice (payment request)
+ * - Verify on-chain payment
+ * - Generate wallet deep link
  */
 
 declare class PaymentAgent {
@@ -25,38 +25,38 @@ declare class PaymentAgent {
     static readonly PROTOCOL_VERSION = "1.0";
     constructor(config?: PaymentAgentConfig);
     /**
-     * 生成支付请求（Invoice）
+     * Generate payment request（Invoice）
      */
     createInvoice(params: CreateInvoiceParams): Invoice;
     /**
-     * 生成钱包深度链接（支持 MetaMask 等）
+     * Generate wallet deep link（supports MetaMask etc）
      */
     generateDeepLink(amount: number, memo: string): string;
     /**
-     * 验证链上支付
+     * Verify on-chain payment
      */
     verifyPayment(txHash: string, options?: VerifyOptions): Promise<VerifyResult>;
     /**
-     * 扫描最近转账（按金额匹配）
+     * Scan recent transfers (match by amount)
      */
     scanRecentTransfers(expectedAmount: number, timeoutMinutes?: number): Promise<VerifyResult>;
     /**
-     * 获取钱包余额
+     * Get wallet balance
      */
     getBalance(address?: string): Promise<WalletBalance>;
     /**
-     * 格式化 Invoice 为人类可读消息
+     * Format Invoice as human-readable message
      */
     formatInvoiceMessage(invoice: Invoice, includeJson?: boolean): string;
 }
 
 /**
- * AuditLog - 不可篡改审计日志
+ * AuditLog - Immutable Audit Log
  *
- * 特点：
- * - 链式哈希，任何修改都会破坏链条
- * - 按日期分文件存储
- * - JSONL 格式便于追加和解析
+ * Features:
+ * - Hash-chained, any modification breaks the chain
+ * - Stored by date in separate files
+ * - JSONL format for easy append and parse
  */
 
 interface LogParams {
@@ -75,22 +75,22 @@ declare class AuditLog {
     private lastHash;
     constructor(basePath?: string);
     /**
-     * 记录审计日志
+     * Record audit log
      */
     log(params: LogParams): Promise<AuditEntry>;
     /**
-     * 读取指定日期的日志
+     * Read logs for specified date
      */
     read(date?: Date): AuditEntry[];
     /**
-     * 验证日志完整性
+     * Verify log integrity
      */
     verify(date?: Date): {
         valid: boolean;
         errors: string[];
     };
     /**
-     * 搜索日志
+     * Search logs
      */
     search(filter: Partial<{
         action: AuditAction;
@@ -101,159 +101,159 @@ declare class AuditLog {
         endDate: Date;
     }>): AuditEntry[];
     /**
-     * 获取日志文件路径
+     * Get log file path
      */
     private getFilePath;
     /**
-     * 计算条目哈希
+     * Calculate entry hash
      */
     private calculateHash;
     /**
-     * 加载最后一条日志的哈希
+     * Load last log entry hash
      */
     private loadLastHash;
     /**
-     * 确保目录存在
+     * Ensure directory exists
      */
     private ensureDir;
 }
 
 /**
- * Receipt - 交易收据生成
+ * Receipt - Transaction receipt generation
  *
- * 用于生成标准化的交易收据，便于对账/报销/审计
+ * Generate standardized transaction receipts for reconciliation/reimbursement/audit
  */
 
 interface ReceiptParams {
-    /** 发票号（自动生成或指定） */
+    /** Invoice ID (auto-generated or specified) */
     invoiceId?: string;
-    /** 订单号 */
+    /** Order ID */
     orderId: string;
-    /** 服务名称 */
+    /** Service name */
     service: string;
-    /** 服务描述 */
+    /** Service description */
     description?: string;
-    /** 金额 */
+    /** Amount */
     amount: number;
     /** Token */
     token?: 'USDC' | 'USDT' | 'ETH';
-    /** 链 */
+    /** Chain */
     chain: ChainName;
-    /** 交易 hash */
+    /** Transaction hash */
     txHash: string;
-    /** 付款方地址 */
+    /** Payer address */
     payerAddress: string;
-    /** 收款方地址 */
+    /** Recipient address */
     recipientAddress: string;
-    /** 交付信息 */
+    /** Delivery info */
     delivery?: {
-        /** 交付物 URL */
+        /** Delivery URL */
         url?: string;
-        /** 文件 hash */
+        /** File hash */
         fileHash?: string;
-        /** 交付时间 */
+        /** Delivery timestamp */
         deliveredAt?: string;
     };
-    /** 额外元数据 */
+    /** Additional metadata */
     metadata?: Record<string, unknown>;
 }
 interface Receipt {
     type: 'receipt';
     version: '1.0';
-    /** 发票号 */
+    /** Invoice ID */
     invoiceId: string;
-    /** 订单号 */
+    /** Order ID */
     orderId: string;
-    /** 服务 */
+    /** Service */
     service: string;
     description?: string;
-    /** 金额 */
+    /** Amount */
     amount: string;
     token: string;
-    /** 链信息 */
+    /** Chain info */
     chain: string;
     chainId: number;
-    /** 交易信息 */
+    /** Transaction info */
     txHash: string;
     txUrl: string;
-    /** 参与方 */
+    /** Parties */
     payer: string;
     recipient: string;
-    /** 时间 */
+    /** Timestamps */
     paidAt: string;
     issuedAt: string;
-    /** 交付信息 */
+    /** Delivery info */
     delivery?: {
         url?: string;
         fileHash?: string;
         deliveredAt?: string;
     };
-    /** 额外元数据 */
+    /** Additional metadata */
     metadata?: Record<string, unknown>;
 }
 /**
- * 生成交易收据
+ * Generate transaction receipt
  */
 declare function generateReceipt(params: ReceiptParams): Receipt;
 /**
- * 从 Invoice + VerifyResult 生成收据
+ * Generate receipt from Invoice + VerifyResult
  */
 declare function generateReceiptFromInvoice(invoice: Invoice, verifyResult: VerifyResult, delivery?: ReceiptParams['delivery']): Receipt;
 /**
- * 格式化收据为人类可读消息
+ * Format receipt as human-readable message (Markdown)
  */
 declare function formatReceiptMessage(receipt: Receipt): string;
 /**
- * 格式化收据为纯文本（适合飞书/WhatsApp）
+ * Format receipt as plain text (for Feishu/WhatsApp)
  */
 declare function formatReceiptText(receipt: Receipt): string;
 /**
- * 格式化收据为 JSON（适合 Agent 解析）
+ * Format receipt as JSON (for Agent parsing)
  */
 declare function formatReceiptJson(receipt: Receipt): string;
 
 /**
- * Agent 对话模板
+ * Agent Conversation Templates
  *
- * 标准化的 Agent-to-Agent 支付对话模板
- * 可直接嵌入 prompt 或用于生成对话
+ * Standardized Agent-to-Agent payment conversation templates
+ * Can be embedded in prompts or used for dialogue generation
  */
 
 declare const SellerTemplates: {
     /**
-     * 1. 能力识别 - 询问买方是否有支付能力
+     * 1. Capability Check - Ask if buyer has payment capability
      */
     askPaymentCapability(): string;
     /**
-     * 2. 能力协商 - 说明结算方式
+     * 2. Settlement Method - Explain how we settle
      */
     explainSettlement(chain?: ChainName): string;
     /**
-     * 3.1 引导安装 - 第一步安装 SDK
+     * 3.1 Installation Guide - First step: install SDK
      */
     guideInstall(): string;
     /**
-     * 3.2 确认钱包地址
+     * 3.2 Confirm Wallet Address
      */
     confirmWalletAddress(address: string): string;
     /**
-     * 3.3 引导获取资金 - 选择方式
+     * 3.3 Funding Options - Choose method
      */
     guideFunding(): string;
     /**
-     * 3.4 引导 Permit 授权
+     * 3.4 Guide Permit Authorization
      */
     guidePermit(agentAddress: string, suggestedAmount?: number): string;
     /**
-     * 3.5 确认能力就绪
+     * 3.5 Confirm Capability Ready
      */
     confirmCapabilityReady(): string;
     /**
-     * 4. 询问服务需求
+     * 4. Ask Service Requirements
      */
     askServiceRequirements(serviceName?: string): string;
     /**
-     * 5. 报价
+     * 5. Quote
      */
     quote(params: {
         service: string;
@@ -262,88 +262,88 @@ declare const SellerTemplates: {
         chain?: ChainName;
     }): string;
     /**
-     * 7. 验证中
+     * 7. Verifying
      */
     verifying(): string;
     /**
-     * 7. 验证通过
+     * 7. Verification Passed
      */
     verificationPassed(amount: string): string;
     /**
-     * 7. 验证失败
+     * 7. Verification Failed
      */
     verificationFailed(error: string): string;
     /**
-     * 8. 交付
+     * 8. Delivery
      */
     deliver(params: {
         downloadUrl: string;
         fileHash?: string;
     }): string;
     /**
-     * 9. 收据
+     * 9. Receipt
      */
     receipt(receipt: Receipt): string;
     /**
-     * 10. 结束
+     * 10. End
      */
     end(): string;
 };
 declare const BuyerTemplates: {
     /**
-     * 0. 发起请求
+     * 0. Request Service
      */
     requestService(service: string): string;
     /**
-     * 1. 回复无能力
+     * 1. No Capability
      */
     noCapability(): string;
     /**
-     * 1. 回复有能力
+     * 1. Has Capability
      */
     hasCapability(balance?: string): string;
     /**
-     * 2. 同意引导
+     * 2. Agree to Guide
      */
     agreeToGuide(): string;
     /**
-     * 3.1 报告钱包创建完成
+     * 3.1 Report Wallet Created
      */
     walletCreated(address: string): string;
     /**
-     * 3.3 选择 Permit 方式
+     * 3.3 Choose Permit Method
      */
     choosePermit(): string;
     /**
-     * 3.3 选择直接转账方式
+     * 3.3 Choose Direct Transfer
      */
     chooseDirectTransfer(): string;
     /**
-     * 3.4 报告获得授权
+     * 3.4 Report Permit Received
      */
     permitReceived(amount: number): string;
     /**
-     * 4. 提交需求
+     * 4. Submit Requirements
      */
     submitRequirements(requirements: string): string;
     /**
-     * 5. 确认购买
+     * 5. Confirm Purchase
      */
     confirmPurchase(): string;
     /**
-     * 6. 报告已支付
+     * 6. Report Payment Sent
      */
     paymentSent(txHash: string, amount: number): string;
     /**
-     * 8. 确认收到交付
+     * 8. Confirm Delivery Received
      */
     deliveryReceived(): string;
     /**
-     * 9. 确认收据
+     * 9. Confirm Receipt
      */
     receiptReceived(): string;
     /**
-     * 向 Boss 请求 Permit
+     * Request Permit from Boss
      */
     requestPermitFromBoss(params: {
         amount: number;