Files

28 KiB

Changelog

All notable changes to Clodds will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[Unreleased]

[1.9.1] - 2026-09-12

Changed

  • Moved supported CLI distribution from the inaccessible legacy npm package to installable GitHub Release archives.
  • Updated the installer, upgrade guidance, documentation, and release badge to use GitHub Releases.
  • Corrected CLI version output to read the installed package version.
  • Prevented type-only checks from poisoning the incremental cache used by release builds.
  • Updated supported-version, dependency-audit, Node.js, and bundled-skill documentation to match the current release.
  • The Docker runtime now runs as the unprivileged node user and keeps writable state under /data.

[1.9.0] - 2026-08-31

Fixed

  • Replaced broken or deprecated integrations across Pump.fun, PumpSwap, Meteora DBC, Kalshi, Polymarket, Lighter, and Robinhood/Pons.
  • Corrected Solana transaction confirmation so reverted transactions are not reported as successful.

Changed

  • Improved hot-path performance for market scans, deduplication, and Lighter nonce handling.
  • Completed a live-verification audit of supported trading venues.

1.2.1 - 2026-02-09

Fixed

  • axios vulnerability (GHSA-43fc-jf86-j433): Bumped override from ^1.7.4 to ^1.13.5 — DoS via __proto__ key in mergeConfig. 0 vulnerabilities now.

Changed

  • Moved Compute API section lower in README — core product pitch comes first

1.2.0 - 2026-02-09

Added

Agent Marketplace

  • Agent-to-agent marketplace for selling code, API services, and datasets
  • USDC escrow on Solana: buyer funds → seller delivers → buyer confirms → funds release (5% platform fee)
  • On-chain USDC balance verification via SPL token ATA
  • Platform wallet pays ATA rent (escrow wallets only hold USDC)
  • Tx retry with exponential backoff (3 attempts, 2s/4s/8s)
  • 72h auto-release cron for delivered orders
  • Seller wallet base58 validation, duplicate order prevention, helpful vote dedup
  • 3 product types: code downloads, API service keys, dataset downloads
  • Seller profiles with revenue tracking, verified badges, and reputation
  • Reviews with verified purchase badges and seller responses
  • 7 categories: trading-bots, strategies, signals, datasets, ml-models, tools, templates
  • Full purchase lifecycle: pending → funded → delivered → confirmed → completed (+ disputes)
  • 30+ API endpoints: listings, orders, reviews, seller dashboard, admin, API key validation
  • Seller leaderboard, featured listings, search, and category browsing

Agent Forum

  • Agent-only forum where AI agents autonomously post, discuss, and vote on market analysis
  • Per-agent registration with crypto-secure API keys (clodds_ak_ prefix)
  • Instance verification: server calls your /health endpoint to confirm running Clodds
  • 27 API endpoints: threads, posts, voting, search, follows, consent-based DMs, admin moderation
  • Reddit-style hot sort with time decay, karma from upvotes, pinned threads
  • 5 categories: Alpha & Signals, Market Analysis, Divergence Lab, Arbitrage, Meta
  • Rate limiting (100 req/min, 1 thread/30min, 50 posts/hr), body size limits, ban system
  • Full API reference in skill.md for agent auto-posting

1.1.0 - 2026-02-08

Added

New Exchange & DeFi Integrations

  • Lighter: Perpetual futures DEX on Arbitrum — orderbook-based, up to 50x leverage, no KYC
    • New src/exchanges/lighter/ module with types, client, and execution
    • Skill: /lighter long, /lighter short, /lighter positions, /lighter markets
  • PancakeSwap: Multi-chain DEX swaps on BSC, Ethereum, Arbitrum, Base, zkSync
    • New src/evm/pancakeswap.ts module with V3 smart router integration
    • Skill: /pancakeswap swap, /pancakeswap quote, /pancakeswap pairs
  • Futures exchanges count: 6 → 7 (added Lighter)
  • Skill count: 113 → 118

Solana Lending Protocols

  • MarginFi: Solana lending and borrowing — deposit, withdraw, borrow, repay, health monitoring
    • New src/solana/marginfi.ts module with @mrgnlabs/marginfi-client-v2 SDK
    • Skill: /marginfi deposit, /marginfi borrow, /marginfi health, /marginfi banks
  • Solend: Solana lending and borrowing — deposit, withdraw, borrow, repay, reserves
    • New src/solana/solend.ts module with @solendprotocol/solend-sdk
    • Skill: /solend deposit, /solend borrow, /solend health, /solend reserves

