@catalyst-team/poly-sdk 0.2.0 → 0.3.0

package/scripts/verify/test-approve-trading.ts

@@ -1,98 +0,0 @@
-/**
- * Test Approve Trading
- *
- * Approve all required contracts for trading on Polymarket.
- * This will send real transactions!
- *
- * Usage:
- *   PRIVATE_KEY=0x... npx tsx scripts/test-approve-trading.ts
- */
-
-import { ethers } from 'ethers';
-import dotenv from 'dotenv';
-import { AuthorizationService } from '../src/index.js';
-
-dotenv.config();
-
-const PRIVATE_KEY = process.env.POLY_PRIVATE_KEY || process.env.PRIVATE_KEY;
-
-if (!PRIVATE_KEY) {
-  console.error('❌ Error: No private key found.');
-  process.exit(1);
-}
-
-const POLYGON_RPC = 'https://polygon-rpc.com';
-
-async function main() {
-  console.log('╔════════════════════════════════════════════════════════════╗');
-  console.log('║           APPROVE TRADING TEST                             ║');
-  console.log('╚════════════════════════════════════════════════════════════╝\n');
-
-  const provider = new ethers.providers.JsonRpcProvider(POLYGON_RPC);
-  const signer = new ethers.Wallet(PRIVATE_KEY, provider);
-
-  console.log(`Wallet: ${signer.address}`);
-
-  // Check current balance for gas
-  const balance = await provider.getBalance(signer.address);
-  const maticBalance = ethers.utils.formatEther(balance);
-  console.log(`MATIC Balance: ${maticBalance}\n`);
-
-  if (parseFloat(maticBalance) < 0.1) {
-    console.error('❌ Insufficient MATIC for gas. Need at least 0.1 MATIC');
-    process.exit(1);
-  }
-
-  const authService = new AuthorizationService(signer);
-
-  // Check current state
-  console.log('Checking current allowances...');
-  const before = await authService.checkAllowances();
-  console.log(`Trading Ready: ${before.tradingReady ? '✅' : '❌'}\n`);
-
-  if (before.tradingReady) {
-    console.log('✅ Already ready for trading. No approvals needed.');
-    return;
-  }
-
-  // Approve all
-  console.log('Approving all contracts...\n');
-
-  try {
-    const result = await authService.approveAll();
-
-    console.log('Results:');
-    console.log(`  Wallet: ${result.wallet}`);
-    console.log(`  All Approved: ${result.allApproved ? '✅' : '❌'}`);
-
-    console.log('\n  ERC20 Approvals:');
-    for (const approval of result.erc20Approvals) {
-      const status = approval.success ? '✅' : '❌';
-      console.log(`    ${status} ${approval.contract}`);
-      if (approval.txHash) {
-        console.log(`       TX: https://polygonscan.com/tx/${approval.txHash}`);
-      }
-      if (approval.error) {
-        console.log(`       Error: ${approval.error}`);
-      }
-    }
-
-    console.log('\n  ERC1155 Approvals:');
-    for (const approval of result.erc1155Approvals) {
-      const status = approval.success ? '✅' : '❌';
-      console.log(`    ${status} ${approval.contract}`);
-      if (approval.txHash) {
-        console.log(`       TX: https://polygonscan.com/tx/${approval.txHash}`);
-      }
-      if (approval.error) {
-        console.log(`       Error: ${approval.error}`);
-      }
-    }
-
-    console.log(`\n${result.summary}`);
-  } catch (err) {
-    console.error(`\n❌ Error: ${err instanceof Error ? err.message : err}`);
-  }
-}
-
-main().catch(console.error);

package/scripts/verify/test-provider-fix.ts

