dexbot 1.6.5 → 1.6.6

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

@@ -12,63 +12,58 @@
  * - Detects and flags out-of-spread conditions
  *
  * ===============================================================================
- * TABLE OF CONTENTS - Grid Functions (27 exported functions)
+ * TABLE OF CONTENTS - Grid Functions (22 exported functions)
  * ===============================================================================
  *
- * CONFIGURATION & CALCULATION (1 method)
- *   1. calculateGapSlots(incrementPercent, targetSpreadPercent) - Calculate spread gap size
+ * CONFIGURATION & CALCULATION (2 functions)
+ *   1. resolveRmsThresholdPct(manager) - Resolve the structural-divergence threshold
+ *   2. calculateGapSlots(incrementPercent, targetSpreadPercent) - Calculate spread gap size
  *
- * GRID SIZING & CONTEXT (1 method)
- *   3. _getSizingContext(manager, side) - Get budget and sizing parameters (internal)
- *      Determines budget from allocated funds, deducts BTS fees if needed
+ * GRID SIZING & CONTEXT (1 function)
+ *   3. _getSizingContext(manager, side, options) - Get budget and sizing parameters
+ *      Determines budget from allocated funds and optionally deducts BTS fees
  *
- * GRID CREATION (1 method)
+ * GRID CREATION (1 function)
  *   4. createOrderGrid(config) - Create geometric price grid
  *      Returns price levels from minPrice to maxPrice with increment spacing
  *
- * ORDER CACHE MANAGEMENT (1 method - internal)
- *   5. _clearOrderCachesLogic(manager) - Clear order caches (_ordersByType, _ordersByState)
+ * GRID LOADING & INITIALIZATION (2 functions - async)
+ *   5. loadGrid(manager, grid, boundaryIdx, genesisInput, options) - Load grid into manager orders
+ *   6. initializeGrid(manager) - Full grid initialization from config
  *
- * GRID LOADING & INITIALIZATION (2 methods - async)
- *   6. loadGrid(manager, grid, boundaryIdx) - Load grid into manager orders
- *   7. initializeGrid(manager) - Full grid initialization from config
+ * GRID RECALCULATION (1 function - async)
+ *   7. recalculateGrid(manager, opts) - Recalculate grid based on current state
  *
- * GRID RECALCULATION (1 method - async)
- *   8. recalculateGrid(manager, opts) - Recalculate grid based on current state
+ * GRID STATE CHECKING (1 function)
+ *   8. checkAndUpdateGridIfNeeded(manager) - Check if grid needs update
  *
- * GRID STATE CHECKING (1 method)
- *   9. checkAndUpdateGridIfNeeded(manager) - Check if grid needs update
+ * BLOCKCHAIN SYNCHRONIZATION (2 functions - async)
+ *   9. _recalculateGridOrderSizesFromBlockchain(manager, orderType, options) - Recalculate sizes from blockchain
+ *   10. updateGridFromBlockchainSnapshot(manager, orderType, fromBlockchainTimer, overrideBoundaryIdx) - Update grid from blockchain
  *
- * BLOCKCHAIN SYNCHRONIZATION (2 methods - async)
- *   10. _recalculateGridOrderSizesFromBlockchain(manager, orderType) - Recalculate sizes from blockchain
- *   11. updateGridFromBlockchainSnapshot(manager, orderType, fromBlockchainTimer) - Update grid from blockchain
- *
- * GRID COMPARISON (2 methods - async)
- *   12. compareGrids(calculatedGrid, persistedGrid, manager) - Compare two grids
+ * GRID COMPARISON (2 functions - async)
+ *   11. compareGrids(calculatedGrid, persistedGrid, manager) - Compare two grids
  *       Validates grid structure and reports divergence metrics
- *   13. monitorDivergence(manager, calculatedGrid, persistedGrid) - Unified divergence check
+ *   12. monitorDivergence(manager, calculatedGrid, persistedGrid) - Unified divergence check
  *       Runs ratio-based + RMS-based checks and returns combined result
  *
