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
@@ -13,12 +13,14 @@
13
13
  * node dist/analysis/analyze_risk_profile.js --source market_adapter --bot-key <key> [options]
14
14
  * node dist/analysis/analyze_risk_profile.js --file <path_to_json> [options]
15
15
  */
16
+ import { getErrorMessage } from '../modules/utils/errors.js';
16
17
  import { calculateAMA } from '../market_adapter/core/strategies/ama.js';
17
18
  import { MARKET_ADAPTER } from '../modules/constants.js';
18
19
  import { generateHTML } from '../market_adapter/lp_chart_core.js';
19
20
  import { calcStdDev, getCandleClose } from './math_utils.js';
20
21
  import { writeChartFile } from './chart_utils.js';
21
22
  import { resolveSource, listAvailableBots } from './resolve_source.js';
23
+ import { baseAnalysisConfig, consumeCommonAnalysisArg } from './analyze_args.js';
22
24
  function normSInv(p) {
23
25
  if (p <= 0 || p >= 1)
24
26
  return p <= 0 ? -Infinity : Infinity;
@@ -71,30 +73,18 @@ function getDivergenceDist(closes, amaConfig) {
71
73
  function parseArgs() {
72
74
  const args = process.argv.slice(2);
73
75
  const config = {
74
- source: { type: 'market_adapter', config: { botKey: '' } },
76
+ ...baseAnalysisConfig(),
75
77
  ama: 'AMA3',
76
78
  output: null,
77
- quiet: false,
78
- listBots: false,
79
79
  };
80
80
  for (let i = 0; i < args.length; i++) {
81
81
  const arg = args[i];
82
- if (arg === '--source')
83
- config.source.type = args[++i];
84
- else if (arg === '--bot-key')
85
- config.source.config.botKey = args[++i];
86
- else if (arg === '--file') {
87
- config.source.config.filePath = args[++i];
88
- config.source.type = 'json';
89
- }
90
- else if (arg === '--ama')
82
+ if (consumeCommonAnalysisArg(arg, () => args[++i], config))
83
+ continue;
84
+ if (arg === '--ama')
91
85
  config.ama = args[++i];
92
86
  else if (arg === '--output')
93
87
  config.output = args[++i];
94
- else if (arg === '--list-bots')
95
- config.listBots = true;
96
- else if (arg === '--quiet')
97
- config.quiet = true;
98
88
  }
99
89
  return config;
100
90
  }
@@ -168,7 +158,7 @@ async function main() {
168
158
  pool: `${pairName} ${config.ama} Risk Analysis`,
169
159
  assetA: { symbol: 'Base' },
170
160
  assetB: { symbol: 'Quote' },
171
- intervalSeconds: candles.length > 1 ? ((candles[1]?.timestamp ?? candles[1]?.[0] ?? 0) - (candles[0]?.timestamp ?? candles[0]?.[0] ?? 0)) / 1000 : 3600,
161
+ intervalSeconds: candles.length > 1 ? (Number(candles[1]?.timestamp ?? candles[1]?.[0] ?? 0) - Number(candles[0]?.timestamp ?? candles[0]?.[0] ?? 0)) / 1000 : 3600,
172
162
  thresholds: thresholds,
173
163
  sigmaAmaDelta: amaDeltaSigma !== null ? +((amaDeltaSigma * 100).toFixed(3)) : null
174
164
  };
@@ -178,7 +168,7 @@ async function main() {
178
168
  }
179
169
  }
180
170
  catch (err) {
181
- console.error(`[RiskProfile] Error: ${err?.message ?? err}`);
171
+ console.error(`[RiskProfile] Error: ${getErrorMessage(err)}`);
182
172
  process.exit(1);
183
173
  }
184
174
  }
@@ -14,16 +14,18 @@
14
14
  * Output:
15
15
  * Self-contained HTML file with inline CSS (no JS dependencies).
16
16
  */
17
+ import { getErrorMessage } from '../modules/utils/errors.js';
17
18
  import path from 'node:path';
18
19
  import { calculateAMA } from '../market_adapter/core/strategies/ama.js';
19
20
  import { MARKET_ADAPTER } from '../modules/constants.js';