@@ -1,43 +0,0 @@
-/**
- * Verify provider fix for SwapService
- * This script tests that the provider initialization works correctly
- */
-
-import { ethers } from 'ethers';
-
-// Test that signer without provider works after fix
-async function testProviderFix() {
-  console.log('Testing provider fix...\n');
-
-  // Simulate a signer without provider (like what SDK returns)
-  const privateKey = process.env.POLY_PRIVATE_KEY;
-  if (!privateKey) {
-    console.error('POLY_PRIVATE_KEY not set');
-    process.exit(1);
-  }
-
-  // Create signer WITHOUT provider (simulates SDK issue)
-  const signerNoProvider = new ethers.Wallet(privateKey);
-  console.log('1. Created signer without provider:');
-  console.log('   - Address:', signerNoProvider.address);
-  console.log('   - Has provider:', !!signerNoProvider.provider);
-
-  // Apply the fix: connect to provider if missing
-  const provider = new ethers.providers.JsonRpcProvider('https://polygon-rpc.com');
-  const signer = signerNoProvider.provider ? signerNoProvider : signerNoProvider.connect(provider);
-  
-  console.log('\n2. After fix:');
-  console.log('   - Has provider:', !!signer.provider);
-
-  // Test that provider works
-  try {
-    const balance = await signer.provider!.getBalance(signer.address);
-    console.log('   - MATIC balance:', ethers.utils.formatEther(balance));
-    console.log('\n✅ Provider fix working correctly!');
-  } catch (err) {
-    console.error('\n❌ Provider still not working:', err);
-    process.exit(1);
-  }
-}
-
-testProviderFix().catch(console.error);

package/scripts/verify/test-search-mcp.ts

@@ -1,113 +0,0 @@
-/**
- * Test Search Markets MCP Tool
- *
- * Verify the improved search functionality.
- */
-
-import { PolymarketSDK } from '../src/index.js';
-import { createMcpHandler } from '../src/mcp/index.js';
-
-async function main() {
-  console.log('╔════════════════════════════════════════════════════════════╗');
-  console.log('║           TEST: search_markets MCP TOOL                    ║');
-  console.log('╚════════════════════════════════════════════════════════════╝\n');
-
-  const sdk = new PolymarketSDK();
-  const handler = createMcpHandler(sdk);
-
-  // Test 1: Search for "bitcoin"
-  console.log('--- Test 1: Search for "bitcoin" ---');
-  try {
-    const result = await handler('search_markets', {
-      query: 'bitcoin',
-      limit: 5,
-    });
-
-    console.log('Results:');
-    const data = result as { markets: Array<{ question: string; volume24h: number }>; total: number };
-    data.markets.forEach((m, i) => {
-      console.log(`  ${i + 1}. ${m.question}`);
-      console.log(`     24h Volume: $${m.volume24h?.toLocaleString() || 'N/A'}`);
-    });
-    console.log(`\nTotal matches: ${data.total}`);
-  } catch (err) {
-    console.log(`Error: ${err}`);
-  }
-
-  // Test 2: Search for "trump"
-  console.log('\n--- Test 2: Search for "trump" ---');
-  try {
-    const result = await handler('search_markets', {
-      query: 'trump',
-      limit: 5,
-    });
-
-    const data = result as { markets: Array<{ question: string; volume24h: number }>; total: number };
-    data.markets.forEach((m, i) => {
-      console.log(`  ${i + 1}. ${m.question}`);
-      console.log(`     24h Volume: $${m.volume24h?.toLocaleString() || 'N/A'}`);
-    });
-    console.log(`\nTotal matches: ${data.total}`);
-  } catch (err) {
-    console.log(`Error: ${err}`);
-  }
-
-  // Test 3: Search with category filter
-  console.log('\n--- Test 3: Search "price" with Crypto category ---');
-  try {
-    const result = await handler('search_markets', {
-      query: 'price',
-      category: 'Crypto',
-      limit: 5,
-    });
-
-    const data = result as { markets: Array<{ question: string; volume24h: number }>; total: number };
-    data.markets.forEach((m, i) => {
-      console.log(`  ${i + 1}. ${m.question}`);
-    });
-    console.log(`\nTotal matches: ${data.total}`);
-  } catch (err) {
-    console.log(`Error: ${err}`);
-  }
-
-  // Test 4: Multi-word search
-  console.log('\n--- Test 4: Multi-word search "fed interest rate" ---');
-  try {
-    const result = await handler('search_markets', {
-      query: 'fed interest rate',
-      limit: 5,
-    });
-
-    const data = result as { markets: Array<{ question: string; volume24h: number }>; total: number };
-    data.markets.forEach((m, i) => {
-      console.log(`  ${i + 1}. ${m.question}`);
-      console.log(`     24h Volume: $${m.volume24h?.toLocaleString() || 'N/A'}`);
-    });
-    console.log(`\nTotal matches: ${data.total}`);
-  } catch (err) {
-    console.log(`Error: ${err}`);
-  }
-
-  // Test 5: Trending markets
-  console.log('\n--- Test 5: Trending markets (for comparison) ---');
-  try {
-    const result = await handler('get_trending_markets', {
-      limit: 5,
-      sortBy: 'volume',
-    });
-
-    const data = result as { markets: Array<{ question: string; volume24h: number }> };
-    data.markets.forEach((m, i) => {
-      console.log(`  ${i + 1}. ${m.question}`);
-      console.log(`     24h Volume: $${m.volume24h?.toLocaleString() || 'N/A'}`);
-    });
-  } catch (err) {
-    console.log(`Error: ${err}`);
-  }
-
-  console.log('\n' + '═'.repeat(60));
-  console.log('TEST COMPLETE');
-  console.log('═'.repeat(60));
-}
-
-main().catch(console.error);

