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

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

@@ -0,0 +1,203 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BitgetAuth = void 0;
+const crypto_1 = __importDefault(require("crypto"));
+const utils_1 = require("../../utils");
+/**
+ * Bitget Authentication and Request Handler
+ *
+ * Handles API authentication, request signing, and HTTP requests to Bitget API.
+ * Implements Bitget's HMAC-SHA256 signature generation with BASE64 encoding.
+ *
+ * @see https://www.bitget.com/api-doc/common/signature
+ */
+class BitgetAuth {
+    /**
+     * Initialize Bitget authentication handler
+     *
+     * @param credentials - Bitget API credentials including API key, secret, and passphrase
+     * @param baseUrl - Base URL for Bitget API (defaults to production)
+     */
+    constructor(credentials, baseUrl = 'https://api.bitget.com') {
+        this.logger = (0, utils_1.createLogger)('bitget-auth');
+        this.credentials = credentials;
+        this.baseUrl = baseUrl;
+        this.validateCredentials();
+    }
+    /**
+     * Generate HMAC-SHA256 signature for Bitget API requests
+     */
+    generateSignature(timestamp, method, requestPath, queryString = '', body = '') {
+        const queryPart = queryString ? `?${queryString}` : '';
+        const signatureString = `${timestamp}${method.toUpperCase()}${requestPath}${queryPart}${body}`;
+        try {
+            const hmac = crypto_1.default.createHmac('sha256', this.credentials.secret);
+            hmac.update(signatureString);
+            return hmac.digest('base64');
+        }
+        catch (error) {
+            this.logger.error('Failed to generate signature', { error });
+            throw new Error(`Failed to generate Bitget API signature: ${error}`);
+        }
+    }
+    /**
+     * Get required headers for authenticated Bitget API requests
+     */
+    getHeaders(method, requestPath, queryString = '', body = '', timestamp) {
+        const requestTimestamp = timestamp || Date.now();
+        const signature = this.generateSignature(requestTimestamp, method, requestPath, queryString, body);
+        return {
+            'Content-Type': 'application/json',
+            'ACCESS-KEY': this.credentials.apiKey,
+            'ACCESS-SIGN': signature,
+            'ACCESS-TIMESTAMP': requestTimestamp.toString(),
+            'ACCESS-PASSPHRASE': this.credentials.passphrase,
+        };
+    }
+    /**
+     * Get headers for public API endpoints
+     */
+    getPublicHeaders() {
+        return {
+            'Content-Type': 'application/json',
+        };
+    }
+    /**
+     * Make authenticated request to Bitget API
+     */
+    async makeRequest(endpoint, params = {}, method = 'GET', body) {
+        const timestamp = Date.now();
+        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}${endpoint}?${queryString}`
+            : `${this.baseUrl}${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(`Bitget API request failed: ${error}`);
+        }
+    }
+    /**
+     * Make public request to Bitget 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}${endpoint}?${queryString}`
+            : `${this.baseUrl}${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(`Bitget 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.msg) {
+                    errorMessage = `Bitget API Error: ${errorData.msg} (Code: ${errorData.code || 'Unknown'})`;
+                }
+            }
+            catch {
+                errorMessage = `HTTP ${response.status}: ${responseText.substring(0, 200)}`;
+            }
+            this.logger.error('Bitget API request failed', {
+                endpoint,
+                status: response.status,
+                statusText: response.statusText,
+                error: errorMessage,
+            });
+            throw new Error(errorMessage);
+        }
+        try {
+            const data = JSON.parse(responseText);
+            if (data.code && data.code !== '00000') {
+                const apiError = `Bitget API Error: ${data.msg || 'Unknown error'} (Code: ${data.code})`;
+                this.logger.error('Bitget API returned error', {
+                    endpoint,
+                    code: data.code,
+                    message: data.msg,
+                    data: data.data,
+                });
+                throw new Error(apiError);
+            }
+            return data;
+        }
+        catch (error) {
+            if (error instanceof Error && error.message.includes('Bitget API Error')) {
+                throw error;
+            }
+            this.logger.error('Failed to parse response JSON', {
+                endpoint,
+                responseText: responseText.substring(0, 200),
+            });
+            throw new Error(`Invalid JSON response from Bitget 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 (!this.credentials.passphrase)
+            missing.push('passphrase');
+        if (missing.length > 0) {
+            throw new Error(`Missing required Bitget credentials: ${missing.join(', ')}`);
+        }
+    }
+    /**
+     * Check if credentials are properly configured
+     */
+    validateCredentialsExist() {
+        try {
+            this.validateCredentials();
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Get credentials for WebSocket authentication
+     *
+     * @returns The BitgetCredentials object
+     */
+    getCredentials() {
+        return this.credentials;
+    }
+}
+exports.BitgetAuth = BitgetAuth;
+//# sourceMappingURL=bitget-auth.js.map

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

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

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

@@ -0,0 +1,255 @@
+import { BaseExchangeConnector } from '../../core/exchange/base-exchange-connector';
+import { Order, OrderBook, Ticker, Trade, OrderType, OrderSide, Balance, ExchangeCredentials, WebSocketStatus } from '../../types';
+/**
+ * Bitget Exchange Connector
+ *
+ * Implements the BaseExchangeConnector interface for Bitget exchange.
+ * Provides trading operations, market data access, and WebSocket streaming.
+ */
+export declare class BitgetConnector extends BaseExchangeConnector {
+    private auth?;
+    private ws?;
+    private userStream?;
+    private logger;
+    private readonly baseUrl;
+    private readonly dataMapper;
+    constructor();
+    /**
+     * Set API credentials and initialize authentication handler
+     *
+     * @param credentials - Bitget API credentials including apiKey, secret, and passphrase
+     * @throws Error if credentials are missing required Bitget fields (passphrase)
+     */
+    setCredentials(credentials: ExchangeCredentials): void;
+    /**
+     * Connect to Bitget API by testing server time and validating credentials
+     *
+     * @returns Promise that resolves when successfully connected to Bitget API
+     * @throws Error if connection fails or credentials are invalid
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect from Bitget API and clean up resources
+     *
+     * @returns Promise that resolves when successfully disconnected from Bitget API
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Validate if credentials contain required Bitget fields
+     */
+    private isValidBitgetCredentials;
+    /**
+     * Get account balance for all assets or a specific asset
+     *
+     * @returns Promise resolving to balance data - either all balances or single asset balance
+     * @throws Error if API request fails or credentials are invalid
+     */
+    getBalance(): Promise<Record<string, Balance>>;
+    getBalance(asset: string): Promise<Balance>;
+    /**
+     * Create a new order on Bitget 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 Bitget 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
+     *
+     * @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 Bitget WebSocket for real-time data
+     *
+     * @returns Promise that resolves when WebSocket connection is established
+     * @throws Error if connection fails
+     */
+    connectWebSocket(): Promise<void>;
+    /**
+     * Disconnect from Bitget WebSocket
+     *
+     * @returns Promise that resolves when WebSocket is disconnected
+     */
+    disconnectWebSocket(): Promise<void>;
+    /**
+     * Subscribe to real-time ticker updates for a trading pair
+     *
+     * @param symbol - Trading pair symbol (e.g., 'SNEK/USDT')
+     * @param callback - Function called when ticker updates are received
+     * @returns Promise resolving to subscription ID for managing the subscription
+     * @throws Error if WebSocket not connected or subscription fails
+     */
+    subscribeTicker(symbol: string, callback: (ticker: Ticker) => void): Promise<string>;
+    /**
+     * Subscribe to real-time order book updates for a trading pair
+     *
+     * @param symbol - Trading pair symbol (e.g., 'SNEK/USDT')
+     * @param callback - Function called when order book updates are received
+     * @returns Promise resolving to subscription ID for managing the subscription
+     * @throws Error if WebSocket not connected or subscription fails
+     */
+    subscribeOrderBook(symbol: string, callback: (orderbook: OrderBook) => void): Promise<string>;
+    /**
+     * Subscribe to real-time trade updates for a trading pair
+     *
+     * @param symbol - Trading pair symbol (e.g., 'SNEK/USDT')
+     * @param callback - Function called when new trades are executed
+     * @returns Promise resolving to subscription ID for managing the subscription
+     * @throws Error if WebSocket not connected or subscription fails
+     */
+    subscribeTrades(symbol: string, callback: (trade: Trade) => void): Promise<string>;
+    /**
+     * Subscribe to real-time order updates (user data)
+     *
+     * @param callback - Function called when user's order status changes
+     * @returns Promise resolving to subscription ID for managing the subscription
+     * @throws Error if WebSocket not connected or subscription fails
+     */
+    subscribeOrders(callback: (order: Order) => void): Promise<string>;
+    /**
+     * Unsubscribe from a WebSocket subscription
+     *
+     * @param subscriptionId - The ID of the subscription to cancel
+     * @returns Promise that resolves when subscription is cancelled
+     * @throws Error if WebSocket not connected or unsubscribe fails
+     */
+    unsubscribe(subscriptionId: string): Promise<void>;
+    /**
+     * Check if WebSocket connection is active
+     *
+     * @returns Boolean indicating WebSocket connection status
+     */
+    isWebSocketConnected(): boolean;
+    /**
+     * Get current WebSocket connection status
+     *
+     * @returns Current WebSocket status ('connected', 'disconnected', etc.)
+     */
+    getWebSocketStatus(): WebSocketStatus;
+    /**
+     * User Data Stream Methods Implementation
+     */
+    /**
+     * Connect to user data stream for real-time account updates
+     *
+     * @returns Promise that resolves when user data stream is connected
+     * @throws Error if authentication fails or connection cannot be established
+     */
+    connectUserDataStream(): Promise<void>;
+    /**
+     * Disconnect from user data stream
+     *
+     * @returns Promise that resolves when user data stream is disconnected
+     */
+    disconnectUserDataStream(): Promise<void>;
+    /**
+     * Subscribe to real-time user order updates (limit/market orders)
+     *
+     * @param callback - Function called when user's orders change status
+     * @returns Promise resolving to subscription ID for managing the subscription
+     * @throws Error if user data stream not connected or subscription fails
+     */
+    subscribeUserOrders(callback: (order: Order) => void): Promise<string>;
+    /**
+     * Subscribe to real-time user trade executions
+     * Notifies when user's orders are filled/executed
+     *
+     * @param callback - Function called when user's trades are executed
+     * @returns Promise resolving to subscription ID for managing the subscription
+     * @throws Error if user data stream not connected or subscription fails
+     */
+    subscribeUserTrades(callback: (trade: Trade) => void): Promise<string>;
+    /**
+     * Subscribe to real-time account balance updates
+     *
+     * @param callback - Function called when account balance changes
+     * @returns Promise resolving to subscription ID for managing the subscription
+     * @throws Error if user data stream not connected or subscription fails
+     */
+    subscribeAccountUpdates(callback: (accountData: any) => void): Promise<string>;
+    /**
+     * Check if user data stream is connected
+     *
+     * @returns Boolean indicating user data stream connection status
+     */
+    isUserDataStreamConnected(): boolean;
+    /**
+     * Make authenticated request to Bitget API
+     *
+     * @param endpoint - API endpoint path
+     * @param params - Query parameters for the request
+     * @param method - HTTP method ('GET', 'POST', 'PUT', 'DELETE')
+     * @param body - Request body data for POST/PUT requests
+     * @returns Promise resolving to API response data
+     * @throws Error if not authenticated or request fails
+     */
+    private makeRequest;
+    /**
+     * Make public request to Bitget API (no authentication required)
+     *
+     * @param endpoint - API endpoint path
+     * @param params - Query parameters for the request
+     * @returns Promise resolving to API response data
+     * @throws Error if request fails
+     */
+    private makePublicRequest;
+}
+//# sourceMappingURL=bitget-connector.d.ts.map

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

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