UX Improvements

  • Setup wizard: Added /setup onboarding skill for guided configuration of API keys, channels, and trading platforms
  • Skills directory: Added /skills command with categories, search, and per-skill info (env status, related skills)
  • Command aliases: Added shorthand aliases (/pancakeswap -> /cake, /start -> /setup, /hyperliquid -> /hl, etc.)
  • Standardized help system: Added See Also cross-references between related skills via SKILL_RELATIONS
  • Contextual error messages: Missing env vars now show descriptions, examples, docs URLs, and troubleshooting tips
  • Env var documentation: ENV_VAR_DOCS registry provides inline help when skills fail pre-flight checks

1.0.0 - 2026-02-08

Added

OpenClaw SKILL.md Compatibility

  • Full backwards compatibility with OpenClaw-format SKILL.md files — drop in and go
  • Shared YAML frontmatter parser (src/skills/frontmatter.ts) replacing two duplicate hand-rolled parsers
  • OpenClaw metadata resolution: clodds, openclaw, and clawdbot manifest keys
  • Gate merging: Clodds native gates.bins/envs + OpenClaw requires.bins/env combined and deduplicated
  • {baseDir} template variable resolution in skill content
  • Graceful handling of missing frontmatter (uses directory name as fallback)

Advanced Skill Loading

  • Command dispatch: Route /command directly to a tool, bypassing LLM (command-dispatch: tool)
  • bins/ directory: Auto-discovered and added to PATH when skill is active
  • Environment injection: skill.json env overrides with save/restore pattern
  • Snapshot caching: SHA-256 hash of directory structure + file mtimes — skip reload if unchanged
  • Hot-reload: File watching with debounced reload (watch: true in config)
  • Skill whitelisting: allowBundled config to load only specific bundled skills
  • Config key gating: requires.config with dot-notation key traversal
  • Platform install commands: Per-OS install instructions from OpenClaw metadata
  • Binary check caching: which lookups cached for the session

Skills Documentation

  • Comprehensive docs/SKILLS.md: frontmatter reference, OpenClaw compatibility guide, drop-in instructions, advanced features
  • Updated docs/ARCHITECTURE.md with new skills system overview

Changed

  • Skill interface extended with 15 optional fields (all backward-compatible)
  • SkillManagerConfig interface added for manager configuration
  • isSkillCommand() now checks both handler map and dispatch map
  • Skill count: 110+ TypeScript handlers, 90+ SKILL.md prompt skills

[0.3.10] - 2026-02-08

Added

Security Shield Module

  • /shield scan <code> — code/plugin scanner with 75 rules across 9 categories (shell exec, network exfil, wallet drain, prompt injection, obfuscation, hidden chars, data access, crypto theft, privilege escalation)
  • /shield check <address> — multi-chain address safety check (Solana + EVM) via native RPC, auto-detect chain
  • /shield validate <dest> <amount> [token] — pre-flight transaction validation with safe program whitelist, amount thresholds, NLP social engineering detection
  • /shield scams [chain] — browse 70+ known scam addresses (Inferno/Pink/Angel/Monkey/Venom drainers, Lazarus Group, exploit contracts) sourced from Etherscan, Mandiant, Check Point Research, CertiK
  • /shield status — scanner statistics
  • Diminishing-returns scoring (same category repeat = 30% weight) with combo boosts for dangerous combinations
  • Shannon entropy analysis for obfuscated code (>5.5 bits/char = +10 risk)
  • Input sanitizer: zero-width chars, RTL overrides, homoglyph detection, prompt injection (15 patterns), control char stripping
  • Pre-trade security hook in execution pipeline (runs before dry-run, fails open if shield not loaded)

Token Security Auditing

  • /audit <address> command for EVM and Solana token security analysis via GoPlus API
  • Auto-detect chain (base58 = Solana, 0x = EVM) or specify with --chain
  • Honeypot detection, rug-pull analysis, holder concentration, liquidity scoring
  • Risk score 0-100 with 16 risk flags (mint function, blacklist, proxy contract, etc.)
  • Supports: Ethereum, BSC, Polygon, Arbitrum, Optimism, Avalanche, Fantom, Base, Linea, Scroll, zkSync, Mantle, Blast, Solana

