@3rd-eye-labs/openmm 0.0.1 → 0.1.0

package/dist/exchanges/gateio/gateio-auth.js

@@ -0,0 +1,205 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GateioAuth = void 0;
+const crypto_1 = __importDefault(require("crypto"));
+const utils_1 = require("../../utils");
+/**
+ * Gate.io Authentication and Request Handler
+ *
+ * Handles API authentication, request signing, and HTTP requests to Gate.io API.
+ * Implements Gate.io's HMAC-SHA512 signature generation with hex encoding.
+ *
+ * @see https://www.gate.io/docs/developers/apiv4/en/
+ */
+class GateioAuth {
+    /**
+     * Initialize Gate.io authentication handler
+     *
+     * @param credentials - Gate.io API credentials including API key and secret
+     * @param baseUrl - Base URL for Gate.io API (defaults to production)
+     */
+    constructor(credentials, baseUrl = 'https://api.gateio.ws') {
+        this.logger = (0, utils_1.createLogger)('gateio-auth');
+        this.credentials = credentials;
+        this.baseUrl = baseUrl;
+        this.validateCredentials();
+    }
+    /**
+     * Generate HMAC-SHA512 signature for Gate.io API requests
+     *
+     * Signature format: HMAC-SHA512 of (method + "\n" + "/api/v4" + url_path + "\n" + query_string + "\n" + payload_hash + "\n" + timestamp)
+     * - url_path MUST include "/api/v4" prefix
+     * - payload_hash: SHA512 hash of request body (empty string if no body) - hex encoded
+     * - timestamp: Unix timestamp in SECONDS (not milliseconds)
+     */
+    generateSignature(timestamp, method, requestPath, queryString = '', body = '') {
+        const fullPath = requestPath.startsWith('/api/v4') ? requestPath : `/api/v4${requestPath}`;
+        const payloadHash = crypto_1.default.createHash('sha512').update(body).digest('hex');
+        const signatureString = `${method.toUpperCase()}\n${fullPath}\n${queryString}\n${payloadHash}\n${timestamp}`;
+        try {
+            const hmac = crypto_1.default.createHmac('sha512', this.credentials.secret);
+            hmac.update(signatureString);
+            return hmac.digest('hex');
+        }
+        catch (error) {
+            this.logger.error('Failed to generate signature', { error });
+            throw new Error(`Failed to generate Gate.io API signature: ${error}`);
+        }
+    }
+    /**
+     * Generate signature for Gate.io WebSocket authentication
+     * WebSocket signature format: channel=<channel>&event=<event>&time=<timestamp>
+     *
+     * @param channel - WebSocket channel name (e.g., 'spot.orders')
+     * @param event - Event type (e.g., 'subscribe')
+     * @param timestamp - Unix timestamp in seconds
+     * @returns HMAC-SHA512 hex signature
+     */
+    generateWebSocketSignature(channel, event, timestamp) {
+        const signString = `channel=${channel}&event=${event}&time=${timestamp}`;
+        try {
+            const hmac = crypto_1.default.createHmac('sha512', this.credentials.secret);
+            hmac.update(signString);
+            return hmac.digest('hex');
+        }
+        catch (error) {
+            this.logger.error('Failed to generate WebSocket signature', { error });
+            throw new Error(`Failed to generate Gate.io WebSocket signature: ${error}`);
+        }
+    }
+    /**
+     * Get required headers for authenticated Gate.io API requests
+     */
+    getHeaders(method, requestPath, queryString = '', body = '', timestamp) {
+        const requestTimestamp = timestamp || Math.floor(Date.now() / 1000);
+        const signature = this.generateSignature(requestTimestamp, method, requestPath, queryString, body);
+        return {
+            'Content-Type': 'application/json',
+            KEY: this.credentials.apiKey,
+            SIGN: signature,
+            Timestamp: requestTimestamp.toString(),
+        };
+    }
+    /**
+     * Get headers for public API endpoints
+     */
+    getPublicHeaders() {
+        return {
+            'Content-Type': 'application/json',
+        };
+    }
+    /**
+     * Make authenticated request to Gate.io API
+     */
+    async makeRequest(endpoint, params = {}, method = 'GET', body) {
+        const timestamp = Math.floor(Date.now() / 1000);
+        const queryString = Object.entries(params)
+            .filter(([, value]) => value !== undefined && value !== null && value !== '')
+            .map(([key, value]) => `${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`)
+            .join('&');
+        const requestBody = body ? JSON.stringify(body) : '';
+        const headers = this.getHeaders(method, endpoint, queryString, requestBody, timestamp);
+        const url = queryString
+            ? `${this.baseUrl}/api/v4${endpoint}?${queryString}`
+            : `${this.baseUrl}/api/v4${endpoint}`;
+        try {
+            const response = await fetch(url, {
+                method,
+                headers,
+                body: method !== 'GET' ? requestBody || undefined : undefined,
+            });
+            return await this.handleResponse(response, endpoint);
+        }
+        catch (error) {
+            this.logger.error('Request failed', { endpoint, method, error });
+            throw new Error(`Gate.io API request failed: ${error}`);
+        }
+    }
+    /**
+     * Make public request to Gate.io API
+     */
+    async makePublicRequest(endpoint, params = {}) {
+        const queryString = Object.entries(params)
+            .filter(([, value]) => value !== undefined && value !== null && value !== '')
+            .map(([key, value]) => `${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`)
+            .join('&');
+        const url = queryString
+            ? `${this.baseUrl}/api/v4${endpoint}?${queryString}`
+            : `${this.baseUrl}/api/v4${endpoint}`;
+        try {
+            const response = await fetch(url, {
+                headers: this.getPublicHeaders(),
+            });
+            return await this.handleResponse(response, endpoint);
+        }
+        catch (error) {
+            this.logger.error('Public request failed', { endpoint, error });
+            throw new Error(`Gate.io public API request failed: ${error}`);
+        }
+    }
+    /**
+     * Handle API response and extract meaningful error messages
+     */
+    async handleResponse(response, endpoint) {
+        const responseText = await response.text();
+        if (!response.ok) {
+            let errorMessage = `HTTP ${response.status}: ${response.statusText}`;
+            try {
+                const errorData = JSON.parse(responseText);
+                if (errorData.message) {
+                    errorMessage = `Gate.io API Error: ${errorData.message} (Label: ${errorData.label || 'Unknown'})`;
+                }
+            }
+            catch {
+                errorMessage = `HTTP ${response.status}: ${responseText.substring(0, 200)}`;
+            }
+            this.logger.error('Gate.io API request failed', {
+                endpoint,
+                status: response.status,
+                statusText: response.statusText,
+                error: errorMessage,
+            });
+            throw new Error(errorMessage);
+        }
+        try {
+            return JSON.parse(responseText);
+        }
+        catch (error) {
+            this.logger.error('Failed to parse response JSON', {
+                endpoint,
+                responseText: responseText.substring(0, 200),
+            });
+            throw new Error(`Invalid JSON response from Gate.io API: ${error}`);
+        }
+    }
+    /**
+     * Validate that all required credentials are provided
+     */
+    validateCredentials() {
+        const missing = [];
+        if (!this.credentials.apiKey)
+            missing.push('apiKey');
+        if (!this.credentials.secret)
+            missing.push('secret');
+        if (missing.length > 0) {
+            throw new Error(`Missing required Gate.io credentials: ${missing.join(', ')}`);
+        }
+    }
+    /**
+     * Check if credentials are properly configured
+     */
+    validateCredentialsExist() {
+        try {
+            this.validateCredentials();
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+exports.GateioAuth = GateioAuth;
+//# sourceMappingURL=gateio-auth.js.map

package/dist/exchanges/gateio/gateio-auth.js.map

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

package/dist/exchanges/gateio/gateio-connector.d.ts

@@ -0,0 +1,182 @@
+import { BaseExchangeConnector } from '../../core/exchange/base-exchange-connector';
+import { Order, OrderBook, Ticker, Trade, OrderType, OrderSide, Balance, ExchangeCredentials, WebSocketStatus } from '../../types';
+/**
+ * Gate.io Exchange Connector
+ *
+ * Implements the BaseExchangeConnector interface for Gate.io exchange.
+ * Provides trading operations, market data access, and WebSocket streaming.
+ */
+export declare class GateioConnector extends BaseExchangeConnector {
+    private auth?;
+    private webSocket?;
+    private userDataStream?;
+    private logger;
+    private readonly baseUrl;
+    private readonly dataMapper;
+    constructor(credentials?: ExchangeCredentials);
+    /**
+     * Set API credentials and initialize authentication handler
+     *
+     * @param credentials - Gate.io API credentials (apiKey and secret only)
+     * @throws Error if credentials are missing required fields
+     */
+    setCredentials(credentials: ExchangeCredentials): void;
+    /**
+     * Connect to Gate.io API by testing server time and validating credentials
+     *
+     * @returns Promise that resolves when successfully connected to Gate.io API
+     * @throws Error if connection fails or credentials are invalid
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect from Gate.io API and clean up resources
+     *
+     * @returns Promise that resolves when successfully disconnected from Gate.io API
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Get account balance for all assets
+     *
+     * @returns Promise resolving to balance data for all assets
+     * @throws Error if API request fails or credentials are invalid
+     */
+    getBalance(): Promise<Record<string, Balance>>;
+    /**
+     * Create a new order on Gate.io exchange
+     *
+     * @param symbol - Trading pair symbol (e.g., 'SNEK/USDT')
+     * @param type - Order type ('market' or 'limit')
+     * @param side - Order side ('buy' or 'sell')
+     * @param amount - Order quantity/amount
+     * @param price - Optional. Price for limit orders (required for limit orders)
+     * @returns Promise resolving to the created order details
+     * @throws Error if order creation fails or parameters are invalid
+     */
+    createOrder(symbol: string, type: OrderType, side: OrderSide, amount: number, price?: number): Promise<Order>;
+    /**
+     * Cancel an existing order on Gate.io exchange
+     *
+     * @param orderId - The ID of the order to cancel
+     * @param symbol - Trading pair symbol (e.g., 'SNEK/USDT')
+     * @returns Promise that resolves when order is successfully cancelled
+     * @throws Error if cancellation fails or order not found
+     */
+    cancelOrder(orderId: string, symbol: string): Promise<void>;
+    /**
+     * Cancel all open orders for a specific symbol using batch delete endpoint
+     *
+     * Uses Gate.io's DELETE /spot/orders endpoint to cancel all orders in a single request,
+     * which is more efficient than canceling orders one by one.
+     *
+     * @param symbol - Trading pair symbol (e.g., 'SNEK/USDT')
+     * @returns Promise that resolves when all orders are cancelled
+     * @throws Error if cancellation fails
+     */
+    cancelAllOrders(symbol: string): Promise<void>;
+    /**
+     * Get details of a specific order by ID
+     *
+     * @param orderId - The ID of the order to retrieve
+     * @param symbol - Trading pair symbol (e.g., 'SNEK/USDT')
+     * @returns Promise resolving to order details
+     * @throws Error if order not found or request fails
+     */
+    getOrder(orderId: string, symbol: string): Promise<Order>;
+    /**
+     * Get all open orders, optionally filtered by symbol
+     *
+     * @param symbol - Optional. Trading pair symbol to filter orders (e.g., 'SNEK/USDT')
+     * @returns Promise resolving to array of open orders
+     * @throws Error if request fails
+     */
+    getOpenOrders(symbol?: string): Promise<Order[]>;
+    /**
+     * Get ticker information for a trading pair
+     *
+     * @param symbol - Trading pair symbol (e.g., 'SNEK/USDT')
+     * @returns Promise resolving to ticker data including prices and volume
+     * @throws Error if ticker data not found or request fails
+     */
+    getTicker(symbol: string): Promise<Ticker>;
+    /**
+     * Get order book data for a trading pair
+     *
+     * @param symbol - Trading pair symbol (e.g., 'SNEK/USDT')
+     * @returns Promise resolving to order book with bids and asks
+     * @throws Error if order book data not found or request fails
+     */
+    getOrderBook(symbol: string): Promise<OrderBook>;
+    /**
+     * Get recent trades for a trading pair
+     *
+     * @param symbol - Trading pair symbol (e.g., 'SNEK/USDT')
+     * @returns Promise resolving to array of recent trade executions
+     * @throws Error if request fails
+     */
+    getRecentTrades(symbol: string): Promise<Trade[]>;
+    /**
+     * Connect to Gate.io WebSocket for real-time data
+     */
+    connectWebSocket(): Promise<void>;
+    /**
+     * Disconnect from Gate.io WebSocket
+     */
+    disconnectWebSocket(): Promise<void>;
+    /**
+     * Subscribe to real-time ticker updates for a trading pair
+     */
+    subscribeTicker(symbol: string, callback: (ticker: Ticker) => void): Promise<string>;
+    /**
+     * Subscribe to real-time order book updates for a trading pair
+     */
+    subscribeOrderBook(symbol: string, callback: (orderbook: OrderBook) => void): Promise<string>;
+    /**
+     * Subscribe to real-time trade updates for a trading pair
+     */
+    subscribeTrades(symbol: string, callback: (trade: Trade) => void): Promise<string>;
+    /**
+     * Subscribe to real-time order updates (user data)
+     * Uses Gate.io UserDataStream for authenticated order updates
+     */
+    subscribeOrders(callback: (order: Order) => void): Promise<string>;
+    /**
+     * Unsubscribe from a WebSocket subscription
+     */
+    unsubscribe(subscriptionId: string): Promise<void>;
+    /**
+     * Check if WebSocket connection is active
+     */
+    isWebSocketConnected(): boolean;
+    /**
+     * Get current WebSocket connection status
+     */
+    getWebSocketStatus(): WebSocketStatus;
+    /**
+     * Connect to user data stream for real-time account updates
+     * Uses dedicated GateioUserDataStream class following Bitget/MEXC pattern
+     */
+    connectUserDataStream(): Promise<void>;
+    /**
+     * Disconnect from user data stream
+     */
+    disconnectUserDataStream(): Promise<void>;
+    /**
+     * Subscribe to real-time user order updates
+     * Uses Gate.io's spot.orders channel for authenticated order updates
+     */
+    subscribeUserOrders(callback: (order: Order) => void): Promise<string>;
+    /**
+     * Subscribe to real-time user trade executions
+     * Uses Gate.io's spot.usertrades channel for authenticated trade updates
+     */
+    subscribeUserTrades(callback: (trade: Trade) => void): Promise<string>;
+    /**
+     * Check if user data stream is connected
+     */
+    isUserDataStreamConnected(): boolean;
+    /**
+     * Make public request to Gate.io API (no authentication required)
+     */
+    private makePublicRequest;
+}
+//# sourceMappingURL=gateio-connector.d.ts.map

package/dist/exchanges/gateio/gateio-connector.d.ts.map

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