clodds 1.2.8 → 1.3.0

package/dist/skills/bundled/credentials/SKILL.md

@@ -0,0 +1,261 @@
+---
+name: credentials
+description: "Secure credential management for trading platforms"
+emoji: "🔐"
+---
+
+# Credentials - Complete API Reference
+
+Securely store and manage API credentials for trading platforms with AES-256-GCM encryption.
+
+---
+
+## Chat Commands
+
+### Add Credentials
+
+```
+/creds add polymarket                       Interactive setup
+/creds add kalshi --key abc --secret xyz    Direct setup
+/creds add binance                          Add Binance API
+/creds add hyperliquid                      Add wallet key
+```
+
+### View Credentials
+
+```
+/creds list                                 List configured platforms
+/creds status                               Check credential health
+/creds test polymarket                      Test API connection
+```
+
+### Remove Credentials
+
+```
+/creds remove polymarket                    Remove platform creds
+/creds clear                                Clear all (careful!)
+```
+
+### Auth Status
+
+```
+/auth status                                Overall auth status
+/auth refresh kalshi                        Refresh tokens
+/auth cooldown                              View cooldown status
+```
+
+---
+
+## TypeScript API Reference
+
+### Create Credentials Manager
+
+```typescript
+import { createCredentialsManager } from 'clodds/credentials';
+
+const creds = createCredentialsManager({
+  // Encryption key (required)
+  encryptionKey: process.env.CREDENTIALS_KEY,
+
+  // Storage backend
+  storage: 'sqlite',  // 'sqlite' | 'postgres'
+  dbPath: './credentials.db',
+
+  // Cooldown settings
+  cooldownMinutes: 15,
+  maxFailures: 3,
+});
+```
+
+### Set Credentials
+
+```typescript
+// Polymarket (API + signing key)
+await creds.setCredentials({
+  userId: 'user-123',
+  platform: 'polymarket',
+  credentials: {
+    apiKey: 'pk_...',
+    apiSecret: 'sk_...',
+    privateKey: '0x...',  // For order signing
+    funderAddress: '0x...',
+  },
+});
+
+// Kalshi (API key)
+await creds.setCredentials({
+  userId: 'user-123',
+  platform: 'kalshi',
+  credentials: {
+    email: 'user@example.com',
+    apiKey: 'key_...',
+  },
+});
+
+// Binance Futures
+await creds.setCredentials({
+  userId: 'user-123',
+  platform: 'binance',
+  credentials: {
+    apiKey: 'abc...',
+    apiSecret: 'xyz...',
+  },
+});
+
+// Hyperliquid (wallet)
+await creds.setCredentials({
+  userId: 'user-123',
+  platform: 'hyperliquid',
+  credentials: {
+    privateKey: '0x...',
+    walletAddress: '0x...',
+  },
+});
+```
+
+### Get Credentials
+
+```typescript
+// Get for specific platform
+const polymarketCreds = await creds.getCredentials({
+  userId: 'user-123',
+  platform: 'polymarket',
+});
+
+if (polymarketCreds) {
+  console.log(`API Key: ${polymarketCreds.apiKey}`);
+  // Credentials are decrypted on retrieval
+}
+
+// List user's configured platforms
+const platforms = await creds.listUserPlatforms('user-123');
+console.log(`Configured: ${platforms.join(', ')}`);
+```
+
+### Delete Credentials
+
+```typescript
+// Remove single platform
+await creds.deleteCredentials({
+  userId: 'user-123',
+  platform: 'kalshi',
+});
+
+// Remove all for user
+await creds.deleteAllCredentials('user-123');
+```
+
+### Test Credentials
+
+```typescript
+// Test API connection
+const result = await creds.testCredentials({
+  userId: 'user-123',
+  platform: 'polymarket',
+});
+
+if (result.success) {
+  console.log(`✓ Connected to ${result.platform}`);
+  console.log(`  Balance: $${result.balance}`);
+} else {
+  console.log(`✗ Failed: ${result.error}`);
+}
+```
+
+### Cooldown Management
+
+```typescript
+// Mark failed auth attempt
+await creds.markFailure({
+  userId: 'user-123',
+  platform: 'kalshi',
+  error: 'Invalid API key',
+});
+
+// Check if in cooldown
+const inCooldown = await creds.isInCooldown({
+  userId: 'user-123',
+  platform: 'kalshi',
+});
+
+if (inCooldown) {
+  const remaining = await creds.getCooldownRemaining({
+    userId: 'user-123',
+    platform: 'kalshi',
+  });
+  console.log(`Cooldown: ${remaining} minutes remaining`);
+}
+
+// Mark successful auth (resets failures)
+await creds.markSuccess({
+  userId: 'user-123',
+  platform: 'kalshi',
+});
+```
+
+### Build Trading Context
+
+```typescript
+// Get ready-to-use trading context
+const context = await creds.buildTradingContext({
+  userId: 'user-123',
+  platform: 'polymarket',
+});
+
+// Context includes authenticated client
+await context.client.getBalance();
+await context.client.placeOrder({ ... });
+```
+
+---
+
+## Supported Platforms
+
+| Platform | Credentials Required |
+|----------|---------------------|
+| **Polymarket** | API key, secret, private key, funder address |
+| **Kalshi** | Email, API key |
+| **Betfair** | App key, session token |
+| **Smarkets** | API key |
+| **Binance** | API key, secret |
+| **Bybit** | API key, secret |
+| **Hyperliquid** | Private key, wallet address |
+| **MEXC** | API key, secret |
+
+---
+
+## Security Features
+
+| Feature | Description |
+|---------|-------------|
+| **AES-256-GCM** | Military-grade encryption at rest |
+| **Per-user keys** | Isolated credential storage |
+| **Cooldown** | Rate limits on failed attempts |
+| **No logging** | Secrets never logged |
+| **Memory wipe** | Credentials cleared from memory after use |
+
+---
+
+## Environment Variables
+
+```bash
+# Required encryption key (generate with: openssl rand -hex 32)
+CREDENTIALS_KEY=your-64-char-hex-key
+
+# Optional: per-platform keys
+POLYMARKET_API_KEY=pk_...
+POLYMARKET_API_SECRET=sk_...
+POLYMARKET_PRIVATE_KEY=0x...
+KALSHI_EMAIL=user@example.com
+KALSHI_API_KEY=key_...
+```
+
+---
+
+## Best Practices
+
+1. **Strong encryption key** — Use `openssl rand -hex 32`
+2. **Rotate keys regularly** — Update API keys periodically
+3. **Test after adding** — Always verify credentials work
+4. **Minimal permissions** — Use read-only keys when possible
+5. **Backup securely** — Keep encrypted backups offline

