dexbot 1.1.10

package/dist/modules/order/export.js

@@ -0,0 +1,316 @@
+"use strict";
+/**
+ * modules/order/export.ts - Trade Export Module
+ *
+ * Trading history extraction and CSV export engine.
+ * Parses PM2 log files to extract trading fills and exports to standardized format.
+ *
+ * Usage:
+ *   const exporter = require('./order/export');
+ *   const result = await exporter.exportBotTrades(botKey, botConfig, outputDir);
+ *
+ * Output Format:
+ * - CSV: Trades in standardized format (unix, price, amount, side, fee_asset, fee_amount, order_id)
+ * - JSON: Sanitized bot settings (excludes private keys)
+ *
+ * ===============================================================================
+ * TABLE OF CONTENTS (4 exported functions + 3 internal helpers)
+ * ===============================================================================
+ *
+ * PUBLIC EXPORTS (4 functions)
+ *   1. exportBotTrades(botKey, botConfig, outputDir) - Main export function (async)
+ *      Orchestrates trade extraction and writing CSV/JSON exports
+ *      Returns: { success, trades_exported, csv_path, settings_path, output_dir, timestamp }
+ *
+ *   2. parseLogFile(logFilePath) - Parse PM2 log file to extract trades (async)
+ *      Reads line-by-line, extracts FILL entries, links with fee information
+ *      Returns: Array of trade objects with { timestamp, side, amount, price, proceeds, fee_asset, fee_amount }
+ *
+ *   3. writeTradesCSV(trades, outputPath) - Write trades to CSV file (async)
+ *      Generates standardized CSV with proper escaping and formatting
+ *      Returns: { success, count } or { success: false, error }
+ *
+ *   4. writeSettingsJSON(botConfig, botName, outputPath) - Write sanitized bot settings (async)
+ *      Exports bot parameters and configuration (excludes private keys)
+ *      Returns: { success } or { success: false, error }
+ *
+ * INTERNAL HELPERS (3 functions)
+ *   5. parseFillLine(line) - Parse fill entry from log line
+ *      Expected format: [TIMESTAMP] [DEBUG] [FILL] side fill: size=X, price=Y, proceeds=Z
+ *      Returns: { timestamp, side, amount, price, proceeds } or null
+ *
+ *   6. parseFeeLine(line) - Parse fee information from log line
+ *      Expected format: [TIMESTAMP] [INFO] [FEES] N maker fills @ FEE ASSET = TOTAL
+ *      Returns: { count, fee_per_fill, fee_asset, total_fee } or null
+ *
+ *   7. linkFillWithFee(fills, fees) - Match and link most recent fill with fee
+ *      Checks timestamp proximity (within 5 seconds) to associate fill with fee
+ *      Modifies fills array in-place
+ *
+ * ===============================================================================
+ *
+ * LOG FORMAT PATTERNS:
+ * Fill line: [2026-01-15T15:29:06.185Z] [DEBUG] [FILL] sell fill: size=0.0316, price=1791.30065898866, proceeds=56.60510082 BTS
+ * Fee line:  [2026-01-15T15:29:06.185Z] [INFO] [FEES] BTS fees calculated: 1 maker fills @ 0.04826000 BTS = 0.04826000 BTS
+ *
+ * CSV HEADER:
+ * unix, price, amount, side, fee_asset, fee_amount, order_id
+ *
+ * ===============================================================================
+ */
+const { getStorage } = require('../storage');
+const { getNodeRequire } = require('../env');
+const _require = getNodeRequire();
+const storage = getStorage();
+const { path } = require('../path_api');
+let _readline;
+function getReadline() {
+    if (!_readline && _require)
+        _readline = _require('readline');
+    return _readline;
+}
+const Format = require('./format');
+const { TIMING, DEFAULT_CONFIG } = require('../constants');
+const { PATHS } = require('../paths');
+const Logger = require('../logger');
+const exportLogger = new Logger('Export');
+function parseFillLine(line) {
+    const fillMatch = line.match(/\[(\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z)\].*\[FILL\]\s+(\w+)\s+fill:\s+size=([\d.]+),\s+price=([\d.]+),\s+proceeds=([\d.]+)/);
+    if (!fillMatch)
+        return null;
+    return {
+        timestamp: new Date(fillMatch[1]).getTime() / 1000, // Unix timestamp in seconds
+        side: fillMatch[2], // 'buy' or 'sell'
+        amount: parseFloat(fillMatch[3]), // Size in base asset
+        price: parseFloat(fillMatch[4]), // Execution price
+        proceeds: parseFloat(fillMatch[5]), // Proceeds/cost
+        fee_asset: 'BTS',
+        fee_amount: 0
+    };
+}
+/**
+ * Parse fee information from log line
+ * Expected format: [2026-01-15T15:29:06.185Z] [INFO] [FEES] BTS fees calculated: 1 maker fills @ 0.04826000 BTS = 0.04826000 BTS
+ * @param {string} line - Raw log line
+ * @returns {Object|null} Parsed fee object or null on no match
+ */
+function parseFeeLine(line) {
+    const feeMatch = line.match(/\[FEES\].*?(\d+)\s+maker\s+fills\s+@\s+([\d.]+)\s+(\w+)\s*=\s*([\d.]+)\s+\w+/);
+    if (!feeMatch)
+        return null;
+    return {
+        count: parseInt(feeMatch[1]),
+        fee_per_fill: parseFloat(feeMatch[2]),
+        fee_asset: feeMatch[3],
+        total_fee: parseFloat(feeMatch[4]),
+        timestamp: 0
+    };
+}
+/**
+ * Link fill with its corresponding fee information
+ * @param {Array} fills - Array of parsed fill objects
+ * @param {Array} fees - Array of parsed fee objects
+ * @returns {void}
+ */
+function linkFillWithFee(fills, fees) {
+    // Match most recent fill with most recent fee
+    if (fills.length > 0 && fees.length > 0) {
+        const lastFill = fills[fills.length - 1];
+        const lastFee = fees[fees.length - 1];
+        // Only link if they're close in time (within 5 seconds)
+        if (Math.abs(lastFill.timestamp - lastFee.timestamp) < 5) {
+            lastFill.fee_asset = lastFee.fee_asset;
+            lastFill.fee_amount = lastFee.total_fee;
+        }
+    }
+}
+/**
+ * Parse PM2 log file to extract trades
+ * @param {string} logFilePath - Path to PM2 log file
+ * @returns {Promise<Array>} Array of trade objects
+ */
+async function parseLogFile(logFilePath) {
+    const trades = [];
+    const fills = [];
+    const fees = [];
+    try {
+        const fileStream = storage.createReadStream(logFilePath);
+        const rl = getReadline().createInterface({
+            input: fileStream,
+            crlfDelay: Infinity
+        });
+        for await (const line of rl) {
+            // Parse fill lines
+            const fill = parseFillLine(line);
+            if (fill) {
+                fill.fee_asset = 'BTS'; // Default, will be overwritten if found
+                fill.fee_amount = 0;
+                fills.push(fill);
+                continue;
+            }
+            // Parse fee lines
+            const fee = parseFeeLine(line);
+            if (fee) {
+                fee.timestamp = Date.now() / TIMING.MILLISECONDS_PER_SECOND; // Approximate timestamp (seconds)
+                fees.push(fee);
+                linkFillWithFee(fills, fees);
+                continue;
+            }
+        }
+        // Link any remaining fills with fees
+        for (const fill of fills) {
+            if (fill.fee_amount === 0 && fees.length > 0) {
+                const relevantFee = fees.find(f => Math.abs(f.timestamp - fill.timestamp) < 5);
+                if (relevantFee) {
+                    fill.fee_asset = relevantFee.fee_asset;
+                    fill.fee_amount = relevantFee.total_fee;
+                }
+            }
+        }
+        return fills;
+    }
+    catch (err) {
+        exportLogger.error(`Failed to parse log file ${logFilePath}: ${err.message}`);
+        return [];
+    }
+}
+/**
+ * Write trades to CSV file in QTradeX format
+ * @param {Array} trades - Array of trade objects
+ * @param {string} outputPath - Path to output CSV file
+ * @returns {Promise<Object>} { success: boolean, count: number } or { success: false, error: string }
+ */
+async function writeTradesCSV(trades, outputPath) {
+    try {
+        // CSV header
+        const headers = ['unix', 'price', 'amount', 'side', 'fee_asset', 'fee_amount', 'order_id'];
+        // CSV rows
+        const rows = trades.map(trade => [
+            trade.timestamp.toFixed(1),
+            Format.formatPrice(trade.price),
+            Format.formatAmount8(trade.amount),
+            trade.side,
+            trade.fee_asset || 'BTS',
+            Format.formatAmount8(trade.fee_amount || 0),
+            trade.order_id || ''
+        ]);
+        // Combine and write
+        const csv = [headers, ...rows]
+            .map(row => row.map(val => {
+            // Escape quotes and wrap in quotes if contains comma
+            if (typeof val === 'string' && val.includes(',')) {
+                return `"${val.replace(/"/g, '""')}"`;
+            }
+            return val;
+        }).join(','))
+            .join('\n');
+        storage.writeFile(outputPath, csv + '\n', 'utf8');
+        exportLogger.info(`✓ Exported ${trades.length} trades to ${outputPath}`);
+        return { success: true, count: trades.length };
+    }
+    catch (err) {
+        exportLogger.error(`Failed to write CSV: ${err.message}`);
+        return { success: false, error: err.message };
+    }
+}
+/**
+ * Write sanitized bot settings to JSON file
+ * Excludes private keys and sensitive data
+ * @param {Object} botConfig - Bot configuration object
+ * @param {string} botName - Bot name
+ * @param {string} outputPath - Path to output JSON file
+ * @returns {Promise<Object>} Write result { success, count } or { success: false, error }
+ */
+async function writeSettingsJSON(botConfig, botName, outputPath) {
+    try {
+        const sanitized = {
+            bot_name: botName,
+            strategy: botConfig.strategy || 'grid_trading',
+            market: botConfig.market || `${botConfig.assetA}/${botConfig.assetB}`,
+            parameters: {
+                start_price: botConfig.startPrice || DEFAULT_CONFIG.startPrice,
+                min_price: botConfig.minPrice || DEFAULT_CONFIG.minPrice,
+                max_price: botConfig.maxPrice || DEFAULT_CONFIG.maxPrice,
+                increment_percent: botConfig.incrementPercent || DEFAULT_CONFIG.incrementPercent,
+                target_spread_percent: botConfig.targetSpreadPercent || DEFAULT_CONFIG.targetSpreadPercent,
+                active_orders: botConfig.activeOrders || DEFAULT_CONFIG.activeOrders,
+                bot_funds: botConfig.botFunds || DEFAULT_CONFIG.botFunds,
+                weight_distribution: botConfig.weightDistribution || DEFAULT_CONFIG.weightDistribution,
+                dry_run: botConfig.dryRun || false,
+                active: botConfig.active !== false
+            },
+            assets: {
+                base: botConfig.assetA,
+                quote: botConfig.assetB
+            },
+            exported_at: new Date().toISOString()
+        };
+        storage.writeFile(outputPath, JSON.stringify(sanitized, null, 2) + '\n', 'utf8');
+        exportLogger.info(`✓ Exported settings to ${outputPath}`);
+        return { success: true };
+    }
+    catch (err) {
+        exportLogger.error(`Failed to write settings JSON: ${err.message}`);
+        return { success: false, error: err.message };
+    }
+}
+/**
+ * Export bot trades from PM2 log file to CSV
+ * @param {string} botKey - Bot identifier (e.g., 'xrp-bts-0')
+ * @param {Object} botConfig - Bot configuration object
+ * @param {string} outputDir - Output directory for exports (default: './exports')
+ * @returns {Promise<Object>} Export result status
+ */
+async function exportBotTrades(botKey, botConfig, outputDir = './exports') {
+    try {
+        // Ensure output directory exists
+        storage.ensureDir(outputDir);
+        // Find log file (PM2 format: {botKey}-error.log or {botKey}.log)
+        const logsDir = PATHS.LOGS_DIR;
+        let logFilePath = null;
+        try {
+            const logFiles = storage.readdir(logsDir);
+            const matchingLog = logFiles.find(f => f.includes(botKey) && f.endsWith('.log') && !f.includes('error'));
+            if (matchingLog) {
+                logFilePath = path.join(logsDir, matchingLog);
+            }
+        }
+        catch (err) {
+            exportLogger.warn(`Could not read logs directory: ${err.message}`);
+        }
+        // Parse trades from log file
+        const trades = logFilePath ? await parseLogFile(logFilePath) : [];
+        if (trades.length === 0) {
+            exportLogger.warn(`No trades found in log file for ${botKey}`);
+        }
+        // Write trades CSV
+        const csvPath = path.join(outputDir, `${botKey}_trades.csv`);
+        const csvResult = await writeTradesCSV(trades, csvPath);
+        // Write settings JSON
+        const settingsPath = path.join(outputDir, `${botKey}_settings.json`);
+        const settingsResult = await writeSettingsJSON(botConfig, botKey, settingsPath);
+        return {
+            success: csvResult.success && settingsResult.success,
+            trades_exported: trades.length,
+            csv_path: csvPath,
+            settings_path: settingsPath,
+            output_dir: outputDir,
+            timestamp: new Date().toISOString()
+        };
+    }
+    catch (err) {
+        exportLogger.error(`Export failed for ${botKey}: ${err.message}`);
+        return {
+            success: false,
+            error: err.message,
+            bot_key: botKey
+        };
+    }
+}
+module.exports = {
+    exportBotTrades,
+    parseLogFile,
+    writeTradesCSV,
+    writeSettingsJSON
+};
+//# sourceMappingURL=export.js.map

