clodds 1.2.9 → 1.3.0

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

@@ -0,0 +1,306 @@
+---
+name: slippage
+description: "Slippage estimation, optimization, and protection for trade execution"
+emoji: "📉"
+---
+
+# Slippage - Complete API Reference
+
+Estimate, minimize, and protect against slippage across all trading platforms.
+
+---
+
+## Chat Commands
+
+### Estimate Slippage
+
+```
+/slippage estimate "Trump" YES 5000    Estimate for $5000 order
+/slippage BTCUSDT 1.5 BTC              Estimate for futures
+/slippage ETH 50 --dex uniswap         Estimate DEX slippage
+```
+
+### Analyze Orderbook
+
+```
+/slippage depth "Trump"                Show orderbook depth
+/slippage impact 10000                 Price impact for size
+/slippage levels "Trump"               Show slippage at sizes
+```
+
+### Optimize Execution
+
+```
+/slippage optimize "Trump" YES 10000   Find best execution
+/slippage split 50000                  Optimal order splitting
+/slippage timing "Trump"               Best times for low slippage
+```
+
+### Protection Settings
+
+```
+/slippage max 1%                       Set max slippage tolerance
+/slippage protect on                   Enable slippage protection
+/slippage revert-threshold 2%          Cancel if slippage exceeds
+```
+
+---
+
+## TypeScript API Reference
+
+### Create Slippage Manager
+
+```typescript
+import { createSlippageManager } from 'clodds/slippage';
+
+const slippage = createSlippageManager({
+  // Default tolerance
+  defaultMaxSlippage: 0.01,  // 1%
+
+  // Protection
+  enableProtection: true,
+  revertThreshold: 0.02,  // Cancel if > 2%
+
+  // Data sources
+  orderbookDepth: 20,  // Levels to analyze
+  refreshInterval: 1000,  // ms
+});
+```
+
+### Estimate Slippage
+
+```typescript
+const estimate = await slippage.estimate({
+  platform: 'polymarket',
+  market: 'trump-win-2028',
+  side: 'YES',
+  size: 5000,
+});
+
+console.log(`Expected slippage: ${estimate.slippage}%`);
+console.log(`Price impact: ${estimate.priceImpact}%`);
+console.log(`Effective price: ${estimate.effectivePrice}`);
+console.log(`Best price: ${estimate.bestPrice}`);
+console.log(`Worst price: ${estimate.worstPrice}`);
+console.log(`Confidence: ${estimate.confidence}%`);
+```
+
+### Analyze Orderbook Depth
+
+```typescript
+const depth = await slippage.analyzeDepth({
+  platform: 'polymarket',
+  market: 'trump-win-2028',
+  side: 'YES',
+});
+
+console.log('Orderbook Depth:');
+console.log(`  Liquidity at 0.5%: $${depth.liquidityAt05Pct}`);
+console.log(`  Liquidity at 1%: $${depth.liquidityAt1Pct}`);
+console.log(`  Liquidity at 2%: $${depth.liquidityAt2Pct}`);
+console.log(`  Total depth: $${depth.totalDepth}`);
+
+console.log('\nSlippage by Size:');
+for (const level of depth.slippageLevels) {
+  console.log(`  $${level.size}: ${level.slippage}% slippage`);
+}
+```
+
+### Price Impact Analysis
+
+```typescript
+const impact = await slippage.priceImpact({
+  platform: 'polymarket',
+  market: 'trump-win-2028',
+  side: 'YES',
+  sizes: [1000, 5000, 10000, 25000, 50000],
+});
+
+console.log('Price Impact Analysis:');
+for (const level of impact.levels) {
+  console.log(`  $${level.size}:`);
+  console.log(`    Slippage: ${level.slippage}%`);
+  console.log(`    Impact: ${level.impact}%`);
+  console.log(`    Effective: ${level.effectivePrice}`);
+}
+```
+
+### Optimize Execution
+
+```typescript
+const optimized = await slippage.optimize({
+  platform: 'polymarket',
+  market: 'trump-win-2028',
+  side: 'YES',
+  size: 25000,
+  maxSlippage: 0.01,
+});
+
+console.log('Optimized Execution:');
+console.log(`  Strategy: ${optimized.strategy}`);  // 'single' | 'split' | 'twap'
+console.log(`  Expected slippage: ${optimized.expectedSlippage}%`);
+console.log(`  vs naive: ${optimized.naiveSlippage}%`);
+console.log(`  Savings: $${optimized.savings}`);
+
+if (optimized.strategy === 'split') {
+  console.log('\nOrder Split:');
+  for (const order of optimized.orders) {
+    console.log(`  ${order.size} @ ${order.limitPrice} (${order.delay}s delay)`);
+  }
+}
+```
+
+### Order Splitting
+
+```typescript
+const split = await slippage.splitOrder({
+  platform: 'polymarket',
+  market: 'trump-win-2028',
+  side: 'YES',
+  totalSize: 50000,
+  maxSlippagePerOrder: 0.005,  // 0.5% max per order
+  minOrderSize: 1000,
+});
+
+console.log(`Split into ${split.orders.length} orders:`);
+for (const order of split.orders) {
+  console.log(`  $${order.size} - expected ${order.expectedSlippage}%`);
+}
+console.log(`Total expected slippage: ${split.totalSlippage}%`);
+console.log(`Execution time: ${split.estimatedTime}s`);
+```
+
+### TWAP Execution
+
+```typescript
+const twap = await slippage.twapSchedule({
+  platform: 'polymarket',
+  market: 'trump-win-2028',
+  side: 'YES',
+  totalSize: 100000,
+  duration: 3600,  // 1 hour
+  intervals: 12,   // 12 orders
+});
+
+console.log('TWAP Schedule:');
+for (const order of twap.orders) {
+  console.log(`  ${order.time}: $${order.size}`);
+}
+console.log(`Expected avg slippage: ${twap.expectedSlippage}%`);
+```
+
+### Best Timing Analysis
+
+```typescript
+const timing = await slippage.analyzeTiming({
+  platform: 'polymarket',
+  market: 'trump-win-2028',
+  side: 'YES',
+  size: 10000,
+});
+
+console.log('Best Times for Low Slippage:');
+for (const window of timing.bestWindows) {
+  console.log(`  ${window.time}: avg ${window.avgSlippage}% slippage`);
+  console.log(`    Liquidity: $${window.avgLiquidity}`);
+}
+
+console.log('\nWorst Times:');
+for (const window of timing.worstWindows) {
+  console.log(`  ${window.time}: avg ${window.avgSlippage}% slippage`);
+}
+```
+
+### Slippage Protection
+
+```typescript
+// Set protection parameters
+slippage.setProtection({
+  maxSlippage: 0.01,           // 1% max
+  revertThreshold: 0.02,       // Cancel if > 2%
+  notifyThreshold: 0.005,      // Alert at 0.5%
+  retryOnRevert: true,         // Retry with lower size
+  retryReductionPct: 50,       // Reduce size by 50%
+});
+
+// Execute with protection
+const result = await slippage.executeProtected({
+  platform: 'polymarket',
+  market: 'trump-win-2028',
+  side: 'YES',
+  size: 10000,
+});
+
+console.log(`Executed: ${result.executed}`);
+console.log(`Actual slippage: ${result.actualSlippage}%`);
+console.log(`Protected: ${result.protected}`);
+if (result.reverted) {
+  console.log(`Reverted: ${result.revertReason}`);
+}
+```
+
+### DEX Slippage (Crypto)
+
+```typescript
+const dexSlippage = await slippage.estimateDex({
+  chain: 'ethereum',
+  dex: 'uniswap',
+  tokenIn: 'USDC',
+  tokenOut: 'ETH',
+  amountIn: 50000,
+});
+
+console.log('DEX Slippage Estimate:');
+console.log(`  Expected out: ${dexSlippage.expectedOut}`);
+console.log(`  Min out (1% slip): ${dexSlippage.minOut1Pct}`);
+console.log(`  Price impact: ${dexSlippage.priceImpact}%`);
+console.log(`  Route: ${dexSlippage.route.join(' → ')}`);
+```
+
+### Historical Slippage
+
+```typescript
+const history = await slippage.getHistory({
+  platform: 'polymarket',
+  period: '30d',
+});
+
+console.log('Historical Slippage:');
+console.log(`  Avg slippage: ${history.avgSlippage}%`);
+console.log(`  Max slippage: ${history.maxSlippage}%`);
+console.log(`  Trades with > 1%: ${history.tradesOver1Pct}`);
+console.log(`  Total slippage cost: $${history.totalCost}`);
+```
+
+---
+
+## Slippage Factors
+
+| Factor | Impact | Mitigation |
+|--------|--------|------------|
+| **Order size** | Larger = more slip | Split orders |
+| **Liquidity** | Thin = more slip | Check depth first |
+| **Volatility** | High = more slip | Use limit orders |
+| **Time of day** | Off-hours = more slip | Trade peak hours |
+| **Market type** | New = more slip | Avoid illiquid markets |
+
+---
+
+## Protection Modes
+
+| Mode | Behavior |
+|------|----------|
+| `warn` | Alert but execute |
+| `confirm` | Require confirmation |
+| `block` | Cancel if exceeds |
+| `retry` | Retry with smaller size |
+
+---
+
+## Best Practices
+
+1. **Always estimate first** — Check slippage before trading
+2. **Split large orders** — Reduce impact on thin orderbooks
+3. **Use limit orders** — Protect against unexpected slippage
+4. **Trade liquid markets** — Higher volume = lower slippage
+5. **Monitor execution** — Track actual vs expected slippage

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