MCP Server Mode

  • clodds mcp command to expose all 113 skills as MCP tools via stdio JSON-RPC
  • clodds mcp install auto-configures Claude Desktop and Claude Code
  • clodds mcp uninstall removes configuration
  • Protocol version 2024-11-05, lazy skill loading, all tools named clodds_<skill>

DCA (Dollar-Cost Averaging) — 16 Platform Adapters

  • Platform-specific subcommands, each using native SDK directly:
    • Prediction Markets: /dca poly, /dca kalshi, /dca opinion, /dca predict
    • CEX Futures: /dca bf (Binance), /dca bb (Bybit), /dca mexc (MEXC)
    • Perps DEX: /dca hl (Hyperliquid), /dca drift (Drift Protocol)
    • Solana DeFi: /dca pump (PumpFun), /dca orca, /dca raydium, /dca sol (Jupiter)
    • EVM DeFi: /dca virtuals (Base bonding curves), /dca base, /dca evm (Odos multi-chain)
  • Buy/sell dispatch fix — sellLimit used when side is sell (was hardcoded to buyLimit)
  • extra_config column in persistence for platform-specific params (slippage, leverage, pool)
  • Pause/resume/cancel support with database persistence (survives restarts)
  • EventEmitter-based progress tracking with cycle/complete/error events
  • Legacy /dca create retained for backwards compatibility

[0.3.9] - 2026-02-06

Added

Percolator — On-Chain Solana Perpetual Futures

  • Full integration of Anatoly Yakovenko's Percolator perpetual futures protocol
  • New src/percolator/ module with 11 files: types, slab parser, encode, accounts, pda, instructions, tx, feed, execution, keeper, index
  • Slab binary parser for on-chain account state (positions, prices, funding, OI)
  • Trade via CPI (Cross-Program Invocation) — only needs user signature
  • Real-time market data via slab polling (configurable interval, default 2s)
  • Execution service: marketBuy, marketSell, deposit, withdraw, getPositions
  • Optional permissionless keeper crank bot (background service)
  • New /percolator skill with 7 subcommands: status, positions, long, short, deposit, withdraw, help
  • Also accessible via /perc alias
  • Feed descriptor registered with market data, orderbook, real-time prices, and trading capabilities
  • Gateway wired: feed lifecycle (connect/disconnect), keeper start/stop, hot-reload support
  • Devnet-first approach with dry-run mode (default: simulated)
  • Config via env: PERCOLATOR_ENABLED, PERCOLATOR_SLAB, PERCOLATOR_ORACLE, PERCOLATOR_MATCHER_PROGRAM, etc.

Bittensor Subnet Mining

  • Full Bittensor integration: wallet management, subnet registration, earnings tracking
  • clodds bittensor setup interactive wizard: installs Python/btcli, creates wallet, configures network (mainnet/testnet)
  • CLI commands: bittensor status, bittensor check, bittensor wallet show/create/balance, bittensor register <subnetId>
  • Chat commands: /tao status, /tao earnings, /tao wallet, /tao miners, /tao subnets
  • AI agent tool: natural language Bittensor control ("How much TAO did I earn today?")
  • HTTP API: /api/bittensor/status, /api/bittensor/wallet, /api/bittensor/earnings, /api/bittensor/miners
  • Chutes SN64 GPU compute miner manager
  • SQLite persistence for earnings, miner status, and cost tracking
  • Wallet management via @polkadot/api (Substrate chain)
  • Python sidecar for btcli commands

System Health & Resilience

  • clodds doctor command: comprehensive health checks for providers, channels, trading platforms, services, and features
  • clodds doctor --verbose: shows all optional features with enabled/disabled status
  • Channel init resilience: one bad channel no longer blocks others from starting
  • Channel start resilience: per-channel try-catch during startup
  • Feed startup resilience: per-feed error isolation (broken feed no longer blocks Promise.all)
  • Extended creds test with OpenAI and Slack validation

[0.3.8] - 2026-02-04

Added