package/dist/modules/order/export.js.map

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

package/dist/modules/order/format.d.ts

@@ -0,0 +1,158 @@
+/**
+ * modules/order/format.ts - Numeric formatting utilities
+ *
+ * Centralized formatting utilities for consistent decimal precision display across logs and output.
+ * All functions return strings formatted to specified decimal places.
+ *
+ * ===============================================================================
+ * DECIMAL PRECISION STANDARDS
+ * ===============================================================================
+ *
+ * Asset Amounts:                8 decimals  - blockchain native precision
+ * Prices:                       6-8 decimals - price precision varies by pair
+ * Percentages:                  1-4 decimals - display precision
+ * Ratios/Metrics:               2-5 decimals - context dependent
+ * Time/Performance (ms, %):     1-2 decimals - readable metrics
+ *
+ * ===============================================================================
+ * TABLE OF CONTENTS (17 exported functions)
+ * ===============================================================================
+ *
+ * SECTION 1: ASSET FORMATTING (5 functions)
+ *   1. formatAmount8(value) - Format to 8 decimals (blockchain standard)
+ *   2. formatAmount(value, decimals) - Format with custom decimal places
+ *   3. formatAmountByPrecision(value, precision) - Format using chain precision
+ *   4. formatAmountStrict(value, precision) - Format using chain precision; returns 'N/A' if either arg is non-finite
+ *   5. formatSizeByOrderType(value, orderType, assets) - Format order size by BUY/SELL asset precision
+ *
+ * SECTION 2: PRICE FORMATTING (3 functions)
+ *   6. formatPrice(value) - Format to 8 decimals (maximum precision)
+ *   7. formatPrice6(value) - Format to 6 decimals
+ *   8. formatPrice4(value) - Format to 4 decimals (simplified display)
+ *
+ * SECTION 3: PERCENTAGE FORMATTING (3 functions)
+ *   9. formatPercent2(value) - Format to 2 decimals (spread %, ratios)
+ *   10. formatPercent(value, decimals) - Format with custom decimal places
+ *
+ * SECTION 4: RATIO/METRIC FORMATTING (3 functions)
+ *   12. formatRatio(value, decimals) - Format ratios with custom decimals (default 5)
+ *   13. formatMetric2(value) - Format to 2 decimals (timing, performance)
+ *   14. formatMetric5(value) - Format to 5 decimals (detailed metrics)
+ *
+ * SECTION 5: HELPER UTILITIES (4 functions)
+ *   15. isValidNumber(value) - Check if value is defined and finite
+ *   16. isNumeric(val) - Check if value is a number or parseable numeric string
+ *   17. toFiniteNumber(value, defaultValue) - Convert to finite number with fallback
+ *   18. safeFormat(value, decimals, fallback) - Safely format with fallback
+ *
+ * ===============================================================================
+ */
+/**
+ * Format asset amounts to 8 decimal places (blockchain standard)
+ * Used for: Asset amounts, order sizes
+ *
+ * @param {number} value - The value to format
+ * @returns {string} Formatted value to 8 decimals
+ */
+declare function formatAmount8(value: number): string;
+/**
+ * Format asset amounts with custom decimal places
+ *
+ * @param {number} value - The value to format
+ * @param {number} [decimals=8] - Number of decimal places (default 8)
+ * @returns {string} Formatted value
+ */
+declare function formatAmount(value: number, decimals?: number): string;
+/**
+ * Format asset amount using an explicit blockchain precision.
+ * Throws if precision is invalid — no silent fallback.
+ *
+ * @param {number} value - The value to format
+ * @param {number} precision - Asset precision to apply
+ * @returns {string} Formatted value
+ */
+declare function formatAmountByPrecision(value: number, precision: number | undefined): string;
+/**
+ * Format an order size using market-side precision.
+ * BUY size is in assetB units, SELL size is in assetA units.
+ * Throws if precision is unavailable — no silent fallback.
+ *
+ * @param {number} value - The value to format
+ * @param {string} orderType - Order side ('buy' or 'sell')
+ * @param {Object} assets - Asset metadata with assetA/assetB precision
+ * @returns {string} Formatted value
+ */
+declare function formatSizeByOrderType(value: number, orderType: string, assets: {
+    assetA?: {
+        precision?: number;
+    };
+    assetB?: {
+        precision?: number;
+    };
+}): string;
+/**
+ * Format prices to 8 decimal places (maximum precision)
+ * Used for: order prices, market prices
+ *
+ * @param {number} value - The price to format
+ * @returns {string} Formatted price to 8 decimals
+ */
+declare function formatPrice(value: number): string;
+declare function formatPrice6(value: number): string;
+declare function formatPrice4(value: number): string;
+/**
+ * Format percentages to 2 decimal places
+ * Used for: spread %, ratios, simple percentages
+ *
+ * @param {number} value - The percentage value (0-100 or decimal 0-1)
+ * @returns {string} Formatted percentage to 2 decimals
+ */
+declare function formatPercent2(value: number): string;
+declare function formatPercent(value: number, decimals?: number): string;
+/**
+ * Format ratios with custom decimal places
+ *
+ * @param {number} value - The ratio value
+ * @param {number} [decimals=5] - Number of decimal places (default 5)
+ * @returns {string} Formatted ratio
+ */
+declare function formatRatio(value: number, decimals?: number): string;
+declare function formatMetric2(value: number): string;
+declare function formatMetric5(value: number): string;
+/**
+ * Check if a value is defined and represents a finite number.
+ * @param {*} value - Value to check
+ * @returns {boolean} True if value is defined and finite
+ */
+declare function isValidNumber(value: any): boolean;
+declare function isNumeric(val: any): boolean;
+declare function toFiniteNumber(value: any, defaultValue?: number): number;
+/**
+ * Safely format a numeric value with specified decimals and fallback.
+ *
+ * @param {*} value - The value to format
+ * @param {number} decimals - Number of decimal places
+ * @param {string} [fallback='N/A'] - Fallback value if format fails
+ * @returns {string} Formatted value or fallback string
+ */
+declare function safeFormat(value: any, decimals: number, fallback?: string): string;
+declare const _default: {
+    formatAmount8: typeof formatAmount8;
+    formatAmount: typeof formatAmount;
+    formatAmountByPrecision: typeof formatAmountByPrecision;
+    formatSizeByOrderType: typeof formatSizeByOrderType;
+    formatPrice: typeof formatPrice;
+    formatPrice6: typeof formatPrice6;
+    formatPrice4: typeof formatPrice4;
+    formatPercent2: typeof formatPercent2;
+    formatPercent: typeof formatPercent;
+    formatRatio: typeof formatRatio;
+    formatMetric2: typeof formatMetric2;
+    formatMetric5: typeof formatMetric5;
+    isValidNumber: typeof isValidNumber;
+    isNumeric: typeof isNumeric;
+    toFiniteNumber: typeof toFiniteNumber;
+    safeFormat: typeof safeFormat;
+};
+export = _default;
+//# sourceMappingURL=format.d.ts.map

