dexbot 1.6.10 → 1.6.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (365) hide show
  1. package/CHANGELOG.md +50 -3
  2. package/README.md +3 -1
  3. package/analysis/README.md +51 -11
  4. package/analysis/bot_fitting/README.md +12 -0
  5. package/analysis/tradingview/README.md +3 -3
  6. package/analysis/trend_detection/DYNAMIC_WEIGHT_RESEARCH.md +11 -37
  7. package/analysis/trend_detection/README.md +31 -0
  8. package/claw/docs/DEXBOT2_TUNING_CHEAT_SHEET.md +4 -3
  9. package/claw/modules/chain_broadcast.ts +7 -1
  10. package/claw/modules/claw_launcher.ts +1 -1
  11. package/claw/modules/launcher_mode_detector.ts +9 -2
  12. package/claw/package.json +1 -1
  13. package/claw/runtimes/openclaw-plugin/openclaw.plugin.json +1 -1
  14. package/claw/runtimes/openclaw-plugin/package.json +1 -1
  15. package/dist/analysis/account_resolver.d.ts +1 -1
  16. package/dist/analysis/account_resolver.js +15 -2
  17. package/dist/analysis/ama_fitting/analyze_ama_price_changes.js +3 -4
  18. package/dist/analysis/ama_fitting/analyze_lambda_vs_slow.js +2 -7
  19. package/dist/analysis/ama_fitting/calibrate_convergence_er.js +0 -1
  20. package/dist/analysis/ama_fitting/fetch_lp_candles.js +4 -4
  21. package/dist/analysis/ama_fitting/generate_unified_comparison_chart.d.ts +20 -4
  22. package/dist/analysis/ama_fitting/generate_unified_comparison_chart.js +9 -6
  23. package/dist/analysis/ama_fitting/optimizer_high_resolution.js +16 -12
  24. package/dist/analysis/analyze_args.d.ts +31 -0
  25. package/dist/analysis/analyze_args.js +41 -0
  26. package/dist/analysis/analyze_dynamic_weight.js +7 -20
  27. package/dist/analysis/analyze_kalman.js +7 -17
  28. package/dist/analysis/analyze_regime.js +7 -17
  29. package/dist/analysis/analyze_regime_windows.js +8 -18
  30. package/dist/analysis/analyze_risk_profile.js +8 -18
  31. package/dist/analysis/analyze_trade_heatmap.js +7 -17
  32. package/dist/analysis/analyze_volatility.js +7 -17
  33. package/dist/analysis/bot_fitting/backtest_ama_sweep.d.ts +220 -12
  34. package/dist/analysis/bot_fitting/backtest_ama_sweep.js +55 -10
  35. package/dist/analysis/bot_fitting/backtest_bot_fitting.d.ts +34 -4
  36. package/dist/analysis/bot_fitting/backtest_bot_fitting.js +72 -66
  37. package/dist/analysis/bot_fitting/backtest_lookback_drawdown.d.ts +21 -0
  38. package/dist/analysis/bot_fitting/backtest_lookback_drawdown.js +315 -0
  39. package/dist/analysis/bot_fitting/shared_utils.d.ts +7 -7
  40. package/dist/analysis/bot_fitting/shared_utils.js +2 -2
  41. package/dist/analysis/bot_key_utils.d.ts +18 -10
  42. package/dist/analysis/bot_key_utils.js +10 -17
  43. package/dist/analysis/bot_usage/discover_bot_accounts.js +44 -47
  44. package/dist/analysis/bot_usage/kibana_bot_queries.d.ts +1 -21
  45. package/dist/analysis/chain_pool.d.ts +3 -1
  46. package/dist/analysis/chart_ui.d.ts +5 -2
  47. package/dist/analysis/chart_ui.js +6 -3
  48. package/dist/analysis/chart_utils.d.ts +5 -5
  49. package/dist/analysis/chart_utils.js +9 -0
  50. package/dist/analysis/fills_cache.d.ts +64 -0
  51. package/dist/analysis/fills_cache.js +254 -0
  52. package/dist/analysis/fills_source.d.ts +2 -2
  53. package/dist/analysis/fills_source.js +19 -14
  54. package/dist/analysis/grid_correction_check.d.ts +1 -1
  55. package/dist/analysis/grid_correction_check.js +12 -11
  56. package/dist/analysis/math_utils.d.ts +7 -6
  57. package/dist/analysis/math_utils.js +5 -8
  58. package/dist/analysis/pnl_report.d.ts +39 -0
  59. package/dist/analysis/pnl_report.js +325 -0
  60. package/dist/analysis/price_sources.d.ts +8 -8
  61. package/dist/analysis/price_sources.js +5 -4
  62. package/dist/analysis/resolve_bot_accounts.js +2 -2
  63. package/dist/analysis/resolve_source.d.ts +1 -2
  64. package/dist/analysis/trade_profitability.d.ts +32 -2
  65. package/dist/analysis/trade_profitability.js +232 -106
  66. package/dist/analysis/tradingview/analyze_tradingview.d.ts +17 -6
  67. package/dist/analysis/tradingview/analyze_tradingview.js +9 -10
  68. package/dist/analysis/tradingview/grid_reset_config.d.ts +42 -31
  69. package/dist/analysis/tradingview/grid_reset_config.js +35 -6
  70. package/dist/analysis/tradingview/grid_reset_sim.d.ts +75 -8
  71. package/dist/analysis/tradingview/grid_reset_sim.js +42 -5
  72. package/dist/analysis/tradingview/tradingview_uplot_chart_generator.d.ts +69 -4
  73. package/dist/analysis/tradingview/tradingview_uplot_chart_generator.js +20 -20
  74. package/dist/analysis/trend_detection/backtest_ama_slope_huber.d.ts +102 -0
  75. package/dist/analysis/trend_detection/backtest_ama_slope_huber.js +725 -0
  76. package/dist/analysis/trend_detection/dynamic_weight_chart_generator.d.ts +63 -1
  77. package/dist/analysis/trend_detection/dynamic_weight_chart_generator.js +27 -112
  78. package/dist/analysis/trend_detection/huber_scale_variants.d.ts +40 -0
  79. package/dist/analysis/trend_detection/huber_scale_variants.js +176 -0
  80. package/dist/analysis/trend_detection/kalman_chart_generator.d.ts +30 -1
  81. package/dist/analysis/trend_detection/kalman_chart_generator.js +3 -3
  82. package/dist/analysis/trend_detection/regime_chart_generator.d.ts +31 -1
  83. package/dist/analysis/trend_detection/regime_chart_generator.js +2 -2
  84. package/dist/analysis/trend_detection/volatility_chart_generator.d.ts +33 -1
  85. package/dist/credential-daemon.js +34 -20
  86. package/dist/dexbot.js +17 -14
  87. package/dist/market_adapter/candle_utils.d.ts +22 -18
  88. package/dist/market_adapter/candle_utils.js +24 -20
  89. package/dist/market_adapter/core/asymmetric_bounds.d.ts +13 -4
  90. package/dist/market_adapter/core/config_normalizers.d.ts +3 -3
  91. package/dist/market_adapter/core/kibana_candles.d.ts +53 -18
  92. package/dist/market_adapter/core/kibana_candles.js +9 -7
  93. package/dist/market_adapter/core/kibana_client.d.ts +9 -1
  94. package/dist/market_adapter/core/kibana_client.js +8 -7
  95. package/dist/market_adapter/core/kibana_market_candles.d.ts +3 -2
  96. package/dist/market_adapter/core/market_adapter_service.d.ts +297 -115
  97. package/dist/market_adapter/core/market_adapter_service.js +184 -101
  98. package/dist/market_adapter/core/strategies/ama.d.ts +10 -2
  99. package/dist/market_adapter/core/strategies/ama.js +7 -32
  100. package/dist/market_adapter/core/strategies/ama_slope_model.d.ts +14 -1
  101. package/dist/market_adapter/core/strategies/ama_slope_model.js +12 -34
  102. package/dist/market_adapter/core/strategies/atr/calculator.d.ts +7 -2
  103. package/dist/market_adapter/core/strategies/atr/calculator.js +2 -34
  104. package/dist/market_adapter/core/strategies/collateral_manager.d.ts +7 -1
  105. package/dist/market_adapter/core/strategies/collateral_manager.js +0 -22
  106. package/dist/market_adapter/core/strategies/dynamic_weight_series.d.ts +36 -8
  107. package/dist/market_adapter/core/strategies/dynamic_weight_series.js +9 -9
  108. package/dist/market_adapter/core/strategies/regime_gate.d.ts +24 -15
  109. package/dist/market_adapter/core/strategies/regime_gate.js +4 -31
  110. package/dist/market_adapter/core/strategies/regime_interp.d.ts +7 -1
  111. package/dist/market_adapter/core/strategies/regime_interp.js +14 -22
  112. package/dist/market_adapter/core/strategies/volatility_shift.d.ts +11 -1
  113. package/dist/market_adapter/core/strategies/volatility_shift.js +0 -13
  114. package/dist/market_adapter/inputs/cex_candle_parsing.d.ts +29 -0
  115. package/dist/market_adapter/inputs/cex_candle_parsing.js +52 -0
  116. package/dist/market_adapter/inputs/fetch_book_data.d.ts +20 -4
  117. package/dist/market_adapter/inputs/fetch_book_data.js +3 -1
  118. package/dist/market_adapter/inputs/fetch_cex_synthetic_data.js +97 -226
  119. package/dist/market_adapter/inputs/fetch_lp_data.d.ts +42 -7
  120. package/dist/market_adapter/inputs/fetch_lp_data.js +22 -15
  121. package/dist/market_adapter/inputs/kibana_feed_source.d.ts +74 -15
  122. package/dist/market_adapter/inputs/kibana_feed_source.js +29 -22
  123. package/dist/market_adapter/inputs/kibana_source.d.ts +25 -3
  124. package/dist/market_adapter/inputs/kibana_source.js +2 -2
  125. package/dist/market_adapter/inputs/window_cache.d.ts +99 -94
  126. package/dist/market_adapter/inputs/window_cache.js +8 -8
  127. package/dist/market_adapter/interval_utils.d.ts +4 -4
  128. package/dist/market_adapter/log_format.d.ts +6 -6
  129. package/dist/market_adapter/log_format.js +28 -22
  130. package/dist/market_adapter/lp_chart_core.d.ts +22 -1
  131. package/dist/market_adapter/lp_chart_core.js +26 -192
  132. package/dist/market_adapter/lp_chart_runner.d.ts +7 -7
  133. package/dist/market_adapter/lp_chart_strategy_loader.d.ts +41 -6
  134. package/dist/market_adapter/lp_chart_strategy_loader.js +8 -7
  135. package/dist/market_adapter/market_adapter.d.ts +94 -33
  136. package/dist/market_adapter/market_adapter.js +69 -75
  137. package/dist/market_adapter/utils/adapter_client.d.ts +3 -3
  138. package/dist/market_adapter/utils/adapter_client.js +2 -2
  139. package/dist/market_adapter/utils/atomic_write.d.ts +8 -1
  140. package/dist/market_adapter/utils/chain.d.ts +50 -41
  141. package/dist/market_adapter/utils/chain.js +40 -46
  142. package/dist/market_adapter/utils/data_discovery.d.ts +4 -1
  143. package/dist/market_adapter/utils/dynamic_grid_snapshot.d.ts +12 -3
  144. package/dist/market_adapter/utils/file_json_cache.d.ts +2 -2
  145. package/dist/market_adapter/utils/file_lock.d.ts +28 -14
  146. package/dist/market_adapter/utils/file_lock.js +36 -32
  147. package/dist/market_adapter/utils/native_history.d.ts +9 -2
  148. package/dist/market_adapter/utils/native_history.js +35 -28
  149. package/dist/modules/account_bots.d.ts +577 -21
  150. package/dist/modules/account_bots.js +182 -158
  151. package/dist/modules/account_orders.d.ts +66 -30
  152. package/dist/modules/account_orders.js +22 -20
  153. package/dist/modules/authority_resolver.d.ts +12 -2
  154. package/dist/modules/authority_resolver.js +15 -8
  155. package/dist/modules/bitshares-native/chain_client.d.ts +38 -3
  156. package/dist/modules/bitshares-native/chain_client.js +45 -46
  157. package/dist/modules/bitshares-native/crypto/ecc.browser.js +11 -171
  158. package/dist/modules/bitshares-native/crypto/ecc.js +13 -176
  159. package/dist/modules/bitshares-native/crypto/ecc_core.d.ts +33 -0
  160. package/dist/modules/bitshares-native/crypto/ecc_core.js +213 -0
  161. package/dist/modules/bitshares-native/crypto/ecc_selector.d.ts +2 -1
  162. package/dist/modules/bitshares-native/crypto/ecc_selector.js +1 -13
  163. package/dist/modules/bitshares-native/index.d.ts +1 -1
  164. package/dist/modules/bitshares-native/lru_cache.d.ts +7 -7
  165. package/dist/modules/bitshares-native/resolvers.d.ts +18 -6
  166. package/dist/modules/bitshares-native/serial/lazy_buffer.d.ts +4 -0
  167. package/dist/modules/bitshares-native/serial/lazy_buffer.js +21 -0
  168. package/dist/modules/bitshares-native/serial/operations.d.ts +1 -1
  169. package/dist/modules/bitshares-native/serial/serializer.d.ts +16 -12
  170. package/dist/modules/bitshares-native/serial/serializer.js +7 -13
  171. package/dist/modules/bitshares-native/serial/types.d.ts +25 -16
  172. package/dist/modules/bitshares-native/serial/types.js +55 -62
  173. package/dist/modules/bitshares-native/signing_client.d.ts +32 -2
  174. package/dist/modules/bitshares-native/signing_client.js +19 -14
  175. package/dist/modules/bitshares-native/subscriptions.d.ts +81 -1
  176. package/dist/modules/bitshares-native/subscriptions.js +12 -12
  177. package/dist/modules/bitshares-native/transport.d.ts +5 -4
  178. package/dist/modules/bitshares-native/transport.js +5 -4
  179. package/dist/modules/bitshares-native/tx/builder.d.ts +40 -5
  180. package/dist/modules/bitshares-native/tx/builder.js +4 -3
  181. package/dist/modules/bitshares-native/tx/tx_cache.d.ts +4 -4
  182. package/dist/modules/bitshares_client.d.ts +45 -13
  183. package/dist/modules/bitshares_client.js +28 -19
  184. package/dist/modules/bot_defaults.d.ts +6 -15
  185. package/dist/modules/bot_defaults.js +1 -5
  186. package/dist/modules/bot_settings.d.ts +44 -10
  187. package/dist/modules/bot_settings.js +11 -8
  188. package/dist/modules/bots_file_lock.d.ts +6 -6
  189. package/dist/modules/bots_file_lock.js +16 -12
  190. package/dist/modules/broadcast_failure.d.ts +2 -2
  191. package/dist/modules/broadcast_failure.js +5 -4
  192. package/dist/modules/chain_keys.d.ts +42 -40
  193. package/dist/modules/chain_keys.js +53 -45
  194. package/dist/modules/chain_orders.d.ts +93 -59
  195. package/dist/modules/chain_orders.js +31 -23
  196. package/dist/modules/constants.d.ts +530 -32
  197. package/dist/modules/constants.js +52 -60
  198. package/dist/modules/cr_planner.d.ts +40 -2
  199. package/dist/modules/credential_policy.d.ts +68 -8
  200. package/dist/modules/credential_policy.js +37 -31
  201. package/dist/modules/credential_session_cache.d.ts +2 -2
  202. package/dist/modules/credit_pricing.d.ts +42 -6
  203. package/dist/modules/credit_pricing.js +44 -30
  204. package/dist/modules/credit_runtime.d.ts +276 -118
  205. package/dist/modules/credit_runtime.js +462 -165
  206. package/dist/modules/crypto/browser_provider.js +6 -4
  207. package/dist/modules/crypto/node_provider.js +1 -1
  208. package/dist/modules/crypto/pure_scrypt.js +35 -4
  209. package/dist/modules/crypto/pure_secp256k1.js +72 -26
  210. package/dist/modules/crypto/sync.d.ts +9 -9
  211. package/dist/modules/crypto/sync.js +16 -9
  212. package/dist/modules/dexbot_class.d.ts +195 -139
  213. package/dist/modules/dexbot_class.js +78 -28
  214. package/dist/modules/dexbot_cow_runtime.d.ts +167 -87
  215. package/dist/modules/dexbot_cow_runtime.js +248 -206
  216. package/dist/modules/dexbot_credential_client.d.ts +19 -11
  217. package/dist/modules/dexbot_fill_runtime.d.ts +63 -48
  218. package/dist/modules/dexbot_fill_runtime.js +48 -41
  219. package/dist/modules/dexbot_maintenance_runtime.d.ts +109 -70
  220. package/dist/modules/dexbot_maintenance_runtime.js +117 -80
  221. package/dist/modules/dexbot_startup_runtime.d.ts +11 -10
  222. package/dist/modules/dexbot_startup_runtime.js +43 -43
  223. package/dist/modules/dexbot_state_recovery.d.ts +13 -12
  224. package/dist/modules/dexbot_state_recovery.js +18 -13
  225. package/dist/modules/fund_registry.d.ts +4 -2
  226. package/dist/modules/fund_registry.js +10 -10
  227. package/dist/modules/general_settings.d.ts +30 -4
  228. package/dist/modules/graceful_shutdown.d.ts +3 -3
  229. package/dist/modules/graceful_shutdown.js +2 -2
  230. package/dist/modules/grid_price_source.d.ts +1 -1
  231. package/dist/modules/key_store.d.ts +14 -8
  232. package/dist/modules/key_store.js +7 -6
  233. package/dist/modules/launcher/adapter_requirement.d.ts +11 -5
  234. package/dist/modules/launcher/adapter_requirement.js +5 -5
  235. package/dist/modules/launcher/bot_supervisor.d.ts +106 -24
  236. package/dist/modules/launcher/bot_supervisor.js +12 -11
  237. package/dist/modules/launcher/credential_bootstrap.d.ts +1 -1
  238. package/dist/modules/launcher/credential_bootstrap.js +1 -1
  239. package/dist/modules/launcher/credential_daemon.d.ts +4 -4
  240. package/dist/modules/launcher/credential_daemon.js +2 -2
  241. package/dist/modules/launcher/credential_secret.d.ts +1 -1
  242. package/dist/modules/launcher/foreign_cred_daemon.d.ts +2 -2
  243. package/dist/modules/launcher/market_adapter_runtime.d.ts +61 -6
  244. package/dist/modules/launcher/market_adapter_watchdog.d.ts +10 -2
  245. package/dist/modules/launcher/market_adapter_watchdog.js +4 -0
  246. package/dist/modules/launcher/monolithic_runtime.d.ts +18 -16
  247. package/dist/modules/launcher/status_reporting.d.ts +22 -14
  248. package/dist/modules/launcher/supervisor_control.d.ts +8 -1
  249. package/dist/modules/launcher/supervisor_control.js +4 -2
  250. package/dist/modules/market_adapter_whitelist.d.ts +9 -3
  251. package/dist/modules/market_adapter_whitelist.js +15 -3
  252. package/dist/modules/node_manager.d.ts +41 -11
  253. package/dist/modules/node_manager.js +5 -4
  254. package/dist/modules/order/accounting.d.ts +53 -24
  255. package/dist/modules/order/accounting.js +40 -14
  256. package/dist/modules/order/async_lock.d.ts +5 -2
  257. package/dist/modules/order/async_lock.js +1 -1
  258. package/dist/modules/order/export.d.ts +7 -6
  259. package/dist/modules/order/export.js +1 -7
  260. package/dist/modules/order/format.d.ts +39 -19
  261. package/dist/modules/order/format.js +62 -16
  262. package/dist/modules/order/genesis_policy.d.ts +21 -18
  263. package/dist/modules/order/genesis_policy.js +12 -8
  264. package/dist/modules/order/grid.d.ts +142 -36
  265. package/dist/modules/order/grid.js +148 -123
  266. package/dist/modules/order/grid_reconcile.d.ts +21 -20
  267. package/dist/modules/order/grid_reconcile.js +13 -12
  268. package/dist/modules/order/grid_reconcile_internal.d.ts +85 -72
  269. package/dist/modules/order/grid_reconcile_internal.js +28 -19
  270. package/dist/modules/order/index.d.ts +263 -1
  271. package/dist/modules/order/logger.d.ts +45 -11
  272. package/dist/modules/order/logger.js +38 -40
  273. package/dist/modules/order/logger_state.d.ts +4 -4
  274. package/dist/modules/order/manager.d.ts +226 -180
  275. package/dist/modules/order/manager.js +101 -83
  276. package/dist/modules/order/processed_fill_store.d.ts +18 -3
  277. package/dist/modules/order/processed_fill_store.js +16 -27
  278. package/dist/modules/order/strategy.d.ts +21 -13
  279. package/dist/modules/order/strategy.js +5 -6
  280. package/dist/modules/order/sync_engine.d.ts +91 -33
  281. package/dist/modules/order/sync_engine.js +99 -54
  282. package/dist/modules/order/utils/math.d.ts +157 -102
  283. package/dist/modules/order/utils/math.js +77 -38
  284. package/dist/modules/order/utils/order.d.ts +326 -106
  285. package/dist/modules/order/utils/order.js +200 -99
  286. package/dist/modules/order/utils/slot.d.ts +1 -1
  287. package/dist/modules/order/utils/system.d.ts +176 -26
  288. package/dist/modules/order/utils/system.js +86 -69
  289. package/dist/modules/order/utils/validate.d.ts +89 -41
  290. package/dist/modules/order/utils/validate.js +24 -22
  291. package/dist/modules/order/utils/withPoolRef.d.ts +4 -3
  292. package/dist/modules/order/utils/withPoolRef.js +18 -12
  293. package/dist/modules/order/working_grid.d.ts +14 -13
  294. package/dist/modules/paths.d.ts +3 -4
  295. package/dist/modules/paths.js +3 -27
  296. package/dist/modules/process_discovery.d.ts +1 -1
  297. package/dist/modules/process_discovery.js +2 -1
  298. package/dist/modules/runtime.d.ts +7 -3
  299. package/dist/modules/runtime.js +4 -3
  300. package/dist/modules/runtime_settings.d.ts +15 -10
  301. package/dist/modules/runtime_settings.js +30 -24
  302. package/dist/modules/settings_merge.d.ts +29 -3
  303. package/dist/modules/settings_merge.js +56 -78
  304. package/dist/modules/socket_json_client.d.ts +7 -4
  305. package/dist/modules/storage/browser_adapter.d.ts +38 -53
  306. package/dist/modules/storage/browser_adapter.js +7 -30
  307. package/dist/modules/storage/index.d.ts +1 -1
  308. package/dist/modules/storage/node_adapter.d.ts +45 -27
  309. package/dist/modules/storage/node_adapter.js +9 -9
  310. package/dist/modules/storage/types.d.ts +5 -4
  311. package/dist/modules/types.d.ts +1071 -2
  312. package/dist/modules/types.js +4 -1
  313. package/dist/modules/utils/asset_symbols.d.ts +2 -1
  314. package/dist/modules/utils/asset_symbols.js +2 -1
  315. package/dist/modules/utils/errors.d.ts +9 -0
  316. package/dist/modules/utils/errors.js +23 -1
  317. package/dist/modules/utils/time_range.d.ts +4 -0
  318. package/dist/modules/utils/time_range.js +18 -0
  319. package/dist/modules/validate_profiles.js +53 -43
  320. package/dist/modules/version_notice.d.ts +14 -3
  321. package/dist/modules/version_notice.js +6 -4
  322. package/dist/pm2.d.ts +29 -27
  323. package/dist/pm2.js +5 -5
  324. package/dist/scripts/analyze-credit.d.ts +2 -1
  325. package/dist/scripts/analyze-credit.js +23 -24
  326. package/dist/scripts/analyze-orders.d.ts +77 -9
  327. package/dist/scripts/analyze-orders.js +66 -84
  328. package/dist/scripts/chart_command.d.ts +27 -18
  329. package/dist/scripts/chart_command.js +16 -15
  330. package/dist/scripts/check_any.d.ts +18 -0
  331. package/dist/scripts/check_any.js +126 -0
  332. package/dist/scripts/diagnose-pool-history.js +12 -7
  333. package/dist/scripts/pnl.d.ts +3 -0
  334. package/dist/scripts/pnl.js +40 -0
  335. package/dist/scripts/print_grid.js +0 -1
  336. package/dist/scripts/run-tests.js +39 -7
  337. package/dist/scripts/runner.js +1 -1
  338. package/dist/scripts/test-credit-renewal.js +30 -21
  339. package/dist/scripts/update.d.ts +10 -5
  340. package/dist/scripts/update.js +168 -103
  341. package/dist/scripts/update_dist_freshness.js +1 -0
  342. package/dist/scripts/update_layout.d.ts +61 -0
  343. package/dist/scripts/update_layout.js +180 -0
  344. package/dist/scripts/validate_bots.js +2 -1
  345. package/dist/scripts/verify-browser-bundle.js +8 -0
  346. package/dist/unlock.d.ts +28 -3
  347. package/dist/unlock.js +72 -10
  348. package/docs/BITSHARES_ONBOARDING.md +2 -0
  349. package/docs/COPY_ON_WRITE_MASTER_PLAN.md +1 -1
  350. package/docs/COW_INVARIANTS.md +13 -6
  351. package/docs/DEXBOT_COMPARISON.md +8 -8
  352. package/docs/EVOLUTION.md +12 -10
  353. package/docs/FUND_MOVEMENT_AND_ACCOUNTING.md +5 -5
  354. package/docs/GRID_RECALCULATION.md +15 -16
  355. package/docs/GRID_RECONCILE.md +14 -3
  356. package/docs/LIFECYCLE.md +11 -11
  357. package/docs/MPA_CREDIT_USAGE.md +22 -3
  358. package/docs/README.md +15 -4
  359. package/docs/WORKFLOW.md +1 -0
  360. package/docs/architecture.md +12 -9
  361. package/docs/developer_guide.md +6 -6
  362. package/market_adapter/README.md +9 -26
  363. package/modules/README.md +4 -1
  364. package/package.json +4 -1
  365. package/scripts/README.md +14 -0
