moltspay 0.5.4 → 0.7.1

package/dist/index.d.ts

@@ -1,1484 +1,7 @@
-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 { AllowanceStatus, AllowanceWallet, AllowanceWalletConfig, CreateWalletOptions, CreateWalletResult, OwnerPermit, PermitData, PermitSigner, PermitWallet, PermitWalletConfig, SecureWallet, SignPermitConfig, SignPermitParams, SignPermitResult, SpendParams, SpendResult, TransferWithPermitParams, TransferWithPermitResult, Wallet, WalletData, createWallet, formatPermitRequest, generatePermitInstructions, getWalletAddress, loadWallet, signPermit, walletExists } from './wallet/index.js';
-export { PermitPayment } from './permit/index.js';
-export { CreateOrderParams, MemoryOrderStore, Order, OrderManager, OrderStatus, OrderStore } from './orders/index.js';
+export { Charge, ChargeStatus, MoltsPayServer, MoltsPayServerOptions, PaymentRequest, ProviderConfig, RegisteredSkill, ServiceConfig, ServicesManifest, SkillFunction } from './server/index.js';
+export { ClientConfig, MoltsPayClient, MoltsPayClientOptions, PaymentRequired, ProviderInfo, ServiceInfo, ServicesResponse, VerifyResponse, WalletData } from './client/index.js';
+export { CHAINS, ERC20_ABI, getChain, getChainById, listChains } from './chains/index.js';
+export { c as createWallet, g as getWalletAddress, l as loadWallet, w as walletExists } from './createWallet-D53qu7ie.js';
 export { VerifyPaymentParams, VerifyPaymentResult, getTransactionStatus, verifyPayment, waitForTransaction } from './verify/index.js';
