pmxtjs 0.0.1 → 0.1.0

package/test/exchanges/polymarket/TradeHistory.test.ts

@@ -0,0 +1,248 @@
+import axios from 'axios';
+import { PolymarketExchange } from '../../../src/exchanges/Polymarket';
+
+/**
+ * Polymarket getTradeHistory() Test
+ * 
+ * What: Tests fetching raw trade history data from CLOB API.
+ * Why: Trade history is CRITICAL for market analysis and price discovery.
+ * How: Mocks CLOB trades API responses and verifies data transformation.
+ */
+
+jest.mock('axios');
+const mockedAxios = axios as jest.Mocked<typeof axios>;
+
+describe('PolymarketExchange - getTradeHistory', () => {
+    let exchange: PolymarketExchange;
+
+    beforeEach(() => {
+        exchange = new PolymarketExchange();
+        jest.clearAllMocks();
+    });
+
+    it('should fetch and parse trade history', async () => {
+        mockedAxios.get.mockResolvedValue({
+            data: [
+                {
+                    id: 'trade-1',
+                    timestamp: 1704067200,
+                    price: '0.52',
+                    size: '100',
+                    side: 'BUY'
+                },
+                {
+                    id: 'trade-2',
+                    timestamp: 1704067260,
+                    price: '0.53',
+                    size: '250',
+                    side: 'SELL'
+                }
+            ]
+        });
+
+        const trades = await exchange.getTradeHistory('token123456789', { resolution: '1h' });
+
+        expect(trades.length).toBe(2);
+        expect(trades[0].id).toBe('trade-1');
+        expect(trades[0].price).toBe(0.52);
+        expect(trades[0].amount).toBe(100);
+        expect(trades[0].side).toBe('buy');
+    });
+
+    it('should convert timestamps to milliseconds', async () => {
+        mockedAxios.get.mockResolvedValue({
+            data: [{
+                id: 'trade-1',
+                timestamp: 1704067200,
+                price: '0.50',
+                size: '100',
+                side: 'BUY'
+            }]
+        });
+
+        const trades = await exchange.getTradeHistory('token123456789', { resolution: '1h' });
+
+        expect(trades[0].timestamp).toBe(1704067200 * 1000);
+    });
+
+    it('should handle BUY and SELL sides correctly', async () => {
+        mockedAxios.get.mockResolvedValue({
+            data: [
+                { id: 'trade-1', timestamp: 1704067200, price: '0.50', size: '100', side: 'BUY' },
+                { id: 'trade-2', timestamp: 1704067260, price: '0.51', size: '150', side: 'SELL' }
+            ]
+        });
+
+        const trades = await exchange.getTradeHistory('token123456789', { resolution: '1h' });
+
+        expect(trades[0].side).toBe('buy');
+        expect(trades[1].side).toBe('sell');
+    });
+
+    it('should handle unknown side values', async () => {
+        mockedAxios.get.mockResolvedValue({
+            data: [{
+                id: 'trade-1',
+                timestamp: 1704067200,
+                price: '0.50',
+                size: '100',
+                side: 'UNKNOWN'
+            }]
+        });
+
+        const trades = await exchange.getTradeHistory('token123456789', { resolution: '1h' });
+
+        expect(trades[0].side).toBe('unknown');
+    });
+
+    it('should handle missing trade ID with fallback', async () => {
+        mockedAxios.get.mockResolvedValue({
+            data: [{
+                timestamp: 1704067200,
+                price: '0.50',
+                size: '100',
+                side: 'BUY'
+                // Missing id
+            }]
+        });
+
+        const trades = await exchange.getTradeHistory('token123456789', { resolution: '1h' });
+
+        expect(trades[0].id).toBe('1704067200-0.50');
+    });
+
+    it('should handle alternative amount field names', async () => {
+        mockedAxios.get.mockResolvedValue({
+            data: [{
+                id: 'trade-1',
+                timestamp: 1704067200,
+                price: '0.50',
+                amount: '200',  // Alternative field
+                side: 'BUY'
+            }]
+        });
+
+        const trades = await exchange.getTradeHistory('token123456789', { resolution: '1h' });
+
+        expect(trades[0].amount).toBe(200);
+    });
+
+    it('should respect limit parameter', async () => {
+        const mockTrades = Array.from({ length: 100 }, (_, i) => ({
+            id: `trade-${i}`,
+            timestamp: 1704067200 + i,
+            price: '0.50',
+            size: '100',
+            side: 'BUY'
+        }));
+
+        mockedAxios.get.mockResolvedValue({ data: mockTrades });
+
+        const trades = await exchange.getTradeHistory('token123456789', {
+            resolution: '1h',
+            limit: 20
+        });
+
+        expect(trades.length).toBe(20);
+    });
+
+    it('should include start timestamp in query params', async () => {
+        mockedAxios.get.mockResolvedValue({ data: [] });
+
+        const start = new Date('2025-01-01T00:00:00Z');
+        await exchange.getTradeHistory('token123456789', {
+            resolution: '1h',
+            start
+        });
+
+        expect(mockedAxios.get).toHaveBeenCalledWith(
+            expect.any(String),
+            expect.objectContaining({
+                params: expect.objectContaining({
+                    after: Math.floor(start.getTime() / 1000)
+                })
+            })
+        );
+    });
+
+    it('should include end timestamp in query params', async () => {
+        mockedAxios.get.mockResolvedValue({ data: [] });
+
+        const end = new Date('2025-01-31T00:00:00Z');
+        await exchange.getTradeHistory('token123456789', {
+            resolution: '1h',
+            end
+        });
+
+        expect(mockedAxios.get).toHaveBeenCalledWith(
+            expect.any(String),
+            expect.objectContaining({
+                params: expect.objectContaining({
+                    before: Math.floor(end.getTime() / 1000)
+                })
+            })
+        );
+    });
+
+    it('should handle empty trades array', async () => {
+        mockedAxios.get.mockResolvedValue({ data: [] });
+
+        const trades = await exchange.getTradeHistory('token123456789', { resolution: '1h' });
+
+        expect(trades).toEqual([]);
+    });
+
+    it('should throw error for invalid token ID format', async () => {
+        await expect(exchange.getTradeHistory('123', { resolution: '1h' }))
+            .rejects
+            .toThrow(/Invalid ID/i);
+    });
+
+    it('should handle API errors with detailed messages', async () => {
+        const error = {
+            response: {
+                status: 401,
+                data: { error: 'Authentication required' }
+            },
+            isAxiosError: true
+        };
+        mockedAxios.get.mockRejectedValue(error);
+        // @ts-expect-error - Mock type mismatch is expected in tests
+        mockedAxios.isAxiosError = jest.fn().mockReturnValue(true);
+
+        await expect(exchange.getTradeHistory('token123456789', { resolution: '1h' }))
+            .rejects
+            .toThrow(/Trades API Error/i);
+    });
+
+    it('should handle unexpected errors', async () => {
+        mockedAxios.get.mockRejectedValue(new Error('Network failure'));
+        const consoleSpy = jest.spyOn(console, 'error').mockImplementation(() => { });
+
+        await expect(exchange.getTradeHistory('token123456789', { resolution: '1h' }))
+            .rejects
+            .toThrow('Network failure');
+
+        expect(consoleSpy).toHaveBeenCalled();
+        consoleSpy.mockRestore();
+    });
+
+    it('should return most recent trades when limit is applied', async () => {
+        const mockTrades = [
+            { id: 'trade-1', timestamp: 1704067200, price: '0.50', size: '100', side: 'BUY' },
+            { id: 'trade-2', timestamp: 1704067260, price: '0.51', size: '100', side: 'BUY' },
+            { id: 'trade-3', timestamp: 1704067320, price: '0.52', size: '100', side: 'BUY' }
+        ];
+
+        mockedAxios.get.mockResolvedValue({ data: mockTrades });
+
+        const trades = await exchange.getTradeHistory('token123456789', {
+            resolution: '1h',
+            limit: 2
+        });
+
+        expect(trades.length).toBe(2);
+        expect(trades[0].id).toBe('trade-2');  // Most recent 2
+        expect(trades[1].id).toBe('trade-3');
+    });
+});

