@catalyst-team/poly-sdk 0.2.0 → 0.3.0

package/dist/__tests__/integration/ctf-client.integration.test.js

@@ -0,0 +1,234 @@
+/**
+ * CTF Client Integration Tests
+ *
+ * These tests verify the CTF (Conditional Token Framework) implementation
+ * by making REAL on-chain calls to Polygon.
+ *
+ * IMPORTANT: These tests are READ-ONLY and do not require a wallet.
+ * They verify:
+ * 1. Contract addresses are correct
+ * 2. Position ID calculation is correct
+ * 3. Market resolution queries work
+ * 4. Balance queries work
+ *
+ * Run with: pnpm test:integration
+ */
+import { describe, it, expect } from 'vitest';
+import { ethers } from 'ethers';
+import { CTF_CONTRACT, USDC_CONTRACT, NEG_RISK_CTF_EXCHANGE, NEG_RISK_ADAPTER, USDC_DECIMALS, } from '../../clients/ctf-client.js';
+// Public RPC for read-only tests
+const POLYGON_RPC = 'https://polygon-rpc.com';
+// Known addresses and markets for testing
+const KNOWN_WHALE_ADDRESS = '0x82a1b239c1ff9bc60a4c86caf5b6bdbd9fddfe20'; // Top trader
+const SECOND_CTF_CONTRACT = '0x4bFb41d5B3570DeFd03C39a9A4D8dE6Bd8B8982E';
+// ABIs for testing
+const CTF_ABI = [
+    'function balanceOf(address account, uint256 positionId) view returns (uint256)',
+    'function payoutNumerators(bytes32 conditionId, uint256 outcomeIndex) view returns (uint256)',
+    'function payoutDenominator(bytes32 conditionId) view returns (uint256)',
+    'function getOutcomeSlotCount(bytes32 conditionId) view returns (uint256)',
+];
+const ERC20_ABI = [
+    'function balanceOf(address account) view returns (uint256)',
+    'function decimals() view returns (uint8)',
+    'function symbol() view returns (string)',
+];
+describe('CTF Contract Verification', () => {
+    const provider = new ethers.providers.JsonRpcProvider(POLYGON_RPC);
+    describe('Contract Addresses', () => {
+        it('should verify CTF contract is deployed and accessible', async () => {
+            const ctf = new ethers.Contract(CTF_CONTRACT, CTF_ABI, provider);
+            // Query a known condition ID to verify contract works
+            // Using a random condition ID should return 0 for unresolved markets
+            const testConditionId = '0x0000000000000000000000000000000000000000000000000000000000000001';
+            const denominator = await ctf.payoutDenominator(testConditionId);
+            // Should return 0 for non-existent/unresolved condition
+            expect(denominator.toNumber()).toBe(0);
+            console.log(`✓ CTF Contract verified at ${CTF_CONTRACT}`);
+        }, 30000);
+        it('should verify USDC contract is deployed', async () => {
+            const usdc = new ethers.Contract(USDC_CONTRACT, ERC20_ABI, provider);
+            const [decimals, symbol] = await Promise.all([
+                usdc.decimals(),
+                usdc.symbol(),
+            ]);
+            expect(decimals).toBe(USDC_DECIMALS);
+            expect(symbol).toBe('USDC');
+            console.log(`✓ USDC Contract verified at ${USDC_CONTRACT}`);
+            console.log(`  Symbol: ${symbol}, Decimals: ${decimals}`);
+        }, 30000);
+        it('should verify second CTF contract exists', async () => {
+            // The second contract address from Polymarket docs
+            // Note: This is the NegRisk CTF contract with a different ABI
+            // We just verify the contract code exists
+            const code = await provider.getCode(SECOND_CTF_CONTRACT);
+            expect(code).not.toBe('0x');
+            expect(code.length).toBeGreaterThan(10);
+            console.log(`✓ Second CTF Contract verified at ${SECOND_CTF_CONTRACT}`);
+            console.log(`  Contract code size: ${(code.length - 2) / 2} bytes`);
+            console.log('  Note: This is the NegRisk CTF contract (different ABI from standard CTF)');
+        }, 30000);
+        it('should verify NegRisk Adapter contract exists', async () => {
+            // Check contract code exists
+            const code = await provider.getCode(NEG_RISK_ADAPTER);
+            expect(code).not.toBe('0x');
+            expect(code.length).toBeGreaterThan(10);
+            console.log(`✓ NegRisk Adapter verified at ${NEG_RISK_ADAPTER}`);
+            console.log(`  Contract code size: ${(code.length - 2) / 2} bytes`);
+        }, 30000);
+        it('should verify NegRisk CTF Exchange contract exists', async () => {
+            const code = await provider.getCode(NEG_RISK_CTF_EXCHANGE);
+            expect(code).not.toBe('0x');
+            expect(code.length).toBeGreaterThan(10);
+            console.log(`✓ NegRisk CTF Exchange verified at ${NEG_RISK_CTF_EXCHANGE}`);
+            console.log(`  Contract code size: ${(code.length - 2) / 2} bytes`);
+        }, 30000);
+    });
+    describe('Position ID Calculation', () => {
+        it('should calculate position ID correctly', () => {
+            // This matches the Polymarket gist for positionId calculation
+            // https://gist.github.com/polymarket/1e12f0ac3e23400ca53ec9b6e1ba00ce
+            const conditionId = '0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef';
+            const indexSet = 1; // YES outcome
+            // Collection ID = keccak256(parentCollectionId, conditionId, indexSet)
+            const collectionId = ethers.utils.keccak256(ethers.utils.defaultAbiCoder.encode(['bytes32', 'bytes32', 'uint256'], [ethers.constants.HashZero, conditionId, indexSet]));
+            // Position ID = keccak256(collateralToken, collectionId)
+            const positionId = ethers.utils.keccak256(ethers.utils.defaultAbiCoder.encode(['address', 'bytes32'], [USDC_CONTRACT, collectionId]));
+            // Verify the calculation produces valid bytes32
+            expect(positionId).toMatch(/^0x[a-f0-9]{64}$/);
+            expect(collectionId).toMatch(/^0x[a-f0-9]{64}$/);
+            console.log('✓ Position ID calculation verified');
+            console.log(`  Condition ID: ${conditionId.slice(0, 20)}...`);
+            console.log(`  Collection ID: ${collectionId.slice(0, 20)}...`);
+            console.log(`  Position ID: ${positionId.slice(0, 20)}...`);
+        });
+        it('should produce different position IDs for YES and NO', () => {
+            const conditionId = '0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef';
+            // YES position (indexSet = 1)
+            const yesCollectionId = ethers.utils.keccak256(ethers.utils.defaultAbiCoder.encode(['bytes32', 'bytes32', 'uint256'], [ethers.constants.HashZero, conditionId, 1]));
+            const yesPositionId = ethers.utils.keccak256(ethers.utils.defaultAbiCoder.encode(['address', 'bytes32'], [USDC_CONTRACT, yesCollectionId]));
+            // NO position (indexSet = 2)
+            const noCollectionId = ethers.utils.keccak256(ethers.utils.defaultAbiCoder.encode(['bytes32', 'bytes32', 'uint256'], [ethers.constants.HashZero, conditionId, 2]));
+            const noPositionId = ethers.utils.keccak256(ethers.utils.defaultAbiCoder.encode(['address', 'bytes32'], [USDC_CONTRACT, noCollectionId]));
+            expect(yesPositionId).not.toBe(noPositionId);
+            expect(yesCollectionId).not.toBe(noCollectionId);
+            console.log('✓ YES and NO position IDs are different');
+            console.log(`  YES Position ID: ${yesPositionId.slice(0, 20)}...`);
+            console.log(`  NO Position ID:  ${noPositionId.slice(0, 20)}...`);
+        });
+    });
+    describe('Balance Queries', () => {
+        it('should query USDC balance for known whale', async () => {
+            const usdc = new ethers.Contract(USDC_CONTRACT, ERC20_ABI, provider);
+            const balance = await usdc.balanceOf(KNOWN_WHALE_ADDRESS);
+            const formattedBalance = ethers.utils.formatUnits(balance, USDC_DECIMALS);
+            expect(balance.gte(0)).toBe(true);
+            console.log(`✓ USDC balance query works`);
+            console.log(`  Whale ${KNOWN_WHALE_ADDRESS.slice(0, 10)}... has ${parseFloat(formattedBalance).toLocaleString()} USDC`);
+        }, 30000);
+        it('should query CTF token balance', async () => {
+            const ctf = new ethers.Contract(CTF_CONTRACT, CTF_ABI, provider);
+            // Use a known position ID (we'll use a random one, should return 0)
+            const randomPositionId = ethers.utils.keccak256(ethers.utils.defaultAbiCoder.encode(['string'], ['random-test-position']));
+            const balance = await ctf.balanceOf(KNOWN_WHALE_ADDRESS, randomPositionId);
+            expect(balance.gte(0)).toBe(true);
+            console.log('✓ CTF balance query works');
+            console.log(`  Balance for random position: ${ethers.utils.formatUnits(balance, USDC_DECIMALS)}`);
+        }, 30000);
+    });
+    describe('Market Resolution', () => {
+        it('should query payout info for a real market condition', async () => {
+            // First get a real market from Gamma API to get a valid condition ID
+            const response = await fetch('https://gamma-api.polymarket.com/markets?closed=true&limit=1');
+            const markets = await response.json();
+            if (markets.length === 0) {
+                console.log('No closed markets found, skipping test');
+                return;
+            }
+            const ctf = new ethers.Contract(CTF_CONTRACT, CTF_ABI, provider);
+            const conditionId = markets[0].conditionId;
+            try {
+                const [yesNumerator, noNumerator, denominator] = await Promise.all([
+                    ctf.payoutNumerators(conditionId, 0),
+                    ctf.payoutNumerators(conditionId, 1),
+                    ctf.payoutDenominator(conditionId),
+                ]);
+                expect(yesNumerator.gte(0)).toBe(true);
+                expect(noNumerator.gte(0)).toBe(true);
+                expect(denominator.gte(0)).toBe(true);
+                const isResolved = denominator.gt(0);
+                console.log('✓ Market resolution query works');
+                console.log(`  Market: "${markets[0].question.slice(0, 40)}..."`);
+                console.log(`  Condition ID: ${conditionId.slice(0, 20)}...`);
+                console.log(`  Is resolved: ${isResolved}`);
+                if (isResolved) {
+                    console.log(`  Payout numerators: [${yesNumerator.toString()}, ${noNumerator.toString()}]`);
+                    console.log(`  Payout denominator: ${denominator.toString()}`);
+                }
+            }
+            catch (error) {
+                // Some markets might be NegRisk markets with different contract
+                console.log('✓ Query attempted (market might be NegRisk type)');
+                console.log(`  Condition ID: ${conditionId.slice(0, 20)}...`);
+            }
+        }, 30000);
+    });
+    describe('Gas Price', () => {
+        it('should fetch current gas price', async () => {
+            const gasPrice = await provider.getGasPrice();
+            const gasPriceGwei = ethers.utils.formatUnits(gasPrice, 'gwei');
+            expect(gasPrice.gt(0)).toBe(true);
+            console.log('✓ Gas price fetched');
+            console.log(`  Current gas price: ${parseFloat(gasPriceGwei).toFixed(2)} gwei`);
+        }, 30000);
+    });
+});
+describe('CTF Architecture Understanding', () => {
+    it('should document the two-contract architecture', () => {
+        /**
+         * Polymarket uses TWO different CTF systems:
+         *
+         * 1. STANDARD CTF (0x4D97DCd97eC945f40cF65F87097ACe5EA0476045)
+         *    - Used for simple binary (Yes/No) markets
+         *    - Operations: split, merge, redeem
+         *    - Each market is independent
+         *
+         * 2. NEGRISK CTF (0x4bFb41d5B3570DeFd03C39a9A4D8dE6Bd8B8982E)
+         *    - Used for "winner-take-all" events (elections, championships)
+         *    - Key innovation: NO shares can convert to YES shares in other markets
+         *    - Example: "Trump NO" can become "Biden YES + Harris YES + ..."
+         *
+         * Why NegRisk exists:
+         * - Capital efficiency: Don't need to buy YES in every candidate
+         * - Buying NO in one candidate = betting on all other candidates
+         * - The Negative Adapter (0xd91E80cF2E7be2e162c6513ceD06f1dD0dA35296) handles conversions
+         *
+         * Which contract to use:
+         * - Check the market's metadata to determine if it's a NegRisk market
+         * - Most simple Yes/No markets use Standard CTF
+         * - Multi-outcome events (elections, sports champions) may use NegRisk
+         */
+        console.log('✓ CTF Architecture Documented');
+        console.log('');
+        console.log('Standard CTF Contract:');
+        console.log(`  ${CTF_CONTRACT}`);
+        console.log('  - Simple Yes/No markets');
+        console.log('  - split/merge/redeem operations');
+        console.log('');
+        console.log('NegRisk CTF Contract:');
+        console.log(`  ${SECOND_CTF_CONTRACT}`);
+        console.log('  - Winner-take-all events');
+        console.log('  - NO shares convertible to YES in other markets');
+        console.log('');
+        console.log('NegRisk Adapter:');
+        console.log(`  ${NEG_RISK_ADAPTER}`);
+        console.log('  - Handles NO → YES conversions');
+        console.log('');
+        console.log('NegRisk CTF Exchange:');
+        console.log(`  ${NEG_RISK_CTF_EXCHANGE}`);
+        console.log('  - Trading for NegRisk markets');
+        // This test always passes - it's documentation
+        expect(true).toBe(true);
+    });
+});
+//# sourceMappingURL=ctf-client.integration.test.js.map

