clodds 1.1.0

package/dist/api/custody.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Custody Manager - Managed wallet system for API users
+ *
+ * Features:
+ * - HD wallet derivation (one wallet per user)
+ * - Encrypted key storage
+ * - EVM + Solana support
+ * - Automatic key rotation (optional)
+ */
+import type { CustodyConfig, ManagedWalletData } from './types';
+export interface CustodyManager {
+    /** Get or create managed wallet for user */
+    getOrCreate(ownerAddress: string): Promise<ManagedWallet>;
+    /** Get existing wallet */
+    get(ownerAddress: string): ManagedWallet | null;
+    /** List all wallets */
+    list(): ManagedWallet[];
+    /** Get wallet by ID */
+    getById(id: string): ManagedWallet | null;
+    /** Check if user has wallet */
+    hasWallet(ownerAddress: string): boolean;
+    /** Get statistics */
+    getStats(): CustodyStats;
+}
+export interface ManagedWallet {
+    /** Wallet ID */
+    id: string;
+    /** Owner's external wallet address */
+    owner: string;
+    /** EVM address */
+    evmAddress: string;
+    /** Solana address (if available) */
+    solanaAddress?: string;
+    /** Get EVM private key (decrypted) */
+    getEvmPrivateKey(): string;
+    /** Get Solana private key (decrypted) */
+    getSolanaPrivateKey(): string | null;
+    /** Get wallet data (without keys) */
+    getData(): ManagedWalletData;
+    /** Update last used timestamp */
+    touch(): void;
+}
+export interface CustodyStats {
+    totalWallets: number;
+    activeWallets: number;
+    totalDerivationIndex: number;
+}
+export declare function createCustodyManager(config?: CustodyConfig): CustodyManager;

package/dist/api/custody.js