package/scripts/verify/verify-all-apis.ts

@@ -1,160 +0,0 @@
-/**
- * Verify all Polymarket API responses against SDK type definitions
- *
- * Run: pnpm -F @catalyst-team/poly-sdk tsx scripts/verify-all-apis.ts
- */
-
-const DATA_API = 'https://data-api.polymarket.com';
-const GAMMA_API = 'https://gamma-api.polymarket.com';
-const CLOB_API = 'https://clob.polymarket.com';
-
-// Known active wallet for testing
-const TEST_WALLET = '0x1c579085b4dcdf00f0ce6f2d8c1d402fec0f1632';
-
-interface FieldAnalysis {
-  field: string;
-  type: string;
-  sample: unknown;
-  isNull: boolean;
-}
-
-function analyzeFields(obj: Record<string, unknown>, prefix = ''): FieldAnalysis[] {
-  const results: FieldAnalysis[] = [];
-  for (const [key, value] of Object.entries(obj)) {
-    const fieldPath = prefix ? `${prefix}.${key}` : key;
-    const type = value === null ? 'null' : Array.isArray(value) ? 'array' : typeof value;
-    results.push({
-      field: fieldPath,
-      type,
-      sample: type === 'object' ? '[object]' : type === 'array' ? `[${(value as unknown[]).length} items]` : value,
-      isNull: value === null,
-    });
-    if (type === 'object' && value !== null) {
-      results.push(...analyzeFields(value as Record<string, unknown>, fieldPath));
-    }
-  }
-  return results;
-}
-
-async function fetchAndAnalyze(name: string, url: string, extractFirst = true) {
-  console.log(`\n${'='.repeat(60)}`);
-  console.log(`API: ${name}`);
-  console.log(`URL: ${url}`);
-  console.log('='.repeat(60));
-
-  try {
-    const response = await fetch(url);
-    if (!response.ok) {
-      console.log(`ERROR: ${response.status} ${response.statusText}`);
-      return null;
-    }
-
-    const data = await response.json();
-    const sample = extractFirst && Array.isArray(data) ? data[0] : data;
-
-    if (!sample) {
-      console.log('No data returned');
-      return null;
-    }
-
-    console.log('\nRaw Response Sample:');
-    console.log(JSON.stringify(sample, null, 2));
-
-    console.log('\nField Analysis:');
-    const fields = analyzeFields(sample as Record<string, unknown>);
-    for (const f of fields) {
-      const nullMarker = f.isNull ? ' [NULL]' : '';
-      console.log(`  ${f.field}: ${f.type}${nullMarker}`);
-    }
-
-    return sample;
-  } catch (error) {
-    console.log(`ERROR: ${error}`);
-    return null;
-  }
-}
-
-async function main() {
-  console.log('Polymarket API Verification Script');
-  console.log('===================================\n');
-
-  // ===== DATA API =====
-  console.log('\n' + '#'.repeat(60));
-  console.log('# DATA API');
-  console.log('#'.repeat(60));
-
-  // Positions
-  await fetchAndAnalyze(
-    'Positions',
-    `${DATA_API}/positions?user=${TEST_WALLET}`
-  );
-
-  // Activity
-  await fetchAndAnalyze(
-    'Activity',
-    `${DATA_API}/activity?user=${TEST_WALLET}&limit=1`
-  );
-
-  // Trades
-  await fetchAndAnalyze(
-    'Trades',
-    `${DATA_API}/trades?limit=1`
-  );
-
-  // Leaderboard
-  await fetchAndAnalyze(
-    'Leaderboard',
-    `${DATA_API}/v1/leaderboard?limit=1`
-  );
-
-  // ===== GAMMA API =====
-  console.log('\n' + '#'.repeat(60));
-  console.log('# GAMMA API');
-  console.log('#'.repeat(60));
-
-  // Markets
-  const market = await fetchAndAnalyze(
-    'Markets',
-    `${GAMMA_API}/markets?active=true&limit=1`
-  );
-
-  // Events
-  await fetchAndAnalyze(
-    'Events',
-    `${GAMMA_API}/events?active=true&limit=1`
-  );
-
-  // ===== CLOB API =====
-  console.log('\n' + '#'.repeat(60));
-  console.log('# CLOB API');
-  console.log('#'.repeat(60));
-
-  // Get a conditionId from gamma market
-  const conditionId = (market as Record<string, unknown>)?.conditionId;
-  if (conditionId) {
-    // Market
-    const clobMarket = await fetchAndAnalyze(
-      'CLOB Market',
-      `${CLOB_API}/markets/${conditionId}`,
-      false
-    );
-
-    // Orderbook
-    const tokens = (clobMarket as Record<string, unknown>)?.tokens as Array<{ token_id: string }>;
-    if (tokens?.[0]) {
-      await fetchAndAnalyze(
-        'Orderbook',
-        `${CLOB_API}/book?token_id=${tokens[0].token_id}`,
-        false
-      );
-    }
-  }
-
-  // ===== SUMMARY =====
-  console.log('\n' + '#'.repeat(60));
-  console.log('# VERIFICATION COMPLETE');
-  console.log('#'.repeat(60));
-  console.log('\nReview the output above to compare with SDK type definitions.');
-}
-
-main().catch(console.error);

