@catalyst-team/poly-sdk 0.4.3 → 0.4.5

package/dist/src/services/order-manager.test.js

@@ -0,0 +1,477 @@
+/**
+ * OrderManager Unit Tests
+ *
+ * Focus: Fill event generation in polling mode
+ * Issue #7: Polling mode doesn't emit fill events, only status changes
+ */
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { OrderManager } from './order-manager.js';
+import { OrderStatus } from '../core/types.js';
+import { MockRateLimiter, MockCache, waitFor } from '../__tests__/test-utils.js';
+// ============================================================================
+// Mock Dependencies
+// ============================================================================
+class MockTradingService {
+    orders = new Map();
+    async initialize() { }
+    async getOrder(orderId) {
+        return this.orders.get(orderId) || null;
+    }
+    // Test helper: update order state
+    updateOrder(orderId, updates) {
+        const existing = this.orders.get(orderId);
+        if (existing) {
+            this.orders.set(orderId, { ...existing, ...updates });
+        }
+        else {
+            this.orders.set(orderId, {
+                id: orderId,
+                status: OrderStatus.OPEN,
+                tokenId: 'token123',
+                side: 'BUY',
+                price: 0.52,
+                originalSize: 100,
+                filledSize: 0,
+                remainingSize: 100,
+                associateTrades: [],
+                createdAt: Date.now(),
+                ...updates,
+            });
+        }
+    }
+    getCredentials() {
+        return null;
+    }
+}
+// ============================================================================
+// Test Fixtures
+// ============================================================================
+const createTestOrder = (overrides) => ({
+    id: 'test-order-1',
+    status: OrderStatus.OPEN,
+    tokenId: 'token123',
+    side: 'BUY',
+    price: 0.52,
+    originalSize: 100,
+    filledSize: 0,
+    remainingSize: 100,
+    associateTrades: [],
+    createdAt: Date.now(),
+    ...overrides,
+});
+// ============================================================================
+// Tests
+// ============================================================================
+describe('OrderManager - Polling Fill Detection', () => {
+    let orderManager;
+    let mockTradingService;
+    let rateLimiter;
+    let cache;
+    beforeEach(async () => {
+        rateLimiter = new MockRateLimiter();
+        cache = new MockCache();
+        mockTradingService = new MockTradingService();
+        orderManager = new OrderManager({
+            privateKey: '0x0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef',
+            rateLimiter: rateLimiter,
+            cache: cache,
+            mode: 'polling',
+            pollingInterval: 100, // Fast polling for tests
+        });
+        // Inject mock trading service
+        orderManager.tradingService = mockTradingService;
+        await orderManager.start();
+    });
+    afterEach(() => {
+        orderManager.stop();
+    });
+    describe('Fill Detection', () => {
+        it('should emit order_partially_filled when filledSize increases', async () => {
+            const orderId = 'order-1';
+            const initialOrder = createTestOrder({
+                id: orderId,
+                filledSize: 0,
+                remainingSize: 100,
+            });
+            // Set initial state
+            mockTradingService.updateOrder(orderId, initialOrder);
+            // Start watching
+            orderManager.watchOrder(orderId);
+            // Setup event listener
+            const fillEvents = [];
+            orderManager.on('order_partially_filled', (event) => {
+                fillEvents.push(event);
+            });
+            // Wait for initial poll
+            await waitFor(150);
+            // Simulate partial fill (50 shares filled)
+            mockTradingService.updateOrder(orderId, {
+                filledSize: 50,
+                remainingSize: 50,
+                status: OrderStatus.PARTIALLY_FILLED,
+                associateTrades: ['trade-1'],
+            });
+            // Wait for next poll
+            await waitFor(150);
+            // Verify fill event emitted
+            expect(fillEvents).toHaveLength(1);
+            expect(fillEvents[0]).toMatchObject({
+                orderId,
+                fill: {
+                    size: 50, // Delta from 0 to 50
+                    price: 0.52, // Order price
+                },
+                cumulativeFilled: 50,
+                remainingSize: 50,
+                isCompleteFill: false,
+            });
+        });
+        it('should emit order_filled when order completely filled', async () => {
+            const orderId = 'order-2';
+            // Set initial state with partial fill
+            mockTradingService.updateOrder(orderId, {
+                id: orderId,
+                filledSize: 50,
+                remainingSize: 50,
+                status: OrderStatus.PARTIALLY_FILLED,
+                associateTrades: ['trade-1'],
+            });
+            // Start watching (this will poll and set initial state)
+            orderManager.watchOrder(orderId);
+            // Setup event listener AFTER first poll
+            await waitFor(150);
+            const fillEvents = [];
+            orderManager.on('order_filled', (event) => {
+                fillEvents.push(event);
+            });
+            // Simulate complete fill
+            mockTradingService.updateOrder(orderId, {
+                filledSize: 100,
+                remainingSize: 0,
+                status: OrderStatus.FILLED,
+                associateTrades: ['trade-1', 'trade-2'],
+            });
+            // Wait for next poll
+            await waitFor(150);
+            // Verify fill event emitted
+            expect(fillEvents).toHaveLength(1);
+            expect(fillEvents[0]).toMatchObject({
+                orderId,
+                fill: {
+                    size: 50, // Delta from 50 to 100
+                    price: 0.52,
+                },
+                cumulativeFilled: 100,
+                remainingSize: 0,
+                isCompleteFill: true,
+            });
+        });
+        it('should emit multiple partial fill events correctly', async () => {
+            const orderId = 'order-3';
+            // Set initial state
+            mockTradingService.updateOrder(orderId, {
+                id: orderId,
+                filledSize: 0,
+                remainingSize: 100,
+            });
+            // Start watching and wait for initial state
+            orderManager.watchOrder(orderId);
+            await waitFor(150);
+            // Setup event listener AFTER initial poll
+            const partialFillEvents = [];
+            const completeFillEvents = [];
+            orderManager.on('order_partially_filled', (event) => {
+                partialFillEvents.push(event);
+            });
+            orderManager.on('order_filled', (event) => {
+                completeFillEvents.push(event);
+            });
+            // First fill: 30 shares
+            mockTradingService.updateOrder(orderId, {
+                filledSize: 30,
+                remainingSize: 70,
+                status: OrderStatus.PARTIALLY_FILLED,
+                associateTrades: ['trade-1'],
+            });
+            await waitFor(150);
+            // Second fill: 40 more shares (total 70)
+            mockTradingService.updateOrder(orderId, {
+                filledSize: 70,
+                remainingSize: 30,
+                status: OrderStatus.PARTIALLY_FILLED,
+                associateTrades: ['trade-1', 'trade-2'],
+            });
+            await waitFor(150);
+            // Final fill: 30 more shares (total 100, complete)
+            mockTradingService.updateOrder(orderId, {
+                filledSize: 100,
+                remainingSize: 0,
+                status: OrderStatus.FILLED,
+                associateTrades: ['trade-1', 'trade-2', 'trade-3'],
+            });
+            await waitFor(150);
+            // Verify partial fills
+            expect(partialFillEvents).toHaveLength(2);
+            expect(partialFillEvents[0].fill.size).toBe(30);
+            expect(partialFillEvents[1].fill.size).toBe(40);
+            // Verify complete fill
+            expect(completeFillEvents).toHaveLength(1);
+            expect(completeFillEvents[0].fill.size).toBe(30);
+            expect(completeFillEvents[0].isCompleteFill).toBe(true);
+        });
+        it('should not emit duplicate fill events', async () => {
+            const orderId = 'order-4';
+            // Set initial state
+            mockTradingService.updateOrder(orderId, {
+                id: orderId,
+                filledSize: 0,
+                remainingSize: 100,
+            });
+            // Start watching
+            orderManager.watchOrder(orderId);
+            // Setup event listener
+            const fillEvents = [];
+            orderManager.on('order_partially_filled', (event) => {
+                fillEvents.push(event);
+            });
+            // Wait for initial poll
+            await waitFor(150);
+            // Simulate fill
+            mockTradingService.updateOrder(orderId, {
+                filledSize: 50,
+                remainingSize: 50,
+                status: OrderStatus.PARTIALLY_FILLED,
+            });
+            // Wait for multiple polls
+            await waitFor(150);
+            await waitFor(150);
+            await waitFor(150);
+            // Should only emit once (deduplication works)
+            expect(fillEvents).toHaveLength(1);
+        });
+        it('should include correct fill details', async () => {
+            const orderId = 'order-5';
+            // Set initial state
+            mockTradingService.updateOrder(orderId, {
+                id: orderId,
+                price: 0.65,
+                originalSize: 200,
+                filledSize: 0,
+                remainingSize: 200,
+                associateTrades: [],
+            });
+            // Start watching
+            orderManager.watchOrder(orderId);
+            // Setup event listener
+            let capturedEvent = null;
+            orderManager.on('order_partially_filled', (event) => {
+                capturedEvent = event;
+            });
+            // Wait for initial poll
+            await waitFor(150);
+            // Simulate fill
+            mockTradingService.updateOrder(orderId, {
+                filledSize: 100,
+                remainingSize: 100,
+                status: OrderStatus.PARTIALLY_FILLED,
+                associateTrades: ['trade-abc'],
+            });
+            // Wait for poll
+            await waitFor(150);
+            // Verify fill details
+            expect(capturedEvent).not.toBeNull();
+            expect(capturedEvent).toMatchObject({
+                orderId,
+                fill: {
+                    tradeId: 'trade-abc',
+                    size: 100,
+                    price: 0.65,
+                    fee: 0, // Polling doesn't have fee info
+                },
+                cumulativeFilled: 100,
+                remainingSize: 100,
+                isCompleteFill: false,
+            });
+            // Verify order reference
+            expect(capturedEvent.order.id).toBe(orderId);
+            expect(capturedEvent.order.filledSize).toBe(100);
+        });
+    });
+    describe('Status Change Events', () => {
+        it('should emit both fill event and status change event', async () => {
+            const orderId = 'order-6';
+            // Set initial state
+            mockTradingService.updateOrder(orderId, {
+                id: orderId,
+                filledSize: 0,
+                remainingSize: 100,
+                status: OrderStatus.OPEN,
+            });
+            // Start watching and wait for initial state
+            orderManager.watchOrder(orderId);
+            await waitFor(150);
+            // Setup event listeners AFTER initial poll
+            const fillEvents = [];
+            const statusChanges = [];
+            orderManager.on('order_partially_filled', (event) => {
+                fillEvents.push(event);
+            });
+            orderManager.on('status_change', (event) => {
+                statusChanges.push(event);
+            });
+            // Simulate fill with status change
+            mockTradingService.updateOrder(orderId, {
+                filledSize: 50,
+                remainingSize: 50,
+                status: OrderStatus.PARTIALLY_FILLED,
+            });
+            // Wait for poll
+            await waitFor(150);
+            // Both events should be emitted
+            expect(fillEvents).toHaveLength(1);
+            expect(statusChanges).toHaveLength(1);
+            expect(statusChanges[0].to).toBe(OrderStatus.PARTIALLY_FILLED);
+        });
+    });
+    describe('Edge Cases', () => {
+        it('should handle filledSize staying the same (no fill)', async () => {
+            const orderId = 'order-7';
+            // Set initial state with existing fill
+            mockTradingService.updateOrder(orderId, {
+                id: orderId,
+                filledSize: 50,
+                remainingSize: 50,
+                status: OrderStatus.PARTIALLY_FILLED,
+            });
+            // Start watching and wait for initial state
+            orderManager.watchOrder(orderId);
+            await waitFor(150);
+            // Setup event listener AFTER initial poll
+            const fillEvents = [];
+            orderManager.on('order_partially_filled', (event) => {
+                fillEvents.push(event);
+            });
+            // Wait for multiple polls (no fill change)
+            await waitFor(150);
+            await waitFor(150);
+            // No fill events should be emitted
+            expect(fillEvents).toHaveLength(0);
+        });
+        it('should handle order with no associateTrades', async () => {
+            const orderId = 'order-8';
+            // Set initial state
+            mockTradingService.updateOrder(orderId, {
+                id: orderId,
+                filledSize: 0,
+                remainingSize: 100,
+                associateTrades: [],
+            });
+            // Start watching
+            orderManager.watchOrder(orderId);
+            // Setup event listener
+            let capturedEvent = null;
+            orderManager.on('order_partially_filled', (event) => {
+                capturedEvent = event;
+            });
+            // Wait for initial poll
+            await waitFor(150);
+            // Simulate fill with no trade ID
+            mockTradingService.updateOrder(orderId, {
+                filledSize: 50,
+                remainingSize: 50,
+                status: OrderStatus.PARTIALLY_FILLED,
+                associateTrades: [], // Empty array
+            });
+            // Wait for poll
+            await waitFor(150);
+            // Should generate synthetic tradeId
+            expect(capturedEvent).not.toBeNull();
+            expect(capturedEvent.fill.tradeId).toMatch(/^polling_\d+$/);
+        });
+        it('should handle order going directly from OPEN to FILLED', async () => {
+            const orderId = 'order-9';
+            // Set initial state
+            mockTradingService.updateOrder(orderId, {
+                id: orderId,
+                filledSize: 0,
+                remainingSize: 100,
+                status: OrderStatus.OPEN,
+            });
+            // Start watching and wait for initial state
+            orderManager.watchOrder(orderId);
+            await waitFor(150);
+            // Setup event listeners AFTER initial poll
+            const partialFillEvents = [];
+            const completeFillEvents = [];
+            orderManager.on('order_partially_filled', (event) => {
+                partialFillEvents.push(event);
+            });
+            orderManager.on('order_filled', (event) => {
+                completeFillEvents.push(event);
+            });
+            // Simulate instant complete fill (market order scenario)
+            mockTradingService.updateOrder(orderId, {
+                filledSize: 100,
+                remainingSize: 0,
+                status: OrderStatus.FILLED,
+                associateTrades: ['trade-1'],
+            });
+            // Wait for poll
+            await waitFor(150);
+            // Should emit complete fill only
+            expect(partialFillEvents).toHaveLength(0);
+            expect(completeFillEvents).toHaveLength(1);
+            expect(completeFillEvents[0].fill.size).toBe(100);
+        });
+    });
+});
+describe('OrderManager - WebSocket + Polling Deduplication', () => {
+    let orderManager;
+    let mockTradingService;
+    beforeEach(async () => {
+        mockTradingService = new MockTradingService();
+        orderManager = new OrderManager({
+            privateKey: '0x0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef',
+            rateLimiter: new MockRateLimiter(),
+            cache: new MockCache(),
+            mode: 'hybrid', // Both WebSocket and Polling
+            pollingInterval: 100,
+        });
+        // Inject mock trading service
+        orderManager.tradingService = mockTradingService;
+        await orderManager.start();
+    });
+    afterEach(() => {
+        orderManager.stop();
+    });
+    it('should not emit duplicate fills when both WebSocket and Polling detect same fill', async () => {
+        const orderId = 'order-10';
+        // Set initial state
+        mockTradingService.updateOrder(orderId, {
+            id: orderId,
+            filledSize: 0,
+            remainingSize: 100,
+        });
+        // Start watching
+        orderManager.watchOrder(orderId);
+        // Setup event listener
+        const fillEvents = [];
+        orderManager.on('order_partially_filled', (event) => {
+            fillEvents.push(event);
+        });
+        // Wait for initial poll
+        await waitFor(150);
+        // Update order state
+        mockTradingService.updateOrder(orderId, {
+            filledSize: 50,
+            remainingSize: 50,
+            status: OrderStatus.PARTIALLY_FILLED,
+        });
+        // Wait for multiple polls
+        await waitFor(150);
+        await waitFor(150);
+        // Deduplication should prevent multiple emissions
+        expect(fillEvents).toHaveLength(1);
+    });
+});
+//# sourceMappingURL=order-manager.test.js.map