@@ -1,4 +1,12 @@
1
- declare function getAmaWarmupBars(erPeriod: any, slowPeriod: any, lookbackBars: any, fastPeriod: any, erSmoothPeriod?: number): number;
2
- declare function calculateAMA(closes: any, params: any): any[];
1
+ /**
2
+ * Kaufman's Adaptive Moving Average (KAMA/AMA).
3
+ */
4
+ export interface AmaParams {
5
+ erPeriod: number;
6
+ fastPeriod: number;
7
+ slowPeriod: number;
8
+ }
9
+ declare function getAmaWarmupBars(erPeriod: number, slowPeriod: number, lookbackBars: number, fastPeriod: number): number;
10
+ declare function calculateAMA(closes: number[], params: AmaParams): number[];
3
11
  export { calculateAMA, getAmaWarmupBars };
4
12
  //# sourceMappingURL=ama.d.ts.map
@@ -1,13 +1,7 @@
1
1
  'use strict';
2
2
  import { MARKET_ADAPTER } from '../../../modules/constants.js';
3
- /**
4
- * Kaufman's Adaptive Moving Average (KAMA/AMA).
5
- */
6
3
  class AMA {
7
4
  erPeriod;
8
- erSmoothPeriod;
9
- erSmoothAlpha;
10
- erSmoothValue;
11
5
  fastSC;
12
6
  slowSC;
13
7
  prevAMA;
@@ -15,7 +9,7 @@ class AMA {
15
9
  warmedUp;
16
10
  smaSum;
17
11
  smaCount;
18
- constructor(erPeriod, fastPeriod, slowPeriod, erSmoothPeriod) {
12
+ constructor(erPeriod, fastPeriod, slowPeriod) {
19
13
  if (!Number.isFinite(erPeriod) || erPeriod <= 0) {
20
14
  throw new TypeError(`AMA erPeriod must be a positive finite number, got ${erPeriod}`);
21
15
  }
@@ -26,10 +20,6 @@ class AMA {
26
20
  throw new TypeError(`AMA slowPeriod must be a positive finite number, got ${slowPeriod}`);
27
21
  }
28
22
  this.erPeriod = Math.ceil(erPeriod);
29
- const esPeriod = Number(erSmoothPeriod);
30
- this.erSmoothPeriod = Number.isFinite(esPeriod) && esPeriod >= 1 ? esPeriod : 0;
31
- this.erSmoothAlpha = this.erSmoothPeriod > 0 ? 2 / (this.erSmoothPeriod + 1) : 0;
32
- this.erSmoothValue = null;
33
23
  this.fastSC = 2 / (fastPeriod + 1);
34
24
  this.slowSC = 2 / (slowPeriod + 1);
35
25
  this.prevAMA = null;
@@ -65,21 +55,14 @@ class AMA {
65
55
  volatility += Math.abs(this.history[i] - this.history[i - 1]);
66
56
  }
67
57
  const er = volatility === 0 ? 0 : direction / volatility;
68
- const effectiveER = this.erSmoothAlpha > 0
69
- ? (this.erSmoothValue === null
70
- ? er
71
- : this.erSmoothValue + this.erSmoothAlpha * (er - this.erSmoothValue))
72
- : er;
73
- if (this.erSmoothAlpha > 0) {
74
- this.erSmoothValue = effectiveER;
75
- }
76
- const smooth = (effectiveER * (this.fastSC - this.slowSC) + this.slowSC) ** 2;
77
- const ama = this.prevAMA + smooth * (price - this.prevAMA);
58
+ const prevAMA = this.prevAMA;
59
+ const smooth = (er * (this.fastSC - this.slowSC) + this.slowSC) ** 2;
60
+ const ama = prevAMA + smooth * (price - prevAMA);
78
61
  this.prevAMA = ama;
79
62
  return ama;
80
63
  }
81
64
  }
82
- function getAmaWarmupBars(erPeriod, slowPeriod, lookbackBars, fastPeriod, erSmoothPeriod = 0) {
65
+ function getAmaWarmupBars(erPeriod, slowPeriod, lookbackBars, fastPeriod) {
83
66
  if (!Number.isFinite(erPeriod) || erPeriod <= 0) {
84
67
  throw new TypeError(`getAmaWarmupBars erPeriod must be a positive finite number, got ${erPeriod}`);
85
68
  }
@@ -92,23 +75,15 @@ function getAmaWarmupBars(erPeriod, slowPeriod, lookbackBars, fastPeriod, erSmoo
92
75
  if (!Number.isFinite(fastPeriod) || fastPeriod <= 0) {
93
76
  throw new TypeError(`getAmaWarmupBars fastPeriod must be a positive finite number, got ${fastPeriod}`);
94
77
  }
95
- if (!Number.isFinite(erSmoothPeriod) || erSmoothPeriod < 0) {
96
- throw new TypeError(`getAmaWarmupBars erSmoothPeriod must be a non-negative finite number, got ${erSmoothPeriod}`);
97
- }
98
78
  const safeErPeriod = Math.ceil(erPeriod);
99
79
  const safeSlowPeriod = Math.ceil(slowPeriod);
100
80
  const safeLookbackBars = Math.ceil(lookbackBars);
101
- const safeErSmoothPeriod = erSmoothPeriod >= 1 ? erSmoothPeriod : 0;
102
81
  const fastSC = 2 / (fastPeriod + 1);
103
82
  const slowSC = 2 / (safeSlowPeriod + 1);
104
83
  const deltaSC = fastSC - slowSC;
105
84
  const scAvg = (MARKET_ADAPTER.AMA_CONVERGENCE_ER_AVG * deltaSC + slowSC) ** 2;
106
85
  const convergenceBars = Math.ceil(Math.log(MARKET_ADAPTER.AMA_CONVERGENCE_EPSILON) / Math.log(1 - scAvg));
107
- const erSmoothConvergenceBars = safeErSmoothPeriod > 0
108
- ? Math.ceil(Math.log(MARKET_ADAPTER.AMA_CONVERGENCE_EPSILON)
109
- / Math.log(1 - (2 / (safeErSmoothPeriod + 1))))
110
- : 0;
111
- return safeErPeriod + convergenceBars + erSmoothConvergenceBars + safeLookbackBars;
86
+ return safeErPeriod + convergenceBars + safeLookbackBars;
112
87
  }
113
88
  function calculateAMA(closes, params) {
114
89
  if (!params || typeof params !== 'object') {
@@ -126,7 +101,7 @@ function calculateAMA(closes, params) {
126
101
  if (!Array.isArray(closes)) {
127
102
  throw new TypeError('calculateAMA closes must be an array');
128
103
  }
129
- const indicator = new AMA(params.erPeriod, params.fastPeriod, params.slowPeriod, params.erSmoothPeriod);
104
+ const indicator = new AMA(params.erPeriod, params.fastPeriod, params.slowPeriod);
130
105
  return closes.map(price => indicator.update(price));
131
106
  }
132
107
  export { calculateAMA, getAmaWarmupBars };
@@ -21,7 +21,20 @@ import { computeAverageAmaSlopePct, computeHuberWindowSlopePct, computeAmaSlopeC
21
21
  * @param {number} [opts.clipThreshold=Infinity] Pre-computed clip threshold from slope history (percentile clipping is done by the caller)
22
22
  * @returns {{ slopeOffset, rawSlopeOffset, symmetricDelta, slopePct, clippedSlopePct, confidence, trend, isReady }}
23
23
  */
24
- declare function computeAmaSlopeWeights(amaValues: any, weightVariance: any, opts?: any): {
24
+ interface AmaSlopeOpts {
25
+ lookbackBars?: unknown;
26
+ maxSlopePct?: unknown;
27
+ neutralZonePct?: unknown;
28
+ volatilityExponent?: unknown;
29
+ volatilityScaleX?: unknown;
30
+ volatilityThreshold?: unknown;
31
+ erPeriod?: unknown;
32
+ maxSlopeOffset?: unknown;
33
+ maxVolatilityOffset?: unknown;
34
+ clipThreshold?: unknown;
35
+ [key: string]: unknown;
36
+ }
37
+ declare function computeAmaSlopeWeights(amaValues: unknown, weightVariance: number, opts?: AmaSlopeOpts): {
25
38
  slopeOffset: number;
26
39
  rawSlopeOffset: number;
27
40
  symmetricDelta: number;
@@ -9,48 +9,26 @@ import { computeVolatilityShift } from './volatility_shift.js';
9
9
  import { computeAverageAmaSlopePct, computeHuberWindowSlopePct, computeAmaSlopeClipThreshold, createAmaSlopeClipTracker, } from './dynamic_weight_series.js';
10
10
  const _DEFAULT_AMA_KEY = MARKET_ADAPTER.DEFAULT_AMA_KEY;
11
11
  const DEFAULT_ER_PERIOD = MARKET_ADAPTER.AMAS[_DEFAULT_AMA_KEY].erPeriod;
12
- /**
13
- * Compute AMA slope and volatility offsets from the AMA series.
14
- *
15
- * Two independent additive factors:
16
- * slopeOffset (asymmetric): AMA slope magnitude → trend direction
17
- * symmetricDelta (symmetric): ATR/price ratio → noise level
18
- *
19
- * @param {number[]} amaValues Full AMA series (output of calculateAMA)
20
- * @param {number} weightVariance ATR(period) / amaPrice (0 = no volatility)
21
- * @param {Object} [opts] Market-reading tuning — no offset bounds here
22
- * @param {number} [opts.lookbackBars=MARKET_ADAPTER.DYNAMIC_WEIGHT_AMA_LOOKBACK_BARS] Bars to look back for slope
23
- * @param {number} [opts.maxSlopePct=MARKET_ADAPTER.DYNAMIC_WEIGHT_AMA_MAX_SLOPE_PCT] Average per-bar slope % that saturates slopeOffset
24
- * @param {number} [opts.neutralZonePct=MARKET_ADAPTER.DYNAMIC_WEIGHT_AMA_NEUTRAL_ZONE_PCT] Dead-band around zero average slope
25
- * @param {number} [opts.volatilityExponent=1.0] Exponent for ATR-based penalty
26
- * @param {number} [opts.volatilityScaleX=10.0] Scale factor penalty (10.0 = normal start)
27
- * @param {number} [opts.volatilityThreshold=0.1] Minimum |symmetricDelta| before penalty applies
28
- * @param {number} [opts.erPeriod=DEFAULT_ER_PERIOD] AMA warm-up bars to skip in isReady guard
29
- * @param {number} [opts.maxSlopeOffset=MARKET_ADAPTER.DYNAMIC_WEIGHT_ASYMMETRIC_OFFSET_CLAMP] Per-bot cap on buy/sell asymmetry offset
30
- * @param {number} [opts.maxVolatilityOffset=MARKET_ADAPTER.DYNAMIC_WEIGHT_SYMMETRIC_SHIFT_CLAMP] Per-bot cap on volatility shift
31
- * @param {number} [opts.clipThreshold=Infinity] Pre-computed clip threshold from slope history (percentile clipping is done by the caller)
32
- * @returns {{ slopeOffset, rawSlopeOffset, symmetricDelta, slopePct, clippedSlopePct, confidence, trend, isReady }}
33
- */
34
12
  function computeAmaSlopeWeights(amaValues, weightVariance, opts = {}) {
35
- const lookbackBars = Number.isFinite(opts.lookbackBars) && opts.lookbackBars >= 0
36
- ? Math.ceil(opts.lookbackBars)
13
+ const lookbackBars = Number.isFinite(Number(opts.lookbackBars)) && Number(opts.lookbackBars) >= 0
14
+ ? Math.ceil(Number(opts.lookbackBars))
37
15
  : MARKET_ADAPTER.DYNAMIC_WEIGHT_AMA_LOOKBACK_BARS;
38
- const maxSlopePct = opts.maxSlopePct ?? MARKET_ADAPTER.DYNAMIC_WEIGHT_AMA_MAX_SLOPE_PCT;
39
- const neutralZonePct = opts.neutralZonePct ?? MARKET_ADAPTER.DYNAMIC_WEIGHT_AMA_NEUTRAL_ZONE_PCT;
40
- const volatilityExponent = opts.volatilityExponent ?? MARKET_ADAPTER.DYNAMIC_WEIGHT_VOLATILITY_EXPONENT;
41
- const volatilityScaleX = opts.volatilityScaleX ?? MARKET_ADAPTER.DYNAMIC_WEIGHT_VOLATILITY_SCALE_X_DEFAULT;
42
- const volatilityThreshold = normalizeVolatilityThreshold(opts.volatilityThreshold);
43
- const erPeriod = Number.isFinite(opts.erPeriod) && opts.erPeriod > 0
44
- ? Math.ceil(opts.erPeriod)
16
+ const maxSlopePct = Number(opts.maxSlopePct ?? MARKET_ADAPTER.DYNAMIC_WEIGHT_AMA_MAX_SLOPE_PCT);
17
+ const neutralZonePct = Number(opts.neutralZonePct ?? MARKET_ADAPTER.DYNAMIC_WEIGHT_AMA_NEUTRAL_ZONE_PCT);
18
+ const volatilityExponent = Number(opts.volatilityExponent ?? MARKET_ADAPTER.DYNAMIC_WEIGHT_VOLATILITY_EXPONENT);
19
+ const volatilityScaleX = Number(opts.volatilityScaleX ?? MARKET_ADAPTER.DYNAMIC_WEIGHT_VOLATILITY_SCALE_X_DEFAULT);
20
+ const volatilityThreshold = normalizeVolatilityThreshold(Number(opts.volatilityThreshold));
21
+ const erPeriod = Number.isFinite(Number(opts.erPeriod)) && Number(opts.erPeriod) > 0
22
+ ? Math.ceil(Number(opts.erPeriod))
45
23
  : DEFAULT_ER_PERIOD;
46
24
  // Reject negative caps outright (a negative cap would silently invert the
47
25
  // trend-bias sign); fall back to the default like other invalid values.
48
- const rawMaxSlopeOffset = opts.maxSlopeOffset ?? MARKET_ADAPTER.DYNAMIC_WEIGHT_ASYMMETRIC_OFFSET_CLAMP;
26
+ const rawMaxSlopeOffset = Number(opts.maxSlopeOffset ?? MARKET_ADAPTER.DYNAMIC_WEIGHT_ASYMMETRIC_OFFSET_CLAMP);
49
27
  const maxSlopeOffset = Number.isFinite(rawMaxSlopeOffset) && rawMaxSlopeOffset >= 0
50
28
  ? rawMaxSlopeOffset
51
29
  : MARKET_ADAPTER.DYNAMIC_WEIGHT_ASYMMETRIC_OFFSET_CLAMP;
52
- const maxVolatilityOffset = normalizeMaxVolatilityOffset(opts.maxVolatilityOffset);
53
- const clipThreshold = opts.clipThreshold ?? Infinity;
30
+ const maxVolatilityOffset = normalizeMaxVolatilityOffset(Number(opts.maxVolatilityOffset));
31
+ const clipThreshold = Number(opts.clipThreshold ?? Infinity);
54
32
  const hasDirectionalOffset = Number.isFinite(maxSlopeOffset) && maxSlopeOffset > 0;
55
33
  const safeWeightVariance = Number.isFinite(weightVariance) && weightVariance > 0 ? weightVariance : 0;
56
34
  const safeVolatilityExponent = Number.isFinite(volatilityExponent) && volatilityExponent >= 0
@@ -30,7 +30,12 @@
30
30
  * even when the final row is missing/invalid).
31
31
  * @returns {number[]} Per-candle ATR values (0 during warmup / across breaks)
32
32
  */
33
- declare function computeATRSeries(candles: any, period?: number, stats?: any): number[];
33
+ interface AtrStats {
34
+ validRanges?: number;
35
+ atr?: number;
36
+ [key: string]: unknown;
37
+ }
38
+ declare function computeATRSeries(candles: unknown, period?: number, stats?: AtrStats | null): number[];
34
39
  /**
35
40
  * Calculates ATR from candles (High, Low, Close).
36
41
  *
@@ -44,6 +49,6 @@ declare function computeATRSeries(candles: any, period?: number, stats?: any): n
44
49
  * @param {number} period - ATR period
45
50
  * @returns {number} Average True Range value
46
51
  */
47
- declare function calculateATR(candles: any, period?: number): any;
52
+ declare function calculateATR(candles: unknown, period?: number): number;
48
53
  export { calculateATR, computeATRSeries };
49
54
  //# sourceMappingURL=calculator.d.ts.map
@@ -1,37 +1,5 @@
1
1
  'use strict';
2
2
  import { normalizeAtrPeriod } from '../../config_normalizers.js';
3
- /**
4
- * Average True Range (ATR) Service
5
- * Computes market volatility for symmetrical weight shifts.
6
- *
7
- * computeATRSeries is the canonical series implementation — it is shared by the
8
- * live market adapter (via calculateATR), analysis tooling (re-exported through
9
- * analysis/math_utils.ts), and the browser-embedded chart scripts (injected via
10
- * fn.toString()). calculateATR is a thin single-value wrapper that preserves the
11
- * production edge-case guards on top of the same series.
12
- */
13
- /**
14
- * ATR series over candles (High, Low, Close).
15
- *
16
- * Chain-breaking semantics: an invalid row resets the previous-close reference
17
- * and re-arms warmup, so a single bad candle never synthesizes a multi-bar gap
18
- * into the next true range. Positions before `period` valid true ranges within
19
- * the current chain segment resolve to 0 (insufficient data).
20
- *
21
- * Candles may be rows ([timestamp, open, high, low, close, volume]) or objects
22
- * ({ open, high, low, close, ... }); the getter logic is inlined so the function
23
- * stays self-contained and can be injected into generated HTML verbatim.
24
- *
25
- * @param {Array} candles - Array of candle rows or candle objects
26
- * @param {number} period - ATR period
27
- * @param {Object} [stats] - Optional mutable object; when provided, the number of
28
- * valid true ranges computed is written to `stats.validRanges`
29
- * and the final running ATR value to `stats.atr` (useful for
30
- * callers that need to distinguish "no valid data" from "warmup 0"
31
- * without re-scanning the input, or to read the last computed ATR
32
- * even when the final row is missing/invalid).
33
- * @returns {number[]} Per-candle ATR values (0 during warmup / across breaks)
34
- */
35
3
  function computeATRSeries(candles, period = 14, stats = null) {
36
4
  const atrs = [];
37
5
  if (!Array.isArray(candles))
@@ -104,10 +72,10 @@ function calculateATR(candles, period = 14) {
104
72
  if (series.length === 0)
105
73
  return Number.NaN;
106
74
  // No valid true ranges at all (all rows missing/invalid) → NaN, not 0.
107
- if (stats.validRanges === 0)
75
+ if ((stats.validRanges ?? 0) === 0)
108
76
  return Number.NaN;
109
77
  // Fewer valid true ranges than the period → warmup 0.
110
- if (stats.validRanges < safePeriod)
78
+ if ((stats.validRanges ?? 0) < safePeriod)
111
79
  return 0;
112
80
  return Number.isFinite(stats.atr) ? stats.atr : 0;
113
81
  }
@@ -20,7 +20,13 @@
20
20
  * @param {number} maxRatio - Ceiling collateral ratio (e.g. 2.0)
21
21
  * @returns {{ targetRatio: number, action: string, adjustment: number }}
22
22
  */
23
- declare function adjustCollateralRatio(trendData: any, minRatio?: number, maxRatio?: number): {
23
+ interface CollateralTrendData {
24
+ isReady?: unknown;
25
+ confidence?: unknown;
26
+ trend?: unknown;
27
+ [key: string]: unknown;
28
+ }
29
+ declare function adjustCollateralRatio(trendData: CollateralTrendData | null | undefined, minRatio?: number, maxRatio?: number): {
24
30
  targetRatio: number;
25
31
  action: string;
26
32
  adjustment: number;
@@ -5,28 +5,6 @@ import { roundTo, roundToDecimals } from '../../../modules/order/utils/math.js';
5
5
  * reported instead of HOLD — below this the move is considered noise.
6
6
  */
7
7
  const MIN_ACTION_ADJUSTMENT = 0.01;
8
- /**
9
- * Collateral Ratio Recommendation Service
10
- *
11
- * Recommends a target collateral ratio based on trend analysis:
12
- *
13
- * UP trend → lower CR (less defensive — expect price to rise, so collateral
14
- * needs less cushion against margin calls)
15
- * DOWN trend → higher CR (more defensive — expect price to fall, risk increases)
16
- * NEUTRAL → midpoint of allowed range
17
- *
18
- * Confidence scales the adjustment:
19
- * ratio = midpoint + direction × (confidence / 100) × halfRange
20
- *
21
- * The output is recommendation only. Execution is owned by the debt runtime
22
- * and any CR adjustment should trigger a grid rebuild from fresh on-chain state.
23
- */
24
- /**
25
- * @param {Object} trendData - AMA slope model output ({ trend, confidence, isReady })
26
- * @param {number} minRatio - Floor collateral ratio (e.g. 1.5)
27
- * @param {number} maxRatio - Ceiling collateral ratio (e.g. 2.0)
28
- * @returns {{ targetRatio: number, action: string, adjustment: number }}
29
- */
30
8
  function adjustCollateralRatio(trendData, minRatio = 1.5, maxRatio = 2.0) {
31
9
  const min = Number.isFinite(minRatio) && minRatio > 0 ? minRatio : 1.5;
32
10
  const max = Number.isFinite(maxRatio) && maxRatio > min ? maxRatio : min + 0.5;
@@ -1,4 +1,32 @@
1
- declare function computeAverageAmaSlopePct(current: any, past: any, lookbackBars: any): number | null;
1
+ interface HuberParams {
2
+ C: number;
3
+ ITERATIONS: number;
4
+ SCALE_FLOOR: number;
5
+ ZERO_EPSILON: number;
6
+ }
7
+ interface DynamicWeightSeriesInputs {
8
+ amaValues: unknown[] | null | undefined;
9
+ kalmanVelocityPct?: Array<number | null> | null;
10
+ kalmanDisplacementPct?: Array<number | null> | null;
11
+ kalmanIsReady?: Array<boolean | null> | null;
12
+ regimeMultipliers?: Array<number | null> | null;
13
+ lookbackBars: number;
14
+ amaErPeriod: number;
15
+ amaClipThreshold: number;
16
+ kalClipThreshold: number;
17
+ neutralZonePct: number;
18
+ amaMaxSlopePct: number;
19
+ kalmanMaxSlopePct: number;
20
+ offsetClamp: number;
21
+ dispScaleMinPct: number;
22
+ alpha: number;
23
+ dw: number;
24
+ gain: number;
25
+ minOutputThreshold: number;
26
+ signalConfirmBars: number;
27
+ clampFinalOutput?: boolean;
28
+ }
29
+ declare function computeAverageAmaSlopePct(current: number, past: number, lookbackBars: unknown): number | null;
2
30
  /**
3
31
  * Per-bar AMA trend in %/bar over `lookbackBars`, fitted as a Huber-robust
4
32
  * linear regression of ln(AMA) against bar index (uniform weights, no kernel).
@@ -13,7 +41,7 @@ declare function computeAverageAmaSlopePct(current: any, past: any, lookbackBars
13
41
  * continuous and bounded rather than an order statistic.
14
42
  *
15
43
  * The fit is local linear over `lookbackBars` intervals (bars+1 points, the same
16
- * 20h span the endpoint uses), so a window-wide regime change tilts the line
44
+ * 16h span the endpoint uses), so a window-wide regime change tilts the line
17
45
  * continuously instead of waiting for a majority, and a lone off-trend spike is
18
46
  * bounded rather than given full endpoint weight. Output is the log-return per
19
47
  * bar x 100. That differs from the arithmetic per-bar return by ~beta^2/2,
@@ -37,17 +65,17 @@ declare function computeAverageAmaSlopePct(current: any, past: any, lookbackBars
37
65
  *
38
66
  * @param amaValues Full AMA series (index-addressable).
39
67
  * @param index Bar to measure at (evaluated at the window edge).
40
- * @param lookbackBars Window length in bars (fixed at 20 for every estimator).
68
+ * @param lookbackBars Window length in bars (fixed at 16 for every estimator).
41
69
  * @param hub Parameter block; defaults to the centralized constant.
42
70
  * @returns %/bar, or null when the window is unusable.
43
71
  */
44
- declare function computeHuberWindowSlopePct(amaValues: any, index: number, lookbackBars: any, hub?: any): number | null;
45
- declare function echoLatchSeries(appliedSeries: any[], preGainSeries: any[], confirmBars: any): {
72
+ declare function computeHuberWindowSlopePct(amaValues: unknown[] | null | undefined, index: number, lookbackBars: unknown, hub?: Partial<HuberParams>): number | null;
73
+ declare function echoLatchSeries(appliedSeries: number[], preGainSeries: number[] | null | undefined, confirmBars: unknown): {
46
74
  echoedAppliedSeries: any[];
47
75
  echoedPreGainSeries: any[];
48
76
  };
49
- declare function roundToN(value: any, factor: any): number;
50
- declare function computeDynamicWeightSeries(inputs: any): {
77
+ declare function roundToN(value: number, factor: number): number;
78
+ declare function computeDynamicWeightSeries(inputs: DynamicWeightSeriesInputs): {
51
79
  amaOffsets: any[];
52
80
  kalmanOffsets: any[];
53
81
  combinedOffSeries: any[];
@@ -85,7 +113,7 @@ declare function percentileFromSorted(sorted: number[], clipPercentile: number):
85
113
  * @param lookbackBars Bars averaged per slope sample.
86
114
  * @param clipPercentile Percentile to clip at (e.g. 10 → use 90th pct). 0 disables.
87
115
  */
88
- declare function computeAmaSlopeClipThreshold(amaValues: any, erPeriod: number, lookbackBars: number, clipPercentile: number): number;
116
+ declare function computeAmaSlopeClipThreshold(amaValues: unknown[] | null | undefined, erPeriod: number, lookbackBars: number, clipPercentile: number): number;
89
117
  /**
90
118
  * Incremental equivalent of calling {@link computeAmaSlopeClipThreshold} on
91
119
  * every growing prefix of the AMA series. Feed exactly one AMA value per bar
@@ -19,8 +19,8 @@ import { MARKET_ADAPTER } from '../../../modules/constants.js';
19
19
  */
20
20
  const AMA_SLOPE_HUBER = MARKET_ADAPTER.DYNAMIC_WEIGHT_AMA_HUBER;
21
21
  function computeAverageAmaSlopePct(current, past, lookbackBars) {
22
- const safeLookbackBars = Number.isFinite(lookbackBars) && lookbackBars > 0
23
- ? Math.ceil(lookbackBars)
22
+ const safeLookbackBars = Number.isFinite(Number(lookbackBars)) && Number(lookbackBars) > 0
23
+ ? Math.ceil(Number(lookbackBars))
24
24
  : 1;
25
25
  if (!Number.isFinite(current) || !Number.isFinite(past) || past === 0) {
26
26
  return null;
@@ -41,7 +41,7 @@ function computeAverageAmaSlopePct(current, past, lookbackBars) {
41
41
  * continuous and bounded rather than an order statistic.
42
42
  *
43
43
  * The fit is local linear over `lookbackBars` intervals (bars+1 points, the same
44
- * 20h span the endpoint uses), so a window-wide regime change tilts the line
44
+ * 16h span the endpoint uses), so a window-wide regime change tilts the line
45
45
  * continuously instead of waiting for a majority, and a lone off-trend spike is
46
46
  * bounded rather than given full endpoint weight. Output is the log-return per
47
47
  * bar x 100. That differs from the arithmetic per-bar return by ~beta^2/2,
@@ -65,7 +65,7 @@ function computeAverageAmaSlopePct(current, past, lookbackBars) {
65
65
  *
66
66
  * @param amaValues Full AMA series (index-addressable).
67
67
  * @param index Bar to measure at (evaluated at the window edge).
68
- * @param lookbackBars Window length in bars (fixed at 20 for every estimator).
68
+ * @param lookbackBars Window length in bars (fixed at 16 for every estimator).
69
69
  * @param hub Parameter block; defaults to the centralized constant.
70
70
  * @returns %/bar, or null when the window is unusable.
71
71
  */
@@ -90,10 +90,10 @@ function computeHuberWindowSlopePct(amaValues, index, lookbackBars, hub = AMA_SL
90
90
  // Fill any missing field from the canonical constant. Production never passes
91
91
  // `hub` (the default is the constant), so this only guards a partial override
92
92
  // from silently skipping the IRLS loop or injecting NaN weights.
93
- const hubC = Number.isFinite(hub?.C) ? hub.C : AMA_SLOPE_HUBER.C;
94
- const hubIterations = Number.isFinite(hub?.ITERATIONS) ? hub.ITERATIONS : AMA_SLOPE_HUBER.ITERATIONS;
95
- const hubScaleFloor = Number.isFinite(hub?.SCALE_FLOOR) ? hub.SCALE_FLOOR : AMA_SLOPE_HUBER.SCALE_FLOOR;
96
- const hubZeroEpsilon = Number.isFinite(hub?.ZERO_EPSILON) ? hub.ZERO_EPSILON : AMA_SLOPE_HUBER.ZERO_EPSILON;
93
+ const hubC = Number.isFinite(hub?.C) ? hub?.C : AMA_SLOPE_HUBER.C;
94
+ const hubIterations = Number.isFinite(hub?.ITERATIONS) ? hub?.ITERATIONS : AMA_SLOPE_HUBER.ITERATIONS;
95
+ const hubScaleFloor = Number.isFinite(hub?.SCALE_FLOOR) ? hub?.SCALE_FLOOR : AMA_SLOPE_HUBER.SCALE_FLOOR;
96
+ const hubZeroEpsilon = Number.isFinite(hub?.ZERO_EPSILON) ? hub?.ZERO_EPSILON : AMA_SLOPE_HUBER.ZERO_EPSILON;
97
97
  // Weighted least squares of y on the CENTERED index x_i = i - (n-1)/2. The
98
98
  // x-centering keeps the normal equations well-conditioned, but the FULL
99
99
  // two-variable solution is required: with non-uniform Huber weights the
@@ -146,7 +146,7 @@ function echoLatchSeries(appliedSeries, preGainSeries, confirmBars) {
146
146
  const n = Array.isArray(appliedSeries) ? appliedSeries.length : 0;
147
147
  const echoedAppliedSeries = new Array(n).fill(0);
148
148
  const echoedPreGainSeries = new Array(n).fill(0);
149
- const safeConfirmBars = Math.max(0, Math.min(5, Math.round(confirmBars)));
149
+ const safeConfirmBars = Math.max(0, Math.min(5, Math.round(Number(confirmBars))));
150
150
  if (safeConfirmBars === 0) {
151
151
  for (let i = 0; i < n; i++) {
152
152
  echoedAppliedSeries[i] = appliedSeries[i];
@@ -10,7 +10,11 @@
10
10
  * _locateResume). An analyzer that does not report a usable size fails closed
11
11
  * (MAX_SAFE_INTEGER), which disables resuming for that cache entry.
12
12
  */
13
- declare function _analyzerBufferSize(hurst: any, pe: any): number;
13
+ declare function _analyzerBufferSize(hurst: {
14
+ bufferBars?: unknown;
15
+ } | null | undefined, pe: {
16
+ bufferBars?: unknown;
17
+ } | null | undefined): number;
14
18
  /**
15
19
  * Locate how `closes` advances the cached window, or null when they are not
16
20
  * related that way.
@@ -79,22 +83,27 @@ declare function _resetRegimeCache(): void;
79
83
  * hurstRegime: string|null, peRegime: string|null, isReady: boolean,
80
84
  * series: number[] }}
81
85
  */
82
- declare function computeRegimeMultiplier(closes: any, opts?: any): {
86
+ interface RegimeOpts {
87
+ regimeSensitivity?: number;
88
+ regimeTable?: unknown;
89
+ hurstZoneBand?: number;
90
+ peNodes?: unknown;
91
+ cacheKey?: string;
92
+ hurstConfig?: {
93
+ window?: number;
94
+ scales?: number[];
95
+ };
96
+ peConfig?: Record<string, number>;
97
+ }
98
+ export interface RegimeMultiplierResult {
83
99
  multiplier: number;
84
- hurst: null;
85
- pe: null;
86
- hurstRegime: null;
87
- peRegime: null;
88
- isReady: boolean;
89
- series: never[];
90
- } | {
91
- multiplier: number;
92
- hurst: any;
93
- pe: number;
94
- hurstRegime: string;
95
- peRegime: string;
100
+ hurst: number | null;
101
+ pe: number | null;
102
+ hurstRegime: string | null;
103
+ peRegime: string | null;
96
104
  isReady: boolean;
97
105
  series: number[];
98
- };
106
+ }
107
+ declare function computeRegimeMultiplier(closes: unknown, opts?: RegimeOpts): RegimeMultiplierResult;
99
108
  export { computeRegimeMultiplier, _resetRegimeCache, _locateResume, _analyzerBufferSize };
100
109
  //# sourceMappingURL=regime_gate.d.ts.map
@@ -183,34 +183,6 @@ function classifyPeRegime(pe, peNodes = null) {
183
183
  return 'NOISE';
184
184
  return 'MIXED';
185
185
  }
186
- /**
187
- * Compute the Hurst+PE regime multiplier from a price series.
188
- *
189
- * Bilinear interpolation over the 3×3 regime table is delegated to the
190
- * canonical pure implementation in strategies/regime_interp.ts (shared with the
191
- * browser-embedded chart scripts).
192
- *
193
- * Feeds prices through HurstAnalyzer and PermutationEntropyAnalyzer,
194
- * then bilinear-interpolates the regime table to produce a multiplier that
195
- * gates the AMA slope offset in production weight computation. When
196
- * `opts.cacheKey` is set, a window that ADVANCES the memoized one (k leading
197
- * bars dropped, m appended) resumes from the cached analyzer state and feeds
198
- * only the appended bars; anything else recomputes from scratch. See the cache
199
- * notes above.
200
- *
201
- * @param {number[]} closes - Full close price series (same array used for AMA)
202
- * @param {Object} [opts]
203
- * @param {number} [opts.regimeSensitivity=1.0] - Exponent on the base multiplier (0=off, 1=default)
204
- * @param {Array} [opts.regimeTable] - Custom 3x3 regime multiplier table
205
- * @param {number} [opts.hurstZoneBand] - Override Hurst neutral-zone width
206
- * @param {Array} [opts.peNodes] - Override entropy thresholds
207
- * @param {string} [opts.cacheKey] - Stable per-market key enabling cross-cycle reuse
208
- * @param {Object} [opts.hurstConfig] - Override for HurstAnalyzer config
209
- * @param {Object} [opts.peConfig] - Override for PermutationEntropyAnalyzer config
210
- * @returns {{ multiplier: number, hurst: number|null, pe: number|null,
211
- * hurstRegime: string|null, peRegime: string|null, isReady: boolean,
212
- * series: number[] }}
213
- */
214
186
  function computeRegimeMultiplier(closes, opts = {}) {
215
187
  const sensitivity = Number.isFinite(opts.regimeSensitivity) ? opts.regimeSensitivity : 1.0;
216
188
  const regimeTable = opts.regimeTable ?? MARKET_ADAPTER.REGIME_TABLE;
@@ -245,8 +217,9 @@ function computeRegimeMultiplier(closes, opts = {}) {
245
217
  ? _locateResume(cached.closes, closes, _analyzerBufferSize(cached.hurst, cached.pe))
246
218
  : null;
247
219
  const resumable = !!resume;
248
- const hurst = resumable ? cached.hurst : new HurstAnalyzer(hurstCfg);
249
- const pe = resumable ? cached.pe : new PermutationEntropyAnalyzer(peCfg);
220
+ const cachedEntry = cached;
221
+ const hurst = resumable ? cachedEntry.hurst : new HurstAnalyzer(hurstCfg);
222
+ const pe = resumable ? cachedEntry.pe : new PermutationEntropyAnalyzer(peCfg);
250
223
  // Index-aligned with `closes`, exactly like the pre-cache implementation.
251
224
  // The neutral 1.0 fill also covers bars the loop below does not produce a
252
225
  // value for (warmup, or a non-finite price it skips): a resumed run must
@@ -256,7 +229,7 @@ function computeRegimeMultiplier(closes, opts = {}) {
256
229
  const startIndex = resumable ? resume.shared : 0;
257
230
  if (resumable) {
258
231
  for (let i = 0; i < startIndex; i++) {
259
- const carried = cached.series[i + resume.k];
232
+ const carried = cachedEntry.series[i + resume.k];
260
233
  if (carried !== undefined)
261
234
  series[i] = carried;
262
235
  }
@@ -8,6 +8,12 @@
8
8
  * Node-side defaults below mirror MARKET_ADAPTER.REGIME_TABLE /
9
9
  * HURST_ZONE_BAND / PE_NODES; callers may pass explicit hNodes/pNodes/table.
10
10
  */
11
- declare function bilinearInterpolate(h: any, pe: any, regimeTable?: any, opts?: any): number;
11
+ interface RegimeInterpOpts {
12
+ hurstZoneBand?: unknown;
13
+ hNodes?: unknown;
14
+ peNodes?: unknown;
15
+ [key: string]: unknown;
16
+ }
17
+ declare function bilinearInterpolate(h: unknown, pe: unknown, regimeTable?: unknown, opts?: RegimeInterpOpts): number;
12
18
  export { bilinearInterpolate };
13
19
  //# sourceMappingURL=regime_interp.d.ts.map
@@ -1,21 +1,13 @@
1
1
  'use strict';
2
- /**
3
- * Regime bilinear interpolation — canonical implementation shared by the live
4
- * regime gate (regime_gate.ts) and the browser-embedded dynamic-weight chart
5
- * script (injected via fn.toString()).
6
- *
7
- * Self-contained on purpose so the chart generator can inject this exact source
8
- * into generated HTML — do not add imports referenced from the function body.
9
- * Node-side defaults below mirror MARKET_ADAPTER.REGIME_TABLE /
10
- * HURST_ZONE_BAND / PE_NODES; callers may pass explicit hNodes/pNodes/table.
11
- */
12
2
  function bilinearInterpolate(h, pe, regimeTable = null, opts = {}) {
13
- const table = regimeTable ?? [
3
+ const hv = Number(h);
4
+ const pev = Number(pe);
5
+ const table = (Array.isArray(regimeTable) ? regimeTable : null) ?? [
14
6
  [1.0, 0.7, 0.3],
15
7
  [0.6, 0.4, 0.15],
16
8
  [0.3, 0.2, 0.05],
17
9
  ];
18
- const band = Number.isFinite(opts.hurstZoneBand) ? opts.hurstZoneBand : 0.05;
10
+ const band = Number.isFinite(Number(opts.hurstZoneBand)) ? Number(opts.hurstZoneBand) : 0.05;
19
11
  const H_NODES = (Array.isArray(opts.hNodes) && opts.hNodes.length === 3 && opts.hNodes.every(Number.isFinite))
20
12
  ? opts.hNodes
21
13
  : [0.5 + band, 0.5, 0.5 - band];
@@ -25,40 +17,40 @@ function bilinearInterpolate(h, pe, regimeTable = null, opts = {}) {
25
17
  // --- Hurst axis (H_NODES decreasing) ---
26
18
  // Find which interval h falls in: row r0, r1 = r0+1, fraction tRow toward r1
27
19
  let r0, tRow;
28
- if (h >= H_NODES[0]) {
20
+ if (hv >= H_NODES[0]) {
29
21
  r0 = 0;
30
22
  tRow = 0; // at or above top node
31
23
  }
32
- else if (h <= H_NODES[2]) {
24
+ else if (hv <= H_NODES[2]) {
33
25
  r0 = 1;
34
26
  tRow = 1; // at or below bottom node
35
27
  }
36
- else if (h >= H_NODES[1]) {
28
+ else if (hv >= H_NODES[1]) {
37
29
  r0 = 0;
38
- tRow = (H_NODES[0] - h) / (H_NODES[0] - H_NODES[1]); // between nodes 0 and 1
30
+ tRow = (H_NODES[0] - hv) / (H_NODES[0] - H_NODES[1]); // between nodes 0 and 1
39
31
  }
40
32
  else {
41
33
  r0 = 1;
42
- tRow = (H_NODES[1] - h) / (H_NODES[1] - H_NODES[2]); // between nodes 1 and 2
34
+ tRow = (H_NODES[1] - hv) / (H_NODES[1] - H_NODES[2]); // between nodes 1 and 2
43
35
  }
44
36
  const r1 = Math.min(2, r0 + 1);
45
37
  // --- PE axis (PE_NODES increasing) ---
46
38
  let c0, tCol;
47
- if (pe <= PE_NODES[0]) {
39
+ if (pev <= PE_NODES[0]) {
48
40
  c0 = 0;
49
41
  tCol = 0;
50
42
  }
51
- else if (pe >= PE_NODES[2]) {
43
+ else if (pev >= PE_NODES[2]) {
52
44
  c0 = 1;
53
45
  tCol = 1;
54
46
  }
55
- else if (pe <= PE_NODES[1]) {
47
+ else if (pev <= PE_NODES[1]) {
56
48
  c0 = 0;
57
- tCol = (pe - PE_NODES[0]) / (PE_NODES[1] - PE_NODES[0]);
49
+ tCol = (pev - PE_NODES[0]) / (PE_NODES[1] - PE_NODES[0]);
58
50
  }
59
51
  else {
60
52
  c0 = 1;
61
- tCol = (pe - PE_NODES[1]) / (PE_NODES[2] - PE_NODES[1]);
53
+ tCol = (pev - PE_NODES[1]) / (PE_NODES[2] - PE_NODES[1]);
62
54
  }
63
55
  const c1 = Math.min(2, c0 + 1);
64
56
  // --- Bilinear blend ---