@catalyst-team/poly-sdk 0.2.0 → 0.3.0

package/examples/13-arbitrage-service.ts

@@ -1,211 +0,0 @@
-#!/usr/bin/env npx tsx
-/**
- * Example 13: ArbitrageService - Complete Workflow
- *
- * Demonstrates the full arbitrage workflow:
- * 1. Scan markets for opportunities
- * 2. Start real-time monitoring
- * 3. Auto-execute arbitrage
- * 4. Stop and clear positions
- *
- * Environment variables:
- *   POLY_PRIVKEY - Private key for trading (optional for scan-only mode)
- *
- * Run with:
- *   pnpm example:arb-service
- *
- * Or scan-only (no trading):
- *   npx tsx examples/13-arbitrage-service.ts --scan-only
- */
-
-import { ArbitrageService } from '../src/index.js';
-
-// Parse arguments
-const args = process.argv.slice(2);
-const SCAN_ONLY = args.includes('--scan-only');
-const RUN_DURATION = parseInt(args.find(a => a.startsWith('--duration='))?.split('=')[1] || '60') * 1000; // default 60s
-
-async function main() {
-  console.log('╔════════════════════════════════════════════════════════════════╗');
-  console.log('║              ArbitrageService - Complete Workflow              ║');
-  console.log('╚════════════════════════════════════════════════════════════════╝');
-  console.log();
-
-  const privateKey = process.env.POLY_PRIVKEY;
-
-  if (!privateKey && !SCAN_ONLY) {
-    console.log('No POLY_PRIVKEY provided. Running in scan-only mode.\n');
-  }
-
-  // ========== Initialize ArbitrageService ==========
-  const arbService = new ArbitrageService({
-    privateKey: SCAN_ONLY ? undefined : privateKey,
-    profitThreshold: 0.005,  // 0.5% minimum profit
-    minTradeSize: 5,         // $5 minimum
-    maxTradeSize: 100,       // $100 maximum
-    autoExecute: !SCAN_ONLY && !!privateKey,
-    enableLogging: true,
-
-    // Rebalancer config
-    enableRebalancer: !SCAN_ONLY && !!privateKey,
-    minUsdcRatio: 0.2,
-    maxUsdcRatio: 0.8,
-    targetUsdcRatio: 0.5,
-    imbalanceThreshold: 5,
-    rebalanceInterval: 10000,
-    rebalanceCooldown: 30000,
-
-    // Execution safety
-    sizeSafetyFactor: 0.8,
-    autoFixImbalance: true,
-  });
-
-  // ========== Set up event listeners ==========
-  arbService.on('opportunity', (opp) => {
-    console.log(`\n🎯 ${opp.type.toUpperCase()} ARB: ${opp.profitPercent.toFixed(2)}%`);
-    console.log(`   ${opp.description}`);
-    console.log(`   Recommended size: ${opp.recommendedSize.toFixed(2)}, Est profit: $${opp.estimatedProfit.toFixed(2)}`);
-  });
-
-  arbService.on('execution', (result) => {
-    if (result.success) {
-      console.log(`\n✅ Execution succeeded!`);
-      console.log(`   Type: ${result.type}, Size: ${result.size.toFixed(2)}`);
-      console.log(`   Profit: $${result.profit.toFixed(2)}`);
-      console.log(`   Time: ${result.executionTimeMs}ms`);
-    } else {
-      console.log(`\n❌ Execution failed: ${result.error}`);
-    }
-  });
-
-  arbService.on('rebalance', (result) => {
-    if (result.success) {
-      console.log(`\n🔄 Rebalance: ${result.action.type} ${result.action.amount.toFixed(2)}`);
-      console.log(`   Reason: ${result.action.reason}`);
-    } else {
-      console.log(`\n⚠️ Rebalance failed: ${result.error}`);
-    }
-  });
-
-  arbService.on('balanceUpdate', (balance) => {
-    console.log(`\n💰 Balance: USDC=${balance.usdc.toFixed(2)}, YES=${balance.yesTokens.toFixed(2)}, NO=${balance.noTokens.toFixed(2)}`);
-  });
-
-  arbService.on('error', (error) => {
-    console.error(`\n🚨 Error: ${error.message}`);
-  });
-
-  // ========== Step 1: Scan Markets ==========
-  console.log('═══════════════════════════════════════════════════════════════');
-  console.log('Step 1: Scanning markets for arbitrage opportunities...');
-  console.log('═══════════════════════════════════════════════════════════════\n');
-
-  const scanResults = await arbService.scanMarkets(
-    { minVolume24h: 5000, limit: 50 },
-    0.003  // 0.3% min profit for scanning
-  );
-
-  const opportunities = scanResults.filter(r => r.arbType !== 'none');
-
-  console.log(`\nFound ${opportunities.length} opportunities out of ${scanResults.length} markets scanned\n`);
-
-  if (opportunities.length > 0) {
-    console.log('Top 5 opportunities:');
-    console.log('┌──────────────────────────────────────────────────────────────────┐');
-    for (const r of opportunities.slice(0, 5)) {
-      console.log(`│ ${r.market.name.slice(0, 50).padEnd(50)} │`);
-      console.log(`│   ${r.arbType.toUpperCase()} +${r.profitPercent.toFixed(2)}%  Size: ${r.availableSize.toFixed(0)}  Vol: $${r.volume24h.toLocaleString().padEnd(10)} │`);
-      console.log(`├──────────────────────────────────────────────────────────────────┤`);
-    }
-    console.log('└──────────────────────────────────────────────────────────────────┘');
-  }
-
-  if (SCAN_ONLY || opportunities.length === 0) {
-    console.log('\n✅ Scan complete.');
-    if (SCAN_ONLY) {
-      console.log('   (Running in scan-only mode, not starting arbitrage)');
-    }
-    if (opportunities.length === 0) {
-      console.log('   (No profitable opportunities found)');
-    }
-    return;
-  }
-
-  // ========== Step 2: Start Arbitrage ==========
-  console.log('\n═══════════════════════════════════════════════════════════════');
-  console.log('Step 2: Starting arbitrage on best market...');
-  console.log('═══════════════════════════════════════════════════════════════\n');
-
-  const best = opportunities[0];
-  console.log(`Selected: ${best.market.name}`);
-  console.log(`Type: ${best.arbType.toUpperCase()}, Profit: +${best.profitPercent.toFixed(2)}%\n`);
-
-  await arbService.start(best.market);
-
-  // ========== Step 3: Run for duration ==========
-  console.log('\n═══════════════════════════════════════════════════════════════');
-  console.log(`Step 3: Running for ${RUN_DURATION / 1000} seconds...`);
-  console.log('═══════════════════════════════════════════════════════════════\n');
-  console.log('Monitoring for arbitrage opportunities...');
-  console.log('(Press Ctrl+C to stop early)\n');
-
-  // Handle graceful shutdown
-  let stopped = false;
-  const shutdown = async () => {
-    if (stopped) return;
-    stopped = true;
-    console.log('\n\nShutting down...');
-    await cleanup();
-    process.exit(0);
-  };
-
-  process.on('SIGINT', shutdown);
-  process.on('SIGTERM', shutdown);
-
-  // Wait for duration
-  await new Promise(resolve => setTimeout(resolve, RUN_DURATION));
-
-  // ========== Step 4: Stop and Clear ==========
-  async function cleanup() {
-    console.log('\n═══════════════════════════════════════════════════════════════');
-    console.log('Step 4: Stopping and clearing positions...');
-    console.log('═══════════════════════════════════════════════════════════════\n');
-
-    await arbService.stop();
-
-    // Print stats
-    const stats = arbService.getStats();
-    console.log('Session Statistics:');
-    console.log(`  Opportunities detected: ${stats.opportunitiesDetected}`);
-    console.log(`  Executions attempted: ${stats.executionsAttempted}`);
-    console.log(`  Executions succeeded: ${stats.executionsSucceeded}`);
-    console.log(`  Total profit: $${stats.totalProfit.toFixed(2)}`);
-    console.log(`  Running time: ${(stats.runningTimeMs / 1000).toFixed(0)}s`);
-
-    // Clear positions
-    if (privateKey) {
-      console.log('\nClearing positions...');
-      const clearResult = await arbService.clearPositions(best.market, false);
-
-      console.log(`\nPosition status:`);
-      console.log(`  Market status: ${clearResult.marketStatus}`);
-      console.log(`  YES balance: ${clearResult.yesBalance.toFixed(4)}`);
-      console.log(`  NO balance: ${clearResult.noBalance.toFixed(4)}`);
-      console.log(`  Expected recovery: $${clearResult.totalUsdcRecovered.toFixed(2)}`);
-
-      if (clearResult.actions.length > 0) {
-        console.log(`\nPlanned actions:`);
-        for (const action of clearResult.actions) {
-          console.log(`  - ${action.type}: ${action.amount.toFixed(4)} → ~$${action.usdcResult.toFixed(2)}`);
-        }
-        console.log('\n(Run with --execute-clear to actually clear positions)');
-      }
-    }
-
-    console.log('\n✅ Done!');
-  }
-
-  await cleanup();
-}
-
-main().catch(console.error);