@@ -0,0 +1,107 @@
+---
+name: smarkets
+description: "Smarkets Exchange betting with 2% commission"
+emoji: "🎰"
+commands:
+  - /sm
+gates:
+  envs:
+    - SMARKETS_SESSION_TOKEN
+---
+
+# Smarkets Exchange
+
+Full integration with Smarkets, a betting exchange with lower fees than Betfair (2% vs 5%). Politics, sports, and entertainment markets.
+
+## Quick Start
+
+```bash
+# Set credentials
+export SMARKETS_SESSION_TOKEN="your-session-token"
+
+# Search markets
+/sm markets election
+
+# Get market prices
+/sm prices 12345
+
+# Place buy order
+/sm buy 12345 67890 0.55 10
+
+# Place sell order
+/sm sell 12345 67890 0.60 10
+```
+
+## Commands
+
+### Market Data
+
+| Command | Description |
+|---------|-------------|
+| `/sm markets [query]` | Search markets |
+| `/sm market <id>` | Get market details |
+| `/sm prices <marketId>` | Current prices |
+| `/sm book <marketId> <contractId>` | Show orderbook |
+
+### Trading
+
+| Command | Description |
+|---------|-------------|
+| `/sm buy <marketId> <contractId> <price> <quantity>` | Place buy order |
+| `/sm sell <marketId> <contractId> <price> <quantity>` | Place sell order |
+| `/sm cancel <orderId>` | Cancel order |
+| `/sm cancelall [marketId]` | Cancel all orders |
+| `/sm orders [marketId]` | List open orders |
+
+**Examples:**
+```bash
+/sm buy 123 456 0.55 10    # Buy at 55% price, £10
+/sm sell 123 456 0.60 10   # Sell at 60% price, £10
+/sm cancel abc123          # Cancel specific order
+```
+
+### Account
+
+| Command | Description |
+|---------|-------------|
+| `/sm balance` | Check account balance |
+
+## Configuration
+
+```bash
+# Required for trading
+export SMARKETS_SESSION_TOKEN="your-session-token"
+
+# Optional - API token for market data only
+export SMARKETS_API_TOKEN="your-api-token"
+```
+
+## Features
+
+- **Low Fees** - 2% commission vs Betfair's 5%
+- **Politics Markets** - UK, US, EU elections
+- **Sports** - Football, tennis, horse racing
+- **Entertainment** - TV, music, awards
+- **Real-time Streaming** - WebSocket price updates
+
+## Market Types
+
+| Domain | Examples |
+|--------|----------|
+| politics | Elections, referendums |
+| sport | Football, tennis, cricket |
+| entertainment | Oscars, Eurovision, reality TV |
+| current_affairs | Economic events, news |
+| esports | CS:GO, League of Legends |
+
+## Trading Notes
+
+1. **Prices**: Expressed as percentages (0.55 = 55%)
+2. **Quantities**: In GBP
+3. **Buy**: Betting FOR an outcome
+4. **Sell**: Betting AGAINST an outcome
+
+## Resources
+
+- [Smarkets Exchange](https://smarkets.com/)
+- [Smarkets API Docs](https://docs.smarkets.com/)

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

@@ -0,0 +1,63 @@
+---
+name: solend
+description: "Solend — Solana lending and borrowing"
+emoji: "💰"
+commands:
+  - /solend
+gates:
+  envs:
+    - SOLANA_PRIVATE_KEY
+---
+
+# Solend
+
+Solend is a decentralized lending and borrowing protocol on Solana. Supply assets to earn interest, borrow against collateral, and monitor health to avoid liquidation.
+
+## Commands
+
+### Lending
+```
+/solend deposit <amount> <token>       Deposit collateral
+/solend withdraw <amount|all> <token>  Withdraw collateral
+/solend borrow <amount> <token>        Borrow assets
+/solend repay <amount|all> <token>     Repay borrowed assets
+```
+
+### Account
+```
+/solend obligation                     View your positions (deposits & borrows)
+/solend health                         Check health factor & liquidation risk
+```
+
+### Markets
+```
+/solend reserves                       List reserves with APY & utilization
+/solend rates                          View supply/borrow interest rates table
+/solend markets                        List available lending markets
+```
+
+## Examples
+
+```
+/solend deposit 100 USDC
+/solend borrow 1 SOL
+/solend health
+/solend repay all SOL
+/solend withdraw all USDC
+/solend reserves
+/solend rates
+```
+
+## Configuration
+
+```bash
+export SOLANA_PRIVATE_KEY="your-base58-private-key"
+export SOLANA_RPC_URL="https://api.mainnet-beta.solana.com"  # Optional
+```
+
+## See Also
+
+- `/kamino` — Kamino Finance lending + liquidity vaults
+- `/marginfi` — MarginFi lending protocol
+- `/jup` — Jupiter DEX aggregator
+- `/bags` — Portfolio overview