clodds 1.1.0

package/dist/ledger/anchor.js

@@ -0,0 +1,271 @@
+"use strict";
+/**
+ * Trade Ledger - Onchain Hash Anchoring
+ *
+ * Anchor decision hashes to blockchain for tamper-proof verification.
+ * Supports Solana (memo), Polygon, and Base (calldata).
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAnchorService = createAnchorService;
+exports.verifyAnchor = verifyAnchor;
+const logger_1 = require("../utils/logger");
+// =============================================================================
+// SOLANA ANCHOR
+// =============================================================================
+async function anchorToSolana(hash, config) {
+    try {
+        const { Connection, Keypair, Transaction, TransactionInstruction, PublicKey } = await Promise.resolve().then(() => __importStar(require('@solana/web3.js')));
+        const rpcUrl = config.solanaRpcUrl || process.env.SOLANA_RPC_URL || 'https://api.mainnet-beta.solana.com';
+        const connection = new Connection(rpcUrl, 'confirmed');
+        // Load keypair
+        const privateKey = config.solanaPrivateKey || process.env.SOLANA_PRIVATE_KEY;
+        if (!privateKey) {
+            return {
+                success: false,
+                chain: 'solana',
+                error: 'No Solana private key configured',
+                timestamp: Date.now(),
+            };
+        }
+        const { loadSolanaKeypair } = await Promise.resolve().then(() => __importStar(require('../solana/wallet')));
+        const keypair = loadSolanaKeypair({ privateKey });
+        // Memo program ID
+        const MEMO_PROGRAM_ID = new PublicKey('MemoSq4gqABAXKb96qnH8TysNcWxMyWCqXgDLGmfcHr');
+        // Create memo instruction with the hash
+        const memoData = `clodds:ledger:${hash}`;
+        const memoIx = new TransactionInstruction({
+            keys: [],
+            programId: MEMO_PROGRAM_ID,
+            data: Buffer.from(memoData, 'utf-8'),
+        });
+        const tx = new Transaction().add(memoIx);
+        tx.feePayer = keypair.publicKey;
+        tx.recentBlockhash = (await connection.getLatestBlockhash()).blockhash;
+        tx.sign(keypair);
+        const signature = await connection.sendRawTransaction(tx.serialize(), {
+            skipPreflight: false,
+            preflightCommitment: 'confirmed',
+        });
+        // Wait for confirmation
+        await connection.confirmTransaction(signature, 'confirmed');
+        logger_1.logger.info({ chain: 'solana', hash: hash.slice(0, 16), signature }, 'Anchored hash to Solana');
+        return {
+            success: true,
+            chain: 'solana',
+            txHash: signature,
+            timestamp: Date.now(),
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        logger_1.logger.error({ chain: 'solana', error: message }, 'Failed to anchor to Solana');
+        return {
+            success: false,
+            chain: 'solana',
+            error: message,
+            timestamp: Date.now(),
+        };
+    }
+}
+// =============================================================================
+// EVM ANCHOR (Polygon / Base)
+// =============================================================================
+const EVM_RPC_URLS = {
+    polygon: 'https://polygon-rpc.com',
+    base: 'https://mainnet.base.org',
+};
+async function anchorToEvm(hash, chain, config) {
+    try {
+        // Dynamic import to avoid bundling ethers if not needed
+        const { ethers } = await Promise.resolve().then(() => __importStar(require('ethers')));
+        const rpcUrl = config.evmRpcUrl || process.env[`${chain.toUpperCase()}_RPC_URL`] || EVM_RPC_URLS[chain];
+        const provider = new ethers.JsonRpcProvider(rpcUrl);
+        const privateKey = config.evmPrivateKey || process.env[`${chain.toUpperCase()}_PRIVATE_KEY`] || process.env.EVM_PRIVATE_KEY;
+        if (!privateKey) {
+            return {
+                success: false,
+                chain,
+                error: `No ${chain} private key configured`,
+                timestamp: Date.now(),
+            };
+        }
+        const wallet = new ethers.Wallet(privateKey, provider);
+        // Encode hash as calldata (0x prefix + "clodds:ledger:" + hash)
+        const data = ethers.hexlify(ethers.toUtf8Bytes(`clodds:ledger:${hash}`));
+        // Send minimal transaction to self with hash in data
+        const tx = await wallet.sendTransaction({
+            to: wallet.address,
+            value: 0,
+            data,
+        });
+        // Wait for confirmation
+        const receipt = await tx.wait();
+        logger_1.logger.info({ chain, hash: hash.slice(0, 16), txHash: receipt?.hash }, `Anchored hash to ${chain}`);
+        return {
+            success: true,
+            chain,
+            txHash: receipt?.hash,
+            timestamp: Date.now(),
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        logger_1.logger.error({ chain, error: message }, `Failed to anchor to ${chain}`);
+        return {
+            success: false,
+            chain,
+            error: message,
+            timestamp: Date.now(),
+        };
+    }
+}
+/**
+ * Create an anchor service for the specified chain
+ */
+function createAnchorService(config) {
+    const pendingHashes = [];
+    let batchTimer = null;
+    const flushBatch = async () => {
+        if (pendingHashes.length === 0)
+            return null;
+        const hashes = [...pendingHashes];
+        pendingHashes.length = 0;
+        if (batchTimer) {
+            clearTimeout(batchTimer);
+            batchTimer = null;
+        }
+        // Combine hashes into a Merkle-like root (simple concatenation for now)
+        const combined = hashes.join(',');
+        const { createHash } = await Promise.resolve().then(() => __importStar(require('crypto')));
+        const batchHash = createHash('sha256').update(combined).digest('hex');
+        return anchorHash(batchHash, config);
+    };
+    return {
+        async anchor(hash) {
+            if (config.batchSize && config.batchSize > 1) {
+                pendingHashes.push(hash);
+                if (pendingHashes.length >= config.batchSize) {
+                    const result = await flushBatch();
+                    return result || { success: false, chain: config.chain, error: 'Batch empty', timestamp: Date.now() };
+                }
+                // Set timer to flush batch after max age
+                if (!batchTimer && config.batchMaxAgeMs) {
+                    batchTimer = setTimeout(flushBatch, config.batchMaxAgeMs);
+                }
+                return {
+                    success: true,
+                    chain: config.chain,
+                    timestamp: Date.now(),
+                };
+            }
+            return anchorHash(hash, config);
+        },
+        async anchorBatch(hashes) {
+            const combined = hashes.join(',');
+            const { createHash } = await Promise.resolve().then(() => __importStar(require('crypto')));
+            const batchHash = createHash('sha256').update(combined).digest('hex');
+            return anchorHash(batchHash, config);
+        },
+        getConfig() {
+            return config;
+        },
+    };
+}
+/**
+ * Anchor a single hash to the configured chain
+ */
+async function anchorHash(hash, config) {
+    switch (config.chain) {
+        case 'solana':
+            return anchorToSolana(hash, config);
+        case 'polygon':
+        case 'base':
+            return anchorToEvm(hash, config.chain, config);
+        default:
+            return {
+                success: false,
+                chain: config.chain,
+                error: `Unsupported chain: ${config.chain}`,
+                timestamp: Date.now(),
+            };
+    }
+}
+/**
+ * Verify an anchor exists on chain
+ */
+async function verifyAnchor(txHash, expectedHash, chain) {
+    try {
+        const expectedData = `clodds:ledger:${expectedHash}`;
+        if (chain === 'solana') {
+            const { Connection } = await Promise.resolve().then(() => __importStar(require('@solana/web3.js')));
+            const connection = new Connection(process.env.SOLANA_RPC_URL || 'https://api.mainnet-beta.solana.com', 'confirmed');
+            const tx = await connection.getParsedTransaction(txHash, {
+                maxSupportedTransactionVersion: 0,
+            });
+            if (!tx) {
+                return { verified: false, error: 'Transaction not found' };
+            }
+            // Check memo instruction data
+            const instructions = tx.transaction.message.instructions;
+            for (const ix of instructions) {
+                if ('parsed' in ix && ix.parsed?.info?.message === expectedData) {
+                    return { verified: true };
+                }
+            }
+            return { verified: false, error: 'Hash not found in transaction' };
+        }
+        else {
+            // EVM chains
+            const { ethers } = await Promise.resolve().then(() => __importStar(require('ethers')));
+            const rpcUrl = EVM_RPC_URLS[chain];
+            const provider = new ethers.JsonRpcProvider(rpcUrl);
+            const tx = await provider.getTransaction(txHash);
+            if (!tx) {
+                return { verified: false, error: 'Transaction not found' };
+            }
+            const data = ethers.toUtf8String(tx.data);
+            if (data === expectedData) {
+                return { verified: true };
+            }
+            return { verified: false, error: 'Hash mismatch in transaction data' };
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return { verified: false, error: message };
+    }
+}
+//# sourceMappingURL=anchor.js.map

package/dist/ledger/anchor.js.map

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

package/dist/ledger/hash.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Trade Ledger - Integrity Hashing
+ *
+ * SHA-256 hashing for decision record integrity verification.
+ */
+import type { DecisionRecord } from './types';
+/**
+ * Create a deterministic hash of the decision record
+ */
+export declare function hashDecision(record: Partial<DecisionRecord>): string;
+/**
+ * Verify that a hash matches the record
+ */
+export declare function verifyHash(record: DecisionRecord, expectedHash: string): boolean;
+/**
+ * Create a commitment object with hash and timestamp
+ */
+export declare function createCommitment(record: Partial<DecisionRecord>): {
+    hash: string;
+    timestamp: number;
+    dataHash: string;
+};
+/**
+ * Generate a short ID from hash (first 8 chars)
+ */
+export declare function shortHash(hash: string): string;

package/dist/ledger/hash.js

@@ -0,0 +1,69 @@
+"use strict";
+/**
+ * Trade Ledger - Integrity Hashing
+ *
+ * SHA-256 hashing for decision record integrity verification.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hashDecision = hashDecision;
+exports.verifyHash = verifyHash;
+exports.createCommitment = createCommitment;
+exports.shortHash = shortHash;
+const crypto_1 = require("crypto");
+/**
+ * Fields included in the hash (immutable decision data)
+ */
+const HASH_FIELDS = [
+    'userId',
+    'sessionId',
+    'timestamp',
+    'category',
+    'action',
+    'platform',
+    'marketId',
+    'inputs',
+    'analysis',
+    'constraints',
+    'confidence',
+    'decision',
+    'reason',
+];
+/**
+ * Create a deterministic hash of the decision record
+ */
+function hashDecision(record) {
+    const hashData = {};
+    for (const field of HASH_FIELDS) {
+        if (record[field] !== undefined) {
+            hashData[field] = record[field];
+        }
+    }
+    // Sort keys for deterministic serialization
+    const serialized = JSON.stringify(hashData, Object.keys(hashData).sort());
+    return (0, crypto_1.createHash)('sha256').update(serialized).digest('hex');
+}
+/**
+ * Verify that a hash matches the record
+ */
+function verifyHash(record, expectedHash) {
+    const computedHash = hashDecision(record);
+    return computedHash === expectedHash;
+}
+/**
+ * Create a commitment object with hash and timestamp
+ */
+function createCommitment(record) {
+    const timestamp = Date.now();
+    const dataHash = hashDecision(record);
+    // Commitment includes timestamp for uniqueness
+    const commitmentData = JSON.stringify({ dataHash, timestamp });
+    const hash = (0, crypto_1.createHash)('sha256').update(commitmentData).digest('hex');
+    return { hash, timestamp, dataHash };
+}
+/**
+ * Generate a short ID from hash (first 8 chars)
+ */
+function shortHash(hash) {
+    return hash.slice(0, 8);
+}
+//# sourceMappingURL=hash.js.map

package/dist/ledger/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../../src/ledger/hash.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AA2BH,oCAaC;AAKD,gCAGC;AAKD,4CAaC;AAKD,8BAEC;AAvED,mCAAoC;AAGpC;;GAEG;AACH,MAAM,WAAW,GAAG;IAClB,QAAQ;IACR,WAAW;IACX,WAAW;IACX,UAAU;IACV,QAAQ;IACR,UAAU;IACV,UAAU;IACV,QAAQ;IACR,UAAU;IACV,aAAa;IACb,YAAY;IACZ,UAAU;IACV,QAAQ;CACA,CAAC;AAEX;;GAEG;AACH,SAAgB,YAAY,CAAC,MAA+B;IAC1D,MAAM,QAAQ,GAA4B,EAAE,CAAC;IAE7C,KAAK,MAAM,KAAK,IAAI,WAAW,EAAE,CAAC;QAChC,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,SAAS,EAAE,CAAC;YAChC,QAAQ,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;IAED,4CAA4C;IAC5C,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAE1E,OAAO,IAAA,mBAAU,EAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC/D,CAAC;AAED;;GAEG;AACH,SAAgB,UAAU,CAAC,MAAsB,EAAE,YAAoB;IACrE,MAAM,YAAY,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IAC1C,OAAO,YAAY,KAAK,YAAY,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,SAAgB,gBAAgB,CAAC,MAA+B;IAK9D,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,QAAQ,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IAEtC,+CAA+C;IAC/C,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC;IAC/D,MAAM,IAAI,GAAG,IAAA,mBAAU,EAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAEvE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,SAAgB,SAAS,CAAC,IAAY;IACpC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC1B,CAAC"}

package/dist/ledger/hooks.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Trade Ledger - Hook Integration
+ *
+ * Auto-capture decisions via the Clodds hooks system.
+ */
+import type { DecisionOutcome, ConstraintEvaluation, LedgerConfig } from './types';
+import type { LedgerStorage } from './storage';
+export interface HookContext {
+    event: string;
+    message?: {
+        userId?: string;
+        chatId?: string;
+        text?: string;
+    };
+    session?: {
+        id?: string;
+        userId?: string;
+    };
+    toolName?: string;
+    toolParams?: Record<string, unknown>;
+    toolResult?: unknown;
+    data: Record<string, unknown>;
+    cancelled?: boolean;
+}
+/**
+ * Create ledger hook handlers
+ */
+export declare function createLedgerHooks(storage: LedgerStorage, config: LedgerConfig): {
+    beforeTool: (ctx: HookContext) => void;
+    afterTool: (ctx: HookContext) => void;
+};
+/**
+ * Capture an opportunity decision
+ */
+export declare function captureOpportunityDecision(storage: LedgerStorage, config: LedgerConfig, data: {
+    userId: string;
+    sessionId?: string;
+    opportunityId: string;
+    type: string;
+    edge: number;
+    liquidity: number;
+    constraints: ConstraintEvaluation[];
+    decision: DecisionOutcome;
+    reason: string;
+    confidence?: number;
+    platform?: string;
+    marketId?: string;
+}): string | null;
+/**
+ * Capture a copy trading decision
+ */
+export declare function captureCopyDecision(storage: LedgerStorage, config: LedgerConfig, data: {
+    userId: string;
+    sessionId?: string;
+    followedAddress: string;
+    originalTrade: Record<string, unknown>;
+    constraints: ConstraintEvaluation[];
+    decision: DecisionOutcome;
+    reason: string;
+    confidence?: number;
+    platform?: string;
+}): string | null;
+/**
+ * Capture a risk check decision
+ */
+export declare function captureRiskDecision(storage: LedgerStorage, config: LedgerConfig, data: {
+    userId: string;
+    sessionId?: string;
+    checkType: string;
+    proposed: number;
+    current?: number;
+    limit: number;
+    passed: boolean;
+    reason: string;
+    platform?: string;
+    marketId?: string;
+}): string | null;
+export interface CopyTraderEvents {
+    on(event: 'tradeCopied', listener: (data: {
+        target: {
+            address: string;
+            name?: string;
+            config: {
+                multiplier: number;
+                maxPositionSol: number;
+            };
+        };
+        trade: {
+            action: 'buy' | 'sell';
+            mint: string;
+            solAmount: number;
+            signature: string;
+        };
+        result: {
+            success: boolean;
+            solSpent?: number;
+            solReceived?: number;
+            error?: string;
+            signature?: string;
+        };
+    }) => void): void;
+}
+/**
+ * Integrate ledger with CopyTrader events
+ * Call this to auto-capture copy trading decisions
+ */
+export declare function integrateCopyTrader(storage: LedgerStorage, config: LedgerConfig, copyTrader: CopyTraderEvents, userId?: string): void;