moltspay 0.3.0 → 0.4.1

package/dist/index.d.mts

@@ -5,7 +5,8 @@ export { PermitPayment } from './permit/index.mjs';
 export { CreateOrderParams, MemoryOrderStore, Order, OrderManager, OrderStatus, OrderStore } from './orders/index.mjs';
 export { VerifyPaymentParams, VerifyPaymentResult, getTransactionStatus, verifyPayment, waitForTransaction } from './verify/index.mjs';
 export { PaymentGuideParams, extractTransactionHash, generatePaymentGuide, generatePaymentReminder, generateWalletGuide, hasTransactionHash } from './guide/index.mjs';
-export { CHAINS, ERC20_ABI, getChain, getChainById, listChains } from './chains/index.mjs';
+import { getChain } from './chains/index.mjs';
+export { CHAINS, ERC20_ABI, getChainById, listChains } from './chains/index.mjs';
 import { ethers } from 'ethers';
 
 /**
@@ -616,6 +617,87 @@ declare function parseStatusMarker(message: 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/x402pay');
+ * ```
+ */
+
+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/x402pay', {
+ *   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/x402pay', {
+ *   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
  *
@@ -746,4 +828,111 @@ declare function verifyPaymentHeader(header: string, expectedRecipient: string,
     payload?: X402PaymentPayload;
 };
 
-export { AgentWallet, AuditAction, AuditEntry, AuditLog, BuyerTemplates, ChainConfig, ChainName, CreateInvoiceParams, type EIP3009Authorization, Invoice, PAYMENT_HEADER, PAYMENT_REQUIRED_HEADER, PAYMENT_RESPONSE_HEADER, PaymentAgent, PaymentAgentConfig, type Receipt, type ReceiptParams, SellerTemplates, StatusMarkers, VerifyOptions, VerifyResult, WalletBalance, type X402PaymentPayload, type X402PaymentRequirements, X402_VERSION, chainToNetwork, createExactEvmPayload, createPaymentRequiredResponse, encodePaymentPayload, formatReceiptJson, formatReceiptMessage, formatReceiptText, generateReceipt, generateReceiptFromInvoice, getAgentAddress, networkToChain, parsePaymentRequired, parseStatusMarker, signEIP3009, verifyPaymentHeader, wrapFetchWith402 };
+/**
+ * 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>;
+}
+
+export { AgentWallet, AuditAction, AuditEntry, AuditLog, BuyerTemplates, type CDPInitResult, CDPWallet, type CDPWalletConfig, type CDPWalletData, ChainConfig, ChainName, CreateInvoiceParams, type EIP3009Authorization, Invoice, PAYMENT_HEADER, PAYMENT_REQUIRED_HEADER, PAYMENT_RESPONSE_HEADER, PaymentAgent, PaymentAgentConfig, type Receipt, type ReceiptParams, SellerTemplates, 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, parsePaymentRequired, parseStatusMarker, signEIP3009, verifyPaymentHeader, wrapFetchWith402, x402Fetch };

package/dist/index.d.ts

@@ -5,7 +5,8 @@ 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';
 export { PaymentGuideParams, extractTransactionHash, generatePaymentGuide, generatePaymentReminder, generateWalletGuide, hasTransactionHash } from './guide/index.js';
-export { CHAINS, ERC20_ABI, getChain, getChainById, listChains } from './chains/index.js';
+import { getChain } from './chains/index.js';
+export { CHAINS, ERC20_ABI, getChainById, listChains } from './chains/index.js';
 import { ethers } from 'ethers';
 
 /**
@@ -616,6 +617,87 @@ declare function parseStatusMarker(message: 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/x402pay');
+ * ```
+ */
+
+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/x402pay', {
+ *   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/x402pay', {
+ *   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
  *
@@ -746,4 +828,111 @@ declare function verifyPaymentHeader(header: string, expectedRecipient: string,
     payload?: X402PaymentPayload;
 };
 
-export { AgentWallet, AuditAction, AuditEntry, AuditLog, BuyerTemplates, ChainConfig, ChainName, CreateInvoiceParams, type EIP3009Authorization, Invoice, PAYMENT_HEADER, PAYMENT_REQUIRED_HEADER, PAYMENT_RESPONSE_HEADER, PaymentAgent, PaymentAgentConfig, type Receipt, type ReceiptParams, SellerTemplates, StatusMarkers, VerifyOptions, VerifyResult, WalletBalance, type X402PaymentPayload, type X402PaymentRequirements, X402_VERSION, chainToNetwork, createExactEvmPayload, createPaymentRequiredResponse, encodePaymentPayload, formatReceiptJson, formatReceiptMessage, formatReceiptText, generateReceipt, generateReceiptFromInvoice, getAgentAddress, networkToChain, parsePaymentRequired, parseStatusMarker, signEIP3009, verifyPaymentHeader, wrapFetchWith402 };
+/**
+ * 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>;
+}
+
+export { AgentWallet, AuditAction, AuditEntry, AuditLog, BuyerTemplates, type CDPInitResult, CDPWallet, type CDPWalletConfig, type CDPWalletData, ChainConfig, ChainName, CreateInvoiceParams, type EIP3009Authorization, Invoice, PAYMENT_HEADER, PAYMENT_REQUIRED_HEADER, PAYMENT_RESPONSE_HEADER, PaymentAgent, PaymentAgentConfig, type Receipt, type ReceiptParams, SellerTemplates, 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, parsePaymentRequired, parseStatusMarker, signEIP3009, verifyPaymentHeader, wrapFetchWith402, x402Fetch };