dexbot 1.6.11 → 1.6.13

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (398) hide show
  1. package/CHANGELOG.md +67 -4
  2. package/README.md +2 -1
  3. package/analysis/README.md +11 -11
  4. package/analysis/ama_fitting/README.md +5 -3
  5. package/analysis/tradingview/README.md +1 -1
  6. package/analysis/trend_detection/DYNAMIC_WEIGHT_RESEARCH.md +3 -3
  7. package/claw/README.md +1 -0
  8. package/claw/docs/AI_BOT_LIBRARY_API.md +2 -0
  9. package/claw/docs/DEXBOT2_TUNING_CHEAT_SHEET.md +4 -3
  10. package/claw/modules/chain_broadcast.ts +7 -1
  11. package/claw/modules/claw_bridge.ts +0 -3
  12. package/claw/modules/claw_launcher.ts +1 -1
  13. package/claw/modules/claw_skill_md.ts +1 -0
  14. package/claw/modules/launcher_mode_detector.ts +9 -2
  15. package/claw/package.json +3 -3
  16. package/claw/runtimes/openclaw-plugin/openclaw.plugin.json +1 -1
  17. package/claw/runtimes/openclaw-plugin/package.json +1 -1
  18. package/claw/tsconfig.json +2 -2
  19. package/dist/analysis/account_resolver.d.ts +1 -1
  20. package/dist/analysis/account_resolver.js +2 -1
  21. package/dist/analysis/ama_fitting/analyze_ama_price_changes.js +3 -4
  22. package/dist/analysis/ama_fitting/analyze_lambda_vs_slow.js +3 -21
  23. package/dist/analysis/ama_fitting/calibrate_convergence_er.js +0 -1
  24. package/dist/analysis/ama_fitting/fetch_lp_candles.js +55 -45
  25. package/dist/analysis/ama_fitting/generate_unified_comparison_chart.d.ts +1 -8
  26. package/dist/analysis/ama_fitting/generate_unified_comparison_chart.js +45 -24
  27. package/dist/analysis/ama_fitting/optimizer_high_resolution.js +34 -78
  28. package/dist/analysis/analyze_args.d.ts +43 -0
  29. package/dist/analysis/analyze_args.js +61 -0
  30. package/dist/analysis/analyze_dynamic_weight.js +7 -17
  31. package/dist/analysis/analyze_kalman.js +7 -17
  32. package/dist/analysis/analyze_regime.js +7 -17
  33. package/dist/analysis/analyze_regime_windows.js +8 -18
  34. package/dist/analysis/analyze_risk_profile.js +8 -18
  35. package/dist/analysis/analyze_trade_heatmap.js +7 -17
  36. package/dist/analysis/analyze_volatility.js +7 -17
  37. package/dist/analysis/bot_fitting/backtest_ama_sweep.d.ts +221 -28
  38. package/dist/analysis/bot_fitting/backtest_ama_sweep.js +23 -103
  39. package/dist/analysis/bot_fitting/backtest_bot_fitting.d.ts +34 -4
  40. package/dist/analysis/bot_fitting/backtest_bot_fitting.js +32 -150
  41. package/dist/analysis/bot_fitting/backtest_lookback_drawdown.js +19 -34
  42. package/dist/analysis/bot_fitting/shared_utils.d.ts +77 -9
  43. package/dist/analysis/bot_fitting/shared_utils.js +125 -9
  44. package/dist/analysis/bot_key_utils.d.ts +18 -10
  45. package/dist/analysis/bot_key_utils.js +7 -4
  46. package/dist/analysis/bot_usage/discover_bot_accounts.js +44 -47
  47. package/dist/analysis/bot_usage/kibana_bot_queries.d.ts +1 -21
  48. package/dist/analysis/chain_pool.d.ts +3 -1
  49. package/dist/analysis/chart_ui.d.ts +35 -3
  50. package/dist/analysis/chart_ui.js +43 -4
  51. package/dist/analysis/chart_utils.d.ts +5 -5
  52. package/dist/analysis/chart_utils.js +9 -0
  53. package/dist/analysis/fills_cache.d.ts +4 -24
  54. package/dist/analysis/fills_cache.js +3 -84
  55. package/dist/analysis/fills_source.d.ts +33 -3
  56. package/dist/analysis/fills_source.js +83 -13
  57. package/dist/analysis/grid_correction_check.d.ts +2 -24
  58. package/dist/analysis/grid_correction_check.js +27 -69
  59. package/dist/analysis/math_utils.d.ts +91 -6
  60. package/dist/analysis/math_utils.js +119 -7
  61. package/dist/analysis/pnl_report.js +29 -29
  62. package/dist/analysis/price_sources.d.ts +30 -9
  63. package/dist/analysis/price_sources.js +28 -4
  64. package/dist/analysis/resolve_bot_accounts.js +2 -2
  65. package/dist/analysis/resolve_source.d.ts +1 -1
  66. package/dist/analysis/resolve_source.js +31 -10
  67. package/dist/analysis/trade_profitability.d.ts +29 -2
  68. package/dist/analysis/trade_profitability.js +73 -147
  69. package/dist/analysis/tradingview/analyze_tradingview.d.ts +3 -8
  70. package/dist/analysis/tradingview/analyze_tradingview.js +7 -6
  71. package/dist/analysis/tradingview/grid_reset_config.d.ts +41 -32
  72. package/dist/analysis/tradingview/grid_reset_config.js +23 -11
  73. package/dist/analysis/tradingview/grid_reset_sim.d.ts +75 -9
  74. package/dist/analysis/tradingview/grid_reset_sim.js +4 -3
  75. package/dist/analysis/tradingview/tradingview_uplot_chart_generator.d.ts +69 -4
  76. package/dist/analysis/tradingview/tradingview_uplot_chart_generator.js +20 -34
  77. package/dist/analysis/trend_detection/backtest_ama_slope_huber.d.ts +1 -101
  78. package/dist/analysis/trend_detection/backtest_ama_slope_huber.js +26 -84
  79. package/dist/analysis/trend_detection/dynamic_weight_chart_generator.d.ts +63 -1
  80. package/dist/analysis/trend_detection/dynamic_weight_chart_generator.js +16 -41
  81. package/dist/analysis/trend_detection/huber_scale_variants.d.ts +9 -3
  82. package/dist/analysis/trend_detection/huber_scale_variants.js +4 -4
  83. package/dist/analysis/trend_detection/kalman_chart_generator.d.ts +30 -1
  84. package/dist/analysis/trend_detection/kalman_chart_generator.js +3 -3
  85. package/dist/analysis/trend_detection/regime_chart_generator.d.ts +31 -1
  86. package/dist/analysis/trend_detection/regime_chart_generator.js +2 -2
  87. package/dist/analysis/trend_detection/volatility_chart_generator.d.ts +33 -1
  88. package/dist/analysis/trend_detection/volatility_chart_generator.js +9 -10
  89. package/dist/analysis/worker_pool.d.ts +38 -0
  90. package/dist/analysis/worker_pool.js +67 -0
  91. package/dist/credential-daemon.js +34 -20
  92. package/dist/dexbot.js +78 -59
  93. package/dist/market_adapter/ama_signal_runner.js +21 -54
  94. package/dist/market_adapter/candle_utils.d.ts +29 -19
  95. package/dist/market_adapter/candle_utils.js +35 -21
  96. package/dist/market_adapter/cli_args.d.ts +22 -0
  97. package/dist/market_adapter/cli_args.js +30 -0
  98. package/dist/market_adapter/core/asymmetric_bounds.d.ts +13 -4
  99. package/dist/market_adapter/core/config_normalizers.d.ts +3 -3
  100. package/dist/market_adapter/core/config_normalizers.js +11 -6
  101. package/dist/market_adapter/core/kibana_candles.d.ts +56 -19
  102. package/dist/market_adapter/core/kibana_candles.js +12 -9
  103. package/dist/market_adapter/core/kibana_client.d.ts +9 -1
  104. package/dist/market_adapter/core/kibana_client.js +8 -7
  105. package/dist/market_adapter/core/kibana_market_candles.d.ts +3 -2
  106. package/dist/market_adapter/core/market_adapter_service.d.ts +320 -153
  107. package/dist/market_adapter/core/market_adapter_service.js +228 -269
  108. package/dist/market_adapter/core/signals/hurst_analyzer.d.ts +1 -6
  109. package/dist/market_adapter/core/signals/hurst_analyzer.js +1 -1
  110. package/dist/market_adapter/core/signals/permutation_entropy_analyzer.d.ts +1 -11
  111. package/dist/market_adapter/core/signals/permutation_entropy_analyzer.js +1 -1
  112. package/dist/market_adapter/core/strategies/ama.d.ts +10 -2
  113. package/dist/market_adapter/core/strategies/ama.js +2 -4
  114. package/dist/market_adapter/core/strategies/ama_slope_model.d.ts +14 -1
  115. package/dist/market_adapter/core/strategies/ama_slope_model.js +12 -34
  116. package/dist/market_adapter/core/strategies/atr/calculator.d.ts +7 -2
  117. package/dist/market_adapter/core/strategies/atr/calculator.js +2 -34
  118. package/dist/market_adapter/core/strategies/collateral_manager.d.ts +7 -1
  119. package/dist/market_adapter/core/strategies/collateral_manager.js +0 -22
  120. package/dist/market_adapter/core/strategies/dynamic_weight_series.d.ts +34 -6
  121. package/dist/market_adapter/core/strategies/dynamic_weight_series.js +7 -7
  122. package/dist/market_adapter/core/strategies/regime_gate.d.ts +24 -15
  123. package/dist/market_adapter/core/strategies/regime_gate.js +4 -31
  124. package/dist/market_adapter/core/strategies/regime_interp.d.ts +7 -1
  125. package/dist/market_adapter/core/strategies/regime_interp.js +14 -22
  126. package/dist/market_adapter/core/strategies/volatility_shift.d.ts +11 -1
  127. package/dist/market_adapter/core/strategies/volatility_shift.js +0 -13
  128. package/dist/market_adapter/inputs/cex_candle_parsing.d.ts +29 -0
  129. package/dist/market_adapter/inputs/cex_candle_parsing.js +52 -0
  130. package/dist/market_adapter/inputs/fetch_book_data.d.ts +20 -4
  131. package/dist/market_adapter/inputs/fetch_book_data.js +3 -2
  132. package/dist/market_adapter/inputs/fetch_cex_synthetic_data.js +160 -332
  133. package/dist/market_adapter/inputs/fetch_lp_data.d.ts +50 -8
  134. package/dist/market_adapter/inputs/fetch_lp_data.js +47 -22
  135. package/dist/market_adapter/inputs/kibana_feed_source.d.ts +74 -15
  136. package/dist/market_adapter/inputs/kibana_feed_source.js +26 -41
  137. package/dist/market_adapter/inputs/kibana_source.d.ts +25 -3
  138. package/dist/market_adapter/inputs/kibana_source.js +2 -2
  139. package/dist/market_adapter/inputs/window_cache.d.ts +93 -156
  140. package/dist/market_adapter/inputs/window_cache.js +59 -184
  141. package/dist/market_adapter/interval_utils.d.ts +15 -5
  142. package/dist/market_adapter/interval_utils.js +16 -1
  143. package/dist/market_adapter/log_format.d.ts +6 -6
  144. package/dist/market_adapter/log_format.js +28 -21
  145. package/dist/market_adapter/lp_chart_core.d.ts +22 -1
  146. package/dist/market_adapter/lp_chart_core.js +26 -192
  147. package/dist/market_adapter/lp_chart_runner.d.ts +10 -7
  148. package/dist/market_adapter/lp_chart_runner.js +37 -19
  149. package/dist/market_adapter/lp_chart_strategy_loader.d.ts +41 -6
  150. package/dist/market_adapter/lp_chart_strategy_loader.js +8 -7
  151. package/dist/market_adapter/market_adapter.d.ts +94 -32
  152. package/dist/market_adapter/market_adapter.js +94 -120
  153. package/dist/market_adapter/utils/adapter_client.d.ts +3 -3
  154. package/dist/market_adapter/utils/adapter_client.js +2 -2
  155. package/dist/market_adapter/utils/atomic_write.d.ts +8 -1
  156. package/dist/market_adapter/utils/chain.d.ts +50 -41
  157. package/dist/market_adapter/utils/chain.js +40 -46
  158. package/dist/market_adapter/utils/data_discovery.d.ts +49 -2
  159. package/dist/market_adapter/utils/data_discovery.js +220 -27
  160. package/dist/market_adapter/utils/dynamic_grid_snapshot.d.ts +12 -3
  161. package/dist/market_adapter/utils/file_json_cache.d.ts +2 -2
  162. package/dist/market_adapter/utils/file_lock.d.ts +28 -14
  163. package/dist/market_adapter/utils/file_lock.js +36 -32
  164. package/dist/market_adapter/utils/month_shards.d.ts +84 -0
  165. package/dist/market_adapter/utils/month_shards.js +237 -0
  166. package/dist/market_adapter/utils/native_history.d.ts +9 -2
  167. package/dist/market_adapter/utils/native_history.js +35 -28
  168. package/dist/modules/account_bots.d.ts +578 -21
  169. package/dist/modules/account_bots.js +272 -267
  170. package/dist/modules/account_orders.d.ts +79 -30
  171. package/dist/modules/account_orders.js +60 -64
  172. package/dist/modules/authority_resolver.d.ts +12 -2
  173. package/dist/modules/authority_resolver.js +15 -8
  174. package/dist/modules/bitshares-native/chain_client.d.ts +39 -4
  175. package/dist/modules/bitshares-native/chain_client.js +59 -59
  176. package/dist/modules/bitshares-native/crypto/ecc.browser.js +11 -171
  177. package/dist/modules/bitshares-native/crypto/ecc.js +13 -176
  178. package/dist/modules/bitshares-native/crypto/ecc_core.d.ts +33 -0
  179. package/dist/modules/bitshares-native/crypto/ecc_core.js +213 -0
  180. package/dist/modules/bitshares-native/crypto/ecc_selector.d.ts +2 -1
  181. package/dist/modules/bitshares-native/crypto/ecc_selector.js +1 -13
  182. package/dist/modules/bitshares-native/index.d.ts +1 -1
  183. package/dist/modules/bitshares-native/lru_cache.d.ts +7 -7
  184. package/dist/modules/bitshares-native/resolvers.d.ts +18 -6
  185. package/dist/modules/bitshares-native/resolvers.js +22 -25
  186. package/dist/modules/bitshares-native/serial/lazy_buffer.d.ts +4 -0
  187. package/dist/modules/bitshares-native/serial/lazy_buffer.js +21 -0
  188. package/dist/modules/bitshares-native/serial/operations.d.ts +1 -1
  189. package/dist/modules/bitshares-native/serial/serializer.d.ts +16 -12
  190. package/dist/modules/bitshares-native/serial/serializer.js +7 -13
  191. package/dist/modules/bitshares-native/serial/types.d.ts +25 -16
  192. package/dist/modules/bitshares-native/serial/types.js +73 -108
  193. package/dist/modules/bitshares-native/signing_client.d.ts +32 -2
  194. package/dist/modules/bitshares-native/signing_client.js +19 -14
  195. package/dist/modules/bitshares-native/subscriptions.d.ts +81 -1
  196. package/dist/modules/bitshares-native/subscriptions.js +12 -12
  197. package/dist/modules/bitshares-native/transport.d.ts +5 -4
  198. package/dist/modules/bitshares-native/transport.js +5 -4
  199. package/dist/modules/bitshares-native/tx/builder.d.ts +40 -5
  200. package/dist/modules/bitshares-native/tx/builder.js +4 -3
  201. package/dist/modules/bitshares-native/tx/tx_cache.d.ts +4 -4
  202. package/dist/modules/bitshares_client.d.ts +45 -13
  203. package/dist/modules/bitshares_client.js +28 -19
  204. package/dist/modules/bot_defaults.d.ts +8 -16
  205. package/dist/modules/bot_defaults.js +1 -5
  206. package/dist/modules/bot_settings.d.ts +44 -10
  207. package/dist/modules/bot_settings.js +11 -8
  208. package/dist/modules/bots_file_lock.d.ts +6 -6
  209. package/dist/modules/bots_file_lock.js +16 -12
  210. package/dist/modules/broadcast_failure.d.ts +4 -3
  211. package/dist/modules/broadcast_failure.js +5 -4
  212. package/dist/modules/chain_keys.d.ts +42 -40
  213. package/dist/modules/chain_keys.js +53 -45
  214. package/dist/modules/chain_orders.d.ts +94 -60
  215. package/dist/modules/chain_orders.js +81 -118
  216. package/dist/modules/cli_start_onboarding.d.ts +2 -1
  217. package/dist/modules/constants.d.ts +534 -32
  218. package/dist/modules/constants.js +35 -48
  219. package/dist/modules/cr_planner.d.ts +41 -3
  220. package/dist/modules/cr_planner.js +1 -5
  221. package/dist/modules/credential_policy.d.ts +68 -8
  222. package/dist/modules/credential_policy.js +37 -31
  223. package/dist/modules/credential_session_cache.d.ts +2 -2
  224. package/dist/modules/credit_pricing.d.ts +43 -6
  225. package/dist/modules/credit_pricing.js +70 -60
  226. package/dist/modules/credit_runtime.d.ts +283 -118
  227. package/dist/modules/credit_runtime.js +500 -231
  228. package/dist/modules/crypto/browser_provider.js +6 -4
  229. package/dist/modules/crypto/node_provider.js +1 -1
  230. package/dist/modules/crypto/pure_scrypt.js +35 -4
  231. package/dist/modules/crypto/pure_secp256k1.js +72 -26
  232. package/dist/modules/crypto/sync.d.ts +9 -9
  233. package/dist/modules/crypto/sync.js +16 -9
  234. package/dist/modules/daemon_node_health.d.ts +4 -3
  235. package/dist/modules/dexbot_class.d.ts +213 -146
  236. package/dist/modules/dexbot_class.js +183 -86
  237. package/dist/modules/dexbot_cow_runtime.d.ts +160 -87
  238. package/dist/modules/dexbot_cow_runtime.js +302 -234
  239. package/dist/modules/dexbot_credential_client.d.ts +19 -18
  240. package/dist/modules/dexbot_credential_client.js +1 -2
  241. package/dist/modules/dexbot_fill_runtime.d.ts +63 -49
  242. package/dist/modules/dexbot_fill_runtime.js +53 -47
  243. package/dist/modules/dexbot_maintenance_runtime.d.ts +127 -71
  244. package/dist/modules/dexbot_maintenance_runtime.js +187 -147
  245. package/dist/modules/dexbot_startup_runtime.d.ts +11 -11
  246. package/dist/modules/dexbot_startup_runtime.js +56 -57
  247. package/dist/modules/dexbot_state_recovery.d.ts +13 -12
  248. package/dist/modules/dexbot_state_recovery.js +18 -13
  249. package/dist/modules/fund_registry.d.ts +4 -2
  250. package/dist/modules/fund_registry.js +10 -10
  251. package/dist/modules/general_settings.d.ts +30 -4
  252. package/dist/modules/graceful_shutdown.d.ts +3 -3
  253. package/dist/modules/graceful_shutdown.js +19 -13
  254. package/dist/modules/grid_price_source.d.ts +1 -1
  255. package/dist/modules/key_store.d.ts +14 -8
  256. package/dist/modules/key_store.js +7 -7
  257. package/dist/modules/launcher/adapter_requirement.d.ts +11 -5
  258. package/dist/modules/launcher/adapter_requirement.js +5 -5
  259. package/dist/modules/launcher/bot_supervisor.d.ts +106 -24
  260. package/dist/modules/launcher/bot_supervisor.js +12 -11
  261. package/dist/modules/launcher/credential_bootstrap.d.ts +1 -1
  262. package/dist/modules/launcher/credential_bootstrap.js +1 -1
  263. package/dist/modules/launcher/credential_daemon.d.ts +4 -4
  264. package/dist/modules/launcher/credential_daemon.js +2 -2
  265. package/dist/modules/launcher/credential_secret.d.ts +1 -1
  266. package/dist/modules/launcher/foreign_cred_daemon.d.ts +2 -2
  267. package/dist/modules/launcher/market_adapter_runtime.d.ts +61 -6
  268. package/dist/modules/launcher/market_adapter_watchdog.d.ts +10 -2
  269. package/dist/modules/launcher/market_adapter_watchdog.js +4 -0
  270. package/dist/modules/launcher/monolithic_runtime.d.ts +18 -16
  271. package/dist/modules/launcher/status_reporting.d.ts +22 -14
  272. package/dist/modules/launcher/supervisor_control.d.ts +8 -1
  273. package/dist/modules/launcher/supervisor_control.js +4 -2
  274. package/dist/modules/lazy_shim.d.ts +11 -0
  275. package/dist/modules/lazy_shim.js +16 -0
  276. package/dist/modules/market_adapter_whitelist.d.ts +9 -3
  277. package/dist/modules/market_adapter_whitelist.js +15 -3
  278. package/dist/modules/node_connect_policy.d.ts +3 -2
  279. package/dist/modules/node_failure_ledger.d.ts +6 -5
  280. package/dist/modules/node_manager.d.ts +41 -11
  281. package/dist/modules/node_manager.js +5 -4
  282. package/dist/modules/order/accounting.d.ts +53 -24
  283. package/dist/modules/order/accounting.js +16 -15
  284. package/dist/modules/order/async_lock.d.ts +5 -2
  285. package/dist/modules/order/async_lock.js +1 -1
  286. package/dist/modules/order/export.d.ts +7 -6
  287. package/dist/modules/order/export.js +1 -7
  288. package/dist/modules/order/format.d.ts +16 -7
  289. package/dist/modules/order/format.js +15 -3
  290. package/dist/modules/order/genesis_policy.d.ts +24 -21
  291. package/dist/modules/order/genesis_policy.js +17 -10
  292. package/dist/modules/order/grid.d.ts +144 -36
  293. package/dist/modules/order/grid.js +226 -145
  294. package/dist/modules/order/grid_reconcile.d.ts +21 -20
  295. package/dist/modules/order/grid_reconcile.js +13 -12
  296. package/dist/modules/order/grid_reconcile_internal.d.ts +85 -72
  297. package/dist/modules/order/grid_reconcile_internal.js +28 -19
  298. package/dist/modules/order/index.d.ts +264 -1
  299. package/dist/modules/order/logger.d.ts +46 -19
  300. package/dist/modules/order/logger.js +38 -49
  301. package/dist/modules/order/logger_state.d.ts +4 -4
  302. package/dist/modules/order/manager.d.ts +232 -191
  303. package/dist/modules/order/manager.js +110 -130
  304. package/dist/modules/order/processed_fill_store.d.ts +18 -3
  305. package/dist/modules/order/processed_fill_store.js +16 -27
  306. package/dist/modules/order/strategy.d.ts +21 -13
  307. package/dist/modules/order/strategy.js +5 -6
  308. package/dist/modules/order/sync_engine.d.ts +91 -33
  309. package/dist/modules/order/sync_engine.js +84 -53
  310. package/dist/modules/order/utils/math.d.ts +157 -102
  311. package/dist/modules/order/utils/math.js +77 -38
  312. package/dist/modules/order/utils/order.d.ts +310 -110
  313. package/dist/modules/order/utils/order.js +153 -126
  314. package/dist/modules/order/utils/slot.d.ts +1 -1
  315. package/dist/modules/order/utils/system.d.ts +156 -26
  316. package/dist/modules/order/utils/system.js +103 -71
  317. package/dist/modules/order/utils/validate.d.ts +89 -41
  318. package/dist/modules/order/utils/validate.js +26 -24
  319. package/dist/modules/order/utils/withPoolRef.d.ts +6 -4
  320. package/dist/modules/order/utils/withPoolRef.js +18 -12
  321. package/dist/modules/order/working_grid.d.ts +14 -13
  322. package/dist/modules/paths.d.ts +1 -4
  323. package/dist/modules/paths.js +33 -61
  324. package/dist/modules/process_discovery.d.ts +1 -1
  325. package/dist/modules/process_discovery.js +2 -1
  326. package/dist/modules/runtime.d.ts +7 -3
  327. package/dist/modules/runtime.js +4 -3
  328. package/dist/modules/runtime_settings.d.ts +14 -11
  329. package/dist/modules/runtime_settings.js +30 -24
  330. package/dist/modules/settings_merge.d.ts +29 -3
  331. package/dist/modules/settings_merge.js +56 -78
  332. package/dist/modules/socket_json_client.d.ts +9 -5
  333. package/dist/modules/storage/browser_adapter.d.ts +38 -53
  334. package/dist/modules/storage/browser_adapter.js +7 -30
  335. package/dist/modules/storage/index.d.ts +1 -1
  336. package/dist/modules/storage/node_adapter.d.ts +45 -27
  337. package/dist/modules/storage/node_adapter.js +9 -9
  338. package/dist/modules/storage/types.d.ts +5 -4
  339. package/dist/modules/types.d.ts +1090 -6
  340. package/dist/modules/types.js +4 -1
  341. package/dist/modules/utils/asset_symbols.d.ts +2 -1
  342. package/dist/modules/utils/asset_symbols.js +2 -1
  343. package/dist/modules/utils/errors.d.ts +9 -0
  344. package/dist/modules/utils/errors.js +24 -4
  345. package/dist/modules/utils/time_range.d.ts +1 -12
  346. package/dist/modules/utils/time_range.js +1 -1
  347. package/dist/modules/validate_profiles.js +53 -43
  348. package/dist/modules/version_notice.d.ts +23 -11
  349. package/dist/modules/version_notice.js +6 -4
  350. package/dist/pm2.d.ts +28 -27
  351. package/dist/pm2.js +61 -40
  352. package/dist/scripts/analyze-credit.d.ts +2 -1
  353. package/dist/scripts/analyze-credit.js +23 -24
  354. package/dist/scripts/analyze-git.js +2 -15
  355. package/dist/scripts/analyze-orders.d.ts +77 -9
  356. package/dist/scripts/analyze-orders.js +65 -40
  357. package/dist/scripts/chart_command.d.ts +27 -18
  358. package/dist/scripts/chart_command.js +15 -13
  359. package/dist/scripts/check_any.d.ts +22 -0
  360. package/dist/scripts/check_any.js +158 -0
  361. package/dist/scripts/diagnose-pool-history.js +13 -13
  362. package/dist/scripts/print_grid.js +0 -1
  363. package/dist/scripts/run-tests.js +39 -8
  364. package/dist/scripts/runner.js +1 -1
  365. package/dist/scripts/sync-version.js +0 -10
  366. package/dist/scripts/test-credit-renewal.js +30 -21
  367. package/dist/scripts/update.d.ts +10 -5
  368. package/dist/scripts/update.js +168 -103
  369. package/dist/scripts/update_dist_freshness.js +1 -0
  370. package/dist/scripts/update_layout.d.ts +61 -0
  371. package/dist/scripts/update_layout.js +180 -0
  372. package/dist/scripts/validate_bots.js +2 -1
  373. package/dist/scripts/verify-browser-bundle.js +8 -0
  374. package/dist/unlock.d.ts +28 -3
  375. package/dist/unlock.js +63 -35
  376. package/docs/BITSHARES_ONBOARDING.md +10 -12
  377. package/docs/COPY_ON_WRITE_MASTER_PLAN.md +2 -2
  378. package/docs/COW_INVARIANTS.md +13 -6
  379. package/docs/DEXBOT_COMPARISON.md +8 -8
  380. package/docs/EVOLUTION.md +10 -8
  381. package/docs/FUND_MOVEMENT_AND_ACCOUNTING.md +5 -5
  382. package/docs/GRID_RECALCULATION.md +4 -2
  383. package/docs/GRID_RECONCILE.md +14 -3
  384. package/docs/LIFECYCLE.md +11 -11
  385. package/docs/MPA_CREDIT_USAGE.md +22 -3
  386. package/docs/README.md +14 -3
  387. package/docs/WORKFLOW.md +1 -0
  388. package/docs/architecture.md +31 -19
  389. package/docs/developer_guide.md +6 -6
  390. package/market_adapter/README.md +12 -5
  391. package/modules/README.md +4 -1
  392. package/package.json +9 -9
  393. package/scripts/README.md +43 -38
  394. package/tests/README.md +25 -10
  395. package/dist/scripts/diagnose-kibana-candles.d.ts +0 -3
  396. package/dist/scripts/diagnose-kibana-candles.js +0 -82
  397. package/scripts/git-viewer.sh +0 -489
  398. package/scripts/postinstall.js +0 -16
