clodds 1.2.9 → 1.4.0

package/dist/skills/bundled/tailscale/index.js.map

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

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

@@ -0,0 +1,61 @@
+# Tick Data Skill
+
+Query historical tick, OHLC, and orderbook data from TimescaleDB.
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `/ticks <platform> <marketId>` | Get recent ticks (last 24h) |
+| `/ticks ohlc <platform> <marketId> --outcome <id>` | Get OHLC candles |
+| `/ticks spread <platform> <marketId>` | Get spread history |
+| `/ticks stats` | Get tick recorder stats |
+
+## Options
+
+| Option | Description |
+|--------|-------------|
+| `--outcome <id>` | Filter by outcome ID |
+| `--interval <int>` | OHLC interval: `1m`, `5m`, `15m`, `1h`, `4h`, `1d` |
+| `--limit <n>` | Limit number of results |
+
+## Examples
+
+```
+/ticks polymarket 0x1234abcd
+/ticks ohlc polymarket 0x1234 --outcome 0x5678 --interval 1h
+/ticks spread polymarket 0x1234 --limit 50
+/ticks stats
+```
+
+## Requirements
+
+- TimescaleDB tick recorder must be enabled
+- Configure in `clodds.config.yaml`:
+
+```yaml
+tickRecorder:
+  enabled: true
+  connectionString: postgres://user:pass@localhost:5432/clodds
+```
+
+## Output
+
+### Ticks
+Shows price history with timestamps and price changes.
+
+### OHLC
+Shows candlestick data with open, high, low, close, and tick count.
+Includes period change summary.
+
+### Spread
+Shows orderbook spread history with mid price and depth.
+Includes spread statistics (avg, min, max).
+
+### Stats
+Shows recorder status including:
+- Database connection status
+- Total ticks/orderbooks recorded
+- Buffer pending counts
+- Last flush time
+- Active platforms

package/dist/skills/bundled/token-security/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: token-security
+description: "Token security audit via GoPlus API"
+command: audit
+emoji: "🔍"
+---
+
+# Token Security Audit
+
+Comprehensive token security analysis powered by GoPlus API - honeypot detection, rug-pull analysis, and risk scoring.
+
+## Commands
+
+```
+/audit <address>                  Auto-detect chain and audit token
+/audit <address> --chain <name>   Audit token on specific chain
+/audit help                       Show help
+```

package/dist/skills/bundled/trading-evm/SKILL.md

