dexbot 1.6.10 → 1.6.12

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 (365) hide show
  1. package/CHANGELOG.md +50 -3
  2. package/README.md +3 -1
  3. package/analysis/README.md +51 -11
  4. package/analysis/bot_fitting/README.md +12 -0
  5. package/analysis/tradingview/README.md +3 -3
  6. package/analysis/trend_detection/DYNAMIC_WEIGHT_RESEARCH.md +11 -37
  7. package/analysis/trend_detection/README.md +31 -0
  8. package/claw/docs/DEXBOT2_TUNING_CHEAT_SHEET.md +4 -3
  9. package/claw/modules/chain_broadcast.ts +7 -1
  10. package/claw/modules/claw_launcher.ts +1 -1
  11. package/claw/modules/launcher_mode_detector.ts +9 -2
  12. package/claw/package.json +1 -1
  13. package/claw/runtimes/openclaw-plugin/openclaw.plugin.json +1 -1
  14. package/claw/runtimes/openclaw-plugin/package.json +1 -1
  15. package/dist/analysis/account_resolver.d.ts +1 -1
  16. package/dist/analysis/account_resolver.js +15 -2
  17. package/dist/analysis/ama_fitting/analyze_ama_price_changes.js +3 -4
  18. package/dist/analysis/ama_fitting/analyze_lambda_vs_slow.js +2 -7
  19. package/dist/analysis/ama_fitting/calibrate_convergence_er.js +0 -1
  20. package/dist/analysis/ama_fitting/fetch_lp_candles.js +4 -4
  21. package/dist/analysis/ama_fitting/generate_unified_comparison_chart.d.ts +20 -4
  22. package/dist/analysis/ama_fitting/generate_unified_comparison_chart.js +9 -6
  23. package/dist/analysis/ama_fitting/optimizer_high_resolution.js +16 -12
  24. package/dist/analysis/analyze_args.d.ts +31 -0
  25. package/dist/analysis/analyze_args.js +41 -0
  26. package/dist/analysis/analyze_dynamic_weight.js +7 -20
  27. package/dist/analysis/analyze_kalman.js +7 -17
  28. package/dist/analysis/analyze_regime.js +7 -17
  29. package/dist/analysis/analyze_regime_windows.js +8 -18
  30. package/dist/analysis/analyze_risk_profile.js +8 -18
  31. package/dist/analysis/analyze_trade_heatmap.js +7 -17
  32. package/dist/analysis/analyze_volatility.js +7 -17
  33. package/dist/analysis/bot_fitting/backtest_ama_sweep.d.ts +220 -12
  34. package/dist/analysis/bot_fitting/backtest_ama_sweep.js +55 -10
  35. package/dist/analysis/bot_fitting/backtest_bot_fitting.d.ts +34 -4
  36. package/dist/analysis/bot_fitting/backtest_bot_fitting.js +72 -66
  37. package/dist/analysis/bot_fitting/backtest_lookback_drawdown.d.ts +21 -0
  38. package/dist/analysis/bot_fitting/backtest_lookback_drawdown.js +315 -0
  39. package/dist/analysis/bot_fitting/shared_utils.d.ts +7 -7
  40. package/dist/analysis/bot_fitting/shared_utils.js +2 -2
  41. package/dist/analysis/bot_key_utils.d.ts +18 -10
  42. package/dist/analysis/bot_key_utils.js +10 -17
  43. package/dist/analysis/bot_usage/discover_bot_accounts.js +44 -47
  44. package/dist/analysis/bot_usage/kibana_bot_queries.d.ts +1 -21
  45. package/dist/analysis/chain_pool.d.ts +3 -1
  46. package/dist/analysis/chart_ui.d.ts +5 -2
  47. package/dist/analysis/chart_ui.js +6 -3
  48. package/dist/analysis/chart_utils.d.ts +5 -5
  49. package/dist/analysis/chart_utils.js +9 -0
  50. package/dist/analysis/fills_cache.d.ts +64 -0
  51. package/dist/analysis/fills_cache.js +254 -0
  52. package/dist/analysis/fills_source.d.ts +2 -2
  53. package/dist/analysis/fills_source.js +19 -14
  54. package/dist/analysis/grid_correction_check.d.ts +1 -1
  55. package/dist/analysis/grid_correction_check.js +12 -11
  56. package/dist/analysis/math_utils.d.ts +7 -6
  57. package/dist/analysis/math_utils.js +5 -8
  58. package/dist/analysis/pnl_report.d.ts +39 -0
  59. package/dist/analysis/pnl_report.js +325 -0
  60. package/dist/analysis/price_sources.d.ts +8 -8
  61. package/dist/analysis/price_sources.js +5 -4
  62. package/dist/analysis/resolve_bot_accounts.js +2 -2
  63. package/dist/analysis/resolve_source.d.ts +1 -2
  64. package/dist/analysis/trade_profitability.d.ts +32 -2
  65. package/dist/analysis/trade_profitability.js +232 -106
  66. package/dist/analysis/tradingview/analyze_tradingview.d.ts +17 -6
  67. package/dist/analysis/tradingview/analyze_tradingview.js +9 -10
  68. package/dist/analysis/tradingview/grid_reset_config.d.ts +42 -31
  69. package/dist/analysis/tradingview/grid_reset_config.js +35 -6
  70. package/dist/analysis/tradingview/grid_reset_sim.d.ts +75 -8
  71. package/dist/analysis/tradingview/grid_reset_sim.js +42 -5
  72. package/dist/analysis/tradingview/tradingview_uplot_chart_generator.d.ts +69 -4
  73. package/dist/analysis/tradingview/tradingview_uplot_chart_generator.js +20 -20
  74. package/dist/analysis/trend_detection/backtest_ama_slope_huber.d.ts +102 -0
  75. package/dist/analysis/trend_detection/backtest_ama_slope_huber.js +725 -0
  76. package/dist/analysis/trend_detection/dynamic_weight_chart_generator.d.ts +63 -1
  77. package/dist/analysis/trend_detection/dynamic_weight_chart_generator.js +27 -112
  78. package/dist/analysis/trend_detection/huber_scale_variants.d.ts +40 -0
  79. package/dist/analysis/trend_detection/huber_scale_variants.js +176 -0
  80. package/dist/analysis/trend_detection/kalman_chart_generator.d.ts +30 -1
  81. package/dist/analysis/trend_detection/kalman_chart_generator.js +3 -3
  82. package/dist/analysis/trend_detection/regime_chart_generator.d.ts +31 -1
  83. package/dist/analysis/trend_detection/regime_chart_generator.js +2 -2
  84. package/dist/analysis/trend_detection/volatility_chart_generator.d.ts +33 -1
  85. package/dist/credential-daemon.js +34 -20
  86. package/dist/dexbot.js +17 -14
  87. package/dist/market_adapter/candle_utils.d.ts +22 -18
  88. package/dist/market_adapter/candle_utils.js +24 -20
  89. package/dist/market_adapter/core/asymmetric_bounds.d.ts +13 -4
  90. package/dist/market_adapter/core/config_normalizers.d.ts +3 -3
  91. package/dist/market_adapter/core/kibana_candles.d.ts +53 -18
  92. package/dist/market_adapter/core/kibana_candles.js +9 -7
  93. package/dist/market_adapter/core/kibana_client.d.ts +9 -1
  94. package/dist/market_adapter/core/kibana_client.js +8 -7
  95. package/dist/market_adapter/core/kibana_market_candles.d.ts +3 -2
  96. package/dist/market_adapter/core/market_adapter_service.d.ts +297 -115
  97. package/dist/market_adapter/core/market_adapter_service.js +184 -101
  98. package/dist/market_adapter/core/strategies/ama.d.ts +10 -2
  99. package/dist/market_adapter/core/strategies/ama.js +7 -32
  100. package/dist/market_adapter/core/strategies/ama_slope_model.d.ts +14 -1
  101. package/dist/market_adapter/core/strategies/ama_slope_model.js +12 -34
  102. package/dist/market_adapter/core/strategies/atr/calculator.d.ts +7 -2
  103. package/dist/market_adapter/core/strategies/atr/calculator.js +2 -34
  104. package/dist/market_adapter/core/strategies/collateral_manager.d.ts +7 -1
  105. package/dist/market_adapter/core/strategies/collateral_manager.js +0 -22
  106. package/dist/market_adapter/core/strategies/dynamic_weight_series.d.ts +36 -8
  107. package/dist/market_adapter/core/strategies/dynamic_weight_series.js +9 -9
  108. package/dist/market_adapter/core/strategies/regime_gate.d.ts +24 -15
  109. package/dist/market_adapter/core/strategies/regime_gate.js +4 -31
  110. package/dist/market_adapter/core/strategies/regime_interp.d.ts +7 -1
  111. package/dist/market_adapter/core/strategies/regime_interp.js +14 -22
  112. package/dist/market_adapter/core/strategies/volatility_shift.d.ts +11 -1
  113. package/dist/market_adapter/core/strategies/volatility_shift.js +0 -13
  114. package/dist/market_adapter/inputs/cex_candle_parsing.d.ts +29 -0
  115. package/dist/market_adapter/inputs/cex_candle_parsing.js +52 -0
  116. package/dist/market_adapter/inputs/fetch_book_data.d.ts +20 -4
  117. package/dist/market_adapter/inputs/fetch_book_data.js +3 -1
  118. package/dist/market_adapter/inputs/fetch_cex_synthetic_data.js +97 -226
  119. package/dist/market_adapter/inputs/fetch_lp_data.d.ts +42 -7
  120. package/dist/market_adapter/inputs/fetch_lp_data.js +22 -15
  121. package/dist/market_adapter/inputs/kibana_feed_source.d.ts +74 -15
  122. package/dist/market_adapter/inputs/kibana_feed_source.js +29 -22
  123. package/dist/market_adapter/inputs/kibana_source.d.ts +25 -3
  124. package/dist/market_adapter/inputs/kibana_source.js +2 -2
  125. package/dist/market_adapter/inputs/window_cache.d.ts +99 -94
  126. package/dist/market_adapter/inputs/window_cache.js +8 -8
  127. package/dist/market_adapter/interval_utils.d.ts +4 -4
  128. package/dist/market_adapter/log_format.d.ts +6 -6
  129. package/dist/market_adapter/log_format.js +28 -22
  130. package/dist/market_adapter/lp_chart_core.d.ts +22 -1
  131. package/dist/market_adapter/lp_chart_core.js +26 -192
  132. package/dist/market_adapter/lp_chart_runner.d.ts +7 -7
  133. package/dist/market_adapter/lp_chart_strategy_loader.d.ts +41 -6
  134. package/dist/market_adapter/lp_chart_strategy_loader.js +8 -7
  135. package/dist/market_adapter/market_adapter.d.ts +94 -33
  136. package/dist/market_adapter/market_adapter.js +69 -75
  137. package/dist/market_adapter/utils/adapter_client.d.ts +3 -3
  138. package/dist/market_adapter/utils/adapter_client.js +2 -2
  139. package/dist/market_adapter/utils/atomic_write.d.ts +8 -1
  140. package/dist/market_adapter/utils/chain.d.ts +50 -41
  141. package/dist/market_adapter/utils/chain.js +40 -46
  142. package/dist/market_adapter/utils/data_discovery.d.ts +4 -1
  143. package/dist/market_adapter/utils/dynamic_grid_snapshot.d.ts +12 -3
  144. package/dist/market_adapter/utils/file_json_cache.d.ts +2 -2
  145. package/dist/market_adapter/utils/file_lock.d.ts +28 -14
  146. package/dist/market_adapter/utils/file_lock.js +36 -32
  147. package/dist/market_adapter/utils/native_history.d.ts +9 -2
  148. package/dist/market_adapter/utils/native_history.js +35 -28
  149. package/dist/modules/account_bots.d.ts +577 -21
  150. package/dist/modules/account_bots.js +182 -158
  151. package/dist/modules/account_orders.d.ts +66 -30
  152. package/dist/modules/account_orders.js +22 -20
  153. package/dist/modules/authority_resolver.d.ts +12 -2
  154. package/dist/modules/authority_resolver.js +15 -8
  155. package/dist/modules/bitshares-native/chain_client.d.ts +38 -3
  156. package/dist/modules/bitshares-native/chain_client.js +45 -46
  157. package/dist/modules/bitshares-native/crypto/ecc.browser.js +11 -171
  158. package/dist/modules/bitshares-native/crypto/ecc.js +13 -176
  159. package/dist/modules/bitshares-native/crypto/ecc_core.d.ts +33 -0
  160. package/dist/modules/bitshares-native/crypto/ecc_core.js +213 -0
  161. package/dist/modules/bitshares-native/crypto/ecc_selector.d.ts +2 -1
  162. package/dist/modules/bitshares-native/crypto/ecc_selector.js +1 -13
  163. package/dist/modules/bitshares-native/index.d.ts +1 -1
  164. package/dist/modules/bitshares-native/lru_cache.d.ts +7 -7
  165. package/dist/modules/bitshares-native/resolvers.d.ts +18 -6
  166. package/dist/modules/bitshares-native/serial/lazy_buffer.d.ts +4 -0
  167. package/dist/modules/bitshares-native/serial/lazy_buffer.js +21 -0
  168. package/dist/modules/bitshares-native/serial/operations.d.ts +1 -1
  169. package/dist/modules/bitshares-native/serial/serializer.d.ts +16 -12
  170. package/dist/modules/bitshares-native/serial/serializer.js +7 -13
  171. package/dist/modules/bitshares-native/serial/types.d.ts +25 -16
  172. package/dist/modules/bitshares-native/serial/types.js +55 -62
  173. package/dist/modules/bitshares-native/signing_client.d.ts +32 -2
  174. package/dist/modules/bitshares-native/signing_client.js +19 -14
  175. package/dist/modules/bitshares-native/subscriptions.d.ts +81 -1
  176. package/dist/modules/bitshares-native/subscriptions.js +12 -12
  177. package/dist/modules/bitshares-native/transport.d.ts +5 -4
  178. package/dist/modules/bitshares-native/transport.js +5 -4
  179. package/dist/modules/bitshares-native/tx/builder.d.ts +40 -5
  180. package/dist/modules/bitshares-native/tx/builder.js +4 -3
  181. package/dist/modules/bitshares-native/tx/tx_cache.d.ts +4 -4
  182. package/dist/modules/bitshares_client.d.ts +45 -13
  183. package/dist/modules/bitshares_client.js +28 -19
  184. package/dist/modules/bot_defaults.d.ts +6 -15
  185. package/dist/modules/bot_defaults.js +1 -5
  186. package/dist/modules/bot_settings.d.ts +44 -10
  187. package/dist/modules/bot_settings.js +11 -8
  188. package/dist/modules/bots_file_lock.d.ts +6 -6
  189. package/dist/modules/bots_file_lock.js +16 -12
  190. package/dist/modules/broadcast_failure.d.ts +2 -2
  191. package/dist/modules/broadcast_failure.js +5 -4
  192. package/dist/modules/chain_keys.d.ts +42 -40
  193. package/dist/modules/chain_keys.js +53 -45
  194. package/dist/modules/chain_orders.d.ts +93 -59
  195. package/dist/modules/chain_orders.js +31 -23
  196. package/dist/modules/constants.d.ts +530 -32
  197. package/dist/modules/constants.js +52 -60
  198. package/dist/modules/cr_planner.d.ts +40 -2
  199. package/dist/modules/credential_policy.d.ts +68 -8
  200. package/dist/modules/credential_policy.js +37 -31
  201. package/dist/modules/credential_session_cache.d.ts +2 -2
  202. package/dist/modules/credit_pricing.d.ts +42 -6
  203. package/dist/modules/credit_pricing.js +44 -30
  204. package/dist/modules/credit_runtime.d.ts +276 -118
  205. package/dist/modules/credit_runtime.js +462 -165
  206. package/dist/modules/crypto/browser_provider.js +6 -4
  207. package/dist/modules/crypto/node_provider.js +1 -1
  208. package/dist/modules/crypto/pure_scrypt.js +35 -4
  209. package/dist/modules/crypto/pure_secp256k1.js +72 -26
  210. package/dist/modules/crypto/sync.d.ts +9 -9
  211. package/dist/modules/crypto/sync.js +16 -9
  212. package/dist/modules/dexbot_class.d.ts +195 -139
  213. package/dist/modules/dexbot_class.js +78 -28
  214. package/dist/modules/dexbot_cow_runtime.d.ts +167 -87
  215. package/dist/modules/dexbot_cow_runtime.js +248 -206
  216. package/dist/modules/dexbot_credential_client.d.ts +19 -11
  217. package/dist/modules/dexbot_fill_runtime.d.ts +63 -48
  218. package/dist/modules/dexbot_fill_runtime.js +48 -41
  219. package/dist/modules/dexbot_maintenance_runtime.d.ts +109 -70
  220. package/dist/modules/dexbot_maintenance_runtime.js +117 -80
  221. package/dist/modules/dexbot_startup_runtime.d.ts +11 -10
  222. package/dist/modules/dexbot_startup_runtime.js +43 -43
  223. package/dist/modules/dexbot_state_recovery.d.ts +13 -12
  224. package/dist/modules/dexbot_state_recovery.js +18 -13
  225. package/dist/modules/fund_registry.d.ts +4 -2
  226. package/dist/modules/fund_registry.js +10 -10
  227. package/dist/modules/general_settings.d.ts +30 -4
  228. package/dist/modules/graceful_shutdown.d.ts +3 -3
  229. package/dist/modules/graceful_shutdown.js +2 -2
  230. package/dist/modules/grid_price_source.d.ts +1 -1
  231. package/dist/modules/key_store.d.ts +14 -8
  232. package/dist/modules/key_store.js +7 -6
  233. package/dist/modules/launcher/adapter_requirement.d.ts +11 -5
  234. package/dist/modules/launcher/adapter_requirement.js +5 -5
  235. package/dist/modules/launcher/bot_supervisor.d.ts +106 -24
  236. package/dist/modules/launcher/bot_supervisor.js +12 -11
  237. package/dist/modules/launcher/credential_bootstrap.d.ts +1 -1
  238. package/dist/modules/launcher/credential_bootstrap.js +1 -1
  239. package/dist/modules/launcher/credential_daemon.d.ts +4 -4
  240. package/dist/modules/launcher/credential_daemon.js +2 -2
  241. package/dist/modules/launcher/credential_secret.d.ts +1 -1
  242. package/dist/modules/launcher/foreign_cred_daemon.d.ts +2 -2
  243. package/dist/modules/launcher/market_adapter_runtime.d.ts +61 -6
  244. package/dist/modules/launcher/market_adapter_watchdog.d.ts +10 -2
  245. package/dist/modules/launcher/market_adapter_watchdog.js +4 -0
  246. package/dist/modules/launcher/monolithic_runtime.d.ts +18 -16
  247. package/dist/modules/launcher/status_reporting.d.ts +22 -14
  248. package/dist/modules/launcher/supervisor_control.d.ts +8 -1
  249. package/dist/modules/launcher/supervisor_control.js +4 -2
  250. package/dist/modules/market_adapter_whitelist.d.ts +9 -3
  251. package/dist/modules/market_adapter_whitelist.js +15 -3
  252. package/dist/modules/node_manager.d.ts +41 -11
  253. package/dist/modules/node_manager.js +5 -4
  254. package/dist/modules/order/accounting.d.ts +53 -24
  255. package/dist/modules/order/accounting.js +40 -14
  256. package/dist/modules/order/async_lock.d.ts +5 -2
  257. package/dist/modules/order/async_lock.js +1 -1
  258. package/dist/modules/order/export.d.ts +7 -6
  259. package/dist/modules/order/export.js +1 -7
  260. package/dist/modules/order/format.d.ts +39 -19
  261. package/dist/modules/order/format.js +62 -16
  262. package/dist/modules/order/genesis_policy.d.ts +21 -18
  263. package/dist/modules/order/genesis_policy.js +12 -8
  264. package/dist/modules/order/grid.d.ts +142 -36
  265. package/dist/modules/order/grid.js +148 -123
  266. package/dist/modules/order/grid_reconcile.d.ts +21 -20
  267. package/dist/modules/order/grid_reconcile.js +13 -12
  268. package/dist/modules/order/grid_reconcile_internal.d.ts +85 -72
  269. package/dist/modules/order/grid_reconcile_internal.js +28 -19
  270. package/dist/modules/order/index.d.ts +263 -1
  271. package/dist/modules/order/logger.d.ts +45 -11
  272. package/dist/modules/order/logger.js +38 -40
  273. package/dist/modules/order/logger_state.d.ts +4 -4
  274. package/dist/modules/order/manager.d.ts +226 -180
  275. package/dist/modules/order/manager.js +101 -83
  276. package/dist/modules/order/processed_fill_store.d.ts +18 -3
  277. package/dist/modules/order/processed_fill_store.js +16 -27
  278. package/dist/modules/order/strategy.d.ts +21 -13
  279. package/dist/modules/order/strategy.js +5 -6
  280. package/dist/modules/order/sync_engine.d.ts +91 -33
  281. package/dist/modules/order/sync_engine.js +99 -54
  282. package/dist/modules/order/utils/math.d.ts +157 -102
  283. package/dist/modules/order/utils/math.js +77 -38
  284. package/dist/modules/order/utils/order.d.ts +326 -106
  285. package/dist/modules/order/utils/order.js +200 -99
  286. package/dist/modules/order/utils/slot.d.ts +1 -1
  287. package/dist/modules/order/utils/system.d.ts +176 -26
  288. package/dist/modules/order/utils/system.js +86 -69
  289. package/dist/modules/order/utils/validate.d.ts +89 -41
  290. package/dist/modules/order/utils/validate.js +24 -22
  291. package/dist/modules/order/utils/withPoolRef.d.ts +4 -3
  292. package/dist/modules/order/utils/withPoolRef.js +18 -12
  293. package/dist/modules/order/working_grid.d.ts +14 -13
  294. package/dist/modules/paths.d.ts +3 -4
  295. package/dist/modules/paths.js +3 -27
  296. package/dist/modules/process_discovery.d.ts +1 -1
  297. package/dist/modules/process_discovery.js +2 -1
  298. package/dist/modules/runtime.d.ts +7 -3
  299. package/dist/modules/runtime.js +4 -3
  300. package/dist/modules/runtime_settings.d.ts +15 -10
  301. package/dist/modules/runtime_settings.js +30 -24
  302. package/dist/modules/settings_merge.d.ts +29 -3
  303. package/dist/modules/settings_merge.js +56 -78
  304. package/dist/modules/socket_json_client.d.ts +7 -4
  305. package/dist/modules/storage/browser_adapter.d.ts +38 -53
  306. package/dist/modules/storage/browser_adapter.js +7 -30
  307. package/dist/modules/storage/index.d.ts +1 -1
  308. package/dist/modules/storage/node_adapter.d.ts +45 -27
  309. package/dist/modules/storage/node_adapter.js +9 -9
  310. package/dist/modules/storage/types.d.ts +5 -4
  311. package/dist/modules/types.d.ts +1071 -2
  312. package/dist/modules/types.js +4 -1
  313. package/dist/modules/utils/asset_symbols.d.ts +2 -1
  314. package/dist/modules/utils/asset_symbols.js +2 -1
  315. package/dist/modules/utils/errors.d.ts +9 -0
  316. package/dist/modules/utils/errors.js +23 -1
  317. package/dist/modules/utils/time_range.d.ts +4 -0
  318. package/dist/modules/utils/time_range.js +18 -0
  319. package/dist/modules/validate_profiles.js +53 -43
  320. package/dist/modules/version_notice.d.ts +14 -3
  321. package/dist/modules/version_notice.js +6 -4
  322. package/dist/pm2.d.ts +29 -27
  323. package/dist/pm2.js +5 -5
  324. package/dist/scripts/analyze-credit.d.ts +2 -1
  325. package/dist/scripts/analyze-credit.js +23 -24
  326. package/dist/scripts/analyze-orders.d.ts +77 -9
  327. package/dist/scripts/analyze-orders.js +66 -84
  328. package/dist/scripts/chart_command.d.ts +27 -18
  329. package/dist/scripts/chart_command.js +16 -15
  330. package/dist/scripts/check_any.d.ts +18 -0
  331. package/dist/scripts/check_any.js +126 -0
  332. package/dist/scripts/diagnose-pool-history.js +12 -7
  333. package/dist/scripts/pnl.d.ts +3 -0
  334. package/dist/scripts/pnl.js +40 -0
  335. package/dist/scripts/print_grid.js +0 -1
  336. package/dist/scripts/run-tests.js +39 -7
  337. package/dist/scripts/runner.js +1 -1
  338. package/dist/scripts/test-credit-renewal.js +30 -21
  339. package/dist/scripts/update.d.ts +10 -5
  340. package/dist/scripts/update.js +168 -103
  341. package/dist/scripts/update_dist_freshness.js +1 -0
  342. package/dist/scripts/update_layout.d.ts +61 -0
  343. package/dist/scripts/update_layout.js +180 -0
  344. package/dist/scripts/validate_bots.js +2 -1
  345. package/dist/scripts/verify-browser-bundle.js +8 -0
  346. package/dist/unlock.d.ts +28 -3
  347. package/dist/unlock.js +72 -10
  348. package/docs/BITSHARES_ONBOARDING.md +2 -0
  349. package/docs/COPY_ON_WRITE_MASTER_PLAN.md +1 -1
  350. package/docs/COW_INVARIANTS.md +13 -6
  351. package/docs/DEXBOT_COMPARISON.md +8 -8
  352. package/docs/EVOLUTION.md +12 -10
  353. package/docs/FUND_MOVEMENT_AND_ACCOUNTING.md +5 -5
  354. package/docs/GRID_RECALCULATION.md +15 -16
  355. package/docs/GRID_RECONCILE.md +14 -3
  356. package/docs/LIFECYCLE.md +11 -11
  357. package/docs/MPA_CREDIT_USAGE.md +22 -3
  358. package/docs/README.md +15 -4
  359. package/docs/WORKFLOW.md +1 -0
  360. package/docs/architecture.md +12 -9
  361. package/docs/developer_guide.md +6 -6
  362. package/market_adapter/README.md +9 -26
  363. package/modules/README.md +4 -1
  364. package/package.json +4 -1
  365. package/scripts/README.md +14 -0