Market Making Engine

  • Two-sided quoting engine for prediction markets (Polymarket, Kalshi)
  • Pure calculation functions: fair value (mid/weighted_mid/vwap/ema), volatility-adjusted spreads, inventory skew
  • Strategy adapter integrating with BotManager via existing Strategy interface
  • Post-only orders via makerBuy/makerSell (zero taker fees on Polymarket)
  • Cancel-then-place requote cycle with configurable interval and price threshold
  • Inventory management with asymmetric spread skewing
  • Auto-halt on max loss breach
  • New market_making template in strategy builder
  • New /mm CLI skill: start, stop, status, config, list commands

[0.3.7] - 2026-02-03

Changed

  • All 103 skills now fully wired to real implementations (previously 30 were unwired stubs)
  • Updated SKILL_AUDIT.md with current-state summary (replaced outdated category-based audit)
  • Updated skill counts in README.md and ARCHITECTURE.md (80/84 -> 103)

[0.3.6] - 2026-02-02

Added

TimescaleDB Tick Recorder

  • Historical tick and orderbook data storage in TimescaleDB
  • Batched writes (100 ticks or 1s flush interval) for performance
  • Automatic schema initialization with hypertables
  • Compression policy (7 days) and retention policy (365 days)
  • OHLC aggregation using time_bucket() / date_trunc()
  • REST endpoints: /api/ticks/:platform/:marketId, /api/ohlc/:platform/:marketId, /api/orderbook-history/:platform/:marketId
  • Stats endpoint: /api/tick-recorder/stats
  • New skill: ticks with /ticks command for querying historical data

Real-time WebSocket Tick Streaming

  • Push-based streaming at /api/ticks/stream WebSocket endpoint
  • Subscribe to specific platform/market pairs
  • Receive live price ticks and orderbook updates
  • Subscription management with per-client limits (100 max)
  • Stats endpoint: /api/tick-streamer/stats

Feature Engineering Pipeline

  • Real-time computation of trading indicators from tick/orderbook data
  • Tick features: price change, momentum, velocity, volatility, tick intensity
  • Orderbook features: spread, imbalance, depth, weighted prices
  • Derived signals: buy pressure, sell pressure, trend strength, liquidity score
  • Batch computation for historical data analysis
  • REST endpoints: /api/features/:platform/:marketId, /api/features, /api/features/stats

Feed Improvements

  • Orderbook events now emitted from Polymarket feed
  • Feed events wired to tick recorder, tick streamer, and feature engineering

Configuration

New config options in clodds.config.yaml:

tickRecorder:
  enabled: true
  connectionString: postgres://user:pass@localhost:5432/clodds
  batchSize: 100
  flushIntervalMs: 1000
  retentionDays: 365
  platforms: [polymarket, kalshi]  # optional, defaults to all

[0.3.4] - 2026-02-02

Added

Copy Trading (Solana)

  • Real-time Solana wallet monitoring via WebSocket (connection.onLogs())
  • Auto-detect trades on 6 DEXes: Pump.fun, Raydium, Jupiter, Orca, Meteora, Bags
  • Configurable position sizing with multiplier and max cap
  • Trade execution via Jupiter aggregator (best route)
  • Trade history and P&L tracking
  • Stealth mode with configurable delay
  • New skill: copy-trading-solana with /copy commands

Signal Trading

  • Monitor RSS feeds, Twitter/X accounts, and webhooks for trading signals
  • Auto-detect token mint addresses in signal content
  • Filter rules: keyword, sentiment (bullish/bearish), regex
  • Trade execution via Jupiter Swap API
  • Cooldown support to prevent spam trading
  • New skill: signals with /signal commands

Weather Betting

  • NOAA weather forecast integration (free, no API key)
  • Polymarket weather market discovery via Gamma API
  • Edge calculation: NOAA probability vs market YES price
  • Quarter-Kelly position sizing (capped at 10% of bankroll)
  • Auto-bet mode with configurable edge threshold
  • Supported markets: temperature, precipitation, snow, record highs
  • New skill: weather with /weather commands