-export { PaymentGuideParams, extractTransactionHash, generatePaymentGuide, generatePaymentReminder, generateWalletGuide, hasTransactionHash } from './guide/index.js';
-import { getChain } from './chains/index.js';
-export { CHAINS, ERC20_ABI, getChainById, listChains } from './chains/index.js';
-import { ethers } from 'ethers';
-
-/**
- * PaymentAgent - Core Payment Agent
- *
- * Features:
- * - Generate Invoice (payment request)
- * - Verify on-chain payment
- * - Generate wallet deep link
- */
-
-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);
-    /**
-     * Generate payment request（Invoice）
-     */
-    createInvoice(params: CreateInvoiceParams): Invoice;
-    /**
-     * 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>;
-    /**
-     * Format Invoice as human-readable message
-     */
-    formatInvoiceMessage(invoice: Invoice, includeJson?: boolean): string;
-}
-
-/**
- * AgentWallet - Zero-config wallet for AI Agents
- *
- * Design principles:
- * - Auto-initialize on first use (no manual setup)
- * - Generate address locally (no gas needed)
- * - Owner authorizes via Permit (can be CLI or UI)
- * - Agent only needs gas when actually spending
- */
-
-interface OwnerPermit {
-    owner: string;
-    value: string;
-    deadline: number;
-    nonce: number;
-    v: number;
-    r: string;
-    s: string;
-}
-interface AgentWalletConfig {
-    /** Storage directory for wallet data (default: ~/.moltspay) */
-    storageDir?: string;
-    /** Chain to use */
-    chain?: ChainName;
-    /** Custom RPC URL */
-    rpcUrl?: string;
-}
-interface SpendResult {
-    success: boolean;
-    txHash?: string;
-    error?: string;
-    from: string;
-    to: string;
-    amount: number;
-    remainingAllowance?: string;
-    explorerUrl?: string;
-}
-declare class AgentWallet {
-    readonly chain: ChainName;
-    readonly chainConfig: ChainConfig;
-    readonly storageDir: string;
-    private _address;
-    private _privateKey;
-    private _wallet;
-    private _provider;
-    private _permits;
-    constructor(config?: AgentWalletConfig);
-    private getDefaultStorageDir;
-    private getWalletPath;
-    private getPermitsPath;
-    /**
-     * Auto-initialize: create wallet if not exists
-     * This is called automatically in constructor
-     */
-    private ensureInitialized;
-    /** Agent's address (auto-generated on first use) */
-    get address(): string;
-    private get wallet();
-    private get provider();
-    /**
-     * Store a Permit from Owner
-     */
-    storePermit(permit: OwnerPermit): void;
-    /**
-     * Get stored permit for an owner
-     */
-    getPermit(owner: string): OwnerPermit | undefined;
-    /**
-     * Check allowance from an owner
-     */
-    checkAllowance(owner: string): Promise<{
-        allowance: string;
-        ownerBalance: string;
-        canSpend: boolean;
-    }>;
-    /**
-     * Spend USDC from Owner's wallet
-     *
-     * @param to - Recipient (service provider)
-     * @param amount - Amount in USDC
-     * @param permit - Optional, uses stored permit if not provided
-     */
-    spend(to: string, amount: number, permit?: OwnerPermit): Promise<SpendResult>;
-    /**
-     * Get USDC balance
-     */
-    getBalance(): Promise<{
-        usdc: string;
-        eth: string;
-    }>;
-    /**
-     * Transfer USDC to a recipient (direct payment)
-     *
-     * This is the simplest payment method - Agent pays directly from its wallet.
-     * Requires Agent wallet to have USDC (funded by Owner).
-     *
-     * @example
-     * ```typescript
-     * const wallet = new AgentWallet({ chain: 'base' });
-     *
-     * // Check balance
-     * const balance = await wallet.getBalance();
-     * console.log('USDC:', balance.usdc);
-     *
-     * // Pay for service
-     * const result = await wallet.transfer({
-     *   to: '0xServiceProvider...',
-     *   amount: 0.99
-     * });
-     * console.log('Tx:', result.txHash);
-     * ```
-     */
-    transfer(params: {
-        to: string;
-        amount: number;
-    }): Promise<{
-        success: boolean;
-        txHash?: string;
-        error?: string;
-        from?: string;
-        to?: string;
-        amount?: number;
-        explorerUrl?: string;
-    }>;
-    /**
-     * Pay for a service (transfer USDC to service provider)
-     *
-     * This is the main method for Agent-to-Agent payments.
-     * Returns payment data ready to submit to service API.
-     *
-     * @example
-     * ```typescript
-     * const wallet = new AgentWallet({ chain: 'base' });
-     *
-     * // Pay for Zen7 video service
-     * const payment = await wallet.payService({
-     *   provider: '0xb8d6f2441e8f8dfB6288A74Cf73804cDd0484E0C',
-     *   amount: 0.99,
-     *   service: 'video_generation'
-     * });
-     *
-     * if (payment.success) {
-     *   // Submit to service API
-     *   await fetch('/v1/video/generate', {
-     *     body: JSON.stringify({
-     *       prompt: "...",
-     *       payment: payment.paymentData  // Ready to use!
-     *     })
-     *   });
-     * }
-     * ```
-     */
-    payService(params: {
-        provider: string;
-        amount: number;
-        service?: string;
-    }): Promise<{
-        success: boolean;
-        txHash?: string;
-        error?: string;
-        paymentData?: {
-            method: 'transfer';
-            chain: string;
-            tx_hash: string;
-        };
-        explorerUrl?: string;
-    }>;
-    /**
-     * Get gas balance (ETH needed for transactions)
-     */
-    getGasBalance(): Promise<string>;
-    /**
-     * Check if agent has enough gas
-     */
-    hasGas(minEth?: number): Promise<boolean>;
-    /**
-     * Generate authorization request for Owner
-     * Owner can sign this with CLI (ethers) or MetaMask
-     */
-    generateAuthRequest(params: {
-        ownerAddress: string;
-        amount: number;
-        expiresInHours?: number;
-    }): Promise<{
-        message: string;
-        typedData: object;
-        cliCommand: string;
-    }>;
-}
-/**
- * Quick helper to get agent address (auto-initializes if needed)
- */
-declare function getAgentAddress(config?: AgentWalletConfig): string;
-
-/**
- * AuditLog - Immutable Audit Log
- *
- * Features:
- * - Hash-chained, any modification breaks the chain
- * - Stored by date in separate files
- * - JSONL format for easy append and parse
- */
-
-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);
-    /**
-     * 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;
-        request_id: string;
-        from: string;
-        to: string;
-        startDate: Date;
-        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 - 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 - Request funding from Owner
-     */
-    guideFunding(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;
-    /**
-     * Offer Permit payment option
-     */
-    offerPermitPayment(params: {
-        service: string;
-        price: number;
-        sellerAddress: string;
-        chain?: ChainName;
-        invoiceId: string;
-    }): string;
-    /**
-     * Confirm Permit received, executing payment
-     */
-    executingPermit(invoiceId: string): string;
-    /**
-     * Permit payment successful
-     */
-    permitPaymentReceived(params: {
-        amount: number;
-        txHash: string;
-        invoiceId: string;
-    }): string;
-    /**
-     * Permit payment failed
-     */
-    permitPaymentFailed(error: string, invoiceId: string): 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 Report Funding Received
-     */
-    fundingReceived(amount: number): string;
-    /**
-     * 3.4 Request Funding from Owner
-     */
-    requestFunding(agentAddress: string, amount: number, reason?: string): 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;
-    /**
-     * Confirm willing to pay via Permit
-     */
-    confirmPermitPayment(): string;
-    /**
-     * Send signed Permit to Seller
-     */
-    sendPermit(params: {
-        permit: {
-            owner: string;
-            spender: string;
-            value: string;
-            deadline: number;
-            nonce: number;
-            v: number;
-            r: string;
-            s: string;
-        };
-        invoiceId: string;
-        amount: number;
-    }): string;
-    /**
-     * Simplified Permit message (compact JSON for agent parsing)
-     */
-    sendPermitCompact(params: {
-        permit: {
-            owner: string;
-            spender: string;
-            value: string;
-            deadline: number;
-            v: number;
-            r: string;
-            s: string;
-        };
-        invoiceId: string;
-    }): string;
-};
-declare const StatusMarkers: {
-    walletReady: string;
-    permitReady: (amount: number) => string;
-    permitSent: (invoiceId: string, amount: number) => string;
-    awaitingPermit: (invoiceId: string) => 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;
-
-/**
- * x402 Client - Easy HTTP client with automatic payment handling
- *
- * Wraps @x402/fetch to provide simple API for AI Agents.
- *
- * @example
- * ```typescript
- * import { createX402Client } from 'moltspay/x402';
- *
- * // Using local wallet (AgentWallet)
- * const client = await createX402Client({ chain: 'base' });
- *
- * // Using CDP wallet
- * const client = await createX402Client({ chain: 'base', useCDP: true });
- *
- * // Make request - payment handled automatically
- * const response = await client.fetch('https://juai8.com/zen7/v1/video/generate');
- * ```
- */
-
-interface X402ClientConfig {
-    /** Chain to use */
-    chain?: ChainName;
-    /** Use CDP wallet instead of local wallet */
-    useCDP?: boolean;
-    /** Custom private key (overrides stored wallet) */
-    privateKey?: string;
-    /** Storage directory for wallet */
-    storageDir?: string;
-}
-interface X402Client {
-    /** Fetch with automatic x402 payment handling */
-    fetch: (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
-    /** Wallet address */
-    address: string;
-    /** Chain being used */
-    chain: ChainName;
-}
-/**
- * Check if @x402/fetch is available
- */
-declare function isX402Available(): boolean;
-/**
- * Create x402 client
- *
- * Automatically handles 402 Payment Required responses.
- *
- * @example
- * ```typescript
- * import { createX402Client } from 'moltspay/x402';
- *
- * const client = await createX402Client({ chain: 'base' });
- *
- * // Request paid API - payment handled automatically
- * const response = await client.fetch('https://juai8.com/zen7/v1/video/generate', {
- *   method: 'POST',
- *   headers: { 'Content-Type': 'application/json' },
- *   body: JSON.stringify({ prompt: 'a cat dancing' })
- * });
- *
- * const result = await response.json();
- * ```
- */
-declare function createX402Client(config?: X402ClientConfig): Promise<X402Client>;
-/**
- * Simple one-shot x402 request
- *
- * For when you just need to make one paid request.
- *
- * @example
- * ```typescript
- * import { x402Fetch } from 'moltspay/x402';
- *
- * const response = await x402Fetch('https://juai8.com/zen7/v1/video/generate', {
- *   method: 'POST',
- *   body: JSON.stringify({ prompt: 'a cat dancing' })
- * }, { chain: 'base' });
- * ```
- */
-declare function x402Fetch(input: string | URL | Request, init?: RequestInit, config?: X402ClientConfig): Promise<Response>;
-
-/**
- * x402 Protocol Support for MoltsPay
- *
- * x402 is an open standard for HTTP-native payments.
- * When a server returns 402 Payment Required, the client can pay and retry.
- *
- * @see https://x402.org
- * @see https://github.com/coinbase/x402
- */
-
-declare const X402_VERSION = 2;
-declare const PAYMENT_REQUIRED_HEADER = "x-payment-required";
-declare const PAYMENT_HEADER = "x-payment";
-declare const PAYMENT_RESPONSE_HEADER = "x-payment-response";
-/**
- * x402 Payment Requirements (from server 402 response)
- */
-interface X402PaymentRequirements {
-    /** Scheme (e.g., "exact") */
-    scheme: string;
-    /** Network (e.g., "eip155:8453" for Base) */
-    network: string;
-    /** Maximum amount in base units (e.g., "990000" for 0.99 USDC) */
-    maxAmountRequired: string;
-    /** Payee address */
-    resource: string;
-    /** Payment description */
-    description?: string;
-    /** MIME type of the resource */
-    mimeType?: string;
-    /** Output schema for the resource */
-    outputSchema?: unknown;
-    /** Expiration timestamp */
-    expiration?: number;
-    /** Extra data */
-    extra?: string;
-}
-/**
- * x402 Payment Payload (client sends to server)
- */
-interface X402PaymentPayload {
-    /** x402 protocol version */
-    x402Version: number;
-    /** Scheme used */
-    scheme: string;
-    /** Network used */
-    network: string;
-    /** Scheme-specific payload */
-    payload: unknown;
-}
-/**
- * Parse x402 Payment Required header from 402 response
- */
-declare function parsePaymentRequired(header: string): X402PaymentRequirements[];
-/**
- * Encode payment payload for x-payment header
- */
-declare function encodePaymentPayload(payload: X402PaymentPayload): string;
-/**
- * Convert chain name to x402 network identifier
- */
-declare function chainToNetwork(chain: ChainName): string;
-/**
- * Convert x402 network identifier to chain name
- */
-declare function networkToChain(network: string): ChainName | null;
-/**
- * EIP-3009 Authorization for USDC transferWithAuthorization
- */
-interface EIP3009Authorization {
-    from: string;
-    to: string;
-    value: string;
-    validAfter: string;
-    validBefore: string;
-    nonce: string;
-}
-/**
- * Sign EIP-3009 transferWithAuthorization
- * Used for x402 "exact" scheme with USDC
- */
-declare function signEIP3009(wallet: ethers.Wallet, params: {
-    to: string;
-    amount: number;
-    validAfter?: number;
-    validBefore?: number;
-    chain: ChainName;
-}): Promise<{
-    authorization: EIP3009Authorization;
-    signature: string;
-}>;
-/**
- * Create x402 payment payload for "exact" scheme on EVM
- */
-declare function createExactEvmPayload(wallet: ethers.Wallet, requirements: X402PaymentRequirements, chain: ChainName): Promise<X402PaymentPayload>;
-/**
- * Wrap fetch to handle x402 402 responses automatically
- *
- * @example
- * ```typescript
- * import { AgentWallet } from 'moltspay';
- * import { wrapFetchWith402 } from 'moltspay/x402';
- *
- * const wallet = new AgentWallet({ chain: 'base' });
- * const fetch402 = wrapFetchWith402(fetch, wallet);
- *
- * // Automatically handles 402 and pays
- * const response = await fetch402('https://api.example.com/paid-resource');
- * ```
- */
-declare function wrapFetchWith402(fetchFn: typeof fetch, wallet: {
-    address: string;
-    chain: ChainName;
-}, privateKey: string): (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
-/**
- * Server-side: Generate x402 Payment Required response
- */
-declare function createPaymentRequiredResponse(requirements: X402PaymentRequirements[]): {
-    status: 402;
-    headers: Record<string, string>;
-};
-/**
- * Server-side: Verify x402 payment header
- */
-declare function verifyPaymentHeader(header: string, expectedRecipient: string, expectedAmount: number): {
-    valid: boolean;
-    error?: string;
-    payload?: X402PaymentPayload;
-};
-
-/**
- * CDP (Coinbase Developer Platform) Wallet Integration
- *
- * Creates and manages wallets via Coinbase's CDP SDK.
- * These wallets are hosted by Coinbase, making them easy to use for AI Agents.
- *
- * @see https://docs.cdp.coinbase.com/
- */
-
-interface CDPWalletConfig {
-    /** Storage directory (default: ~/.moltspay) */
-    storageDir?: string;
-    /** Chain name */
-    chain?: ChainName;
-    /** CDP API credentials (or use env vars) */
-    apiKeyId?: string;
-    apiKeySecret?: string;
-    walletSecret?: string;
-}
-interface CDPWalletData {
-    /** Wallet address */
-    address: string;
-    /** CDP wallet ID */
-    walletId: string;
-    /** Chain */
-    chain: ChainName;
-    /** Created timestamp */
-    createdAt: string;
-    /** CDP account data (for restoration) */
-    accountData?: string;
-}
-interface CDPInitResult {
-    success: boolean;
-    address?: string;
-    walletId?: string;
-    isNew?: boolean;
-    error?: string;
-    storagePath?: string;
-}
-/**
- * Check if CDP SDK is available
- */
-declare function isCDPAvailable(): boolean;
-/**
- * Initialize CDP wallet
- *
- * Creates a new CDP wallet or loads existing one.
- *
- * @example
- * ```bash
- * # Set credentials
- * export CDP_API_KEY_ID=your-key-id
- * export CDP_API_KEY_SECRET=your-key-secret
- *
- * # Initialize
- * npx moltspay init --cdp --chain base
- * ```
- */
-declare function initCDPWallet(config?: CDPWalletConfig): Promise<CDPInitResult>;
-/**
- * Load existing CDP wallet
- */
-declare function loadCDPWallet(config?: CDPWalletConfig): CDPWalletData | null;
-/**
- * Get CDP wallet address (quick check without full init)
- */
-declare function getCDPWalletAddress(storageDir?: string): string | null;
-/**
- * CDP Wallet class for making payments
- *
- * Uses CDP SDK for wallet operations with x402 support.
- */
-declare class CDPWallet {
-    readonly address: string;
-    readonly chain: ChainName;
-    readonly chainConfig: ReturnType<typeof getChain>;
-    private storageDir;
-    constructor(config?: CDPWalletConfig);
-    /**
-     * Get USDC balance
-     */
-    getBalance(): Promise<{
-        usdc: string;
-        eth: string;
-    }>;
-    /**
-     * Transfer USDC to a recipient
-     *
-     * Requires CDP SDK and credentials to sign transactions.
-     */
-    transfer(params: {
-        to: string;
-        amount: number;
-    }): Promise<{
-        success: boolean;
-        txHash?: string;
-        error?: string;
-        explorerUrl?: string;
-    }>;
-    /**
-     * Create viem-compatible signer for x402
-     *
-     * This allows using CDP wallet with x402 protocol.
-     */
-    getViemAccount(): Promise<unknown>;
-}
-
-/**
- * Deferred Payment Types
- *
- * Supports credit-based, milestone, and subscription payment models
- * for trusted Agent-to-Agent transactions.
- */
-
-interface CreditAccount {
-    /** Unique account identifier */
-    accountId: string;
-    /** Buyer/debtor address or identifier */
-    buyerId: string;
-    /** Seller/creditor address */
-    sellerId: string;
-    /** Credit limit in USDC */
-    creditLimit: number;
-    /** Current balance owed (positive = buyer owes seller) */
-    balance: number;
-    /** Account status */
-    status: CreditAccountStatus;
-    /** Settlement chain */
-    chain: ChainName;
-    /** Payment terms */
-    terms: PaymentTerms;
-    /** Account creation time */
-    createdAt: string;
-    /** Last activity time */
-    updatedAt: string;
-    /** Transaction history */
-    transactions: CreditTransaction[];
-    /** Optional metadata */
-    metadata?: Record<string, unknown>;
-}
-type CreditAccountStatus = 'active' | 'suspended' | 'closed' | 'pending';
-interface PaymentTerms {
-    /** Net days for payment (e.g., 30 = Net-30) */
-    netDays: number;
-    /** Grace period after due date before suspension */
-    graceDays: number;
-    /** Settlement frequency: on-demand, daily, weekly, monthly */
-    settlementFrequency: SettlementFrequency;
-    /** Minimum balance to trigger auto-settlement */
-    autoSettleThreshold?: number;
-    /** Late fee percentage (optional) */
-    lateFeePercent?: number;
-}
-type SettlementFrequency = 'on-demand' | 'daily' | 'weekly' | 'monthly';
-interface CreditTransaction {
-    /** Transaction ID */
-    txId: string;
-    /** Transaction type */
-    type: CreditTransactionType;
-    /** Amount (positive for charges, negative for payments/credits) */
-    amount: number;
-    /** Running balance after this transaction */
-    balanceAfter: number;
-    /** Reference (order ID, service name, etc.) */
-    reference: string;
-    /** Optional on-chain tx hash for settlements */
-    onChainTxHash?: string;
-    /** Transaction time */
-    timestamp: string;
-    /** Notes */
-    notes?: string;
-}
-type CreditTransactionType = 'charge' | 'payment' | 'credit' | 'adjustment' | 'late_fee' | 'refund';
-interface DeferredPayment {
-    /** Payment ID */
-    paymentId: string;
-    /** Associated credit account (if using credit) */
-    accountId?: string;
-    /** Order/service ID */
-    orderId: string;
-    /** Service description */
-    service: string;
-    /** Total amount */
-    amount: number;
-    /** Amount paid so far */
-    paidAmount: number;
-    /** Payment status */
-    status: DeferredPaymentStatus;
-    /** Due date (ISO string) */
-    dueDate: string;
-    /** Settlement chain */
-    chain: ChainName;
-    /** Buyer identifier */
-    buyerId: string;
-    /** Seller address */
-    sellerAddress: string;
-    /** Payment plan (for installments) */
-    plan?: PaymentPlan;
-    /** Creation time */
-    createdAt: string;
-    /** Last update time */
-    updatedAt: string;
-    /** Settlement transactions */
-    settlements: Settlement[];
-    /** Optional metadata */
-    metadata?: Record<string, unknown>;
-}
-type DeferredPaymentStatus = 'pending' | 'partial' | 'paid' | 'overdue' | 'settled' | 'cancelled' | 'disputed';
-interface PaymentPlan {
-    /** Plan type */
-    type: 'fixed' | 'milestone' | 'subscription';
-    /** Total installments */
-    totalInstallments: number;
-    /** Completed installments */
-    completedInstallments: number;
-    /** Installment schedule */
-    schedule: Installment[];
-}
-interface Installment {
-    /** Installment number (1-based) */
-    number: number;
-    /** Amount for this installment */
-    amount: number;
-    /** Due date */
-    dueDate: string;
-    /** Status */
-    status: 'pending' | 'paid' | 'overdue';
-    /** Settlement tx hash (if paid) */
-    txHash?: string;
-    /** Milestone description (for milestone-based) */
-    milestone?: string;
-}
-interface Settlement {
-    /** Settlement ID */
-    settlementId: string;
-    /** Amount settled */
-    amount: number;
-    /** On-chain transaction hash */
-    txHash: string;
-    /** Chain */
-    chain: ChainName;
-    /** Settlement time */
-    timestamp: string;
-    /** Verification status */
-    verified: boolean;
-}
-interface CreateCreditAccountParams {
-    buyerId: string;
-    sellerId: string;
-    creditLimit: number;
-    chain?: ChainName;
-    terms?: Partial<PaymentTerms>;
-    metadata?: Record<string, unknown>;
-}
-interface CreateDeferredPaymentParams {
-    accountId?: string;
-    orderId: string;
-    service: string;
-    amount: number;
-    buyerId: string;
-    sellerAddress: string;
-    chain?: ChainName;
-    dueInDays?: number;
-    plan?: Omit<PaymentPlan, 'completedInstallments'>;
-    metadata?: Record<string, unknown>;
-}
-interface RecordSettlementParams {
-    paymentId: string;
-    amount: number;
-    txHash: string;
-    chain?: ChainName;
-}
-interface DeferredPaymentStore {
-    createAccount(params: CreateCreditAccountParams): Promise<CreditAccount>;
-    getAccount(accountId: string): Promise<CreditAccount | null>;
-    getAccountByBuyer(buyerId: string, sellerId: string): Promise<CreditAccount | null>;
-    updateAccount(accountId: string, updates: Partial<CreditAccount>): Promise<CreditAccount>;
-    listAccounts(sellerId: string): Promise<CreditAccount[]>;
-    createPayment(params: CreateDeferredPaymentParams): Promise<DeferredPayment>;
-    getPayment(paymentId: string): Promise<DeferredPayment | null>;
-    updatePayment(paymentId: string, updates: Partial<DeferredPayment>): Promise<DeferredPayment>;
-    listPayments(filter: PaymentFilter): Promise<DeferredPayment[]>;
-    addTransaction(accountId: string, tx: Omit<CreditTransaction, 'txId' | 'timestamp'>): Promise<CreditTransaction>;
-}
-interface PaymentFilter {
-    accountId?: string;
-    buyerId?: string;
-    sellerId?: string;
-    status?: DeferredPaymentStatus | DeferredPaymentStatus[];
-    overdueOnly?: boolean;
-}
-
-/**
- * Deferred Payment Manager
- *
- * Manages credit accounts and deferred payments for Agent-to-Agent transactions.
- * Supports credit-based, milestone, and installment payment models.
- */
-
-interface DeferredPaymentManagerConfig {
-    /** Seller's wallet address for receiving payments */
-    sellerAddress: string;
-    /** Seller's identifier */
-    sellerId: string;
-    /** Default chain for payments */
-    chain?: ChainName;
-    /** Custom store implementation (defaults to MemoryDeferredStore) */
-    store?: DeferredPaymentStore;
-    /** Auto-verify settlements on-chain */
-    autoVerify?: boolean;
-}
-interface ChargeResult {
-    success: boolean;
-    payment?: DeferredPayment;
-    transaction?: CreditTransaction;
-    error?: string;
-    /** True if credit limit would be exceeded */
-    creditExceeded?: boolean;
-}
-interface SettlementResult {
-    success: boolean;
-    settlement?: Settlement;
-    payment?: DeferredPayment;
-    transaction?: CreditTransaction;
-    error?: string;
-}
-interface AccountSummary {
-    account: CreditAccount;
-    pendingPayments: DeferredPayment[];
-    overduePayments: DeferredPayment[];
-    availableCredit: number;
-    totalOwed: number;
-}
-declare class DeferredPaymentManager {
-    private config;
-    constructor(config: DeferredPaymentManagerConfig);
-    /**
-     * Create a new credit account for a buyer
-     */
-    createCreditAccount(params: {
-        buyerId: string;
-        creditLimit: number;
-        netDays?: number;
-        metadata?: Record<string, unknown>;
-    }): Promise<CreditAccount>;
-    /**
-     * Get or create a credit account for a buyer
-     */
-    getOrCreateAccount(params: {
-        buyerId: string;
-        creditLimit?: number;
-    }): Promise<CreditAccount>;
-    /**
-     * Get credit account by ID
-     */
-    getAccount(accountId: string): Promise<CreditAccount | null>;
-    /**
-     * Get credit account by buyer ID
-     */
-    getAccountByBuyer(buyerId: string): Promise<CreditAccount | null>;
-    /**
-     * Update credit limit
-     */
-    updateCreditLimit(accountId: string, newLimit: number): Promise<CreditAccount>;
-    /**
-     * Suspend an account
-     */
-    suspendAccount(accountId: string, reason?: string): Promise<CreditAccount>;
-    /**
-     * Reactivate a suspended account
-     */
-    reactivateAccount(accountId: string): Promise<CreditAccount>;
-    /**
-     * Get account summary with pending/overdue payments
-     */
-    getAccountSummary(accountId: string): Promise<AccountSummary | null>;
-    /**
-     * List all credit accounts for this seller
-     */
-    listAccounts(): Promise<CreditAccount[]>;
-    /**
-     * Charge a service to a credit account (deferred payment)
-     */
-    charge(params: {
-        buyerId: string;
-        orderId: string;
-        service: string;
-        amount: number;
-        dueInDays?: number;
-        metadata?: Record<string, unknown>;
-    }): Promise<ChargeResult>;
-    /**
-     * Create a deferred payment without a credit account (standalone)
-     */
-    createDeferredPayment(params: CreateDeferredPaymentParams): Promise<DeferredPayment>;
-    /**
-     * Get deferred payment by ID
-     */
-    getPayment(paymentId: string): Promise<DeferredPayment | null>;
-    /**
-     * List deferred payments with filters
-     */
-    listPayments(filter?: PaymentFilter): Promise<DeferredPayment[]>;
-    /**
-     * Get overdue payments
-     */
-    getOverduePayments(): Promise<DeferredPayment[]>;
-    /**
-     * Record a settlement (payment received)
-     */
-    recordSettlement(params: RecordSettlementParams): Promise<SettlementResult>;
-    /**
-     * Settle all pending charges for an account
-     */
-    settleAccount(accountId: string, txHash: string): Promise<SettlementResult>;
-    /**
-     * Issue a credit (reduce balance owed)
-     */
-    issueCredit(params: {
-        accountId: string;
-        amount: number;
-        reason: string;
-    }): Promise<CreditTransaction>;
-    /**
-     * Issue a refund
-     */
-    issueRefund(params: {
-        paymentId: string;
-        amount: number;
-        reason: string;
-    }): Promise<SettlementResult>;
-    /**
-     * Mark overdue payments
-     */
-    markOverduePayments(): Promise<DeferredPayment[]>;
-    /**
-     * Apply late fees to overdue accounts
-     */
-    applyLateFees(): Promise<CreditTransaction[]>;
-}
-
-/**
- * In-Memory Store for Deferred Payments
- *
- * Suitable for testing and single-process deployments.
- * For production, implement DeferredPaymentStore with persistent storage.
- */
-
-declare class MemoryDeferredStore implements DeferredPaymentStore {
-    private accounts;
-    private payments;
-    private buyerSellerIndex;
-    private makeKey;
-    createAccount(params: CreateCreditAccountParams): Promise<CreditAccount>;
-    getAccount(accountId: string): Promise<CreditAccount | null>;
-    getAccountByBuyer(buyerId: string, sellerId: string): Promise<CreditAccount | null>;
-    updateAccount(accountId: string, updates: Partial<CreditAccount>): Promise<CreditAccount>;
-    listAccounts(sellerId: string): Promise<CreditAccount[]>;
-    createPayment(params: CreateDeferredPaymentParams): Promise<DeferredPayment>;
-    getPayment(paymentId: string): Promise<DeferredPayment | null>;
-    updatePayment(paymentId: string, updates: Partial<DeferredPayment>): Promise<DeferredPayment>;
-    listPayments(filter: PaymentFilter): Promise<DeferredPayment[]>;
-    addTransaction(accountId: string, tx: Omit<CreditTransaction, 'txId' | 'timestamp'>): Promise<CreditTransaction>;
-    /**
-     * Get all data (for debugging/export)
-     */
-    export(): {
-        accounts: CreditAccount[];
-        payments: DeferredPayment[];
-    };
-    /**
-     * Import data (for restore)
-     */
-    import(data: {
-        accounts: CreditAccount[];
-        payments: DeferredPayment[];
-    }): void;
-    /**
-     * Clear all data
-     */
-    clear(): void;
-}
-
-/**
- * JSON File-based Store for Deferred Payments
- *
- * Persists deferred payment data to a JSON file.
- * Suitable for single-process production deployments.
- *
- * For multi-process or distributed systems, implement DeferredPaymentStore
- * with a proper database (PostgreSQL, Redis, etc.).
- */
-
-interface JsonDeferredStoreConfig {
-    /** Path to the JSON file */
-    filePath: string;
-    /** Auto-save after each write operation (default: true) */
-    autoSave?: boolean;
-    /** Pretty print JSON (default: true) */
-    prettyPrint?: boolean;
-}
-declare class JsonDeferredStore implements DeferredPaymentStore {
-    private memory;
-    private config;
-    private dirty;
-    constructor(config: JsonDeferredStoreConfig);
-    /**
-     * Load data from file
-     */
-    load(): void;
-    /**
-     * Save data to file
-     */
-    save(): void;
-    /**
-     * Mark as dirty and optionally auto-save
-     */
-    private markDirty;
-    /**
-     * Check if there are unsaved changes
-     */
-    isDirty(): boolean;
-    createAccount(params: CreateCreditAccountParams): Promise<CreditAccount>;
-    getAccount(accountId: string): Promise<CreditAccount | null>;
-    getAccountByBuyer(buyerId: string, sellerId: string): Promise<CreditAccount | null>;
-    updateAccount(accountId: string, updates: Partial<CreditAccount>): Promise<CreditAccount>;
-    listAccounts(sellerId: string): Promise<CreditAccount[]>;
-    createPayment(params: CreateDeferredPaymentParams): Promise<DeferredPayment>;
-    getPayment(paymentId: string): Promise<DeferredPayment | null>;
-    updatePayment(paymentId: string, updates: Partial<DeferredPayment>): Promise<DeferredPayment>;
-    listPayments(filter: PaymentFilter): Promise<DeferredPayment[]>;
-    addTransaction(accountId: string, tx: Omit<CreditTransaction, 'txId' | 'timestamp'>): Promise<CreditTransaction>;
-    /**
-     * Export all data
-     */
-    export(): {
-        accounts: CreditAccount[];
-        payments: DeferredPayment[];
-    };
-    /**
-     * Clear all data (including file)
-     */
-    clear(): void;
-}
-
-/**
- * Deferred Payment Conversation Templates
- *
- * Natural language templates for Agent-to-Agent deferred payment flows.
- */
-
-declare const DeferredStatusMarkers: {
-    creditAccountCreated: (accountId: string, limit: number) => string;
-    chargeAdded: (paymentId: string, amount: number) => string;
-    settlementReceived: (paymentId: string, txHash: string, amount: number) => string;
-    accountSettled: (accountId: string, txHash: string, amount: number) => string;
-    creditIssued: (accountId: string, amount: number) => string;
-    accountSuspended: (accountId: string, reason: string) => string;
-    paymentOverdue: (paymentId: string, amount: number) => string;
-};
-declare const DeferredSellerTemplates: {
-    /**
-     * Offer deferred payment option
-     */
-    offerDeferredPayment: (params: {
-        service: string;
-        price: number;
-        netDays?: number;
-    }) => string;
-    /**
-     * Explain credit account setup
-     */
-    explainCreditAccount: () => string;
-    /**
-     * Confirm credit account creation
-     */
-    creditAccountCreated: (account: CreditAccount) => string;
-    /**
-     * Charge confirmation
-     */
-    chargeConfirmation: (payment: DeferredPayment, availableCredit: number) => string;
-    /**
-     * Credit limit exceeded
-     */
-    creditLimitExceeded: (params: {
-        requested: number;
-        available: number;
-        balance: number;
-        limit: number;
-    }) => string;
-    /**
-     * Account summary/statement
-     */
-    accountStatement: (summary: AccountSummary) => string;
-    /**
-     * Settlement confirmation
-     */
-    settlementConfirmation: (params: {
-        amount: number;
-        txHash: string;
-        newBalance: number;
-        paymentId?: string;
-    }) => string;
-    /**
-     * Overdue notice
-     */
-    overdueNotice: (payments: DeferredPayment[]) => string;
-    /**
-     * Credit issued confirmation
-     */
-    creditIssued: (params: {
-        amount: number;
-        reason: string;
-        newBalance: number;
-        accountId: string;
-    }) => string;
-};
-declare const DeferredBuyerTemplates: {
-    /**
-     * Request deferred payment
-     */
-    requestDeferredPayment: (service: string) => string;
-    /**
-     * Accept credit account offer
-     */
-    acceptCreditAccount: () => string;
-    /**
-     * Request credit limit increase
-     */
-    requestCreditIncrease: (currentLimit: number, requestedLimit: number) => string;
-    /**
-     * Request account statement
-     */
-    requestStatement: () => string;
-    /**
-     * Announce settlement payment
-     */
-    announceSettlement: (params: {
-        amount: number;
-        txHash: string;
-        accountId?: string;
-    }) => string;
-    /**
-     * Dispute a charge
-     */
-    disputeCharge: (paymentId: string, reason: string) => string;
-};
-interface ParsedDeferredStatus {
-    type: string;
-    data: Record<string, string>;
-}
-declare function parseDeferredStatusMarker(text: string): ParsedDeferredStatus | null;
-
-export { type AccountSummary, AgentWallet, AuditAction, AuditEntry, AuditLog, BuyerTemplates, type CDPInitResult, CDPWallet, type CDPWalletConfig, type CDPWalletData, ChainConfig, ChainName, type ChargeResult, type CreateCreditAccountParams, type CreateDeferredPaymentParams, CreateInvoiceParams, type CreditAccount, type CreditAccountStatus, type CreditTransaction, type CreditTransactionType, DeferredBuyerTemplates, type DeferredPayment, DeferredPaymentManager, type DeferredPaymentManagerConfig, type DeferredPaymentStatus, type DeferredPaymentStore, DeferredSellerTemplates, DeferredStatusMarkers, type EIP3009Authorization, type Installment, Invoice, JsonDeferredStore, type JsonDeferredStoreConfig, MemoryDeferredStore, PAYMENT_HEADER, PAYMENT_REQUIRED_HEADER, PAYMENT_RESPONSE_HEADER, type ParsedDeferredStatus, PaymentAgent, PaymentAgentConfig, type PaymentFilter, type PaymentPlan, type PaymentTerms, type Receipt, type ReceiptParams, type RecordSettlementParams, SellerTemplates, type Settlement, type SettlementFrequency, type SettlementResult, StatusMarkers, VerifyOptions, VerifyResult, WalletBalance, type X402Client, type X402ClientConfig, type X402PaymentPayload, type X402PaymentRequirements, X402_VERSION, chainToNetwork, createExactEvmPayload, createPaymentRequiredResponse, createX402Client, encodePaymentPayload, formatReceiptJson, formatReceiptMessage, formatReceiptText, generateReceipt, generateReceiptFromInvoice, getAgentAddress, getCDPWalletAddress, getChain, initCDPWallet, isCDPAvailable, isX402Available, loadCDPWallet, networkToChain, parseDeferredStatusMarker, parsePaymentRequired, parseStatusMarker, signEIP3009, verifyPaymentHeader, wrapFetchWith402, x402Fetch };
+export { CDPWallet, getCDPWalletAddress, initCDPWallet, isCDPAvailable, loadCDPWallet } from './cdp/index.js';
+import './index-Dg8n6wdW.js';