dexbot 1.4.23 → 1.4.25

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

@@ -45,6 +45,7 @@ declare class OrderManager {
     _endOfBootstrapValidationDone: boolean;
     _broadcastingFlag: number;
     _broadcastingStartedAt: number;
+    _shuttingDown: boolean;
     _illegalStateSignal: any;
     _accountingFailureSignal: any;
     _recoveryStateValue: {
@@ -133,6 +134,10 @@ declare class OrderManager {
     _orphanFillsCreditedAt: number | null;
     _pendingRecovery: Promise<void> | null;
     _recentFillKeysSnapshot: Record<string, number> | null;
+    _lastFilledBuyPrice: number | null;
+    _lastFilledSellPrice: number | null;
+    _lastFilledPrice: number | null;
+    _lastFilledType: string | null;
     _metrics: any;
     private _currentWorkingGridStack;
     _cowEngine: any;
@@ -194,6 +199,19 @@ declare class OrderManager {
      * @returns {boolean}
      */
     isBroadcastingActive(): boolean;
+    /**
+     * Whether the owning bot has begun shutting down. Mirrors the
+     * bot-level `_shuttingDown` flag (set via setShuttingDown() from
+     * DEXBot._shutdownImpl) so manager-level wait loops can bail out
+     * instead of proceeding with broadcasts after shutdown completed.
+     * @returns {boolean}
+     */
+    isShuttingDown(): boolean;
+    /**
+     * @param {boolean} value
+     * @returns {void}
+     */
+    setShuttingDown(value: any): void;
     /**
      * Auto-clears a stale broadcast flag after 120s so a hung
      * broadcast cannot permanently block rebalancing.
@@ -534,22 +552,33 @@ declare class OrderManager {
      * disk-load).  This is the same write as _setBoundary but without the
      * lock-hold warning — loadGrid / initializeGrid are single-threaded at
      * startup and the boundary is being restored from a known-good snapshot,
-     * not committed alongside order mutations.
+     * not committed alongside order mutations. Accepts null to clear the
+     * boundary after a rejected persisted snapshot (P4) so re-derivation
+     * (P3) starts from a clean state.
      */
-    _restoreBoundary(newIdx: number): void;
+    _restoreBoundary(newIdx: number | null): void;
     /**
-     * DEFENSE-IN-DEPTH (runs after every COW commit): verify the committed
-     * state still has an intact gap band — implied geometry inside the slot
-     * array, and no placed order strictly inside the implied spread.
-     *
-     * This is a DETECTOR, not a guard: the grid is already committed when it
-     * runs.  Violations are logged loudly and flagged via _recoveryState
-     * (structuralResyncRequested) so the maintenance loop reconciles against
-     * the chain.  Purpose is any-writer detection — if a path other than the
-     * promotion clamp commits a boundary that invades the opposite rail or
-     * strands placed orders inside the spread, this fires.
+     * Observability (fix #4, docs/CONSOLIDATED_ORPHAN_FIX_SUMMARY.md §2): emit the live
+     * boundary whenever roles are (re)assigned, so a silent boundary crawl that
+     * re-rolls slots into the wrong rail is diagnosable in real time. Debug-level
+     * only; no behavioral effect.
+     */
+    _logBoundaryDebug(source: string, newIdx: number | null): void;
+    /**
+     * Record last filled price for side-gated guard: only the side of the most recent fill is gated
+     * (BUY after BUY must be lower, SELL after SELL must be higher). Spread-correction bypasses.
+     * Cold start (null) => disabled. Per-type fields kept for observability/back-compat.
+     * @param {Array} fills
      */
-    _assertGapBandIntactPostCommit(): void;
+    recordLastFilledPrices(fills: any): void;
+    /**
+     * Seed last-filled guard from the live book at startup. Book-derived
+     * (survives restart), analogous to the deleted MarketAnchor book-seed.
+     * Closes the in-memory-only window where LAST-FILL-GUARD would be
+     * disabled until the first fill arrives.
+     * @param {Array} chainOpenOrders - raw chain open orders (from readOpenOrdersGuarded)
+     */
+    seedLastFilledPricesFromBook(chainOpenOrders: any): void;
     /**
      * @returns {Object|null} The consumed signal or null
      */
@@ -622,12 +651,37 @@ declare class OrderManager {
             updates: any;
         };
     };
+    /**
+     * Wait (bounded) until any non-COW broadcast/placement activity — the
+     * refcounted _broadcastingFlag — has released. Startup/structural
+     * reconcile Phase-2 placement now holds this flag across its create/update
+     * groups; launching a fill-driven COW rebalance on top of it mutates the
+     * master mid-broadcast, forcing a commit refusal and leaving a
+     * previous-generation order set on chain as duplicate-price orphans
+     * that block placements until drained.
+     *
+     * The wait is capped: after the timeout the rebalance proceeds anyway —
+     * the existing commit-refusal + chain-adoption machinery remains the
+     * backstop, so the worst case equals the pre-guard behavior.
+     *
+     * @param {number} [timeoutMs]
+     * @returns {Promise<{waitedMs: number, timedOut: boolean}>}
+     */
+    _awaitBroadcastIdle(timeoutMs?: number): Promise<{
+        waitedMs: number;
+        timedOut: boolean;
+        shutdown: boolean;
+    }>;
     /**
      * @param {Array} [fills] - Fill events triggering rebalance
      * @param {Set<string>} [excludeIds] - Order IDs to exclude
+     * @param {Object} [options]
+     * @param {boolean} [options.skipBroadcastWait] - Set by the COW re-plan path,
+     *   which runs INSIDE its own startBroadcasting() region and must not wait
+     *   on the flag it holds itself.
      * @returns {Promise<any>}
      */
-    performSafeRebalance(fills?: any, excludeIds?: any): Promise<any>;
+    performSafeRebalance(fills?: any, excludeIds?: any, options?: any): Promise<any>;
     _applySafeRebalanceCOW(fills?: any, excludeIds?: any): Promise<any>;
     _getCowComparePrecisions(): {
         buyPrecision: number;

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

@@ -1 +1 @@
-{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../modules/order/manager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../modules/order/manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAiJH,cAAM,kBAAkB;IACpB,QAAQ,EAAE,GAAG,CAAC;IACd,MAAM,EAAE,GAAG,CAAC;IACZ,MAAM,EAAE,GAAG,CAAC;IACZ,MAAM,EAAE,GAAG,CAAC;gBAEA,IAAI,EAAE,GAAG;IAOf,OAAO,CAAC,EACV,UAAU,EACV,WAAW,EACX,WAAW,EACX,KAAK,EACL,KAAU,EACV,UAAsB,EACzB,EAAE,GAAG;;;;;;;;;;CAsHT;AAMD,cAAM,YAAY;IACd,MAAM,EAAE,GAAG,CAAC;IACZ,UAAU,EAAE,GAAG,CAAC;IAChB,MAAM,EAAE,GAAG,CAAC;IACZ,MAAM,EAAE,GAAG,CAAC;IACZ,WAAW,EAAE,GAAG,CAAC;IACjB,UAAU,EAAE,GAAG,CAAC;IAChB,UAAU,EAAE,GAAG,CAAC;IAChB,QAAQ,EAAE,GAAG,CAAC;IACd,IAAI,EAAE,GAAG,CAAC;IACV,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,6BAA6B,EAAE,OAAO,CAAC;IACvC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,aAAa,EAAE,OAAO,CAAC;IACvB,mBAAmB,EAAE,GAAG,CAAC;IACzB,wBAAwB,EAAE,GAAG,CAAC;IAC9B,mBAAmB,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,yBAAyB,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACnK,oBAAoB,EAAE;QAAE,GAAG,EAAE;YAAE,KAAK,EAAE,OAAO,CAAC;YAAC,eAAe,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,IAAI,EAAE;YAAE,KAAK,EAAE,OAAO,CAAC;YAAC,eAAe,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;IAC9H,OAAO,CAAC,kBAAkB,CAA4C;IACtE,OAAO,CAAC,mBAAmB,CAA4C;IACvE,OAAO,CAAC,yBAAyB,CAAc;IAC/C,OAAO,CAAC,0BAA0B,CAAc;IAEhD;;;;;;;;;;;;OAYG;IACH,IAAI,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAc/C;IACD,IAAI,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,EAGjD;IAED;;;OAGG;IACH,IAAI,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAchD;IACD,IAAI,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,EAGlD;IACD,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,GAAG,CAAC;IACZ,SAAS,EAAE,GAAG,CAAC;IACf,aAAa,EAAE,GAAG,CAAC;IACnB,KAAK,EAAE,GAAG,CAAC;IACX,qBAAqB,EAAE,GAAG,CAAC;IAC3B,qBAAqB,EAAE,GAAG,CAAC;IAC3B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,4BAA4B,EAAE,GAAG,EAAE,CAAC;IACpC,cAAc,EAAE,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC9B,oBAAoB,EAAE,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACpC,kBAAkB,EAAE,GAAG,CAAC;IACxB,SAAS,EAAE,GAAG,CAAC;IACf,mBAAmB,EAAE,GAAG,CAAC;IACzB,eAAe,EAAE,GAAG,CAAC;IACrB,SAAS,EAAE,GAAG,CAAC;IACf,SAAS,EAAE,GAAG,CAAC;IACf,wBAAwB,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;IACnC,iBAAiB,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;IAC5B,gBAAgB,EAAE,MAAM,CAAC;IACzB,wBAAwB,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,GAAG,IAAI,CAAC;IAC/D,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,2BAA2B,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,GAAG,IAAI,CAAC;IAClE,oBAAoB,EAAE,OAAO,CAAC;IAC9B,qBAAqB,EAAE,GAAG,CAAC;IAC3B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,+BAA+B,EAAE,GAAG,CAAC;IACrC,kBAAkB,EAAE,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAClC,kBAAkB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAChC,yBAAyB,EAAE,MAAM,CAAC;IAClC,kBAAkB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C,sBAAsB,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,gBAAgB,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACvC,uBAAuB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IACvD,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAK/B,QAAQ,EAAE,GAAG,CAAC;IACd,OAAO,CAAC,wBAAwB,CAAQ;IACxC,UAAU,EAAE,GAAG,CAAC;IAChB,aAAa,EAAE,GAAG,CAAC;IACnB,UAAU,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAE5D;;OAEG;gBACS,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM;IA+H5C,aAAa;IAYb,oBAAoB;IAOpB;;;;;;;;;OASG;IACH,mBAAmB,CAAC,WAAW,EAAE,GAAG,EAAE,MAAM,GAAE,GAAU;IASxD;;;;;;;;OAQG;IACH,kBAAkB,CAAC,MAAM,GAAE,GAAU;IAOrC;;;;;;;;OAQG;IACH,sBAAsB,CAAC,WAAW,EAAE,GAAG;IAOvC,kBAAkB,CAAC,KAAK,EAAE,GAAG;IAK7B,2BAA2B;IAM3B;;OAEG;IACH,aAAa;IAIb;;OAEG;IACH,eAAe;IAIf;;;OAGG;IACH,oBAAoB;IAIpB;;;;;;OAMG;IACH,cAAc;IAId;;;OAGG;IACH,eAAe,CAAC,KAAK,EAAE,GAAG;IAI1B;;;;;;;OAOG;IACH,wBAAwB;IAcxB;;;OAGG;IACH,gBAAgB;IAIhB;;OAEG;IACH,cAAc;IAQd;;OAEG;IACH,eAAe;;;;IA8Bf;;OAEG;IACH,iBAAiB;IAajB;;OAEG;IACH,gBAAgB;IAchB;;;;;OAKG;IACG,UAAU;IAMhB;;;;;;;;;OASG;IACH,qBAAqB;;;;kBA/XD,MAAM;mBAAS,MAAM;oBAAU,MAAM;;;;;;;;;;;IAmZzD;;;OAGG;IACG,oBAAoB,CAAC,SAAS,GAAE,GAAsC;IAwB5E;;;OAGG;IACG,kBAAkB,CAAC,SAAS,EAAE,GAAG;IAKvC;;;;;;;;;;;;OAYG;IACG,2BAA2B,CAAC,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO;;;;;;;IAiCnE;;;;;;;OAOG;IACH,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAOhD;;;;;;;;;;;;;OAaG;IACG,qBAAqB,CAAC,KAAK,SAAe;IAe1C,iCAAiC;IAIvC;;;OAGG;IACG,gBAAgB,CAAC,MAAM,GAAE,GAA8D;IAMvF,iBAAiB,CAAC,MAAM,EAAE,GAAG;IAiBnC,kCAAkC;IASlC;;OAEG;IACH,uBAAuB;IAyBvB;;OAEG;IACG,gBAAgB;IAMhB,iBAAiB;IAMvB;;;;;;;;;;;;;;;;;;OAkBG;IACH,eAAe;IA0Bf;;;;OAIG;IACG,gBAAgB;IAWtB;;;;;;;;;;;;;OAaG;IACH,kBAAkB;IAelB;;;OAGG;IACH,mBAAmB;IAQnB;;;;OAIG;IACH,kBAAkB,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG;IAIzC;;;;OAIG;IACH,mBAAmB,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG;IAI3C;;;;OAIG;IACH,wBAAwB,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG;IAIjD;;;;OAIG;IACG,oBAAoB,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG;IAMxC,UAAU,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG;IAI9B,iBAAiB;IAIvB;;;OAGG;IACH,UAAU,CAAC,QAAQ,EAAE,GAAG;IAOxB;;;OAGG;IACH,YAAY,CAAC,QAAQ,EAAE,GAAG;IAM1B;;;OAGG;IACH,aAAa,CAAC,EAAE,EAAE,GAAG;IAUrB,kBAAkB;IASlB,4BAA4B,CAAC,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM;;;;IAW9D,uBAAuB,CAAC,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM;;;IAOnD,YAAY,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,GAAE,GAAmB,EAAE,OAAO,GAAE,GAAQ;IAOxE,iBAAiB,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,GAAE,GAAmB,EAAE,OAAO,GAAE,GAAQ;IAuFnF;;;OAGG;IACH,IAAI,mBAAmB,IAAI,GAAG,CAE7B;IAED,IAAI,mBAAmB,CAAC,GAAG,EAAE,GAAG,EAI/B;IAED,gBAAgB,IAAI,GAAG;IAKvB,kCAAkC,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG;IAiB7D;;;;;OAKG;IACG,oBAAoB,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,GAAE,GAAoB,EAAE,OAAO,GAAE,GAAQ;IAmBzF;;;;;;;;OAQG;IACH,cAAc;IAMd;;;OAGG;IACH,eAAe;IAIf;;;;OAIG;IACH,WAAW;IAIX;;;;;;;;;;;;;OAaG;IACG,cAAc,CAAC,YAAY,GAAE,GAAwB;;;;;;;;;;;;;;;;;;;;IAgC3D;;;;;OAKG;IACG,mBAAmB,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG;IA8B/D;;OAEG;IACH,0BAA0B;IAiD1B;;;;;;OAMG;IACH,uBAAuB,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG;IAe7C;;;;;;;OAOG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAYlC;;;;;;;;OAQG;IACH,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAK7C;;;;;OAKG;IACH,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAyB9D;;;;;OAKG;IACH,sBAAsB,CAAC,KAAK,EAAE,GAAG,GAAG,IAAI;IAmBxC;;;;;;OAMG;IACH,4BAA4B,CAAC,eAAe,EAAE,GAAG,GAAG,IAAI;IAwCxD;;OAEG;IACH,yBAAyB;IAMzB;;OAEG;IACH,8BAA8B;IAM9B;;;;OAIG;IACG,oBAAoB,CAAC,SAAS,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG;IAIvD;;;OAGG;IACG,eAAe,CAAC,OAAO,EAAE,GAAG;IAIlC;;OAEG;IACH,sBAAsB;IAItB;;OAEG;IACH,wBAAwB;;;;;;;;;;;;;;;;;;IAOxB;;;OAGG;IACH,eAAe,CAAC,eAAe,GAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAK;;;;IA+CjE;;OAEG;IACH,4BAA4B;IAW5B;;;;OAIG;IACH,aAAa,CAAC,UAAU,EAAE,GAAG,EAAE,cAAc,EAAE,GAAG;;;;;;;;;;;IAOlD;;;;;;;;;;;;;;;OAeG;IACG,mBAAmB,CAAC,SAAS,GAAE,MAAc,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC;IAmCzH;;;;;;;;OAQG;IACG,oBAAoB,CAAC,KAAK,GAAE,GAAQ,EAAE,UAAU,GAAE,GAAe,EAAE,OAAO,GAAE,GAAQ;IAcpF,sBAAsB,CAAC,KAAK,GAAE,GAAQ,EAAE,UAAU,GAAE,GAAe;IA4BzE,wBAAwB;;;;;IAiClB,kBAAkB,CAAC,WAAW,EAAE,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,OAAO,GAAE,GAAQ;IAoKxG;;;;OAIG;IACH,+BAA+B,CAAC,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM;;;;;;;IAYjE;;;OAGG;IACH,sBAAsB,CAAC,MAAM,GAAE,GAAiB;IAIhD;;;OAGG;IACH,qBAAqB,CAAC,MAAM,GAAE,GAAU;IASxC;;;;;;;OAOG;IACG,WAAW,CAAC,cAAc,EAAE,GAAG,EAAE,cAAc,CAAC,EAAE,GAAG,EAAE,YAAY,CAAC,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,GAAG,CAAA;KAAE;;;;;;;;;;;;IAyDvH,IAAI,iBAAiB,QAEpB;IAED,IAAI,iBAAiB,CAAC,KAAK,KAAA,EAO1B;IAED,IAAI,sBAAsB,QAEzB;IAED,IAAI,sBAAsB,CAAC,KAAK,KAAA,EAO/B;IAED,IAAI,cAAc;eA17DY,MAAM;sBAAgB,MAAM;uBAAiB,MAAM;kBAAY,OAAO;uBAAiB,MAAM;oCAA8B,OAAO;MA47D/J;IAED,IAAI,cAAc,CAAC,KAAK;eA97DM,MAAM;sBAAgB,MAAM;uBAAiB,MAAM;kBAAY,OAAO;uBAAiB,MAAM;oCAA8B,OAAO;KA87DxI,EAavB;IAED,IAAI,eAAe;aA58DU;YAAE,KAAK,EAAE,OAAO,CAAC;YAAC,eAAe,EAAE,MAAM,CAAA;SAAE;cAAQ;YAAE,KAAK,EAAE,OAAO,CAAC;YAAC,eAAe,EAAE,MAAM,CAAA;SAAE;MA88D1H;IAED,IAAI,eAAe,CAAC,KAAK;aAh9DI;YAAE,KAAK,EAAE,OAAO,CAAC;YAAC,eAAe,EAAE,MAAM,CAAA;SAAE;cAAQ;YAAE,KAAK,EAAE,OAAO,CAAC;YAAC,eAAe,EAAE,MAAM,CAAA;SAAE;KAg9DlG,EAQxB;CAEJ;AAED,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,CAAA"}

package/dist/modules/order/manager.js

@@ -27,9 +27,9 @@ import SyncEngine from './sync_engine.js';
 import { calculateCurrentSpread, checkSpreadCondition, checkGridHealth } from './grid.js';
 import * as Format from './format.js';
 import { ORDER_TYPES, ORDER_STATES, REBALANCE_STATES, DEFAULT_CONFIG, TIMING, LOG_LEVEL, PIPELINE_TIMING, COW_PERFORMANCE, COW_ACTIONS } from '../constants.js';
-import { getMinOrderSize, computeChainFundTotals, hasValidAccountTotals, resolveConfigValueWithRegistry, isExplicitZeroAllocation, floatToBlockchainInt, validateBoundaryCommit, resolveGapSlots, resolveGapBand } from './utils/math.js';
+import { getMinOrderSize, computeChainFundTotals, hasValidAccountTotals, resolveConfigValueWithRegistry, isExplicitZeroAllocation, floatToBlockchainInt, validateBoundaryCommit, resolveGapSlots } from './utils/math.js';
 import { validateOrder, validateGridForPersistence, validateWorkingGridFunds, checkFundDrift, reconcileGrid, optimizeRebalanceActions, projectTargetToWorkingGrid, buildStateUpdates, buildAbortedResult, buildSuccessResult, evaluateCommit } from './utils/validate.js';
-import { resolveSpreadOrderSide, parseSlotIndex } from './utils/order.js';
+import { resolveSpreadOrderSide, parseSlotIndex, parseChainOrder } from './utils/order.js';
 import { getErrorMessage } from '../utils/errors.js';
 const { toFiniteNumber } = Format;
 // ===============================================================================
@@ -198,6 +198,25 @@ class COWRebalanceEngine {
             this.logger?.log(`[COW] Rebalance planning took ${duration}ms`, 'warn');
         }
         this.logger?.log(`[COW] Plan: Actions=${optimizedActions.length}, StateUpdates=${stateUpdates.length}`, 'info');
+        // Per-action plan detail. UPDATE/ROTATE ops are the dangerous ones —
+        // their target size/price must be visible in production logs without
+        // on-chain archaeology (a mis-sized update op is only diagnosable from
+        // the chain afterwards otherwise).
+        for (const a of optimizedActions) {
+            if (!a || !a.type || !a.id)
+                continue;
+            const size = Number.isFinite(Number(a.newSize))
+                ? Number(a.newSize)
+                : Number(a.order?.size);
+            const price = Number.isFinite(Number(a.newPrice))
+                ? Number(a.newPrice)
+                : Number(a.order?.price);
+            const rotationSuffix = (a.newGridId && a.newGridId !== a.id) ? ` -> ${a.newGridId}` : '';
+            const line = `[COW] Plan action: ${a.type} ${a.id}${rotationSuffix} ` +
+                `(orderId=${a.orderId || 'none'}, size=${Number.isFinite(size) ? Format.formatAmount(size) : 'n/a'}, ` +
+                `price=${Number.isFinite(price) ? Format.formatPrice6(price) : 'n/a'})`;
+            this.logger?.log(line, a.type === COW_ACTIONS.UPDATE ? 'info' : 'debug');
+        }
         return buildSuccessResult({
             actions: optimizedActions,
             stateUpdates,
@@ -225,6 +244,7 @@ class OrderManager {
     _endOfBootstrapValidationDone;
     _broadcastingFlag;
     _broadcastingStartedAt;
+    _shuttingDown;
     _illegalStateSignal;
     _accountingFailureSignal;
     _recoveryStateValue;
@@ -333,6 +353,13 @@ class OrderManager {
     _orphanFillsCreditedAt;
     _pendingRecovery;
     _recentFillKeysSnapshot;
+    _lastFilledBuyPrice;
+    _lastFilledSellPrice;
+    _lastFilledPrice;
+    _lastFilledType;
+    // anchor fields removed
+    // Note: dedupe lives inside the anchor object (`_seenKeys`), not here.
+    // Kept for backwards compat if external code checks existence; not used.
     _metrics;
     _currentWorkingGridStack;
     _cowEngine;
@@ -363,6 +390,7 @@ class OrderManager {
         this._endOfBootstrapValidationDone = false;
         this._broadcastingFlag = 0;
         this._broadcastingStartedAt = 0;
+        this._shuttingDown = false;
         this._illegalStateSignal = null;
         this._accountingFailureSignal = null;
         this._recoveryStateValue = {
@@ -437,6 +465,10 @@ class OrderManager {
         this._pendingRecovery = null;
         this._recentFillKeysSnapshot = null;
         this._lastStaleTotalsWarnAt = {};
+        this._lastFilledBuyPrice = null;
+        this._lastFilledSellPrice = null;
+        this._lastFilledPrice = null;
+        this._lastFilledType = null;
         this._metrics = {
             fundRecalcCount: 0,
             lockAcquisitions: 0,
@@ -545,6 +577,23 @@ class OrderManager {
     isBroadcastingActive() {
         return this._broadcastingFlag > 0;
     }
+    /**
+     * Whether the owning bot has begun shutting down. Mirrors the
+     * bot-level `_shuttingDown` flag (set via setShuttingDown() from
+     * DEXBot._shutdownImpl) so manager-level wait loops can bail out
+     * instead of proceeding with broadcasts after shutdown completed.
+     * @returns {boolean}
+     */
+    isShuttingDown() {
+        return this._shuttingDown === true;
+    }
+    /**
+     * @param {boolean} value
+     * @returns {void}
+     */
+    setShuttingDown(value) {
+        this._shuttingDown = value === true;
+    }
     /**
      * Auto-clears a stale broadcast flag after 120s so a hung
      * broadcast cannot permanently block rebalancing.
@@ -611,9 +660,14 @@ class OrderManager {
      * @returns {void}
      */
     startBroadcasting() {
-        if (this._broadcastingFlag === 0) {
-            this._broadcastingStartedAt = Date.now();
-        }
+        // Refresh the stale-watchdog timestamp on EVERY increment, not just
+        // the 0→1 transition: with refcounted holders (e.g. structural
+        // Phase-2 reconcile + an inner COW batch) measuring only from the
+        // first holder's start lets the 120s watchdog hard-reset while a
+        // later holder is still legitimately active. Each new holder
+        // restarts the window; the commit-refusal backstop bounds any
+        // pathological stream of short holders.
+        this._broadcastingStartedAt = Date.now();
         this._broadcastingFlag++;
         this.logger?.log?.('[BROADCAST] Flag incremented — fill processing will be deferred until stopBroadcasting()', 'debug');
     }
@@ -626,6 +680,11 @@ class OrderManager {
         }
         if (this._broadcastingFlag === 0) {
             this._broadcastingStartedAt = 0;
+            // Runtime hook (wired by the bot): the fill consumer defers while
+            // this flag is held and its defer branch returns without
+            // rescheduling, so fills enqueued during a long region would
+            // starve indefinitely. Fire once when the last region ends.
+            this._onBroadcastRegionEnd?.();
         }
     }
     /**
@@ -1372,71 +1431,149 @@ class OrderManager {
                 `Boundary writes should only happen inside _commitWorkingGrid.`, 'warn');
         }
         this.boundaryIdx = newIdx;
+        this._logBoundaryDebug('set', newIdx);
     }
     /**
      * Restore boundaryIdx outside the COW commit path (startup, recovery,
      * disk-load).  This is the same write as _setBoundary but without the
      * lock-hold warning — loadGrid / initializeGrid are single-threaded at
      * startup and the boundary is being restored from a known-good snapshot,
-     * not committed alongside order mutations.
+     * not committed alongside order mutations. Accepts null to clear the
+     * boundary after a rejected persisted snapshot (P4) so re-derivation
+     * (P3) starts from a clean state.
      */
     _restoreBoundary(newIdx) {
         this.boundaryIdx = newIdx;
+        this._logBoundaryDebug('restore', newIdx);
     }
     /**
-     * DEFENSE-IN-DEPTH (runs after every COW commit): verify the committed
-     * state still has an intact gap band — implied geometry inside the slot
-     * array, and no placed order strictly inside the implied spread.
-     *
-     * This is a DETECTOR, not a guard: the grid is already committed when it
-     * runs.  Violations are logged loudly and flagged via _recoveryState
-     * (structuralResyncRequested) so the maintenance loop reconciles against
-     * the chain.  Purpose is any-writer detection — if a path other than the
-     * promotion clamp commits a boundary that invades the opposite rail or
-     * strands placed orders inside the spread, this fires.
-     */
-    _assertGapBandIntactPostCommit() {
+     * Observability (fix #4, docs/CONSOLIDATED_ORPHAN_FIX_SUMMARY.md §2): emit the live
+     * boundary whenever roles are (re)assigned, so a silent boundary crawl that
+     * re-rolls slots into the wrong rail is diagnosable in real time. Debug-level
+     * only; no behavioral effect.
+     */
+    _logBoundaryDebug(source, newIdx) {
         try {
-            const resolved = resolveGapBand(this);
-            if (resolved.boundaryIdx === null || resolved.sellStartIdx === null)
+            const self = this;
+            const boundary = newIdx == null ? self.boundaryIdx : newIdx;
+            if (boundary == null)
                 return;
-            const { boundaryIdx, sellStartIdx } = resolved;
-            const sorted = Array.from(this.orders.values())
-                .filter((o) => o && o.price != null && Number.isFinite(Number(o.price)))
-                .sort((a, b) => Number(a.price) - Number(b.price));
-            const maxIdx = sorted.length - 1;
-            const problems = [];
-            if (maxIdx < 0 || boundaryIdx < 0 || boundaryIdx > maxIdx) {
-                problems.push(`boundary ${boundaryIdx} outside slot range [0, ${maxIdx}]`);
-            }
-            if (sellStartIdx > maxIdx + 1) {
-                problems.push(`implied sellStart ${sellStartIdx} beyond slot range (${maxIdx})`);
+            const gapSlots = typeof self._gapSlots === 'number' ? self._gapSlots : 0;
+            const sellStart = boundary + 1 + gapSlots;
+            const countActive = (type) => {
+                let n = 0;
+                for (const o of (self.orders?.values?.() || [])) {
+                    if (o && o.type === type && o.orderId)
+                        n++;
+                }
+                return n;
+            };
+            this.logger?.log?.(`[BOUNDARY] ${source} boundary=${boundary} sellStart=${sellStart} gapSlots=${gapSlots} ` +
+                `spreadCount=${self.currentSpreadCount ?? self.initialSpreadCount ?? '?'} ` +
+                `activeBuy=${countActive(ORDER_TYPES.BUY)} activeSell=${countActive(ORDER_TYPES.SELL)}`, 'debug');
+        }
+        catch {
+            /* observability only — never throw from logging */
+        }
+    }
+    /**
+     * Record last filled price for side-gated guard: only the side of the most recent fill is gated
+     * (BUY after BUY must be lower, SELL after SELL must be higher). Spread-correction bypasses.
+     * Cold start (null) => disabled. Per-type fields kept for observability/back-compat.
+     * @param {Array} fills
+     */
+    recordLastFilledPrices(fills) {
+        if (!Array.isArray(fills) || fills.length === 0)
+            return;
+        for (const f of fills) {
+            if (!f || (f.type !== ORDER_TYPES.BUY && f.type !== ORDER_TYPES.SELL))
+                continue;
+            let price = Number(f.price ?? f.order?.price);
+            if (!Number.isFinite(price) || price <= 0) {
+                try {
+                    const slot = f.id ? this.orders?.get?.(f.id) : null;
+                    price = slot ? Number(slot.price) : null;
+                }
+                catch {
+                    price = null;
+                }
             }
-            for (let idx = 0; idx < sorted.length; idx++) {
-                const o = sorted[idx];
-                if (!o.orderId)
+            if (!Number.isFinite(price) || price <= 0)
+                continue;
+            this._lastFilledPrice = price;
+            this._lastFilledType = f.type;
+            if (f.type === ORDER_TYPES.BUY)
+                this._lastFilledBuyPrice = price;
+            else if (f.type === ORDER_TYPES.SELL)
+                this._lastFilledSellPrice = price;
+        }
+    }
+    /**
+     * Seed last-filled guard from the live book at startup. Book-derived
+     * (survives restart), analogous to the deleted MarketAnchor book-seed.
+     * Closes the in-memory-only window where LAST-FILL-GUARD would be
+     * disabled until the first fill arrives.
+     * @param {Array} chainOpenOrders - raw chain open orders (from readOpenOrdersGuarded)
+     */
+    seedLastFilledPricesFromBook(chainOpenOrders) {
+        if (!Array.isArray(chainOpenOrders) || chainOpenOrders.length === 0)
+            return;
+        if (this._lastFilledPrice != null)
+            return;
+        if (this._lastFilledType != null)
+            return;
+        // Only seed when cold (no fills yet) — don't overwrite a live value.
+        if (this._lastFilledBuyPrice != null && this._lastFilledSellPrice != null)
+            return;
+        try {
+            let maxBuy = null;
+            let minSell = null;
+            for (const o of chainOpenOrders) {
+                const parsed = parseChainOrder(o, this.assets);
+                if (!parsed)
+                    continue;
+                const price = Number(parsed.price);
+                if (!Number.isFinite(price) || price <= 0)
                     continue;
-                if (idx > boundaryIdx && idx < sellStartIdx) {
-                    problems.push(`placed ${o.type || 'order'} ${o.id} @ ${o.price} sits inside gap band ` +
-                        `(${boundaryIdx + 1}..${sellStartIdx - 1})`);
+                if (parsed.type === ORDER_TYPES.BUY) {
+                    if (maxBuy == null || price > maxBuy)
+                        maxBuy = price;
                 }
+                else if (parsed.type === ORDER_TYPES.SELL) {
+                    if (minSell == null || price < minSell)
+                        minSell = price;
+                }
+            }
+            if (maxBuy != null && this._lastFilledBuyPrice == null)
+                this._lastFilledBuyPrice = maxBuy;
+            if (minSell != null && this._lastFilledSellPrice == null)
+                this._lastFilledSellPrice = minSell;
+            if (this._lastFilledPrice == null) {
+                if (maxBuy != null && minSell != null)
+                    this._lastFilledPrice = (maxBuy + minSell) / 2;
+                else if (maxBuy != null)
+                    this._lastFilledPrice = maxBuy;
+                else if (minSell != null)
+                    this._lastFilledPrice = minSell;
             }
-            if (problems.length > 0) {
-                this.logger.log(`[COW] GAP-BAND INVARIANT VIOLATION after commit: ${problems.slice(0, 5).join('; ')}` +
-                    `${problems.length > 5 ? ` (+${problems.length - 5} more)` : ''}. Requesting structural resync.`, 'error');
-                if (this._recoveryState) {
-                    this._recoveryState = {
-                        ...this._recoveryState,
-                        lastFailureAt: Date.now(),
-                        structuralResyncRequested: true
-                    };
+            if (this._lastFilledType == null) {
+                if (maxBuy != null && minSell != null) {
+                    // Seed is ambiguous (no real fill yet) — leave type null so guard stays disabled until first fill
+                    this._lastFilledType = null;
                 }
+                else if (maxBuy != null)
+                    this._lastFilledType = ORDER_TYPES.BUY;
+                else if (minSell != null)
+                    this._lastFilledType = ORDER_TYPES.SELL;
+            }
+            if (maxBuy != null || minSell != null) {
+                try {
+                    this.logger?.log?.(`[LAST-FILL-GUARD] Seeded from book: lastBuy=${maxBuy} lastSell=${minSell} lastPrice=${this._lastFilledPrice} lastType=${this._lastFilledType}`, 'info');
+                }
+                catch { }
             }
         }
-        catch (err) {
-            // Detector must never break the commit path.
-            this.logger.log(`[COW] Gap-band post-commit check failed: ${getErrorMessage(err)}`, 'warn');
-        }
+        catch { }
     }
     /**
      * @returns {Object|null} The consumed signal or null
@@ -1555,13 +1692,66 @@ class OrderManager {
             dustThresholdPercent: this.config?.gridLimits?.PARTIAL_DUST_THRESHOLD_PERCENTAGE
         });
     }
+    /**
+     * Wait (bounded) until any non-COW broadcast/placement activity — the
+     * refcounted _broadcastingFlag — has released. Startup/structural
+     * reconcile Phase-2 placement now holds this flag across its create/update
+     * groups; launching a fill-driven COW rebalance on top of it mutates the
+     * master mid-broadcast, forcing a commit refusal and leaving a
+     * previous-generation order set on chain as duplicate-price orphans
+     * that block placements until drained.
+     *
+     * The wait is capped: after the timeout the rebalance proceeds anyway —
+     * the existing commit-refusal + chain-adoption machinery remains the
+     * backstop, so the worst case equals the pre-guard behavior.
+     *
+     * @param {number} [timeoutMs]
+     * @returns {Promise<{waitedMs: number, timedOut: boolean}>}
+     */
+    async _awaitBroadcastIdle(timeoutMs = 30000) {
+        if (this._shuttingDown) {
+            return { waitedMs: 0, timedOut: false, shutdown: true };
+        }
+        if (!this.isBroadcastingActive())
+            return { waitedMs: 0, timedOut: false, shutdown: false };
+        const startedAt = Date.now();
+        let logged = false;
+        while (this.isBroadcastingActive()) {
+            if (this._shuttingDown) {
+                this.logger?.log?.(`[SAFE-REBALANCE] Broadcast wait aborted: shutdown in progress after ${Date.now() - startedAt}ms`, 'warn');
+                return { waitedMs: Date.now() - startedAt, timedOut: false, shutdown: true };
+            }
+            const waited = Date.now() - startedAt;
+            if (waited >= timeoutMs) {
+                this.logger?.log?.(`[SAFE-REBALANCE] Broadcast still active after ${waited}ms; proceeding (commit-refusal + chain adoption remains the backstop)`, 'warn');
+                return { waitedMs: waited, timedOut: true, shutdown: false };
+            }
+            if (!logged) {
+                this.logger?.log?.('[SAFE-REBALANCE] Deferring: broadcast/placement activity active (startup/structural reconcile or another batch)', 'info');
+                logged = true;
+            }
+            await new Promise(resolve => setTimeout(resolve, 1000));
+        }
+        return { waitedMs: Date.now() - startedAt, timedOut: false, shutdown: false };
+    }
     /**
      * @param {Array} [fills] - Fill events triggering rebalance
      * @param {Set<string>} [excludeIds] - Order IDs to exclude
+     * @param {Object} [options]
+     * @param {boolean} [options.skipBroadcastWait] - Set by the COW re-plan path,
+     *   which runs INSIDE its own startBroadcasting() region and must not wait
+     *   on the flag it holds itself.
      * @returns {Promise<any>}
      */
-    async performSafeRebalance(fills = [], excludeIds = new Set()) {
+    async performSafeRebalance(fills = [], excludeIds = new Set(), options = {}) {
         this.logger.log("[SAFE-REBALANCE] Starting with COW...", "info");
+        if (!options?.skipBroadcastWait) {
+            const idle = await this._awaitBroadcastIdle();
+            if (idle.shutdown || this._shuttingDown) {
+                this.logger.log('[SAFE-REBALANCE] Aborting rebalance: shutdown in progress', 'warn');
+                return buildAbortedResult('Shutdown in progress — safe rebalance aborted');
+            }
+        }
         return await this._gridLock.acquire(async () => {
             return await this._applySafeRebalanceCOW(fills, excludeIds);
         });
@@ -1719,7 +1909,6 @@ class OrderManager {
                 releaseStackEntry();
                 return false;
             }
-            this._assertGapBandIntactPostCommit();
             try {
                 if (!skipRecalc) {
                     // If the last accounting failure was due to stale accountTotals,