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

package/dist/utils/crypto.js

@@ -0,0 +1,50 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = exports.ExchangeAuthUtils = exports.CryptoUtils = void 0;
+const crypto_1 = __importDefault(require("crypto"));
+class CryptoUtils {
+    static generateHMACSignature(secret, message, algorithm = 'sha256') {
+        return crypto_1.default
+            .createHmac(algorithm, secret)
+            .update(message)
+            .digest('hex');
+    }
+    static generateHMACSignatureBase64(secret, message, algorithm = 'sha256') {
+        return crypto_1.default
+            .createHmac(algorithm, secret)
+            .update(message)
+            .digest('base64');
+    }
+    static hash(data, algorithm = 'sha256') {
+        return crypto_1.default.createHash(algorithm).update(data).digest('hex');
+    }
+}
+exports.CryptoUtils = CryptoUtils;
+exports.default = CryptoUtils;
+class ExchangeAuthUtils {
+    static createKucoinSignature(secret, timestamp, method, endpoint, body = '') {
+        const message = `${timestamp}${method}${endpoint}${body}`;
+        const signature = CryptoUtils.generateHMACSignatureBase64(secret, message, 'sha256');
+        return {
+            signature,
+            passphrase: CryptoUtils.generateHMACSignatureBase64(secret, 'your-passphrase', 'sha256')
+        };
+    }
+    static createMEXCSignature(secret, params) {
+        const sortedParams = Object.keys(params)
+            .sort()
+            .map(key => `${key}=${params[key]}`)
+            .join('&');
+        return CryptoUtils.generateHMACSignature(secret, sortedParams, 'sha256');
+    }
+    static createGateSignature(secret, method, url, body, timestamp) {
+        const hashedPayload = CryptoUtils.hash(body || '', 'sha512');
+        const message = `${method}\n${url}\n\n${hashedPayload}\n${timestamp}`;
+        return CryptoUtils.generateHMACSignature(secret, message, 'sha512');
+    }
+}
+exports.ExchangeAuthUtils = ExchangeAuthUtils;
+//# sourceMappingURL=crypto.js.map

package/dist/utils/crypto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.js","sourceRoot":"","sources":["../../src/utils/crypto.ts"],"names":[],"mappings":";;;;;;AAAA,oDAA4B;AAE5B,MAAa,WAAW;IAEtB,MAAM,CAAC,qBAAqB,CAC1B,MAAc,EACd,OAAe,EACf,YAAoB,QAAQ;QAE5B,OAAO,gBAAM;aACV,UAAU,CAAC,SAAS,EAAE,MAAM,CAAC;aAC7B,MAAM,CAAC,OAAO,CAAC;aACf,MAAM,CAAC,KAAK,CAAC,CAAC;IACnB,CAAC;IAED,MAAM,CAAC,2BAA2B,CAChC,MAAc,EACd,OAAe,EACf,YAAoB,QAAQ;QAE5B,OAAO,gBAAM;aACV,UAAU,CAAC,SAAS,EAAE,MAAM,CAAC;aAC7B,MAAM,CAAC,OAAO,CAAC;aACf,MAAM,CAAC,QAAQ,CAAC,CAAC;IACtB,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,IAAY,EAAE,YAAoB,QAAQ;QACpD,OAAO,gBAAM,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACjE,CAAC;CACF;AA3BD,kCA2BC;AA2CuB,8BAAO;AAzC/B,MAAa,iBAAiB;IAC5B,MAAM,CAAC,qBAAqB,CAC1B,MAAc,EACd,SAAiB,EACjB,MAAc,EACd,QAAgB,EAChB,OAAe,EAAE;QAEjB,MAAM,OAAO,GAAG,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,IAAI,EAAE,CAAC;QAC1D,MAAM,SAAS,GAAG,WAAW,CAAC,2BAA2B,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;QAErF,OAAO;YACL,SAAS;YACT,UAAU,EAAE,WAAW,CAAC,2BAA2B,CAAC,MAAM,EAAE,iBAAiB,EAAE,QAAQ,CAAC;SACzF,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,mBAAmB,CACxB,MAAc,EACd,MAA2B;QAE3B,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;aACrC,IAAI,EAAE;aACN,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;aACnC,IAAI,CAAC,GAAG,CAAC,CAAC;QACb,OAAO,WAAW,CAAC,qBAAqB,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC;IAC3E,CAAC;IAED,MAAM,CAAC,mBAAmB,CACxB,MAAc,EACd,MAAc,EACd,GAAW,EACX,IAAY,EACZ,SAAiB;QAEjB,MAAM,aAAa,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,EAAE,QAAQ,CAAC,CAAC;QAC7D,MAAM,OAAO,GAAG,GAAG,MAAM,KAAK,GAAG,OAAO,aAAa,KAAK,SAAS,EAAE,CAAC;QACtE,OAAO,WAAW,CAAC,qBAAqB,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IACtE,CAAC;CACF;AAvCD,8CAuCC"}