package/examples/README.md

@@ -1,179 +0,0 @@
-# Poly-SDK Examples
-
-Comprehensive examples demonstrating the Polymarket SDK capabilities.
-
-## Running Examples
-
-```bash
-# From poly-sdk directory
-npx tsx examples/01-basic-usage.ts
-
-# Or use pnpm scripts
-pnpm example:basic       # 01-basic-usage.ts
-pnpm example:smart-money # 02-smart-money.ts
-```
-
----
-
-## Examples Overview
-
-| # | File | Description | Auth Required |
-|---|------|-------------|---------------|
-| 01 | `basic-usage.ts` | Trending markets, orderbook data | No |
-| 02 | `smart-money.ts` | Smart money wallet analysis | No |
-| 03 | `market-analysis.ts` | Market search and analysis | No |
-| 04 | `kline-aggregation.ts` | Price history and KLine data | No |
-| 05 | `follow-wallet-strategy.ts` | Copy trading simulation | No |
-| 06 | `services-demo.ts` | WalletService & MarketService | No |
-| 07 | `realtime-websocket.ts` | Real-time orderbook updates | No |
-| 08 | `trading-orders.ts` | Order placement and management | Yes |
-| 09 | `rewards-tracking.ts` | Liquidity rewards tracking | Yes |
-| 10 | `ctf-operations.ts` | Split/Merge/Redeem tokens | Yes |
-| 11 | `live-arbitrage-scan.ts` | Scan markets for arbitrage | No |
-| 12 | `trending-arb-monitor.ts` | Real-time arbitrage monitoring | No |
-
----
-
-## Example Details
-
-### 01 - Basic Usage
-
-Get started with the SDK. Fetches trending markets and orderbook data.
-
-```typescript
-import { PolymarketSDK } from '@catalyst-team/poly-sdk';
-const sdk = new PolymarketSDK();
-const trending = await sdk.gammaApi.getTrendingMarkets(5);
-```
-
-### 02 - Smart Money Analysis
-
-Analyze wallet trading performance and identify profitable traders.
-
-- Fetch wallet positions and activity
-- Calculate P&L and win rate
-- Identify high-performing wallets
-
-### 03 - Market Analysis
-
-Search and analyze markets by various criteria.
-
-- Search by keyword
-- Filter by volume, liquidity
-- Analyze market spreads
-
-### 04 - KLine Aggregation
-
-Get price history for charting.
-
-- Multi-timeframe candles (1m, 5m, 1h, 1d)
-- OHLCV data
-- Dual YES/NO price tracking
-
-### 05 - Follow Wallet Strategy
-
-Simulate copy trading based on smart money signals.
-
-- Monitor wallet activity
-- Generate trade signals
-- Backtest strategy performance
-
-### 06 - Services Demo
-
-High-level service abstractions.
-
-- `WalletService` - Wallet analysis helpers
-- `MarketService` - Market data aggregation
-
-### 07 - Real-time WebSocket
-
-Live orderbook streaming.
-
-- Connect to Polymarket WebSocket
-- Real-time price updates
-- Orderbook change events
-
-### 08 - Trading Orders
-
-Place and manage orders (requires private key).
-
-```bash
-POLY_PRIVKEY=0x... npx tsx examples/08-trading-orders.ts
-```
-
-- Create limit/market orders
-- Cancel orders
-- Check order status
-
-### 09 - Rewards Tracking
-
-Track liquidity provider rewards.
-
-- Earned rewards by market
-- Order scoring metrics
-- Reward rate analysis
-
-### 10 - CTF Operations
-
-On-chain token operations (requires private key + USDC.e).
-
-```bash
-POLY_PRIVKEY=0x... npx tsx examples/10-ctf-operations.ts
-```
-
-**Critical:** Uses USDC.e (not native USDC):
-| Token | Address | CTF Compatible |
-|-------|---------|----------------|
-| USDC.e | `0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174` | Yes |
-| Native USDC | `0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359` | No |
-
-Operations:
-- **Split**: USDC.e → YES + NO tokens
-- **Merge**: YES + NO → USDC.e (arbitrage profit)
-- **Redeem**: Winning tokens → USDC.e
-
-### 11 - Live Arbitrage Scan
-
-Scan markets for arbitrage opportunities (read-only).
-
-- Fetches active markets
-- Calculates effective prices
-- Detects long/short arb opportunities
-
-### 12 - Trending Arbitrage Monitor
-
-Continuous monitoring of trending markets.
-
-- Real-time orderbook analysis
-- Correct effective price calculation
-- Configurable scan intervals
-
----
-
-## Arbitrage Concepts
-
-Polymarket orderbooks have a mirroring property:
-- **Buying YES @ P = Selling NO @ (1-P)**
-
-Correct effective prices:
-```
-effectiveBuyYes = min(YES.ask, 1 - NO.bid)
-effectiveBuyNo = min(NO.ask, 1 - YES.bid)
-effectiveSellYes = max(YES.bid, 1 - NO.ask)
-effectiveSellNo = max(NO.bid, 1 - YES.ask)
-```
-
-| Arb Type | Condition | Action |
-|----------|-----------|--------|
-| Long | `effectiveBuyYes + effectiveBuyNo < 1` | Buy both, merge for $1 |
-| Short | `effectiveSellYes + effectiveSellNo > 1` | Split $1, sell both |
-
----
-
-## Environment Variables
-
-| Variable | Description | Required For |
-|----------|-------------|--------------|
-| `POLY_PRIVKEY` | Private key for trading | 08, 09, 10 |
-| `SCAN_INTERVAL_MS` | Arb scan interval (ms) | 12 |
-| `PROFIT_THRESHOLD` | Min arb profit % | 11, 12 |