package/dist/src/services/order-manager.test.js.map

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

package/dist/src/services/trading-service.d.ts

@@ -21,6 +21,7 @@ import { Wallet } from 'ethers';
 import { RateLimiter } from '../core/rate-limiter.js';
 import type { UnifiedCache } from '../core/unified-cache.js';
 import type { Side } from '../core/types.js';
+import { OrderStatus } from '../core/types.js';
 export declare const POLYGON_MAINNET = 137;
 export declare const POLYGON_AMOY = 80002;
 /** Minimum order value in USDC (price * size >= MIN_ORDER_VALUE) */
@@ -56,9 +57,20 @@ export interface MarketOrderParams {
     price?: number;
     orderType?: 'FOK' | 'FAK';
 }
+/**
+ * Order representation with detailed status tracking
+ *
+ * Status Flow:
+ * pending → open → partially_filled → filled
+ *              ↓         ↓               (or)
+ *          cancelled  cancelled       expired
+ *
+ * @see OrderStatus enum for detailed state documentation
+ */
 export interface Order {
     id: string;
-    status: string;
+    /** Current order status - see OrderStatus enum for state machine */
+    status: OrderStatus;
     tokenId: string;
     side: Side;
     price: number;
@@ -67,6 +79,16 @@ export interface Order {
     remainingSize: number;
     associateTrades: string[];
     createdAt: number;
+    /**
+     * Last update timestamp
+     * Updated on: status change, new fill, cancellation
+     */
+    updatedAt?: number;
+    /**
+     * Expiration timestamp (for GTD orders)
+     * undefined for GTC orders
+     */
+    expiration?: number;
 }
 export interface OrderResult {
     success: boolean;
@@ -159,10 +181,76 @@ export declare class TradingService {
      * Market orders below this limit will be rejected by the API.
      */
     createMarketOrder(params: MarketOrderParams): Promise<OrderResult>;
+    /**
+     * Create and post multiple limit orders in a batch
+     *
+     * Note: Polymarket enforces:
+     * - Maximum 15 orders per batch
+     * - Same minimum requirements as single orders (5 shares, $1 value)
+     *
+     * This method uses Polymarket's batch API (POST /orders) which submits
+     * all orders in a single HTTP request, significantly faster than individual calls.
+     *
+     * @param orders - Array of limit order parameters (max 15)
+     * @returns Batch result with individual order IDs or errors
+     */
+    createBatchOrders(orders: LimitOrderParams[]): Promise<OrderResult>;
+    /**
+     * Get a single order by ID
+     *
+     * @param orderId - Order ID (hash)
+     * @returns Order details or null if not found
+     */
+    getOrder(orderId: string): Promise<Order | null>;
     cancelOrder(orderId: string): Promise<OrderResult>;
     cancelOrders(orderIds: string[]): Promise<OrderResult>;
     cancelAllOrders(): Promise<OrderResult>;
+    /**
+     * Cancel orders by market or asset
+     *
+     * @param marketId - Market condition ID (optional)
+     * @param assetId - Token ID (optional)
+     * @returns Cancel result with canceled order IDs
+     */
+    cancelMarketOrders(marketId?: string, assetId?: string): Promise<OrderResult>;
     getOpenOrders(marketId?: string): Promise<Order[]>;
+    /**
+     * Check if an order can be cancelled
+     *
+     * Orders can be cancelled if they are in OPEN or PARTIALLY_FILLED status.
+     * Orders in terminal states (FILLED, CANCELLED, EXPIRED, REJECTED) or
+     * PENDING state cannot be cancelled via API.
+     *
+     * @param orderId - Order ID to check
+     * @returns Promise<boolean> - true if order can be cancelled
+     *
+     * @example
+     * ```typescript
+     * const canCancel = await sdk.trading.canCancelOrder(orderId);
+     * if (canCancel) {
+     *   await sdk.trading.cancelOrder(orderId);
+     * }
+     * ```
+     */
+    canCancelOrder(orderId: string): Promise<boolean>;
+    /**
+     * Get order fill progress as percentage
+     *
+     * Returns the percentage of the order that has been filled (0-100).
+     * Useful for tracking partial fills and displaying progress.
+     *
+     * @param orderId - Order ID to check
+     * @returns Promise<number | null> - Fill percentage (0-100) or null if order not found
+     *
+     * @example
+     * ```typescript
+     * const progress = await sdk.trading.getOrderProgress(orderId);
+     * if (progress !== null) {
+     *   console.log(`Order ${progress.toFixed(1)}% filled`);
+     * }
+     * ```
+     */
+    getOrderProgress(orderId: string): Promise<number | null>;
     getTrades(marketId?: string): Promise<TradeInfo[]>;
     isOrderScoring(orderId: string): Promise<boolean>;
     areOrdersScoring(orderIds: string[]): Promise<Record<string, boolean>>;

package/dist/src/services/trading-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"trading-service.d.ts","sourceRoot":"","sources":["../../../src/services/trading-service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"trading-service.d.ts","sourceRoot":"","sources":["../../../src/services/trading-service.ts"],"names":[],"mappings":"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"}