package/dist/__tests__/integration/ctf-client.integration.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ctf-client.integration.test.js","sourceRoot":"","sources":["../../../src/__tests__/integration/ctf-client.integration.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/integration/data-api.integration.test.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Data API Client Integration Tests
+ *
+ * These tests make REAL API calls to Polymarket.
+ *
+ * Run with: pnpm test:integration
+ */
+export {};
+//# sourceMappingURL=data-api.integration.test.d.ts.map

package/dist/__tests__/integration/data-api.integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-api.integration.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/integration/data-api.integration.test.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/__tests__/integration/data-api.integration.test.js

@@ -0,0 +1,164 @@
+/**
+ * Data API Client Integration Tests
+ *
+ * These tests make REAL API calls to Polymarket.
+ *
+ * Run with: pnpm test:integration
+ */
+import { describe, it, expect, beforeAll } from 'vitest';
+import { DataApiClient } from '../../clients/data-api.js';
+import { RateLimiter } from '../../core/rate-limiter.js';
+import { createUnifiedCache } from '../../core/unified-cache.js';
+describe('DataApiClient Integration', () => {
+    let client;
+    beforeAll(() => {
+        client = new DataApiClient(new RateLimiter(), createUnifiedCache());
+    });
+    describe('getLeaderboard', () => {
+        it('should fetch leaderboard entries', async () => {
+            const leaderboard = await client.getLeaderboard({ limit: 10 });
+            expect(Array.isArray(leaderboard.entries)).toBe(true);
+            expect(leaderboard.entries.length).toBeGreaterThan(0);
+            expect(leaderboard.entries.length).toBeLessThanOrEqual(10);
+            // Verify entry structure
+            for (const entry of leaderboard.entries) {
+                expect(typeof entry.address).toBe('string');
+                expect(entry.address.length).toBeGreaterThan(0);
+                expect(typeof entry.rank).toBe('number');
+                expect(entry.rank).toBeGreaterThan(0);
+                expect(typeof entry.pnl).toBe('number');
+                expect(typeof entry.volume).toBe('number');
+            }
+            // Verify ranks are in order
+            for (let i = 1; i < leaderboard.entries.length; i++) {
+                expect(leaderboard.entries[i].rank).toBeGreaterThan(leaderboard.entries[i - 1].rank);
+            }
+            console.log(`✓ Leaderboard fetched: ${leaderboard.entries.length} entries`);
+            console.log(`  #1: ${leaderboard.entries[0].address.slice(0, 10)}... PnL: $${leaderboard.entries[0].pnl.toLocaleString()}`);
+        }, 30000);
+        it('should handle pagination', async () => {
+            const page1 = await client.getLeaderboard({ limit: 5, offset: 0 });
+            const page2 = await client.getLeaderboard({ limit: 5, offset: 5 });
+            // Ranks should be continuous
+            if (page1.entries.length > 0 && page2.entries.length > 0) {
+                const lastRankPage1 = page1.entries[page1.entries.length - 1].rank;
+                const firstRankPage2 = page2.entries[0].rank;
+                expect(firstRankPage2).toBe(lastRankPage1 + 1);
+            }
+            console.log('✓ Pagination verified');
+        }, 30000);
+    });
+    describe('getTrades', () => {
+        it('should fetch recent trades', async () => {
+            const trades = await client.getTrades({ limit: 20 });
+            expect(Array.isArray(trades)).toBe(true);
+            if (trades.length > 0) {
+                // Verify trade structure
+                for (const trade of trades) {
+                    // id may not be present in all API responses
+                    if (trade.id !== undefined) {
+                        expect(typeof trade.id).toBe('string');
+                    }
+                    expect(['BUY', 'SELL']).toContain(trade.side);
+                    expect(typeof trade.price).toBe('number');
+                    expect(trade.price).toBeGreaterThanOrEqual(0);
+                    expect(trade.price).toBeLessThanOrEqual(1);
+                    expect(typeof trade.size).toBe('number');
+                    expect(trade.size).toBeGreaterThan(0);
+                    expect(typeof trade.timestamp).toBe('number');
+                }
+                console.log(`✓ Fetched ${trades.length} recent trades`);
+                console.log(`  Latest: ${trades[0].side} ${trades[0].size} @ ${trades[0].price}`);
+            }
+            else {
+                console.log('✓ No recent trades found (this is ok)');
+            }
+        }, 30000);
+        it('should fetch trades for specific market', async () => {
+            // Get a trending market first
+            const response = await fetch('https://gamma-api.polymarket.com/markets?active=true&limit=1&order=volume24hr&ascending=false');
+            const markets = await response.json();
+            if (markets.length === 0) {
+                console.log('No markets found, skipping test');
+                return;
+            }
+            const trades = await client.getTradesByMarket(markets[0].conditionId, 10);
+            expect(Array.isArray(trades)).toBe(true);
+            // All trades should be for this market
+            for (const trade of trades) {
+                expect(trade.market).toBe(markets[0].conditionId);
+            }
+            console.log(`✓ Fetched ${trades.length} trades for specific market`);
+        }, 30000);
+    });
+    describe('getPositions', () => {
+        it('should fetch positions for a known active wallet', async () => {
+            // Get top trader from leaderboard
+            const leaderboard = await client.getLeaderboard({ limit: 1 });
+            if (leaderboard.entries.length === 0) {
+                console.log('No leaderboard entries, skipping test');
+                return;
+            }
+            const address = leaderboard.entries[0].address;
+            const positions = await client.getPositions(address);
+            expect(Array.isArray(positions)).toBe(true);
+            if (positions.length > 0) {
+                // Verify position structure
+                for (const pos of positions) {
+                    expect(typeof pos.asset).toBe('string');
+                    expect(typeof pos.conditionId).toBe('string');
+                    // Polymarket has multi-outcome markets, not just Yes/No
+                    expect(typeof pos.outcome).toBe('string');
+                    expect(pos.outcome.length).toBeGreaterThan(0);
+                    expect(typeof pos.size).toBe('number');
+                    expect(typeof pos.avgPrice).toBe('number');
+                    expect(typeof pos.title).toBe('string');
+                }
+                console.log(`✓ Fetched ${positions.length} positions for ${address.slice(0, 10)}...`);
+            }
+            else {
+                console.log(`✓ Top trader has no current positions (this is ok)`);
+            }
+        }, 30000);
+        it('should return empty array for wallet with no positions', async () => {
+            // Use a random address that probably has no positions
+            const positions = await client.getPositions('0x0000000000000000000000000000000000000001');
+            expect(Array.isArray(positions)).toBe(true);
+            // Might be empty or have some positions, both are valid
+            console.log(`✓ Returned ${positions.length} positions for test address`);
+        }, 30000);
+    });
+    describe('getActivity', () => {
+        it('should fetch activity for an active wallet', async () => {
+            // Get top trader
+            const leaderboard = await client.getLeaderboard({ limit: 1 });
+            if (leaderboard.entries.length === 0) {
+                console.log('No leaderboard entries, skipping test');
+                return;
+            }
+            const address = leaderboard.entries[0].address;
+            const activity = await client.getActivity(address, { limit: 20 });
+            expect(Array.isArray(activity)).toBe(true);
+            if (activity.length > 0) {
+                // Verify activity structure
+                for (const act of activity) {
+                    // Polymarket has various activity types
+                    expect(['TRADE', 'SPLIT', 'MERGE', 'REDEEM', 'CONVERSION', 'YIELD', 'REWARD']).toContain(act.type);
+                    // Side might be null for non-trade activities
+                    if (act.type === 'TRADE') {
+                        expect(['BUY', 'SELL']).toContain(act.side);
+                    }
+                    expect(typeof act.size).toBe('number');
+                    expect(typeof act.price).toBe('number');
+                    expect(typeof act.timestamp).toBe('number');
+                    expect(act.timestamp).toBeGreaterThan(0);
+                }
+                console.log(`✓ Fetched ${activity.length} activities for ${address.slice(0, 10)}...`);
+            }
+            else {
+                console.log('✓ No recent activity found (this is ok)');
+            }
+        }, 30000);
+    });
+});
+//# sourceMappingURL=data-api.integration.test.js.map

