dexbot 1.6.11 → 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 (354) hide show
  1. package/CHANGELOG.md +35 -4
  2. package/README.md +2 -1
  3. package/analysis/README.md +2 -0
  4. package/analysis/tradingview/README.md +1 -1
  5. package/analysis/trend_detection/DYNAMIC_WEIGHT_RESEARCH.md +3 -3
  6. package/claw/docs/DEXBOT2_TUNING_CHEAT_SHEET.md +4 -3
  7. package/claw/modules/chain_broadcast.ts +7 -1
  8. package/claw/modules/claw_launcher.ts +1 -1
  9. package/claw/modules/launcher_mode_detector.ts +9 -2
  10. package/claw/package.json +1 -1
  11. package/claw/runtimes/openclaw-plugin/openclaw.plugin.json +1 -1
  12. package/claw/runtimes/openclaw-plugin/package.json +1 -1
  13. package/dist/analysis/account_resolver.d.ts +1 -1
  14. package/dist/analysis/account_resolver.js +2 -1
  15. package/dist/analysis/ama_fitting/analyze_ama_price_changes.js +3 -4
  16. package/dist/analysis/ama_fitting/analyze_lambda_vs_slow.js +2 -7
  17. package/dist/analysis/ama_fitting/calibrate_convergence_er.js +0 -1
  18. package/dist/analysis/ama_fitting/fetch_lp_candles.js +4 -4
  19. package/dist/analysis/ama_fitting/generate_unified_comparison_chart.d.ts +20 -4
  20. package/dist/analysis/ama_fitting/generate_unified_comparison_chart.js +9 -6
  21. package/dist/analysis/ama_fitting/optimizer_high_resolution.js +16 -12
  22. package/dist/analysis/analyze_args.d.ts +31 -0
  23. package/dist/analysis/analyze_args.js +41 -0
  24. package/dist/analysis/analyze_dynamic_weight.js +7 -17
  25. package/dist/analysis/analyze_kalman.js +7 -17
  26. package/dist/analysis/analyze_regime.js +7 -17
  27. package/dist/analysis/analyze_regime_windows.js +8 -18
  28. package/dist/analysis/analyze_risk_profile.js +8 -18
  29. package/dist/analysis/analyze_trade_heatmap.js +7 -17
  30. package/dist/analysis/analyze_volatility.js +7 -17
  31. package/dist/analysis/bot_fitting/backtest_ama_sweep.d.ts +220 -12
  32. package/dist/analysis/bot_fitting/backtest_ama_sweep.js +6 -5
  33. package/dist/analysis/bot_fitting/backtest_bot_fitting.d.ts +34 -4
  34. package/dist/analysis/bot_fitting/backtest_bot_fitting.js +11 -63
  35. package/dist/analysis/bot_fitting/shared_utils.d.ts +7 -7
  36. package/dist/analysis/bot_fitting/shared_utils.js +2 -2
  37. package/dist/analysis/bot_key_utils.d.ts +18 -10
  38. package/dist/analysis/bot_key_utils.js +7 -4
  39. package/dist/analysis/bot_usage/discover_bot_accounts.js +44 -47
  40. package/dist/analysis/bot_usage/kibana_bot_queries.d.ts +1 -21
  41. package/dist/analysis/chain_pool.d.ts +3 -1
  42. package/dist/analysis/chart_ui.d.ts +5 -2
  43. package/dist/analysis/chart_ui.js +6 -3
  44. package/dist/analysis/chart_utils.d.ts +5 -5
  45. package/dist/analysis/chart_utils.js +9 -0
  46. package/dist/analysis/fills_cache.d.ts +1 -1
  47. package/dist/analysis/fills_source.d.ts +2 -2
  48. package/dist/analysis/fills_source.js +14 -12
  49. package/dist/analysis/grid_correction_check.d.ts +1 -1
  50. package/dist/analysis/grid_correction_check.js +12 -11
  51. package/dist/analysis/math_utils.d.ts +7 -6
  52. package/dist/analysis/math_utils.js +5 -8
  53. package/dist/analysis/pnl_report.js +29 -29
  54. package/dist/analysis/price_sources.d.ts +8 -8
  55. package/dist/analysis/price_sources.js +5 -4
  56. package/dist/analysis/resolve_bot_accounts.js +2 -2
  57. package/dist/analysis/resolve_source.d.ts +1 -1
  58. package/dist/analysis/trade_profitability.d.ts +23 -2
  59. package/dist/analysis/trade_profitability.js +50 -50
  60. package/dist/analysis/tradingview/analyze_tradingview.d.ts +17 -6
  61. package/dist/analysis/tradingview/analyze_tradingview.js +6 -5
  62. package/dist/analysis/tradingview/grid_reset_config.d.ts +41 -32
  63. package/dist/analysis/tradingview/grid_reset_config.js +23 -11
  64. package/dist/analysis/tradingview/grid_reset_sim.d.ts +75 -9
  65. package/dist/analysis/tradingview/grid_reset_sim.js +4 -3
  66. package/dist/analysis/tradingview/tradingview_uplot_chart_generator.d.ts +69 -4
  67. package/dist/analysis/tradingview/tradingview_uplot_chart_generator.js +18 -19
  68. package/dist/analysis/trend_detection/backtest_ama_slope_huber.d.ts +1 -1
  69. package/dist/analysis/trend_detection/backtest_ama_slope_huber.js +5 -5
  70. package/dist/analysis/trend_detection/dynamic_weight_chart_generator.d.ts +63 -1
  71. package/dist/analysis/trend_detection/dynamic_weight_chart_generator.js +5 -4
  72. package/dist/analysis/trend_detection/huber_scale_variants.d.ts +9 -3
  73. package/dist/analysis/trend_detection/huber_scale_variants.js +4 -4
  74. package/dist/analysis/trend_detection/kalman_chart_generator.d.ts +30 -1
  75. package/dist/analysis/trend_detection/kalman_chart_generator.js +3 -3
  76. package/dist/analysis/trend_detection/regime_chart_generator.d.ts +31 -1
  77. package/dist/analysis/trend_detection/regime_chart_generator.js +2 -2
  78. package/dist/analysis/trend_detection/volatility_chart_generator.d.ts +33 -1
  79. package/dist/credential-daemon.js +34 -20
  80. package/dist/dexbot.js +11 -11
  81. package/dist/market_adapter/candle_utils.d.ts +22 -18
  82. package/dist/market_adapter/candle_utils.js +24 -20
  83. package/dist/market_adapter/core/asymmetric_bounds.d.ts +13 -4
  84. package/dist/market_adapter/core/config_normalizers.d.ts +3 -3
  85. package/dist/market_adapter/core/kibana_candles.d.ts +53 -18
  86. package/dist/market_adapter/core/kibana_candles.js +9 -7
  87. package/dist/market_adapter/core/kibana_client.d.ts +9 -1
  88. package/dist/market_adapter/core/kibana_client.js +8 -7
  89. package/dist/market_adapter/core/kibana_market_candles.d.ts +3 -2
  90. package/dist/market_adapter/core/market_adapter_service.d.ts +284 -117
  91. package/dist/market_adapter/core/market_adapter_service.js +137 -113
  92. package/dist/market_adapter/core/strategies/ama.d.ts +10 -2
  93. package/dist/market_adapter/core/strategies/ama.js +2 -4
  94. package/dist/market_adapter/core/strategies/ama_slope_model.d.ts +14 -1
  95. package/dist/market_adapter/core/strategies/ama_slope_model.js +12 -34
  96. package/dist/market_adapter/core/strategies/atr/calculator.d.ts +7 -2
  97. package/dist/market_adapter/core/strategies/atr/calculator.js +2 -34
  98. package/dist/market_adapter/core/strategies/collateral_manager.d.ts +7 -1
  99. package/dist/market_adapter/core/strategies/collateral_manager.js +0 -22
  100. package/dist/market_adapter/core/strategies/dynamic_weight_series.d.ts +34 -6
  101. package/dist/market_adapter/core/strategies/dynamic_weight_series.js +7 -7
  102. package/dist/market_adapter/core/strategies/regime_gate.d.ts +24 -15
  103. package/dist/market_adapter/core/strategies/regime_gate.js +4 -31
  104. package/dist/market_adapter/core/strategies/regime_interp.d.ts +7 -1
  105. package/dist/market_adapter/core/strategies/regime_interp.js +14 -22
  106. package/dist/market_adapter/core/strategies/volatility_shift.d.ts +11 -1
  107. package/dist/market_adapter/core/strategies/volatility_shift.js +0 -13
  108. package/dist/market_adapter/inputs/cex_candle_parsing.d.ts +29 -0
  109. package/dist/market_adapter/inputs/cex_candle_parsing.js +52 -0
  110. package/dist/market_adapter/inputs/fetch_book_data.d.ts +20 -4
  111. package/dist/market_adapter/inputs/fetch_book_data.js +3 -1
  112. package/dist/market_adapter/inputs/fetch_cex_synthetic_data.js +96 -224
  113. package/dist/market_adapter/inputs/fetch_lp_data.d.ts +42 -7
  114. package/dist/market_adapter/inputs/fetch_lp_data.js +22 -15
  115. package/dist/market_adapter/inputs/kibana_feed_source.d.ts +74 -15
  116. package/dist/market_adapter/inputs/kibana_feed_source.js +29 -22
  117. package/dist/market_adapter/inputs/kibana_source.d.ts +25 -3
  118. package/dist/market_adapter/inputs/kibana_source.js +2 -2
  119. package/dist/market_adapter/inputs/window_cache.d.ts +99 -94
  120. package/dist/market_adapter/inputs/window_cache.js +8 -8
  121. package/dist/market_adapter/interval_utils.d.ts +4 -4
  122. package/dist/market_adapter/log_format.d.ts +6 -6
  123. package/dist/market_adapter/log_format.js +28 -21
  124. package/dist/market_adapter/lp_chart_core.d.ts +22 -1
  125. package/dist/market_adapter/lp_chart_core.js +26 -192
  126. package/dist/market_adapter/lp_chart_runner.d.ts +7 -7
  127. package/dist/market_adapter/lp_chart_strategy_loader.d.ts +41 -6
  128. package/dist/market_adapter/lp_chart_strategy_loader.js +8 -7
  129. package/dist/market_adapter/market_adapter.d.ts +94 -32
  130. package/dist/market_adapter/market_adapter.js +67 -48
  131. package/dist/market_adapter/utils/adapter_client.d.ts +3 -3
  132. package/dist/market_adapter/utils/adapter_client.js +2 -2
  133. package/dist/market_adapter/utils/atomic_write.d.ts +8 -1
  134. package/dist/market_adapter/utils/chain.d.ts +50 -41
  135. package/dist/market_adapter/utils/chain.js +40 -46
  136. package/dist/market_adapter/utils/data_discovery.d.ts +4 -1
  137. package/dist/market_adapter/utils/dynamic_grid_snapshot.d.ts +12 -3
  138. package/dist/market_adapter/utils/file_json_cache.d.ts +2 -2
  139. package/dist/market_adapter/utils/file_lock.d.ts +28 -14
  140. package/dist/market_adapter/utils/file_lock.js +36 -32
  141. package/dist/market_adapter/utils/native_history.d.ts +9 -2
  142. package/dist/market_adapter/utils/native_history.js +35 -28
  143. package/dist/modules/account_bots.d.ts +577 -21
  144. package/dist/modules/account_bots.js +182 -158
  145. package/dist/modules/account_orders.d.ts +66 -30
  146. package/dist/modules/account_orders.js +22 -20
  147. package/dist/modules/authority_resolver.d.ts +12 -2
  148. package/dist/modules/authority_resolver.js +15 -8
  149. package/dist/modules/bitshares-native/chain_client.d.ts +38 -3
  150. package/dist/modules/bitshares-native/chain_client.js +45 -46
  151. package/dist/modules/bitshares-native/crypto/ecc.browser.js +11 -171
  152. package/dist/modules/bitshares-native/crypto/ecc.js +13 -176
  153. package/dist/modules/bitshares-native/crypto/ecc_core.d.ts +33 -0
  154. package/dist/modules/bitshares-native/crypto/ecc_core.js +213 -0
  155. package/dist/modules/bitshares-native/crypto/ecc_selector.d.ts +2 -1
  156. package/dist/modules/bitshares-native/crypto/ecc_selector.js +1 -13
  157. package/dist/modules/bitshares-native/index.d.ts +1 -1
  158. package/dist/modules/bitshares-native/lru_cache.d.ts +7 -7
  159. package/dist/modules/bitshares-native/resolvers.d.ts +18 -6
  160. package/dist/modules/bitshares-native/serial/lazy_buffer.d.ts +4 -0
  161. package/dist/modules/bitshares-native/serial/lazy_buffer.js +21 -0
  162. package/dist/modules/bitshares-native/serial/operations.d.ts +1 -1
  163. package/dist/modules/bitshares-native/serial/serializer.d.ts +16 -12
  164. package/dist/modules/bitshares-native/serial/serializer.js +7 -13
  165. package/dist/modules/bitshares-native/serial/types.d.ts +25 -16
  166. package/dist/modules/bitshares-native/serial/types.js +55 -62
  167. package/dist/modules/bitshares-native/signing_client.d.ts +32 -2
  168. package/dist/modules/bitshares-native/signing_client.js +19 -14
  169. package/dist/modules/bitshares-native/subscriptions.d.ts +81 -1
  170. package/dist/modules/bitshares-native/subscriptions.js +12 -12
  171. package/dist/modules/bitshares-native/transport.d.ts +5 -4
  172. package/dist/modules/bitshares-native/transport.js +5 -4
  173. package/dist/modules/bitshares-native/tx/builder.d.ts +40 -5
  174. package/dist/modules/bitshares-native/tx/builder.js +4 -3
  175. package/dist/modules/bitshares-native/tx/tx_cache.d.ts +4 -4
  176. package/dist/modules/bitshares_client.d.ts +45 -13
  177. package/dist/modules/bitshares_client.js +28 -19
  178. package/dist/modules/bot_defaults.d.ts +6 -15
  179. package/dist/modules/bot_defaults.js +1 -5
  180. package/dist/modules/bot_settings.d.ts +44 -10
  181. package/dist/modules/bot_settings.js +11 -8
  182. package/dist/modules/bots_file_lock.d.ts +6 -6
  183. package/dist/modules/bots_file_lock.js +16 -12
  184. package/dist/modules/broadcast_failure.d.ts +2 -2
  185. package/dist/modules/broadcast_failure.js +5 -4
  186. package/dist/modules/chain_keys.d.ts +42 -40
  187. package/dist/modules/chain_keys.js +53 -45
  188. package/dist/modules/chain_orders.d.ts +93 -59
  189. package/dist/modules/chain_orders.js +31 -23
  190. package/dist/modules/constants.d.ts +527 -31
  191. package/dist/modules/constants.js +15 -47
  192. package/dist/modules/cr_planner.d.ts +40 -2
  193. package/dist/modules/credential_policy.d.ts +68 -8
  194. package/dist/modules/credential_policy.js +37 -31
  195. package/dist/modules/credential_session_cache.d.ts +2 -2
  196. package/dist/modules/credit_pricing.d.ts +42 -6
  197. package/dist/modules/credit_pricing.js +44 -30
  198. package/dist/modules/credit_runtime.d.ts +276 -118
  199. package/dist/modules/credit_runtime.js +462 -165
  200. package/dist/modules/crypto/browser_provider.js +6 -4
  201. package/dist/modules/crypto/node_provider.js +1 -1
  202. package/dist/modules/crypto/pure_scrypt.js +35 -4
  203. package/dist/modules/crypto/pure_secp256k1.js +72 -26
  204. package/dist/modules/crypto/sync.d.ts +9 -9
  205. package/dist/modules/crypto/sync.js +16 -9
  206. package/dist/modules/dexbot_class.d.ts +195 -139
  207. package/dist/modules/dexbot_class.js +78 -28
  208. package/dist/modules/dexbot_cow_runtime.d.ts +167 -87
  209. package/dist/modules/dexbot_cow_runtime.js +248 -206
  210. package/dist/modules/dexbot_credential_client.d.ts +19 -11
  211. package/dist/modules/dexbot_fill_runtime.d.ts +63 -48
  212. package/dist/modules/dexbot_fill_runtime.js +48 -41
  213. package/dist/modules/dexbot_maintenance_runtime.d.ts +109 -70
  214. package/dist/modules/dexbot_maintenance_runtime.js +108 -83
  215. package/dist/modules/dexbot_startup_runtime.d.ts +11 -10
  216. package/dist/modules/dexbot_startup_runtime.js +43 -43
  217. package/dist/modules/dexbot_state_recovery.d.ts +13 -12
  218. package/dist/modules/dexbot_state_recovery.js +18 -13
  219. package/dist/modules/fund_registry.d.ts +4 -2
  220. package/dist/modules/fund_registry.js +10 -10
  221. package/dist/modules/general_settings.d.ts +30 -4
  222. package/dist/modules/graceful_shutdown.d.ts +3 -3
  223. package/dist/modules/graceful_shutdown.js +2 -2
  224. package/dist/modules/grid_price_source.d.ts +1 -1
  225. package/dist/modules/key_store.d.ts +14 -8
  226. package/dist/modules/key_store.js +7 -6
  227. package/dist/modules/launcher/adapter_requirement.d.ts +11 -5
  228. package/dist/modules/launcher/adapter_requirement.js +5 -5
  229. package/dist/modules/launcher/bot_supervisor.d.ts +106 -24
  230. package/dist/modules/launcher/bot_supervisor.js +12 -11
  231. package/dist/modules/launcher/credential_bootstrap.d.ts +1 -1
  232. package/dist/modules/launcher/credential_bootstrap.js +1 -1
  233. package/dist/modules/launcher/credential_daemon.d.ts +4 -4
  234. package/dist/modules/launcher/credential_daemon.js +2 -2
  235. package/dist/modules/launcher/credential_secret.d.ts +1 -1
  236. package/dist/modules/launcher/foreign_cred_daemon.d.ts +2 -2
  237. package/dist/modules/launcher/market_adapter_runtime.d.ts +61 -6
  238. package/dist/modules/launcher/market_adapter_watchdog.d.ts +10 -2
  239. package/dist/modules/launcher/market_adapter_watchdog.js +4 -0
  240. package/dist/modules/launcher/monolithic_runtime.d.ts +18 -16
  241. package/dist/modules/launcher/status_reporting.d.ts +22 -14
  242. package/dist/modules/launcher/supervisor_control.d.ts +8 -1
  243. package/dist/modules/launcher/supervisor_control.js +4 -2
  244. package/dist/modules/market_adapter_whitelist.d.ts +9 -3
  245. package/dist/modules/market_adapter_whitelist.js +15 -3
  246. package/dist/modules/node_manager.d.ts +41 -11
  247. package/dist/modules/node_manager.js +5 -4
  248. package/dist/modules/order/accounting.d.ts +53 -24
  249. package/dist/modules/order/accounting.js +16 -15
  250. package/dist/modules/order/async_lock.d.ts +5 -2
  251. package/dist/modules/order/async_lock.js +1 -1
  252. package/dist/modules/order/export.d.ts +7 -6
  253. package/dist/modules/order/export.js +1 -7
  254. package/dist/modules/order/format.d.ts +4 -4
  255. package/dist/modules/order/genesis_policy.d.ts +21 -18
  256. package/dist/modules/order/genesis_policy.js +12 -8
  257. package/dist/modules/order/grid.d.ts +142 -36
  258. package/dist/modules/order/grid.js +148 -123
  259. package/dist/modules/order/grid_reconcile.d.ts +21 -20
  260. package/dist/modules/order/grid_reconcile.js +13 -12
  261. package/dist/modules/order/grid_reconcile_internal.d.ts +85 -72
  262. package/dist/modules/order/grid_reconcile_internal.js +28 -19
  263. package/dist/modules/order/index.d.ts +263 -1
  264. package/dist/modules/order/logger.d.ts +45 -11
  265. package/dist/modules/order/logger.js +38 -40
  266. package/dist/modules/order/logger_state.d.ts +4 -4
  267. package/dist/modules/order/manager.d.ts +225 -180
  268. package/dist/modules/order/manager.js +80 -83
  269. package/dist/modules/order/processed_fill_store.d.ts +18 -3
  270. package/dist/modules/order/processed_fill_store.js +16 -27
  271. package/dist/modules/order/strategy.d.ts +21 -13
  272. package/dist/modules/order/strategy.js +5 -6
  273. package/dist/modules/order/sync_engine.d.ts +91 -33
  274. package/dist/modules/order/sync_engine.js +84 -53
  275. package/dist/modules/order/utils/math.d.ts +157 -102
  276. package/dist/modules/order/utils/math.js +77 -38
  277. package/dist/modules/order/utils/order.d.ts +310 -110
  278. package/dist/modules/order/utils/order.js +122 -99
  279. package/dist/modules/order/utils/slot.d.ts +1 -1
  280. package/dist/modules/order/utils/system.d.ts +176 -26
  281. package/dist/modules/order/utils/system.js +86 -69
  282. package/dist/modules/order/utils/validate.d.ts +89 -41
  283. package/dist/modules/order/utils/validate.js +24 -22
  284. package/dist/modules/order/utils/withPoolRef.d.ts +4 -3
  285. package/dist/modules/order/utils/withPoolRef.js +18 -12
  286. package/dist/modules/order/working_grid.d.ts +14 -13
  287. package/dist/modules/paths.d.ts +1 -4
  288. package/dist/modules/paths.js +1 -27
  289. package/dist/modules/process_discovery.d.ts +1 -1
  290. package/dist/modules/process_discovery.js +2 -1
  291. package/dist/modules/runtime.d.ts +7 -3
  292. package/dist/modules/runtime.js +4 -3
  293. package/dist/modules/runtime_settings.d.ts +15 -10
  294. package/dist/modules/runtime_settings.js +30 -24
  295. package/dist/modules/settings_merge.d.ts +29 -3
  296. package/dist/modules/settings_merge.js +56 -78
  297. package/dist/modules/socket_json_client.d.ts +7 -4
  298. package/dist/modules/storage/browser_adapter.d.ts +38 -53
  299. package/dist/modules/storage/browser_adapter.js +7 -30
  300. package/dist/modules/storage/index.d.ts +1 -1
  301. package/dist/modules/storage/node_adapter.d.ts +45 -27
  302. package/dist/modules/storage/node_adapter.js +9 -9
  303. package/dist/modules/storage/types.d.ts +5 -4
  304. package/dist/modules/types.d.ts +1071 -2
  305. package/dist/modules/types.js +4 -1
  306. package/dist/modules/utils/asset_symbols.d.ts +2 -1
  307. package/dist/modules/utils/asset_symbols.js +2 -1
  308. package/dist/modules/utils/errors.d.ts +9 -0
  309. package/dist/modules/utils/errors.js +23 -1
  310. package/dist/modules/utils/time_range.d.ts +1 -12
  311. package/dist/modules/utils/time_range.js +1 -1
  312. package/dist/modules/validate_profiles.js +53 -43
  313. package/dist/modules/version_notice.d.ts +14 -3
  314. package/dist/modules/version_notice.js +6 -4
  315. package/dist/pm2.d.ts +29 -27
  316. package/dist/pm2.js +5 -5
  317. package/dist/scripts/analyze-credit.d.ts +2 -1
  318. package/dist/scripts/analyze-credit.js +23 -24
  319. package/dist/scripts/analyze-orders.d.ts +77 -9
  320. package/dist/scripts/analyze-orders.js +65 -40
  321. package/dist/scripts/chart_command.d.ts +27 -18
  322. package/dist/scripts/chart_command.js +13 -11
  323. package/dist/scripts/check_any.d.ts +18 -0
  324. package/dist/scripts/check_any.js +126 -0
  325. package/dist/scripts/diagnose-pool-history.js +12 -7
  326. package/dist/scripts/print_grid.js +0 -1
  327. package/dist/scripts/run-tests.js +39 -7
  328. package/dist/scripts/runner.js +1 -1
  329. package/dist/scripts/test-credit-renewal.js +30 -21
  330. package/dist/scripts/update.d.ts +10 -5
  331. package/dist/scripts/update.js +168 -103
  332. package/dist/scripts/update_dist_freshness.js +1 -0
  333. package/dist/scripts/update_layout.d.ts +61 -0
  334. package/dist/scripts/update_layout.js +180 -0
  335. package/dist/scripts/validate_bots.js +2 -1
  336. package/dist/scripts/verify-browser-bundle.js +8 -0
  337. package/dist/unlock.d.ts +28 -3
  338. package/dist/unlock.js +63 -35
  339. package/docs/BITSHARES_ONBOARDING.md +2 -0
  340. package/docs/COPY_ON_WRITE_MASTER_PLAN.md +1 -1
  341. package/docs/COW_INVARIANTS.md +13 -6
  342. package/docs/DEXBOT_COMPARISON.md +8 -8
  343. package/docs/EVOLUTION.md +10 -9
  344. package/docs/FUND_MOVEMENT_AND_ACCOUNTING.md +5 -5
  345. package/docs/GRID_RECALCULATION.md +4 -2
  346. package/docs/GRID_RECONCILE.md +14 -3
  347. package/docs/LIFECYCLE.md +11 -11
  348. package/docs/MPA_CREDIT_USAGE.md +22 -3
  349. package/docs/README.md +14 -3
  350. package/docs/architecture.md +12 -9
  351. package/docs/developer_guide.md +6 -6
  352. package/market_adapter/README.md +6 -1
  353. package/modules/README.md +4 -1
  354. package/package.json +4 -1