@@ -1,5 +1,17 @@
1
+ import type { BotLike, OrderManagerLike, ManagedOrder } from './types.js';
2
+ /** Loose JSON-object view used across the maintenance runtime. */
3
+ type JsonObj = Record<string, unknown>;
4
+ /** A stranded/held chain order as seen by the deferred-hold helpers. */
5
+ interface HeldChainOrder {
6
+ type?: unknown;
7
+ price?: unknown;
8
+ size?: unknown;
9
+ reason?: unknown;
10
+ chainOrderId?: unknown;
11
+ [key: string]: unknown;
12
+ }
1
13
  import { usesAmaGridPrice } from './grid_price_source.js';
2
- declare function isWrapperAdapterOwner(...args: any): any;
14
+ declare function isWrapperAdapterOwner(...args: unknown[]): any;
3
15
  /**
4
16
  * Check if a bot configuration uses an AMA grid price source.
5
17
  *
@@ -10,25 +22,29 @@ declare function isWrapperAdapterOwner(...args: any): any;
10
22
  /**
11
23
  * Find a bot entry in the bots config snapshot that matches a runtime config.
12
24
  * Matches by botKey or name.
13
- * @param {any} snapshot - Bots configuration snapshot
25
+ * @param {unknown} snapshot - Bots configuration snapshot
14
26
  * @param {Object} config - Runtime bot configuration
15
27
  * @returns {Object|null} Matched bot entry or null
16
28
  */