package/dist/utils/exchange-utils.d.ts

@@ -0,0 +1,194 @@
+import { OrderType, OrderSide } from '../types';
+import { MexcOrderParams } from '../types';
+/**
+ * Shared utility functions for exchange operations
+ *
+ * This module provides common functionality that can be used across different exchange connectors
+ * to avoid code duplication and maintain consistency.
+ */
+export declare class ExchangeUtils {
+    /**
+     * Validate common order parameters
+     *
+     * @param symbol - Trading pair symbol
+     * @param type - Order type
+     * @param side - Order side
+     * @param amount - Order amount
+     * @param price - Optional price for limit orders
+     * @throws Error if parameters are invalid
+     */
+    private static validateOrderParams;
+    /**
+     * Create standardized order parameters for exchange APIs
+     *
+     * @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)
+     * @param exchangeFormat - Exchange-specific parameter formatting function
+     * @returns Record with order parameters formatted for the exchange
+     * @throws Error if required parameters are missing or invalid
+     */
+    static createOrderParams<T = Record<string, string | number>>(symbol: string, type: OrderType, side: OrderSide, amount: number, price?: number, exchangeFormat?: (params: {
+        symbol: string;
+        type: OrderType;
+        side: OrderSide;
+        amount: number;
+        price?: number;
+    }) => T): T;
+    /**
+     * Create Bitget-specific order parameters
+     *
+     * @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
+     * @returns Bitget-formatted order parameters
+     */
+    static createBitgetOrderParams(symbol: string, type: OrderType, side: OrderSide, amount: number, price?: number): Record<string, string>;
+    /**
+     * Format quantity for Bitget with appropriate precision
+     *
+     * @param quantity - The quantity to format
+     * @param symbol - Trading pair symbol for precision rules
+     * @returns Formatted quantity string with correct decimal places
+     */
+    private static formatBitgetQuantity;
+    /**
+     * Format price for Bitget with appropriate precision
+     *
+     * @param price - The price to format
+     * @param symbol - Trading pair symbol for precision rules
+     * @returns Formatted price string with correct decimal places
+     */
+    private static formatBitgetPrice;
+    /**
+     * Get quantity precision for Bitget symbol
+     * Based on common Bitget precision rules
+     *
+     * @param symbol - Trading pair symbol
+     * @returns Number of decimal places for quantity
+     */
+    private static getBitgetQuantityPrecision;
+    /**
+     * Get price precision for Bitget symbol
+     * Based on common Bitget precision rules
+     *
+     * @param symbol - Trading pair symbol
+     * @returns Number of decimal places for price
+     */
+    private static getBitgetPricePrecision;
+    /**
+     * Validate minimum order value for Bitget
+     * Bitget requires minimum order value of 1 USDT
+     *
+     * @param amount - Order quantity
+     * @param price - Order price
+     * @param symbol - Trading pair symbol
+     * @throws Error if order value is below minimum
+     */
+    private static validateBitgetMinimumOrder;
+    /**
+     * Create MEXC-specific order parameters
+     *
+     * @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
+     * @returns MEXC-formatted order parameters
+     */
+    static createMexcOrderParams(symbol: string, type: OrderType, side: OrderSide, amount: number, price?: number): MexcOrderParams;
+    /**
+     * Create Gate.io-specific order parameters
+     *
+     * @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
+     * @returns Gate.io-formatted order parameters
+     */
+    static createGateioOrderParams(symbol: string, type: OrderType, side: OrderSide, amount: number, price?: number): Record<string, string>;
+    /**
+     * Validate minimum order value for Gate.io
+     * Gate.io requires minimum order value of 3 USDT
+     *
+     * @param amount - Order quantity
+     * @param price - Order price
+     * @param symbol - Trading pair symbol
+     * @throws Error if order value is below minimum
+     */
+    private static validateGateioMinimumOrder;
+    /**
+     * Create Kraken-specific order parameters
+     *
+     * @param symbol - Trading pair symbol (e.g., 'ADA/EUR')
+     * @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
+     * @returns Kraken-formatted order parameters
+     */
+    static createKrakenOrderParams(symbol: string, type: OrderType, side: OrderSide, amount: number, price?: number): Record<string, string>;
+    /**
+     * Validate minimum order value for Kraken
+     * Kraken requires different minimum order values based on quote currency
+     *
+     * @param amount - Order quantity
+     * @param price - Order price
+     * @param symbol - Trading pair symbol
+     * @throws Error if order value is below minimum
+     */
+    private static validateKrakenMinimumOrder;
+    /**
+     * Format quantity for Kraken with appropriate precision
+     *
+     * @param quantity - The quantity to format
+     * @param symbol - Trading pair symbol for precision rules
+     * @returns Formatted quantity string with correct decimal places
+     */
+    private static formatKrakenQuantity;
+    /**
+     * Format price for Kraken with appropriate precision
+     *
+     * @param price - The price to format
+     * @param symbol - Trading pair symbol for precision rules
+     * @returns Formatted price string with correct decimal places
+     */
+    private static formatKrakenPrice;
+    /**
+     * Get quantity precision for Kraken symbol
+     * Based on Kraken precision rules
+     *
+     * @param symbol - Trading pair symbol
+     * @returns Number of decimal places for quantity
+     */
+    private static getKrakenQuantityPrecision;
+    /**
+     * Get price precision for Kraken symbol
+     * Kraken has a maximum of 6 decimal places for prices
+     *
+     * @param symbol - Trading pair symbol
+     * @returns Number of decimal places for price
+     */
+    private static getKrakenPricePrecision;
+    /**
+     * Get minimum order value for exchange
+     *
+     * @param exchange - Exchange name ('bitget', 'mexc', 'gateio', 'kraken', etc.)
+     * @param symbol - Trading pair symbol
+     * @returns Minimum order value in quote currency
+     */
+    static getMinimumOrderValue(exchange: string, symbol: string): number;
+    /**
+     * Validate symbol format for exchange compatibility
+     *
+     * @param symbol - Symbol to validate
+     * @returns True if symbol is valid, false otherwise
+     */
+    static isValidSymbol(symbol: string): boolean;
+}
+//# sourceMappingURL=exchange-utils.d.ts.map