package/dist/skills/bundled/crypto-hft/SKILL.md

@@ -0,0 +1,121 @@
+---
+name: crypto-hft
+description: "Trade 15-minute crypto binary markets on Polymarket with 4 automated strategies"
+commands:
+  - /crypto-hft
+  - /hft
+gates:
+  envs:
+    - POLY_PRIVATE_KEY
+    - POLY_FUNDER_ADDRESS
+    - POLY_API_KEY
+    - POLY_API_SECRET
+    - POLY_API_PASSPHRASE
+---
+
+# Crypto HFT - 15-Minute Market Trading
+
+Trade Polymarket's 15-minute crypto binary markets (BTC, ETH, SOL, XRP) with 4 automated strategies. Each round lasts 15 minutes with UP/DOWN token pairs that settle at 0 or 1.
+
+Starts in **dry-run mode** by default (no real orders).
+
+## Quick Start
+
+```
+/crypto-hft start                          # Start dry-run on BTC,ETH,SOL,XRP
+/crypto-hft start BTC,ETH --dry-run       # Specific assets, dry run
+/crypto-hft start --preset scalper         # Use a built-in preset
+/crypto-hft status                         # Check stats + open positions
+/crypto-hft stop                           # Stop and show summary
+```
+
+For live trading, set Polymarket env vars and omit `--dry-run`:
+```bash
+export POLY_PRIVATE_KEY="..."
+export POLY_FUNDER_ADDRESS="..."
+export POLY_API_KEY="..."
+export POLY_API_SECRET="..."
+export POLY_API_PASSPHRASE="..."
+```
+
+## Commands
+
+### Start / Stop
+```
+/crypto-hft start [ASSETS] [--size N] [--dry-run] [--preset NAME]
+/crypto-hft stop
+```
+
+### Monitor
+```
+/crypto-hft status       Stats, round info, open positions
+/crypto-hft positions    Last 20 closed trades with PnL
+/crypto-hft markets      Active 15-min markets from Gamma API
+/crypto-hft round        Current round slot and timing
+```
+
+### Configure (while running)
+```
+/crypto-hft config                                 Show current config
+/crypto-hft config --tp 15 --sl 12                 Set take-profit/stop-loss %
+/crypto-hft config --size 30 --max-pos 4           Set trade size and max positions
+/crypto-hft config --ratchet on --trailing off      Toggle exit features
+/crypto-hft config --max-loss 100                   Set daily loss limit
+```
+
+### Strategy Control
+```
+/crypto-hft enable momentum          Enable a strategy
+/crypto-hft disable expiry_fade      Disable a strategy
+```
+
+### Presets
+```
+/crypto-hft preset list              Show all presets
+/crypto-hft preset save my_config    Save current config as preset
+/crypto-hft preset load scalper      Load a preset (into running engine or for next start)
+/crypto-hft preset delete my_config  Delete a saved preset
+```
+
+## Strategies
+
+| Strategy | Entry Condition | Order Mode | Best For |
+|----------|----------------|------------|----------|
+| **momentum** | Spot price moved, poly lagging | maker_then_taker | Catching delayed reactions |
+| **mean_reversion** | Token mispriced, spot calm | maker (0% fee) | Range-bound markets |
+| **penny_clipper** | Oscillating in zone, price below mean | maker (0% fee) | Tight spread scalping |
+| **expiry_fade** | Near expiry, skewed pricing, flat spot | taker (speed) | Late-round mean reversion |
+
+## Built-in Presets
+
+| Preset | Size | Strategies | Risk |
+|--------|------|-----------|------|
+| **conservative** | $10 | mean_reversion, penny_clipper | Low - dry run, tight stops |
+| **aggressive** | $50 | All 4 | High - live, wide stops |
+| **scalper** | $20 | penny_clipper only | Medium - ratchet on |
+| **momentum_only** | $30 | momentum only | Medium - ratchet + trailing |
+
+## Exit Logic
+
+Positions are monitored every 500ms with 9 exit types (in priority order):
+
+1. **Force exit** - < 30s before market expiry
+2. **Take profit** - PnL >= TP% (default 15%)
+3. **Stop loss** - PnL <= -SL% (default 12%)
+4. **Ratchet floor** - Progressive giveback from confirmed high-water mark
+5. **Trailing stop** - Tightens as expiry approaches
+6. **Depth collapse** - Orderbook depth dropped 60%+ while price dropping
+7. **Stale profit** - Profitable but bid unchanged for 7s
+8. **Stagnant profit** - At +3% for 13s with no progress
+9. **Time exit** - Approaching minimum time left
+
+## Architecture
+
+```
+Binance WS (spot) --> CryptoFeed --> Strategy Evaluators --> Entry Signals
+Gamma API ---------> MarketScanner --> Round Detection    |
+                                                          v
+Poly Orderbook ----> OBI/Spread/Depth --> Exit Checks --> ExecutionService
+                                    |
+                              PositionManager (ratchet, trailing, depth collapse)
+```