17
- declare function findSnapshotBotForRuntimeConfig(snapshot: any, config: any): any;
29
+ declare function findSnapshotBotForRuntimeConfig(snapshot: {
30
+ activeBots?: BotLike[];
31
+ }, config: JsonObj): BotLike | null;
18
32
  /**
19
33
  * Check if a runtime bot configuration requires the market adapter.
20
- * @param {any} snapshot - Bots configuration snapshot
34
+ * @param {unknown} snapshot - Bots configuration snapshot
21
35
  * @param {Object} config - Runtime bot configuration
22
36
  * @returns {boolean} True if the bot uses AMA grid pricing
23
37
  */
24
- declare function runtimeConfigNeedsMarketAdapter(snapshot: any, config: any): boolean;
38
+ declare function runtimeConfigNeedsMarketAdapter(snapshot: {
39
+ activeBots?: BotLike[];
40
+ }, config: JsonObj): boolean;
25
41
  /**
26
42
  * Build the full-entry fingerprint for one bot (stable across key order and
27
43
  * comment/whitespace edits, since those never reach the parsed entry).
28
- * @param {any} entry - Raw bot entry from bots.json
44
+ * @param {unknown} entry - Raw bot entry from bots.json
29
45
  * @returns {string} Fingerprint ('' when entry is missing)
30
46
  */