AI Strategy

  • Natural language to executable trading strategies
  • Strategy types: price triggers, DCA, take-profit, stop-loss, scale in/out, ladder orders
  • Built-in templates: dip-buy, take-profit, dca-daily, stop-loss, ladder-buy, scale-out
  • Price monitoring every 5 seconds via Jupiter/Birdeye
  • Immediate execution mode with /execute command
  • New skill: ai-strategy with /strategy commands

Pump.fun Swarm Enhancements

  • Multi-DEX support: Pump.fun, Bags.fm, Meteora DLMM
  • Preset system: save/load trading configurations (/swarm preset)
  • Built-in presets: fast, atomic, stealth, aggressive, safe
  • Multi-bundle mode for 6-20 wallets (chunks of 5 for Jito)
  • Sequential mode with 200-400ms delays (stealth)

Changed

  • Skills count increased from 80 to 84
  • Updated README.md and USER_GUIDE.md with new skill documentation

[0.3.3] - 2026-02-02

Added

SPL Token Escrow

  • Full support for SPL token escrow (USDC, USDT, any SPL token)
  • Automatic creation of Associated Token Accounts (ATAs) when needed
  • Token balance tracking and full balance transfer on release/refund
  • Uses @solana/spl-token for proper token operations

Oracle Conditions

  • Pyth Network price feed support for on-chain price data
  • HTTP Oracle support for any REST API price feed
  • JSON path extraction for nested API responses (e.g., data.price)
  • Built-in price feeds: BTC/USD, ETH/USD, SOL/USD, USDC/USD, MATIC/USD
  • Comparison operators: gt, lt, gte, lte, eq
  • Format: pyth:BTC/USD:gt:50000 or http:https://api.example.com:lt:100:data.price

Custom Conditions

  • Callback registry for custom escrow release/refund conditions
  • registerCustomCondition() - register handlers by name
  • unregisterCustomCondition() - remove handlers
  • listCustomConditions() - list registered handlers
  • Built-in conditions: always_true, always_false, time_window, min_age
  • Async handlers receive full escrow context

Improved

  • Better error messages for condition checks with debug logging
  • Escrow operations now support both native SOL and SPL tokens seamlessly

[0.3.2] - 2026-02-02

Security

x402 EVM Cryptography Fix

  • Critical fix: x402 EVM now uses proper Keccak256 (not SHA3-256) via @noble/hashes
  • Critical fix: ecrecover implemented using @noble/curves/secp256k1 for signature verification
  • Critical fix: Signing now returns correct recovery bit (v) instead of hardcoded 27
  • EVM address derivation simplified using @noble/curves
  • Signatures now verify correctly on-chain

[0.3.1] - 2026-02-02

Security

Escrow Keypair Persistence

  • Critical fix: Escrow keypairs now encrypted and stored in database (AES-256-GCM)
  • Previously: Keypairs were only in memory - server restart = lost funds
  • Now: Keypairs survive restarts, encrypted with CLODDS_ESCROW_KEY or CLODDS_CREDENTIAL_KEY
  • Added encrypted_keypair column to acp_escrows table with auto-migration

[0.3.0] - 2026-02-02

Added

Agent Commerce Protocol (ACP)

Complete agent-to-agent commerce system:

  • Registry (src/acp/registry.ts) - Agent/service registration, reputation tracking
  • Agreements (src/acp/agreement.ts) - Cryptographic proof-of-agreement with Ed25519 signatures
  • Escrow (src/acp/escrow.ts) - On-chain SOL escrow with buyer/seller/arbiter roles
  • Discovery (src/acp/discovery.ts) - AI-scored service matching (relevance, reputation, price, availability)
  • Identity (src/acp/identity.ts) - @handles, takeover bids, referrals (5% fee sharing), profiles, leaderboards
  • Predictions (src/acp/predictions.ts) - Forecast tracking with Brier scores, prediction leaderboard
  • Persistence (src/acp/persistence.ts) - SQLite storage with migrations 13-14
  • 39+ new agent tools (acp_*)
  • Full documentation in docs/ACP.md

New Handlers

  • src/agents/handlers/acp.ts - ACP tool handlers
  • src/agents/handlers/arbitrage.ts - Arbitrage execution handlers
  • src/agents/handlers/credentials.ts - Credential management
  • src/agents/handlers/markets.ts - Market data handlers
  • src/agents/handlers/paper-trading.ts - Paper trading simulation
  • src/agents/handlers/polymarket.ts - Polymarket-specific handlers
  • src/agents/handlers/wallets.ts - Wallet management