package/dist/skills/bundled/dca/SKILL.md

@@ -0,0 +1,27 @@
+---
+name: dca
+description: "Dollar-cost averaging across all platforms"
+command: dca
+emoji: "📊"
+---
+
+# DCA (Dollar-Cost Averaging)
+
+Spread orders over time across multiple platforms including Polymarket, Kalshi, PumpFun, Hyperliquid, Binance Futures, Bybit, MEXC, Drift, Opinion.trade, Predict.fun, Orca, Raydium, Virtuals, and Jupiter.
+
+## Commands
+
+```
+/dca poly <token-id> <total-$> --per <$> --every <interval>    Polymarket DCA
+/dca kalshi <ticker> <total-$> --per <$> --every <interval>    Kalshi DCA
+/dca pump <mint> <total-SOL> --per <SOL> --every <interval>    PumpFun DCA
+/dca hl <coin> <total-$> --per <$> --every <interval>          Hyperliquid DCA
+/dca bf <symbol> <total-$> --per <$> --every <interval>        Binance Futures DCA
+/dca bb <symbol> <total-$> --per <$> --every <interval>        Bybit DCA
+/dca list                                                       List active DCA orders
+/dca info <id>                                                  Show order details
+/dca pause <id>                                                 Pause DCA order
+/dca resume <id>                                                Resume DCA order
+/dca cancel <id>                                                Cancel DCA order
+/dca help                                                       Show all commands
+```

package/dist/skills/bundled/dex/SKILL.md

