moltspay 0.1.3 → 0.2.1

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 - 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;
+    /** Transaction hash */
+    txHash: string;
+    /** Payer address */
+    payerAddress: string;
+    /** Recipient address */
+    recipientAddress: string;
+    /** Delivery info */
+    delivery?: {
+        /** Delivery URL */
+        url?: string;
+        /** 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;
+/**
+ * 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;
+/**
+ * Format receipt as plain text (for Feishu/WhatsApp)
+ */
+declare function formatReceiptText(receipt: Receipt): string;
+/**
+ * Format receipt as JSON (for Agent parsing)
+ */
+declare function formatReceiptJson(receipt: Receipt): string;
+
+/**
+ * Agent Conversation Templates
+ *
+ * Standardized Agent-to-Agent payment conversation templates
+ * Can be embedded in prompts or used for dialogue generation
+ */
+
+declare const SellerTemplates: {
+    /**
+     * 1. Capability Check - Ask if buyer has payment capability
+     */
+    askPaymentCapability(): string;
+    /**
+     * 2. Settlement Method - Explain how we settle
+     */
+    explainSettlement(chain?: ChainName): string;
+    /**
+     * 3.1 Installation Guide - First step: install SDK
+     */
+    guideInstall(): string;
+    /**
+     * 3.2 Confirm Wallet Address
+     */
+    confirmWalletAddress(address: string): string;
+    /**
+     * 3.3 Funding Options - Choose method
+     */
+    guideFunding(): string;
+    /**
+     * 3.4 Guide Permit Authorization
+     */
+    guidePermit(agentAddress: string, suggestedAmount?: number): string;
+    /**
+     * 3.5 Confirm Capability Ready
+     */
+    confirmCapabilityReady(): string;
+    /**
+     * 4. Ask Service Requirements
+     */
+    askServiceRequirements(serviceName?: string): string;
+    /**
+     * 5. Quote
+     */
+    quote(params: {
+        service: string;
+        price: number;
+        recipientAddress: string;
+        chain?: ChainName;
+    }): string;
+    /**
+     * 7. Verifying
+     */
+    verifying(): string;
+    /**
+     * 7. Verification Passed
+     */
+    verificationPassed(amount: string): string;
+    /**
+     * 7. Verification Failed
+     */
+    verificationFailed(error: string): string;
+    /**
+     * 8. Delivery
+     */
+    deliver(params: {
+        downloadUrl: string;
+        fileHash?: string;
+    }): string;
+    /**
+     * 9. Receipt
+     */
+    receipt(receipt: Receipt): string;
+    /**
+     * 10. End
+     */
+    end(): string;
+};
+declare const BuyerTemplates: {
+    /**
+     * 0. Request Service
+     */
+    requestService(service: string): string;
+    /**
+     * 1. No Capability
+     */
+    noCapability(): string;
+    /**
+     * 1. Has Capability
+     */
+    hasCapability(balance?: string): string;
+    /**
+     * 2. Agree to Guide
+     */
+    agreeToGuide(): string;
+    /**
+     * 3.1 Report Wallet Created
+     */
+    walletCreated(address: string): string;
+    /**
+     * 3.3 Choose Permit Method
+     */
+    choosePermit(): string;
+    /**
+     * 3.3 Choose Direct Transfer
+     */
+    chooseDirectTransfer(): string;
+    /**
+     * 3.4 Report Permit Received
+     */
+    permitReceived(amount: number): string;
+    /**
+     * 4. Submit Requirements
+     */
+    submitRequirements(requirements: string): string;
+    /**
+     * 5. Confirm Purchase
+     */
+    confirmPurchase(): string;
+    /**
+     * 6. Report Payment Sent
+     */
+    paymentSent(txHash: string, amount: number): string;
+    /**
+     * 8. Confirm Delivery Received
+     */
+    deliveryReceived(): string;
+    /**
+     * 9. Confirm Receipt
+     */
+    receiptReceived(): string;
+    /**
+     * Request Permit from Boss
+     */
+    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 };