package/tsconfig.json

@@ -0,0 +1,12 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "commonjs",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "outDir": "./dist"
+  },
+  "include": ["src/**/*"]
+}

package/Cargo.toml

@@ -1,15 +0,0 @@
-[package]
-name = "pmxt-node"
-version = "0.0.1"
-edition = "2021"
-
-[lib]
-crate-type = ["cdylib"]
-
-[dependencies]
-napi = { version = "2.12", features = ["async"] }
-napi-derive = "2.12"
-pmxt-core = { path = "../../crates/core" }
-
-[build-dependencies]
-napi-build = "2.0"

package/README.md

@@ -1,47 +0,0 @@
-# PMXT: The ccxt for Prediction Markets
-
-PMXT is a unified endpoint for trading on prediction markets (Polymarket, Kalshi, etc.), written in Rust for performance with native bindings for Python and Node.js.
-
-## Architecture
-
-This project is organized as a Cargo Workspace:
-
-- **`crates/core`**: Defines the shared `Exchange` trait and data models (`Market`, `Order`, `Ticker`).
-- **`crates/polymarket`**: The implementation for Polymarket.
-- **`bindings/python`**: The native Python extension (using PyO3).
-
-## Development
-
-### Prerequisites
-
-- Rust (cargo)
-- Python 3.9+
-- `maturin` (for building Python bindings) -> `pip install maturin`
-
-### Building Python Bindings
-
-To build and install the python library into your current environment:
-
-```bash
-cd bindings/python
-maturin develop
-```
-
-### Usage (Python)
-
-```python
-import pmxt
-import asyncio
-
-async def main():
-    exchange = pmxt.Polymarket(api_key="your_key")
-    markets = await exchange.load_markets()
-    print(markets)
-
-asyncio.run(main())
-```
-
-## Contributing
-
-1. Implement `Exchange` trait for a new market in `crates/new_market`.
-2. Register it in `bindings/python/src/lib.rs`.

package/src/lib.rs

@@ -1,6 +0,0 @@
-use napi_derive::napi;
-
-#[napi]
-pub fn info() -> String {
-    "PMXT Node.js Bindings".to_string()
-}