- * ON-CHAIN ORDER FETCHING (1 method - async)
- *   14. _getOnChainOrders(manager) - Collect on-chain buy/sell orders from manager
- *
- * SPREAD MANAGEMENT (2 methods - async)
- *   15. calculateCurrentSpread(manager) - Calculate current bid-ask spread
- *   16. checkSpreadCondition(manager, BitShares, updateOrdersOnChainBatch) - Check and flag spread condition
+ * SPREAD MANAGEMENT (2 functions)
+ *   13. calculateCurrentSpread(manager) - Calculate current bid-ask spread
+ *   14. checkSpreadCondition(manager, BitShares, updateOrdersOnChainBatch) - Check and flag spread condition
  *
- * GRID HEALTH MONITORING (6 methods)
- *   17. checkGridHealth(manager, updateOrdersOnChainBatch) - Monitor grid health (async)
- *   18. checkWindowDust(manager) - Dust check scoped to the active buy/sell window (async)
- *   19. _hasAnyDust(manager, partials, type) - Check for dust orders (internal)
- *   20. hasAnyDust(manager, partials, side) - Check for dust orders (public)
- *   21. getDustOrders(manager, partials, side) - Get all dust order IDs (public)
- *   22. determineOrderSideByFunds(manager, currentMarketPrice) - Determine priority side
+ * GRID HEALTH MONITORING (4 functions)
+ *   15. checkGridHealth(manager, updateOrdersOnChainBatch) - Monitor grid health
+ *   16. checkWindowDust(manager) - Dust check scoped to the active buy/sell window
+ *   17. hasAnyDust(manager, partials, side) - Check for dust orders
+ *   18. getDustOrders(manager, partials, side) - Get dust order IDs
  *
- * SPREAD CORRECTION (1 method)
- *   23. prepareSpreadCorrectionOrders(manager, preferredSide) - Prepare correction orders
+ * SIDE SELECTION (1 function)
+ *   19. determineOrderSideByFunds(manager, currentMarketPrice) - Determine priority side
  *
- * DUST DETECTION (1 method - internal)
- *   25. _getDustOrders(manager, partials, type) - Internal dust detection helper
+ * BLOAT STATUS (3 functions)
+ *   20. isGridBloated(manager, orders) - Check whether the grid is bloated
+ *   21. isGridBloatGraceActive(manager) - Check the bloat grace state
+ *   22. clearGridBloatFlag(manager) - Clear the bloat state
  *
  * ===============================================================================
  *

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

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

package/dist/modules/order/grid.js

@@ -12,63 +12,58 @@
  * - Detects and flags out-of-spread conditions
  *
  * ===============================================================================
- * TABLE OF CONTENTS - Grid Functions (27 exported functions)
+ * TABLE OF CONTENTS - Grid Functions (22 exported functions)
  * ===============================================================================
  *
- * CONFIGURATION & CALCULATION (1 method)
- *   1. calculateGapSlots(incrementPercent, targetSpreadPercent) - Calculate spread gap size
+ * CONFIGURATION & CALCULATION (2 functions)
+ *   1. resolveRmsThresholdPct(manager) - Resolve the structural-divergence threshold
+ *   2. calculateGapSlots(incrementPercent, targetSpreadPercent) - Calculate spread gap size
  *
- * GRID SIZING & CONTEXT (1 method)
- *   3. _getSizingContext(manager, side) - Get budget and sizing parameters (internal)
- *      Determines budget from allocated funds, deducts BTS fees if needed
+ * GRID SIZING & CONTEXT (1 function)
+ *   3. _getSizingContext(manager, side, options) - Get budget and sizing parameters
+ *      Determines budget from allocated funds and optionally deducts BTS fees
  *