@@ -0,0 +1,329 @@
+---
+name: trading-evm
+description: "Trade tokens on EVM chains - Uniswap V3, 1inch on Ethereum, Arbitrum, Optimism, Base, Polygon"
+emoji: "⟠"
+gates:
+  envs:
+    - EVM_PRIVATE_KEY
+---
+
+# EVM DEX Trading - Complete API Reference
+
+Trade any token on Ethereum, Arbitrum, Optimism, Base, and Polygon using Uniswap V3 and 1inch aggregator.
+
+## Required Environment Variables
+
+```bash
+EVM_PRIVATE_KEY=0x...                      # Your EVM wallet private key
+ALCHEMY_API_KEY=...                        # Optional: for better RPC
+ONEINCH_API_KEY=...                        # Optional: for 1inch API
+```
+
+---
+
+## Supported Chains
+
+| Chain | Chain ID | DEXes | MEV Protection |
+|-------|----------|-------|----------------|
+| Ethereum | 1 | Uniswap V3, 1inch | Flashbots Protect |
+| Arbitrum | 42161 | Uniswap V3, 1inch | Sequencer |
+| Optimism | 10 | Uniswap V3, 1inch | Sequencer |
+| Base | 8453 | Uniswap V3, 1inch | Sequencer |
+| Polygon | 137 | Uniswap V3, 1inch | Standard |
+
+---
+
+## Chat Commands
+
+### Swaps
+
+```
+/swap eth <amount> <from> to <to>           # Swap on Ethereum
+/swap arb <amount> <from> to <to>           # Swap on Arbitrum
+/swap op <amount> <from> to <to>            # Swap on Optimism
+/swap base <amount> <from> to <to>          # Swap on Base
+/swap matic <amount> <from> to <to>         # Swap on Polygon
+
+# Examples:
+/swap eth 1 ETH to USDC                     # Swap 1 ETH to USDC on Ethereum
+/swap arb 100 USDC to ARB                   # Swap 100 USDC to ARB on Arbitrum
+/swap base 0.5 ETH to DEGEN                 # Swap 0.5 ETH to DEGEN on Base
+```
+
+### Quotes
+
+```
+/quote eth <amount> <from> to <to>          # Get quote without executing
+/quote arb 1 ETH to USDC                    # Quote on Arbitrum
+```
+
+### Compare Routes
+
+```
+/compare <chain> <amount> <from> to <to>    # Compare Uniswap vs 1inch
+/compare eth 1 ETH to USDC                  # Compare routes on Ethereum
+```
+
+### Balances
+
+```
+/balance eth                                # Check ETH and token balances
+/balance arb                                # Check Arbitrum balances
+/balance base <token>                       # Check specific token on Base
+```
+
+---
+
+## TypeScript API Reference
+
+### Uniswap V3
+
+```typescript
+import {
+  executeUniswapSwap,
+  getUniswapQuote,
+  resolveToken,
+  getTokenInfo,
+  getEvmBalance
+} from 'clodds/evm/uniswap';
+
+// Get quote
+const quote = await getUniswapQuote({
+  chain: 'ethereum',
+  tokenIn: 'ETH',
+  tokenOut: 'USDC',
+  amountIn: '1000000000000000000',  // 1 ETH in wei
+  slippageTolerance: 0.5,
+});
+
+console.log(`Expected output: ${quote.amountOut}`);
+console.log(`Price impact: ${quote.priceImpact}%`);
+console.log(`Route: ${quote.route.join(' → ')}`);
+
+// Execute swap
+const result = await executeUniswapSwap({
+  chain: 'ethereum',
+  tokenIn: 'ETH',
+  tokenOut: 'USDC',
+  amountIn: '1000000000000000000',
+  slippageTolerance: 0.5,
+  deadline: 300,  // 5 minutes
+});
+
+console.log(`TX: ${result.transactionHash}`);
+console.log(`Amount out: ${result.amountOut}`);
+
+// Resolve token symbol to address
+const usdcAddress = resolveToken('USDC', 'ethereum');
+
+// Get token info
+const tokenInfo = await getTokenInfo('ethereum', usdcAddress);
+console.log(`${tokenInfo.symbol}: ${tokenInfo.decimals} decimals`);
+
+// Check balance
+const balance = await getEvmBalance('ethereum', walletAddress, 'USDC');
+```
+
+### 1inch Aggregator
+
+```typescript
+import {
+  executeOneInchSwap,
+  getOneInchQuote,
+  getOneInchProtocols,
+  compareDexRoutes
+} from 'clodds/evm/oneinch';
+
+// Get quote from 1inch
+const quote = await getOneInchQuote({
+  chain: 'ethereum',
+  fromToken: 'ETH',
+  toToken: 'USDC',
+  amount: '1000000000000000000',
+});
+
+console.log(`Expected output: ${quote.toAmount}`);
+console.log(`Estimated gas: ${quote.estimatedGas}`);
+console.log(`Protocols used: ${quote.protocols.join(', ')}`);
+
+// Execute swap via 1inch
+const result = await executeOneInchSwap({
+  chain: 'ethereum',
+  fromToken: 'ETH',
+  toToken: 'USDC',
+  amount: '1000000000000000000',
+  slippage: 0.5,
+});
+
+// Get available protocols
+const protocols = await getOneInchProtocols('ethereum');
+// ['UNISWAP_V3', 'SUSHISWAP', 'CURVE', ...]
+
+// Compare routes between Uniswap and 1inch
+const comparison = await compareDexRoutes({
+  chain: 'ethereum',
+  tokenIn: 'ETH',
+  tokenOut: 'USDC',
+  amountIn: '1000000000000000000',
+});
+
+console.log(`Uniswap: ${comparison.uniswap.amountOut}`);
+console.log(`1inch: ${comparison.oneinch.amountOut}`);
+console.log(`Best: ${comparison.best}`);
+```
+
+---
+
+## Chain-Specific Examples
+
+### Ethereum
+
+```typescript
+// Swap ETH → USDC on Ethereum with MEV protection
+const result = await executeUniswapSwap({
+  chain: 'ethereum',
+  tokenIn: 'ETH',
+  tokenOut: 'USDC',
+  amountIn: '1000000000000000000',
+  useMevProtection: true,  // Uses Flashbots
+});
+```
+
+### Arbitrum
+
+```typescript
+// Swap on Arbitrum (lower gas)
+const result = await executeOneInchSwap({
+  chain: 'arbitrum',
+  fromToken: 'ETH',
+  toToken: 'ARB',
+  amount: '500000000000000000',  // 0.5 ETH
+  slippage: 1,
+});
+```
+
+### Base
+
+```typescript
+// Swap on Base
+const result = await executeUniswapSwap({
+  chain: 'base',
+  tokenIn: 'ETH',
+  tokenOut: 'DEGEN',
+  amountIn: '100000000000000000',  // 0.1 ETH
+  slippageTolerance: 2,  // Higher slippage for meme coins
+});
+```
+
+### Optimism
+
+```typescript
+// Swap on Optimism
+const result = await executeOneInchSwap({
+  chain: 'optimism',
+  fromToken: 'USDC',
+  toToken: 'OP',
+  amount: '100000000',  // 100 USDC (6 decimals)
+  slippage: 0.5,
+});
+```
+
+### Polygon
+
+```typescript
+// Swap on Polygon
+const result = await executeUniswapSwap({
+  chain: 'polygon',
+  tokenIn: 'MATIC',
+  tokenOut: 'USDC',
+  amountIn: '10000000000000000000',  // 10 MATIC
+  slippageTolerance: 0.5,
+});
+```
+
+---
+
+## Common Tokens
+
+### Ethereum
+
+| Symbol | Address |
+|--------|---------|
+| ETH | Native |
+| USDC | 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 |
+| USDT | 0xdAC17F958D2ee523a2206206994597C13D831ec7 |
+| WETH | 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2 |
+| DAI | 0x6B175474E89094C44Da98b954EescdeCB5BE3830 |
+
+### Arbitrum
+
+| Symbol | Address |
+|--------|---------|
+| ETH | Native |
+| ARB | 0x912CE59144191C1204E64559FE8253a0e49E6548 |
+| USDC | 0xaf88d065e77c8cC2239327C5EDb3A432268e5831 |
+
+### Base
+
+| Symbol | Address |
+|--------|---------|
+| ETH | Native |
+| USDC | 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 |
+| DEGEN | 0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed |
+
+### Optimism
+
+| Symbol | Address |
+|--------|---------|
+| ETH | Native |
+| OP | 0x4200000000000000000000000000000000000042 |
+| USDC | 0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85 |
+
+---
+
+## MEV Protection
+
+### Ethereum (Flashbots)
+
+```typescript
+// Automatically uses Flashbots Protect RPC
+const result = await executeUniswapSwap({
+  chain: 'ethereum',
+  useMevProtection: true,  // Sends via Flashbots
+  ...
+});
+```
+
+### L2 Chains
+
+L2s (Arbitrum, Optimism, Base) have sequencer-level MEV protection by default.
+
+---
+
+## Gas Estimation
+
+```typescript
+// Get gas estimate before swapping
+const quote = await getUniswapQuote({ ... });
+console.log(`Estimated gas: ${quote.gasEstimate}`);
+console.log(`Gas price: ${quote.gasPrice} gwei`);
+console.log(`Total gas cost: ${quote.gasCostUsd} USD`);
+```
+
+---
+
+## Error Handling
+
+```typescript
+import { EvmSwapError, InsufficientBalanceError, SlippageExceededError } from 'clodds/evm';
+
+try {
+  await executeUniswapSwap({ ... });
+} catch (error) {
+  if (error instanceof InsufficientBalanceError) {
+    console.log('Not enough balance');
+  } else if (error instanceof SlippageExceededError) {
+    console.log('Price moved, increase slippage');
+  }
+}
+```