@@ -1,4 +1,12 @@
1
- declare function getAmaWarmupBars(erPeriod: any, slowPeriod: any, lookbackBars: any, fastPeriod: any): 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,8 +1,5 @@
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
5
  fastSC;
@@ -58,8 +55,9 @@ class AMA {
58
55
  volatility += Math.abs(this.history[i] - this.history[i - 1]);
59
56
  }
60
57
  const er = volatility === 0 ? 0 : direction / volatility;
58
+ const prevAMA = this.prevAMA;
61
59
  const smooth = (er * (this.fastSC - this.slowSC) + this.slowSC) ** 2;
62
- const ama = this.prevAMA + smooth * (price - this.prevAMA);
60
+ const ama = prevAMA + smooth * (price - prevAMA);
63
61
  this.prevAMA = ama;
64
62
  return ama;
65
63
  }
@@ -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).
@@ -41,13 +69,13 @@ declare function computeAverageAmaSlopePct(current: any, past: any, lookbackBars
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;
@@ -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 ---
@@ -11,7 +11,17 @@
11
11
  * Self-contained on purpose so the chart generators can inject this exact source
12
12
  * into generated HTML — do not add imports referenced from the function body.
13
13
  */
14
- declare function computeVolatilityShift(weightVariance: any, opts?: any): {
14
+ interface VolatilityShiftOpts {
15
+ exponent?: number;
16
+ scaleX?: number;
17
+ threshold?: number;
18
+ clampValue?: number;
19
+ minWeight?: number;
20
+ maxWeight?: number;
21
+ baselineWeight?: number;
22
+ [key: string]: unknown;
23
+ }
24
+ declare function computeVolatilityShift(weightVariance: number, opts?: VolatilityShiftOpts): {
15
25
  rawSymmetricDelta: number;
16
26
  symmetricDelta: number;
17
27
  effectiveWeight: number;
@@ -1,17 +1,4 @@
1
1
  'use strict';
2
- /**
3
- * Symmetric volatility shift — canonical implementation shared by the AMA slope
4
- * model, the volatility research tool, and the browser-embedded chart scripts.
5
- *
6
- * Signal path (mirrors the live adapter):
7
- * rawDelta = -weightVariance^exponent * scaleX
8
- * clampedRawDelta = clamp(rawDelta, -clampValue, 0)
9
- * symmetricDelta = |clampedRawDelta| < threshold ? 0 : clampedRawDelta
10
- * effectiveWeight = clamp(baselineWeight + symmetricDelta, minWeight, maxWeight)
11
- *
12
- * Self-contained on purpose so the chart generators can inject this exact source
13
- * into generated HTML — do not add imports referenced from the function body.
14
- */
15
2
  function computeVolatilityShift(weightVariance, opts = {}) {
16
3
  const { exponent = 1.0, scaleX = 10.0, threshold = 0.1, clampValue = 0.5, minWeight = -1, maxWeight = 2, baselineWeight = 0.5, } = opts;
17
4
  const safeVariance = Number.isFinite(weightVariance) && weightVariance > 0 ? weightVariance : 0;
@@ -0,0 +1,29 @@
1
+ /**
2
+ * Shared OHLC row parsing for the CEX synthetic-candle adapters.
3
+ *
4
+ * Each exchange returns candle arrays with a different field order (and some,
5
+ * like HTX, also return objects). Centralizing the row validation /
6
+ * timestamp normalization / sorting here keeps every adapter's `parseCandles`
7
+ * a one-liner and guarantees identical handling across exchanges.
8
+ */
9
+ export type CandleRow = [number, number, number, number, number, number];
10
+ export interface OhlcIndexes {
11
+ minLength: number;
12
+ ts: number;
13
+ open: number;
14
+ high: number;
15
+ low: number;
16
+ close: number;
17
+ volume: number;
18
+ }
19
+ export declare const OHLC_STANDARD: OhlcIndexes;
20
+ export declare const OHLC_CLOSE_HIGH_LOW: OhlcIndexes;
21
+ export declare const OHLC_GATE: OhlcIndexes;
22
+ export declare const OHLC_KRAKEN: OhlcIndexes;
23
+ /** Normalize a seconds- or milliseconds-epoch timestamp to milliseconds. */
24
+ export declare function normalizeTimestamp(raw: unknown): number;
25
+ export declare function parseCandleRow(row: unknown, idx: OhlcIndexes): CandleRow | null;
26
+ export declare function parseCandleRows(rows: unknown[], idx: OhlcIndexes): CandleRow[];
27
+ /** HTX can return objects instead of arrays; map those to the shared shape. */
28
+ export declare function parseHtxObjectRow(row: unknown): CandleRow | null;
29
+ //# sourceMappingURL=cex_candle_parsing.d.ts.map