- * GRID CREATION (1 method)
+ * GRID CREATION (1 function)
  *   4. createOrderGrid(config) - Create geometric price grid
  *      Returns price levels from minPrice to maxPrice with increment spacing
  *
- * ORDER CACHE MANAGEMENT (1 method - internal)
- *   5. _clearOrderCachesLogic(manager) - Clear order caches (_ordersByType, _ordersByState)
+ * GRID LOADING & INITIALIZATION (2 functions - async)
+ *   5. loadGrid(manager, grid, boundaryIdx, genesisInput, options) - Load grid into manager orders
+ *   6. initializeGrid(manager) - Full grid initialization from config
  *
- * GRID LOADING & INITIALIZATION (2 methods - async)
- *   6. loadGrid(manager, grid, boundaryIdx) - Load grid into manager orders
- *   7. initializeGrid(manager) - Full grid initialization from config
+ * GRID RECALCULATION (1 function - async)
+ *   7. recalculateGrid(manager, opts) - Recalculate grid based on current state
  *
- * GRID RECALCULATION (1 method - async)
- *   8. recalculateGrid(manager, opts) - Recalculate grid based on current state
+ * GRID STATE CHECKING (1 function)
+ *   8. checkAndUpdateGridIfNeeded(manager) - Check if grid needs update
  *
- * GRID STATE CHECKING (1 method)
- *   9. checkAndUpdateGridIfNeeded(manager) - Check if grid needs update
+ * BLOCKCHAIN SYNCHRONIZATION (2 functions - async)
+ *   9. _recalculateGridOrderSizesFromBlockchain(manager, orderType, options) - Recalculate sizes from blockchain
+ *   10. updateGridFromBlockchainSnapshot(manager, orderType, fromBlockchainTimer, overrideBoundaryIdx) - Update grid from blockchain
  *
- * BLOCKCHAIN SYNCHRONIZATION (2 methods - async)
- *   10. _recalculateGridOrderSizesFromBlockchain(manager, orderType) - Recalculate sizes from blockchain
- *   11. updateGridFromBlockchainSnapshot(manager, orderType, fromBlockchainTimer) - Update grid from blockchain
- *
- * GRID COMPARISON (2 methods - async)
- *   12. compareGrids(calculatedGrid, persistedGrid, manager) - Compare two grids
+ * GRID COMPARISON (2 functions - async)
+ *   11. compareGrids(calculatedGrid, persistedGrid, manager) - Compare two grids
  *       Validates grid structure and reports divergence metrics
- *   13. monitorDivergence(manager, calculatedGrid, persistedGrid) - Unified divergence check
+ *   12. monitorDivergence(manager, calculatedGrid, persistedGrid) - Unified divergence check
  *       Runs ratio-based + RMS-based checks and returns combined result
  *
- * ON-CHAIN ORDER FETCHING (1 method - async)
- *   14. _getOnChainOrders(manager) - Collect on-chain buy/sell orders from manager
- *
- * SPREAD MANAGEMENT (2 methods - async)
- *   15. calculateCurrentSpread(manager) - Calculate current bid-ask spread
- *   16. checkSpreadCondition(manager, BitShares, updateOrdersOnChainBatch) - Check and flag spread condition
+ * SPREAD MANAGEMENT (2 functions)
+ *   13. calculateCurrentSpread(manager) - Calculate current bid-ask spread
+ *   14. checkSpreadCondition(manager, BitShares, updateOrdersOnChainBatch) - Check and flag spread condition
  *
