clodds 1.6.26 → 1.7.0

package/README.md

@@ -29,9 +29,9 @@
 
 ---
 
-**Clodds** is a personal AI trading terminal for prediction markets, crypto spot, and **perpetual futures with leverage**. Run it on your own machine, chat via any of **21 messaging platforms**, trade across **10 prediction markets + 7 futures exchanges** (including on-chain Solana perps via Percolator), and manage your portfolio — all through natural conversation.
+**Clodds** is a personal AI trading terminal for prediction markets, crypto spot, perpetual futures with leverage, and **Bittensor subnet mining**. Run it on your own machine, chat via any of **21 messaging platforms**, trade across **10 prediction markets + 7 futures exchanges** (including on-chain Solana perps via Percolator), mine TAO on Bittensor, and manage your portfolio — all through natural conversation.
 
-Built on Claude with arbitrage detection algorithms based on [arXiv:2508.03474](https://arxiv.org/abs/2508.03474), which documented arbitrage patterns on Polymarket. See [Arbitrage Limitations](#arbitrage-limitations) for practical considerations.
+Powered by Claude with 118+ trading strategies, whale tracking, arbitrage detection, copy trading, and DCA bots.
 
 ---
 
@@ -55,6 +55,22 @@ npm run build && npm start
 ```
 </details>
 
+## Demo
+
+**30-second terminal onboarding** — See Clodds in action:
+
+[![Watch the demo video](https://img.shields.io/badge/▶-Watch%20Demo-blue?style=for-the-badge)](https://cloddsbot.com/onboard.mp4)
+
+The demo shows:
+- `npm install -g clodds` → `clodds onboard`
+- Onboarding wizard walks through credentials setup
+- Fetches live 15-minute BTC prediction markets from Polymarket (in real-time)
+- One command away from trading
+
+After the demo: Set your env vars or input credentials, then you're ready to trade.
+
+---
+
 ## WebChat
 
 Built-in browser interface at `http://localhost:18789/webchat` -- no setup, no third-party dependencies.
@@ -111,22 +127,31 @@ See [docs/USER_GUIDE.md](./docs/USER_GUIDE.md) for all commands.
 |----------|-----------------|
 | **Messaging** | 21 platforms (Telegram, Discord, WhatsApp, Slack, Teams, Signal, Matrix, iMessage, LINE, Nostr, and more) + built-in WebChat with sidebar, unlimited history, context compacting |
 | **Prediction Markets** | 10 platforms (Polymarket, Kalshi, Betfair, Smarkets, Drift, Manifold, Metaculus, PredictIt, Opinion.xyz, Predict.fun) |
+| **Polymarket Crypto Markets** | Deep expertise in BTC/ETH/SOL/XRP binary markets — 5-minute (BTC only), 15-minute, 1-hour, 4-hour, and daily rounds with round-based discovery, timing gates, and 4 automated strategies |
 | **Perpetual Futures** | 7 exchanges (Binance, Bybit, Hyperliquid, MEXC, Drift, Percolator, Lighter) with up to 200x leverage, database tracking, A/B testing |
 | **On-Chain Perps** | Percolator protocol — Solana-native perpetual futures with pluggable matchers, keeper cranking, real-time slab polling |
+| **Trading Strategies** | 118+ strategies including momentum, mean reversion, penny clipper, expiry fade, DCA bots, smart routing, whale tracking, copy trading |
+| **Risk Management** | Unified risk engine with circuit breaker, VaR/CVaR, volatility regime detection, stress testing, Kelly sizing, daily loss limits, kill switch |
+| **Backtesting** | Configurable strategy backtesting with historical data, SL/TP validation, P&L analysis |
+| **Skills System** | 119 bundled skills + lazy-loaded extensions (no missing dependencies crash) — chat-driven automation |
 | **Token Security** | GoPlus-powered audits — honeypot detection, rug-pull analysis, holder concentration, risk scoring |
 | **Security Shield** | Code scanning (75 rules), scam DB (70+ addresses), multi-chain address checking, pre-trade tx validation |
 | **Trading** | Order execution on 16+ platforms (prediction markets, futures, Solana DEXs, EVM DEXs), portfolio tracking, P&L, DCA |
+| **Market Data** | Real-time orderbooks, candles, liquidity tracking, depth analysis, price feeds across all platforms |
 | **MCP Server** | Expose all 119 skills as MCP tools for Claude Desktop and Claude Code |
 | **Arbitrage** | Cross-platform detection, combinatorial analysis, semantic matching, real-time scanning |
 | **AI** | 8 LLM providers, 4 specialized agents, semantic memory, 18 tools |
+| **Data Persistence** | SQLite (local), LanceDB (semantic memory + embeddings), PostgreSQL (analytics) — unlimited WebChat history, trade database, context compacting, hybrid search, user profiles |
 | **i18n** | 10 languages (EN, ZH, ES, JA, KO, DE, FR, PT, RU, AR) |
-| **Solana DeFi** | Jupiter, Raydium, Orca, Meteora, Kamino, MarginFi, Solend, Pump.fun, Bags.fm, AgentBets |
+| **Solana DeFi** | Jupiter, Raydium, Orca, Meteora, Kamino, MarginFi, Solend, Pump.fun, Bags.fm |
 | **EVM DeFi** | Uniswap V3, 1inch, PancakeSwap, Virtuals Protocol, Clanker, Veil, ENS (ETH, ARB, OP, Base, Polygon) |
-| **Smart Trading** | Whale tracking, copy trading, smart routing, MEV protection |
 | **Trade Ledger** | Decision audit trail with confidence calibration, SHA-256 integrity hashing, statistics |
 | **Crypto Whale Tracking** | Multi-chain whale monitoring (Solana, ETH, Polygon, ARB, Base, OP) |
 | **Payments** | x402 protocol for machine-to-machine USDC payments (Base + Solana) |
 | **Bridging** | Wormhole cross-chain token transfers |
+| **Agent Forum** | Agent-only discussion platform for market insights, strategy sharing, and voting (cloddsbot.com/forum) |
+| **Agent Marketplace** | Peer-to-peer marketplace for AI agents to buy/sell strategies, APIs, datasets with USDC escrow on Solana |
+| **Compute API** | Pay-per-use compute (LLM, code execution, web scraping, data, storage, trade execution) with USDC micropayments |
 | **Bittensor Mining** | Subnet mining with wallet management, earnings tracking, Chutes SN64 support |
 | **Automation** | Trading bots, cron jobs, webhooks, skills system |
 
@@ -321,60 +346,73 @@ Enable: `clodds config set ledger.enabled true`
 ## Architecture
 
 ```
-┌─────────────────────────────────────────────────────────────────────┐
-│                            GATEWAY                                   │
-│       HTTP • WebSocket • Auth • Rate Limiting • 1000 connections     │
-└─────────────────────────────────┬───────────────────────────────────┘
-                                  │
-        ┌─────────────────────────┼─────────────────────────┐
-        ▼                         ▼                         ▼
-┌───────────────┐         ┌───────────────┐         ┌───────────────┐
-│   CHANNELS    │         │    AGENTS     │         │    FEEDS      │
-│   (21)        │         │    (4)        │         │    (12+)      │
-├───────────────┤         ├───────────────┤         ├───────────────┤
-│ Telegram      │         │ Main          │         │ Polymarket    │
-│ Discord       │         │ Trading       │         │ Kalshi        │
-│ WhatsApp      │         │ Research      │         │ Betfair       │
-│ Slack         │         │ Alerts        │         │ Manifold      │
-│ Teams         │         │               │         │ Crypto (10)   │
-│ Matrix        │         │ Tools (18)    │         │               │
-│ Signal        │         │ Skills (118)  │         │ Arbitrage     │
-│ +14 more      │         │ Memory        │         │ Detector      │
-└───────────────┘         └───────────────┘         └───────────────┘
-        │                         │                         │
-        └─────────────────────────┼─────────────────────────┘
-                                  │
-        ┌─────────────────────────┼─────────────────────────┐
-        ▼                         ▼                         ▼
-┌───────────────┐         ┌───────────────┐         ┌───────────────┐
-│   TRADING     │         │   SOLANA      │         │   PAYMENTS    │
-│               │         │   DeFi        │         │   (x402)      │
-├───────────────┤         ├───────────────┤         ├───────────────┤
-│ Execution     │         │ Jupiter       │         │ Base USDC     │
-│ Portfolio     │         │ Raydium       │         │ Solana USDC   │
-│ Trade Logger  │         │ Orca          │         │ Auto-approve  │
-│ Bots          │         │ Meteora       │         │               │
-│ Risk Manager  │         │ Pump.fun      │         │ Wormhole      │
-│ Backtesting   │         │               │         │ Bridge        │
-└───────────────┘         └───────────────┘         └───────────────┘
-                                  │
-                          ┌───────────────┐
-                          │  BITTENSOR    │
-                          ├───────────────┤
-                          │ Wallet        │
-                          │ Subnet Mining │
-                          │ Earnings      │
-                          │ Chutes (SN64) │
-                          └───────────────┘
-                                  │
-                          ┌───────────────┐
-                          │  PERCOLATOR   │
-                          ├───────────────┤
-                          │ Slab Parser   │
-                          │ Trade CPI     │
-                          │ Keeper Crank  │
-                          │ Oracle Feed   │
-                          └───────────────┘
+┌──────────────────────────────────────────────────────────────────────────────┐
+│                         GATEWAY & USER INTERFACE                              │
+│  HTTP • WebSocket • Auth • Rate Limiting • 1000 connections                   │
+│  21 Messaging Channels: WebChat, Telegram, Discord, Slack, Teams, Matrix...  │
+└──────────────────────────────────────────┬─────────────────────────────────────┘
+                                           │
+┌──────────────────────────────────────────┴─────────────────────────────────────┐
+│                            AI AGENTS LAYER (4)                                 │
+│  Main (Claude) • Trading (Exec) • Research (Data) • Alerts (Monitor)          │
+│  119+ Skills • 18 Tools • LanceDB Memory • Semantic Reasoning                  │
+└──────────────────────────────────────────┬─────────────────────────────────────┘
+                                           │
+┌──────────────────────────────────────────┴─────────────────────────────────────┐
+│                    UNIFIED STRATEGY & RISK LAYER                               │
+│  118+ Strategies • Risk Engine (VaR/CVaR/Circuit Breaker) • Kelly Sizing      │
+│  Backtesting • Trade Ledger • Position Manager • Arbitrage Detection          │
+│  Whale Tracking • Copy Trading • MEV Protection • Smart Routing               │
+└──────────────────────────────────────────┬─────────────────────────────────────┘
+                                           │
+    ┌──────────────────────┬──────────────┼──────────────┬──────────────────────┐
+    ▼                      ▼              ▼              ▼                      ▼
+┌──────────────────┐ ┌──────────────┐ ┌──────────────┐ ┌─────────────┐ ┌──────────────┐
+│ PREDICTION       │ │ SOLANA DeFi  │ │ EVM DeFi     │ │ PERPETUAL   │ │ ON-CHAIN     │
+│ MARKETS          │ │              │ │              │ │ FUTURES     │ │ PERPS        │
+├──────────────────┤ ├──────────────┤ ├──────────────┤ ├─────────────┤ ├──────────────┤
+│ Polymarket:      │ │ Jupiter      │ │ Uniswap V3   │ │ Binance     │ │ Percolator   │
+│  • 5-min BTC     │ │ Raydium      │ │ 1inch        │ │  (125x)     │ │ (Solana)     │
+│  • 1h/4h/daily   │ │ Orca         │ │ PancakeSwap  │ │ Bybit       │ │              │
+│    (All assets)  │ │ Meteora      │ │ Virtuals     │ │  (100x)     │ │ Slab Parser  │
+│ Kalshi           │ │ Kamino       │ │ Clanker      │ │ Hyperliquid │ │ Keeper Crank │
+│ Betfair          │ │ MarginFi     │ │ Veil         │ │  (50x)      │ │ Oracle Feed  │
+│ Smarkets         │ │ Solend       │ │ (ETH, ARB,   │ │ MEXC (200x) │ │              │
+│ Drift           │ │ Pump.fun     │ │  OP, Base,   │ │ Drift       │ │ Settlement   │
+│ Opinion.xyz      │ │ Bags.fm      │ │  Polygon)    │ │  (Solana)   │ │ Monitoring   │
+│ Predict.fun      │ │              │ │              │ │ Percolator  │ │ Liquidation  │
+│ Manifold         │ │ Jito Bundles │ │ Flashbots    │ │ Lighter     │ │ Alerts       │
+│ Metaculus        │ │ MEV Protect. │ │ MEV Protect. │ │  (ARB)      │ │              │
+│ PredictIt        │ │              │ │              │ │             │ │ Up to 200x   │
+│                  │ │ WebSocket &  │ │ WebSocket &  │ │ WebSocket & │ │ leverage     │
+│ CLOB Orders      │ │ HTTP APIs    │ │ HTTP APIs    │ │ HTTP APIs   │ │              │
+│ Settlement       │ │              │ │              │ │             │ │ Fully        │
+│ Tracking         │ │ Real-time    │ │ Real-time    │ │ Liquidation │ │ On-chain     │
+└──────────────────┘ │ Price Feeds  │ │ Price Feeds  │ │ Monitoring  │ │              │
+                     │              │ │              │ │             │ │ No KYC       │
+    │ Gamma API │    │ Chainlink    │ │ Chainlink    │ │ Funding     │ │              │
+    │ Poll for  │    │ Feeds        │ │ Feeds        │ │ Rates       │ └──────────────┘
+    │ rounds    │    │              │ │              │ │             │
+    │ Execution │    │ Execution    │ │ Execution    │ │ Execution   │
+    └──────────┘    └──────────────┘ └──────────────┘ └─────────────┘
+                     │                │                │
+    ┌────────────────┴────────────────┴────────────────┴──────────────┐
+    │          COMMON EXECUTION & DATA LAYER                          │
+    │  Order Builder • Balance Checker • Slippage Estimator           │
+    │  Fee Calculator • Real-time P&L • Settlement Polling            │
+    │  Bittensor Mining (TAO) • x402 Payments (USDC)                 │
+    │  Agent Forum • Agent Marketplace • Compute API                  │
+    └────────────────────────┬─────────────────────────────────────────┘
+                             │
+                             ▼
+        ┌───────────────────────────────────────────────────┐
+        │       DATA PERSISTENCE LAYER                       │
+        ├───────────────────────────────────────────────────┤
+        │ SQLite: Local configs, WebChat, earnings          │
+        │ LanceDB: Semantic memory, embeddings, profiles    │
+        │ PostgreSQL: Trade history, analytics, backtest    │
+        │ Backup & Sync: 3x replication • Compression       │
+        └───────────────────────────────────────────────────┘
 ```
 
 ---

package/dist/gateway/index.js

@@ -388,6 +388,11 @@ function createGatewayServer(config) {
  * - Agent manager for non-command messages
  */
 async function createGateway(config) {
+    // Railway/Heroku inject PORT — override gateway port if set
+    const envPort = parseInt(process.env.PORT ?? '', 10);
+    if (envPort > 0 && envPort <= 65535) {
+        config = { ...config, gateway: { ...config.gateway, port: envPort } };
+    }
     let currentConfig = config;
     (0, http_1.configureHttpClient)(currentConfig.http);
     const configPath = process.env.CLODDS_CONFIG_PATH || config_1.CONFIG_FILE;
@@ -507,6 +512,19 @@ async function createGateway(config) {
         const { createAuditRouter } = await Promise.resolve().then(() => __importStar(require('./audit-routes.js')));
         httpGateway.setAuditRouter(createAuditRouter());
     }
+    // Wire Launch API router (Solana token launches via Meteora DBC)
+    {
+        const { createLaunchRouter } = await Promise.resolve().then(() => __importStar(require('./launch-routes.js')));
+        const { getSolanaConnection, loadSolanaKeypair } = await Promise.resolve().then(() => __importStar(require('../solana/wallet.js')));
+        try {
+            const launchConnection = getSolanaConnection();
+            const launchKeypair = loadSolanaKeypair();
+            httpGateway.setLaunchRouter(createLaunchRouter(launchConnection, launchKeypair));
+        }
+        catch (err) {
+            logger_1.logger.warn({ err }, 'Launch API: Solana wallet not configured — launch endpoints disabled');
+        }
+    }
     // DCA router is wired later (after executionService is created) so it can start the engine
     // Create alt-data sentiment pipeline if enabled
     let altDataService = null;