31
- declare function buildBotConfigFingerprint(entry: any): string;
47
+ declare function buildBotConfigFingerprint(entry: unknown): string;
32
48
  /**
33
49
  * Check bots.json for this bot's entry and live-apply allowlisted keys
34
50
  * (BOT_LIVE_CONFIG_KEYS; debtPolicy additionally reconciles the credit
@@ -46,12 +62,12 @@ declare function buildBotConfigFingerprint(entry: any): string;
46
62
  * the baseline with no hint. Corrupt/unreadable files and missing entries
47
63
  * never touch the stored fingerprint (except the missing-entry hint
48
64
  * throttle) so the next tick re-evaluates.
49
- * @param {any} bot - DEXBot instance
65
+ * @param {unknown} bot - DEXBot instance
50
66
  * @param {string} [context='bots-config poll'] - Context label for logging
51
- * @param {any} [preloadedSnapshot=null] - Reuse an already-loaded snapshot
67
+ * @param {unknown} [preloadedSnapshot=null] - Reuse an already-loaded snapshot
52
68
  * @returns {Promise<any>} Result with applied/liveChanges/otherKeys or skipped
53
69
  */
54
- declare function checkAndApplyBotConfigChanges(bot: any, context?: any, preloadedSnapshot?: any): Promise<any>;
70
+ declare function checkAndApplyBotConfigChanges(bot: BotLike, context?: string, preloadedSnapshot?: JsonObj | null): Promise<unknown>;
55
71
  /**
56
72
  * Count live on-chain reserve orders for one side (issue #27 follow-up).
57
73
  *
@@ -71,27 +87,27 @@ declare function checkAndApplyBotConfigChanges(bot: any, context?: any, preloade
71
87
  * window = bottom slots = floor edge) makes the edge pick land on window
72
88
  * members and the count reads N/N with zero dedicated reserves, so the
73
89
  * deficit never fires (issue #27 follow-up).
74
- * @param {any} manager - OrderManager
75
- * @param {any} config - Bot configuration (reserve count source)
76
- * @param {any} type - ORDER_TYPES.BUY or ORDER_TYPES.SELL
90
+ * @param {unknown} manager - OrderManager
91
+ * @param {unknown} config - Bot configuration (reserve count source)
92
+ * @param {unknown} type - ORDER_TYPES.BUY or ORDER_TYPES.SELL
77
93
  * @returns {number|null} Live reserve count, or null when unclassifiable
78
94
  */
