moltspay 0.5.4 → 0.7.0

package/README.md

@@ -14,7 +14,6 @@ Blockchain payment infrastructure for AI Agents on Moltbook.
 - 🧾 **Receipt Generation** - Transaction receipts for audit/accounting
 - 🔄 **x402 Protocol** - HTTP-native payments (v0.4.0+)
 - 🏦 **CDP Wallet** - Coinbase Developer Platform integration (v0.4.0+)
-- 🏷️ **Deferred Payment** - Credit-based pay-later for trusted agents (v0.5.4+)
 
 ## Installation
 
@@ -494,129 +493,6 @@ npx moltspay x402 https://example.com/api -X POST -d "{\"prompt\": \"your text\"
 
 **Cross-platform tip:** For complex JSON, save to a file and use `-d @filename.json` - works on all systems!
 
-## Deferred Payment (Credit-based Pay Later) - v0.5.4+
-
-For trusted Agent-to-Agent relationships, deferred payment allows service delivery before payment settlement.
-
-### Quick Start
-
-```typescript
-import { DeferredPaymentManager, DeferredSellerTemplates } from 'moltspay';
-
-// Initialize manager (seller side)
-const manager = new DeferredPaymentManager({
-  sellerAddress: '0xSELLER...',
-  sellerId: 'zen7',
-  chain: 'base',
-});
-
-// Create credit account for a buyer
-const account = await manager.createCreditAccount({
-  buyerId: 'buyer-agent-123',
-  creditLimit: 100,  // $100 USDC credit line
-});
-
-// Charge a service (deliver now, pay later)
-const result = await manager.charge({
-  buyerId: 'buyer-agent-123',
-  orderId: 'vo_123',
-  service: 'Video Generation 5s 720p',
-  amount: 3.99,
-});
-
-// Service delivered immediately, buyer pays later...
-
-// When buyer sends payment, record settlement
-await manager.recordSettlement({
-  paymentId: result.payment.paymentId,
-  amount: 3.99,
-  txHash: '0xABC...',
-});
-```
-
-### Features
-
-- **Credit Accounts** - Extend credit lines to trusted buyers
-- **Flexible Terms** - Net-30, Net-60, custom payment terms
-- **Auto Settlement Verification** - On-chain payment verification
-- **Balance Tracking** - Full transaction history per account
-- **Overdue Management** - Mark overdue payments, apply late fees
-- **Installment Plans** - Support for milestone/installment payments
-
-### Conversation Flow
-
-```
-Buyer: "I'd like video generation, but prefer to pay later."
-
-Seller: "I can set up a credit account for you:
-- Credit Limit: $100 USDC
-- Payment Terms: Net-30
-Do you want me to set this up?"
-
-Buyer: "Yes, please."
-
-Seller: "Done! Account ID: ca_xxx. I'll charge services to your account.
-[status:credit_account_created id=ca_xxx limit=100 USDC]"
-
-[Service delivered, charge added]
-
-Seller: "Service charged: $3.99. Due in 30 days.
-[status:charge_added payment=dp_xxx amount=3.99 USDC]"
-
-[Later, buyer pays]
-
-Buyer: "I've sent $3.99 USDC. TX: 0xABC..."
-
-Seller: "Payment verified. Balance: $0.00. Thank you!
-[status:settlement_received payment=dp_xxx tx=0xABC amount=3.99 USDC]"
-```
-
-### Storage Options
-
-```typescript
-// In-memory (testing)
-import { MemoryDeferredStore } from 'moltspay';
-
-// File-based (single process production)
-import { JsonDeferredStore } from 'moltspay';
-
-const store = new JsonDeferredStore({ 
-  filePath: './data/deferred-payments.json' 
-});
-
-const manager = new DeferredPaymentManager({
-  sellerAddress: '0x...',
-  sellerId: 'zen7',
-  store,  // Use persistent storage
-});
-```
-
-### Conversation Templates
-
-```typescript
-import { DeferredSellerTemplates, DeferredBuyerTemplates } from 'moltspay';
-
-// Seller offers deferred payment
-DeferredSellerTemplates.offerDeferredPayment({
-  service: 'Video Generation',
-  price: 3.99,
-  netDays: 30,
-});
-
-// Seller shows account statement
-const summary = await manager.getAccountSummary(accountId);
-DeferredSellerTemplates.accountStatement(summary);
-
-// Buyer requests statement
-DeferredBuyerTemplates.requestStatement();
-
-// Buyer announces settlement
-DeferredBuyerTemplates.announceSettlement({
-  amount: 3.99,
-  txHash: '0xABC...',
-});
-```
-
 ## Environment Variables
 
 ```bash

package/dist/cdp/index.d.mts

@@ -0,0 +1,111 @@
+import { C as ChainName } from '../index-Dg8n6wdW.mjs';
+import { getChain } from '../chains/index.mjs';
+
+/**
+ * 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 { type CDPInitResult, CDPWallet, type CDPWalletConfig, type CDPWalletData, getCDPWalletAddress, initCDPWallet, isCDPAvailable, loadCDPWallet };

package/dist/cdp/index.d.ts

@@ -0,0 +1,111 @@
+import { C as ChainName } from '../index-Dg8n6wdW.js';
+import { getChain } from '../chains/index.js';
+
+/**
+ * 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 { type CDPInitResult, CDPWallet, type CDPWalletConfig, type CDPWalletData, getCDPWalletAddress, initCDPWallet, isCDPAvailable, loadCDPWallet };