package/scripts/README.md

@@ -1,163 +0,0 @@
-# Poly-SDK Scripts
-
-Utility scripts for testing and operating with Polymarket.
-
-## Environment Setup
-
-Set environment variable:
-
-```bash
-export POLY_PRIVKEY=0x...  # Your private key
-```
-
-Or pass inline:
-
-```bash
-POLY_PRIVKEY=0x... npx tsx scripts/...
-```
-
----
-
-## Directory Structure
-
-```
-scripts/
-├── approvals/          # ERC20/ERC1155 approval scripts
-├── deposit/            # USDC deposit and swap scripts
-├── trading/            # Order and position management
-├── wallet/             # Wallet balance and verification
-├── verify/             # API verification tests
-└── research/           # Market research and analysis
-```
-
----
-
-## Scripts Reference
-
-### `approvals/` - Token Approvals
-
-| Script | Description |
-|--------|-------------|
-| `check-allowance.ts` | Check USDC allowance for CTF Exchange |
-| `check-all-allowances.ts` | Check all token allowances at once |
-| `check-ctf-approval.ts` | Check CTF/ERC1155 approval status |
-| `approve-neg-risk.ts` | Approve USDC for Neg Risk Exchange |
-| `approve-erc1155.ts` | Approve ERC1155 for CTF Exchange |
-| `approve-neg-risk-erc1155.ts` | Approve ERC1155 for Neg Risk Exchange |
-
-```bash
-# Check all allowances
-npx tsx scripts/approvals/check-all-allowances.ts
-
-# Approve for neg risk markets
-npx tsx scripts/approvals/approve-neg-risk.ts
-```
-
----
-
-### `deposit/` - Deposits & Swaps
-
-| Script | Description |
-|--------|-------------|
-| `deposit-native-usdc.ts` | Deposit Native USDC via Bridge |
-| `deposit-usdc.ts` | Deposit USDC.e directly |
-| `swap-usdc-to-usdce.ts` | Swap Native USDC → USDC.e on DEX |
-
-```bash
-# Check deposit address and status
-npx tsx scripts/deposit/deposit-native-usdc.ts check
-
-# Deposit $50 via Bridge
-npx tsx scripts/deposit/deposit-native-usdc.ts deposit 50
-```
-
-**Important:** USDC.e is required for Polymarket CTF operations. Native USDC must be swapped or bridged first.
-
----
-
-### `trading/` - Orders & Positions
-
-| Script | Description |
-|--------|-------------|
-| `check-orders.ts` | View open orders and recent trades |
-| `test-order.ts` | Test order placement |
-| `sell-nvidia-positions.ts` | Sell specific positions |
-
-```bash
-# Check open orders
-npx tsx scripts/trading/check-orders.ts
-
-# Test order placement
-npx tsx scripts/trading/test-order.ts
-```
-
----
-
-### `wallet/` - Wallet Management
-
-| Script | Description |
-|--------|-------------|
-| `check-wallet-balances.ts` | Check all wallet balances |
-| `verify-wallet-tools.ts` | Verify wallet MCP tools |
-| `test-wallet-operations.ts` | Test wallet operations |
-
-```bash
-# Check balances
-npx tsx scripts/wallet/check-wallet-balances.ts
-```
-
----
-
-### `verify/` - API Verification
-
-| Script | Description |
-|--------|-------------|
-| `verify-all-apis.ts` | Verify all API endpoints |
-| `test-search-mcp.ts` | Test MCP search tools |
-| `test-approve-trading.ts` | Test trading approvals |
-
-```bash
-# Verify all APIs work
-npx tsx scripts/verify/verify-all-apis.ts
-```
-
----
-
-### `research/` - Market Research
-
-| Script | Description |
-|--------|-------------|
-| `research-markets.ts` | ARB/MM/Hybrid market analysis |
-
-```bash
-# Find arbitrage and MM opportunities
-npx tsx scripts/research/research-markets.ts
-```
-
----
-
-## Important Concepts
-
-### USDC Types
-
-| Token | Address | Use |
-|-------|---------|-----|
-| USDC.e (Bridged) | `0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174` | **Required for CTF** |
-| Native USDC | `0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359` | Must swap to USDC.e |
-
-### Effective Prices
-
-Polymarket orderbooks have mirroring:
-- Buying YES @ P = Selling NO @ (1-P)
-
-```
-effectiveBuyYes = min(YES.bestAsk, 1 - NO.bestBid)
-effectiveBuyNo = min(NO.bestAsk, 1 - YES.bestBid)
-```
-
-### Arbitrage Detection
-
-| Type | Condition | Action |
-|------|-----------|--------|
-| Long | `effectiveBuyYes + effectiveBuyNo < 1` | Buy both, merge |
-| Short | `effectiveSellYes + effectiveSellNo > 1` | Split, sell both |

