clodds 1.1.0

package/dist/api/middleware.js

@@ -0,0 +1,315 @@
+"use strict";
+/**
+ * x402 Payment Middleware
+ *
+ * Handles HTTP 402 Payment Required flow:
+ * 1. Request arrives without payment
+ * 2. Return 402 with payment details
+ * 3. Client pays via x402 protocol
+ * 4. Client retries with payment proof
+ * 5. Verify payment and proceed
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createX402Middleware = createX402Middleware;
+exports.createExpressX402Middleware = createExpressX402Middleware;
+const crypto_1 = require("crypto");
+const logger_1 = require("../utils/logger");
+// =============================================================================
+// CONSTANTS
+// =============================================================================
+const DEFAULT_PRICING = {
+    basic: 0.05,
+    standard: 0.10,
+    complex: 0.25,
+    defaultTier: 'standard',
+    tokenDiscount: 0.2,
+};
+// USDC on Base
+const DEFAULT_TOKEN_ADDRESS = '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913';
+// Payment patterns for classification
+const BASIC_PATTERNS = [
+    /price|balance|check|show|get|list|view|display|what.*(?:is|are)/i,
+    /how much|status|info|details|lookup/i,
+];
+const COMPLEX_PATTERNS = [
+    /automat|schedul|recurring|trigger|webhook|alert/i,
+    /multi|batch|bulk|all.*positions|portfolio/i,
+    /copy.*trad|follow|mirror|signal/i,
+    /strateg|backtest|optimiz|analyz.*(?:all|portfolio)/i,
+];
+// =============================================================================
+// IMPLEMENTATION
+// =============================================================================
+function createX402Middleware(config = {}) {
+    const pricing = { ...DEFAULT_PRICING, ...config.pricing };
+    const tokenAddress = config.tokenAddress || DEFAULT_TOKEN_ADDRESS;
+    const network = config.network || 'base';
+    const cacheTtl = config.cacheTtl || 300000;
+    const cacheEnabled = config.cachePayments !== false;
+    // Payment cache: txHash -> { proof, timestamp }
+    const paymentCache = new Map();
+    // Stats
+    const stats = {
+        totalVerified: 0,
+        totalRevenue: 0,
+        cacheHits: 0,
+        cacheMisses: 0,
+        failedVerifications: 0,
+    };
+    // Get treasury wallet from env or config
+    function getPaymentAddress() {
+        // First check env var (recommended for production)
+        const envTreasury = process.env.CLODDS_TREASURY_WALLET;
+        if (envTreasury && envTreasury.startsWith('0x')) {
+            return envTreasury;
+        }
+        // Fall back to config
+        if (config.privateKey) {
+            const hash = (0, crypto_1.createHash)('sha256').update(config.privateKey).digest('hex');
+            return `0x${hash.slice(0, 40)}`;
+        }
+        // No treasury configured - will reject payments
+        throw new Error('CLODDS_TREASURY_WALLET env var not set');
+    }
+    function getPrice(tier) {
+        return pricing[tier] || pricing.standard;
+    }
+    function classifyPrompt(prompt) {
+        const normalized = prompt.toLowerCase().trim();
+        // Check for complex patterns first (highest priority)
+        for (const pattern of COMPLEX_PATTERNS) {
+            if (pattern.test(normalized)) {
+                return 'complex';
+            }
+        }
+        // Check for basic patterns
+        for (const pattern of BASIC_PATTERNS) {
+            if (pattern.test(normalized)) {
+                // But if it also contains action words, upgrade to standard
+                if (/buy|sell|swap|trade|transfer|send|stake|unstake|claim|bridge/i.test(normalized)) {
+                    return 'standard';
+                }
+                return 'basic';
+            }
+        }
+        return pricing.defaultTier;
+    }
+    function getPaymentRequiredHeaders(amount, tier) {
+        const nonce = (0, crypto_1.randomBytes)(16).toString('hex');
+        const paymentAddress = getPaymentAddress();
+        return {
+            'X-Payment-Required': 'true',
+            'X-Payment-Address': paymentAddress,
+            'X-Payment-Amount': amount.toFixed(6),
+            'X-Payment-Currency': 'USD',
+            'X-Payment-Token': tokenAddress,
+            'X-Payment-Network': network,
+            'X-Payment-Tier': tier,
+            'X-Payment-Nonce': nonce,
+            'X-Payment-Protocol': 'x402',
+            'X-Payment-Version': '1.0',
+            'X-Payment-Facilitator': config.facilitatorUrl || 'https://x402.org/facilitator',
+        };
+    }
+    async function verifyPayment(proof) {
+        try {
+            // Check cache first
+            if (cacheEnabled) {
+                const cached = paymentCache.get(proof.txHash);
+                if (cached && Date.now() - cached.timestamp < cacheTtl) {
+                    stats.cacheHits++;
+                    return { valid: true, amount: cached.proof.amountUsd, token: cached.proof.token, network: cached.proof.network };
+                }
+                stats.cacheMisses++;
+            }
+            // Verify with facilitator or directly on-chain
+            const isValid = await verifyOnChain(proof);
+            if (isValid) {
+                stats.totalVerified++;
+                stats.totalRevenue += proof.amountUsd;
+                // Cache the verified payment
+                if (cacheEnabled) {
+                    paymentCache.set(proof.txHash, { proof, timestamp: Date.now() });
+                }
+                return {
+                    valid: true,
+                    amount: proof.amountUsd,
+                    token: proof.token,
+                    network: proof.network,
+                };
+            }
+            stats.failedVerifications++;
+            return { valid: false, error: 'Payment verification failed' };
+        }
+        catch (error) {
+            stats.failedVerifications++;
+            logger_1.logger.error({ error, txHash: proof.txHash }, 'Payment verification error');
+            return { valid: false, error: error instanceof Error ? error.message : 'Unknown error' };
+        }
+    }
+    async function verifyOnChain(proof) {
+        // Basic validation
+        if (!proof.txHash || !proof.txHash.startsWith('0x') || proof.txHash.length !== 66) {
+            logger_1.logger.warn({ txHash: proof.txHash }, 'Invalid tx hash format');
+            return false;
+        }
+        if (proof.amountUsd <= 0) {
+            logger_1.logger.warn({ amount: proof.amountUsd }, 'Invalid payment amount');
+            return false;
+        }
+        // Check timestamp (payment must be recent - within 10 minutes)
+        const maxAge = 10 * 60 * 1000; // 10 minutes
+        if (Date.now() - proof.timestamp > maxAge) {
+            logger_1.logger.warn({ timestamp: proof.timestamp }, 'Payment proof expired');
+            return false;
+        }
+        // Dev mode: accept well-formed proofs
+        if (process.env.NODE_ENV === 'development' || process.env.CLODDS_DEV_MODE === 'true') {
+            logger_1.logger.debug({ proof }, 'Dev mode: accepting payment');
+            return true;
+        }
+        // Production: verify on-chain via RPC
+        try {
+            const rpcUrl = proof.network === 'base'
+                ? 'https://mainnet.base.org'
+                : proof.network === 'base-sepolia'
+                    ? 'https://sepolia.base.org'
+                    : 'https://mainnet.base.org';
+            const response = await fetch(rpcUrl, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    jsonrpc: '2.0',
+                    method: 'eth_getTransactionReceipt',
+                    params: [proof.txHash],
+                    id: 1,
+                }),
+            });
+            const data = await response.json();
+            if (!data.result) {
+                logger_1.logger.warn({ txHash: proof.txHash }, 'Transaction not found');
+                return false;
+            }
+            // Check transaction succeeded
+            if (data.result.status !== '0x1') {
+                logger_1.logger.warn({ txHash: proof.txHash, status: data.result.status }, 'Transaction failed');
+                return false;
+            }
+            // Verify recipient (should be our payment address or USDC contract)
+            const paymentAddress = getPaymentAddress().toLowerCase();
+            const recipient = data.result.to?.toLowerCase();
+            if (recipient !== paymentAddress && recipient !== tokenAddress.toLowerCase()) {
+                logger_1.logger.warn({ txHash: proof.txHash, to: recipient, expected: paymentAddress }, 'Wrong recipient');
+                return false;
+            }
+            logger_1.logger.info({ txHash: proof.txHash, amount: proof.amountUsd }, 'Payment verified on-chain');
+            return true;
+        }
+        catch (error) {
+            logger_1.logger.error({ error, txHash: proof.txHash }, 'On-chain verification failed');
+            return false;
+        }
+    }
+    async function hasValidPayment(proof, requiredAmount) {
+        if (!proof) {
+            return false;
+        }
+        const result = await verifyPayment(proof);
+        if (!result.valid) {
+            return false;
+        }
+        // Check amount if specified
+        if (requiredAmount !== undefined && result.amount !== undefined) {
+            // Allow 1% tolerance for rounding
+            const tolerance = requiredAmount * 0.01;
+            if (result.amount < requiredAmount - tolerance) {
+                return false;
+            }
+        }
+        return true;
+    }
+    function getCachedPayment(txHash) {
+        const cached = paymentCache.get(txHash);
+        if (cached && Date.now() - cached.timestamp < cacheTtl) {
+            return cached.proof;
+        }
+        return null;
+    }
+    function clearCache() {
+        paymentCache.clear();
+    }
+    function getStats() {
+        return { ...stats };
+    }
+    // Periodic cache cleanup
+    setInterval(() => {
+        const now = Date.now();
+        for (const [hash, entry] of paymentCache) {
+            if (now - entry.timestamp > cacheTtl) {
+                paymentCache.delete(hash);
+            }
+        }
+    }, cacheTtl);
+    return {
+        hasValidPayment,
+        getPaymentRequiredHeaders,
+        verifyPayment,
+        getPaymentAddress,
+        getPrice,
+        classifyPrompt,
+        getCachedPayment,
+        clearCache,
+        getStats,
+    };
+}
+// =============================================================================
+// EXPRESS MIDDLEWARE HELPER
+// =============================================================================
+/**
+ * Create Express-compatible middleware
+ */
+function createExpressX402Middleware(config = {}) {
+    const middleware = createX402Middleware(config);
+    return async (req, res, next) => {
+        // Skip for non-prompt endpoints
+        if (!req.path.startsWith('/v2/prompt')) {
+            return next();
+        }
+        // Check for payment proof in headers
+        const paymentHeader = req.headers['x-payment-proof'];
+        let proof;
+        if (paymentHeader) {
+            try {
+                proof = JSON.parse(Buffer.from(paymentHeader, 'base64').toString());
+            }
+            catch {
+                return res.status(400).json({ error: 'Invalid payment proof format' });
+            }
+        }
+        // Classify the prompt to determine price
+        const prompt = req.body?.prompt || '';
+        const tier = middleware.classifyPrompt(prompt);
+        const price = middleware.getPrice(tier);
+        // Check if payment is valid
+        const hasPayment = await middleware.hasValidPayment(proof, price);
+        if (!hasPayment) {
+            // Return 402 Payment Required
+            const headers = middleware.getPaymentRequiredHeaders(price, tier);
+            for (const [key, value] of Object.entries(headers)) {
+                res.setHeader(key, value);
+            }
+            return res.status(402).json({
+                error: 'Payment Required',
+                amount: price,
+                currency: 'USD',
+                tier,
+                paymentAddress: middleware.getPaymentAddress(),
+                protocol: 'x402',
+            });
+        }
+        // Payment valid - attach to request and continue
+        req.payment = { proof, tier, price };
+        next();
+    };
+}
+//# sourceMappingURL=middleware.js.map