@@ -0,0 +1,272 @@
+"use strict";
+/**
+ * Custody Manager - Managed wallet system for API users
+ *
+ * Features:
+ * - HD wallet derivation (one wallet per user)
+ * - Encrypted key storage
+ * - EVM + Solana support
+ * - Automatic key rotation (optional)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCustodyManager = createCustodyManager;
+const crypto_1 = require("crypto");
+const fs_1 = require("fs");
+const path_1 = require("path");
+const os_1 = require("os");
+const accounts_1 = require("viem/accounts");
+const web3_js_1 = require("@solana/web3.js");
+const logger_1 = require("../utils/logger");
+// =============================================================================
+// CONSTANTS
+// =============================================================================
+const DEFAULT_CONFIG = {
+    enabled: false,
+    masterKey: '',
+    derivationPath: "m/44'/60'/0'/0",
+    storageDir: (0, path_1.join)((0, os_1.homedir)(), '.clodds', 'api', 'wallets'),
+};
+const ENCRYPTION_ALGORITHM = 'aes-256-gcm';
+const KEY_LENGTH = 32;
+const IV_LENGTH = 16;
+const AUTH_TAG_LENGTH = 16;
+const SALT_LENGTH = 32;
+// =============================================================================
+// ENCRYPTION HELPERS
+// =============================================================================
+function deriveKey(masterKey, salt) {
+    return (0, crypto_1.scryptSync)(masterKey, salt, KEY_LENGTH);
+}
+function encrypt(plaintext, masterKey) {
+    const salt = (0, crypto_1.randomBytes)(SALT_LENGTH);
+    const key = deriveKey(masterKey, salt);
+    const iv = (0, crypto_1.randomBytes)(IV_LENGTH);
+    const cipher = (0, crypto_1.createCipheriv)(ENCRYPTION_ALGORITHM, key, iv);
+    const encrypted = Buffer.concat([cipher.update(plaintext, 'utf8'), cipher.final()]);
+    const authTag = cipher.getAuthTag();
+    // Format: salt:iv:authTag:encrypted (all base64)
+    return [
+        salt.toString('base64'),
+        iv.toString('base64'),
+        authTag.toString('base64'),
+        encrypted.toString('base64'),
+    ].join(':');
+}
+function decrypt(ciphertext, masterKey) {
+    const [saltB64, ivB64, authTagB64, encryptedB64] = ciphertext.split(':');
+    const salt = Buffer.from(saltB64, 'base64');
+    const iv = Buffer.from(ivB64, 'base64');
+    const authTag = Buffer.from(authTagB64, 'base64');
+    const encrypted = Buffer.from(encryptedB64, 'base64');
+    const key = deriveKey(masterKey, salt);
+    const decipher = (0, crypto_1.createDecipheriv)(ENCRYPTION_ALGORITHM, key, iv);
+    decipher.setAuthTag(authTag);
+    return decipher.update(encrypted) + decipher.final('utf8');
+}
+function generateWalletFromIndex(derivationIndex, masterSeed) {
+    // Derive deterministic private key using HMAC-SHA512 (BIP-32 style)
+    // This creates a secure, deterministic derivation from master seed + index
+    // EVM key derivation
+    const evmDerivation = (0, crypto_1.createHmac)('sha512', masterSeed)
+        .update(`clodds:evm:${derivationIndex}`)
+        .digest();
+    const evmPrivateKey = `0x${evmDerivation.subarray(0, 32).toString('hex')}`;
+    // Derive actual EVM address from private key using secp256k1
+    let evmAddress;
+    try {
+        const account = (0, accounts_1.privateKeyToAccount)(evmPrivateKey);
+        evmAddress = account.address;
+    }
+    catch {
+        // Fallback if viem not available
+        evmAddress = `0x${(0, crypto_1.createHash)('keccak256').update(evmDerivation.subarray(0, 32)).digest('hex').slice(-40)}`;
+    }
+    // Solana key derivation (Ed25519 requires 32 bytes)
+    const solanaDerivation = (0, crypto_1.createHmac)('sha512', masterSeed)
+        .update(`clodds:solana:${derivationIndex}`)
+        .digest();
+    const solanaSeed = solanaDerivation.subarray(0, 32);
+    let solanaPrivateKey;
+    let solanaAddress;
+    try {
+        const keypair = web3_js_1.Keypair.fromSeed(solanaSeed);
+        solanaPrivateKey = Buffer.from(keypair.secretKey).toString('hex');
+        solanaAddress = keypair.publicKey.toBase58();
+    }
+    catch {
+        // Fallback if @solana/web3.js not available
+        solanaPrivateKey = solanaSeed.toString('hex');
+        solanaAddress = undefined;
+    }
+    return {
+        evmPrivateKey,
+        evmAddress,
+        solanaPrivateKey,
+        solanaAddress,
+    };
+}
+function createCustodyManager(config = {}) {
+    const cfg = { ...DEFAULT_CONFIG, ...config };
+    if (cfg.enabled && !cfg.masterKey) {
+        throw new Error('Custody manager requires masterKey when enabled');
+    }
+    // Derive master seed from master key
+    const masterSeed = cfg.masterKey
+        ? (0, crypto_1.createHash)('sha256').update(`clodds:custody:${cfg.masterKey}`).digest('hex')
+        : '';
+    // Wallet storage
+    const wallets = new Map(); // owner -> wallet
+    const walletsById = new Map(); // id -> wallet
+    let nextDerivationIndex = 0;
+    // Ensure storage directory exists
+    if (cfg.enabled) {
+        (0, fs_1.mkdirSync)(cfg.storageDir, { recursive: true });
+        loadWallets();
+    }
+    function loadWallets() {
+        try {
+            const indexPath = (0, path_1.join)(cfg.storageDir, 'index.json');
+            if ((0, fs_1.existsSync)(indexPath)) {
+                const data = JSON.parse((0, fs_1.readFileSync)(indexPath, 'utf-8'));
+                for (const wallet of data.wallets) {
+                    wallets.set(wallet.owner.toLowerCase(), wallet);
+                    walletsById.set(wallet.id, wallet);
+                }
+                nextDerivationIndex = data.nextIndex;
+                logger_1.logger.info({ count: wallets.size }, 'Loaded custody wallets');
+            }
+        }
+        catch (e) {
+            logger_1.logger.warn('Failed to load custody wallets, starting fresh');
+        }
+    }
+    function saveWallets() {
+        try {
+            const indexPath = (0, path_1.join)(cfg.storageDir, 'index.json');
+            const data = {
+                wallets: Array.from(wallets.values()),
+                nextIndex: nextDerivationIndex,
+            };
+            (0, fs_1.writeFileSync)(indexPath, JSON.stringify(data, null, 2));
+        }
+        catch (e) {
+            logger_1.logger.error({ error: e }, 'Failed to save custody wallets');
+        }
+    }
+    function generateWalletId() {
+        return `cw_${Date.now().toString(36)}_${(0, crypto_1.randomBytes)(4).toString('hex')}`;
+    }
+    function createWalletWrapper(stored) {
+        return {
+            id: stored.id,
+            owner: stored.owner,
+            evmAddress: stored.evmAddress,
+            solanaAddress: stored.solanaAddress,
+            getEvmPrivateKey() {
+                return decrypt(stored.encryptedEvmKey, cfg.masterKey);
+            },
+            getSolanaPrivateKey() {
+                if (!stored.encryptedSolanaKey)
+                    return null;
+                return decrypt(stored.encryptedSolanaKey, cfg.masterKey);
+            },
+            getData() {
+                return {
+                    id: stored.id,
+                    owner: stored.owner,
+                    evmAddress: stored.evmAddress,
+                    solanaAddress: stored.solanaAddress,
+                    createdAt: stored.createdAt,
+                    lastUsedAt: stored.lastUsedAt,
+                    derivationIndex: stored.derivationIndex,
+                };
+            },
+            touch() {
+                stored.lastUsedAt = Date.now();
+                saveWallets();
+            },
+        };
+    }
+    async function getOrCreate(ownerAddress) {
+        if (!cfg.enabled) {
+            throw new Error('Custody manager is not enabled');
+        }
+        const ownerLower = ownerAddress.toLowerCase();
+        // Check existing
+        const existing = wallets.get(ownerLower);
+        if (existing) {
+            existing.lastUsedAt = Date.now();
+            saveWallets();
+            return createWalletWrapper(existing);
+        }
+        // Generate new wallet
+        const index = nextDerivationIndex++;
+        const keys = generateWalletFromIndex(index, masterSeed);
+        const stored = {
+            id: generateWalletId(),
+            owner: ownerAddress,
+            evmAddress: keys.evmAddress,
+            solanaAddress: keys.solanaAddress,
+            encryptedEvmKey: encrypt(keys.evmPrivateKey, cfg.masterKey),
+            encryptedSolanaKey: keys.solanaPrivateKey ? encrypt(keys.solanaPrivateKey, cfg.masterKey) : undefined,
+            derivationIndex: index,
+            createdAt: Date.now(),
+            lastUsedAt: Date.now(),
+        };
+        wallets.set(ownerLower, stored);
+        walletsById.set(stored.id, stored);
+        saveWallets();
+        logger_1.logger.info({ walletId: stored.id, owner: ownerAddress, evmAddress: stored.evmAddress }, 'Created custody wallet');
+        return createWalletWrapper(stored);
+    }
+    function get(ownerAddress) {
+        if (!cfg.enabled)
+            return null;
+        const stored = wallets.get(ownerAddress.toLowerCase());
+        if (!stored)
+            return null;
+        return createWalletWrapper(stored);
+    }
+    function getById(id) {
+        if (!cfg.enabled)
+            return null;
+        const stored = walletsById.get(id);
+        if (!stored)
+            return null;
+        return createWalletWrapper(stored);
+    }
+    function list() {
+        if (!cfg.enabled)
+            return [];
+        return Array.from(wallets.values()).map(createWalletWrapper);
+    }
+    function hasWallet(ownerAddress) {
+        if (!cfg.enabled)
+            return false;
+        return wallets.has(ownerAddress.toLowerCase());
+    }
+    function getStats() {
+        const now = Date.now();
+        const dayAgo = now - 86400000;
+        let activeCount = 0;
+        for (const wallet of wallets.values()) {
+            if (wallet.lastUsedAt > dayAgo) {
+                activeCount++;
+            }
+        }
+        return {
+            totalWallets: wallets.size,
+            activeWallets: activeCount,
+            totalDerivationIndex: nextDerivationIndex,
+        };
+    }
+    return {
+        getOrCreate,
+        get,
+        getById,
+        list,
+        hasWallet,
+        getStats,
+    };
+}
+//# sourceMappingURL=custody.js.map

package/dist/api/custody.js.map

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

package/dist/api/fees.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Fee Calculator - Trading fees and revenue tracking
+ *
+ * Revenue sources:
+ * 1. Prompt fees: $0.05-0.25 per request
+ * 2. Trading fees: 0.3% of volume (configurable)
+ * 3. Subscription revenue: $29-499/month
+ */
+import type { TradingFeeConfig, SubscriptionTier } from './types';
+export interface FeeCalculator {
+    /** Calculate trading fee for a trade */
+    calculateTradingFee(volumeUsd: number, tier?: SubscriptionTier, isTokenHolder?: boolean): FeeResult;
+    /** Calculate prompt fee */
+    calculatePromptFee(tier: 'basic' | 'standard' | 'complex', subscriptionTier?: SubscriptionTier): number;
+    /** Get fee breakdown */
+    getFeeBreakdown(volumeUsd: number, tier?: SubscriptionTier, isTokenHolder?: boolean): FeeBreakdown;
+    /** Record fee revenue */
+    recordRevenue(type: 'prompt' | 'trading' | 'subscription', amount: number, meta?: Record<string, unknown>): void;
+    /** Get total revenue */
+    getTotalRevenue(): RevenueStats;
+    /** Get revenue by period */
+    getRevenueByPeriod(startMs: number, endMs: number): RevenueStats;
+}
+export interface FeeResult {
+    /** Fee in USD */
+    feeUsd: number;
+    /** Fee as percentage */
+    feePct: number;
+    /** Net amount after fee */
+    netAmount: number;
+    /** Discounts applied */
+    discounts: FeeDiscount[];
+}
+export interface FeeDiscount {
+    type: 'subscription' | 'token_holder' | 'referral' | 'volume';
+    amount: number;
+    reason: string;
+}
+export interface FeeBreakdown {
+    grossFee: number;
+    discounts: FeeDiscount[];
+    netFee: number;
+    platform: string;
+    timestamp: number;
+}
+export interface RevenueRecord {
+    type: 'prompt' | 'trading' | 'subscription';
+    amount: number;
+    timestamp: number;
+    meta?: Record<string, unknown>;
+}
+export interface RevenueStats {
+    total: number;
+    byType: {
+        prompt: number;
+        trading: number;
+        subscription: number;
+    };
+    count: number;
+    period?: {
+        start: number;
+        end: number;
+    };
+}
+export interface FeeCalculatorConfig extends Partial<TradingFeeConfig> {
+    /** Prompt pricing */
+    promptPricing?: {
+        basic: number;
+        standard: number;
+        complex: number;
+    };
+}
+export declare function createFeeCalculator(config?: FeeCalculatorConfig): FeeCalculator;
+/**
+ * Example fee calculations:
+ *
+ * Free user trades $1,000:
+ *   Base fee: 0.3% = $3.00
+ *   Net: $997.00
+ *
+ * Pro subscriber ($29/mo) trades $1,000:
+ *   Base fee: 0.3% = $3.00
+ *   Subscription discount: 10% = -$0.30
+ *   Net fee: $2.70
+ *
+ * Business + $CLODDS holder trades $10,000:
+ *   Base fee: 0.3% = $30.00
+ *   Subscription discount: 25% = -$7.50
+ *   Token holder discount: 20% of remaining = -$4.50
+ *   Net fee: $18.00
+ */

