dexbot 1.4.12 → 1.4.14

package/dist/modules/dexbot_class.d.ts

@@ -18,18 +18,29 @@
  * ===============================================================================
  *
  * LIFECYCLE METHODS:
- *   - constructor(config) - Initialize bot with configuration
- *   - run() - Start bot operation loop
+ *   - constructor(config, options) - Initialize bot with configuration
+ *   - start(vaultSecret) / startWithPrivateKey(privateKey) - Start bot operation loop
+ *   - initialize(vaultSecret) - Shared startup initialization
  *   - shutdown() - Graceful shutdown
  *
+ * ORDER & GRID OPERATIONS:
+ *   - placeInitialOrders() - Place initial grid orders
+ *   - updateOrdersOnChainBatch(rebalanceResult) / updateOrdersOnChainPlan(plan) - Apply rebalance plans
+ *   - requestGridReset(reason, options) - Request a grid reset
+ *   - getMetrics() - Expose runtime metrics
+ *
  * FILL PROCESSING:
- *   - processFills() - Handle fill events
+ *   - _processFillsWithBootstrapMode(chainOrders) - Fill queue drain + bootstrap-mode fills
+ *     (core fill pipeline lives in dexbot_fill_runtime.ts)
  *
- * SYNCHRONIZATION:
- *   - reconcileGrid() - Reconcile grid state with blockchain
+ * SYNCHRONIZATION & MAINTENANCE:
+ *   - _executeMaintenanceLogic(context) / _runGridMaintenance(context) - Periodic
+ *     maintenance and grid checks (implemented in dexbot_maintenance_runtime.ts)
+ *   - _runDustHealthCheck() / _setupDustHealthCheckInterval() - Dust health monitoring
  *
- * MONITORING:
- *   - monitorHealth() - Check bot health status
+ * STATE RECOVERY:
+ *   - _recoverFromPersistedGrid() - Reload grid from on-disk snapshot
+ *     (implementation in dexbot_state_recovery.ts)
  *
  * ===============================================================================
  *