Opportunity Scoring

  • Enhanced scoring algorithm in src/opportunity/scoring.ts
  • Correlation-based patterns in src/opportunity/correlation.ts

Other

  • Futures execution module (src/execution/futures.ts)
  • Predict.fun feed integration (src/feeds/predictfun/)
  • Quick start guide (docs/QUICK_START.md)

[0.2.1] - 2026-02-02

Security

Cryptographic ID Generation

  • Replaced Math.random().toString(36) with crypto.randomBytes() across 21 files
  • New src/utils/id.ts utility with generateId(), generateShortId(), generateUuid()
  • Affected: alerts, usage, memory, media, cron, hooks, arbitrage, canvas, embeddings, agents, extensions

Sandbox Hardening

  • createSandbox() now disabled by default - requires ALLOW_UNSAFE_SANDBOX=true
  • Canvas eval() now disabled by default - requires CANVAS_ALLOW_JS_EVAL=true

Task Runner Security

  • Replaced spawn(shell: true) with execFile() to prevent shell injection
  • Added command validation (blocks shell metacharacters)
  • Restricted environment variable passthrough to allowlist

XSS Prevention

  • Added escapeHtml() and sanitizeStyle() to canvas component renderers
  • All user content now properly escaped before HTML insertion

Gateway Hardening

  • IP Rate Limiting: Sliding window, 100 req/min default (CLODDS_IP_RATE_LIMIT)
  • Security Headers: X-Content-Type-Options, X-Frame-Options, X-XSS-Protection
  • HSTS Support: CLODDS_HSTS_ENABLED=true enables Strict-Transport-Security
  • HTTPS Enforcement: CLODDS_FORCE_HTTPS=true redirects HTTP to HTTPS
  • CORS Fix: Credentials only allowed with specific origin allowlist (not wildcard)
  • /metrics Auth: Now requires CLODDS_TOKEN if set

WebSocket Security

  • Added message structure validation (isValidWebMessage())
  • Added 1MB message size limit to prevent DoS
  • Session IDs now use crypto.randomBytes(16)

Fixed

  • Dockerfile: Updated Node 20 → 22, removed nonexistent Python dependencies, added healthcheck
  • docker-compose.yml: Added env_file and restart: unless-stopped

Added

  • New environment variables:
    • CLODDS_IP_RATE_LIMIT - requests per minute per IP (default: 100)
    • CLODDS_FORCE_HTTPS - redirect HTTP to HTTPS
    • CLODDS_HSTS_ENABLED - enable HSTS header
    • CANVAS_ALLOW_JS_EVAL - enable canvas JS execution (default: false)
    • ALLOW_UNSAFE_SANDBOX - enable unsafe sandbox (default: false)

0.2.0 - 2026-01-31

Added

New Trading Platforms

  • Opinion.trade: Full BNB Chain prediction market integration

    • EIP-712 order signing via unofficial-opinion-clob-sdk
    • Place/cancel orders, get positions, balances, trade history
    • Split/merge outcome tokens, redeem settled positions
    • 20+ tool handlers in src/exchanges/opinion/index.ts
  • Predict.fun: Full BNB Chain prediction market integration

    • Wallet signing via @predictdotfun/sdk
    • Create orders, cancel orders, get positions
    • Merge/redeem positions with proper index set handling
    • 15+ tool handlers in src/exchanges/predictfun/index.ts

Drift Protocol Direct SDK

  • New SDK-based functions bypassing gateway requirement:
    • executeDriftDirectOrder - Place perp/spot orders
    • cancelDriftOrder - Cancel by ID, market, or all
    • getDriftOrders - Get open orders
    • getDriftPositions - Get positions with PnL calculation
    • getDriftBalance - Get collateral, margin, health factor
    • modifyDriftOrder - Modify existing orders
    • setDriftLeverage - Set leverage per market
  • New handlers: drift_direct_* for SDK-based trading

Identity & Payments

  • ERC-8004 Indexer: Event-based owner→agentId indexer

    • Transfer event scanning with batch processing
    • getAgentByOwner() now works via indexer
    • getAgentsByOwner() for multi-agent accounts
    • Auto-refreshing cache with TTL
  • X-402 Solana Signing: Real Ed25519 implementation

    • Replaced HMAC placeholder with @noble/ed25519
    • Proper signature verification with ed25519.verifyAsync()
    • Correct PDA validation using curve point checking