@@ -8,7 +8,319 @@
8
8
  */
9
9
  export type OrderType = 'sell' | 'buy' | 'spread';
10
10
  export type OrderState = 'virtual' | 'active' | 'partial';
11
- export interface OrderBase {
11
+ /**
12
+ * Why a spread correction placed no effective order. Carried from
13
+ * checkSpreadCondition to the maintenance loop so the funds/open-orders refresh
14
+ * is requested only when it can repair the cause, and so the log states the
15
+ * truth instead of always blaming free funds.
16
+ *
17
+ * no-free-funds — determineOrderSideByFunds found no fundable side.
18
+ * unfunded — candidates existed but free funds funded none.
19
+ * no-candidates — no spread-tightening slot exists in the LOCAL snapshot.
20
+ * This can be genuine structural geometry, or a stale
21
+ * local order state (a missed fill leaves an ACTIVE slot
22
+ * occupying the window edge, hiding the tightening slot
23
+ * behind it). Only a chain sync can tell the two apart,
24
+ * so it arms the refresh too; the out-of-spread staleness
25
+ * watchdog remains the backstop if the sync heals nothing.
26
+ * batch-not-executed— a plan was prepared but the COW batch did not run.
27
+ * apply-error — the broadcast threw.
28
+ */
29
+ export type SpreadCorrectionStall = 'no-free-funds' | 'unfunded' | 'no-candidates' | 'batch-not-executed' | 'apply-error';
30
+ /**
31
+ * Dict with unknown values. The canonical replacement for
32
+ * `Record<string, any>`; callers must narrow a value before using it.
33
+ */
34
+ export type UnknownRecord = Record<string, unknown>;
35
+ /** A value that survives JSON round-tripping. */
36
+ type JsonPrimitive = string | number | boolean | null;
37
+ type JsonValue = JsonPrimitive | JsonObject | JsonValue[];
38
+ export interface JsonObject {
39
+ [key: string]: JsonValue;
40
+ }
41
+ /**
42
+ * Function-shaped logger callback. `level` is intentionally an open string:
43
+ * call sites use labels such as `info`, `warn`, `error`, `debug`.
44
+ */
45
+ export type LogFn = (message: string, level?: string) => void;
46
+ /**
47
+ * Anything logger-like. Mirrors how callers use injected loggers
48
+ * (`logger?.log?.()` / `logger.warn?.()`).
49
+ */
50
+ export interface LoggerLike {
51
+ log?: LogFn;
52
+ warn?: LogFn;
53
+ info?: LogFn;
54
+ debug?: LogFn;
55
+ error?: LogFn;
56
+ }
57
+ /**
58
+ * The `{ promise, resolve, reject }` pattern used by async gates.
59
+ * Prefer this over hand-rolled `Promise<any>` + `any` callbacks.
60
+ */
61
+ export interface Deferred<T> {
62
+ promise: Promise<T>;
63
+ resolve: (value: T | PromiseLike<T>) => void;
64
+ reject: (reason?: unknown) => void;
65
+ }
66
+ /** Runtime narrowing guard for `UnknownRecord` at I/O boundaries. */
67
+ export declare function isUnknownRecord(value: unknown): value is UnknownRecord;
68
+ /** Graphene `asset_amount` (e.g. `{ amount: 12345, asset_id: '1.3.0' }`). */
69
+ interface ChainAssetAmount {
70
+ amount: number | string;
71
+ asset_id: string;
72
+ }
73
+ /** Graphene `price` (sell_price.base / sell_price.quote). */
74
+ interface ChainPrice {
75
+ base: ChainAssetAmount;
76
+ quote: ChainAssetAmount;
77
+ }
78
+ /**
79
+ * A raw BitShares `limit_order_object` as returned by the node (before
80
+ * `parseChainOrder` converts it to a grid `Order`). Extra protocol fields
81
+ * remain accessible via the index signature.
82
+ */
83
+ export interface ChainOrder {
84
+ id: string;
85
+ seller?: string;
86
+ sell_price: ChainPrice;
87
+ for_sale: number | string;
88
+ expiration?: string;
89
+ [key: string]: unknown;
90
+ }
91
+ /** The result of `parseChainOrder()`: a chain order normalized to grid terms. */
92
+ export interface ParsedChainOrder {
93
+ orderId: string;
94
+ price: number;
95
+ type: OrderType;
96
+ size: number | undefined;
97
+ }
98
+ /** A raw chain order paired with its parsed form (holds the pre-filter join). */
99
+ export interface ParsedChainEntry {
100
+ chain: ChainOrder;
101
+ parsed: ParsedChainOrder;
102
+ }
103
+ /**
104
+ * The subset of the `chain_orders` module surface the order engine calls.
105
+ * Methods are variadic (`unknown` args) because their real parameter lists are
106
+ * still being typed; the named members keep them callable without `any`.
107
+ */
108
+ export interface ChainOrdersLike {
109
+ cancelOrder(...args: unknown[]): Promise<{
110
+ verifiedAfterFailure?: boolean;
111
+ [key: string]: unknown;
112
+ } | null | undefined>;
113
+ createOrder(...args: unknown[]): Promise<{
114
+ skipped?: boolean;
115
+ [key: string]: unknown;
116
+ } | null | undefined>;
117
+ readOpenOrders(...args: unknown[]): Promise<unknown>;
118
+ buildUpdateOrderOp?(...args: unknown[]): Promise<{
119
+ op?: unknown;
120
+ [key: string]: unknown;
121
+ } | null | undefined>;
122
+ executeBatch?(...args: unknown[]): Promise<unknown>;
123
+ updateOrder?(...args: unknown[]): Promise<{
124
+ [key: string]: unknown;
125
+ } | null | undefined>;
126
+ wasRecentlyOwnCancelled?(orderId: string): boolean;
127
+ [key: string]: unknown;
128
+ }
129
+ /**
130
+ * Minimal runtime surface shared by the `dexbot_*_runtime.ts` layer. This is
131
+ * a seeded interface to grow as each runtime file is typed — the index
132
+ * signature keeps the many `_camelCase` internals reachable (as `unknown`)
133
+ * while the common surface gets real types. Replace index-signature reads with
134
+ * named fields as the relevant owners are typed.
135
+ */
136
+ /**
137
+ * The DexBot runtime surface used by the `dexbot_*_runtime.ts` layer (and the
138
+ * `DexBot` class itself, which structurally satisfies it). No index signature:
139
+ * every member the runtime touches is enumerated, so a typo or an undeclared
140
+ * internal is a compile error instead of a silent `unknown`.
141
+ */
142
+ /** Credential-daemon signing token (used until the private key is unlocked). */
143
+ export interface SigningToken {
144
+ accountName: string;
145
+ socketPath?: string;
146
+ }
147
+ export interface BotLike {
148
+ config: GridConfig;
149
+ manager: OrderManagerLike;
150
+ account: string | null;
151
+ accountId: string | null;
152
+ privateKey: string | SigningToken | null;
153
+ accountOrders: AccountOrdersLike;
154
+ assets: AssetPair | null;
155
+ botKey: string;
156
+ name: string;
157
+ triggerFile: string;
158
+ logPrefix: string;
159
+ _log: LogFn;
160
+ _warn: LogFn;
161
+ _baseWeightDistribution: {
162
+ sell: number;
163
+ buy: number;
164
+ };
165
+ _metrics: BotMetrics;
166
+ _recentlyQueuedFills: Map<string, number>;
167
+ _recentlyProcessedFills: Map<string, number>;
168
+ _incomingFillQueue: IncomingFill[];
169
+ _processedFillStore: ProcessedFillStoreLike;
170
+ _staleCleanedOrderIds: Map<string, number>;
171
+ _staleCleanupRetentionMs: number;
172
+ _fillCleanupCounter: number;
173
+ _fillDedupeWindowMs: number;
174
+ _fillRecordRetentionMs: number;
175
+ _targetedDriftSyncCooldownMs: number;
176
+ _maintenanceCooldownCycles: number;
177
+ _lastGridActivityAt: number;
178
+ _currentCycleId: number;
179
+ _consecutiveConsumeFailures: number;
180
+ _consumeFailureFirstAt: number;
181
+ _fillTotalsRetryAttempt: number;
182
+ _gridPriceInvariantRejectStreak: Map<string, number>;
183
+ _structuralGridResyncRunning: number;
184
+ _structuralGridResyncDeferCount: number;
185
+ _structuralGridResyncDeferStartedAt: number | null;
186
+ _postRecoveryRebalanceDefers: number;
187
+ _lastDeferredDustCount: number;
188
+ _deferredFillRetryWaits: number;
189
+ _deferredFillRetryDelayMs: number;
190
+ _lastTargetedDriftSyncAt: number;
191
+ _lightweightSyncCheckAt: number;
192
+ _lastUncertainResyncAt: number;
193
+ _lastResolvedPollIntervalMs: number;
194
+ _fillBroadcastDeferSince: number;
195
+ _fillBroadcastDeferRegionAt: number;
196
+ _fillTotalsParkedFills: IncomingFill[];
197
+ _fillTotalsRetryTimer: ReturnType<typeof setTimeout> | null;
198
+ _fillTotalsRetryDelayMs: number;
199
+ _currentBatchId: string | number | null | undefined;
200
+ _lastBroadcastHeartbeatAt: number | undefined;
201
+ _appliedBotConfigFingerprint: string | null;
202
+ _lastBotConfigHintFingerprint: string | null;
203
+ _marketAdapterWatchdogFingerprint: string | null;
204
+ _lastHeldChainOrderSignature: string | null;
205
+ _lastHeldChainOrderSignatureSince: number;
206
+ _lastHeldChainOrderWarnAt: number;
207
+ _lastDeferredHoldResyncAt: number;
208
+ _lastGridPriceInvariantResyncAt: number;
209
+ _lastSpreadStaleResyncAt: number;
210
+ _gridLockHoldWarnAt: number;
211
+ _outOfSpreadSince: number;
212
+ _outOfSpreadStaleWarned: boolean;
213
+ _strandedHoldSince: Map<string, number>;
214
+ _recoverySyncInFlight: number;
215
+ _batchInFlight: number;
216
+ _cowBroadcastInFlight: boolean;
217
+ _deferredFillsPending: boolean;
218
+ _credentialRecoveryNeeded: boolean;
219
+ _shuttingDown: boolean;
220
+ _mainLoopActive: boolean;
221
+ _botsConfigPollInFlight: boolean;
222
+ _marketAdapterWatchdogInFlight: boolean;
223
+ _blockchainFetchInFlight: number;
224
+ _blockchainFetchIntervalMin: number;
225
+ _spreadFundsExhausted: boolean;
226
+ _spreadCorrectionStall: SpreadCorrectionStall | null;
227
+ _skipEmptyReadConfirmDelay: boolean;
228
+ _testPollIntervalMs?: number;
229
+ _appliedBotConfigEntry: unknown;
230
+ _creditRuntime: CreditRuntimeLike | null;
231
+ _gridModule: unknown;
232
+ _gridReconcileModule: unknown;
233
+ _blockchainFetchInterval: ReturnType<typeof setInterval> | null;
234
+ _botsConfigPollInterval: ReturnType<typeof setInterval> | null;
235
+ _credentialDaemonWatchdogInterval: ReturnType<typeof setInterval> | null;
236
+ _creditWatchdogInterval: ReturnType<typeof setInterval> | null;
237
+ _dustHealthCheckTimer: ReturnType<typeof setInterval> | null;
238
+ _deferredFillRetryTimer: ReturnType<typeof setTimeout> | null;
239
+ _postRecoveryRebalanceTimer: ReturnType<typeof setTimeout> | null;
240
+ _structuralGridResyncTimer: ReturnType<typeof setTimeout> | null;
241
+ _triggerDebounceTimer: ReturnType<typeof setTimeout> | null;
242
+ _fillsUnsubscribe: (() => Promise<unknown>) | null;
243
+ _reconnectUnregister: (() => void) | null;
244
+ _triggerWatcher: {
245
+ close?: () => void;
246
+ } | null;
247
+ _mainLoopPromise: Promise<unknown> | null;
248
+ _abortFlowIfIllegalState(...args: unknown[]): unknown;
249
+ _applyRecoverableGridUpdates(...args: unknown[]): unknown;
250
+ _applyReplaySafeTrackedFillAccounting(...args: unknown[]): Promise<FillAccountingResult>;
251
+ _applyReplaySafeOrphanFillAccounting(...args: unknown[]): Promise<FillAccountingResult>;
252
+ _buildOrphanFillFallbackKey(...args: unknown[]): unknown;
253
+ _buildOutsideInPairGroupsForOrders(...args: unknown[]): unknown[];
254
+ _cancelDustOrders(options?: unknown): Promise<unknown>;
255
+ _consumeFillQueue(...args: unknown[]): Promise<unknown>;
256
+ _createFillCallback(...args: unknown[]): unknown;
257
+ _ensureCredentialDaemonWritable(contextLabel?: unknown): unknown;
258
+ _executeBatchIfNeeded(rebalanceResult: unknown, contextLabel?: unknown): Promise<unknown>;
259
+ _flushProcessedFillPersistence(...args: unknown[]): unknown;
260
+ _flushProcessedFillPersistenceForKeys(...args: unknown[]): unknown;
261
+ _formatUnmatchedChainOrderForLog(...args: unknown[]): unknown;
262
+ _getGapSlotBatchSize(...args: unknown[]): unknown;
263
+ _getMaxOpsPerBroadcast(...args: unknown[]): unknown;
264
+ _getPipelineSignals(...args: unknown[]): unknown;
265
+ _getPm2ProcessNames(...args: unknown[]): Promise<string[]>;
266
+ _getRecentFillKeysSnapshot(...args: unknown[]): Record<string, number> | null;
267
+ _handleBatchHardAbort(...args: unknown[]): unknown;
268
+ _handlePendingTriggerReset(...args: unknown[]): unknown;
269
+ _isCredentialDaemonError(err: unknown): unknown;
270
+ _isNewFillKey(...args: unknown[]): unknown;
271
+ _isOpenOrdersSyncLoopEnabled(...args: unknown[]): unknown;
272
+ _listenForFillsHook(...args: unknown[]): unknown;
273
+ _loadBotsConfigSnapshot(...args: unknown[]): unknown;
274
+ _markGridActivity(...args: unknown[]): unknown;
275
+ _performGridResync(options?: UnknownRecord): Promise<unknown>;
276
+ _persistAndRecoverIfNeeded(...args: unknown[]): unknown;
277
+ _processFillsWithBatching(fills: unknown, excl: unknown, contextLabel: unknown, options?: unknown): Promise<FillBatchResult>;
278
+ _processFillsWithBootstrapMode(...args: unknown[]): unknown;
279
+ _readOpenOrdersHook(...args: unknown[]): unknown;
280
+ _recoverBatchSizeDrift(...args: unknown[]): unknown;
281
+ _recoverExplicitStaleOrders(...args: unknown[]): unknown;
282
+ _recoverFromPersistedGrid(...args: unknown[]): unknown;
283
+ _refreshAndSyncCreditRuntime(...args: unknown[]): unknown;
284
+ _refreshDynamicWeightDistribution(...args: unknown[]): unknown;
285
+ _rejectCorruptedGridSnapshot(...args: unknown[]): unknown;
286
+ _runCreditRuntimeMaintenance(context?: unknown, options?: unknown): unknown;
287
+ _runDustHealthCheck(...args: unknown[]): unknown;
288
+ _runGridMaintenance(context?: unknown, options?: unknown): unknown;
289
+ _scheduleFillConsumerRestart(...args: unknown[]): unknown;
290
+ _setupBlockchainFetchInterval(...args: unknown[]): unknown;
291
+ _setupBotsConfigPollInterval(...args: unknown[]): unknown;
292
+ _setupCredentialDaemonWatchdogInterval(...args: unknown[]): unknown;
293
+ _setupCreditRuntime(...args: unknown[]): unknown;
294
+ _setupCreditWatchdogInterval(...args: unknown[]): unknown;
295
+ _setupDustHealthCheckInterval(...args: unknown[]): unknown;
296
+ _setupTriggerFileDetection(...args: unknown[]): unknown;
297
+ _startMarketAdapterPm2(...args: unknown[]): unknown;
298
+ _startOpenOrdersSyncLoop(...args: unknown[]): unknown;
299
+ _stopCreditWatchdogInterval(...args: unknown[]): unknown;
300
+ _stopMarketAdapterPm2(...args: unknown[]): unknown;
301
+ _submitCancelOrder(...args: unknown[]): unknown;
302
+ _suspendGridPersistenceForCredentialOutage(reason: unknown): unknown;
303
+ _resumeGridPersistenceAfterCredentialRecovery(reason: unknown): unknown;
304
+ _syncMarketAdapterHook(...args: unknown[]): unknown;
305
+ _syncOpenOrdersAndProcessFills(...args: unknown[]): Promise<{
306
+ aborted?: boolean;
307
+ hasUnmatched?: number;
308
+ syncResult?: SyncResult | null;
309
+ openOrders?: unknown[] | null;
310
+ [key: string]: unknown;
311
+ }>;
312
+ _targetedOrderRepair(...args: unknown[]): unknown;
313
+ _triggerStateRecoverySync(...args: unknown[]): unknown;
314
+ _wireBroadcastRegionEndDrain(...args: unknown[]): unknown;
315
+ _wireProcessedFillTracking(...args: unknown[]): unknown;
316
+ _wireStructuralGridResyncRequest(...args: unknown[]): unknown;
317
+ placeInitialOrders(...args: unknown[]): unknown;
318
+ requestGridReset(reason?: unknown, options?: unknown): Promise<unknown>;
319
+ shutdown(...args: unknown[]): unknown;
320
+ updateOrdersOnChainBatch(rebalanceResult: unknown): unknown;
321
+ updateOrdersOnChainPlan(...args: unknown[]): unknown;
322
+ }
323
+ interface OrderBase {
12
324
  id: string;
13
325
  price: number;
14
326
  type: OrderType;
@@ -17,26 +329,798 @@ export interface OrderBase {
17
329
  orderId: string | null;
18
330
  committedSide?: OrderType;
19
331
  rawOnChain?: {
20
- for_sale?: number;
332
+ for_sale?: number | string;
333
+ fetchedAt?: number;
334
+ } | null;
335
+ btsFeeState?: {
336
+ deferredFee?: number;
337
+ [key: string]: unknown;
21
338
  };
22
- metadata?: Record<string, any>;
339
+ metadata?: JsonObject;
23
340
  gridIndex?: number;
24
341
  idealSize?: number;
25
342
  sideHint?: string;
26
343
  }
27
- export interface VirtualOrder extends OrderBase {
344
+ interface VirtualOrder extends OrderBase {
28
345
  state: 'virtual';
29
346
  orderId: null | '';
30
347
  }
31
- export interface ActiveOrder extends OrderBase {
348
+ interface ActiveOrder extends OrderBase {
32
349
  state: 'active';
33
350
  orderId: string;
34
351
  size: number;
35
352
  }
36
- export interface PartialOrder extends OrderBase {
353
+ interface PartialOrder extends OrderBase {
37
354
  state: 'partial';
38
355
  orderId: string;
39
356
  size: number;
40
357
  }
41
358
  export type Order = VirtualOrder | ActiveOrder | PartialOrder;
359
+ /** Asset metadata used by the grid engine (precision is the only required bit). */
360
+ export interface AssetInfo {
361
+ id?: string;
362
+ symbol?: string;
363
+ precision: number;
364
+ amount?: number;
365
+ [key: string]: unknown;
366
+ }
367
+ /** The two-asset pair held by an order manager. */
368
+ export interface AssetPair {
369
+ assetA: AssetInfo;
370
+ assetB: AssetInfo;
371
+ [key: string]: unknown;
372
+ }
373
+ /** Blockchain balance snapshot (nulls until the first successful fetch). */
374
+ export interface AccountTotals {
375
+ buy: number | null;
376
+ sell: number | null;
377
+ buyFree: number | null;
378
+ sellFree: number | null;
379
+ _lastFetchedAt?: number;
380
+ buyLocked?: number;
381
+ sellLocked?: number;
382
+ [key: string]: unknown;
383
+ }
384
+ /** Per-side fund amounts. */
385
+ interface SideFunds {
386
+ buy: number;
387
+ sell: number;
388
+ }
389
+ /** Chain/grid split of a fund category. */
390
+ interface ChainGridFunds {
391
+ chain: SideFunds;
392
+ grid: SideFunds;
393
+ }
394
+ /** `manager.funds` — the accountant's derived fund view. */
395
+ export interface ManagerFunds {
396
+ available: SideFunds;
397
+ total: ChainGridFunds;
398
+ virtual: SideFunds;
399
+ committed: ChainGridFunds;
400
+ btsFeesOwed: number;
401
+ btsBalance: {
402
+ free: number;
403
+ total: number;
404
+ locked: number;
405
+ };
406
+ allocated?: SideFunds;
407
+ allocatedBuy?: number;
408
+ allocatedSell?: number;
409
+ chainFreeBuy?: number;
410
+ chainFreeSell?: number;
411
+ [key: string]: unknown;
412
+ }
413
+ /** `manager.persistGrid()` result — validation outcome plus skip flags. */
414
+ interface PersistGridResult extends UnknownRecord {
415
+ isValid: boolean;
416
+ skipped?: boolean;
417
+ suspended?: boolean;
418
+ reason?: string | null;
419
+ }
420
+ /** Signal raised by the manager on an illegal order state. */
421
+ export interface IllegalStateSignal extends UnknownRecord {
422
+ context?: string;
423
+ message?: string;
424
+ }
425
+ /** Signal raised by the manager on an accounting commitment failure. */
426
+ export interface AccountingFailureSignal extends UnknownRecord {
427
+ side?: string;
428
+ amount: number;
429
+ context?: string;
430
+ message?: string;
431
+ }
432
+ /** Result of `manager.checkFundDriftAfterFills()`. */
433
+ export interface FundDriftCheck extends UnknownRecord {
434
+ isValid: boolean;
435
+ driftSell?: number;
436
+ driftBuy?: number;
437
+ reason?: string | null;
438
+ }
439
+ /** Result of `manager.performSafeRebalance()`. */
440
+ export interface RebalanceResult extends UnknownRecord {
441
+ aborted?: boolean;
442
+ reason?: string | null;
443
+ deferred?: boolean;
444
+ actions?: unknown[];
445
+ needsResync?: boolean;
446
+ resyncReason?: string;
447
+ targetGrid?: unknown;
448
+ committed?: boolean;
449
+ }
450
+ /** Result of a chain open-orders sync pass. */
451
+ export interface SyncResult extends UnknownRecord {
452
+ filledOrders: unknown[];
453
+ updatedOrders: unknown[];
454
+ ordersNeedingCorrection: unknown[];
455
+ unmatchedChainOrders?: UnmatchedChainOrder[];
456
+ partialFill?: boolean;
457
+ requiresOpenOrdersSync?: boolean;
458
+ deferred?: boolean;
459
+ newOrders?: unknown[];
460
+ }
461
+ /** Result of a single/batch fill-history sync (`syncFromFillHistory*`). */
462
+ export interface FillHistorySyncResult extends UnknownRecord {
463
+ deferred?: boolean;
464
+ filledOrders?: unknown[];
465
+ residualCancels?: unknown[];
466
+ requiresOpenOrdersSync?: boolean;
467
+ }
468
+ /** Result of `_processFillsWithBatching` / `_processFillsWithBootstrapMode`. */
469
+ export interface FillBatchResult extends UnknownRecord {
470
+ aborted?: boolean;
471
+ deferred?: boolean;
472
+ }
473
+ /** Result of `manager.checkGridHealth()`. */
474
+ interface GridHealthResult extends UnknownRecord {
475
+ buyDustOrders?: unknown[];
476
+ sellDustOrders?: unknown[];
477
+ }
478
+ /** Runtime metrics counters. */
479
+ export interface BotMetrics extends UnknownRecord {
480
+ fillsProcessed: number;
481
+ batchesExecuted: number;
482
+ fillProcessingTimeMs: number;
483
+ lockContentionEvents: number;
484
+ maxQueueDepth: number;
485
+ gridLockContention: number;
486
+ fundRecalcCount: number;
487
+ }
488
+ /** An unmatched chain order surfaced by a sync pass. */
489
+ export interface UnmatchedChainOrder extends UnknownRecord {
490
+ chainOrderId?: string;
491
+ orderId?: string;
492
+ price?: number;
493
+ size?: number;
494
+ reason?: string;
495
+ }
496
+ /** A raw fill/operation entry carried on the incoming fill queue. */
497
+ export interface IncomingFill extends UnknownRecord {
498
+ op?: [unknown, {
499
+ order_id: string;
500
+ is_maker?: boolean;
501
+ pays?: {
502
+ amount?: unknown;
503
+ asset_id?: unknown;
504
+ };
505
+ receives?: {
506
+ amount?: unknown;
507
+ asset_id?: unknown;
508
+ };
509
+ }];
510
+ block_num?: number;
511
+ id?: string;
512
+ }
513
+ /** Aggregate chain-funds summary produced by `computeChainFundTotals`. */
514
+ interface ChainFundsTotals {
515
+ chainFreeBuy: number;
516
+ chainFreeSell: number;
517
+ committedChainBuy: number;
518
+ committedChainSell: number;
519
+ freePlusLockedBuy: number;
520
+ freePlusLockedSell: number;
521
+ chainTotalBuy: number;
522
+ chainTotalSell: number;
523
+ [key: string]: unknown;
524
+ }
525
+ /** `manager.getChainFundsSnapshot()` result. */
526
+ export interface ChainFundsSnapshot extends ChainFundsTotals {
527
+ allocatedBuy: number;
528
+ allocatedSell: number;
529
+ btsBalance: {
530
+ free: number;
531
+ total: number;
532
+ locked: number;
533
+ } | null;
534
+ }
535
+ /**
536
+ * The mutable order record the grid engine operates on. Deliberately NOT the
537
+ * discriminated `Order` union: the engine transitions a single record across
538
+ * `virtual`/`active`/`partial` in place, so `state`/`orderId` must stay
539
+ * independently writable.
540
+ */
541
+ export interface ManagedOrder {
542
+ id: string;
543
+ price: number;
544
+ type: OrderType;
545
+ state: OrderState;
546
+ size: number;
547
+ orderId: string | null;
548
+ committedSide?: OrderType;
549
+ rawOnChain?: {
550
+ for_sale?: number | string;
551
+ fetchedAt?: number;
552
+ } | null;
553
+ metadata?: UnknownRecord;
554
+ btsFeeState?: {
555
+ deferredFee?: number;
556
+ deferredPaidFee?: number;
557
+ [key: string]: unknown;
558
+ } | null;
559
+ createUncertain?: boolean;
560
+ gridIndex?: number;
561
+ idealSize?: number;
562
+ sideHint?: string;
563
+ [key: string]: unknown;
564
+ }
565
+ /** Active-order target counts. */
566
+ export interface ActiveOrdersConfig extends UnknownRecord {
567
+ buy?: number;
568
+ sell?: number;
569
+ }
570
+ /** Grid-limit knobs (mirrors `GRID_LIMITS` profile overrides). */
571
+ export interface GridLimitsLike extends UnknownRecord {
572
+ GRID_COMPARISON?: {
573
+ RMS_PERCENTAGE?: number;
574
+ [key: string]: unknown;
575
+ };
576
+ MIN_SPREAD_ORDERS?: number;
577
+ MIN_SPREAD_FACTOR?: number;
578
+ MIN_ORDER_SIZE_FACTOR?: number;
579
+ PARTIAL_DUST_THRESHOLD_PERCENTAGE?: number;
580
+ }
581
+ /** Per-side weight distribution for fund allocation. */
582
+ export interface WeightDistributionConfig extends UnknownRecord {
583
+ buy?: number;
584
+ sell?: number;
585
+ }
586
+ /**
587
+ * Bot/grid configuration. Only the fields the engine reads directly are named;
588
+ * the index signature keeps profile-defined extras reachable as `unknown`.
589
+ */
590
+ export interface GridConfig extends UnknownRecord {
591
+ startPrice?: number | string;
592
+ minPrice?: number | null;
593
+ maxPrice?: number | null;
594
+ incrementPercent?: number;
595
+ incrementBounds?: {
596
+ MIN_PERCENT: number;
597
+ MAX_PERCENT: number;
598
+ [key: string]: unknown;
599
+ };
600
+ targetSpreadPercent?: number;
601
+ activeOrders?: ActiveOrdersConfig;
602
+ assetA?: string;
603
+ assetB?: string;
604
+ botKey?: string;
605
+ market?: string;
606
+ accountId?: string;
607
+ preferredAccount?: string;
608
+ maintenance?: {
609
+ uncertainReadResyncCooldownMs?: number;
610
+ [key: string]: unknown;
611
+ };
612
+ min_BTS_value?: number;
613
+ priceMode?: string;
614
+ poolRef?: string | null;
615
+ gridLimits?: GridLimitsLike;
616
+ weightDistribution?: WeightDistributionConfig;
617
+ asymmetricBounds?: UnknownRecord;
618
+ rotation?: UnknownRecord;
619
+ botFunds?: UnknownRecord;
620
+ feeParams?: GridFeeParams;
621
+ fillProcessing?: FillProcessingConfig;
622
+ timing?: TimingConfig;
623
+ accountTotals?: AccountTotals;
624
+ pipelineTiming?: {
625
+ TIMEOUT_MS?: number;
626
+ [key: string]: unknown;
627
+ };
628
+ logging?: {
629
+ level?: string;
630
+ config?: Record<string, unknown>;
631
+ [key: string]: unknown;
632
+ };
633
+ }
634
+ /** Fee-schedule override block inside `config.feeParams`. */
635
+ export interface GridFeeParams extends UnknownRecord {
636
+ MAKER_REFUND_PERCENT?: number;
637
+ TAKER_FEE_PERCENT?: number;
638
+ DEFAULT_MAX_FEE_RATE_PER_DAY?: number;
639
+ BTS_ACQUIRE_THRESHOLD?: number;
640
+ BTS_ACQUIRE_TARGET_MULTIPLIER?: number;
641
+ BTS_RESERVATION_MULTIPLIER?: number;
642
+ POOL_SLIPPAGE_TOLERANCE?: number;
643
+ }
644
+ /** `config.timing` knobs. */
645
+ interface TimingConfig extends UnknownRecord {
646
+ SAFETY_NET_SYNC_TIMEOUT_MS?: number;
647
+ CREDIT_DEAL_EXPIRY_THRESHOLD_HOURS?: number;
648
+ CREDIT_REBORROW_MAX_ATTEMPTS?: number;
649
+ BLOCKCHAIN_FETCH_INTERVAL_MIN?: number;
650
+ BOTS_CONFIG_POLL_INTERVAL_MS?: number;
651
+ BTS_ACQUIRE_COOLDOWN_MIN?: number;
652
+ }
653
+ /** `config.fillProcessing` knobs read by the fill consumer. */
654
+ interface FillProcessingConfig extends UnknownRecord {
655
+ CONSUMER_BACKOFF_INITIAL_MS?: number;
656
+ CONSUMER_BACKOFF_MAX_MS?: number;
657
+ MAX_CONSECUTIVE_CONSUMER_FAILURES?: number;
658
+ OPERATION_TYPE?: number;
659
+ }
660
+ /** Async mutex surface (AsyncLock) used by the manager. */
661
+ export interface ManagerLock {
662
+ acquire<T>(fn: () => T | Promise<T>, options?: number | {
663
+ timeout?: number;
664
+ }): Promise<T>;
665
+ isReentrant(): boolean;
666
+ isLocked(): boolean;
667
+ forceRelease(reason?: string): unknown;
668
+ getQueueLength(): number;
669
+ heldForMs(): number;
670
+ }
671
+ /** `refreshAccountTotalsIfStale()` freshness gate. */
672
+ interface AccountTotalsGate {
673
+ ok: boolean;
674
+ [key: string]: unknown;
675
+ }
676
+ /** Accountant surface the sync engine calls directly. */
677
+ /** Result of `accountant.processFillAccounting()`. */
678
+ interface FillAccountingResult extends UnknownRecord {
679
+ status: string;
680
+ }
681
+ interface AccountantLike {
682
+ processFillAccounting(fillOp: unknown, fillKey: string, options?: UnknownRecord): Promise<boolean>;
683
+ adjustTotalBalance(orderType: string, delta: number, operation: string): Promise<unknown>;
684
+ addToChainFree(orderType: string, size: number, operation: string): Promise<unknown>;
685
+ _performStateRecovery(...args: unknown[]): {
686
+ isValid: boolean;
687
+ reason?: string | null;
688
+ [key: string]: unknown;
689
+ } | Promise<{
690
+ isValid: boolean;
691
+ reason?: string | null;
692
+ [key: string]: unknown;
693
+ }>;
694
+ updateOptimisticFreeBalance(...args: unknown[]): Promise<unknown>;
695
+ recalculateFunds(): Promise<unknown>;
696
+ resetFunds(): unknown;
697
+ _getBtsOrderType?(): string | null;
698
+ resetRecoveryState?(): unknown;
699
+ }
700
+ /** A pending price-correction queue entry. */
701
+ export interface PendingPriceCorrection extends UnknownRecord {
702
+ chainOrderId?: string;
703
+ isSurplus?: boolean;
704
+ cancelOnly?: boolean;
705
+ gapEvacuation?: boolean;
706
+ queuedBy?: string;
707
+ queuedAt?: number;
708
+ reason?: string;
709
+ gridOrder?: ManagedOrder | null;
710
+ }
711
+ /** A startup Phase-1 cancel plan executed in Phase 2. */
712
+ export interface StartupCancelPlan {
713
+ chainOrderId: string;
714
+ chainOrderObj: ChainOrder | ManagedOrder | null;
715
+ releaseUntrackedFunds?: boolean;
716
+ orderType?: OrderType;
717
+ boundaryIdx?: number | null;
718
+ gapSlots?: number;
719
+ gridOrderId?: string;
720
+ gridOrder?: ManagedOrder;
721
+ }
722
+ /** A startup Phase-1 update plan executed in Phase 2. */
723
+ export interface StartupUpdatePlan {
724
+ orderType: OrderType;
725
+ chainOrderId: string;
726
+ chainOrderObj: ChainOrder;
727
+ gridOrderId: string;
728
+ gridOrder: ManagedOrder;
729
+ }
730
+ /** A startup Phase-1 create plan executed in Phase 2. */
731
+ export interface StartupCreatePlan {
732
+ orderType: OrderType;
733
+ gridOrder: ManagedOrder;
734
+ orderLabel?: string;
735
+ recovery?: {
736
+ triggerMessage: string;
737
+ source: string;
738
+ };
739
+ extraOptions?: UnknownRecord;
740
+ }
741
+ /** A validation error/warning emitted by `validateOrder()`. */
742
+ export interface ValidationIssue {
743
+ code: string;
744
+ message: string;
745
+ isFatal?: boolean;
746
+ autoCorrect?: UnknownRecord;
747
+ [key: string]: unknown;
748
+ }
749
+ /** A per-asset fund shortfall emitted by `validateWorkingGridFunds()`. */
750
+ export interface FundShortfall {
751
+ asset: string;
752
+ required: number;
753
+ available: number;
754
+ deficit: number;
755
+ }
756
+ /**
757
+ * A copy-on-write reconcile action (`reconcileGrid` / the COW executor).
758
+ * `type` is one of the `COW_ACTIONS` values; the remaining fields are populated
759
+ * per action kind (CREATE carries `order`, CANCEL carries `orderId`+`reason`,
760
+ * UPDATE carries `newGridId`/`newSize`/`newPrice`/`isRotation`).
761
+ */
762
+ export interface CowAction {
763
+ type: string;
764
+ id: string;
765
+ orderId?: string | null;
766
+ reason?: string;
767
+ order?: ManagedOrder;
768
+ newGridId?: string;
769
+ newSize?: number;
770
+ newPrice?: number;
771
+ isRotation?: boolean;
772
+ origin?: string;
773
+ evacBoundary?: number;
774
+ evacGapSlots?: number;
775
+ [key: string]: unknown;
776
+ }
777
+ /** A CREATE-target violation from `validateCreateTargetSlots()`. */
778
+ export interface CreateTargetViolation {
779
+ targetId: string;
780
+ currentOrderId?: string | null;
781
+ currentType?: string;
782
+ currentState?: string;
783
+ reason: string;
784
+ duplicateOf?: string;
785
+ [key: string]: unknown;
786
+ }
787
+ /** Asset precisions used by the fund validators (per side). */
788
+ export interface FundPrecisions {
789
+ buyPrecision?: number;
790
+ sellPrecision?: number;
791
+ }
792
+ /** Optimistic/projected fund figures consumed by `validateWorkingGridFunds()`. */
793
+ export interface ProjectedFunds {
794
+ allocatedBuy?: number;
795
+ allocatedSell?: number;
796
+ chainTotalBuy?: number;
797
+ chainTotalSell?: number;
798
+ freeBuy?: number;
799
+ freeSell?: number;
800
+ chainFreeBuy?: number;
801
+ chainFreeSell?: number;
802
+ btsBalance?: {
803
+ free?: number;
804
+ total?: number;
805
+ locked?: number;
806
+ } | null;
807
+ [key: string]: unknown;
808
+ }
809
+ /** A queued broadcast-region entry. */
810
+ export interface PendingBroadcast {
811
+ slotId?: string;
812
+ order?: ManagedOrder | null;
813
+ [key: string]: unknown;
814
+ }
815
+ /** Account-orders adapter surface the engine calls directly. */
816
+ export interface AccountOrdersLike {
817
+ syncMeta(botConfig: unknown): Promise<unknown>;
818
+ storeMasterGrid(...args: unknown[]): Promise<unknown>;
819
+ loadGrid(forceReload?: boolean): unknown[] | null;
820
+ loadBoundaryIdx(forceReload?: boolean): number | null;
821
+ loadGenesis(forceReload?: boolean): unknown;
822
+ loadGapEvacStreaks(forceReload?: boolean): unknown;
823
+ loadLastFillPivot?(forceReload?: boolean): unknown;
824
+ loadPendingFillCrawls(forceReload?: boolean): unknown[];
825
+ loadRecentFillKeys(forceReload?: boolean): unknown;
826
+ loadPersistedAssets(forceReload?: boolean): {
827
+ assetA?: AssetInfo;
828
+ assetB?: AssetInfo;
829
+ } | null;
830
+ loadBtsBalance(forceReload?: boolean): unknown;
831
+ loadBtsFeesOwed(forceReload?: boolean): unknown;
832
+ clearGrid(): Promise<unknown>;
833
+ clearPersistedBoundary(...args: unknown[]): Promise<unknown>;
834
+ clearPersistedLastFillPivot(...args: unknown[]): Promise<unknown>;
835
+ loadProcessedFills(options?: boolean | {
836
+ forceReload?: boolean;
837
+ minTimestamp?: number | null;
838
+ }): Map<string, number>;
839
+ updateProcessedFillsBatch(fills: Map<string, number>): Promise<unknown>;
840
+ cleanOldProcessedFills(olderThanMs?: number): Promise<unknown>;
841
+ getAssetBalances?(forceReload?: boolean): unknown;
842
+ }
843
+ /** Batch-persistence handle for processed fill keys. */
844
+ export interface ProcessedFillStoreLike {
845
+ configure(options?: {
846
+ accountOrders?: AccountOrdersLike | null;
847
+ }): void;
848
+ setShuttingDown(value: boolean): void;
849
+ loadPersisted(options?: {
850
+ forceReload?: boolean;
851
+ minTimestamp?: number | null;
852
+ }): number;
853
+ mergeTracker(sourceTracker: Map<string, number>): void;
854
+ persist(fillKey: string, timestamp: number, options?: {
855
+ mode?: string;
856
+ }): Promise<void>;
857
+ discard(fillKey: string, timestamp?: number): void;
858
+ flush(reason?: string, options?: {
859
+ throwOnError?: boolean;
860
+ }): Promise<void>;
861
+ flushKeys(fillKeys: string[] | Set<string>, reason?: string, options?: {
862
+ throwOnError?: boolean;
863
+ }): Promise<void>;
864
+ [key: string]: unknown;
865
+ }
866
+ /** The manager's logger surface (all levels are present on `Logger`). */
867
+ export interface ManagerLogger {
868
+ log: LogFn;
869
+ warn: LogFn;
870
+ info: LogFn;
871
+ debug: LogFn;
872
+ error: LogFn;
873
+ level?: string;
874
+ marketName?: unknown;
875
+ logFundsStatus(manager: unknown, context?: string, forceDetailed?: boolean): void;
876
+ logOrderGrid?(orders: ManagedOrder[], startPrice: number): void;
877
+ flush?(): Promise<void>;
878
+ }
879
+ /** Mutable recovery-state record (all fields optional to allow partial writes). */
880
+ interface ManagerRecoveryState {
881
+ phase?: string;
882
+ attemptCount?: number;
883
+ lastAttemptAt?: number;
884
+ inFlight?: boolean;
885
+ lastFailureAt?: number;
886
+ structuralResyncRequested?: boolean;
887
+ [key: string]: unknown;
888
+ }
889
+ /**
890
+ * The contract the order engine consumes from `OrderManager`. This is the
891
+ * decoupled interface the `modules/order/**` layer types its `manager`
892
+ * parameters against, so the engine does not need to import the concrete
893
+ * class (avoiding a runtime import cycle). `OrderManager` structurally
894
+ * satisfies it.
895
+ *
896
+ * Optional members are either wired in later by the runtime layer
897
+ * (e.g. `requestStructuralGridResync`, `notifyBoundaryUpdate`) or read only
898
+ * defensively; keep them optional so partial test doubles still type-check.
899
+ */
900
+ /** Minimal surface of the credit runtime consumed by the bot/manager layer. */
901
+ export interface CreditRuntimeLike {
902
+ config: GridConfig;
903
+ loadState(): Promise<unknown>;
904
+ refreshState(): Promise<unknown>;
905
+ runMaintenance(context?: unknown, options?: unknown): Promise<unknown>;
906
+ runCreditWatchdog(): Promise<unknown>;
907
+ shutdown(): Promise<unknown>;
908
+ }
909
+ export interface OrderManagerLike {
910
+ _consecutiveBoundaryHolds?: number;
911
+ _boundaryShiftBudgetBase?: number;
912
+ _lastBoundaryHoldInfo?: unknown;
913
+ _lastHeldPlanSignature?: {
914
+ boundaryIdx?: number | null;
915
+ pivot?: number | null;
916
+ fillsAt?: number | null;
917
+ [key: string]: unknown;
918
+ } | null;
919
+ config: GridConfig;
920
+ marketName: string | null;
921
+ logger: ManagerLogger;
922
+ accountId: string | null;
923
+ account?: unknown;
924
+ accountant: AccountantLike;
925
+ strategy?: unknown;
926
+ sync?: unknown;
927
+ orders: Map<string, ManagedOrder>;
928
+ assets: AssetPair;
929
+ funds: ManagerFunds;
930
+ accountTotals: AccountTotals;
931
+ accountOrders: AccountOrdersLike;
932
+ flushGridDirty(contextLabel?: string): Promise<unknown>;
933
+ recordLastFilledPrices(fills: unknown[]): void;
934
+ suspendGridPersistence(reason?: string): unknown;
935
+ resumeGridPersistence(reason?: string | null): unknown;
936
+ boundaryIdx: number | null;
937
+ _deferredRebalanceAt?: number;
938
+ _onBroadcastRegionEndListeners?: Array<() => void>;
939
+ targetGrid?: unknown;
940
+ initialSpreadCount: number;
941
+ currentSpreadCount: number;
942
+ outOfSpread: number;
943
+ btsBalance?: {
944
+ free: number;
945
+ total: number;
946
+ locked: number;
947
+ };
948
+ ordersNeedingPriceCorrection: PendingPriceCorrection[];
949
+ _gapSlots: number;
950
+ _gridVersion: number;
951
+ _gridLock: ManagerLock;
952
+ _fundLock: ManagerLock;
953
+ _accountTotalsPromise: Promise<unknown> | null;
954
+ accountTotalsStale: boolean;
955
+ _placedAt: Map<string, number>;
956
+ _orderIdAssignedAt: Map<string, number>;
957
+ _pendingBroadcasts: Map<string, PendingBroadcast>;
958
+ _pendingFillCrawls: Array<{
959
+ slotId: string;
960
+ side: string;
961
+ ts: number;
962
+ }>;
963
+ _recentFillKeysSnapshot: Record<string, number> | null;
964
+ _gridSidesUpdated: Set<string>;
965
+ shadowOrderIds: Map<string, number>;
966
+ processedFillTracker: Map<string, number>;
967
+ processedFillStore: ProcessedFillStoreLike | null;
968
+ _pauseFundRecalc: number;
969
+ _pauseRecalcLogging: boolean;
970
+ _throwOnIllegalState: boolean;
971
+ _fillBatchInFlight: number;
972
+ _fillProcessingLock: ManagerLock;
973
+ _syncLock: ManagerLock;
974
+ _divergenceLock: ManagerLock;
975
+ _resetLastFillPivot?(reason?: string): boolean;
976
+ _rateLimitStaleTotalsWarn(kind: string): boolean;
977
+ clearStalePipelineOperations(): void;
978
+ isPipelineEmpty(...args: unknown[]): {
979
+ isEmpty: boolean;
980
+ reasons: string[];
981
+ };
982
+ _cleanExpiredLocks(): void;
983
+ getActiveShadowLockCount(): number;
984
+ _clearStaleBroadcastFlag(): void;
985
+ _orphanFillsCreditedAt?: number | null;
986
+ _broadcastingStartedAt: number;
987
+ _recoveryState: ManagerRecoveryState;
988
+ _committedOrderIdsBuiltAt?: number;
989
+ _committedOrderIds?: Set<string>;
990
+ _recoveryAttempted?: boolean;
991
+ _gapEvacStreaks: Map<string, number>;
992
+ _gapEvacCancelQueued?: Set<string>;
993
+ _genesis?: {
994
+ startPrice?: number;
995
+ incrementPercent?: number;
996
+ gapSlots?: number;
997
+ priceLevels?: readonly unknown[];
998
+ priceLevelsHash?: string;
999
+ createdAt?: number;
1000
+ } | null;
1001
+ _missingGenesis?: unknown;
1002
+ _genesisInvariantViolations?: number;
1003
+ _genesisInvariantLoggedAt?: number;
1004
+ _fundDriftLedger?: {
1005
+ side: string;
1006
+ direction: string;
1007
+ count: number;
1008
+ firstAt: number;
1009
+ lastAt: number;
1010
+ } | null;
1011
+ _lastFilledBuyPrice: number | null;
1012
+ _lastFilledSellPrice: number | null;
1013
+ _lastFilledPrice: number | null;
1014
+ _lastFilledType: string | null;
1015
+ _lastFilledAt: number | null;
1016
+ lastFillPivotSource: 'fill' | 'book' | null;
1017
+ _lastUnmatchedChainOrders?: UnmatchedChainOrder[];
1018
+ _lastUnmatchedChainOrdersAt?: number;
1019
+ _lastAccountingFailure?: unknown;
1020
+ _pendingRecovery: Promise<unknown> | null;
1021
+ _lastGridPricingContext?: {
1022
+ gridPrice?: unknown;
1023
+ gridPriceOffsetPct?: unknown;
1024
+ offsetAdjustedStartPrice?: unknown;
1025
+ startPrice?: unknown;
1026
+ configuredMinPrice?: unknown;
1027
+ configuredMaxPrice?: unknown;
1028
+ rangeScalingFactor?: unknown;
1029
+ [key: string]: unknown;
1030
+ } | null;
1031
+ _boundaryShiftBudget?: unknown;
1032
+ _persistenceWarning?: unknown;
1033
+ _recoveryExhaustedAt?: number | null;
1034
+ _skipEmptyReadConfirmDelay?: unknown;
1035
+ _readSingleOrderFn?: unknown;
1036
+ _batchReadOrdersFn?: unknown;
1037
+ _confirmEmptyReadFn?: unknown;
1038
+ _syncGeneration?: number;
1039
+ _suspectEmptyReads?: {
1040
+ count: number;
1041
+ firstAt: number;
1042
+ };
1043
+ _correctionQueueWarnAt?: number;
1044
+ _gridBloatDetectedAt?: number;
1045
+ isRebalancing(): boolean;
1046
+ isBootstrapping(): boolean;
1047
+ isBroadcastingActive(): boolean;
1048
+ isPlanningActive(): boolean;
1049
+ setShuttingDown(value: boolean): void;
1050
+ startBootstrap(): void;
1051
+ finishBootstrap(): void;
1052
+ startBroadcasting(): void;
1053
+ stopBroadcasting(): void;
1054
+ addBroadcastRegionEndListener(listener: () => void): void;
1055
+ _applySync(data: unknown, src: string): Promise<unknown>;
1056
+ synchronizeWithChain(data: unknown, src: string): Promise<SyncResult>;
1057
+ requestStructuralGridResync?: (reason?: string, details?: UnknownRecord) => Promise<{
1058
+ skipped?: boolean;
1059
+ reason?: string;
1060
+ [key: string]: unknown;
1061
+ } | undefined>;
1062
+ validateGridStateForPersistence(options?: {
1063
+ allowBootstrapTransient?: boolean;
1064
+ [key: string]: unknown;
1065
+ }): {
1066
+ isValid: boolean;
1067
+ [key: string]: unknown;
1068
+ };
1069
+ notifyBoundaryUpdate?: (boundaryIdx: number | null) => unknown;
1070
+ resetFunds(): Promise<void>;
1071
+ recalculateFunds(): Promise<void>;
1072
+ applyBotFundsAllocation(): void;
1073
+ setAccountTotals(totals?: Partial<AccountTotals>): Promise<unknown>;
1074
+ refreshAccountTotalsIfStale(options?: {
1075
+ force?: boolean;
1076
+ }): Promise<AccountTotalsGate>;
1077
+ reanchorAccountTotals(label?: string): Promise<unknown>;
1078
+ lockOrders(orderIds: unknown): void;
1079
+ unlockOrders(orderIds: unknown): void;
1080
+ pauseFundRecalc(): void;
1081
+ resumeFundRecalc(): Promise<void>;
1082
+ pauseRecalcLogging(): void;
1083
+ resumeRecalcLogging(): void;
1084
+ fetchAccountTotals(accountId?: string | null): Promise<void>;
1085
+ waitForAccountTotals(timeoutMs?: number): Promise<void>;
1086
+ getChainFundsSnapshot(): ChainFundsSnapshot;
1087
+ _initializeAssets(): Promise<unknown>;
1088
+ _updateOrder(order: ManagedOrder, context?: string, options?: UnknownRecord): Promise<boolean>;
1089
+ _applyOrderUpdate(order: ManagedOrder, context?: string, options?: UnknownRecord): Promise<boolean>;
1090
+ applyGridUpdateBatch(updates: unknown, context?: string, options?: UnknownRecord): Promise<boolean>;
1091
+ getOrdersByTypeAndState(type?: OrderType | null, state?: OrderState): ManagedOrder[];
1092
+ _markGridDirty(): void;
1093
+ _restoreBoundary(newIdx: number | null): void;
1094
+ _clearPendingFillCrawls(reason?: string): void;
1095
+ syncFromOpenOrders(orders: unknown, info?: unknown): Promise<SyncResult>;
1096
+ syncFromFillHistory(fill: unknown, options?: UnknownRecord): Promise<FillHistorySyncResult>;
1097
+ syncFromFillHistoryBatch(fills: unknown, options?: UnknownRecord): Promise<FillHistorySyncResult>;
1098
+ checkSpreadCondition(...args: unknown[]): Promise<{
1099
+ ordersPlaced?: number;
1100
+ partialsMoved?: number;
1101
+ stall?: SpreadCorrectionStall;
1102
+ [key: string]: unknown;
1103
+ }>;
1104
+ _fetchAccountBalancesAndSetTotals(...args: unknown[]): Promise<unknown>;
1105
+ getInitialOrdersToActivate(): ManagedOrder[];
1106
+ seedLastFilledPricesFromBook(...args: unknown[]): void;
1107
+ checkGridHealth(...args: unknown[]): Promise<GridHealthResult>;
1108
+ processFilledOrders(orders: unknown, excl: unknown, options?: UnknownRecord): Promise<unknown>;
1109
+ performSafeRebalance(fills?: unknown, excludeIds?: Set<string>, options?: UnknownRecord): Promise<RebalanceResult>;
1110
+ consumeIllegalStateSignal(): IllegalStateSignal | null;
1111
+ consumeAccountingFailureSignal(): AccountingFailureSignal | null;
1112
+ checkFundDriftAfterFills(...args: unknown[]): FundDriftCheck;
1113
+ _popWorkingGridRef?(result?: unknown): void;
1114
+ _pushWorkingGridRef(...args: unknown[]): unknown;
1115
+ _resetRebalanceStateToDepth(...args: unknown[]): void;
1116
+ _setRebalanceState(...args: unknown[]): void;
1117
+ _lastBoundaryHoldResyncAt: number;
1118
+ _commitWorkingGrid(workingGrid: unknown, workingIndexes: unknown, workingBoundary: unknown, options?: UnknownRecord): Promise<boolean>;
1119
+ persistGrid(snapshotOrders?: unknown, recentFillKeys?: unknown, fundSnapshot?: {
1120
+ btsFeesOwed: number;
1121
+ accountTotals: AccountTotals;
1122
+ }): Promise<PersistGridResult>;
1123
+ calculateCurrentSpread(): number;
1124
+ }
1125
+ export {};
42
1126
  //# sourceMappingURL=types.d.ts.map