dexbot 1.1.10

package/dist/modules/dexbot_maintenance_runtime.d.ts

@@ -0,0 +1,279 @@
+/**
+ * Check if a bot configuration uses an AMA grid price source.
+ * @param {Object} bot - Bot configuration object
+ * @returns {boolean} True if gridPrice starts with 'ama' (ama, ama1..ama4)
+ */
+declare function usesAmaGridPrice(bot: any): boolean;
+/**
+ * Find a bot entry in the bots config snapshot that matches a runtime config.
+ * Matches by botKey or name.
+ * @param {import('./types').BotsConfigSnapshot} snapshot - Bots configuration snapshot
+ * @param {Object} config - Runtime bot configuration
+ * @returns {Object|null} Matched bot entry or null
+ */
+declare function findSnapshotBotForRuntimeConfig(snapshot: any, config: any): any;
+/**
+ * Check if a runtime bot configuration requires the market adapter.
+ * @param {import('./types').BotsConfigSnapshot} snapshot - Bots configuration snapshot
+ * @param {Object} config - Runtime bot configuration
+ * @returns {boolean} True if the bot uses AMA grid pricing
+ */
+declare function runtimeConfigNeedsMarketAdapter(snapshot: any, config: any): boolean;
+/**
+ * Load and fingerprint the bots.json configuration file.
+ * @returns {import('./types').BotsConfigSnapshot} Snapshot with exists flag, fingerprint, active bots list, and adapter requirement
+ */
+declare function loadBotsConfigSnapshot(): {
+    exists: boolean;
+    fingerprint: any;
+    activeBots: any[];
+    needsMarketAdapter: boolean;
+    config?: undefined;
+} | {
+    exists: boolean;
+    fingerprint: any;
+    config: any;
+    activeBots: any;
+    needsMarketAdapter: any;
+};
+/**
+ * Stop and delete the market adapter process from PM2.
+ * @returns {Promise<void>}
+ */
+declare function stopMarketAdapterPm2(): Promise<void>;
+/**
+ * Synchronize market adapter state based on periodic config checks.
+ * Starts or stops the market adapter based on whether any active bot uses AMA grid pricing.
+ * @param {import('./dexbot_class').DEXBot} bot
+ * @param {string} [context='periodic'] - Context label for logging
+ * @returns {Promise<import('./types').MarketAdapterSyncResult>}
+ */
+declare function syncMarketAdapterOnPeriodicConfigCheck(bot: any, context?: string): Promise<{
+    skipped: boolean;
+    reason: string;
+    changed?: undefined;
+    required?: undefined;
+    running?: undefined;
+    started?: undefined;
+    stopped?: undefined;
+    mode?: undefined;
+    error?: undefined;
+} | {
+    changed: boolean;
+    required: boolean;
+    running: boolean;
+    started: boolean;
+    stopped: boolean;
+    mode: string;
+    skipped?: undefined;
+    reason?: undefined;
+    error?: undefined;
+} | {
+    changed: boolean;
+    required: boolean;
+    running: boolean;
+    started: boolean;
+    stopped: boolean;
+    error: any;
+    skipped?: undefined;
+    reason?: undefined;
+    mode?: undefined;
+}>;
+/**
+ * Refresh the dynamic weight distribution from the AMA center snapshot.
+ * Applies live dynamic weights if the bot is whitelisted and weights are ready.
+ * @param {import('./dexbot_class').DEXBot} bot
+ * @param {string} [context='runtime'] - Context label for logging
+ * @returns {import('./types').DynamicWeightRefreshResult}
+ */
+declare function refreshDynamicWeightDistribution(bot: any, context?: string): {
+    applied: boolean;
+    source: string;
+    weightDistribution: any;
+    snapshotUpdatedAt?: undefined;
+} | {
+    applied: boolean;
+    source: string;
+    weightDistribution: any;
+    snapshotUpdatedAt: any;
+};
+/**
+ * Update the grid reset metadata (last reset timestamp and source) in the dynamic grid snapshot.
+ * @param {string} botKey - Bot identifier key
+ * @param {Object} [options] - Reset metadata options
+ * @param {string} [options.resetAt] - ISO timestamp for the reset (defaults to now)
+ * @param {string} [options.resetSource] - Source label for the reset (defaults to 'dexbot_grid_resync')
+ * @returns {boolean} True if metadata was written
+ */
+declare function updateBotGridResetMetadata(botKey: any, options?: {
+    resetAt?: string;
+    resetSource?: string;
+}): any;
+/**
+ * Perform a full grid resync: reload config, optionally refresh center price,
+ * recalculate the grid, persist, and record reset metadata.
+ * @param {import('./dexbot_class').DEXBot} bot
+ * @param {import('./types').GridResyncOptions} [options] - Grid resync options
+ * @returns {Promise<boolean>} True if resync succeeded
+ */
+declare function performGridResync(bot: any, options?: {
+    refreshCenterPrice?: boolean;
+    centerRefreshContext?: string;
+    centerRefreshLabel?: string;
+    resetSource?: string;
+}): Promise<boolean>;
+/**
+ * Handle a pending trigger file detected at startup or during runtime.
+ * Processes the trigger and performs a grid resync if the trigger file exists.
+ * @param {import('./dexbot_class').DEXBot} bot
+ * @returns {Promise<boolean>} True if reset was handled successfully
+ */
+declare function handlePendingTriggerReset(bot: any): Promise<boolean>;
+/**
+ * Set up a file watcher on the profiles directory to detect trigger file creation.
+ * When a trigger file appears, debounces and processes the grid resync.
+ * @param {import('./dexbot_class').DEXBot} bot
+ * @returns {Promise<void>}
+ */
+declare function setupTriggerFileDetection(bot: any): Promise<void>;
+/**
+ * Perform periodic grid health checks (divergence, spread condition, dust detection).
+ * Called as part of the periodic blockchain fetch interval.
+ * @param {import('./dexbot_class').DEXBot} bot
+ * @returns {Promise<void>}
+ */
+declare function performPeriodicGridChecks(bot: any): Promise<void>;
+/**
+ * Check if the continuous open-orders sync loop is enabled.
+ * @param {import('./dexbot_class').DEXBot} bot
+ * @returns {boolean} True if the sync loop is enabled in TIMING config
+ */
+declare function isOpenOrdersSyncLoopEnabled(bot: any): boolean;
+/**
+ * Start the continuous open-orders sync loop.
+ * Periodically reads on-chain orders and synchronizes with the grid manager.
+ * @param {import('./dexbot_class').DEXBot} bot
+ */
+declare function startOpenOrdersSyncLoop(bot: any): void;
+/**
+ * Stop the continuous open-orders sync loop.
+ * @param {import('./dexbot_class').DEXBot} bot
+ * @returns {Promise<void>}
+ */
+declare function stopOpenOrdersSyncLoop(bot: any): Promise<void>;
+/**
+ * Set up the periodic blockchain fetch interval.
+ * Periodically fetches account totals and syncs open orders from the blockchain.
+ * @param {import('./dexbot_class').DEXBot} bot
+ */
+declare function setupBlockchainFetchInterval(bot: any): void;
+/**
+ * Stop the periodic blockchain fetch interval.
+ * @param {import('./dexbot_class').DEXBot} bot
+ */
+declare function stopBlockchainFetchInterval(bot: any): void;
+/**
+ * Release the market adapter runtime for a bot.
+ * In PM2 mode this is a no-op; in direct mode it calls the shared runtime's releaseBot.
+ * @param {import('./dexbot_class').DEXBot} bot
+ * @param {string} botId - Bot identifier
+ * @param {string} [context='shutdown'] - Context label for logging
+ * @returns {Promise<import('./types').MarketAdapterReleaseResult>}
+ */
+declare function releaseMarketAdapterRuntime(bot: any, botId: any, context?: string): Promise<any>;
+/**
+ * Check if an error message indicates that an order does not exist on the blockchain.
+ * @param {string} message - Error message to check
+ * @param {string} [orderId] - Optional order ID for context-aware matching
+ * @returns {boolean} True if the message indicates a nonexistent order
+ */
+declare function isOrderDoesNotExistError(message: any, orderId: any): boolean;
+/**
+ * Execute the core maintenance logic: recalculate funds, check pipeline,
+ * refresh dynamic weights, check grid health, cancel dust orders,
+ * apply divergence corrections, and fix spread conditions.
+ * @param {import('./dexbot_class').DEXBot} bot
+ * @param {string} context - Context label for logging (e.g. 'periodic', 'dust-timer')
+ * @returns {Promise<void>}
+ */
+declare function executeMaintenanceLogic(bot: any, context: any): Promise<void>;
+/**
+ * Cancel dust orders immediately — no delay, no timer, no maps.
+ * Each dust order is cancelled on chain and its slot is rotated through
+ * the normal synthetic-fill pipeline. Failures are logged and retried on
+ * the next detection cycle (next fill batch or 5-min health check).
+ * @param {import('./dexbot_class').DEXBot} bot
+ * @param {Object} [options] - Dust cancellation options
+ * @param {import('./types').Order[]} [options.buy=[]] - Buy-side dust orders
+ * @param {import('./types').Order[]} [options.sell=[]] - Sell-side dust orders
+ * @param {boolean} [options.fillLockAlreadyHeld=false] - Skip fill-processing lock re-entry (caller already holds it)
+ * @returns {Promise<{cancelledCount: number, batchResult: {aborted: boolean}|null}>}
+ */
+declare function cancelDustOrders(bot: any, { buy: buyDust, sell: sellDust, fillLockAlreadyHeld }?: {
+    buy?: any[];
+    sell?: any[];
+    fillLockAlreadyHeld?: boolean;
+}): Promise<{
+    cancelledCount: number;
+    batchResult: {
+        aborted: any;
+    };
+}>;
+/**
+ * Run grid maintenance with idle detection and lock acquisition.
+ * Checks if the bot is idle before proceeding, and acquires the fill processing lock.
+ * @param {import('./dexbot_class').DEXBot} bot
+ * @param {string} [context='periodic'] - Context label for logging
+ * @param {Object} [options] - Maintenance options
+ * @param {boolean} [options.fillLockAlreadyHeld=false] - Skip fill lock acquisition if already held
+ * @param {boolean} [options.skipIdle=false] - Skip idle delay check
+ * @returns {Promise<void>}
+ */
+declare function runGridMaintenance(bot: any, context?: string, options?: {
+    fillLockAlreadyHeld?: boolean;
+    skipIdle?: boolean;
+}): Promise<void>;
+/**
+ * Check if the bot's BTS balance is below the minimum threshold and trigger acquisition.
+ * Only applies to non-BTS pairs. Uses hysteresis: triggers at 1× min_BTS_value,
+ * fills to BTS_ACQUIRE_TARGET_MULTIPLIER × min_BTS_value.
+ * @param {import('./dexbot_class').DEXBot} bot
+ * @returns {Promise<void>}
+ */
+declare function checkBtsBalanceAndAcquire(bot: any): Promise<void>;
+/**
+ * Acquire BTS by swapping one of the trading pair assets through an AMM pool.
+ * Tries both assets for a BTS pool, picks the best (lowest price impact).
+ * @param {import('./dexbot_class').DEXBot} bot
+ * @param {number} deficit - Amount of BTS needed (float)
+ * @returns {Promise<void>}
+ */
+declare function acquireBts(bot: any, deficit: any): Promise<void>;
+declare const _default: {
+    loadBotsConfigSnapshot: typeof loadBotsConfigSnapshot;
+    refreshDynamicWeightDistribution: typeof refreshDynamicWeightDistribution;
+    performGridResync: typeof performGridResync;
+    updateBotGridResetMetadata: typeof updateBotGridResetMetadata;
+    handlePendingTriggerReset: typeof handlePendingTriggerReset;
+    setupTriggerFileDetection: typeof setupTriggerFileDetection;
+    performPeriodicGridChecks: typeof performPeriodicGridChecks;
+    isOpenOrdersSyncLoopEnabled: typeof isOpenOrdersSyncLoopEnabled;
+    startOpenOrdersSyncLoop: typeof startOpenOrdersSyncLoop;
+    stopOpenOrdersSyncLoop: typeof stopOpenOrdersSyncLoop;
+    setupBlockchainFetchInterval: typeof setupBlockchainFetchInterval;
+    stopBlockchainFetchInterval: typeof stopBlockchainFetchInterval;
+    executeMaintenanceLogic: typeof executeMaintenanceLogic;
+    cancelDustOrders: typeof cancelDustOrders;
+    isOrderDoesNotExistError: typeof isOrderDoesNotExistError;
+    runGridMaintenance: typeof runGridMaintenance;
+    stopMarketAdapterPm2: typeof stopMarketAdapterPm2;
+    releaseMarketAdapterRuntime: typeof releaseMarketAdapterRuntime;
+    syncMarketAdapterOnPeriodicConfigCheck: typeof syncMarketAdapterOnPeriodicConfigCheck;
+    findSnapshotBotForRuntimeConfig: typeof findSnapshotBotForRuntimeConfig;
+    runtimeConfigNeedsMarketAdapter: typeof runtimeConfigNeedsMarketAdapter;
+    usesAmaGridPrice: typeof usesAmaGridPrice;
+    checkBtsBalanceAndAcquire: typeof checkBtsBalanceAndAcquire;
+    acquireBts: typeof acquireBts;
+};
+export = _default;
+//# sourceMappingURL=dexbot_maintenance_runtime.d.ts.map