20
21
  import { calcStdDev, getCandleClose } from './math_utils.js';
21
22
  import { writeChartFile } from './chart_utils.js';
22
23
  import { resolveSource, listAvailableBots } from './resolve_source.js';
24
+ import { baseAnalysisConfig, consumeCommonAnalysisArg } from './analyze_args.js';
23
25
  function parseArgs() {
24
26
  const args = process.argv.slice(2);
25
27
  const config = {
26
- source: { type: 'market_adapter', config: { botKey: '' } },
28
+ ...baseAnalysisConfig(),
27
29
  ama: 'AMA3',
28
30
  output: 'analysis/charts/trade_heatmap.html',
29
31
  buckets: null,
@@ -33,20 +35,12 @@ function parseArgs() {
33
35
  binSize: 5,
34
36
  sliceMonths: 12,
35
37
  thresholds: [1, 2, 3, 5, 10, 20],
36
- quiet: false,
37
- listBots: false,
38
38
  };
39
39
  for (let i = 0; i < args.length; i++) {
40
40
  const arg = args[i];
41
- if (arg === '--source')
42
- config.source.type = args[++i];
43
- else if (arg === '--bot-key')
44
- config.source.config.botKey = args[++i];
45
- else if (arg === '--file') {
46
- config.source.config.filePath = args[++i];
47
- config.source.type = 'json';
48
- }
49
- else if (arg === '--ama')
41
+ if (consumeCommonAnalysisArg(arg, () => args[++i], config))
42
+ continue;
43
+ if (arg === '--ama')
50
44
  config.ama = args[++i];
51
45
  else if (arg === '--output')
52
46
  config.output = args[++i];
@@ -64,10 +58,6 @@ function parseArgs() {
64
58
  config.sliceMonths = parseInt(args[++i], 10);
65
59
  else if (arg === '--thresholds')
66
60
  config.thresholds = args[++i].split(',').map(Number);
67
- else if (arg === '--list-bots')
68
- config.listBots = true;
69
- else if (arg === '--quiet')
70
- config.quiet = true;
71
61
  }
72
62
  return config;
73
63
  }
@@ -350,7 +340,7 @@ table.heatmap td.yl { color: #8b949e; font-size: 10px; text-align: right; paddin
350
340
  console.log(`[TradeHeatmap] ✓ Heatmap saved to ${cfg.output}`);
351
341
  }
352
342
  catch (err) {
353
- console.error(`[TradeHeatmap] Error: ${err?.message ?? err}`);
343
+ console.error(`[TradeHeatmap] Error: ${getErrorMessage(err)}`);
354
344
  process.exit(1);
355
345
  }
356
346
  }
@@ -19,6 +19,7 @@
19
19
  * node dist/analysis/analyze_volatility.js \
20
20
  * --file market_adapter/data/lp/<path>/<to>/<lp-candles>.json
21
21
  */
22
+ import { getErrorMessage } from '../modules/utils/errors.js';
22
23
  import path from 'node:path';
23
24
  import { calculateAMA } from '../market_adapter/core/strategies/ama.js';
24
25
  import { computeATRSeries } from '../market_adapter/core/strategies/atr/calculator.js';
@@ -30,6 +31,7 @@ import { PATHS } from '../modules/paths.js';
30
31
  import { getCandleClose } from './math_utils.js';
31
32
  import { writeChartFile } from './chart_utils.js';
32
33
  import { resolveSource, listAvailableBots } from './resolve_source.js';
34
+ import { baseAnalysisConfig, consumeCommonAnalysisArg } from './analyze_args.js';
33
35
  const DEFAULT_ATR_PERIOD = MARKET_ADAPTER.DYNAMIC_WEIGHT_ATR_PERIOD_DEFAULT;
34
36
  const MIN_WEIGHT = MARKET_ADAPTER.DYNAMIC_WEIGHT_MIN_WEIGHT;
35
37
  const MAX_WEIGHT = MARKET_ADAPTER.DYNAMIC_WEIGHT_MAX_WEIGHT;
@@ -43,27 +45,19 @@ function computeATRSeriesNormalized(candles, period = DEFAULT_ATR_PERIOD) {
43
45
  function parseArgs() {
44
46
  const args = process.argv.slice(2);
45
47
  const config = {
46
- source: { type: 'market_adapter', config: { botKey: '' } },
48
+ ...baseAnalysisConfig(),
47
49
  chartFile: DEFAULT_CHART_FILE,
48
50
  threshold: DEFAULT_THRESHOLD,
49
51
  atrPeriod: DEFAULT_ATR_PERIOD,
50
52
  exponent: MARKET_ADAPTER.DYNAMIC_WEIGHT_VOLATILITY_EXPONENT,
51
53
  scaleX: MARKET_ADAPTER.DYNAMIC_WEIGHT_VOLATILITY_SCALE_X_DEFAULT,
52
54
  clamp: DEFAULT_CLAMP,
53
- quiet: false,
54
- listBots: false,
55
55
  };
56
56
  for (let i = 0; i < args.length; i++) {
57
57
  const arg = args[i];
58
- if (arg === '--source')
59
- config.source.type = args[++i];
60
- else if (arg === '--bot-key')
61
- config.source.config.botKey = args[++i];
62
- else if (arg === '--file') {
63
- config.source.config.filePath = args[++i];
64
- config.source.type = 'json';
65
- }
66
- else if (arg === '--chart')
58
+ if (consumeCommonAnalysisArg(arg, () => args[++i], config))
59
+ continue;
60
+ if (arg === '--chart')
67
61
  config.chartFile = args[++i];
68
62
  else if (arg === '--threshold')
69
63
  config.threshold = parseFloat(args[++i]);
@@ -78,10 +72,6 @@ function parseArgs() {
78
72
  config.scaleX = parseFloat(args[++i]);
79
73
  else if (arg === '--clamp')
80
74
  config.clamp = parseFloat(args[++i]);
81
- else if (arg === '--list-bots')
82
- config.listBots = true;
83
- else if (arg === '--quiet')
84
- config.quiet = true;
85
75
  }
86
76
  return config;
87
77
  }
@@ -157,7 +147,7 @@ async function main() {
157
147
  console.log(`[Volatility] ✓ Chart saved to ${config.chartFile}`);
158
148
  }
159
149
  catch (err) {
160
- console.error(`[Volatility] Error: ${err?.message ?? err}`);
150
+ console.error(`[Volatility] Error: ${getErrorMessage(err)}`);
161
151
  process.exit(1);
162
152
  }
163
153
  }
@@ -3,6 +3,40 @@ declare const WEIGHT_PROFILES: {
3
3
  neutral: number;
4
4
  mountain: number;
5
5
  };
6
+ declare function parseArgs(): {
7
+ dataPath: string | null;
8
+ resultsPath: string | null;
9
+ spreadValues: number[];
10
+ incrementValues: number[];
11
+ ratioValues: number[];
12
+ maxOrders: number;
13
+ feeRoundtripPct: number;
14
+ minSpreadFactor: number;
15
+ capital: number;
16
+ repositionPct: number;
17
+ asymmetricBounds: boolean;
18
+ btsCreateFee: number;
19
+ btsCancelFee: number;
20
+ makerCreateFactor: number;
21
+ txFeePrice: number;
22
+ topN: number;
23
+ lookbackBars: number | null;
24
+ };
25
+ interface AmaStrategy {
26
+ id: string;
27
+ name: string;
28
+ er: number;
29
+ fast: number;
30
+ slow: number;
31
+ }
32
+ interface GridOrder {
33
+ level: number;
34
+ price: number;
35
+ railIdx: number;
36
+ cooldownUntil: number;
37
+ size: number;
38
+ [key: string]: unknown;
39
+ }
6
40
  /**
7
41
  * Allocate capital across N levels using weight profile.
8
42
  * weight > 0: mountain (more near center, exponential decay outward)
@@ -27,9 +61,14 @@ declare function allocateFundsByWeights(totalFunds: number, n: number, weight: n
27
61
  *
28
62
  * Returns arrays of buy and sell order objects with fixed chain prices and sizes.
29
63
  */
30
- declare function buildGrid(center: number, params: any, capitalPerSide: number, weightFactor: number): {
31
- buys: any[];
32
- sells: any[];
64
+ declare function buildGrid(center: number, params: {
65
+ incrementPct: number;
66
+ maxMinRatio: number;
67
+ maxOrders: number;
68
+ spreadPct: number;
69
+ }, capitalPerSide: number, weightFactor: number): {
70
+ buys: GridOrder[];
71
+ sells: GridOrder[];
33
72
  rail: number[];
34
73
  };
35
74
  /**
@@ -47,11 +86,36 @@ declare function markInventoryAtPrice(inventory: {
47
86
  grossUnits: number;
48
87
  profitUnits: number;
49
88
  };
50
- declare function simulatePersistentGrid(candles: any[], amaValues: number[], params: any, weightName: string, weightFactor: number): {
89
+ interface SimCandle {
90
+ open?: number;
91
+ high: number;
92
+ low: number;
93
+ close: number;
94
+ time?: number;
95
+ [key: string]: unknown;
96
+ }
97
+ interface SimParams {
98
+ spreadPct: number;
99
+ incrementPct: number;
100
+ maxMinRatio: number;
101
+ maxOrders: number;
102
+ feeRoundtripPct: number;
103
+ capital: number;
104
+ repositionThreshold: number;
105
+ asymmetricBounds: boolean;
106
+ btsCreateFee: number;
107
+ btsCancelFee: number;
108
+ makerCreateFactor: number;
109
+ txFeePrice: number;
110
+ warmupBars: number;
111
+ lookbackBars: number;
112
+ [key: string]: unknown;
113
+ }
114
+ declare function simulatePersistentGrid(candles: SimCandle[], amaValues: number[], params: SimParams, weightName: string, weightFactor: number): {
51
115
  weightName: string;
52
- spreadPct: any;
116
+ spreadPct: number;
53
117
  incrementPct: number;
54
- maxMinRatio: any;
118
+ maxMinRatio: number;
55
119
  matchedPairs: number;
56
120
  cyclesTotal: number;
57
121
  rotationCount: number;
@@ -84,7 +148,7 @@ declare function simulatePersistentGrid(candles: any[], amaValues: number[], par
84
148
  avgTriggerDriftPct: number;
85
149
  offsetAppliedCount: number;
86
150
  makerCreateFeeBts: number;
87
- btsCancelFee: any;
151
+ btsCancelFee: number;
88
152
  avgCancelOrdersPerReposition: number;
89
153
  estimatedFeePerRepositionBts: number;
90
154
  totalRepositionFeesBts: number;
@@ -96,11 +160,155 @@ declare function simulatePersistentGrid(candles: any[], amaValues: number[], par
96
160
  netScore: number;
97
161
  score: number;
98
162
  };
99
- declare function sweepOneAma(strategy: any, candles: any[], closes: number[], weightEntries: [string, number][], cfg: any): {
100
- strategy: any;
101
- best: any;
102
- top5: any[];
103
- allSims: any[];
163
+ declare function sweepOneAma(strategy: AmaStrategy, candles: SimCandle[], closes: number[], weightEntries: [string, number][], cfg: ReturnType<typeof parseArgs>): {
164
+ strategy: AmaStrategy;
165
+ best: {
166
+ weightName: string;
167
+ spreadPct: number;
168
+ incrementPct: number;
169
+ maxMinRatio: number;
170
+ matchedPairs: number;
171
+ cyclesTotal: number;
172
+ rotationCount: number;
173
+ inventorySaleCount: number;
174
+ touchedOrders: number;
175
+ fillEfficiency: number;
176
+ totalProfitUnits: number;
177
+ totalGrossUnits: number;
178
+ finalInventoryUnits: number;
179
+ finalInventoryAvgEntry: number;
180
+ finalInventoryMarkUnits: number;
181
+ profitPerCapital: number;
182
+ pairsPerDay: number;
183
+ avgOpenDurationBars: number;
184
+ avgProfitPerPair: number;
185
+ peakOpenOrders: number;
186
+ avgImbalance: number;
187
+ canceledOnReposition: number;
188
+ repositionCount: number;
189
+ driftTriggerCount: number;
190
+ slopeTriggerCount: number;
191
+ maxDrawdown: number;
192
+ maxDrawdownPct: number;
193
+ maxInventoryExposure: number;
194
+ avgGridAgeBars: number;
195
+ maxGridAgeBars: number;
196
+ avgCenterDriftPct: number;
197
+ maxCenterDriftPct: number;
198
+ nearThresholdBarsPct: number;
199
+ avgTriggerDriftPct: number;
200
+ offsetAppliedCount: number;
201
+ makerCreateFeeBts: number;
202
+ btsCancelFee: number;
203
+ avgCancelOrdersPerReposition: number;
204
+ estimatedFeePerRepositionBts: number;
205
+ totalRepositionFeesBts: number;
206
+ feePerDayBts: number;
207
+ netProfitUnits: number;
208
+ netProfitPerCapital: number;
209
+ ordersPerSide: number;
210
+ grossScore: number;
211
+ netScore: number;
212
+ score: number;
213
+ } | null;
214
+ top5: {
215
+ weightName: string;
216
+ spreadPct: number;
217
+ incrementPct: number;
218
+ maxMinRatio: number;
219
+ matchedPairs: number;
220
+ cyclesTotal: number;
221
+ rotationCount: number;
222
+ inventorySaleCount: number;
223
+ touchedOrders: number;
224
+ fillEfficiency: number;
225
+ totalProfitUnits: number;
226
+ totalGrossUnits: number;
227
+ finalInventoryUnits: number;
228
+ finalInventoryAvgEntry: number;
229
+ finalInventoryMarkUnits: number;
230
+ profitPerCapital: number;
231
+ pairsPerDay: number;
232
+ avgOpenDurationBars: number;
233
+ avgProfitPerPair: number;
234
+ peakOpenOrders: number;
235
+ avgImbalance: number;
236
+ canceledOnReposition: number;
237
+ repositionCount: number;
238
+ driftTriggerCount: number;
239
+ slopeTriggerCount: number;
240
+ maxDrawdown: number;
241
+ maxDrawdownPct: number;
242
+ maxInventoryExposure: number;
243
+ avgGridAgeBars: number;
244
+ maxGridAgeBars: number;
245
+ avgCenterDriftPct: number;
246
+ maxCenterDriftPct: number;
247
+ nearThresholdBarsPct: number;
248
+ avgTriggerDriftPct: number;
249
+ offsetAppliedCount: number;
250
+ makerCreateFeeBts: number;
251
+ btsCancelFee: number;
252
+ avgCancelOrdersPerReposition: number;
253
+ estimatedFeePerRepositionBts: number;
254
+ totalRepositionFeesBts: number;
255
+ feePerDayBts: number;
256
+ netProfitUnits: number;
257
+ netProfitPerCapital: number;
258
+ ordersPerSide: number;
259
+ grossScore: number;
260
+ netScore: number;
261
+ score: number;
262
+ }[];
263
+ allSims: {
264
+ weightName: string;
265
+ spreadPct: number;
266
+ incrementPct: number;
267
+ maxMinRatio: number;
268
+ matchedPairs: number;
269
+ cyclesTotal: number;
270
+ rotationCount: number;
271
+ inventorySaleCount: number;
272
+ touchedOrders: number;
273
+ fillEfficiency: number;
274
+ totalProfitUnits: number;
275
+ totalGrossUnits: number;
276
+ finalInventoryUnits: number;
277
+ finalInventoryAvgEntry: number;
278
+ finalInventoryMarkUnits: number;
279
+ profitPerCapital: number;
280
+ pairsPerDay: number;
281
+ avgOpenDurationBars: number;
282
+ avgProfitPerPair: number;
283
+ peakOpenOrders: number;
284
+ avgImbalance: number;
285
+ canceledOnReposition: number;
286
+ repositionCount: number;
287
+ driftTriggerCount: number;
288
+ slopeTriggerCount: number;
289
+ maxDrawdown: number;
290
+ maxDrawdownPct: number;
291
+ maxInventoryExposure: number;
292
+ avgGridAgeBars: number;
293
+ maxGridAgeBars: number;
294
+ avgCenterDriftPct: number;
295
+ maxCenterDriftPct: number;
296
+ nearThresholdBarsPct: number;
297
+ avgTriggerDriftPct: number;
298
+ offsetAppliedCount: number;
299
+ makerCreateFeeBts: number;
300
+ btsCancelFee: number;
301
+ avgCancelOrdersPerReposition: number;
302
+ estimatedFeePerRepositionBts: number;
303
+ totalRepositionFeesBts: number;
304
+ feePerDayBts: number;
305
+ netProfitUnits: number;
306
+ netProfitPerCapital: number;
307
+ ordersPerSide: number;
308
+ grossScore: number;
309
+ netScore: number;
310
+ score: number;
311
+ }[];
104
312
  evaluated: number;
105
313
  };
106
314
  export { WEIGHT_PROFILES, allocateFundsByWeights, buildGrid, markInventoryAtPrice, simulatePersistentGrid, sweepOneAma };
@@ -84,6 +84,7 @@ function parseArgs() {
84
84
  makerCreateFactor: DEFAULT_BTS_MAKER_CREATE_FACTOR,
85
85
  txFeePrice: DEFAULT_TX_FEE_PRICE,
86
86
  topN: 15,
87
+ lookbackBars: null,
87
88
  };
88
89
  for (let i = 0; i < args.length; i++) {
89
90
  const arg = args[i];
@@ -159,6 +160,10 @@ function parseArgs() {
159
160
  out.topN = Number(val);
160
161
  i++;
161
162
  break;
163
+ case '--lookback':
164
+ out.lookbackBars = Math.max(1, Math.round(Number(val)));
165
+ i++;
166
+ break;
162
167
  }
163
168
  }
164
169
  if (!out.dataPath) {
@@ -192,6 +197,7 @@ function printHelp() {
192
197
  console.log(' --maker-create-factor Maker share of create fee (default: 0.10)');
193
198
  console.log(' --tx-fee-price <n> Convert BTS fees into backtest units (default: 1.0)');
194
199
  console.log(' --top <n> Show top N results (default: 15)');
200
+ console.log(` --lookback <bars> Huber slope lookback override (default: ${SLOPE_LOOKBACK_BARS})`);
195
201
  }
196
202
  function loadAmaStrategies(resultsPath) {
197
203
  const json = readJSON(resultsPath);
@@ -201,9 +207,9 @@ function loadAmaStrategies(resultsPath) {
201
207
  const out = [];
202
208
  for (const [key, val] of Object.entries(amas)) {
203
209
  const v = val;
204
- if (!v || !Number.isFinite(v.er))
210
+ if (!v || !Number.isFinite(Number(v.er)))
205
211
  continue;
206
- out.push({ id: key, name: v.label || key, er: v.er, fast: v.fast, slow: v.slow });
212
+ out.push({ id: key, name: String(v.label || key), er: Number(v.er), fast: Number(v.fast), slow: Number(v.slow) });
207
213
  }
208
214
  out.sort((a, b) => a.id.localeCompare(b.id));
209
215
  if (out.length === 0)
@@ -292,6 +298,15 @@ function markInventoryAtPrice(inventory, exitPrice, feeRoundtripPct) {
292
298
  }
293
299
  function simulatePersistentGrid(candles, amaValues, params, weightName, weightFactor) {
294
300
  const { spreadPct, incrementPct, maxMinRatio, feeRoundtripPct, capital, repositionThreshold, asymmetricBounds, btsCreateFee, btsCancelFee, makerCreateFactor, txFeePrice } = params;
301
+ // Slope-delta persistence gate: follow the production default (constants)
302
+ // unless the caller pins a value, so the sweep's reset path matches live
303
+ // whenever asymmetricBounds enables trigger B.
304
+ const slopePersistBarsRaw = Number(params.slopePersistBars);
305
+ const slopePersistBars = Number.isFinite(slopePersistBarsRaw) && slopePersistBarsRaw >= 1
306
+ ? Math.round(slopePersistBarsRaw)
307
+ : (MARKET_ADAPTER.AMA_SLOPE_PERSIST_ENABLED === true && Number(MARKET_ADAPTER.AMA_SLOPE_PERSIST_BARS) >= 1
308
+ ? Math.round(Number(MARKET_ADAPTER.AMA_SLOPE_PERSIST_BARS))
309
+ : 1);
295
310
  // Warmup follows production AMA seeding/convergence (getAmaWarmupBars,
296
311
  // passed via params.warmupBars from sweepOneAma) instead of an arbitrary
297
312
  // fraction of the dataset. Direct callers that omit warmupBars fall back
@@ -316,9 +331,14 @@ function simulatePersistentGrid(candles, amaValues, params, weightName, weightFa
316
331
  }
317
332
  // Production AMA slope series (%/bar averaged over the lookback window) —
318
333
  // feeds trigger B and the grid price offset when asymmetricBounds is on.
334
+ // Lookback is overridable for research (params.lookbackBars); production
335
+ // callers leave it unset and get the centralized constant.
336
+ const slopeLookbackBars = Number.isFinite(params.lookbackBars) && params.lookbackBars >= 1
337
+ ? Math.round(params.lookbackBars)
338
+ : SLOPE_LOOKBACK_BARS;
319
339
  const slopeAt = new Array(candles.length).fill(null);
320
- for (let j = SLOPE_LOOKBACK_BARS; j < candles.length; j++) {
321
- const s = computeHuberWindowSlopePct(amaValues, j, SLOPE_LOOKBACK_BARS);
340
+ for (let j = slopeLookbackBars; j < candles.length; j++) {
341
+ const s = computeHuberWindowSlopePct(amaValues, j, slopeLookbackBars);
322
342
  if (s != null && Number.isFinite(s))
323
343
  slopeAt[j] = s;
324
344
  }
@@ -392,6 +412,9 @@ function simulatePersistentGrid(candles, amaValues, params, weightName, weightFa
392
412
  // Slope-delta baseline: mirrors botState.gridRangeScalingAmaSlope —
393
413
  // seeded at bootstrap and re-seeded on every reset.
394
414
  let slopeBaseline = null;
415
+ // Persistence-gate state for trigger B.
416
+ let slopePersistCount = 0;
417
+ let slopePersistDir = 0;
395
418
  for (let j = startIdx + 1; j < candles.length; j++) {
396
419
  if (slopeAt[j] != null) {
397
420
  slopeBaseline = slopeAt[j];
@@ -421,13 +444,34 @@ function simulatePersistentGrid(candles, amaValues, params, weightName, weightFa
421
444
  driftTriggerCount++;
422
445
  }
423
446
  if (!shouldReposition && asymmetricBounds && slopeBaseline != null && slopeAt[i] != null) {
424
- const slopeDeltaPct = Math.abs(slopeAt[i] - slopeBaseline);
425
- if (slopeDeltaPct >= slopeDeltaThresholdPct) {
426
- shouldReposition = true;
427
- slopeTriggerCount++;
447
+ const crossed = Math.abs(slopeAt[i] - slopeBaseline) >= slopeDeltaThresholdPct;
448
+ if (slopePersistBars <= 1) {
449
+ if (crossed) {
450
+ shouldReposition = true;
451
+ slopeTriggerCount++;
452
+ }
453
+ }
454
+ else if (!crossed) {
455
+ slopePersistCount = 0;
456
+ slopePersistDir = 0;
457
+ }
458
+ else {
459
+ const dir = Math.sign(slopeAt[i] - slopeBaseline);
460
+ if (dir !== 0 && dir === slopePersistDir)
461
+ slopePersistCount++;
462
+ else {
463
+ slopePersistDir = dir;
464
+ slopePersistCount = 1;
465
+ }
466
+ if (slopePersistCount >= slopePersistBars) {
467
+ shouldReposition = true;
468
+ slopeTriggerCount++;
469
+ }
428
470
  }
429
471
  }
430
472
  if (shouldReposition && Number.isFinite(ama) && ama > 0) {
473
+ slopePersistCount = 0;
474
+ slopePersistDir = 0;
431
475
  canceledOnReposition += orders.size;
432
476
  btsFeesBts += orders.size * btsCancelFee;
433
477
  orders.clear(); // inventory survives — resync never market-sells
@@ -674,6 +718,7 @@ function sweepOneAma(strategy, candles, closes, weightEntries, cfg) {
674
718
  makerCreateFactor: cfg.makerCreateFactor,
675
719
  txFeePrice: cfg.txFeePrice,
676
720
  warmupBars,
721
+ lookbackBars: cfg.lookbackBars,
677
722
  }, weightName, weightFactor);
678
723
  if (!best || sim.score > best.score)
679
724
  best = sim;
@@ -714,7 +759,7 @@ function runParallel(strategies, candles, closes, weightEntries, cfg) {
714
759
  const worker = new Worker(fileURLToPath(import.meta.url), {
715
760
  workerData: { strategy, candles, closes, weightEntries, cfg },
716
761
  });
717
- worker.on('message', resolve);
762
+ worker.on('message', (msg) => resolve(msg));
718
763
  worker.on('error', reject);
719
764
  worker.on('exit', (code) => {
720
765
  if (code !== 0)
@@ -746,7 +791,7 @@ async function run() {
746
791
  console.log(` Spread floor: > fee (${cfg.feeRoundtripPct}%)`);
747
792
  console.log(` Reset (A): ${cfg.repositionPct}% AMA drift from grid center (ratchet)`);
748
793
  console.log(` Asym. bounds: ${cfg.asymmetricBounds ? 'ON — slope reset (B) + grid price offset enabled (whitelist semantics)' : 'OFF — typical non-whitelisted bot (production default)'}`);
749
- console.log(` Reset (B): |slope - slope@lastReset| >= ${fmt((SLOPE_TRIGGER_FACTOR / 100) * SLOPE_MAX_PCT, 4)}% (lookback ${SLOPE_LOOKBACK_BARS})${cfg.asymmetricBounds ? '' : ' [gated off]'}`);
794
+ console.log(` Reset (B): |slope - slope@lastReset| >= ${fmt((SLOPE_TRIGGER_FACTOR / 100) * SLOPE_MAX_PCT, 4)}% (lookback ${cfg.lookbackBars ?? SLOPE_LOOKBACK_BARS})${cfg.asymmetricBounds ? '' : ' [gated off]'}`);
750
795
  console.log(` Tx model: create=${fmt(cfg.btsCreateFee, 5)} BTS, cancel=${fmt(cfg.btsCancelFee, 5)} BTS, maker=${fmt(cfg.makerCreateFactor * 100, 1)}%, 1 BTS=${fmt(cfg.txFeePrice, 2)} units`);
751
796
  console.log(` Combos/AMA: ${totalCombos} | Total: ${totalCombos * strategies.length}\n`);
752
797
  // ── Run AMA sweeps in parallel (one worker per AMA strategy) ──────
@@ -100,10 +100,40 @@ declare function buildProductionGrid(center: number, spreadPct: number, incremen
100
100
  * #10 pool-price fills (no book depth/slippage);
101
101
  * #11 no consolidation/dust-cancel/COW/collision mechanics.
102
102
  */
103
- declare function simulateForParams(candles: any, amaValues: any, params: any): {
104
- spreadPct: any;
105
- incrementPct: any;
106
- maxMinRatio: any;
103
+ interface SimCandle {
104
+ open?: number;
105
+ high: number;
106
+ low: number;
107
+ close: number;
108
+ time?: number;
109
+ [key: string]: unknown;
110
+ }
111
+ interface SimParams {
112
+ spreadPct: number;
113
+ incrementPct: number;
114
+ maxMinRatio: number;
115
+ activeOrders: number;
116
+ feeRoundtripPct: number;
117
+ repositionThresholdPct: number;
118
+ asymmetricBounds: boolean;
119
+ risk: {
120
+ duration: number;
121
+ peakOpen: number;
122
+ imbalance: number;
123
+ cancel: number;
124
+ };
125
+ btsCreateFee: number;
126
+ btsCancelFee: number;
127
+ makerCreateFactor: number;
128
+ txFeePrice: number;
129
+ btsFeeCapital: number;
130
+ warmupBars: number;
131
+ [key: string]: unknown;
132
+ }
133
+ declare function simulateForParams(candles: SimCandle[], amaValues: number[], params: SimParams): {
134
+ spreadPct: number;
135
+ incrementPct: number;
136
+ maxMinRatio: number;
107
137
  touchedOrders: number;
108
138
  matchedPairs: number;
109
139
  cyclesTotal: number;