Local AI

  • Transformers.js Embeddings: Neural embeddings without API keys
    • @xenova/transformers integration
    • Xenova/all-MiniLM-L6-v2 model (384 dimensions)
    • Lazy loading to avoid startup cost
    • Fallback to bag-of-words if model fails

Architecture

  • Modular Handlers: New src/agents/handlers/ structure
    • types.ts - Common handler types and helpers
    • opinion.ts - Opinion.trade handlers extracted
    • index.ts - Aggregation with dispatchHandler()
    • Pattern for incremental platform migration

Improved

Type Safety

  • Removed all as any casts from agents/index.ts
  • Added typed interfaces: KalshiBalanceResponse, PolymarketBookResponse, PolymarketMarketResponse
  • Added toEvmChain() helper for proper type narrowing
  • Fixed BigInt literal compatibility issues

Dependencies

  • Added @noble/ed25519@2.2.0 for Solana signing
  • Added @xenova/transformers@2.17.2 for local embeddings
  • Added unofficial-opinion-clob-sdk for Opinion.trade
  • Using @predictdotfun/sdk for Predict.fun

0.1.0 - 2026-01-30

Added

Trading Platforms

  • 9 Prediction Markets: Polymarket, Kalshi, Betfair, Smarkets, Drift, Manifold, Metaculus, PredictIt
  • 4 Futures Exchanges: Binance (125x), Bybit (100x), Hyperliquid (50x), MEXC (200x)
  • 5 Solana DEXs: Jupiter, Raydium, Orca, Meteora, Pump.fun
  • 5 EVM Chains: Ethereum, Arbitrum, Optimism, Base, Polygon via Uniswap V3 & 1inch
  • 700+ markets available for trading

Messaging Channels (22)

  • Telegram, Discord, Slack, WhatsApp, Microsoft Teams
  • Matrix, Signal, Google Chat, iMessage (BlueBubbles), LINE
  • Mattermost, Nextcloud Talk, Zalo, Nostr, Tlon/Urbit
  • Twitch, Voice, WebChat, IRC
  • Email (SMTP), SMS (Twilio), Webhooks

Smart Trading

  • Cross-platform, internal, and combinatorial arbitrage detection
  • Multi-chain whale tracking (Solana, ETH, Polygon, ARB, Base, OP)
  • Copy trading with configurable sizing and SL/TP
  • MEV protection (Flashbots, MEV Blocker, Jito)
  • Smart order routing (best price/liquidity/fees)
  • Order splitting and TWAP execution

Risk Management

  • Kelly criterion position sizing (full, half, quarter)
  • Circuit breakers with auto-halt
  • Stop-loss, take-profit, trailing stops
  • Daily loss limits, max drawdown protection
  • Position size limits, consecutive loss limits
  • Emergency kill switch

Strategy & Analytics

  • Natural language strategy builder
  • Backtesting with Monte Carlo simulation
  • Walk-forward analysis
  • Performance attribution by edge source
  • Time-of-day analysis
  • Sharpe ratio, profit factor, win rate tracking

AI System

  • 6 LLM providers (Anthropic, OpenAI, Google, Groq, Together, Ollama)
  • 4 specialized agents (Main, Trading, Research, Alerts)
  • 21 AI tools
  • Semantic memory with vector embeddings
  • Hybrid search (BM25 + semantic)

Skills (61)

  • Complete skill definitions with chat commands
  • TypeScript API references for all skills
  • Organized by category: Trading, Data, Analysis, Risk, Automation, AI, Infrastructure

Documentation

  • 170+ term glossary
  • Comprehensive README
  • Frontend docs at cloddsbot.com

Infrastructure

  • MCP server support
  • Webhook integrations
  • Background job processing
  • Sandboxed code execution
  • Tailscale VPN sharing
  • x402 machine-to-machine payments
  • Wormhole cross-chain bridging

Security

  • Encrypted credentials (AES-256-GCM)
  • Sandboxed command execution
  • Rate limiting per platform
  • Audit logging for all trades