package/dist/__tests__/integration/data-api.integration.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-api.integration.test.js","sourceRoot":"","sources":["../../../src/__tests__/integration/data-api.integration.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/integration/gamma-api.integration.test.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Gamma API Client Integration Tests
+ *
+ * These tests make REAL API calls to Polymarket.
+ *
+ * Run with: pnpm test:integration
+ */
+export {};
+//# sourceMappingURL=gamma-api.integration.test.d.ts.map

package/dist/__tests__/integration/gamma-api.integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gamma-api.integration.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/integration/gamma-api.integration.test.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/__tests__/integration/gamma-api.integration.test.js

@@ -0,0 +1,170 @@
+/**
+ * Gamma API Client Integration Tests
+ *
+ * These tests make REAL API calls to Polymarket.
+ *
+ * Run with: pnpm test:integration
+ */
+import { describe, it, expect, beforeAll } from 'vitest';
+import { GammaApiClient } from '../../clients/gamma-api.js';
+import { RateLimiter } from '../../core/rate-limiter.js';
+import { createUnifiedCache } from '../../core/unified-cache.js';
+describe('GammaApiClient Integration', () => {
+    let client;
+    beforeAll(() => {
+        client = new GammaApiClient(new RateLimiter(), createUnifiedCache());
+    });
+    describe('getMarkets', () => {
+        it('should fetch active markets sorted by volume', async () => {
+            const markets = await client.getMarkets({
+                active: true,
+                closed: false,
+                order: 'volume24hr',
+                ascending: false,
+                limit: 10,
+            });
+            expect(Array.isArray(markets)).toBe(true);
+            expect(markets.length).toBeGreaterThan(0);
+            expect(markets.length).toBeLessThanOrEqual(10);
+            // Verify each market structure
+            for (const market of markets) {
+                expect(typeof market.id).toBe('string');
+                expect(typeof market.conditionId).toBe('string');
+                expect(typeof market.question).toBe('string');
+                expect(market.question.length).toBeGreaterThan(0);
+                expect(Array.isArray(market.outcomes)).toBe(true);
+                expect(Array.isArray(market.outcomePrices)).toBe(true);
+                expect(typeof market.volume).toBe('number');
+                expect(typeof market.active).toBe('boolean');
+                expect(market.active).toBe(true); // We filtered for active
+            }
+            // Verify volume24hr is sorted descending
+            for (let i = 1; i < markets.length; i++) {
+                const prev = markets[i - 1].volume24hr ?? 0;
+                const curr = markets[i].volume24hr ?? 0;
+                expect(prev).toBeGreaterThanOrEqual(curr);
+            }
+            console.log(`✓ Fetched ${markets.length} active markets sorted by 24h volume`);
+            console.log(`  Top market: "${markets[0].question.slice(0, 50)}..."`);
+            console.log(`  24h volume: $${markets[0].volume24hr?.toLocaleString()}`);
+        }, 30000);
+        it('should return correct outcome prices', async () => {
+            const markets = await client.getMarkets({
+                active: true,
+                limit: 5,
+            });
+            for (const market of markets) {
+                // Outcome prices should be between 0 and 1
+                for (const price of market.outcomePrices) {
+                    expect(price).toBeGreaterThanOrEqual(0);
+                    expect(price).toBeLessThanOrEqual(1);
+                }
+                // For binary markets, prices should roughly sum to 1
+                // But some markets might have no liquidity (0 prices)
+                if (market.outcomes.length === 2) {
+                    const sum = market.outcomePrices.reduce((a, b) => a + b, 0);
+                    // Allow for no liquidity (0) or normal spread
+                    if (sum > 0) {
+                        expect(sum).toBeGreaterThan(0.8);
+                        expect(sum).toBeLessThan(1.2);
+                    }
+                }
+            }
+            console.log('✓ Outcome prices validated for all markets');
+        }, 30000);
+        it('should handle pagination correctly', async () => {
+            const page1 = await client.getMarkets({
+                active: true,
+                limit: 5,
+                offset: 0,
+            });
+            const page2 = await client.getMarkets({
+                active: true,
+                limit: 5,
+                offset: 5,
+            });
+            // Pages should have different markets
+            const page1Ids = new Set(page1.map(m => m.id));
+            const page2Ids = new Set(page2.map(m => m.id));
+            for (const id of page2Ids) {
+                expect(page1Ids.has(id)).toBe(false);
+            }
+            console.log(`✓ Pagination works: page1 has ${page1.length} markets, page2 has ${page2.length} markets`);
+        }, 30000);
+    });
+    describe('getTrendingMarkets', () => {
+        it('should return trending markets by 24h volume', async () => {
+            const trending = await client.getTrendingMarkets(10);
+            expect(trending.length).toBeGreaterThan(0);
+            // Should all be active and not closed
+            for (const market of trending) {
+                expect(market.active).toBe(true);
+                expect(market.closed).toBe(false);
+            }
+            // Should be sorted by volume24hr descending
+            for (let i = 1; i < trending.length; i++) {
+                const prev = trending[i - 1].volume24hr ?? 0;
+                const curr = trending[i].volume24hr ?? 0;
+                expect(prev).toBeGreaterThanOrEqual(curr);
+            }
+            console.log(`✓ Top ${trending.length} trending markets retrieved`);
+        }, 30000);
+    });
+    describe('getEvents', () => {
+        it('should fetch events with associated markets', async () => {
+            const events = await client.getEvents({
+                active: true,
+                limit: 5,
+            });
+            expect(Array.isArray(events)).toBe(true);
+            if (events.length > 0) {
+                const event = events[0];
+                expect(typeof event.id).toBe('string');
+                expect(typeof event.title).toBe('string');
+                expect(event.title.length).toBeGreaterThan(0);
+                expect(Array.isArray(event.markets)).toBe(true);
+                console.log(`✓ Fetched ${events.length} events`);
+                console.log(`  First event: "${event.title}"`);
+                console.log(`  Markets in event: ${event.markets.length}`);
+            }
+            else {
+                console.log('✓ No active events found (this is ok)');
+            }
+        }, 30000);
+    });
+    describe('getMarketBySlug', () => {
+        it('should find market by slug', async () => {
+            // First get a market to know its slug
+            const markets = await client.getMarkets({ active: true, limit: 1 });
+            if (markets.length === 0) {
+                console.log('No markets found, skipping test');
+                return;
+            }
+            const slug = markets[0].slug;
+            const market = await client.getMarketBySlug(slug);
+            expect(market).not.toBeNull();
+            expect(market?.slug).toBe(slug);
+            expect(market?.question).toBe(markets[0].question);
+            console.log(`✓ Found market by slug: "${slug}"`);
+        }, 30000);
+        it('should return null for non-existent slug', async () => {
+            const market = await client.getMarketBySlug('this-market-definitely-does-not-exist-12345');
+            expect(market).toBeNull();
+        }, 30000);
+    });
+    describe('getMarketByConditionId', () => {
+        it('should find market by condition ID', async () => {
+            const markets = await client.getMarkets({ active: true, limit: 1 });
+            if (markets.length === 0) {
+                console.log('No markets found, skipping test');
+                return;
+            }
+            const conditionId = markets[0].conditionId;
+            const market = await client.getMarketByConditionId(conditionId);
+            expect(market).not.toBeNull();
+            expect(market?.conditionId).toBe(conditionId);
+            console.log(`✓ Found market by conditionId: "${conditionId.slice(0, 20)}..."`);
+        }, 30000);
+    });
+});
+//# sourceMappingURL=gamma-api.integration.test.js.map