package/dist/api/fees.js

@@ -0,0 +1,155 @@
+"use strict";
+/**
+ * Fee Calculator - Trading fees and revenue tracking
+ *
+ * Revenue sources:
+ * 1. Prompt fees: $0.05-0.25 per request
+ * 2. Trading fees: 0.3% of volume (configurable)
+ * 3. Subscription revenue: $29-499/month
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createFeeCalculator = createFeeCalculator;
+const logger_1 = require("../utils/logger");
+// =============================================================================
+// CONSTANTS
+// =============================================================================
+const DEFAULT_CONFIG = {
+    baseFee: 0.003,
+    minFee: 0.01,
+    maxFee: 100,
+    tokenHolderDiscount: 0.2,
+    promptPricing: {
+        basic: 0.05,
+        standard: 0.10,
+        complex: 0.25,
+    },
+};
+// =============================================================================
+// IMPLEMENTATION
+// =============================================================================
+function createFeeCalculator(config = {}) {
+    const cfg = { ...DEFAULT_CONFIG, ...config };
+    // Revenue tracking (in-memory, would use DB in production)
+    const revenueLog = [];
+    function calculateTradingFee(volumeUsd, subscriptionTier = 'free', isTokenHolder = false) {
+        if (volumeUsd <= 0) {
+            return { feeUsd: 0, feePct: 0, netAmount: 0, discounts: [] };
+        }
+        const discounts = [];
+        let effectiveRate = cfg.baseFee;
+        // Import tier config
+        const tierConfig = require('./types').SUBSCRIPTION_TIERS[subscriptionTier];
+        // Subscription discount
+        if (tierConfig?.tradingFeeDiscount > 0) {
+            const discount = effectiveRate * tierConfig.tradingFeeDiscount;
+            effectiveRate -= discount;
+            discounts.push({
+                type: 'subscription',
+                amount: discount * volumeUsd,
+                reason: `${subscriptionTier} tier: ${(tierConfig.tradingFeeDiscount * 100).toFixed(0)}% off`,
+            });
+        }
+        // Token holder discount
+        if (isTokenHolder && cfg.tokenHolderDiscount > 0) {
+            const discount = effectiveRate * cfg.tokenHolderDiscount;
+            effectiveRate -= discount;
+            discounts.push({
+                type: 'token_holder',
+                amount: discount * volumeUsd,
+                reason: `$CLODDS holder: ${(cfg.tokenHolderDiscount * 100).toFixed(0)}% off`,
+            });
+        }
+        // Calculate fee
+        let feeUsd = volumeUsd * effectiveRate;
+        // Apply min/max
+        feeUsd = Math.max(cfg.minFee, Math.min(cfg.maxFee, feeUsd));
+        return {
+            feeUsd: Math.round(feeUsd * 100) / 100,
+            feePct: effectiveRate * 100,
+            netAmount: Math.round((volumeUsd - feeUsd) * 100) / 100,
+            discounts,
+        };
+    }
+    function calculatePromptFee(promptTier, subscriptionTier = 'free') {
+        const basePrice = cfg.promptPricing[promptTier] || cfg.promptPricing.standard;
+        // Pro+ subscribers get prompts included
+        const tierConfig = require('./types').SUBSCRIPTION_TIERS[subscriptionTier];
+        if (tierConfig?.priceMonthly > 0) {
+            // Subscribers pay reduced rate
+            return Math.round(basePrice * 0.5 * 100) / 100;
+        }
+        return basePrice;
+    }
+    function getFeeBreakdown(volumeUsd, subscriptionTier, isTokenHolder) {
+        const result = calculateTradingFee(volumeUsd, subscriptionTier, isTokenHolder);
+        return {
+            grossFee: volumeUsd * cfg.baseFee,
+            discounts: result.discounts,
+            netFee: result.feeUsd,
+            platform: 'clodds',
+            timestamp: Date.now(),
+        };
+    }
+    function recordRevenue(type, amount, meta) {
+        revenueLog.push({
+            type,
+            amount,
+            timestamp: Date.now(),
+            meta,
+        });
+        logger_1.logger.debug({ type, amount }, 'Revenue recorded');
+    }
+    function getTotalRevenue() {
+        return calculateStats(revenueLog);
+    }
+    function getRevenueByPeriod(startMs, endMs) {
+        const filtered = revenueLog.filter(r => r.timestamp >= startMs && r.timestamp <= endMs);
+        const stats = calculateStats(filtered);
+        stats.period = { start: startMs, end: endMs };
+        return stats;
+    }
+    function calculateStats(records) {
+        const stats = {
+            total: 0,
+            byType: { prompt: 0, trading: 0, subscription: 0 },
+            count: records.length,
+        };
+        for (const record of records) {
+            stats.total += record.amount;
+            stats.byType[record.type] += record.amount;
+        }
+        // Round
+        stats.total = Math.round(stats.total * 100) / 100;
+        stats.byType.prompt = Math.round(stats.byType.prompt * 100) / 100;
+        stats.byType.trading = Math.round(stats.byType.trading * 100) / 100;
+        stats.byType.subscription = Math.round(stats.byType.subscription * 100) / 100;
+        return stats;
+    }
+    return {
+        calculateTradingFee,
+        calculatePromptFee,
+        getFeeBreakdown,
+        recordRevenue,
+        getTotalRevenue,
+        getRevenueByPeriod,
+    };
+}
+/**
+ * Example fee calculations:
+ *
+ * Free user trades $1,000:
+ *   Base fee: 0.3% = $3.00
+ *   Net: $997.00
+ *
+ * Pro subscriber ($29/mo) trades $1,000:
+ *   Base fee: 0.3% = $3.00
+ *   Subscription discount: 10% = -$0.30
+ *   Net fee: $2.70
+ *
+ * Business + $CLODDS holder trades $10,000:
+ *   Base fee: 0.3% = $30.00
+ *   Subscription discount: 25% = -$7.50
+ *   Token holder discount: 20% of remaining = -$4.50
+ *   Net fee: $18.00
+ */
+//# sourceMappingURL=fees.js.map