package/scripts/wallet/check-wallet-balances.ts

@@ -1,75 +0,0 @@
-/**
- * Check Wallet Balances Script
- *
- * Query token balances for any wallet address on Polygon.
- * No private key required - just provide an address.
- *
- * Usage:
- *   npx tsx scripts/check-wallet-balances.ts <address>
- *   npx tsx scripts/check-wallet-balances.ts 0xc2e7800b5af46e6093872b177b7a5e7f0563be51
- */
-
-import { SwapService, POLYGON_TOKENS } from '../src/index.js';
-
-const TEST_ADDRESS = '0xc2e7800b5af46e6093872b177b7a5e7f0563be51'; // Top Polymarket trader
-
-async function main() {
-  const address = process.argv[2] || TEST_ADDRESS;
-
-  console.log('╔════════════════════════════════════════════════════════════╗');
-  console.log('║          POLYGON WALLET BALANCE CHECKER                     ║');
-  console.log('╚════════════════════════════════════════════════════════════╝');
-  console.log('');
-  console.log(`Wallet: ${address}`);
-  console.log('');
-
-  console.log('Fetching balances...');
-  console.log('');
-
-  try {
-    const balances = await SwapService.getWalletBalances(address);
-
-    console.log('─── Token Balances ───');
-    console.log('');
-
-    for (const b of balances) {
-      const amount = parseFloat(b.balance);
-      if (amount > 0) {
-        console.log(`  ${b.symbol.padEnd(10)} ${b.balance}`);
-      }
-    }
-
-    // Show zero balances
-    const zeroBalances = balances.filter((b) => parseFloat(b.balance) === 0);
-    if (zeroBalances.length > 0) {
-      console.log('');
-      console.log(`  (Zero balance: ${zeroBalances.map((b) => b.symbol).join(', ')})`);
-    }
-
-    // Summary
-    console.log('');
-    console.log('─── Summary ───');
-    const nonZero = balances.filter((b) => parseFloat(b.balance) > 0);
-    console.log(`  Tokens with balance: ${nonZero.length}`);
-
-    // Calculate stablecoin value
-    let stablecoinValue = 0;
-    for (const b of balances) {
-      if (['USDC', 'USDC_E', 'USDT', 'DAI'].includes(b.token)) {
-        stablecoinValue += parseFloat(b.balance);
-      }
-    }
-    console.log(`  Stablecoin value: $${stablecoinValue.toFixed(2)}`);
-
-    console.log('');
-    console.log('─── Supported Tokens ───');
-    console.log(`  ${Object.keys(POLYGON_TOKENS).join(', ')}`);
-
-  } catch (err) {
-    console.error(`Error: ${err instanceof Error ? err.message : err}`);
-  }
-
-  console.log('');
-}
-
-main().catch(console.error);

