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
@@ -1,28 +1,28 @@
1
- /** Startup runtime - bot initialization, grid placement, and startup sequence */
1
+ import type { BotLike } from './types.js';
2
2
  /**
3
3
  * Initialize the startup state: account orders, manager, persisted data.
4
4
  * @param {import('./dexbot_class.js').DEXBot} bot
5
5
  * @returns {Promise<Object>} startupState
6
6
  */
7
- declare function initializeStartupState(bot: any): Promise<{
8
- persistedGrid: any;
9
- persistedBtsFeesOwed: any;
10
- persistedBoundaryIdx: any;
11
- persistedBtsBalance: any;
12
- persistedRecentFillKeys: any;
13
- persistedGenesis: any;
14
- persistedGapEvacStreaks: any;
7
+ declare function initializeStartupState(bot: BotLike): Promise<{
8
+ persistedGrid: unknown[] | null;
9
+ persistedBtsFeesOwed: unknown;
10
+ persistedBoundaryIdx: number | null;
11
+ persistedBtsBalance: unknown;
12
+ persistedRecentFillKeys: unknown;
13
+ persistedGenesis: {} | null;
14
+ persistedGapEvacStreaks: {} | null;
15
15
  }>;
16
16
  /**
17
17
  * Finish the startup sequence: activate fill listener, reconcile grid, place initial orders.
18
18
  * @param {import('./dexbot_class.js').DEXBot} bot
19
19
  * @param {Object} startupState
20
20
  */
21
- declare function finishStartupSequence(bot: any, startupState: any): Promise<void>;
21
+ declare function finishStartupSequence(bot: BotLike, startupState: Awaited<ReturnType<typeof initializeStartupState>>): Promise<void>;
22
22
  /**
23
23
  * Place initial orders on the blockchain (extracted logic from original placeInitialOrders).
24
24
  * @param {import('./dexbot_class.js').DEXBot} bot
25
25
  */
26
- declare function placeInitialOrdersImpl(bot: any): Promise<void>;
26
+ declare function placeInitialOrdersImpl(bot: BotLike): Promise<void>;
27
27
  export { initializeStartupState, finishStartupSequence, placeInitialOrdersImpl };
28
28
  //# sourceMappingURL=dexbot_startup_runtime.d.ts.map
@@ -1,6 +1,5 @@
1
1
  /** Startup runtime - bot initialization, grid placement, and startup sequence */
2
- import { createRequire } from 'node:module';
3
- const require = createRequire(import.meta.url);
2
+ import { lazyShim } from './lazy_shim.js';
4
3
  import { path } from './path_api.js';
5
4
  import * as chainOrders from './chain_orders.js';
6
5
  import { readOpenOrdersGuarded } from './chain_orders.js';
@@ -16,24 +15,22 @@ import { getErrorMessage } from './utils/errors.js';
16
15
  import { processSweepOrphanFill } from './dexbot_fill_runtime.js';
17
16
  import { ON_MISSING_GENESIS, recordMissingGenesisFault, resolvePersistedGenesis } from './order/genesis_policy.js';
18
17
  const { OrderManager, grid: Grid } = orderModule;
19
- function initializeFeeCache(...args) { return require('./order/utils/system').initializeFeeCache(...args); }
20
- function parseJsonWithComments(...args) { return require('./order/utils/system').parseJsonWithComments(...args); }
21
- function withBlockchainRetry(...args) { return require('./order/utils/system').withBlockchainRetry(...args); }
22
- function buildFillKey(...args) { return require('./order/utils/order').buildFillKey(...args); }
23
- function correctAllPriceMismatches(...args) { return require('./order/utils/order').correctAllPriceMismatches(...args); }
24
- function parseChainOrder(...args) { return require('./order/utils/order').parseChainOrder(...args); }
25
- function restoreGapEvacStreaks(...args) { return require('./order/utils/system').restoreGapEvacStreaks(...args); }
26
- function applyPersistedPendingCrawls(...args) { return require('./order/utils/system').applyPersistedPendingCrawls(...args); }
27
- function startupSleep(...args) { return require('./order/utils/system').sleep(...args); }
18
+ const initializeFeeCache = lazyShim('./order/utils/system', 'initializeFeeCache');
19
+ const parseJsonWithComments = lazyShim('./order/utils/system', 'parseJsonWithComments');
20
+ const withBlockchainRetry = lazyShim('./order/utils/system', 'withBlockchainRetry');
21
+ const buildFillKey = lazyShim('./order/utils/order', 'buildFillKey');
22
+ const correctAllPriceMismatches = lazyShim('./order/utils/order', 'correctAllPriceMismatches');
23
+ const parseChainOrder = lazyShim('./order/utils/order', 'parseChainOrder');
24
+ const restoreGapEvacStreaks = lazyShim('./order/utils/system', 'restoreGapEvacStreaks');
25
+ const applyPersistedPendingCrawls = lazyShim('./order/utils/system', 'applyPersistedPendingCrawls');
26
+ const startupSleep = lazyShim('./order/utils/system', 'sleep');
28
27
  const storage = getStorage();
29
- function attemptResumePersistedGridByPriceMatch(...args) { return require('./order/grid_reconcile').attemptResumePersistedGridByPriceMatch(...args); }
30
- function decideStartupGridAction(...args) { return require('./order/grid_reconcile').decideStartupGridAction(...args); }
31
- function reconcileGridOrders(...args) { return require('./order/grid_reconcile').reconcileGridOrders(...args); }
28
+ const attemptResumePersistedGridByPriceMatch = lazyShim('./order/grid_reconcile', 'attemptResumePersistedGridByPriceMatch');
29
+ const decideStartupGridAction = lazyShim('./order/grid_reconcile', 'decideStartupGridAction');
30
+ const reconcileGridOrders = lazyShim('./order/grid_reconcile', 'reconcileGridOrders');
32
31
  function botRetryLogger(bot) {
33
32
  return { log: (msg) => bot._log(msg) };
34
33
  }
35
- // Test seams: compiled ESM exports cannot be monkey-patched, so tests may
36
- // substitute grid/reconcile modules and chain reads at the bot level.
37
34
  function botGridModule(bot) {
38
35
  return (bot._gridModule && typeof bot._gridModule === 'object') ? bot._gridModule : Grid;
39
36
  }
@@ -54,7 +51,7 @@ const PROFILES_BOTS_FILE = PATHS.PROFILES.BOTS_JSON;
54
51
  * @returns {Promise<Object>} startupState
55
52
  */
56
53
  async function initializeStartupState(bot) {
57
- bot.accountOrders = new AccountOrders({ botKey: bot.config.botKey });
54
+ bot.accountOrders = new AccountOrders({ botKey: bot.config.botKey ?? '' });
58
55
  bot._processedFillStore.configure({
59
56
  accountOrders: bot.accountOrders
60
57
  });
@@ -112,15 +109,16 @@ async function initializeStartupState(bot) {
112
109
  if (persistedGrid && persistedGrid.length > 0) {
113
110
  let repairCount = 0;
114
111
  repairedGrid = persistedGrid.map((order) => {
115
- if (order && order.orderId && order.orderId === order.id) {
112
+ const ord = order;
113
+ if (ord && ord.orderId && ord.orderId === ord.id) {
116
114
  repairCount++;
117
- const repairedOrder = { ...order, orderId: '' };
115
+ const repairedOrder = { ...ord, orderId: '' };
118
116
  if (repairedOrder.state === ORDER_STATES.ACTIVE || repairedOrder.state === ORDER_STATES.PARTIAL) {
119
117
  repairedOrder.state = ORDER_STATES.VIRTUAL;
120
118
  }
121
119
  return repairedOrder;
122
120
  }
123
- return order;
121
+ return ord;
124
122
  });
125
123
  if (repairCount > 0) {
126
124
  bot._log(`[REPAIR] Stripped ${repairCount} fake orderId(s) from persisted grid to restore rebalancing logic.`);
@@ -157,8 +155,8 @@ async function initializeStartupState(bot) {
157
155
  * bot down and rethrows. Nothing is cancelled without an operator.
158
156
  *
159
157
  * @param {import('./dexbot_class.js').DEXBot} bot
160
- * @param {any[]} persistedGrid - Persisted grid array (non-empty).
161
- * @param {any} persistedGenesis - Persisted ladder row (may be null).
158
+ * @param {unknown[]} persistedGrid - Persisted grid array (non-empty).
159
+ * @param {unknown} persistedGenesis - Persisted ladder row (may be null).
162
160
  * @returns {{needsRebuild: boolean}}
163
161
  */
164
162
  function evaluateStartupGenesisGate(bot, persistedGrid, persistedGenesis) {
@@ -182,6 +180,27 @@ function evaluateStartupGenesisGate(bot, persistedGrid, persistedGenesis) {
182
180
  `and reconciles against the live book update-first`, 'warn');
183
181
  return { needsRebuild: true };
184
182
  }
183
+ /**
184
+ * Wire up the post-bootstrap subsystem intervals and run the startup dust
185
+ * health check. Shared by every startup path so the subsystem list stays in
186
+ * lockstep (add a subsystem once). finishBootstrap() is intentionally left to
187
+ * each caller — the bootstrap/try-finally ordering differs per path.
188
+ * @param {import('./dexbot_class.js').DEXBot} bot
189
+ */
190
+ async function startPostBootstrapSubsystems(bot) {
191
+ await bot._setupTriggerFileDetection();
192
+ await bot._setupCreditRuntime();
193
+ await bot._refreshAndSyncCreditRuntime();
194
+ await bot._runCreditRuntimeMaintenance('startup');
195
+ bot._setupBlockchainFetchInterval();
196
+ if (typeof bot._setupBotsConfigPollInterval === 'function')
197
+ bot._setupBotsConfigPollInterval();
198
+ bot._setupCreditWatchdogInterval();
199
+ bot._setupCredentialDaemonWatchdogInterval();
200
+ bot._setupDustHealthCheckInterval();
201
+ await bot._runDustHealthCheck();
202
+ bot._log('[DUST] Startup health check complete');
203
+ }
185
204
  /**
186
205
  * Finish the startup sequence: activate fill listener, reconcile grid, place initial orders.
187
206
  * @param {import('./dexbot_class.js').DEXBot} bot
@@ -248,7 +267,7 @@ async function finishStartupSequence(bot, startupState) {
248
267
  try {
249
268
  await Promise.race([
250
269
  workPromise,
251
- new Promise((_, reject) => {
270
+ new Promise((_resolve, reject) => {
252
271
  safetyNetTimer = setTimeout(() => reject(new Error(`Safety-net sync exceeded ${safetyNetTimeoutMs}ms cap`)), safetyNetTimeoutMs);
253
272
  })
254
273
  ]);
@@ -262,7 +281,7 @@ async function finishStartupSequence(bot, startupState) {
262
281
  bot._log(`Safety-net sync completed despite timeout — ignoring spurious error.`, 'info');
263
282
  }
264
283
  else {
265
- bot._warn(`Post-reconnect safety-net sync aborted: ${capErr?.message || capErr}`);
284
+ bot._warn(`Post-reconnect safety-net sync aborted: ${getErrorMessage(capErr)}`);
266
285
  }
267
286
  }
268
287
  finally {
@@ -274,7 +293,7 @@ async function finishStartupSequence(bot, startupState) {
274
293
  setImmediate(() => {
275
294
  runSafetyNetSync().catch((err) => {
276
295
  try {
277
- bot._warn('Post-reconnect safety-net sync failed: ' + (err?.message || err));
296
+ bot._warn('Post-reconnect safety-net sync failed: ' + (getErrorMessage(err)));
278
297
  }
279
298
  catch (_) {
280
299
  }
@@ -366,8 +385,8 @@ async function finishStartupSequence(bot, startupState) {
366
385
  await bot.manager.recalculateFunds();
367
386
  if (!postResetAborted && !postResetUnmatched) {
368
387
  const spreadResult = await bot.manager.checkSpreadCondition(BitShares, bot.updateOrdersOnChainPlan.bind(bot));
369
- if (spreadResult && spreadResult.ordersPlaced > 0) {
370
- bot._log(`✓ Spread correction after trigger reset: ${spreadResult.ordersPlaced} order(s) placed`);
388
+ if (spreadResult && (spreadResult.ordersPlaced ?? 0) > 0) {
389
+ bot._log(`✓ Spread correction after trigger reset: ${spreadResult.ordersPlaced ?? 0} order(s) placed`);
371
390
  await bot._persistAndRecoverIfNeeded();
372
391
  }
373
392
  }
@@ -385,18 +404,7 @@ async function finishStartupSequence(bot, startupState) {
385
404
  }
386
405
  bot._log('Bootstrap phase complete - fill processing resumed', 'info');
387
406
  });
388
- await bot._setupTriggerFileDetection();
389
- await bot._setupCreditRuntime();
390
- await bot._refreshAndSyncCreditRuntime();
391
- await bot._runCreditRuntimeMaintenance('startup');
392
- bot._setupBlockchainFetchInterval();
393
- if (typeof bot._setupBotsConfigPollInterval === 'function')
394
- bot._setupBotsConfigPollInterval();
395
- bot._setupCreditWatchdogInterval();
396
- bot._setupCredentialDaemonWatchdogInterval();
397
- bot._setupDustHealthCheckInterval();
398
- await bot._runDustHealthCheck();
399
- bot._log('[DUST] Startup health check complete');
407
+ await startPostBootstrapSubsystems(bot);
400
408
  bot.manager.finishBootstrap();
401
409
  if (bot._isOpenOrdersSyncLoopEnabled()) {
402
410
  bot._startOpenOrdersSyncLoop();
@@ -412,10 +420,11 @@ async function finishStartupSequence(bot, startupState) {
412
420
  });
413
421
  if (bot.config.assetA !== 'BTS' && bot.config.assetB !== 'BTS') {
414
422
  if (persistedBtsBalance && typeof persistedBtsBalance === 'object') {
423
+ const bal = persistedBtsBalance;
415
424
  bot.manager.btsBalance = {
416
- free: persistedBtsBalance.free || 0,
417
- total: persistedBtsBalance.total || 0,
418
- locked: persistedBtsBalance.locked || 0
425
+ free: bal.free || 0,
426
+ total: bal.total || 0,
427
+ locked: bal.locked || 0
419
428
  };
420
429
  }
421
430
  }
@@ -534,11 +543,12 @@ async function finishStartupSequence(bot, startupState) {
534
543
  }
535
544
  }
536
545
  if (!shouldRegenerate) {
537
- if (persistedBtsFeesOwed > 0) {
546
+ const btsFeesOwed = Number(persistedBtsFeesOwed);
547
+ if (btsFeesOwed > 0) {
538
548
  await bot.manager._fundLock.acquire(async () => {
539
- bot.manager.funds.btsFeesOwed = persistedBtsFeesOwed;
549
+ bot.manager.funds.btsFeesOwed = btsFeesOwed;
540
550
  });
541
- bot._log(`✓ Restored BTS fees owed: ${Format.formatAmount8(persistedBtsFeesOwed)} BTS`);
551
+ bot._log(`✓ Restored BTS fees owed: ${Format.formatAmount8(btsFeesOwed)} BTS`);
542
552
  }
543
553
  }
544
554
  else {
@@ -702,18 +712,7 @@ async function finishStartupSequence(bot, startupState) {
702
712
  bot.manager.finishBootstrap();
703
713
  }
704
714
  });
705
- await bot._setupTriggerFileDetection();
706
- await bot._setupCreditRuntime();
707
- await bot._refreshAndSyncCreditRuntime();
708
- await bot._runCreditRuntimeMaintenance('startup');
709
- bot._setupBlockchainFetchInterval();
710
- if (typeof bot._setupBotsConfigPollInterval === 'function')
711
- bot._setupBotsConfigPollInterval();
712
- bot._setupCreditWatchdogInterval();
713
- bot._setupCredentialDaemonWatchdogInterval();
714
- bot._setupDustHealthCheckInterval();
715
- await bot._runDustHealthCheck();
716
- bot._log('[DUST] Startup health check complete');
715
+ await startPostBootstrapSubsystems(bot);
717
716
  if (bot._isOpenOrdersSyncLoopEnabled()) {
718
717
  bot._startOpenOrdersSyncLoop();
719
718
  }
@@ -1,28 +1,29 @@
1
1
  /** State recovery runtime - grid persistence, recovery sync, size-drift repair */
2
+ import type { BotLike } from './types.js';
2
3
  /**
3
4
  * Persist the current grid state and trigger recovery if validation fails.
4
5
  * @param {import('./dexbot_class.js').DEXBot} bot
5
6
  */
6
- declare function persistAndRecoverIfNeeded(bot: any): Promise<void>;
7
+ declare function persistAndRecoverIfNeeded(bot: BotLike): Promise<void>;
7
8
  /**
8
9
  * Snapshot the recently queued fill keys as a plain object for crash-durable persistence.
9
10
  * @param {import('./dexbot_class.js').DEXBot} bot
10
11
  * @returns {Record<string, number>}
11
12
  */
12
- declare function getRecentFillKeysSnapshot(bot: any): Record<string, number>;
13
+ declare function getRecentFillKeysSnapshot(bot: BotLike): Record<string, number>;
13
14
  /**
14
15
  * Trigger a full state recovery sync (fetch chain + sync from open orders + persist).
15
16
  * @param {import('./dexbot_class.js').DEXBot} bot
16
17
  * @param {string} [reason='state recovery sync']
17
18
  */
18
- declare function triggerStateRecoverySync(bot: any, reason?: any): Promise<void>;
19
+ declare function triggerStateRecoverySync(bot: BotLike, reason?: string): Promise<void>;
19
20
  /**
20
21
  * Abort the current flow if an illegal state signal was raised.
21
22
  * @param {import('./dexbot_class.js').DEXBot} bot
22
23
  * @param {string} flowContext
23
24
  * @returns {Promise<boolean>}
24
25
  */
25
- declare function abortFlowIfIllegalState(bot: any, flowContext: any): Promise<boolean>;
26
+ declare function abortFlowIfIllegalState(bot: BotLike, flowContext: string): Promise<boolean>;
26
27
  /**
27
28
  * Handle a hard abort from batch processing due to illegal state or accounting failure.
28
29
  * @param {import('./dexbot_class.js').DEXBot} bot
@@ -31,7 +32,7 @@ declare function abortFlowIfIllegalState(bot: any, flowContext: any): Promise<bo
31
32
  * @param {number} [opsCount=0]
32
33
  * @returns {Promise<Object|null>}
33
34
  */
34
- declare function handleBatchHardAbort(bot: any, err: any, phase?: any, opsCount?: any): Promise<{
35
+ declare function handleBatchHardAbort(bot: BotLike, err: unknown, phase?: string, opsCount?: number): Promise<{
35
36
  abortedForAccountingFailure: boolean;
36
37
  executed: boolean;
37
38
  hadRotation: boolean;
@@ -47,7 +48,7 @@ declare function handleBatchHardAbort(bot: any, err: any, phase?: any, opsCount?
47
48
  * @param {string} [context='recoverable-grid-update']
48
49
  * @returns {Promise<number>}
49
50
  */
50
- declare function applyRecoverableGridUpdates(bot: any, updates: any, context?: any): Promise<number>;
51
+ declare function applyRecoverableGridUpdates(bot: BotLike, updates: unknown[], context?: string): Promise<number>;
51
52
  /**
52
53
  * Recover from explicit stale order errors by virtualizing affected grid slots.
53
54
  * @param {import('./dexbot_class.js').DEXBot} bot
@@ -55,7 +56,7 @@ declare function applyRecoverableGridUpdates(bot: any, updates: any, context?: a
55
56
  * @param {string} [reason='stale order cleanup']
56
57
  * @returns {Promise<Object>}
57
58
  */
58
- declare function recoverExplicitStaleOrders(bot: any, staleOrderIds: any, reason?: any): Promise<{
59
+ declare function recoverExplicitStaleOrders(bot: BotLike, staleOrderIds: unknown, reason?: string): Promise<{
59
60
  executed: boolean;
60
61
  hadRotation: boolean;
61
62
  stale: boolean;
@@ -73,7 +74,7 @@ declare function recoverExplicitStaleOrders(bot: any, staleOrderIds: any, reason
73
74
  * @param {Array<Object>} [opContexts=[]]
74
75
  * @returns {Promise<Object>}
75
76
  */
76
- declare function recoverBatchSizeDrift(bot: any, err: any, opContexts?: any): Promise<{
77
+ declare function recoverBatchSizeDrift(bot: BotLike, err: unknown, opContexts?: unknown): Promise<{
77
78
  executed: boolean;
78
79
  hadRotation: boolean;
79
80
  recoveredBySync: boolean;
@@ -84,7 +85,7 @@ declare function recoverBatchSizeDrift(bot: any, err: any, opContexts?: any): Pr
84
85
  * @param {import('./dexbot_class.js').DEXBot} bot
85
86
  * @returns {Promise<{success: boolean, reason?: string}>}
86
87
  */
87
- declare function recoverFromPersistedGrid(bot: any): Promise<{
88
+ declare function recoverFromPersistedGrid(bot: BotLike): Promise<{
88
89
  success: boolean;
89
90
  reason: string;
90
91
  halt?: undefined;
@@ -110,20 +111,20 @@ declare function recoverFromPersistedGrid(bot: any): Promise<{
110
111
  * @param {import('./dexbot_class.js').DEXBot} bot
111
112
  * @param {string} context - Label for logging
112
113
  */
113
- declare function _schedulePostRecoveryRebalance(bot: any, context: any): void;
114
+ declare function _schedulePostRecoveryRebalance(bot: BotLike, context: string): void;
114
115
  /**
115
116
  * Reject a corrupted grid snapshot when catastrophic fund drift is detected.
116
117
  * @param {import('./dexbot_class.js').DEXBot} bot
117
118
  * @param {'startup'|'recovery'} context
118
119
  * @returns {Promise<boolean>}
119
120
  */
120
- declare function rejectCorruptedGridSnapshot(bot: any, context: any): Promise<boolean>;
121
+ declare function rejectCorruptedGridSnapshot(bot: BotLike, context: string): Promise<boolean>;
121
122
  /**
122
123
  * Attempt to repair size-drift for specific order IDs from chain state.
123
124
  * @param {import('./dexbot_class.js').DEXBot} bot
124
125
  * @param {string[]} orderIds
125
126
  * @returns {Promise<boolean>}
126
127
  */
127
- declare function targetedOrderRepair(bot: any, orderIds: any): Promise<boolean>;
128
+ declare function targetedOrderRepair(bot: BotLike, orderIds: string[]): Promise<boolean>;
128
129
  export { persistAndRecoverIfNeeded, getRecentFillKeysSnapshot, triggerStateRecoverySync, abortFlowIfIllegalState, handleBatchHardAbort, applyRecoverableGridUpdates, recoverExplicitStaleOrders, recoverBatchSizeDrift, recoverFromPersistedGrid, rejectCorruptedGridSnapshot, targetedOrderRepair, _schedulePostRecoveryRebalance as schedulePostRecoveryRebalance };
129
130
  //# sourceMappingURL=dexbot_state_recovery.d.ts.map
@@ -323,7 +323,7 @@ async function recoverFromPersistedGrid(bot) {
323
323
  return { success: false, reason: `persisted boundary rejected (${check.reason})` };
324
324
  }
325
325
  }
326
- const persistedGenesis = bot.accountOrders.loadGenesis?.(true) ?? null;
326
+ const persistedGenesis = (bot.accountOrders.loadGenesis?.(true) ?? null);
327
327
  await grid.loadGrid(bot.manager, persistedGrid, boundaryIdx, persistedGenesis, { tolerateTransientStranding });
328
328
  // Restart resilience: same pruning rules as the startup path — streaks
329
329
  // only survive for slots that still exist in the reloaded grid.
@@ -379,18 +379,19 @@ async function recoverFromPersistedGrid(bot) {
379
379
  // path (adoptPlacedBatchFromChain reads by id immediately after
380
380
  // broadcast). When no known ids are available, still defer.
381
381
  const knownIds = (persistedGrid || [])
382
- .map((s) => s && s.orderId)
382
+ .map((s) => s?.orderId)
383
383
  .filter((id) => id && /^1\.7\.\d+$/.test(String(id)));
384
384
  let recoveredById = null;
385
385
  if (knownIds.length > 0 && typeof chainOrders.batchReadOrders === 'function') {
386
386
  try {
387
- const map = await chainOrders.batchReadOrders(knownIds);
387
+ const map = await Promise.resolve(chainOrders.batchReadOrders(knownIds));
388
388
  const byId = [];
389
389
  if (map && typeof map.forEach === 'function') {
390
390
  map.forEach((o) => { if (o)
391
391
  byId.push(o); });
392
392
  }
393
393
  recoveredById = byId;
394
+ recoveredById = byId;
394
395
  }
395
396
  catch (byIdErr) {
396
397
  bot.manager.logger.log(`[RECOVERY] ID-based fallback read failed: ${getErrorMessage(byIdErr)}`, 'warn');
@@ -404,6 +405,9 @@ async function recoverFromPersistedGrid(bot) {
404
405
  return { success: false, reason: 'truncated open-order read; full grid reload deferred' };
405
406
  }
406
407
  }
408
+ if (chainOpenOrders === null) {
409
+ return { success: false, reason: 'truncated open-order read; full grid reload deferred' };
410
+ }
407
411
  if (chainOpenOrders.length > 0 && bot.manager?.syncFromOpenOrders) {
408
412
  await bot.manager.syncFromOpenOrders(chainOpenOrders, {
409
413
  skipAccounting: true,
@@ -439,7 +443,7 @@ async function recoverFromPersistedGrid(bot) {
439
443
  }
440
444
  const ordersArr = Array.from(bot.manager.orders.values());
441
445
  const bloatPostRecovery = isGridBloated(bot.manager, ordersArr);
442
- if (bloatPostRecovery.bloated) {
446
+ if (bloatPostRecovery.bloated && bloatPostRecovery.details) {
443
447
  const d = bloatPostRecovery.details;
444
448
  bot.manager.logger.log(`[RECOVERY] Persisted grid reloaded but still bloated ` +
445
449
  `(${d.gridSize} slots, max ${d.maxAllowed}). Rejecting — full grid reset required.`, 'warn');
@@ -520,7 +524,7 @@ async function _rebalanceAfterRecovery(bot, context) {
520
524
  bot.manager?._popWorkingGridRef?.(rebalanceResult);
521
525
  return;
522
526
  }
523
- bot.manager.logger?.log?.(`[RECOVERY] Re-placing ${rebalanceResult.actions.length} missing rail(s) after ${context}`, 'info');
527
+ bot.manager.logger?.log?.(`[RECOVERY] Re-placing ${(rebalanceResult.actions ?? []).length} missing rail(s) after ${context}`, 'info');
524
528
  await bot.updateOrdersOnChainBatch(rebalanceResult);
525
529
  }
526
530
  catch (err) {
@@ -584,7 +588,7 @@ async function rejectCorruptedGridSnapshot(bot, context) {
584
588
  return false;
585
589
  const tag = context === 'recovery' ? '[RECOVERY][SNAPSHOT-REJECT]' : '[SNAPSHOT-REJECT]';
586
590
  bot._warn(`${tag} Corrupted grid snapshot detected: ` +
587
- `drift sell=${driftCheck.driftSell.toFixed(2)} buy=${driftCheck.driftBuy.toFixed(2)}. ` +
591
+ `drift sell=${Number(driftCheck.driftSell ?? 0).toFixed(2)} buy=${Number(driftCheck.driftBuy ?? 0).toFixed(2)}. ` +
588
592
  `Deleting corrupted snapshot.`);
589
593
  if (bot.accountOrders && typeof bot.accountOrders.clearGrid === 'function') {
590
594
  try {
@@ -592,30 +596,31 @@ async function rejectCorruptedGridSnapshot(bot, context) {
592
596
  bot._warn(`${tag} Corrupted grid snapshot deleted.`);
593
597
  }
594
598
  catch (clearErr) {
595
- bot._warn(`${tag} Failed to delete corrupted snapshot: ${clearErr?.message ?? clearErr}`);
599
+ bot._warn(`${tag} Failed to delete corrupted snapshot: ${getErrorMessage(clearErr)}`);
596
600
  }
597
601
  }
598
602
  // P4: clear in-memory boundary together with snapshot so a stale
599
603
  // restored value (e.g. 131 in the incident) is not reused for rebuild.
600
604
  // clearGrid() already wiped persisted boundaryIdx; also clear manager
601
605
  // state so P3 re-derivation starts from a clean null boundary.
606
+ const mgrRecovery = bot.manager;
602
607
  try {
603
- bot.manager._restoreBoundary?.(null);
608
+ mgrRecovery._restoreBoundary?.(null);
604
609
  }
605
610
  catch { }
606
- bot.manager.boundaryIdx = null;
611
+ mgrRecovery.boundaryIdx = null;
607
612
  // Owed crawls belonged to the rejected generation: the rebuild re-anchors
608
613
  // the boundary absolutely, so applying their relative deltas would
609
614
  // double-count the movement the new anchor already contains. clearGrid()
610
615
  // wiped the persisted copy; drop the in-memory record (marks the grid
611
616
  // dirty so the wipe reaches disk on the next flush too).
612
- bot.manager._clearPendingFillCrawls?.('grid snapshot rejected');
617
+ mgrRecovery._clearPendingFillCrawls?.('grid snapshot rejected');
613
618
  // The LAST-FILL-GUARD pivot was armed against the rejected generation's
614
619
  // geometry: drop it so the rebuild re-arms on a fresh fill instead of
615
620
  // vetoing placements against a boundary that no longer exists.
616
621
  try {
617
- if (typeof bot.manager._resetLastFillPivot === 'function') {
618
- bot.manager._resetLastFillPivot('grid snapshot rejected');
622
+ if (typeof mgrRecovery._resetLastFillPivot === 'function') {
623
+ mgrRecovery._resetLastFillPivot('grid snapshot rejected');
619
624
  }
620
625
  else {
621
626
  resetLastFillPivot(bot.manager, 'grid snapshot rejected');
@@ -669,7 +674,7 @@ async function targetedOrderRepair(bot, orderIds) {
669
674
  return true;
670
675
  }
671
676
  catch (err) {
672
- bot.manager.logger.log(`[COW] Targeted order repair failed: ${err?.message ?? err}`, 'debug');
677
+ bot.manager.logger.log(`[COW] Targeted order repair failed: ${getErrorMessage(err)}`, 'debug');
673
678
  return false;
674
679
  }
675
680
  }
@@ -1,3 +1,5 @@
1
+ /** Allocation value stored in the registry: a decimal number or a percentage string. */
2
+ type PercentageValue = number | string;
1
3
  /**
2
4
  * Register a bot's allocation on an account for a given side.
3
5
  * Called during bot startup.
@@ -6,7 +8,7 @@
6
8
  * @param {'buy'|'sell'} side - Trade side
7
9
  * @param {number|string} percentage - Percentage value (e.g., 1.0 or '100%')
8
10
  */
9
- declare function registerAllocation(account: string, botName: string, side: 'buy' | 'sell', percentage: any): Promise<void>;
11
+ declare function registerAllocation(account: string, botName: string, side: 'buy' | 'sell', percentage: PercentageValue): Promise<void>;
10
12
  /**
11
13
  * Register a credit bot's collateral allocation on an account for a given collateral asset.
12
14
  * Called during bot startup for bots with debtPolicy.lending entries.
@@ -15,7 +17,7 @@ declare function registerAllocation(account: string, botName: string, side: 'buy
15
17
  * @param {string} collateralAssetId - Canonical collateral asset ID (e.g., '1.3.0')
16
18
  * @param {number|string} percentage - Percentage value (e.g., 1.0 or '100%')
17
19
  */
18
- declare function registerCollateralAllocation(account: string, botName: string, collateralAssetId: string, percentage: any): Promise<void>;
20
+ declare function registerCollateralAllocation(account: string, botName: string, collateralAssetId: string, percentage: PercentageValue): Promise<void>;
19
21
  /**
20
22
  * Get the effective collateral allocation for a credit bot on a given account/collateral asset.
21
23
  * Returns chainTotal * (myPercent / sum(allPercentages)).
@@ -1,3 +1,4 @@
1
+ import { getErrorMessage } from './utils/errors.js';
1
2
  import { createRequire } from 'node:module';
2
3
  const require = createRequire(import.meta.url);
3
4
  import { getStorage } from './storage/index.js';
@@ -36,22 +37,21 @@ function _loadRegistry() {
36
37
  }
37
38
  if (_registry !== null)
38
39
  return _registry;
40
+ let loaded;
39
41
  try {
40
- if (storage.exists(REGISTRY_FILE)) {
41
- _registry = readJSON(REGISTRY_FILE);
42
- }
43
- else {
44
- _registry = {};
45
- }
42
+ loaded = storage.exists(REGISTRY_FILE)
43
+ ? readJSON(REGISTRY_FILE)
44
+ : {};
46
45
  }
47
46
  catch (err) {
48
- console.error(`[fund_registry] Failed to load ${REGISTRY_FILE} (${err?.message || err}); ` +
47
+ console.error(`[fund_registry] Failed to load ${REGISTRY_FILE} (${getErrorMessage(err)}); ` +
49
48
  `resetting to an empty registry — previously registered bot allocations are unavailable ` +
50
49
  `and will be overwritten on the next save. Restore the file from backup before restarting other bots.`);
51
- _registry = {};
50
+ loaded = {};
52
51
  }
52
+ _registry = loaded;
53
53
  _registryMtimeMs = _statMtimeMs(REGISTRY_FILE);
54
- return _registry;
54
+ return loaded;
55
55
  }
56
56
  function _saveRegistry() {
57
57
  writeJSON(REGISTRY_FILE, _registry);
@@ -225,7 +225,7 @@ async function releaseAllocation(account, botName) {
225
225
  }
226
226
  }
227
227
  }
228
- else {
228
+ else if (side === 'buy' || side === 'sell') {
229
229
  const pct = _parsePercentage(acc.bots[botName][side]);
230
230
  acc.totalAllocatedPct[side] = Math.max(0, (acc.totalAllocatedPct[side] || 0) - pct);
231
231
  }
@@ -4,7 +4,33 @@
4
4
  * Centralized management for application-wide settings stored in profiles/general.settings.json.
5
5
  * Provides read/write operations with fallback handling.
6
6
  */
7
+ import type { UnknownRecord } from './types.js';
7
8
  declare const SETTINGS_FILE: string;
9
+ /**
10
+ * The on-disk general settings document. Open-ended (dynamic top-level
11
+ * sections) but `NODES` is typed because several callers read it directly.
12
+ */
13
+ interface GeneralSettingsDocument {
14
+ NODES?: {
15
+ enabled?: boolean;
16
+ list?: string[];
17
+ healthCheck?: {
18
+ enabled?: boolean;
19
+ intervalMs?: number;
20
+ timeoutMs?: number;
21
+ maxPingMs?: number;
22
+ blacklistThreshold?: number;
23
+ [key: string]: unknown;
24
+ };
25
+ selection?: {
26
+ strategy?: string;
27
+ preferredNode?: string | null;
28
+ [key: string]: unknown;
29
+ };
30
+ [key: string]: unknown;
31
+ };
32
+ [key: string]: unknown;
33
+ }
8
34
  /**
9
35
  * Read general application settings from file.
10
36
  * Returns fallback if file missing, empty, or parse fails.
@@ -15,9 +41,9 @@ declare const SETTINGS_FILE: string;
15
41
  * @returns {Object|*} Parsed settings object or fallback value
16
42
  */
17
43
  declare function readGeneralSettings({ fallback, onError }?: {
18
- fallback?: any;
19
- onError?: ((err: Error, filePath: string) => void) | null;
20
- }): any;
44
+ fallback?: GeneralSettingsDocument | null;
45
+ onError?: ((err: unknown, filePath: string) => void) | null;
46
+ }): GeneralSettingsDocument | null;
21
47
  /**
22
48
  * Write general application settings to file.
23
49
  * Creates profiles directory if it doesn't exist.
@@ -26,6 +52,6 @@ declare function readGeneralSettings({ fallback, onError }?: {
26
52
  * @param {Object} settings - Settings object to write
27
53
  * @throws {Error} If write operation fails
28
54
  */
29
- declare function writeGeneralSettings(settings: any): void;
55
+ declare function writeGeneralSettings(settings: UnknownRecord): void;
30
56
  export { SETTINGS_FILE, readGeneralSettings, writeGeneralSettings };
31
57
  //# sourceMappingURL=general_settings.d.ts.map
@@ -69,14 +69,14 @@
69
69
  * @param {string} name - Description used in shutdown logs
70
70
  * @param {Function} wipeFn - Synchronous function to execute last
71
71
  */
72
- declare function registerExitWipe(name: any, wipeFn: () => void): void;
72
+ declare function registerExitWipe(name: string, wipeFn: () => void): void;
73
73
  /**
74
74
  * Register a cleanup function to be called on graceful shutdown
75
75
  * Functions are called in LIFO order (last registered = first called)
76
76
  * @param {string} name - Name of the cleanup operation (for logging)
77
77
  * @param {Function} handler - Async or sync function to call on shutdown
78
78
  */
79
- declare function registerCleanup(name: any, handler: any): void;
79
+ declare function registerCleanup(name: string, handler: () => unknown): void;
80
80
  /**
81
81
  * Remove a previously registered cleanup function.
82
82
  * Use this when a component fails to initialize and its cleanup must not run
@@ -84,7 +84,7 @@ declare function registerCleanup(name: any, handler: any): void;
84
84
  * @param {string|Function} nameOrHandler - Cleanup name or handler reference
85
85
  * @returns {boolean} True when a handler was found and removed
86
86
  */
87
- declare function unregisterCleanup(nameOrHandler: any): boolean;
87
+ declare function unregisterCleanup(nameOrHandler: string | (() => unknown)): boolean;
88
88
  /**
89
89
  * Setup signal handlers for graceful shutdown
90
90
  * Should be called once at process startup