package/scripts/approvals/approve-erc1155.ts

@@ -1,129 +0,0 @@
-#!/usr/bin/env npx tsx
-/**
- * Approve ERC1155 for selling YES/NO tokens
- *
- * This sets setApprovalForAll on the Conditional Tokens contract
- * to allow the exchanges to transfer your YES/NO tokens.
- */
-
-import { ethers } from 'ethers';
-import * as fs from 'fs';
-import * as path from 'path';
-import { fileURLToPath } from 'url';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-// Read private key
-const envPath = path.resolve(__dirname, '../../earning-engine/dashboard-api/.env');
-const envContent = fs.readFileSync(envPath, 'utf8');
-const match = envContent.match(/^PRIVATE_KEY=(.+)$/m);
-const PRIVATE_KEY = match ? match[1].trim() : '';
-
-if (!PRIVATE_KEY) {
-  console.error('PRIVATE_KEY not found');
-  process.exit(1);
-}
-
-// Contract addresses
-const CONDITIONAL_TOKENS = '0x4D97DCd97eC945f40cF65F87097ACe5EA0476045';
-const CTF_EXCHANGE = '0x4bFb41d5B3570DeFd03C39a9A4D8dE6Bd8B8982E';
-const NEG_RISK_CTF_EXCHANGE = '0xC5d563A36AE78145C45a50134d48A1215220f80a';
-
-const ERC1155_ABI = [
-  'function setApprovalForAll(address operator, bool approved) external',
-  'function isApprovedForAll(address account, address operator) view returns (bool)',
-];
-
-async function main() {
-  console.log('╔════════════════════════════════════════════════════════════════╗');
-  console.log('║       ERC1155 APPROVAL FOR SELLING YES/NO TOKENS                ║');
-  console.log('╚════════════════════════════════════════════════════════════════╝');
-  console.log('');
-
-  const rpcs = [
-    'https://polygon-bor-rpc.publicnode.com',
-    'https://polygon.drpc.org',
-    'https://polygon-rpc.com',
-  ];
-
-  for (const rpc of rpcs) {
-    console.log(`Trying RPC: ${rpc}`);
-    try {
-      const provider = new ethers.providers.JsonRpcProvider({
-        url: rpc,
-        timeout: 30000,
-      });
-
-      const network = await provider.getNetwork();
-      console.log(`Connected to chain ${network.chainId}`);
-
-      const wallet = new ethers.Wallet(PRIVATE_KEY, provider);
-      console.log(`Wallet: ${wallet.address}`);
-      console.log('');
-
-      const conditionalTokens = new ethers.Contract(CONDITIONAL_TOKENS, ERC1155_ABI, wallet);
-
-      const operators = [
-        { name: 'CTF Exchange', address: CTF_EXCHANGE },
-        { name: 'Neg Risk CTF Exchange', address: NEG_RISK_CTF_EXCHANGE },
-      ];
-
-      // Check current approvals
-      console.log('─── Current ERC1155 Approvals ───');
-      let needsApproval = [];
-
-      for (const op of operators) {
-        const isApproved = await conditionalTokens.isApprovedForAll(wallet.address, op.address);
-        console.log(`${op.name}: ${isApproved ? '✅ Approved' : '❌ Not Approved'}`);
-        if (!isApproved) {
-          needsApproval.push(op);
-        }
-      }
-      console.log('');
-
-      if (needsApproval.length === 0) {
-        console.log('✅ All ERC1155 approvals are set!');
-        return;
-      }
-
-      // Approve missing operators
-      console.log('─── Setting Approvals ───');
-      const gasPrice = await provider.getGasPrice();
-      const adjustedGas = gasPrice.mul(2);
-      console.log(`Gas price: ${ethers.utils.formatUnits(adjustedGas, 'gwei')} Gwei`);
-      console.log('');
-
-      for (const op of needsApproval) {
-        console.log(`Approving ${op.name}...`);
-        try {
-          const tx = await conditionalTokens.setApprovalForAll(op.address, true, {
-            gasPrice: adjustedGas,
-            gasLimit: 100000,
-          });
-          console.log(`  TX: ${tx.hash}`);
-          const receipt = await tx.wait();
-          console.log(`  ✅ Confirmed in block ${receipt.blockNumber}`);
-        } catch (error: any) {
-          console.log(`  ❌ Failed: ${error.message}`);
-        }
-      }
-
-      console.log('');
-      console.log('─── Verifying Approvals ───');
-      for (const op of operators) {
-        const isApproved = await conditionalTokens.isApprovedForAll(wallet.address, op.address);
-        console.log(`${op.name}: ${isApproved ? '✅ Approved' : '❌ Not Approved'}`);
-      }
-
-      return;
-    } catch (error: any) {
-      console.log(`Failed: ${error.message}`);
-      console.log('');
-    }
-  }
-
-  console.log('❌ All RPCs failed!');
-}
-
-main().catch(console.error);