package/scripts/wallet/test-wallet-operations.ts

@@ -1,191 +0,0 @@
-/**
- * Test Wallet Operations
- *
- * Comprehensive test for all wallet-related operations that require a private key:
- * - Token balances
- * - Allowance checking
- * - Token approvals
- * - Swap operations (dry run)
- *
- * Usage:
- *   POLY_PRIVATE_KEY=0x... npx tsx scripts/test-wallet-operations.ts
- *   Or set PRIVATE_KEY in .env file
- */
-
-import { ethers } from 'ethers';
-import dotenv from 'dotenv';
-import {
-  SwapService,
-  AuthorizationService,
-  POLYGON_TOKENS,
-} from '../src/index.js';
-
-dotenv.config();
-
-const PRIVATE_KEY = process.env.POLY_PRIVATE_KEY || process.env.PRIVATE_KEY;
-
-if (!PRIVATE_KEY) {
-  console.error('❌ Error: No private key found.');
-  console.error('   Set POLY_PRIVATE_KEY or PRIVATE_KEY in environment or .env file');
-  process.exit(1);
-}
-
-const POLYGON_RPC = 'https://polygon-rpc.com';
-
-async function main() {
-  console.log('╔════════════════════════════════════════════════════════════╗');
-  console.log('║           POLY-SDK WALLET OPERATIONS TEST                  ║');
-  console.log('╚════════════════════════════════════════════════════════════╝\n');
-
-  // Initialize
-  const provider = new ethers.providers.JsonRpcProvider(POLYGON_RPC);
-  const signer = new ethers.Wallet(PRIVATE_KEY, provider);
-
-  console.log(`Wallet Address: ${signer.address}`);
-  console.log(`Network: Polygon Mainnet (${POLYGON_RPC})`);
-  console.log('');
-
-  // Test 1: Get native MATIC balance
-  console.log('═══════════════════════════════════════════════════════════');
-  console.log('Test 1: Native MATIC Balance');
-  console.log('═══════════════════════════════════════════════════════════');
-  try {
-    const maticBalance = await provider.getBalance(signer.address);
-    const maticFormatted = ethers.utils.formatEther(maticBalance);
-    console.log(`  MATIC Balance: ${maticFormatted} MATIC`);
-
-    if (parseFloat(maticFormatted) < 0.01) {
-      console.log('  ⚠️  Warning: Low MATIC balance. Need MATIC for gas fees.');
-    } else {
-      console.log('  ✅ Sufficient MATIC for gas');
-    }
-  } catch (err) {
-    console.log(`  ❌ Error: ${err instanceof Error ? err.message : err}`);
-  }
-
-  // Test 2: Get all token balances using SwapService
-  console.log('\n═══════════════════════════════════════════════════════════');
-  console.log('Test 2: Token Balances (SwapService.getBalances)');
-  console.log('═══════════════════════════════════════════════════════════');
-  try {
-    const swapService = new SwapService(signer);
-    const balances = await swapService.getBalances();
-
-    console.log('  Token Balances:');
-    for (const b of balances) {
-      const amount = parseFloat(b.balance);
-      const status = amount > 0 ? '✅' : '  ';
-      console.log(`    ${status} ${b.symbol.padEnd(8)} ${b.balance}`);
-    }
-
-    // Calculate total stablecoin value
-    let stablecoinValue = 0;
-    for (const b of balances) {
-      if (['USDC', 'USDC_E', 'USDT', 'DAI'].includes(b.token)) {
-        stablecoinValue += parseFloat(b.balance);
-      }
-    }
-    console.log(`\n  Total Stablecoin Value: $${stablecoinValue.toFixed(2)}`);
-  } catch (err) {
-    console.log(`  ❌ Error: ${err instanceof Error ? err.message : err}`);
-  }
-
-  // Test 3: Check allowances using AuthorizationService
-  console.log('\n═══════════════════════════════════════════════════════════');
-  console.log('Test 3: Trading Allowances (AuthorizationService)');
-  console.log('═══════════════════════════════════════════════════════════');
-  try {
-    const authService = new AuthorizationService(signer);
-    const result = await authService.checkAllowances();
-
-    console.log(`  Wallet: ${result.wallet}`);
-    console.log(`  USDC Balance: ${result.usdcBalance}`);
-    console.log(`  Trading Ready: ${result.tradingReady ? '✅ Yes' : '❌ No'}`);
-
-    console.log('\n  ERC20 Allowances:');
-    for (const allowance of result.erc20Allowances) {
-      const status = allowance.approved ? '✅' : '❌';
-      console.log(`    ${status} ${allowance.contract}: ${allowance.allowance}`);
-    }
-
-    console.log('\n  ERC1155 Approvals:');
-    for (const approval of result.erc1155Approvals) {
-      const status = approval.approved ? '✅' : '❌';
-      console.log(`    ${status} ${approval.contract}`);
-    }
-
-    if (result.issues.length > 0) {
-      console.log('\n  Issues:');
-      for (const issue of result.issues) {
-        console.log(`    ⚠️  ${issue}`);
-      }
-    }
-  } catch (err) {
-    console.log(`  ❌ Error: ${err instanceof Error ? err.message : err}`);
-  }
-
-  // Test 4: Swap Quote (without executing)
-  console.log('\n═══════════════════════════════════════════════════════════');
-  console.log('Test 4: Swap Service (Quote Only - No Execution)');
-  console.log('═══════════════════════════════════════════════════════════');
-  try {
-    const swapService = new SwapService(signer);
-
-    // Check if we have any tokens to get a quote for
-    const balances = await swapService.getBalances();
-    const maticBalance = balances.find((b) => b.token === 'MATIC');
-    const usdcBalance = balances.find((b) => b.token === 'USDC');
-
-    if (maticBalance && parseFloat(maticBalance.balance) > 1) {
-      console.log('  Checking swap quote: 1 MATIC -> USDC');
-      // Note: We're not executing, just confirming the service initializes correctly
-      console.log('  ✅ SwapService initialized successfully');
-      console.log(`  Router: ${POLYGON_TOKENS.WMATIC} (WMATIC)`);
-      console.log(`  Can swap: MATIC, WMATIC, USDC, USDC_E, USDT, DAI, WETH`);
-    } else {
-      console.log('  ℹ️  Insufficient MATIC balance for swap test');
-      console.log('  ✅ SwapService initialized successfully');
-    }
-  } catch (err) {
-    console.log(`  ❌ Error: ${err instanceof Error ? err.message : err}`);
-  }
-
-  // Test 5: Static wallet query (no signer needed)
-  console.log('\n═══════════════════════════════════════════════════════════');
-  console.log('Test 5: Static Wallet Query (Any Address)');
-  console.log('═══════════════════════════════════════════════════════════');
-  try {
-    // Query a known top trader
-    const topTrader = '0xc2e7800b5af46e6093872b177b7a5e7f0563be51';
-    console.log(`  Querying wallet: ${topTrader}`);
-
-    const balances = await SwapService.getWalletBalances(topTrader);
-    const nonZero = balances.filter((b) => parseFloat(b.balance) > 0);
-
-    console.log('  Balances:');
-    for (const b of nonZero) {
-      console.log(`    ${b.symbol.padEnd(8)} ${parseFloat(b.balance).toLocaleString()}`);
-    }
-    console.log('  ✅ Static query works without signer');
-  } catch (err) {
-    console.log(`  ❌ Error: ${err instanceof Error ? err.message : err}`);
-  }
-
-  // Summary
-  console.log('\n═══════════════════════════════════════════════════════════');
-  console.log('SUMMARY');
-  console.log('═══════════════════════════════════════════════════════════');
-  console.log(`
-  ✅ Token balance queries work
-  ✅ Allowance checking works
-  ✅ SwapService initializes correctly
-  ✅ Static wallet queries work
-
-  To test actual transactions:
-  - Use approve-trading if allowances are missing
-  - Use swap if you want to exchange tokens
-  - Use deposit if you want to deposit to Polymarket
-  `);
-}
-
-main().catch(console.error);