@@ -97,6 +108,7 @@ declare class DEXBot {
     _creditRuntime: any;
     _creditWatchdogInterval: any;
     _batchInFlight: number;
+    _cowBroadcastInFlight: boolean;
     _recoverySyncInFlight: number;
     _lastTargetedDriftSyncAt: number;
     _lightweightSyncCheckAt: number;
@@ -252,8 +264,9 @@ declare class DEXBot {
      * with current chain state. Mirrors the startup recovery path.
      *
      * LOCK SAFETY: Does NOT acquire _fillProcessingLock. Caller must either
-     * hold it already or accept concurrent fill-processing risk — matches
-     * the startup pattern at line ~1340.
+     * hold it already or accept concurrent fill-processing risk — the sole
+     * call site is the structural resync path in
+     * dexbot_maintenance_runtime.ts.
      *
      * @returns {Promise<{success: boolean, reason?: string}>}
      */
@@ -314,12 +327,6 @@ declare class DEXBot {
      * @returns {Promise<void>}
      */
     _flushProcessedFillPersistenceForKeys(fillKeys: any, reason?: any, options?: any): Promise<void>;
-    /**
-     * Discard pending persistence for specific fill keys.
-     * @param {string[]|Set<string>} fillKeys - Fill keys to discard
-     * @returns {void}
-     */
-    _discardPendingProcessedFillPersistence(fillKeys: any): void;
     /**
      * Build a fallback deduplication key for an orphan fill (when standard keys are unavailable).
      * @param {Object} fill - Fill event object
@@ -327,50 +334,6 @@ declare class DEXBot {
      */
     _buildOrphanFillFallbackKey(fill: any): string | null;
     _isNewFillKey(fillKey: any, processedFillKeys: any, label?: any, orderId?: any): boolean;
-    /**
-     * Apply replay-safe fill accounting using a provided fill key.
-     * @param {Object} fill - Fill event object
-     * @param {import('./types.js').FillOperationData} fillOp - Fill operation data
-     * @param {Object} [options={}] - Options
-     * @param {string} [options.missingKeyMessage]
-     * @param {string} [options.fallbackKeyMessage]
-     * @param {string} [options.replayMessage]
-     * @param {string} [options.errorMessage]
-     * @param {Object} [options.logger]
-     * @param {string} [options.missingKeyLevel='warn']
-     * @param {string} [options.fallbackKeyLevel='warn']
-     * @param {string} [options.replayLevel='debug']
-     * @param {string} [options.persistenceMode='immediate']
-     * @param {boolean} [options.allowOrphanFallbackKey=false]
-     * @returns {Promise<import('./types.js').ReplaySafeFillResult>}
-     */
-    _applyReplaySafeFillAccounting(fill: any, fillOp: any, { missingKeyMessage, fallbackKeyMessage, replayMessage, errorMessage, logger, missingKeyLevel, fallbackKeyLevel, replayLevel, persistenceMode, allowOrphanFallbackKey }?: {
-        missingKeyMessage?: any;
-        fallbackKeyMessage?: any;
-        replayMessage?: any;
-        errorMessage?: any;
-        logger?: any;
-        missingKeyLevel?: string;
-        fallbackKeyLevel?: string;
-        replayLevel?: string;
-        persistenceMode?: any;
-        allowOrphanFallbackKey?: boolean;
-    }): Promise<{
-        status: string;
-        fillKey: any;
-        usedFallbackKey?: undefined;
-        error?: undefined;
-    } | {
-        status: string;
-        fillKey: any;
-        usedFallbackKey: boolean;
-        error?: undefined;
-    } | {
-        status: string;
-        fillKey: any;
-        error: any;
-        usedFallbackKey?: undefined;
-    }>;
     /**
      * Apply replay-safe fill accounting for tracked fills (those with a valid grid order).
      * @param {Object} fill - Fill event object
@@ -483,7 +446,6 @@ declare class DEXBot {
         hasUnmatched: any;
         openOrders: any[];
     }>;
-    _maxConsecutiveFillConsumerFailures(): any;
     /**
      * Compute the backoff delay for fill-consumer retries after the failure
      * budget (MAX_CONSECUTIVE_CONSUMER_FAILURES) is exhausted. Each retry
@@ -493,7 +455,6 @@ declare class DEXBot {
      * @returns {number} Delay in milliseconds before the next retry.
      * @private
      */
-    _computeFillConsumerBackoffMs(failures: any): number;
     _scheduleFillConsumerRestart(chainOrders: any): void;
     /**
      * Consume queued fills from incomingFillQueue and rebalance.
@@ -513,15 +474,18 @@ declare class DEXBot {
      * Process fills during bootstrap phase using the standard fill pipeline.
      *
      * BOOTSTRAP MODE STRATEGY:
-     * - Delegate to the same fill pipeline as the post-reset path
-     * - Same-side replacement at the filled slot (handled by processFillsOnly)
-     * - Symmetric grid regen via COW rebalance (calculateTargetGrid + reconcileGrid)
-     * - Dust orders are cancelled by the rebalance's isCreateHealthy / cancelSurpluses
+     * - Drain _incomingFillQueue and classify fills against the master grid
+     * - Orphan fills (no matching grid order) are swept via processSweepOrphanFill
+     * - Tracked fills go through replay-safe accounting (_applyReplaySafeTrackedFillAccounting)
+     * - Fills missing replay-safe history identifiers trigger a guarded open-orders
+     *   sync fallback instead of a potentially truncated get_full_accounts read
+     * - Valid fills are handed to the standard batching/COW rebalance pipeline
+     *   (_processFillsWithBatching), which restores grid symmetry and cancels dust
      *
      * This ensures:
      * - Identical behavior between bootstrap and post-reset
      * - Grid symmetry maintained by the rebalance, not by manual rotation
-     * - Budget safety enforced by validateWorkingGridFunds in the COW engine
+     * - Budget safety enforced by the COW engine's validateWorkingGridFunds
      *
      * @param {Object} chainOrders - Chain orders instance for broadcasting
      * @returns {Promise<void>}
@@ -718,8 +682,7 @@ declare class DEXBot {
      * @param {Array<Object>} opContexts - Original opContexts from the failed batch
      * @returns {Promise<Object>} Result object compatible with batch return shape
      */
-    _reconcileAfterUncertainBroadcast(err: any, opContexts: any, options?: Record<string, any>): Promise<any>;
-    _reconcileAfterUncertainBroadcastImpl(err: any, opContexts: any, options: any): Promise<{
+    _reconcileAfterUncertainBroadcast(err: any, opContexts: any, options?: Record<string, any>): Promise<{
         executed: boolean;
         hadRotation: boolean;
         uncertain: boolean;
@@ -1169,16 +1132,16 @@ declare class DEXBot {
      * Consolidates maintenance checks used during startup, periodic updates, and post-fill.
      *
      * ENTRY POINTS:
-     * 1. Startup (line ~681): After grid initialization, ensures grid is healthy
-     * 2. Periodic (line ~2682): Every BLOCKCHAIN_FETCH_INTERVAL_MIN (default 240 min)
-     * 3. Post-Fill (line ~1059): After order fills are rotated
+     * 1. Startup (dexbot_startup_runtime.ts): After grid initialization, ensures grid is healthy
+     * 2. Periodic (dexbot_maintenance_runtime.ts): Every BLOCKCHAIN_FETCH_INTERVAL_MIN (default 240 min)
+     * 3. Post-Fill (dexbot_fill_runtime.ts): After order fills are rotated
      *
      * PIPELINE PROTECTION:
      * All maintenance operations inside _executeMaintenanceLogic respect isPipelineEmpty().
      * This prevents grid modifications while fills/rotations/corrections are pending.
      * See _executeMaintenanceLogic documentation for detailed rationale.
      *
-     * LOCK ORDERING (see manager.ts:389 for full hierarchy):
+     * LOCK ORDERING (see modules/order/grid_reconcile.ts for full hierarchy):
      * - Canonical: _fillProcessingLock(0) → _divergenceLock(1)
      * - When called from post-fill context, Level 0 is already held
      * - When called from periodic context, both levels 0→1 must be acquired

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

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

package/dist/modules/dexbot_class.js

@@ -18,18 +18,29 @@
  * ===============================================================================
  *
  * LIFECYCLE METHODS:
- *   - constructor(config) - Initialize bot with configuration
- *   - run() - Start bot operation loop
+ *   - constructor(config, options) - Initialize bot with configuration
+ *   - start(vaultSecret) / startWithPrivateKey(privateKey) - Start bot operation loop
+ *   - initialize(vaultSecret) - Shared startup initialization
  *   - shutdown() - Graceful shutdown
  *
+ * ORDER & GRID OPERATIONS:
+ *   - placeInitialOrders() - Place initial grid orders
+ *   - updateOrdersOnChainBatch(rebalanceResult) / updateOrdersOnChainPlan(plan) - Apply rebalance plans
+ *   - requestGridReset(reason, options) - Request a grid reset
+ *   - getMetrics() - Expose runtime metrics
+ *
  * FILL PROCESSING:
- *   - processFills() - Handle fill events
+ *   - _processFillsWithBootstrapMode(chainOrders) - Fill queue drain + bootstrap-mode fills
+ *     (core fill pipeline lives in dexbot_fill_runtime.ts)
  *
- * SYNCHRONIZATION:
- *   - reconcileGrid() - Reconcile grid state with blockchain
+ * SYNCHRONIZATION & MAINTENANCE:
+ *   - _executeMaintenanceLogic(context) / _runGridMaintenance(context) - Periodic
+ *     maintenance and grid checks (implemented in dexbot_maintenance_runtime.ts)
+ *   - _runDustHealthCheck() / _setupDustHealthCheckInterval() - Dust health monitoring
  *
- * MONITORING:
- *   - monitorHealth() - Check bot health status
+ * STATE RECOVERY:
+ *   - _recoverFromPersistedGrid() - Reload grid from on-disk snapshot
+ *     (implementation in dexbot_state_recovery.ts)
  *
  * ===============================================================================
  *
@@ -119,6 +130,7 @@ class DEXBot {
     _creditRuntime;
     _creditWatchdogInterval;
     _batchInFlight;
+    _cowBroadcastInFlight;
     _recoverySyncInFlight;
     _lastTargetedDriftSyncAt;
     _lightweightSyncCheckAt;
@@ -211,6 +223,12 @@ class DEXBot {
         this._creditWatchdogInterval = null;
         // Pipeline state flags (used by maintenance gating)
         this._batchInFlight = 0;
+        // Single-flight COW broadcast guard: set while a COW batch is actually
+        // broadcasting/committing so no second batch can broadcast concurrently
+        // (two overlapping broadcasts would collide on the base grid version at
+        // commit time, forcing a commit refusal + snapshot reload that can drop
+        // placed orders and produce orphan fills).
+        this._cowBroadcastInFlight = false;
         this._recoverySyncInFlight = 0;
         this._lastTargetedDriftSyncAt = 0;
         this._lightweightSyncCheckAt = 0;
@@ -221,7 +239,8 @@ class DEXBot {
         this._currentCycleId = 0;
         this._autoCancelOrphanCycleMarker = null;
         this._autoCancelOrphanSubCount = 0;
-        // Dust cancellation uses immediate on-chain cancel — no maps or timers needed.
+        // Dust cancellation is driven by the periodic dust health-check timer
+        // (setupDustHealthCheckInterval) rather than per-dust state maps.
         this._dustHealthCheckTimer = null;
         // Fill consumer watchdog: consecutive failure tracking.
         // Reset on successful consumption; above _maxConsumeFailures, the
@@ -407,8 +426,9 @@ class DEXBot {
      * with current chain state. Mirrors the startup recovery path.
      *
      * LOCK SAFETY: Does NOT acquire _fillProcessingLock. Caller must either
-     * hold it already or accept concurrent fill-processing risk — matches
-     * the startup pattern at line ~1340.
+     * hold it already or accept concurrent fill-processing risk — the sole
+     * call site is the structural resync path in
+     * dexbot_maintenance_runtime.ts.
      *
      * @returns {Promise<{success: boolean, reason?: string}>}
      */
@@ -471,14 +491,6 @@ class DEXBot {
     async _flushProcessedFillPersistenceForKeys(fillKeys, reason = 'manual-selected', options = {}) {
         return DexbotFillRuntime.flushProcessedFillPersistenceForKeys(this, fillKeys, reason, options);
     }
-    /**
-     * Discard pending persistence for specific fill keys.
-     * @param {string[]|Set<string>} fillKeys - Fill keys to discard
-     * @returns {void}
-     */
-    _discardPendingProcessedFillPersistence(fillKeys) {
-        return DexbotFillRuntime.discardPendingProcessedFillPersistence(this, fillKeys);
-    }
     /**
      * Build a fallback deduplication key for an orphan fill (when standard keys are unavailable).
      * @param {Object} fill - Fill event object
@@ -505,37 +517,6 @@ class DEXBot {
         this._recentlyQueuedFills.set(fillKey, now);
         return true;
     }
-    /**
-     * Apply replay-safe fill accounting using a provided fill key.
-     * @param {Object} fill - Fill event object
-     * @param {import('./types.js').FillOperationData} fillOp - Fill operation data
-     * @param {Object} [options={}] - Options
-     * @param {string} [options.missingKeyMessage]
-     * @param {string} [options.fallbackKeyMessage]
-     * @param {string} [options.replayMessage]
-     * @param {string} [options.errorMessage]
-     * @param {Object} [options.logger]
-     * @param {string} [options.missingKeyLevel='warn']
-     * @param {string} [options.fallbackKeyLevel='warn']
-     * @param {string} [options.replayLevel='debug']
-     * @param {string} [options.persistenceMode='immediate']
-     * @param {boolean} [options.allowOrphanFallbackKey=false]
-     * @returns {Promise<import('./types.js').ReplaySafeFillResult>}
-     */
-    async _applyReplaySafeFillAccounting(fill, fillOp, { missingKeyMessage, fallbackKeyMessage, replayMessage, errorMessage, logger = this.manager?.logger, missingKeyLevel = 'warn', fallbackKeyLevel = 'warn', replayLevel = 'debug', persistenceMode = PROCESSED_FILL_PERSISTENCE_MODES.IMMEDIATE, allowOrphanFallbackKey = false } = {}) {
-        return DexbotFillRuntime.applyReplaySafeFillAccounting(this, fill, fillOp, {
-            missingKeyMessage,
-            fallbackKeyMessage,
-            replayMessage,
-            errorMessage,
-            logger,
-            missingKeyLevel,
-            fallbackKeyLevel,
-            replayLevel,
-            persistenceMode,
-            allowOrphanFallbackKey
-        });
-    }
     /**
      * Apply replay-safe fill accounting for tracked fills (those with a valid grid order).
      * @param {Object} fill - Fill event object
@@ -610,9 +591,6 @@ class DEXBot {
     async _syncOpenOrdersAndProcessFills(tag) {
         return DexbotMaintenanceRuntime.syncOpenOrdersAndProcessFills(this, tag);
     }
-    _maxConsecutiveFillConsumerFailures() {
-        return DexbotFillRuntime.maxConsecutiveFillConsumerFailures(this);
-    }
     /**
      * Compute the backoff delay for fill-consumer retries after the failure
      * budget (MAX_CONSECUTIVE_CONSUMER_FAILURES) is exhausted. Each retry
@@ -622,9 +600,6 @@ class DEXBot {
      * @returns {number} Delay in milliseconds before the next retry.
      * @private
      */
-    _computeFillConsumerBackoffMs(failures) {
-        return DexbotFillRuntime.computeFillConsumerBackoffMs(this, failures);
-    }
     _scheduleFillConsumerRestart(chainOrders) {
         DexbotFillRuntime.scheduleFillConsumerRestart(this, chainOrders);
     }
@@ -648,15 +623,18 @@ class DEXBot {
      * Process fills during bootstrap phase using the standard fill pipeline.
      *
      * BOOTSTRAP MODE STRATEGY:
-     * - Delegate to the same fill pipeline as the post-reset path
-     * - Same-side replacement at the filled slot (handled by processFillsOnly)
-     * - Symmetric grid regen via COW rebalance (calculateTargetGrid + reconcileGrid)
-     * - Dust orders are cancelled by the rebalance's isCreateHealthy / cancelSurpluses
+     * - Drain _incomingFillQueue and classify fills against the master grid
+     * - Orphan fills (no matching grid order) are swept via processSweepOrphanFill
+     * - Tracked fills go through replay-safe accounting (_applyReplaySafeTrackedFillAccounting)
+     * - Fills missing replay-safe history identifiers trigger a guarded open-orders
+     *   sync fallback instead of a potentially truncated get_full_accounts read
+     * - Valid fills are handed to the standard batching/COW rebalance pipeline
+     *   (_processFillsWithBatching), which restores grid symmetry and cancels dust
      *
      * This ensures:
      * - Identical behavior between bootstrap and post-reset
      * - Grid symmetry maintained by the rebalance, not by manual rotation
-     * - Budget safety enforced by validateWorkingGridFunds in the COW engine
+     * - Budget safety enforced by the COW engine's validateWorkingGridFunds
      *
      * @param {Object} chainOrders - Chain orders instance for broadcasting
      * @returns {Promise<void>}
@@ -712,7 +690,7 @@ class DEXBot {
                     throw err;
                 }
                 this._warn(`Auto-selection of preferredAccount failed: ${getErrorMessage(err)}`);
-                // dexbot.ts has fallback to selectAccount, bot.ts throws
+                // Fallback: interactive selectAccount (shared by dexbot.ts and bot.ts entry points)
                 if (typeof chainOrders.selectAccount === 'function') {
                     const accountData = await chainOrders.selectAccount();
                     this.privateKey = accountData.privateKey;
@@ -929,9 +907,6 @@ class DEXBot {
     async _reconcileAfterUncertainBroadcast(err, opContexts, options = {}) {
         return cowRuntime.reconcileAfterUncertainBroadcast(this, err, opContexts, options);
     }
-    async _reconcileAfterUncertainBroadcastImpl(err, opContexts, options) {
-        return cowRuntime.reconcileAfterUncertainBroadcastImpl(this, err, opContexts, options);
-    }
     /**
      * Auto-cancel a price-drift orphan from the unmatched-order snapshot.
      *
@@ -1739,16 +1714,16 @@ class DEXBot {
      * Consolidates maintenance checks used during startup, periodic updates, and post-fill.
      *
      * ENTRY POINTS:
-     * 1. Startup (line ~681): After grid initialization, ensures grid is healthy
-     * 2. Periodic (line ~2682): Every BLOCKCHAIN_FETCH_INTERVAL_MIN (default 240 min)
-     * 3. Post-Fill (line ~1059): After order fills are rotated
+     * 1. Startup (dexbot_startup_runtime.ts): After grid initialization, ensures grid is healthy
+     * 2. Periodic (dexbot_maintenance_runtime.ts): Every BLOCKCHAIN_FETCH_INTERVAL_MIN (default 240 min)
+     * 3. Post-Fill (dexbot_fill_runtime.ts): After order fills are rotated
      *
      * PIPELINE PROTECTION:
      * All maintenance operations inside _executeMaintenanceLogic respect isPipelineEmpty().
      * This prevents grid modifications while fills/rotations/corrections are pending.
      * See _executeMaintenanceLogic documentation for detailed rationale.
      *
-     * LOCK ORDERING (see manager.ts:389 for full hierarchy):
+     * LOCK ORDERING (see modules/order/grid_reconcile.ts for full hierarchy):
      * - Canonical: _fillProcessingLock(0) → _divergenceLock(1)
      * - When called from post-fill context, Level 0 is already held
      * - When called from periodic context, both levels 0→1 must be acquired