package/dist/modules/order/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../modules/order/format.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AAMH;;;;;;GAMG;AACH,iBAAS,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED;;;;;;GAMG;AACH,iBAAS,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAU,GAAG,MAAM,CAEjE;AAED;;;;;;;GAOG;AACH,iBAAS,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAKrF;AAED;;;;;;;;;GASG;AACH,iBAAS,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE;IAAE,MAAM,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAAC,MAAM,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAAG,MAAM,CAMrJ;AAmBD;;;;;;GAMG;AACH,iBAAS,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE1C;AAED,iBAAS,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE3C;AAED,iBAAS,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE3C;AAMD;;;;;;GAMG;AACH,iBAAS,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED,iBAAS,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAU,GAAG,MAAM,CAElE;AAMD;;;;;;GAMG;AACH,iBAAS,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAU,GAAG,MAAM,CAEhE;AAED,iBAAS,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED,iBAAS,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE5C;AAMD;;;;GAIG;AACH,iBAAS,aAAa,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAE1C;AAED,iBAAS,SAAS,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAEpC;AAED,iBAAS,cAAc,CAAC,KAAK,EAAE,GAAG,EAAE,YAAY,GAAE,MAAU,GAAG,MAAM,CAGpE;AAED;;;;;;;GAOG;AACH,iBAAS,UAAU,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAc,GAAG,MAAM,CASlF;;;;;;;;;;;;;;;;;;;AAMD,kBA0BE"}