- * GRID HEALTH MONITORING (6 methods)
- *   17. checkGridHealth(manager, updateOrdersOnChainBatch) - Monitor grid health (async)
- *   18. checkWindowDust(manager) - Dust check scoped to the active buy/sell window (async)
- *   19. _hasAnyDust(manager, partials, type) - Check for dust orders (internal)
- *   20. hasAnyDust(manager, partials, side) - Check for dust orders (public)
- *   21. getDustOrders(manager, partials, side) - Get all dust order IDs (public)
- *   22. determineOrderSideByFunds(manager, currentMarketPrice) - Determine priority side
+ * GRID HEALTH MONITORING (4 functions)
+ *   15. checkGridHealth(manager, updateOrdersOnChainBatch) - Monitor grid health
+ *   16. checkWindowDust(manager) - Dust check scoped to the active buy/sell window
+ *   17. hasAnyDust(manager, partials, side) - Check for dust orders
+ *   18. getDustOrders(manager, partials, side) - Get dust order IDs
  *
- * SPREAD CORRECTION (1 method)
- *   23. prepareSpreadCorrectionOrders(manager, preferredSide) - Prepare correction orders
+ * SIDE SELECTION (1 function)
+ *   19. determineOrderSideByFunds(manager, currentMarketPrice) - Determine priority side
  *
- * DUST DETECTION (1 method - internal)
- *   25. _getDustOrders(manager, partials, type) - Internal dust detection helper
+ * BLOAT STATUS (3 functions)
+ *   20. isGridBloated(manager, orders) - Check whether the grid is bloated
+ *   21. isGridBloatGraceActive(manager) - Check the bloat grace state
+ *   22. clearGridBloatFlag(manager) - Clear the bloat state
  *
  * ===============================================================================
  *
@@ -125,7 +120,7 @@ import { floatToBlockchainInt, getPrecisionByOrderType, getPrecisionsForManager,
 import { filterOrdersByType, checkSizesBeforeMinimum, checkSizeThreshold, resolveConfiguredPriceBound, shouldFlagOutOfSpread, isOrderHealthy, isPhantomOrder, isSlotAvailable, isOrderOnChain, isOrderPlaced, hasOnChainId, isEmptyGridSlot, parseSlotIndex, calculateIdealBoundary, assignGridRoles, resolveOnChainRetypeType, resolveReserveCount, reserveEdgeIdSet, resolveLiveReserveEdgeAnchorPrice } from './utils/order.js';
 import { loadAmaCenterPrice, loadAmaCenterSnapshot, withBlockchainRetry } from './utils/system.js';
 import * as MathUtils from './utils/math.js';
-import { derivePriceWithPoolRef } from './utils/withPoolRef.js';
+import { derivePriceWithPoolRef, resolveStartPriceMode } from './utils/withPoolRef.js';
 import { getWhitelistFlags } from '../market_adapter_whitelist.js';
 import { getErrorMessage } from '../utils/errors.js';
 const calculateGapSlots = _mathGapSlots;
@@ -954,9 +949,14 @@ export async function initializeGrid(manager) {
     if (typeof mpRaw !== 'number' || isNaN(mpRaw)) {
         try {
             const { BitShares } = require('../bitshares_client');
-            const derived = await derivePriceWithPoolRef(BitShares, manager.config.assetA, manager.config.assetB, manager.config.priceMode || 'auto', manager.config.poolRef);
+            // startPrice is the master price source: pass its own mode so a
+            // pinned poolRef only refines pool discovery. Without this,
+            // the old `priceMode || 'auto'` read (priceMode is never set in
+            // the runtime path) let a poolRef override startPrice:"book".
+            const startPriceMode = resolveStartPriceMode(mpRaw, manager.config.priceMode || 'auto');
+            const derived = await derivePriceWithPoolRef(BitShares, manager.config.assetA, manager.config.assetB, startPriceMode, manager.config.poolRef);
             if (derived) {
-                manager.logger?.log?.(`[DIAGNOSTIC] initializeGrid: Derived new startPrice=${derived.toFixed(8)} (mode=${manager.config.priceMode || 'auto'})`, 'info');
+                manager.logger?.log?.(`[DIAGNOSTIC] initializeGrid: Derived new startPrice=${derived.toFixed(8)} (mode=${startPriceMode})`, 'info');
                 manager.config.startPrice = Number(derived);
             }
             else {