package/dist/api/middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.js","sourceRoot":"","sources":["../../src/api/middleware.ts"],"names":[],"mappings":"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"}

package/dist/api/prompt.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Prompt Handler - Natural language prompt processing
+ *
+ * Transforms user prompts into executable actions using the agent system.
+ * Integrates with Clodds subagent system for actual execution.
+ */
+import type { ApiRequest, PromptResultData, PromptAction, PricingTier } from './types';
+export interface PromptHandler {
+    /** Process a prompt and return result */
+    process(request: ApiRequest, tier: PricingTier): Promise<PromptResult>;
+    /** Classify prompt into action type */
+    classifyAction(prompt: string): PromptAction;
+    /** Check if prompt requires custody wallet */
+    requiresCustody(prompt: string): boolean;
+    /** Validate prompt before processing */
+    validate(prompt: string): ValidationResult;
+    /** Get supported actions */
+    getSupportedActions(): PromptAction[];
+}
+export interface PromptResult {
+    success: boolean;
+    data?: PromptResultData;
+    error?: string;
+}
+export interface ValidationResult {
+    valid: boolean;
+    error?: string;
+    sanitized?: string;
+}
+export interface PromptHandlerConfig {
+    /** Maximum prompt length (default: 2000) */
+    maxLength?: number;
+    /** Timeout for processing (default: 60000ms) */
+    timeout?: number;
+    /** Agent model to use (default: 'claude-sonnet-4-20250514') */
+    model?: string;
+    /** Enable dry run mode (default: false) */
+    dryRun?: boolean;
+    /** Anthropic API key (defaults to env) */
+    apiKey?: string;
+    /** Maximum tokens for response */
+    maxTokens?: number;
+}
+export declare function createPromptHandler(config?: PromptHandlerConfig): PromptHandler;