package/dist/api/fees.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fees.js","sourceRoot":"","sources":["../../src/api/fees.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;AAqGH,kDAgJC;AAnPD,4CAAyC;AA+EzC,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF,MAAM,cAAc,GAAwB;IAC1C,OAAO,EAAE,KAAK;IACd,MAAM,EAAE,IAAI;IACZ,MAAM,EAAE,GAAG;IACX,mBAAmB,EAAE,GAAG;IACxB,aAAa,EAAE;QACb,KAAK,EAAE,IAAI;QACX,QAAQ,EAAE,IAAI;QACd,OAAO,EAAE,IAAI;KACd;CACF,CAAC;AAEF,gFAAgF;AAChF,iBAAiB;AACjB,gFAAgF;AAEhF,SAAgB,mBAAmB,CAAC,SAA8B,EAAE;IAClE,MAAM,GAAG,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,MAAM,EAAE,CAAC;IAE7C,2DAA2D;IAC3D,MAAM,UAAU,GAAoB,EAAE,CAAC;IAEvC,SAAS,mBAAmB,CAC1B,SAAiB,EACjB,mBAAqC,MAAM,EAC3C,gBAAyB,KAAK;QAE9B,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;YACnB,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;QAC/D,CAAC;QAED,MAAM,SAAS,GAAkB,EAAE,CAAC;QACpC,IAAI,aAAa,GAAG,GAAG,CAAC,OAAQ,CAAC;QAEjC,qBAAqB;QACrB,MAAM,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,kBAAkB,CAAC,gBAAgB,CAAC,CAAC;QAE3E,wBAAwB;QACxB,IAAI,UAAU,EAAE,kBAAkB,GAAG,CAAC,EAAE,CAAC;YACvC,MAAM,QAAQ,GAAG,aAAa,GAAG,UAAU,CAAC,kBAAkB,CAAC;YAC/D,aAAa,IAAI,QAAQ,CAAC;YAC1B,SAAS,CAAC,IAAI,CAAC;gBACb,IAAI,EAAE,cAAc;gBACpB,MAAM,EAAE,QAAQ,GAAG,SAAS;gBAC5B,MAAM,EAAE,GAAG,gBAAgB,UAAU,CAAC,UAAU,CAAC,kBAAkB,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO;aAC7F,CAAC,CAAC;QACL,CAAC;QAED,wBAAwB;QACxB,IAAI,aAAa,IAAI,GAAG,CAAC,mBAAoB,GAAG,CAAC,EAAE,CAAC;YAClD,MAAM,QAAQ,GAAG,aAAa,GAAG,GAAG,CAAC,mBAAoB,CAAC;YAC1D,aAAa,IAAI,QAAQ,CAAC;YAC1B,SAAS,CAAC,IAAI,CAAC;gBACb,IAAI,EAAE,cAAc;gBACpB,MAAM,EAAE,QAAQ,GAAG,SAAS;gBAC5B,MAAM,EAAE,mBAAmB,CAAC,GAAG,CAAC,mBAAoB,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO;aAC9E,CAAC,CAAC;QACL,CAAC;QAED,gBAAgB;QAChB,IAAI,MAAM,GAAG,SAAS,GAAG,aAAa,CAAC;QAEvC,gBAAgB;QAChB,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAO,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAO,EAAE,MAAM,CAAC,CAAC,CAAC;QAE9D,OAAO;YACL,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC,GAAG,GAAG;YACtC,MAAM,EAAE,aAAa,GAAG,GAAG;YAC3B,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,GAAG,MAAM,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG;YACvD,SAAS;SACV,CAAC;IACJ,CAAC;IAED,SAAS,kBAAkB,CACzB,UAA4C,EAC5C,mBAAqC,MAAM;QAE3C,MAAM,SAAS,GAAG,GAAG,CAAC,aAAc,CAAC,UAAU,CAAC,IAAI,GAAG,CAAC,aAAc,CAAC,QAAQ,CAAC;QAEhF,wCAAwC;QACxC,MAAM,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,kBAAkB,CAAC,gBAAgB,CAAC,CAAC;QAC3E,IAAI,UAAU,EAAE,YAAY,GAAG,CAAC,EAAE,CAAC;YACjC,+BAA+B;YAC/B,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,GAAG,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;QACjD,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,SAAS,eAAe,CACtB,SAAiB,EACjB,gBAAmC,EACnC,aAAuB;QAEvB,MAAM,MAAM,GAAG,mBAAmB,CAAC,SAAS,EAAE,gBAAgB,EAAE,aAAa,CAAC,CAAC;QAE/E,OAAO;YACL,QAAQ,EAAE,SAAS,GAAG,GAAG,CAAC,OAAQ;YAClC,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,QAAQ,EAAE,QAAQ;YAClB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC;IACJ,CAAC;IAED,SAAS,aAAa,CACpB,IAA2C,EAC3C,MAAc,EACd,IAA8B;QAE9B,UAAU,CAAC,IAAI,CAAC;YACd,IAAI;YACJ,MAAM;YACN,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,IAAI;SACL,CAAC,CAAC;QAEH,eAAM,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,kBAAkB,CAAC,CAAC;IACrD,CAAC;IAED,SAAS,eAAe;QACtB,OAAO,cAAc,CAAC,UAAU,CAAC,CAAC;IACpC,CAAC;IAED,SAAS,kBAAkB,CAAC,OAAe,EAAE,KAAa;QACxD,MAAM,QAAQ,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,IAAI,OAAO,IAAI,CAAC,CAAC,SAAS,IAAI,KAAK,CAAC,CAAC;QACxF,MAAM,KAAK,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;QACvC,KAAK,CAAC,MAAM,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;QAC9C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,SAAS,cAAc,CAAC,OAAwB;QAC9C,MAAM,KAAK,GAAiB;YAC1B,KAAK,EAAE,CAAC;YACR,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE;YAClD,KAAK,EAAE,OAAO,CAAC,MAAM;SACtB,CAAC;QAEF,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,KAAK,CAAC,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC;YAC7B,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC;QAC7C,CAAC;QAED,QAAQ;QACR,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;QAClD,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;QAClE,KAAK,CAAC,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;QACpE,KAAK,CAAC,MAAM,CAAC,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,YAAY,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;QAE9E,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO;QACL,mBAAmB;QACnB,kBAAkB;QAClB,eAAe;QACf,aAAa;QACb,eAAe;QACf,kBAAkB;KACnB,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG"}