package/dist/modules/dexbot_maintenance_runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dexbot_maintenance_runtime.d.ts","sourceRoot":"","sources":["../../modules/dexbot_maintenance_runtime.ts"],"names":[],"mappings":"AAwEA;;;;GAIG;AACH,iBAAS,gBAAgB,CAAC,GAAG,KAAA,WAG5B;AAED;;;;;;GAMG;AACH,iBAAS,+BAA+B,CAAC,QAAQ,KAAA,EAAE,MAAM,KAAA,OAaxD;AAED;;;;;GAKG;AACH,iBAAS,+BAA+B,CAAC,QAAQ,KAAA,EAAE,MAAM,KAAA,WAMxD;AA8HD;;;GAGG;AACH,iBAAS,sBAAsB;;;;;;;;;;;;EAgC9B;AAuGD;;;GAGG;AACH,iBAAe,oBAAoB,kBAElC;AAED;;;;;;GAMG;AACH,iBAAe,sCAAsC,CAAC,GAAG,KAAA,EAAE,OAAO,SAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4I9E;AAED;;;;;;GAMG;AACH,iBAAS,gCAAgC,CAAC,GAAG,KAAA,EAAE,OAAO,SAAY;;;;;;;;;;EA+DjE;AAyHD;;;;;;;GAOG;AACH,iBAAS,0BAA0B,CAAC,MAAM,KAAA,EAAE,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAO,OA0BnG;AAED;;;;;;GAMG;AACH,iBAAS,iBAAiB,CAAC,GAAG,KAAA,EAAE,OAAO,GAAE;IACrC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;CACnB,oBAsGL;AAED;;;;;GAKG;AACH,iBAAe,yBAAyB,CAAC,GAAG,KAAA,oBAkB3C;AAED;;;;;GAKG;AACH,iBAAe,yBAAyB,CAAC,GAAG,KAAA,iBAkD3C;AAED;;;;;GAKG;AACH,iBAAe,yBAAyB,CAAC,GAAG,KAAA,iBAM3C;AAED;;;;GAIG;AACH,iBAAS,2BAA2B,CAAC,GAAG,KAAA,WAKvC;AAED;;;;GAIG;AACH,iBAAS,uBAAuB,CAAC,GAAG,KAAA,QA0DnC;AAED;;;;GAIG;AACH,iBAAe,sBAAsB,CAAC,GAAG,KAAA,iBAKxC;AAED;;;;GAIG;AACH,iBAAS,4BAA4B,CAAC,GAAG,KAAA,QAsHxC;AAED;;;GAGG;AACH,iBAAS,2BAA2B,CAAC,GAAG,KAAA,QAMvC;AAED;;;;;;;GAOG;AACH,iBAAe,2BAA2B,CAAC,GAAG,KAAA,EAAE,KAAK,KAAA,EAAE,OAAO,SAAa,gBAiB1E;AAID;;;;;GAKG;AACH,iBAAS,wBAAwB,CAAC,OAAO,KAAA,EAAE,OAAO,KAAA,WAYjD;AAyGD;;;;;;;GAOG;AACH,iBAAe,uBAAuB,CAAC,GAAG,KAAA,EAAE,OAAO,KAAA,iBA6GlD;AAED;;;;;;;;;;;GAWG;AACH,iBAAe,gBAAgB,CAAC,GAAG,KAAA,EAAE,EAAE,GAAG,EAAE,OAAY,EAAE,IAAI,EAAE,QAAa,EAAE,mBAA2B,EAAE;;;;CAAK;;;;;GAyChH;AAED;;;;;;;;;GASG;AACH,iBAAe,kBAAkB,CAC7B,GAAG,KAAA,EACH,OAAO,SAAa,EACpB,OAAO,GAAE;IAAE,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAO,iBAkDtE;AAID;;;;;;GAMG;AACH,iBAAe,yBAAyB,CAAC,GAAG,KAAA,iBAoD3C;AAED;;;;;;GAMG;AACH,iBAAe,UAAU,CAAC,GAAG,KAAA,EAAE,OAAO,KAAA,iBAmFrC;;;;;;;;;;;;;;;;;;;;;;;;;;;AAED,kBAyBE"}