moltspay 0.1.3 → 0.2.0

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 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 { 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';
 export { VerifyPaymentParams, VerifyPaymentResult, getTransactionStatus, verifyPayment, waitForTransaction } from './verify/index.js';
@@ -118,4 +118,251 @@ declare class AuditLog {
     private ensureDir;
 }
 
-export { AuditAction, AuditEntry, AuditLog, ChainConfig, ChainName, CreateInvoiceParams, Invoice, PaymentAgent, PaymentAgentConfig, VerifyOptions, VerifyResult, WalletBalance };
+/**
+ * Receipt - 交易收据生成
+ *
+ * 用于生成标准化的交易收据，便于对账/报销/审计
+ */
+
+interface ReceiptParams {
+    /** 发票号（自动生成或指定） */
+    invoiceId?: string;
+    /** 订单号 */
+    orderId: string;
+    /** 服务名称 */
+    service: string;
+    /** 服务描述 */
+    description?: string;
+    /** 金额 */
+    amount: number;
+    /** Token */
+    token?: 'USDC' | 'USDT' | 'ETH';
+    /** 链 */
+    chain: ChainName;
+    /** 交易 hash */
+    txHash: string;
+    /** 付款方地址 */
+    payerAddress: string;
+    /** 收款方地址 */
+    recipientAddress: string;
+    /** 交付信息 */
+    delivery?: {
+        /** 交付物 URL */
+        url?: string;
+        /** 文件 hash */
+        fileHash?: string;
+        /** 交付时间 */
+        deliveredAt?: string;
+    };
+    /** 额外元数据 */
+    metadata?: Record<string, unknown>;
+}
+interface Receipt {
+    type: 'receipt';
+    version: '1.0';
+    /** 发票号 */
+    invoiceId: string;
+    /** 订单号 */
+    orderId: string;
+    /** 服务 */
+    service: string;
+    description?: string;
+    /** 金额 */
+    amount: string;
+    token: string;
+    /** 链信息 */
+    chain: string;
+    chainId: number;
+    /** 交易信息 */
+    txHash: string;
+    txUrl: string;
+    /** 参与方 */
+    payer: string;
+    recipient: string;
+    /** 时间 */
+    paidAt: string;
+    issuedAt: string;
+    /** 交付信息 */
+    delivery?: {
+        url?: string;
+        fileHash?: string;
+        deliveredAt?: string;
+    };
+    /** 额外元数据 */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * 生成交易收据
+ */
+declare function generateReceipt(params: ReceiptParams): Receipt;
+/**
+ * 从 Invoice + VerifyResult 生成收据
+ */
+declare function generateReceiptFromInvoice(invoice: Invoice, verifyResult: VerifyResult, delivery?: ReceiptParams['delivery']): Receipt;
+/**
+ * 格式化收据为人类可读消息
+ */
+declare function formatReceiptMessage(receipt: Receipt): string;
+/**
+ * 格式化收据为纯文本（适合飞书/WhatsApp）
+ */
+declare function formatReceiptText(receipt: Receipt): string;
+/**
+ * 格式化收据为 JSON（适合 Agent 解析）
+ */
+declare function formatReceiptJson(receipt: Receipt): string;
+
+/**
+ * Agent 对话模板
+ *
+ * 标准化的 Agent-to-Agent 支付对话模板
+ * 可直接嵌入 prompt 或用于生成对话
+ */
+
+declare const SellerTemplates: {
+    /**
+     * 1. 能力识别 - 询问买方是否有支付能力
+     */
+    askPaymentCapability(): string;
+    /**
+     * 2. 能力协商 - 说明结算方式
+     */
+    explainSettlement(chain?: ChainName): string;
+    /**
+     * 3.1 引导安装 - 第一步安装 SDK
+     */
+    guideInstall(): string;
+    /**
+     * 3.2 确认钱包地址
+     */
+    confirmWalletAddress(address: string): string;
+    /**
+     * 3.3 引导获取资金 - 选择方式
+     */
+    guideFunding(): string;
+    /**
+     * 3.4 引导 Permit 授权
+     */
+    guidePermit(agentAddress: string, suggestedAmount?: number): string;
+    /**
+     * 3.5 确认能力就绪
+     */
+    confirmCapabilityReady(): string;
+    /**
+     * 4. 询问服务需求
+     */
+    askServiceRequirements(serviceName?: string): string;
+    /**
+     * 5. 报价
+     */
+    quote(params: {
+        service: string;
+        price: number;
+        recipientAddress: string;
+        chain?: ChainName;
+    }): string;
+    /**
+     * 7. 验证中
+     */
+    verifying(): string;
+    /**
+     * 7. 验证通过
+     */
+    verificationPassed(amount: string): string;
+    /**
+     * 7. 验证失败
+     */
+    verificationFailed(error: string): string;
+    /**
+     * 8. 交付
+     */
+    deliver(params: {
+        downloadUrl: string;
+        fileHash?: string;
+    }): string;
+    /**
+     * 9. 收据
+     */
+    receipt(receipt: Receipt): string;
+    /**
+     * 10. 结束
+     */
+    end(): string;
+};
+declare const BuyerTemplates: {
+    /**
+     * 0. 发起请求
+     */
+    requestService(service: string): string;
+    /**
+     * 1. 回复无能力
+     */
+    noCapability(): string;
+    /**
+     * 1. 回复有能力
+     */
+    hasCapability(balance?: string): string;
+    /**
+     * 2. 同意引导
+     */
+    agreeToGuide(): string;
+    /**
+     * 3.1 报告钱包创建完成
+     */
+    walletCreated(address: string): string;
+    /**
+     * 3.3 选择 Permit 方式
+     */
+    choosePermit(): string;
+    /**
+     * 3.3 选择直接转账方式
+     */
+    chooseDirectTransfer(): string;
+    /**
+     * 3.4 报告获得授权
+     */
+    permitReceived(amount: number): string;
+    /**
+     * 4. 提交需求
+     */
+    submitRequirements(requirements: string): string;
+    /**
+     * 5. 确认购买
+     */
+    confirmPurchase(): string;
+    /**
+     * 6. 报告已支付
+     */
+    paymentSent(txHash: string, amount: number): string;
+    /**
+     * 8. 确认收到交付
+     */
+    deliveryReceived(): string;
+    /**
+     * 9. 确认收据
+     */
+    receiptReceived(): string;
+    /**
+     * 向 Boss 请求 Permit
+     */
+    requestPermitFromBoss(params: {
+        amount: number;
+        agentAddress: string;
+        deadlineHours?: number;
+        reason?: string;
+    }): string;
+};
+declare const StatusMarkers: {
+    walletReady: string;
+    permitReady: (amount: number) => string;
+    paymentSent: (txHash: string, amount: number) => string;
+    paymentConfirmed: (txHash: string) => string;
+    delivered: (url: string, hash?: string) => string;
+    receiptIssued: (invoiceId: string, txHash: string) => string;
+};
+declare function parseStatusMarker(message: string): {
+    type: string;
+    data: Record<string, string>;
+} | null;
+
+export { AuditAction, AuditEntry, AuditLog, BuyerTemplates, ChainConfig, ChainName, CreateInvoiceParams, Invoice, PaymentAgent, PaymentAgentConfig, type Receipt, type ReceiptParams, SellerTemplates, StatusMarkers, VerifyOptions, VerifyResult, WalletBalance, formatReceiptJson, formatReceiptMessage, formatReceiptText, generateReceipt, generateReceiptFromInvoice, parseStatusMarker };