79
- declare function countLiveReserveOrders(manager: any, config: any, type: any): number | null;
80
- declare function getTargetedSyncReason(bot: any): {
95
+ declare function countLiveReserveOrders(manager: OrderManagerLike, config: JsonObj, type: unknown): number | null;
96
+ declare function getTargetedSyncReason(bot: BotLike): {
81
97
  reason: string;
82
98
  targetBuy: any;
83
99
  targetSell: any;
84
- liveBuy: any;
85
- liveSell: any;
86
- drift: any;
100
+ liveBuy: number;
101
+ liveSell: number;
102
+ drift: import("./types.js").FundDriftCheck;
87
103
  } | null;
88
- declare function maybeRunTargetedDriftReconciliation(bot: any, context: any): Promise<boolean>;
104
+ declare function maybeRunTargetedDriftReconciliation(bot: BotLike, context: string): Promise<boolean>;
89
105
  /**
90
106
  * Load and fingerprint the bots.json configuration file.
91
107
  * Delegates to the canonical launcher/adapter_requirement helper so the
92
108
  * fingerprint is semantic (AMA-relevant changes only) and identical to the
93
109
  * unlock wrapper watchdog's view of the same file.
94
- * @returns {any} Snapshot with exists flag, fingerprint, active bots list, and adapter requirement
110
+ * @returns {unknown} Snapshot with exists flag, fingerprint, active bots list, and adapter requirement
95
111
  */
96
112
  declare function loadBotsConfigSnapshot(): any;
97
113
  /**
@@ -106,15 +122,15 @@ declare function stopMarketAdapterPm2(): Promise<void>;
106
122
  * @param {string} [context='periodic'] - Context label for logging
107
123
  * @returns {Promise<any>}
108
124
  */
109
- declare function syncMarketAdapterOnPeriodicConfigCheck(bot: any, context?: any): Promise<any>;
125
+ declare function syncMarketAdapterOnPeriodicConfigCheck(bot: BotLike, context?: string): Promise<unknown>;
110
126
  /**
111
127
  * Refresh the dynamic weight distribution from the AMA center snapshot.
112
128
  * Applies live dynamic weights if the bot is whitelisted and weights are ready.
113
129
  * @param {import('./dexbot_class.js').DEXBot} bot
114
130
  * @param {string} [context='runtime'] - Context label for logging
115
- * @returns {any}
131
+ * @returns {unknown}
116
132
  */
117
- declare function refreshDynamicWeightDistribution(bot: any, context?: any): {
133
+ declare function refreshDynamicWeightDistribution(bot: BotLike, context?: string): {
118
134
  applied: boolean;
119
135
  source: string;
120
136
  weightDistribution: any;
@@ -123,7 +139,7 @@ declare function refreshDynamicWeightDistribution(bot: any, context?: any): {
123
139
  applied: boolean;
124
140
  source: string;
125
141
  weightDistribution: any;
126
- snapshotUpdatedAt: any;
142
+ snapshotUpdatedAt: {} | null;
127
143
  };
128
144
  /**
129
145
  * Update the grid reset metadata (last reset timestamp and source) in the dynamic grid snapshot.
@@ -133,7 +149,7 @@ declare function refreshDynamicWeightDistribution(bot: any, context?: any): {
133
149
  * @param {string} [options.resetSource] - Source label for the reset (defaults to 'dexbot_grid_resync')
134
150
  * @returns {boolean} True if metadata was written
135
151
  */
136
- declare function updateBotGridResetMetadata(botKey: any, options?: {
152
+ declare function updateBotGridResetMetadata(botKey: string | undefined, options?: {
137
153
  resetAt?: string;
138
154
  resetSource?: string;
139
155
  }): any;
@@ -141,11 +157,11 @@ declare function updateBotGridResetMetadata(botKey: any, options?: {
141
157
  * Perform a full grid resync: reload config, optionally refresh center price,
142
158
  * recalculate the grid, persist, and record reset metadata.
143
159
  * @param {import('./dexbot_class.js').DEXBot} bot
144
- * @param {any} [options] - Grid resync options
160
+ * @param {unknown} [options] - Grid resync options
145
161
  * @param {boolean} [options.skipIdle=false] - Skip the idle-cooldown deferral
146
162
  * @returns {Promise<boolean>} True if resync succeeded
147
163
  */
148
- declare function performGridResync(bot: any, options?: {
164
+ declare function performGridResync(bot: BotLike, options?: {
149
165
  refreshCenterPrice?: boolean;
150
166
  centerRefreshContext?: string;
151
167
  centerRefreshLabel?: string;
@@ -158,21 +174,21 @@ declare function performGridResync(bot: any, options?: {
158
174
  * @param {import('./dexbot_class.js').DEXBot} bot
159
175
  * @returns {Promise<boolean>} True if reset was handled successfully
160
176
  */
161
- declare function handlePendingTriggerReset(bot: any): Promise<boolean>;
177
+ declare function handlePendingTriggerReset(bot: BotLike): Promise<boolean>;
162
178
  /**
163
179
  * Set up a file watcher on the profiles directory to detect trigger file creation.
164
180
  * When a trigger file appears, debounces and processes the grid resync.
165
181
  * @param {import('./dexbot_class.js').DEXBot} bot
166
182
  * @returns {Promise<void>}
167
183
  */
168
- declare function setupTriggerFileDetection(bot: any): Promise<void>;
184
+ declare function setupTriggerFileDetection(bot: BotLike): Promise<void>;
169
185
  /**
170
186
  * Perform periodic grid health checks (divergence, spread condition, dust detection).
171
187
  * Called as part of the periodic blockchain fetch interval.
172
188
  * @param {import('./dexbot_class.js').DEXBot} bot
173
189
  * @returns {Promise<void>}
174
190
  */
175
- declare function performPeriodicGridChecks(bot: any): Promise<void>;
191
+ declare function performPeriodicGridChecks(bot: BotLike): Promise<void>;
176
192
  /**
177
193
  * Summarize deliberate deferred holds once per count change. The per-order
178
194
  * sync logs report each hold when it first appears; this surfaces the running
@@ -186,7 +202,7 @@ declare function performPeriodicGridChecks(bot: any): Promise<void>;
186
202
  *
187
203
  * @param {import('./dexbot_class.js').DEXBot} bot
188
204
  */
189
- declare function logDeferredHoldSummary(bot: any): void;
205
+ declare function logDeferredHoldSummary(bot: BotLike): void;
190
206
  /**
191
207
  * Escalate an INDEFINITELY-HELD deferred hold to a structural resync.
192
208
  *
@@ -204,7 +220,7 @@ declare function logDeferredHoldSummary(bot: any): void;
204
220
  *
205
221
  * Fire-and-forget; the resync is itself debounced and batch-in-flight aware.
206
222
  */
207
- declare function considerDeferredHoldEscalation(bot: any, strandedOrders: any[], strandedMs: number): void;
223
+ declare function considerDeferredHoldEscalation(bot: BotLike, strandedOrders: HeldChainOrder[], strandedMs: number): void;
208
224
  /**
209
225
  * Render the per-order detail for a deferred-hold summary: side, price, size,
210
226
  * why it is held, and distance from the nearest grid bound when known.
@@ -213,36 +229,36 @@ declare function considerDeferredHoldEscalation(bot: any, strandedOrders: any[],
213
229
  * a near-miss (a few bps outside, likely a rounding/drift artifact) from a
214
230
  * deliberately-placed far order (dip protection after a grid reset).
215
231
  */
216
- declare function describeDeferredHolds(bot: any, heldOrders: any[]): string;
232
+ declare function describeDeferredHolds(bot: BotLike, heldOrders: HeldChainOrder[]): string;
217
233
  /**
218
234
  * Check if the continuous open-orders sync loop is enabled.
219
235
  * @param {import('./dexbot_class.js').DEXBot} bot
220
236
  * @returns {boolean} True if the sync loop is enabled in TIMING config
221
237
  */
222
- declare function isOpenOrdersSyncLoopEnabled(bot: any): boolean;
238
+ declare function isOpenOrdersSyncLoopEnabled(bot: BotLike): boolean;
223
239
  /**
224
240
  * Start the continuous open-orders sync loop.
225
241
  * Periodically reads on-chain orders and synchronizes with the grid manager.
226
242
  * @param {import('./dexbot_class.js').DEXBot} bot
227
243
  */
228
- declare function startOpenOrdersSyncLoop(bot: any): void;
244
+ declare function startOpenOrdersSyncLoop(bot: BotLike): void;
229
245
  /**
230
246
  * Stop the continuous open-orders sync loop.
231
247
  * @param {import('./dexbot_class.js').DEXBot} bot
232
248
  * @returns {Promise<void>}
233
249
  */
234
- declare function stopOpenOrdersSyncLoop(bot: any): Promise<void>;
250
+ declare function stopOpenOrdersSyncLoop(bot: BotLike): Promise<void>;
235
251
  /**
236
252
  * Set up the periodic blockchain fetch interval.
237
253
  * Periodically fetches account totals and syncs open orders from the blockchain.
238
254
  * @param {import('./dexbot_class.js').DEXBot} bot
239
255
  */
240
- declare function setupBlockchainFetchInterval(bot: any): void;
256
+ declare function setupBlockchainFetchInterval(bot: BotLike): void;
241
257
  /**
242
258
  * Stop the periodic blockchain fetch interval.
243
259
  * @param {import('./dexbot_class.js').DEXBot} bot
244
260
  */
245
- declare function stopBlockchainFetchInterval(bot: any): void;
261
+ declare function stopBlockchainFetchInterval(bot: BotLike): void;
246
262
  /**
247
263
  * Set up the periodic bots.json poll interval.
248
264
  * Runs in ALL modes (including wrapper-owned monolithic): the tick drives
@@ -255,12 +271,12 @@ declare function stopBlockchainFetchInterval(bot: any): void;
255
271
  * (default 1min, shared with the wrapper watchdog interval).
256
272
  * @param {import('./dexbot_class.js').DEXBot} bot
257
273
  */
258
- declare function setupBotsConfigPollInterval(bot: any): void;
274
+ declare function setupBotsConfigPollInterval(bot: BotLike): void;
259
275
  /**
260
276
  * Stop the periodic bots.json fingerprint poll interval.
261
277
  * @param {import('./dexbot_class.js').DEXBot} bot
262
278
  */
263
- declare function stopBotsConfigPollInterval(bot: any): void;
279
+ declare function stopBotsConfigPollInterval(bot: BotLike): void;
264
280
  /**
265
281
  * Release the market adapter runtime for a bot.
266
282
  * In PM2 mode this is a no-op; in direct mode it calls the shared runtime's releaseBot.
@@ -269,7 +285,7 @@ declare function stopBotsConfigPollInterval(bot: any): void;
269
285
  * @param {string} [context='shutdown'] - Context label for logging
270
286
  * @returns {Promise<any>}
271
287
  */
272
- declare function releaseMarketAdapterRuntime(_bot: any, botId: any, context?: any): Promise<any>;
288
+ declare function releaseMarketAdapterRuntime(_bot: unknown, botId: string, context?: string): Promise<any>;
273
289
  /**
274
290
  * Check if an error message indicates that an order does not exist on the blockchain.
275
291
  * Delegates to the canonical implementation in order/utils/order.ts (single source
@@ -278,7 +294,7 @@ declare function releaseMarketAdapterRuntime(_bot: any, botId: any, context?: an
278
294
  * @param {string} [orderId] - Optional order ID for context-aware matching
279
295
  * @returns {boolean} True if the message indicates a nonexistent order
280
296
  */
281
- declare function isOrderDoesNotExistError(message: any, orderId: any): any;
297
+ declare function isOrderDoesNotExistError(message: unknown, orderId: string): any;
282
298
  /**
283
299
  * 7a: pre-acquire broadcast deferral for timer-driven lock waiters.
284
300
  *
@@ -297,10 +313,10 @@ declare function isOrderDoesNotExistError(message: any, orderId: any): any;
297
313
  * manager._broadcastingStartedAt on every holder, so its age stays small;
298
314
  * a frozen timestamp ages past BROADCAST_STALE_CLEAR_MS and we let the tick
299
315
  * through so maintenance can hard-reset the flag.
300
- * @param {any} bot
316
+ * @param {unknown} bot
301
317
  * @returns {boolean} true when the caller should skip this tick
302
318
  */
303
- declare function shouldDeferMaintenanceForBroadcast(bot: any): boolean;
319
+ declare function shouldDeferMaintenanceForBroadcast(bot: BotLike): boolean;
304
320
  /**
305
321
  * Observability watchdog for _gridLock hold duration. _gridLock has no
306
322
  * acquisition timeout and its callers cannot safely recover from a rejected
@@ -310,10 +326,10 @@ declare function shouldDeferMaintenanceForBroadcast(bot: any): boolean;
310
326
  * any such section visible: when the live hold crosses
311
327
  * TIMING.GRID_LOCK_HOLD_WARN_MS it emits a rate-limited warn. Called from the
312
328
  * maintenance tick so holds outside a broadcast region are observed too.
313
- * @param {any} bot
329
+ * @param {unknown} bot
314
330
  * @returns {number} Observed hold duration in ms (0 when not held)
315
331
  */
316
- declare function checkGridLockHoldDuration(bot: any): number;
332
+ declare function checkGridLockHoldDuration(bot: BotLike): number;
317
333
  /**
318
334
  * Execute the core maintenance logic: recalculate funds, check pipeline,
319
335
  * refresh dynamic weights, check grid health, cancel dust orders,
@@ -322,7 +338,7 @@ declare function checkGridLockHoldDuration(bot: any): number;
322
338
  * @param {string} context - Context label for logging (e.g. 'periodic', 'dust-timer')
323
339
  * @returns {Promise<void>}
324
340
  */
325
- declare function executeMaintenanceLogic(bot: any, context: any): Promise<void>;
341
+ declare function executeMaintenanceLogic(bot: BotLike, context: string): Promise<void>;
326
342
  /**
327
343
  * Out-of-spread persistence watchdog: the never-run-stale backstop.
328
344
  *
@@ -336,12 +352,12 @@ declare function executeMaintenanceLogic(bot: any, context: any): Promise<void>;
336
352
  * dedupe concurrent requests; the re-center moves the boundary, which clears
337
353
  * any held-plan signature). Resets whenever the spread heals or a correction
338
354
  * places orders.
339
- * @param {any} bot
355
+ * @param {unknown} bot
340
356
  * @param {boolean} spreadChecked - Whether the spread check ran this tick
341
357
  * @param {number} ordersPlaced - Correction orders placed this tick
342
358
  * @returns {{staleMs: number, escalated: boolean}}
343
359
  */
344
- export declare function trackOutOfSpreadStaleness(bot: any, spreadChecked: boolean, ordersPlaced: number): {
360
+ export declare function trackOutOfSpreadStaleness(bot: BotLike, spreadChecked: boolean, ordersPlaced: number): {
345
361
  staleMs: number;
346
362
  escalated: boolean;
347
363
  };
@@ -356,13 +372,16 @@ export declare function trackOutOfSpreadStaleness(bot: any, spreadChecked: boole
356
372
  * @param {import('./types.js').Order[]} [options.sell=[]] - Sell-side dust orders
357
373
  * @returns {Promise<{cancelledCount: number, batchResult: {aborted: boolean}|null}>}
358
374
  */
359
- declare function cancelDustOrders(bot: any, { buy: buyDust, sell: sellDust }?: any): Promise<{
375
+ declare function cancelDustOrders(bot: BotLike, { buy: buyDust, sell: sellDust }?: {
376
+ buy?: ManagedOrder[];
377
+ sell?: ManagedOrder[];
378
+ }): Promise<{
360
379
  cancelledCount: number;
361
380
  batchResult: null;
362
381
  } | {
363
382
  cancelledCount: number;
364
383
  batchResult: {
365
- aborted: any;
384
+ aborted: boolean | undefined;
366
385
  };
367
386
  }>;
368
387
  /**
@@ -374,7 +393,7 @@ declare function cancelDustOrders(bot: any, { buy: buyDust, sell: sellDust }?: a
374
393
  * @param {boolean} [options.skipIdle=false] - Skip idle delay check
375
394
  * @returns {Promise<void>}
376
395
  */
377
- declare function runGridMaintenance(bot: any, context?: any, options?: {
396
+ declare function runGridMaintenance(bot: BotLike, context?: string, options?: {
378
397
  skipIdle?: boolean;
379
398
  }): Promise<void>;
380
399
  /**
@@ -384,7 +403,7 @@ declare function runGridMaintenance(bot: any, context?: any, options?: {
384
403
  * @param {import('./dexbot_class.js').DEXBot} bot
385
404
  * @returns {Promise<void>}
386
405
  */
387
- declare function checkBtsBalanceAndAcquire(bot: any): Promise<void>;
406
+ declare function checkBtsBalanceAndAcquire(bot: BotLike): Promise<void>;
388
407
  /**
389
408
  * Acquire BTS by swapping one of the trading pair assets through an AMM pool.
390
409
  * Tries both assets for a BTS pool, picks the best (lowest price impact).
@@ -392,17 +411,17 @@ declare function checkBtsBalanceAndAcquire(bot: any): Promise<void>;
392
411
  * @param {number} deficit - Amount of BTS needed (float)
393
412
  * @returns {Promise<void>}
394
413
  */
395
- declare function acquireBts(bot: any, deficit: any): Promise<void>;
414
+ declare function acquireBts(bot: BotLike, deficit: number): Promise<void>;
396
415
  /**
397
416
  * Run a single dust health check cycle.
398
417
  * @param {import('./dexbot_class.js').DEXBot} bot
399
418
  */
400
- declare function runDustHealthCheck(bot: any): Promise<void>;
419
+ declare function runDustHealthCheck(bot: BotLike): Promise<void>;
401
420
  /**
402
421
  * Set up the periodic dust health check interval.
403
422
  * @param {import('./dexbot_class.js').DEXBot} bot
404
423
  */
405
- declare function setupDustHealthCheckInterval(bot: any): void;
424
+ declare function setupDustHealthCheckInterval(bot: BotLike): void;
406
425
  /**
407
426
  * Request a full grid reset from fresh on-chain state.
408
427
  * @param {import('./dexbot_class.js').DEXBot} bot
@@ -410,40 +429,60 @@ declare function setupDustHealthCheckInterval(bot: any): void;
410
429
  * @param {{refreshCenterPrice?: boolean, skipIdle?: boolean, skipFillLock?: boolean}} [options={}]
411
430
  * @returns {Promise<Object>}
412
431
  */
413
- declare function requestGridReset(bot: any, reason?: any, options?: {
432
+ declare function requestGridReset(bot: BotLike, reason?: string, options?: {
414
433
  refreshCenterPrice?: boolean;
415
434
  skipIdle?: boolean;
416
435
  skipFillLock?: boolean;
417
- }): Promise<any>;
436
+ }): Promise<boolean | {
437
+ skipped: boolean;
438
+ reason: string;
439
+ }>;
418
440
  /**
419
441
  * Wire the structural grid resync request handler on the manager.
420
442
  * @param {import('./dexbot_class.js').DEXBot} bot
421
443
  */
422
- declare function wireStructuralGridResyncRequest(bot: any): void;
444
+ declare function wireStructuralGridResyncRequest(bot: BotLike): void;
423
445
  /**
424
446
  * Get current pipeline signal state for congestion checks.
425
447
  * @param {import('./dexbot_class.js').DEXBot} bot
426
448
  * @returns {Object}
427
449
  */
428
- declare function getPipelineSignals(bot: any): {
429
- incomingFillQueueLength: any;
430
- shadowLocks: any;
450
+ declare function getPipelineSignals(bot: BotLike): {
451
+ incomingFillQueueLength: number;
452
+ shadowLocks: number;
431
453
  batchInFlight: boolean;
432
454
  recoveryInFlight: boolean;
433
- broadcasting: any;
455
+ broadcasting: boolean;
434
456
  };
435
457
  /**
436
458
  * Mark that grid activity occurred (updates idle timer).
437
459
  * @param {import('./dexbot_class.js').DEXBot} bot
438
460
  * @param {string} [reason='activity']
439
461
  */
440
- declare function markGridActivity(bot: any, reason?: any): void;
462
+ declare function markGridActivity(bot: BotLike, reason?: string): void;
441
463
  /**
442
464
  * Get current metrics for monitoring and debugging.
443
465
  * @param {import('./dexbot_class.js').DEXBot} bot
444
466
  * @returns {Object}
445
467
  */
446
- declare function getMetrics(bot: any): any;
468
+ declare function getMetrics(bot: BotLike): {
469
+ queueDepth: number;
470
+ fillProcessingLockActive: boolean;
471
+ divergenceLockActive: boolean;
472
+ shadowLocksActive: number;
473
+ recoveryExhaustedAt: number | null;
474
+ recentFillsTracked: number;
475
+ unmatchedChainOrders: number;
476
+ heldChainOrders: number;
477
+ blockingChainOrders: number;
478
+ fillsProcessed: number;
479
+ batchesExecuted: number;
480
+ fillProcessingTimeMs: number;
481
+ lockContentionEvents: number;
482
+ maxQueueDepth: number;
483
+ gridLockContention: number;
484
+ fundRecalcCount: number;
485
+ };
447
486
  /**
448
487
  * Read open orders from chain, sync with local state, and process any fills found.
449
488
  * Self-guarding wrapper: every path here mutates grid state and can broadcast a
@@ -456,18 +495,18 @@ declare function getMetrics(bot: any): any;
456
495
  * @param {string} tag - Context label for logging
457
496
  * @returns {Promise<Object>}
458
497
  */
459
- declare function syncOpenOrdersAndProcessFills(bot: any, tag: any): Promise<{
498
+ declare function syncOpenOrdersAndProcessFills(bot: BotLike, tag: string): Promise<{
460
499
  syncResult: null;
461
500
  aborted: boolean;
462
501
  hasUnmatched: number;
463
502
  openOrders: null;
464
503
  } | {
465
- syncResult: any;
504
+ syncResult: import("./types.js").SyncResult;
466
505
  aborted: boolean;
467
- hasUnmatched: any;
468
- openOrders: any[];
506
+ hasUnmatched: number;
507
+ openOrders: import("./types.js").ChainOrder[];
469
508
  }>;
470
- export { loadBotsConfigSnapshot, isWrapperAdapterOwner, checkAndApplyBotConfigChanges, buildBotConfigFingerprint, refreshDynamicWeightDistribution, performGridResync, updateBotGridResetMetadata, handlePendingTriggerReset, setupTriggerFileDetection, performPeriodicGridChecks, isOpenOrdersSyncLoopEnabled, startOpenOrdersSyncLoop, stopOpenOrdersSyncLoop, setupBlockchainFetchInterval, stopBlockchainFetchInterval, setupBotsConfigPollInterval, stopBotsConfigPollInterval, executeMaintenanceLogic, getTargetedSyncReason, countLiveReserveOrders, cancelDustOrders, isOrderDoesNotExistError, runGridMaintenance, releaseMarketAdapterRuntime, syncMarketAdapterOnPeriodicConfigCheck, usesAmaGridPrice, runDustHealthCheck, setupDustHealthCheckInterval, requestGridReset, wireStructuralGridResyncRequest, getPipelineSignals, markGridActivity, getMetrics, syncOpenOrdersAndProcessFills, shouldDeferMaintenanceForBroadcast, checkGridLockHoldDuration };
509
+ export { loadBotsConfigSnapshot, isWrapperAdapterOwner, checkAndApplyBotConfigChanges, buildBotConfigFingerprint, refreshDynamicWeightDistribution, performGridResync, updateBotGridResetMetadata, handlePendingTriggerReset, setupTriggerFileDetection, performPeriodicGridChecks, isOpenOrdersSyncLoopEnabled, startOpenOrdersSyncLoop, stopOpenOrdersSyncLoop, setupBlockchainFetchInterval, stopBlockchainFetchInterval, setupBotsConfigPollInterval, stopBotsConfigPollInterval, executeMaintenanceLogic, getTargetedSyncReason, maybeRunTargetedDriftReconciliation, countLiveReserveOrders, cancelDustOrders, isOrderDoesNotExistError, runGridMaintenance, releaseMarketAdapterRuntime, syncMarketAdapterOnPeriodicConfigCheck, usesAmaGridPrice, runDustHealthCheck, setupDustHealthCheckInterval, requestGridReset, wireStructuralGridResyncRequest, getPipelineSignals, markGridActivity, getMetrics, syncOpenOrdersAndProcessFills, shouldDeferMaintenanceForBroadcast, checkGridLockHoldDuration };
471
510
  declare const _default: {
472
511
  loadBotsConfigSnapshot: typeof loadBotsConfigSnapshot;
473
512
  isWrapperAdapterOwner: typeof isWrapperAdapterOwner;