package/dist/api/gateway.d.ts

@@ -0,0 +1,40 @@
+/**
+ * API Gateway - Main HTTP server for Clodds Hosted API
+ *
+ * Endpoints:
+ * - POST /v2/prompt       Submit natural language prompt (x402 payment)
+ * - GET  /v2/job/:id      Check job status
+ * - POST /v2/job/:id/cancel  Cancel pending job
+ * - GET  /v2/jobs         List jobs for wallet
+ * - GET  /v2/wallet       Get managed wallet info
+ * - GET  /health          Basic health check
+ * - GET  /health/live     Liveness check (is the process alive?)
+ * - GET  /health/ready    Readiness check (is the service ready for traffic?)
+ * - GET  /metrics         API metrics (JSON, auth required)
+ * - GET  /metrics/prometheus  Prometheus-format metrics (auth required)
+ */
+import { EventEmitter } from 'eventemitter3';
+import { type X402Middleware } from './middleware';
+import { type JobManager } from './jobs';
+import { type PromptHandler } from './prompt';
+import { type CustodyManager } from './custody';
+import type { ApiGatewayConfig, ApiMetrics } from './types';
+export interface ApiGateway extends EventEmitter {
+    /** Start the server */
+    start(): Promise<void>;
+    /** Stop the server */
+    stop(): Promise<void>;
+    /** Get server URL */
+    getUrl(): string;
+    /** Get API metrics */
+    getMetrics(): ApiMetrics;
+    /** Get middleware */
+    getX402Middleware(): X402Middleware;
+    /** Get job manager */
+    getJobManager(): JobManager;
+    /** Get prompt handler */
+    getPromptHandler(): PromptHandler;
+    /** Get custody manager */
+    getCustodyManager(): CustodyManager;
+}
+export declare function createApiGateway(config?: ApiGatewayConfig): ApiGateway;