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
@@ -55,7 +55,7 @@ const VALID_ORDER_TYPES = new Set(Object.values(ORDER_TYPES));
55
55
  function validateOrder(order, oldOrder = null, context = 'validate') {
56
56
  const errors = [];
57
57
  const warnings = [];
58
- let normalizedOrder = { ...(oldOrder || {}), ...order };
58
+ const normalizedOrder = { ...(oldOrder || {}), ...order };
59
59
  if (!order || !order.id) {
60
60
  errors.push({ code: 'MISSING_ID', message: 'Refusing to update order: missing ID' });
61
61
  return { isValid: false, errors, warnings, normalizedOrder: null };
@@ -66,13 +66,13 @@ function validateOrder(order, oldOrder = null, context = 'validate') {
66
66
  normalizedOrder.type = ORDER_TYPES.SPREAD;
67
67
  }
68
68
  }
69
- if (!VALID_ORDER_STATES.has(normalizedOrder.state)) {
69
+ if (normalizedOrder.state === undefined || !VALID_ORDER_STATES.has(normalizedOrder.state)) {
70
70
  errors.push({
71
71
  code: 'INVALID_STATE',
72
72
  message: `Refusing to update order ${order.id}: invalid state '${normalizedOrder.state}' (context: ${context})`
73
73
  });
74
74
  }
75
- if (!VALID_ORDER_TYPES.has(normalizedOrder.type)) {
75
+ if (normalizedOrder.type === undefined || !VALID_ORDER_TYPES.has(normalizedOrder.type)) {
76
76
  errors.push({
77
77
  code: 'INVALID_TYPE',
78
78
  message: `Refusing to update order ${order.id}: invalid type '${normalizedOrder.type}' (context: ${context})`
@@ -196,16 +196,17 @@ function validateWorkingGridFunds(workingGrid, projectedFunds, precisions = {},
196
196
  const buyPrecision = precisions.buyPrecision ?? assets?.assetB?.precision;
197
197
  const sellPrecision = precisions.sellPrecision ?? assets?.assetA?.precision;
198
198
  const required = calculateRequiredFunds(workingGrid, { buyPrecision, sellPrecision });
199
- const availableBuy = isValidNumber(projectedFunds?.allocatedBuy)
200
- ? Number(projectedFunds.allocatedBuy)
201
- : isValidNumber(projectedFunds?.chainTotalBuy)
202
- ? Number(projectedFunds.chainTotalBuy)
203
- : toFiniteNumber(projectedFunds?.freeBuy ?? projectedFunds?.chainFreeBuy);
204
- const availableSell = isValidNumber(projectedFunds?.allocatedSell)
205
- ? Number(projectedFunds.allocatedSell)
206
- : isValidNumber(projectedFunds?.chainTotalSell)
207
- ? Number(projectedFunds.chainTotalSell)
208
- : toFiniteNumber(projectedFunds?.freeSell ?? projectedFunds?.chainFreeSell);
199
+ const funds = projectedFunds ?? {};
200
+ const availableBuy = isValidNumber(funds.allocatedBuy)
201
+ ? Number(funds.allocatedBuy)
202
+ : isValidNumber(funds.chainTotalBuy)
203
+ ? Number(funds.chainTotalBuy)
204
+ : toFiniteNumber(funds.freeBuy ?? funds.chainFreeBuy);
205
+ const availableSell = isValidNumber(funds.allocatedSell)
206
+ ? Number(funds.allocatedSell)
207
+ : isValidNumber(funds.chainTotalSell)
208
+ ? Number(funds.chainTotalSell)
209
+ : toFiniteNumber(funds.freeSell ?? funds.chainFreeSell);
209
210
  const shortfalls = [];
210
211
  const availableBuyInt = floatToBlockchainInt(availableBuy, buyPrecision);
211
212
  const availableSellInt = floatToBlockchainInt(availableSell, sellPrecision);
@@ -270,7 +271,7 @@ function checkFundDrift(orders, accountTotals, assets = null, gridLimits = null)
270
271
  }
271
272
  const precisionSlackBuy = getPrecisionSlack(buyPrecision);
272
273
  const precisionSlackSell = getPrecisionSlack(sellPrecision);
273
- const fundInvariantTolerance = gridLimits?.FUND_INVARIANT_PERCENT_TOLERANCE ?? GRID_LIMITS.FUND_INVARIANT_PERCENT_TOLERANCE;
274
+ const fundInvariantTolerance = toFiniteNumber(gridLimits?.FUND_INVARIANT_PERCENT_TOLERANCE ?? GRID_LIMITS.FUND_INVARIANT_PERCENT_TOLERANCE);
274
275
  const percentTolerance = fundInvariantTolerance / 100;
275
276
  const allowedDriftBuy = Math.max(precisionSlackBuy, actualBuy * percentTolerance);
276
277
  const allowedDriftSell = Math.max(precisionSlackSell, actualSell * percentTolerance);
@@ -681,7 +682,7 @@ function summarizeActions(actions) {
681
682
  /**
682
683
  * Check if a rebalance result has executable actions.
683
684
  *
684
- * @param {any} rebalanceResult - Rebalance result to check
685
+ * @param {unknown} rebalanceResult - Rebalance result to check
685
686
  * @returns {boolean} True if actions array is non-empty
686
687
  */
687
688
  function hasExecutableActions(rebalanceResult) {
@@ -704,7 +705,7 @@ function hasExecutableActions(rebalanceResult) {
704
705
  * Returns violating target IDs alongside violations so the caller can skip
705
706
  * individual violating CREATEs instead of aborting the entire batch.
706
707
  *
707
- * @param {Array<any>} actions - List of COW actions
708
+ * @param {Array<CowAction>} actions - List of COW actions
708
709
  * @param {Map} orders - Current order grid
709
710
  * @param {Object|null} [assets=null] - Asset metadata for tolerance calculation
710
711
  * @param {Array<Object>} [chainOrderCandidates=[]] - Unmatched on-chain orders
@@ -996,7 +997,7 @@ function _isProjectionUnchanged(current, targetOrder, resultSize, resultState, r
996
997
  }
997
998
  /**
998
999
  * Project target grid into working grid
999
- * @param {any} workingGrid - Working grid to modify
1000
+ * @param {unknown} workingGrid - Working grid to modify
1000
1001
  * @param {Map} targetGrid - Target state
1001
1002
  * @param {Object} [options] - Optional parameters
1002
1003
  * @param {Array} [options.actions] - Pre-existing COW actions to consider
@@ -1075,7 +1076,7 @@ function projectTargetToWorkingGrid(workingGrid, targetGrid, options = {}) {
1075
1076
  function buildStateUpdates(actions, masterGrid) {
1076
1077
  const stateUpdates = [];
1077
1078
  for (const action of actions) {
1078
- if (action.type === COW_ACTIONS.CREATE) {
1079
+ if (action.type === COW_ACTIONS.CREATE && action.order) {
1079
1080
  stateUpdates.push({
1080
1081
  ...action.order,
1081
1082
  state: ORDER_STATES.VIRTUAL,
@@ -1144,9 +1145,10 @@ function buildSuccessResult({ actions, stateUpdates, workingGrid, workingBoundar
1144
1145
  * @returns {Object} Evaluation result
1145
1146
  */
1146
1147
  function evaluateCommit(workingGrid, options = {}) {
1147
- const hasLock = typeof options === 'boolean' ? options : !!options?.hasLock;
1148
- const currentVersion = toFiniteNumber(options?.currentVersion, null);
1149
- const masterGrid = typeof options === 'object' ? options.masterGrid : null;
1148
+ const opts = options && typeof options === 'object' ? options : {};
1149
+ const hasLock = typeof options === 'boolean' ? options : !!opts.hasLock;
1150
+ const currentVersion = toFiniteNumber(opts.currentVersion, null);
1151
+ const masterGrid = opts.masterGrid ?? null;
1150
1152
  if (!workingGrid) {
1151
1153
  return {
1152
1154
  canCommit: false,
@@ -1178,7 +1180,7 @@ function evaluateCommit(workingGrid, options = {}) {
1178
1180
  }
1179
1181
  if (masterGrid && typeof workingGrid.buildDelta === 'function') {
1180
1182
  const delta = workingGrid.buildDelta(masterGrid, {
1181
- precisions: options?.comparePrecisions || null
1183
+ precisions: opts.comparePrecisions || null
1182
1184
  });
1183
1185
  if (Array.isArray(delta) && delta.length === 0) {
1184
1186
  return {
@@ -1,7 +1,8 @@
1
+ import type { BitSharesClient } from './system.js';
1
2
  export interface PoolPriceOverrides {
2
3
  derivePoolPrice(symA: string, symB: string): Promise<number | null>;
3
4
  }
4
- export declare function withPoolRef(BitShares: any, poolRef: string | null | undefined): PoolPriceOverrides | null;
5
+ export declare function withPoolRef(BitShares: BitSharesClient, poolRef: string | null | undefined): PoolPriceOverrides | null;
5
6
  /**
6
7
  * Resolve the price-derivation mode from a startPrice value. `startPrice` is
7
8
  * the master price source: a string mode ("pool"/"book") governs it, while a
@@ -13,6 +14,6 @@ export declare function withPoolRef(BitShares: any, poolRef: string | null | und
13
14
  * @param {string} [fallback='auto'] - Mode when startPrice is not a string.
14
15
  * @returns {string} Lowercased mode.
15
16
  */
16
- export declare function resolveStartPriceMode(startPrice: any, fallback?: string): string;
17
- export declare function derivePriceWithPoolRef(BitShares: any, symA: string, symB: string, mode: string, poolRef: string | null | undefined): Promise<number | null>;
17
+ export declare function resolveStartPriceMode(startPrice: unknown, fallback?: string): string;
18
+ export declare function derivePriceWithPoolRef(BitShares: BitSharesClient, symA: string, symB: string, mode: string, poolRef: string | null | undefined): Promise<number | null>;
18
19
  //# sourceMappingURL=withPoolRef.d.ts.map
@@ -1,3 +1,4 @@
1
+ import { getErrorMessage } from '../../utils/errors.js';
1
2
  import { lookupAsset, derivePrice as systemDerivePrice, deriveMarketPrice as systemDeriveMarketPrice } from './system.js';
2
3
  import { toFiniteNumber, isValidNumber } from '../format.js';
3
4
  import * as MathUtils from './math.js';
@@ -12,7 +13,12 @@ export function withPoolRef(BitShares, poolRef) {
12
13
  return {
13
14
  derivePoolPrice: async (symA, symB) => {
14
15
  try {
15
- const [pool] = await BitShares.db.get_objects([pinnedId]);
16
+ const db = BitShares.db;
17
+ if (!db?.get_objects) {
18
+ log.warn(`derivePoolPrice: pool db unavailable for ${pinnedId}`);
19
+ return null;
20
+ }
21
+ const [pool] = await db.get_objects([pinnedId]);
16
22
  if (!pool) {
17
23
  log.warn(`derivePoolPrice: pool ${pinnedId} not found`);
18
24
  return null;
@@ -22,8 +28,8 @@ export function withPoolRef(BitShares, poolRef) {
22
28
  let poolLabel = `${pinnedId}`;
23
29
  if (isValidNumber(pool.balance_a) && isValidNumber(pool.balance_b)) {
24
30
  const [poolAssetA, poolAssetB] = await Promise.all([
25
- lookupAsset(BitShares, pool.asset_a),
26
- lookupAsset(BitShares, pool.asset_b),
31
+ lookupAsset(BitShares, pool.asset_a ?? ''),
32
+ lookupAsset(BitShares, pool.asset_b ?? ''),
27
33
  ]);
28
34
  if (!poolAssetA?.id || !poolAssetB?.id || poolAssetA.precision == null || poolAssetB.precision == null) {
29
35
  log.warn(`derivePoolPrice(pinned=${pinnedId}): cannot resolve pool asset precisions`);
@@ -59,14 +65,14 @@ export function withPoolRef(BitShares, poolRef) {
59
65
  if (invert) {
60
66
  amtA = toFiniteNumber(pool.balance_b);
61
67
  amtB = toFiniteNumber(pool.balance_a);
62
- precA = poolAssetB.precision;
63
- precB = poolAssetA.precision;
68
+ precA = poolAssetB.precision ?? null;
69
+ precB = poolAssetA.precision ?? null;
64
70
  }
65
71
  else {
66
72
  amtA = toFiniteNumber(pool.balance_a);
67
73
  amtB = toFiniteNumber(pool.balance_b);
68
- precA = poolAssetA.precision;
69
- precB = poolAssetB.precision;
74
+ precA = poolAssetA.precision ?? null;
75
+ precB = poolAssetB.precision ?? null;
70
76
  }
71
77
  poolLabel = `${poolAssetA.symbol || pool.asset_a}/${poolAssetB.symbol || pool.asset_b} (${pinnedId})`;
72
78
  }
@@ -82,10 +88,10 @@ export function withPoolRef(BitShares, poolRef) {
82
88
  const resA = pool.reserves.find((r) => String(r.asset_id) === String(aMeta.id));
83
89
  const resB = pool.reserves.find((r) => String(r.asset_id) === String(bMeta.id));
84
90
  if (resA && resB) {
85
- amtA = resA.amount;
86
- amtB = resB.amount;
87
- precA = aMeta.precision;
88
- precB = bMeta.precision;
91
+ amtA = Number(resA.amount);
92
+ amtB = Number(resB.amount);
93
+ precA = aMeta.precision ?? null;
94
+ precB = bMeta.precision ?? null;
89
95
  }
90
96
  }
91
97
  if (!isValidNumber(amtA) || !isValidNumber(amtB) || toFiniteNumber(amtB) === 0 || precA == null || precB == null) {
@@ -101,7 +107,7 @@ export function withPoolRef(BitShares, poolRef) {
101
107
  return price;
102
108
  }
103
109
  catch (err) {
104
- log.warn(`derivePoolPrice(pinned=${pinnedId}) failed: ${err?.message || err}`);
110
+ log.warn(`derivePoolPrice(pinned=${pinnedId}) failed: ${getErrorMessage(err)}`);
105
111
  return null;
106
112
  }
107
113
  },
@@ -70,10 +70,11 @@
70
70
  *
71
71
  * ===============================================================================
72
72
  */
73
+ import type { ManagedOrder, UnknownRecord } from '../types.js';
73
74
  declare class WorkingGrid {
74
- grid: Map<string, any>;
75
+ grid: Map<string, ManagedOrder>;
75
76
  modified: Set<string>;
76
- _indexes: any;
77
+ _indexes: unknown;
77
78
  baseVersion: number;
78
79
  _stale: boolean;
79
80
  _staleReason: string | null;
@@ -83,7 +84,7 @@ declare class WorkingGrid {
83
84
  * @param {Object} [options] - Optional parameters
84
85
  * @param {number} [options.baseVersion=0] - Base version number
85
86
  */
86
- constructor(masterGrid: Map<string, any>, options?: {
87
+ constructor(masterGrid: Map<string, ManagedOrder>, options?: {
87
88
  baseVersion?: number;
88
89
  });
89
90
  /**
@@ -91,26 +92,26 @@ declare class WorkingGrid {
91
92
  * @param {Map} source - Source map
92
93
  * @returns {Map} - Cloned map
93
94
  */
94
- _cloneGrid(source: Map<string, any>): Map<string, any>;
95
+ _cloneGrid(source: Map<string, ManagedOrder>): Map<string, ManagedOrder>;
95
96
  /**
96
97
  * Clone a single order object
97
98
  * @param {Object} order - Order to clone
98
99
  * @returns {Object} - Cloned order
99
100
  */
100
- _cloneOrder(order: any): any;
101
+ _cloneOrder(order: ManagedOrder): ManagedOrder;
101
102
  /**
102
103
  * Get order by ID
103
104
  * @param {string} id - Order ID
104
105
  * @returns {Object|undefined} Order object or undefined
105
106
  */
106
- get(id: string): any;
107
+ get(id: string): ManagedOrder | undefined;
107
108
  /**
108
109
  * Set order and mark as modified
109
110
  * @param {string} id - Order ID
110
111
  * @param {Object} order - Order object
111
112
  * @returns {void}
112
113
  */
113
- set(id: string, order: any): void;
114
+ set(id: string, order: ManagedOrder): void;
114
115
  /**
115
116
  * Delete order and mark as modified
116
117
  * @param {string} id - Order ID
@@ -127,12 +128,12 @@ declare class WorkingGrid {
127
128
  * Iterate order values
128
129
  * @returns {IterableIterator<Object>}
129
130
  */
130
- values(): IterableIterator<any>;
131
+ values(): IterableIterator<ManagedOrder>;
131
132
  /**
132
133
  * Iterate [id, order] pairs
133
134
  * @returns {IterableIterator<[string, Object]>}
134
135
  */
135
- entries(): IterableIterator<[string, any]>;
136
+ entries(): IterableIterator<[string, ManagedOrder]>;
136
137
  /**
137
138
  * Iterate order IDs
138
139
  * @returns {IterableIterator<string>}
@@ -147,14 +148,14 @@ declare class WorkingGrid {
147
148
  * Get indexes (builds if not cached)
148
149
  * @returns {Object} - Grid indexes
149
150
  */
150
- getIndexes(): any;
151
+ getIndexes(): unknown;
151
152
  /**
152
153
  * Build delta actions from master grid
153
154
  * @param {Map} masterGrid - Original master grid
154
155
  * @param {Object} [options={}] - Delta options forwarded to ordersEqual
155
156
  * @returns {Array} - Array of action objects
156
157
  */
157
- buildDelta(masterGrid: Map<string, any>, options?: any): any[];
158
+ buildDelta(masterGrid: Map<string, ManagedOrder>, options?: UnknownRecord): unknown[];
158
159
  /**
159
160
  * Check if any modifications were made
160
161
  * @returns {boolean} - True if grid was modified
@@ -180,7 +181,7 @@ declare class WorkingGrid {
180
181
  * Convert to plain Map (for commit)
181
182
  * @returns {Map} - The internal grid map
182
183
  */
183
- toMap(): Map<string, any>;
184
+ toMap(): Map<string, ManagedOrder>;
184
185
  /**
185
186
  * Get memory usage estimate
186
187
  * @returns {Object} - Memory stats
@@ -197,7 +198,7 @@ declare class WorkingGrid {
197
198
  * @param {string} orderId - Order ID to sync
198
199
  * @param {number} [masterVersion] - Current master grid version (updates baseVersion to stay in sync)
199
200
  */
200
- syncFromMaster(masterGrid: Map<string, any>, orderId: string, masterVersion?: number): void;
201
+ syncFromMaster(masterGrid: Map<string, ManagedOrder>, orderId: string, masterVersion?: number): void;
201
202
  }
202
203
  export { WorkingGrid };
203
204
  //# sourceMappingURL=working_grid.d.ts.map
@@ -7,10 +7,7 @@
7
7
  * system prefixes may be read-only.
8
8
  */
9
9
  declare function isGlobalNpmPackageDir(root: string): boolean;
10
- declare function getHomeConfigDir(): string;
11
10
  declare function getHomeProfilesDir(): string;
12
- declare const HOME_CONFIG_DIR: string;
13
- declare const HOME_PROFILES_DIR: string;
14
11
  /**
15
12
  * Resolve the profiles (user state) directory.
16
13
  *
@@ -76,6 +73,7 @@ declare function resolveAnalysisDirs(profilesDir?: string, projectRoot?: string)
76
73
  DIR: string;
77
74
  CHARTS_DIR: string;
78
75
  RESULTS_DIR: string;
76
+ CACHE_DIR: string;
79
77
  ASSETS_DIR: string;
80
78
  };
81
79
  /**
@@ -147,11 +145,12 @@ declare const PATHS: {
147
145
  DIR: string;
148
146
  CHARTS_DIR: string;
149
147
  RESULTS_DIR: string;
148
+ CACHE_DIR: string;
150
149
  ASSETS_DIR: string;
151
150
  };
152
151
  };
153
152
  declare function getNodeBlacklistFile(stateDir?: string): string;
154
153
  declare function getNodeHealthCacheFile(stateDir?: string): string;
155
154
  declare function getRecalculateTriggerFile(botKey: string): string;
156
- export { PATHS, HOME_PROFILES_DIR, HOME_CONFIG_DIR, getHomeConfigDir, getHomeProfilesDir, resolveProfilesDir, resolveMarketAdapterDirs, resolveClawDirs, resolveAnalysisDirs, isGlobalNpmPackageDir, getNodeBlacklistFile, getNodeHealthCacheFile, getRecalculateTriggerFile, computeRelocationNotices, printRelocationNotices };
155
+ export { PATHS, getHomeProfilesDir, resolveProfilesDir, resolveMarketAdapterDirs, resolveClawDirs, resolveAnalysisDirs, isGlobalNpmPackageDir, getNodeBlacklistFile, getNodeHealthCacheFile, getRecalculateTriggerFile, computeRelocationNotices, printRelocationNotices };
157
156
  //# sourceMappingURL=paths.d.ts.map
@@ -83,12 +83,6 @@ function getHomeConfigDir() {
83
83
  function getHomeProfilesDir() {
84
84
  return path.join(getHomeConfigDir(), 'profiles');
85
85
  }
86
- // Snapshot constants — prefer getHomeConfigDir()/getHomeProfilesDir() for live values.
87
- // ESM named imports capture the snapshot; CJS require() interop is patched below via
88
- // Object.defineProperty to return live values (see bottom of file). Future ESM code
89
- // should call getHome*() directly; HOME_* remains for backward compat only.
90
- const HOME_CONFIG_DIR = getHomeConfigDir();
91
- const HOME_PROFILES_DIR = getHomeProfilesDir();
92
86
  /**
93
87
  * Resolve the profiles (user state) directory.
94
88
  *
@@ -234,6 +228,8 @@ function resolveAnalysisDirs(profilesDir = PROFILES_DIR, projectRoot = PROJECT_R
234
228
  DIR: outRoot,
235
229
  CHARTS_DIR: path.join(outRoot, 'charts'),
236
230
  RESULTS_DIR: path.join(outRoot, 'results'),
231
+ // Persistent query caches (e.g. analysis/fills_cache month shards).
232
+ CACHE_DIR: path.join(outRoot, 'cache'),
237
233
  // Vendored read-only assets always live with the code (repo checkout
238
234
  // or npm package), never under the relocated output root.
239
235
  ASSETS_DIR: path.join(sourceDir, 'uplot'),
@@ -341,25 +337,5 @@ function getNodeHealthCacheFile(stateDir) {
341
337
  function getRecalculateTriggerFile(botKey) {
342
338
  return path.join(PATHS.PROFILES_DIR, `recalculate.${botKey}.trigger`);
343
339
  }
344
- export { PATHS, HOME_PROFILES_DIR, HOME_CONFIG_DIR, getHomeConfigDir, getHomeProfilesDir, resolveProfilesDir, resolveMarketAdapterDirs, resolveClawDirs, resolveAnalysisDirs, isGlobalNpmPackageDir, getNodeBlacklistFile, getNodeHealthCacheFile, getRecalculateTriggerFile, computeRelocationNotices, printRelocationNotices };
345
- // Live getters for CJS require() interop (ESM cache not invalidated via require.cache)
346
- try {
347
- // @ts-ignore - patch CJS wrapper if present
348
- const g = globalThis;
349
- if (g.module && g.module.exports) {
350
- Object.defineProperty(g.module.exports, 'HOME_PROFILES_DIR', { get: getHomeProfilesDir, enumerable: true, configurable: true });
351
- Object.defineProperty(g.module.exports, 'HOME_CONFIG_DIR', { get: getHomeConfigDir, enumerable: true, configurable: true });
352
- }
353
- }
354
- catch { }
355
- // Also patch this module's own exports object when loaded via require() interop (Node experimental require(esm))
356
- try {
357
- // @ts-ignore
358
- const exp = typeof exports !== 'undefined' ? exports : undefined;
359
- if (exp) {
360
- Object.defineProperty(exp, 'HOME_PROFILES_DIR', { get: getHomeProfilesDir, enumerable: true, configurable: true });
361
- Object.defineProperty(exp, 'HOME_CONFIG_DIR', { get: getHomeConfigDir, enumerable: true, configurable: true });
362
- }
363
- }
364
- catch { }
340
+ export { PATHS, getHomeProfilesDir, resolveProfilesDir, resolveMarketAdapterDirs, resolveClawDirs, resolveAnalysisDirs, isGlobalNpmPackageDir, getNodeBlacklistFile, getNodeHealthCacheFile, getRecalculateTriggerFile, computeRelocationNotices, printRelocationNotices };
365
341
  //# sourceMappingURL=paths.js.map
@@ -28,7 +28,7 @@ export declare class LinuxProcessDiscovery implements ProcessDiscovery {
28
28
  readStat(pid: number): ProcessStat | null;
29
29
  readMemMB(pid: number): string;
30
30
  readCpuTime(pid: number): string;
31
- readCpuPercent(pid: number, samples?: any, intervalMs?: any): Promise<string>;
31
+ readCpuPercent(pid: number, samples?: number, intervalMs?: number): Promise<string>;
32
32
  readUptime(pid: number): string;
33
33
  readSystemUptimeSec(): number;
34
34
  readSocketInode(socketPath: string): number;
@@ -1,4 +1,5 @@
1
1
  'use strict';
2
+ import { getErrorCode } from './utils/errors.js';
2
3
  import { getStorage } from './storage/index.js';
3
4
  import { runtime } from './runtime.js';
4
5
  import { sleep } from './order/utils/system.js';
@@ -246,7 +247,7 @@ class FallbackProcessDiscovery extends NullProcessDiscovery {
246
247
  return runtime.kill(pid, 0);
247
248
  }
248
249
  catch (err) {
249
- if (err && err.code === 'EPERM')
250
+ if (err && getErrorCode(err) === 'EPERM')
250
251
  return true;
251
252
  return false;
252
253
  }
@@ -3,8 +3,8 @@ export interface Runtime {
3
3
  exitAfterStderrDrain(code: number): void;
4
4
  exitCode: number | undefined;
5
5
  kill(pid: number, signal?: string | number): boolean;
6
- onSignal(signal: string, handler: (...args: any[]) => void): void;
7
- offSignal(signal: string, handler: (...args: any[]) => void): void;
6
+ onSignal(signal: string, handler: (...args: unknown[]) => void): void;
7
+ offSignal(signal: string, handler: (...args: unknown[]) => void): void;
8
8
  readonly pid: number;
9
9
  readonly platform: string;
10
10
  readonly stdout: {
@@ -17,10 +17,14 @@ export interface Runtime {
17
17
  };
18
18
  readonly stdin: {
19
19
  isTTY?: boolean;
20
- on(event: string, handler: (...args: any[]) => void): void;
20
+ isRaw?: boolean;
21
+ on(event: string, handler: (...args: unknown[]) => void): void;
22
+ removeListener(event: string, handler: (...args: unknown[]) => void): void;
21
23
  resume(): void;
22
24
  pause(): void;
23
25
  destroy(): void;
26
+ setRawMode?(mode: boolean): void;
27
+ setEncoding?(encoding: string): void;
24
28
  } | null;
25
29
  readonly argv: string[];
26
30
  cwd(): string;
@@ -1,4 +1,5 @@
1
1
  'use strict';
2
+ import { getErrorCode } from './utils/errors.js';
2
3
  import { isBrowser } from './env.js';
3
4
  class NodeRuntime {
4
5
  exit(code) { process.exit(code); }
@@ -14,7 +15,7 @@ class NodeRuntime {
14
15
  return true;
15
16
  }
16
17
  catch (e) {
17
- if (e && e.code === 'ESRCH') {
18
+ if (e && getErrorCode(e) === 'ESRCH') {
18
19
  return false;
19
20
  }
20
21
  throw e;
@@ -56,14 +57,14 @@ class BrowserRuntime {
56
57
  kill(_pid, _signal) { return false; }
57
58
  onSignal(signal, handler) {
58
59
  if (signal === 'SIGINT' || signal === 'SIGTERM') {
59
- if (isBrowser() && window.addEventListener) {
60
+ if (isBrowser() && window?.addEventListener) {
60
61
  window.addEventListener('beforeunload', handler);
61
62
  }
62
63
  }
63
64
  }
64
65
  offSignal(signal, handler) {
65
66
  if (signal === 'SIGINT' || signal === 'SIGTERM') {
66
- if (isBrowser() && window.removeEventListener) {
67
+ if (isBrowser() && window?.removeEventListener) {
67
68
  window.removeEventListener('beforeunload', handler);
68
69
  }
69
70
  }
@@ -1,17 +1,22 @@
1
+ import type { UnknownRecord } from './types.js';
2
+ import { GRID_LIMITS, FEE_PARAMETERS, INCREMENT_BOUNDS, TIMING, LOGGING_CONFIG, FILL_PROCESSING, PIPELINE_TIMING, API_LIMITS, COW_PERFORMANCE } from './constants.js';
1
3
  export interface BotRuntimeSettings {
2
- gridLimits: Record<string, any>;
3
- feeParams: Record<string, any>;
4
- incrementBounds: Record<string, any>;
5
- timing: Record<string, any>;
6
- fillProcessing: Record<string, any>;
7
- cowPerformance: Record<string, any>;
8
- pipelineTiming: Record<string, any>;
9
- apiLimits: Record<string, any>;
4
+ gridLimits: typeof GRID_LIMITS;
5
+ feeParams: typeof FEE_PARAMETERS;
6
+ incrementBounds: typeof INCREMENT_BOUNDS;
7
+ timing: typeof TIMING;
8
+ fillProcessing: typeof FILL_PROCESSING;
9
+ cowPerformance: typeof COW_PERFORMANCE;
10
+ pipelineTiming: typeof PIPELINE_TIMING;
11
+ apiLimits: typeof API_LIMITS;
10
12
  logging: {
11
13
  level: string;
12
- config: Record<string, any>;
14
+ config: typeof LOGGING_CONFIG;
13
15
  };
14
16
  }
17
+ export type BotRuntimeSettingsOverrides = Partial<BotRuntimeSettings> & {
18
+ poolSlippageTolerance?: number;
19
+ };
15
20
  export declare const RUNTIME_SETTINGS_KEYS: readonly string[];
16
21
  /**
17
22
  * Bot-config keys safe to apply to a live bot without a grid rebuild or a
@@ -26,5 +31,5 @@ export declare const RUNTIME_SETTINGS_KEYS: readonly string[];
26
31
  * (re)starts the credit watchdog, removal stops it).
27
32
  */
28
33
  export declare const BOT_LIVE_CONFIG_KEYS: readonly string[];
29
- export declare function resolveBotRuntimeSettings(botConfig: Record<string, any>): BotRuntimeSettings;
34
+ export declare function resolveBotRuntimeSettings(botConfig: UnknownRecord): BotRuntimeSettings;
30
35
  //# sourceMappingURL=runtime_settings.d.ts.map
@@ -1,6 +1,8 @@
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 { deepMerge } from './settings_merge.js';
5
+ import { isUnknownRecord } from './types.js';
4
6
  import { GRID_LIMITS, FEE_PARAMETERS, INCREMENT_BOUNDS, TIMING, LOG_LEVEL, LOGGING_CONFIG, FILL_PROCESSING, PIPELINE_TIMING, API_LIMITS, COW_PERFORMANCE, } from './constants.js';
5
7
  function _toScreamingCase(key) {
6
8
  return key.replace(/([a-z])([A-Z])/g, '$1_$2').toUpperCase();
@@ -15,7 +17,7 @@ function _normalizeKeys(obj) {
15
17
  return out;
16
18
  }
17
19
  function _deepMerge(target, source) {
18
- return deepMerge(target, _normalizeKeys(source));
20
+ return deepMerge(target ?? {}, _normalizeKeys(source));
19
21
  }
20
22
  export const RUNTIME_SETTINGS_KEYS = [
21
23
  'gridLimits', 'feeParams', 'incrementBounds', 'timing',
@@ -94,10 +96,14 @@ export function resolveBotRuntimeSettings(botConfig) {
94
96
  if (botConfig.apiLimits)
95
97
  result.apiLimits = _deepMerge(result.apiLimits, botConfig.apiLimits);
96
98
  if (botConfig.logging) {
97
- if (botConfig.logging.level)
98
- result.logging.level = botConfig.logging.level;
99
- if (botConfig.logging.config)
100
- result.logging.config = deepMerge(result.logging.config, botConfig.logging.config);
99
+ const loggingOverride = botConfig.logging;
100
+ if (isUnknownRecord(loggingOverride)) {
101
+ if (typeof loggingOverride.level === 'string')
102
+ result.logging.level = loggingOverride.level;
103
+ if (isUnknownRecord(loggingOverride.config)) {
104
+ result.logging.config = deepMerge(result.logging.config, loggingOverride.config);
105
+ }
106
+ }
101
107
  }
102
108
  return result;
103
109
  }
@@ -134,41 +140,41 @@ function _resolveMarketOverrides(botConfig) {
134
140
  const pair = marketAdapter.findPairForBot(botConfig, settings.pairs);
135
141
  if (pair) {
136
142
  if (pair.marketGridLimits)
137
- overrides.gridLimits = _deepMerge(overrides.gridLimits || {}, pair.marketGridLimits);
143
+ overrides.gridLimits = _deepMerge(overrides.gridLimits, pair.marketGridLimits);
138
144
  if (pair.marketFeeParams)
139
- overrides.feeParams = _deepMerge(overrides.feeParams || {}, pair.marketFeeParams);
145
+ overrides.feeParams = _deepMerge(overrides.feeParams, pair.marketFeeParams);
140
146
  if (pair.marketTiming)
141
- overrides.timing = _deepMerge(overrides.timing || {}, pair.marketTiming);
147
+ overrides.timing = _deepMerge(overrides.timing, pair.marketTiming);
142
148
  if (pair.marketIncrementBounds)
143
- overrides.incrementBounds = _deepMerge(overrides.incrementBounds || {}, pair.marketIncrementBounds);
149
+ overrides.incrementBounds = _deepMerge(overrides.incrementBounds, pair.marketIncrementBounds);
144
150
  if (pair.marketFillProcessing)
145
- overrides.fillProcessing = _deepMerge(overrides.fillProcessing || {}, pair.marketFillProcessing);
151
+ overrides.fillProcessing = _deepMerge(overrides.fillProcessing, pair.marketFillProcessing);
146
152
  if (pair.marketCowPerformance)
147
- overrides.cowPerformance = _deepMerge(overrides.cowPerformance || {}, pair.marketCowPerformance);
153
+ overrides.cowPerformance = _deepMerge(overrides.cowPerformance, pair.marketCowPerformance);
148
154
  if (pair.marketPipelineTiming)
149
- overrides.pipelineTiming = _deepMerge(overrides.pipelineTiming || {}, pair.marketPipelineTiming);
155
+ overrides.pipelineTiming = _deepMerge(overrides.pipelineTiming, pair.marketPipelineTiming);
150
156
  if (pair.marketApiLimits)
151
- overrides.apiLimits = _deepMerge(overrides.apiLimits || {}, pair.marketApiLimits);
157
+ overrides.apiLimits = _deepMerge(overrides.apiLimits, pair.marketApiLimits);
152
158
  if (pair.marketPoolSlippageTolerance !== undefined)
153
159
  overrides.poolSlippageTolerance = pair.marketPoolSlippageTolerance;
154
- if (pair.botOverrides && pair.botOverrides[botConfig.name]) {
155
- const bo = pair.botOverrides[botConfig.name];
160
+ if (pair.botOverrides && pair.botOverrides[String(botConfig.name)]) {
161
+ const bo = pair.botOverrides[String(botConfig.name)];
156
162
  if (bo.botGridLimits)
157
- overrides.gridLimits = _deepMerge(overrides.gridLimits || {}, bo.botGridLimits);
163
+ overrides.gridLimits = _deepMerge(overrides.gridLimits, bo.botGridLimits);
158
164
  if (bo.botFeeParams)
159
- overrides.feeParams = _deepMerge(overrides.feeParams || {}, bo.botFeeParams);
165
+ overrides.feeParams = _deepMerge(overrides.feeParams, bo.botFeeParams);
160
166
  if (bo.botTiming)
161
- overrides.timing = _deepMerge(overrides.timing || {}, bo.botTiming);
167
+ overrides.timing = _deepMerge(overrides.timing, bo.botTiming);
162
168
  if (bo.botIncrementBounds)
163
- overrides.incrementBounds = _deepMerge(overrides.incrementBounds || {}, bo.botIncrementBounds);
169
+ overrides.incrementBounds = _deepMerge(overrides.incrementBounds, bo.botIncrementBounds);
164
170
  if (bo.botFillProcessing)
165
- overrides.fillProcessing = _deepMerge(overrides.fillProcessing || {}, bo.botFillProcessing);
171
+ overrides.fillProcessing = _deepMerge(overrides.fillProcessing, bo.botFillProcessing);
166
172
  if (bo.botCowPerformance)
167
- overrides.cowPerformance = _deepMerge(overrides.cowPerformance || {}, bo.botCowPerformance);
173
+ overrides.cowPerformance = _deepMerge(overrides.cowPerformance, bo.botCowPerformance);
168
174
  if (bo.botPipelineTiming)
169
- overrides.pipelineTiming = _deepMerge(overrides.pipelineTiming || {}, bo.botPipelineTiming);
175
+ overrides.pipelineTiming = _deepMerge(overrides.pipelineTiming, bo.botPipelineTiming);
170
176
  if (bo.botApiLimits)
171
- overrides.apiLimits = _deepMerge(overrides.apiLimits || {}, bo.botApiLimits);
177
+ overrides.apiLimits = _deepMerge(overrides.apiLimits, bo.botApiLimits);
172
178
  if (bo.botPoolSlippageTolerance !== undefined)
173
179
  overrides.poolSlippageTolerance = bo.botPoolSlippageTolerance;
174
180
  }
@@ -180,7 +186,7 @@ function _resolveMarketOverrides(botConfig) {
180
186
  }
181
187
  catch (err) {
182
188
  console.warn(`[runtime_settings] Failed to resolve market adapter overrides for bot "${botConfig?.name ?? 'unknown'}" ` +
183
- `(${err?.message || err}); continuing with base settings only.`);
189
+ `(${getErrorMessage(err)}); continuing with base settings only.`);
184
190
  return null;
185
191
  }
186
192
  }