moltspay 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,118 @@
+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';
+export { SecureWallet, Wallet } from './wallet/index.js';
+export { PermitPayment } from './permit/index.js';
+export { CHAINS, ERC20_ABI, getChain, getChainById, listChains } from './chains/index.js';
+
+/**
+ * PaymentAgent - 核心支付代理
+ *
+ * 功能：
+ * - 生成 Invoice（支付请求）
+ * - 验证链上支付
+ * - 生成钱包深度链接
+ */
+
+declare class PaymentAgent {
+    readonly chain: ChainName;
+    readonly chainConfig: ChainConfig;
+    readonly walletAddress: string;
+    private provider;
+    private usdcContract;
+    static readonly PROTOCOL_VERSION = "1.0";
+    constructor(config?: PaymentAgentConfig);
+    /**
+     * 生成支付请求（Invoice）
+     */
+    createInvoice(params: CreateInvoiceParams): Invoice;
+    /**
+     * 生成钱包深度链接（支持 MetaMask 等）
+     */
+    generateDeepLink(amount: number, memo: string): string;
+    /**
+     * 验证链上支付
+     */
+    verifyPayment(txHash: string, options?: VerifyOptions): Promise<VerifyResult>;
+    /**
+     * 扫描最近转账（按金额匹配）
+     */
+    scanRecentTransfers(expectedAmount: number, timeoutMinutes?: number): Promise<VerifyResult>;
+    /**
+     * 获取钱包余额
+     */
+    getBalance(address?: string): Promise<WalletBalance>;
+    /**
+     * 格式化 Invoice 为人类可读消息
+     */
+    formatInvoiceMessage(invoice: Invoice, includeJson?: boolean): string;
+}
+
+/**
+ * AuditLog - 不可篡改审计日志
+ *
+ * 特点：
+ * - 链式哈希，任何修改都会破坏链条
+ * - 按日期分文件存储
+ * - JSONL 格式便于追加和解析
+ */
+
+interface LogParams {
+    action: AuditAction;
+    request_id: string;
+    from?: string;
+    to?: string;
+    amount?: number;
+    tx_hash?: string;
+    reason?: string;
+    requester?: string;
+    metadata?: Record<string, unknown>;
+}
+declare class AuditLog {
+    private basePath;
+    private lastHash;
+    constructor(basePath?: string);
+    /**
+     * 记录审计日志
+     */
+    log(params: LogParams): Promise<AuditEntry>;
+    /**
+     * 读取指定日期的日志
+     */
+    read(date?: Date): AuditEntry[];
+    /**
+     * 验证日志完整性
+     */
+    verify(date?: Date): {
+        valid: boolean;
+        errors: string[];
+    };
+    /**
+     * 搜索日志
+     */
+    search(filter: Partial<{
+        action: AuditAction;
+        request_id: string;
+        from: string;
+        to: string;
+        startDate: Date;
+        endDate: Date;
+    }>): AuditEntry[];
+    /**
+     * 获取日志文件路径
+     */
+    private getFilePath;
+    /**
+     * 计算条目哈希
+     */
+    private calculateHash;
+    /**
+     * 加载最后一条日志的哈希
+     */
+    private loadLastHash;
+    /**
+     * 确保目录存在
+     */
+    private ensureDir;
+}
+
+export { AuditAction, AuditEntry, AuditLog, ChainConfig, ChainName, CreateInvoiceParams, Invoice, PaymentAgent, PaymentAgentConfig, VerifyOptions, VerifyResult, WalletBalance };