package/dist/utils/exchange-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exchange-utils.d.ts","sourceRoot":"","sources":["../../src/utils/exchange-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAG3C;;;;;GAKG;AACH,qBAAa,aAAa;IACxB;;;;;;;;;OASG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAwBlC;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,iBAAiB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,EAC1D,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,SAAS,EACf,IAAI,EAAE,SAAS,EACf,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,MAAM,EACd,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE;QACxB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,SAAS,CAAC;QAChB,IAAI,EAAE,SAAS,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,KAAK,CAAC,GACN,CAAC;IAmCJ;;;;;;;;;OASG;IACH,MAAM,CAAC,uBAAuB,CAC5B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,SAAS,EACf,IAAI,EAAE,SAAS,EACf,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,MAAM,GACb,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAoBzB;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAKnC;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAKhC;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,0BAA0B;IAYzC;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,uBAAuB;IAkBtC;;;;;;;;OAQG;IACH,OAAO,CAAC,MAAM,CAAC,0BAA0B;IAazC;;;;;;;;;OASG;IACH,MAAM,CAAC,qBAAqB,CAC1B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,SAAS,EACf,IAAI,EAAE,SAAS,EACf,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,MAAM,GACb,eAAe;IAkBlB;;;;;;;;;OASG;IACH,MAAM,CAAC,uBAAuB,CAC5B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,SAAS,EACf,IAAI,EAAE,SAAS,EACf,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,MAAM,GACb,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAsBzB;;;;;;;;OAQG;IACH,OAAO,CAAC,MAAM,CAAC,0BAA0B;IAazC;;;;;;;;;OASG;IACH,MAAM,CAAC,uBAAuB,CAC5B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,SAAS,EACf,IAAI,EAAE,SAAS,EACf,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,MAAM,GACb,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAsBzB;;;;;;;;OAQG;IACH,OAAO,CAAC,MAAM,CAAC,0BAA0B;IAyCzC;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAKnC;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAKhC;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,0BAA0B;IAazC;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,uBAAuB;IAmBtC;;;;;;OAMG;IACH,MAAM,CAAC,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;IAuCrE;;;;;OAKG;IACH,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;CAY9C"}