@@ -0,0 +1,87 @@
+---
+name: dex
+description: "Cross-chain DEX market intelligence - trending tokens, gainers, losers, volume, stats across all chains and protocols"
+command: dex
+emoji: "📊"
+---
+
+# DEX Market Intelligence
+
+Cross-chain, cross-DEX market data powered by DexScreener. No API key needed. Works across Solana, Ethereum, BSC, Base, Arbitrum, and 10+ more chains.
+
+**Use this skill when users ask about:**
+- What's trending, what's hot, what's pumping on any chain or DEX
+- Top gainers or losers (24h or right now)
+- Token volume, liquidity, price changes, transaction counts
+- Market data for any token on any chain
+- Comparing tokens across different DEXes
+- Virtuals Protocol, Clanker, Aerodrome, PumpSwap, Raydium, Uniswap, PancakeSwap tokens
+- "What's the most active token right now?"
+- "Show me the top movers on Base/Ethereum/Solana"
+
+## Discovery Commands
+
+```
+/dex trending [filter]    Top tokens by 24h volume
+/dex gainers [filter]     Top 24h price gainers
+/dex losers [filter]      Top 24h price losers
+/dex hot [filter]         Most active right now (1h transactions)
+/dex new [filter]         Newest token profiles
+/dex boosted              DexScreener trending/boosted tokens
+```
+
+**Filter** can be a chain OR a specific DEX/protocol:
+
+| Filter | What it covers |
+|--------|---------------|
+| `solana` / `sol` | All Solana DEXes |
+| `ethereum` / `eth` | All Ethereum DEXes |
+| `bsc` / `bnb` | All BSC DEXes |
+| `base` | All Base chain DEXes |
+| `arbitrum` / `arb` | All Arbitrum DEXes |
+| `pumpfun` / `pump` | Pump.fun tokens only |
+| `pumpswap` | PumpSwap AMM tokens |
+| `raydium` | Raydium tokens |
+| `orca` | Orca tokens |
+| `meteora` | Meteora tokens |
+| `virtuals` | Virtuals Protocol (Base) |
+| `clanker` | Clanker tokens (Base) |
+| `aerodrome` | Aerodrome DEX (Base) |
+| `uniswap` | Uniswap (Ethereum) |
+| `pancakeswap` | PancakeSwap (BSC) |
+
+**Examples:**
+```
+/dex trending solana          What's hot on Solana?
+/dex trending pumpfun         Top pump.fun tokens by volume
+/dex gainers virtuals         Virtuals Protocol top gainers
+/dex losers ethereum          What dumped on Ethereum?
+/dex hot base                 Most active on Base right now
+/dex trending                 Top across ALL chains
+```
+
+## Token Data Commands
+
+```
+/dex token <address> [chain]    Full stats: price, volume, liquidity, txns, price changes
+/dex pairs <address> [chain]    All trading pairs for a token
+/dex search <query>             Search any token across all chains
+```
+
+**Examples:**
+```
+/dex token EPjFW...Dt1v solana
+/dex search PEPE
+/dex pairs 0x1234... eth
+```
+
+## Data Available Per Token
+
+- Price (USD and native)
+- Market cap / FDV
+- Liquidity (USD)
+- Volume: 5m, 1h, 6h, 24h
+- Price change: 5m, 1h, 6h, 24h
+- Transaction counts: buys vs sells at each timeframe
+- DEX / pool info
+- All trading pairs

package/dist/skills/bundled/dex/index.d.ts

@@ -0,0 +1,36 @@
+/**
+ * DEX Market Intelligence Skill - Cross-chain, cross-DEX market data
+ *
+ * Powered by DexScreener (free, no API key required).
+ * Works across all chains: Solana, Ethereum, BSC, Base, Arbitrum, etc.
+ *
+ * Commands:
+ *
+ * DISCOVERY:
+ * /dex trending [chain]           - Top tokens by 24h volume
+ * /dex gainers [chain]            - Top 24h price gainers
+ * /dex losers [chain]             - Top 24h price losers
+ * /dex hot [chain]                - Most active right now (1h transactions)
+ * /dex new [chain]                - Newest token profiles
+ * /dex boosted                    - DexScreener trending/boosted tokens
+ *
+ * TOKEN DATA:
+ * /dex token <address> [chain]    - Full token stats (price, vol, liq, txns)
+ * /dex pairs <address> [chain]    - All trading pairs for a token
+ * /dex search <query>             - Search any token across all chains
+ *
+ * FILTERS (chain OR protocol):
+ *   Chains: solana, ethereum, bsc, base, arbitrum, polygon, avalanche, optimism, sui, aptos, ton
+ *   Solana DEXes: pumpfun, pumpswap, raydium, orca, meteora
+ *   Base protocols: virtuals, clanker, aerodrome
+ *   Ethereum: uniswap, sushiswap, curve
+ *   BSC: pancakeswap
+ */
+export declare function execute(args: string): Promise<string>;
+declare const _default: {
+    name: string;
+    description: string;
+    commands: string[];
+    handle: typeof execute;
+};
+export default _default;