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
@@ -29,6 +29,13 @@ const DEFAULT_QUOTE = 'XAUT';
29
29
  const DEFAULT_COMMON_QUOTE = 'USDT';
30
30
  const DEFAULT_BOOTSTRAP_LOOKBACK_HOURS = 720;
31
31
  const DEFAULT_BOTS_FILE = PATHS.PROFILES.BOTS_JSON;
32
+ import { parseCandleRow, parseCandleRows, parseHtxObjectRow, OHLC_STANDARD, OHLC_CLOSE_HIGH_LOW, OHLC_GATE, OHLC_KRAKEN, } from './cex_candle_parsing.js';
33
+ function asRecord(value) {
34
+ return value && typeof value === 'object' ? value : {};
35
+ }
36
+ function asArray(value) {
37
+ return Array.isArray(value) ? value : [];
38
+ }
32
39
  const DEFAULT_EXCHANGES = [
33
40
  'bybit',
34
41
  'htx',
@@ -75,7 +82,7 @@ function loadBotNameIndex(botsFile) {
75
82
  const parsed = parseJsonWithComments(raw);
76
83
  const bots = Array.isArray(parsed?.bots) ? parsed.bots : [];
77
84
  return bots
78
- .map((bot, index) => ({ bot, index }))
85
+ .map((bot, index) => ({ bot: bot, index }))
79
86
  .filter(({ bot }) => bot && typeof bot === 'object' && bot.name);
80
87
  }
81
88
  catch (_err) {
@@ -145,17 +152,11 @@ function normalizeBaseAsset(base, symbol) {
145
152
  }
146
153
  return rawBase;
147
154
  }
148
- function normalizeTimestamp(raw) {
149
- const ts = Number(raw);
150
- if (!Number.isFinite(ts))
151
- return null;
152
- return ts >= 1e12 ? Math.trunc(ts) : Math.trunc(ts * 1000);
153
- }
154
155
  function computeRequiredCandles(amaConfig = null, cfg = null) {
155
156
  const ama = amaConfig || MARKET_ADAPTER.AMAS[MARKET_ADAPTER.DEFAULT_AMA_KEY] || MARKET_ADAPTER.AMAS.AMA3;
156
157
  if (!ama)
157
158
  return DEFAULT_BOOTSTRAP_LOOKBACK_HOURS;
158
- const warmupBars = getAmaWarmupBars(ama.erPeriod, ama.slowPeriod, cfg?.amaSlope?.lookbackBars ?? MARKET_ADAPTER.DYNAMIC_WEIGHT_AMA_LOOKBACK_BARS, ama.fastPeriod, MARKET_ADAPTER.AMA_ER_SMOOTH_FAST_PERIOD);
159
+ const warmupBars = getAmaWarmupBars(ama.erPeriod, ama.slowPeriod, cfg?.amaSlope?.lookbackBars ?? MARKET_ADAPTER.DYNAMIC_WEIGHT_AMA_LOOKBACK_BARS, ama.fastPeriod);
159
160
  const analysisKeepCount = warmupBars + 1;
160
161
  return Math.max(DEFAULT_BOOTSTRAP_LOOKBACK_HOURS, analysisKeepCount);
161
162
  }
@@ -233,8 +234,8 @@ function marketRow(base, quote, id, extra = {}) {
233
234
  };
234
235
  }
235
236
  function extractMarketsFromList(list, mapper) {
236
- const rows = Array.isArray(list) ? list : [];
237
- return rows.map(mapper).filter((row) => row && row.id && row.base && row.quote);
237
+ const rows = asArray(list);
238
+ return rows.map(mapper).filter((row) => Boolean(row && row.id && row.base && row.quote));
238
239
  }
239
240
  const EXCHANGES = {
240
241
  binance: {
@@ -252,26 +253,11 @@ const EXCHANGES = {
252
253
  url.searchParams.set('endTime', String(Math.max(0, Math.trunc(untilMs))));
253
254
  return url.toString();
254
255
  },
255
- parseMarkets: (json) => extractMarketsFromList(json?.symbols, (row) => marketRow(row.baseAsset, row.quoteAsset, row.symbol, { status: row.status })),
256
- parseCandles: (json) => {
257
- const rows = Array.isArray(json) ? json : [];
258
- return rows
259
- .map((row) => {
260
- if (!Array.isArray(row) || row.length < 6)
261
- return null;
262
- const ts = normalizeTimestamp(row[0]);
263
- const open = Number(row[1]);
264
- const high = Number(row[2]);
265
- const low = Number(row[3]);
266
- const close = Number(row[4]);
267
- const volume = Number(row[5]);
268
- if (!Number.isFinite(ts) || ![open, high, low, close].every(Number.isFinite))
269
- return null;
270
- return [ts, open, high, low, close, Number.isFinite(volume) ? volume : 0];
271
- })
272
- .filter((x) => x != null)
273
- .sort((a, b) => a[0] - b[0]);
274
- },
256
+ parseMarkets: (json) => extractMarketsFromList(asRecord(json).symbols, (row) => {
257
+ const r = asRecord(row);
258
+ return marketRow(r.baseAsset, r.quoteAsset, r.symbol, { status: r.status });
259
+ }),
260
+ parseCandles: (json) => parseCandleRows(asArray(json), OHLC_STANDARD),
275
261
  },
276
262
  bybit: {
277
263
  name: 'Bybit',
@@ -303,26 +289,11 @@ const EXCHANGES = {
303
289
  url.searchParams.set('end', String(Math.max(0, Math.trunc(untilMs))));
304
290
  return url.toString();
305
291
  },
306
- parseMarkets: (json) => extractMarketsFromList(json?.result?.list, (row) => marketRow(row.baseCoin, row.quoteCoin, row.symbol, { status: row.status })),
307
- parseCandles: (json) => {
308
- const rows = Array.isArray(json?.result?.list) ? json.result.list : [];
309
- return rows
310
- .map((row) => {
311
- if (!Array.isArray(row) || row.length < 6)
312
- return null;
313
- const ts = normalizeTimestamp(row[0]);
314
- const open = Number(row[1]);
315
- const high = Number(row[2]);
316
- const low = Number(row[3]);
317
- const close = Number(row[4]);
318
- const volume = Number(row[5]);
319
- if (!Number.isFinite(ts) || ![open, high, low, close].every(Number.isFinite))
320
- return null;
321
- return [ts, open, high, low, close, Number.isFinite(volume) ? volume : 0];
322
- })
323
- .filter((x) => x != null)
324
- .sort((a, b) => a[0] - b[0]);
325
- },
292
+ parseMarkets: (json) => extractMarketsFromList(asRecord(asRecord(json).result).list, (row) => {
293
+ const r = asRecord(row);
294
+ return marketRow(r.baseCoin, r.quoteCoin, r.symbol, { status: r.status });
295
+ }),
296
+ parseCandles: (json) => parseCandleRows(asArray(asRecord(asRecord(json).result).list), OHLC_STANDARD),
326
297
  },
327
298
  gate: {
328
299
  name: 'Gate',
@@ -339,26 +310,11 @@ const EXCHANGES = {
339
310
  url.searchParams.set('to', String(Math.max(0, Math.trunc(untilMs / 1000))));
340
311
  return url.toString();
341
312
  },
342
- parseMarkets: (json) => extractMarketsFromList(json, (row) => marketRow(row.base, row.quote, row.id, { tradeStatus: row.trade_status })),
343
- parseCandles: (json) => {
344
- const rows = Array.isArray(json) ? json : [];
345
- return rows
346
- .map((row) => {
347
- if (!Array.isArray(row) || row.length < 7)
348
- return null;
349
- const ts = normalizeTimestamp(row[0]);
350
- const close = Number(row[2]);
351
- const high = Number(row[3]);
352
- const low = Number(row[4]);
353
- const open = Number(row[5]);
354
- const volume = Number(row[6]);
355
- if (!Number.isFinite(ts) || ![open, high, low, close].every(Number.isFinite))
356
- return null;
357
- return [ts, open, high, low, close, Number.isFinite(volume) ? volume : 0];
358
- })
359
- .filter((x) => x != null)
360
- .sort((a, b) => a[0] - b[0]);
361
- },
313
+ parseMarkets: (json) => extractMarketsFromList(json, (row) => {
314
+ const r = asRecord(row);
315
+ return marketRow(r.base, r.quote, r.id, { tradeStatus: r.trade_status });
316
+ }),
317
+ parseCandles: (json) => parseCandleRows(asArray(json), OHLC_GATE),
362
318
  },
363
319
  bitget: {
364
320
  name: 'Bitget',
@@ -389,26 +345,11 @@ const EXCHANGES = {
389
345
  url.searchParams.set('endTime', String(Math.max(0, Math.trunc(untilMs))));
390
346
  return url.toString();
391
347
  },
392
- parseMarkets: (json) => extractMarketsFromList(json?.data, (row) => marketRow(row.baseCoin, row.quoteCoin, row.symbol, { status: row.status })),
393
- parseCandles: (json) => {
394
- const rows = Array.isArray(json?.data) ? json.data : [];
395
- return rows
396
- .map((row) => {
397
- if (!Array.isArray(row) || row.length < 6)
398
- return null;
399
- const ts = normalizeTimestamp(row[0]);
400
- const open = Number(row[1]);
401
- const high = Number(row[2]);
402
- const low = Number(row[3]);
403
- const close = Number(row[4]);
404
- const volume = Number(row[5]);
405
- if (!Number.isFinite(ts) || ![open, high, low, close].every(Number.isFinite))
406
- return null;
407
- return [ts, open, high, low, close, Number.isFinite(volume) ? volume : 0];
408
- })
409
- .filter((x) => x != null)
410
- .sort((a, b) => a[0] - b[0]);
411
- },
348
+ parseMarkets: (json) => extractMarketsFromList(asRecord(json).data, (row) => {
349
+ const r = asRecord(row);
350
+ return marketRow(r.baseCoin, r.quoteCoin, r.symbol, { status: r.status });
351
+ }),
352
+ parseCandles: (json) => parseCandleRows(asArray(asRecord(json).data), OHLC_STANDARD),
412
353
  },
413
354
  kucoin: {
414
355
  name: 'KuCoin',
@@ -438,26 +379,11 @@ const EXCHANGES = {
438
379
  url.searchParams.set('endAt', String(Math.max(0, Math.trunc(untilMs / 1000))));
439
380
  return url.toString();
440
381
  },
441
- parseMarkets: (json) => extractMarketsFromList(json?.data, (row) => marketRow(row.baseCurrency, row.quoteCurrency, row.symbol, { enableTrading: row.enableTrading })),
442
- parseCandles: (json) => {
443
- const rows = Array.isArray(json?.data) ? json.data : [];
444
- return rows
445
- .map((row) => {
446
- if (!Array.isArray(row) || row.length < 6)
447
- return null;
448
- const ts = normalizeTimestamp(row[0]);
449
- const open = Number(row[1]);
450
- const close = Number(row[2]);
451
- const high = Number(row[3]);
452
- const low = Number(row[4]);
453
- const volume = Number(row[5]);
454
- if (!Number.isFinite(ts) || ![open, high, low, close].every(Number.isFinite))
455
- return null;
456
- return [ts, open, high, low, close, Number.isFinite(volume) ? volume : 0];
457
- })
458
- .filter((x) => x != null)
459
- .sort((a, b) => a[0] - b[0]);
460
- },
382
+ parseMarkets: (json) => extractMarketsFromList(asRecord(json).data, (row) => {
383
+ const r = asRecord(row);
384
+ return marketRow(r.baseCurrency, r.quoteCurrency, r.symbol, { enableTrading: r.enableTrading });
385
+ }),
386
+ parseCandles: (json) => parseCandleRows(asArray(asRecord(json).data), OHLC_CLOSE_HIGH_LOW),
461
387
  },
462
388
  htx: {
463
389
  name: 'HTX',
@@ -489,41 +415,18 @@ const EXCHANGES = {
489
415
  url.searchParams.set('to', String(Math.max(0, Math.trunc(untilMs / 1000))));
490
416
  return url.toString();
491
417
  },
492
- parseMarkets: (json) => extractMarketsFromList(json?.data || json, (row) => {
493
- const base = row.baseCurrency || row['base-currency'] || row.base_currency;
494
- const quote = row.quoteCurrency || row['quote-currency'] || row.quote_currency;
495
- const id = row.symbol || row['symbol'];
496
- return marketRow(base, quote, id, { state: row.state });
418
+ parseMarkets: (json) => extractMarketsFromList(Array.isArray(asRecord(json).data) ? asRecord(json).data : json, (row) => {
419
+ const r = asRecord(row);
420
+ const base = r.baseCurrency || r['base-currency'] || r.base_currency;
421
+ const quote = r.quoteCurrency || r['quote-currency'] || r.quote_currency;
422
+ const id = r.symbol || r['symbol'];
423
+ return marketRow(base, quote, id, { state: r.state });
497
424
  }),
498
425
  parseCandles: (json) => {
499
- const rows = Array.isArray(json?.data) ? json.data : Array.isArray(json) ? json : [];
426
+ const data = asRecord(json).data;
427
+ const rows = Array.isArray(data) ? data : asArray(json);
500
428
  return rows
501
- .map((row) => {
502
- if (Array.isArray(row)) {
503
- if (row.length < 6)
504
- return null;
505
- const ts = normalizeTimestamp(row[0]);
506
- const open = Number(row[1]);
507
- const close = Number(row[2]);
508
- const high = Number(row[3]);
509
- const low = Number(row[4]);
510
- const volume = Number(row[5]);
511
- if (!Number.isFinite(ts) || ![open, high, low, close].every(Number.isFinite))
512
- return null;
513
- return [ts, open, high, low, close, Number.isFinite(volume) ? volume : 0];
514
- }
515
- if (!row || typeof row !== 'object')
516
- return null;
517
- const ts = normalizeTimestamp(row.id ?? row.timestamp ?? row.time);
518
- const open = Number(row.open);
519
- const high = Number(row.high);
520
- const low = Number(row.low);
521
- const close = Number(row.close);
522
- const volume = Number(row.amount ?? row.vol ?? row.volume ?? 0);
523
- if (!Number.isFinite(ts) || ![open, high, low, close].every(Number.isFinite))
524
- return null;
525
- return [ts, open, high, low, close, Number.isFinite(volume) ? volume : 0];
526
- })
429
+ .map((row) => (Array.isArray(row) ? parseCandleRow(row, OHLC_CLOSE_HIGH_LOW) : parseHtxObjectRow(row)))
527
430
  .filter((x) => x != null)
528
431
  .sort((a, b) => a[0] - b[0]);
529
432
  },
@@ -555,38 +458,23 @@ const EXCHANGES = {
555
458
  return url.toString();
556
459
  },
557
460
  parseMarkets: (json) => {
558
- const entries = Object.entries(json?.result || {});
461
+ const entries = Object.entries(asRecord(asRecord(json).result));
559
462
  return entries.map(([key, row]) => {
560
- const ws = String(row.wsname || '').toUpperCase();
463
+ const r = asRecord(row);
464
+ const ws = String(r.wsname || '').toUpperCase();
561
465
  const [baseFromWs, quoteFromWs] = ws.includes('/') ? ws.split('/') : [null, null];
562
- const base = baseFromWs || upper(row.base);
563
- const quote = quoteFromWs || upper(row.quote);
564
- const id = row.altname || key;
565
- return marketRow(base, quote, id, { wsname: row.wsname });
566
- }).filter((row) => row.id && row.base && row.quote);
466
+ const base = baseFromWs || upper(r.base);
467
+ const quote = quoteFromWs || upper(r.quote);
468
+ const id = r.altname || key;
469
+ return marketRow(base, quote, id, { wsname: r.wsname });
470
+ }).filter((row) => Boolean(row.id && row.base && row.quote));
567
471
  },
568
472
  parseCandles: (json) => {
569
- const result = json?.result || {};
473
+ const result = asRecord(asRecord(json).result);
570
474
  const pairKey = Object.keys(result).find((key) => key !== 'last');
571
475
  if (!pairKey)
572
476
  return [];
573
- const rows = Array.isArray(result[pairKey]) ? result[pairKey] : [];
574
- return rows
575
- .map((row) => {
576
- if (!Array.isArray(row) || row.length < 7)
577
- return null;
578
- const ts = normalizeTimestamp(Number(row[0]) * 1000);
579
- const open = Number(row[1]);
580
- const high = Number(row[2]);
581
- const low = Number(row[3]);
582
- const close = Number(row[4]);
583
- const volume = Number(row[6]);
584
- if (!Number.isFinite(ts) || ![open, high, low, close].every(Number.isFinite))
585
- return null;
586
- return [ts, open, high, low, close, Number.isFinite(volume) ? volume : 0];
587
- })
588
- .filter((x) => x != null)
589
- .sort((a, b) => a[0] - b[0]);
477
+ return parseCandleRows(asArray(result[pairKey]), OHLC_KRAKEN);
590
478
  },
591
479
  },
592
480
  okx: {
@@ -620,26 +508,11 @@ const EXCHANGES = {
620
508
  url.searchParams.set('after', String(Math.max(0, Math.trunc(untilMs))));
621
509
  return url.toString();
622
510
  },
623
- parseMarkets: (json) => extractMarketsFromList(json?.data, (row) => marketRow(row.baseCcy, row.quoteCcy, row.instId, { state: row.state })),
624
- parseCandles: (json) => {
625
- const rows = Array.isArray(json?.data) ? json.data : [];
626
- return rows
627
- .map((row) => {
628
- if (!Array.isArray(row) || row.length < 6)
629
- return null;
630
- const ts = normalizeTimestamp(row[0]);
631
- const open = Number(row[1]);
632
- const high = Number(row[2]);
633
- const low = Number(row[3]);
634
- const close = Number(row[4]);
635
- const volume = Number(row[5]);
636
- if (!Number.isFinite(ts) || ![open, high, low, close].every(Number.isFinite))
637
- return null;
638
- return [ts, open, high, low, close, Number.isFinite(volume) ? volume : 0];
639
- })
640
- .filter((x) => x != null)
641
- .sort((a, b) => a[0] - b[0]);
642
- },
511
+ parseMarkets: (json) => extractMarketsFromList(asRecord(json).data, (row) => {
512
+ const r = asRecord(row);
513
+ return marketRow(r.baseCcy, r.quoteCcy, r.instId, { state: r.state });
514
+ }),
515
+ parseCandles: (json) => parseCandleRows(asArray(asRecord(json).data), OHLC_STANDARD),
643
516
  },
644
517
  mexc: {
645
518
  name: 'MEXC',
@@ -673,26 +546,11 @@ const EXCHANGES = {
673
546
  url.searchParams.set('endTime', String(Math.max(0, Math.trunc(untilMs))));
674
547
  return url.toString();
675
548
  },
676
- parseMarkets: (json) => extractMarketsFromList(json?.symbols, (row) => marketRow(normalizeBaseAsset(row.baseAsset, row.symbol), row.quoteAsset, row.symbol, { status: row.status })),
677
- parseCandles: (json) => {
678
- const rows = Array.isArray(json) ? json : [];
679
- return rows
680
- .map((row) => {
681
- if (!Array.isArray(row) || row.length < 6)
682
- return null;
683
- const ts = normalizeTimestamp(row[0]);
684
- const open = Number(row[1]);
685
- const high = Number(row[2]);
686
- const low = Number(row[3]);
687
- const close = Number(row[4]);
688
- const volume = Number(row[5]);
689
- if (!Number.isFinite(ts) || ![open, high, low, close].every(Number.isFinite))
690
- return null;
691
- return [ts, open, high, low, close, Number.isFinite(volume) ? volume : 0];
692
- })
693
- .filter((x) => x != null)
694
- .sort((a, b) => a[0] - b[0]);
695
- },
549
+ parseMarkets: (json) => extractMarketsFromList(asRecord(json).symbols, (row) => {
550
+ const r = asRecord(row);
551
+ return marketRow(normalizeBaseAsset(r.baseAsset, r.symbol), r.quoteAsset, r.symbol, { status: r.status });
552
+ }),
553
+ parseCandles: (json) => parseCandleRows(asArray(json), OHLC_STANDARD),
696
554
  },
697
555
  };
698
556
  function parseArgs() {
@@ -852,20 +710,22 @@ function findMarketId(markets, base, quote) {
852
710
  function buildSyntheticCandle(left, right) {
853
711
  // Guard against degenerate zero/negative leg prices: dividing by them
854
712
  // would produce Infinity/NaN OHLC rows in the seed file.
855
- const leftPrices = [left[1], left[2], left[3], left[4]];
856
- const rightPrices = [right[1], right[2], right[3], right[4]];
713
+ const l = asArray(left).map(Number);
714
+ const r = asArray(right).map(Number);
715
+ const leftPrices = [l[1], l[2], l[3], l[4]];
716
+ const rightPrices = [r[1], r[2], r[3], r[4]];
857
717
  if (!leftPrices.every((v) => Number.isFinite(v) && v > 0)
858
718
  || !rightPrices.every((v) => Number.isFinite(v) && v > 0)) {
859
719
  return null;
860
720
  }
861
- const open = left[1] / right[1];
862
- const close = left[4] / right[4];
863
- const high = Math.max(left[2] / right[3], open, close);
864
- const low = Math.min(left[3] / right[2], open, close);
721
+ const open = l[1] / r[1];
722
+ const close = l[4] / r[4];
723
+ const high = Math.max(l[2] / r[3], open, close);
724
+ const low = Math.min(l[3] / r[2], open, close);
865
725
  if (![open, high, low, close].every(Number.isFinite))
866
726
  return null;
867
- const volume = Number(left[5] || 0);
868
- return [left[0], open, high, low, close, Number.isFinite(volume) ? volume : 0];
727
+ const volume = Number(l[5] || 0);
728
+ return [l[0], open, high, low, close, Number.isFinite(volume) ? volume : 0];
869
729
  }
870
730
  function synthesizeCrossCandles(leftCandles, rightCandles) {
871
731
  const leftMap = new Map(leftCandles.map((row) => [row[0], row]));
@@ -889,10 +749,11 @@ function chooseOutputPath(config, intervalLabel) {
889
749
  }
890
750
  function dedupeCandles(candles) {
891
751
  const map = new Map();
892
- for (const candle of Array.isArray(candles) ? candles : []) {
752
+ for (const candle of asArray(candles)) {
893
753
  if (!Array.isArray(candle) || !Number.isFinite(candle[0]))
894
754
  continue;
895
- map.set(candle[0], candle);
755
+ const row = candle;
756
+ map.set(row[0], row);
896
757
  }
897
758
  return [...map.values()].sort((a, b) => a[0] - b[0]);
898
759
  }
@@ -935,7 +796,7 @@ async function fetchHistoricalCandles(def, marketId, interval, intervalSeconds,
935
796
  break;
936
797
  }
937
798
  if (i < maxIterations - 1) {
938
- await new Promise((r) => setTimeout(r, MARKET_ADAPTER.CEX_API_DELAY_MS));
799
+ await new Promise((resolve) => setTimeout(resolve, MARKET_ADAPTER.CEX_API_DELAY_MS));
939
800
  }
940
801
  }
941
802
  return dedupeCandles(collected);
@@ -943,7 +804,7 @@ async function fetchHistoricalCandles(def, marketId, interval, intervalSeconds,
943
804
  async function probeExchange(exchangeId, base, quote, commonQuote, interval, intervalSeconds, requiredCandles, probeLookbackHours, pageLimit) {
944
805
  const def = EXCHANGES[exchangeId];
945
806
  if (!def) {
946
- return { exchangeId, error: `Unknown exchange: ${exchangeId}` };
807
+ return { exchangeId, error: `Unknown exchange: ${exchangeId}`, baseCandles: [], quoteCandles: [], requiredCandles, probeLookbackHours, probeCandles: 0 };
947
808
  }
948
809
  try {
949
810
  const marketsRes = await fetchJson(def.marketsUrl);
@@ -952,6 +813,11 @@ async function probeExchange(exchangeId, base, quote, commonQuote, interval, int
952
813
  exchangeId,
953
814
  name: def.name,
954
815
  error: `markets HTTP ${marketsRes.status} ${marketsRes.statusText}`.trim(),
816
+ baseCandles: [],
817
+ quoteCandles: [],
818
+ requiredCandles,
819
+ probeLookbackHours,
820
+ probeCandles: 0,
955
821
  };
956
822
  }
957
823
  const markets = def.parseMarkets(marketsRes.json);
@@ -989,18 +855,23 @@ async function probeExchange(exchangeId, base, quote, commonQuote, interval, int
989
855
  exchangeId,
990
856
  name: def.name,
991
857
  error: getErrorMessage(err),
858
+ baseCandles: [],
859
+ quoteCandles: [],
860
+ requiredCandles,
861
+ probeLookbackHours,
862
+ probeCandles: 0,
992
863
  };
993
864
  }
994
865
  }
995
866
  function pickBestExchange(probes, preferredExchangeIds) {
996
- const preferred = (preferredExchangeIds || []).map((id) => lower(id));
867
+ const preferred = preferredExchangeIds.map((id) => lower(id));
997
868
  const ranked = rankProbes(probes, preferred, true);
998
869
  return ranked[0] || null;
999
870
  }
1000
871
  function rankProbes(probes, preferredExchangeIds, onlyUsable = false) {
1001
- const preferred = (preferredExchangeIds || []).map((id) => lower(id));
872
+ const preferred = preferredExchangeIds.map((id) => lower(id));
1002
873
  return probes
1003
- .filter((probe) => probe && !probe.error && probe.baseCommon && probe.quoteCommon && probe.hasUsableTimeframe)
874
+ .filter((probe) => Boolean(probe && !probe.error && probe.baseCommon && probe.quoteCommon && probe.hasUsableTimeframe))
1004
875
  .map((probe) => ({
1005
876
  ...probe,
1006
877
  score: Math.min(probe.baseRange?.count || 0, probe.quoteRange?.count || 0),
@@ -1059,7 +930,7 @@ async function main() {
1059
930
  const parsedConfig = parseArgs();
1060
931
  // Handle --help before bot-derived resolution so a typo'd --bot-name does
1061
932
  // not crash instead of printing usage.
1062
- if (parsedConfig.config.help) {
933
+ if (parsedConfig.config?.help) {
1063
934
  printHelp();
1064
935
  return;
1065
936
  }
@@ -1134,7 +1005,6 @@ async function main() {
1134
1005
  erPeriod: botAma.erPeriod,
1135
1006
  fastPeriod: botAma.fastPeriod,
1136
1007
  slowPeriod: botAma.slowPeriod,
1137
- erSmoothPeriod: botAma.erSmoothPeriod ?? null,
1138
1008
  } : null,
1139
1009
  bot: botContext ? {
1140
1010
  name: botContext.bot.name || null,
@@ -1157,12 +1027,13 @@ async function main() {
1157
1027
  if (!config.quiet) {
1158
1028
  console.log(`Wrote ${filled.length} synthetic candles to ${outPath}`);
1159
1029
  console.log(`Source: ${selected.exchangeId} (${def.name})`);
1160
- console.log(`Legs: ${baseMarket.id} and ${quoteMarket.id}`);
1030
+ console.log(`Legs: ${baseMarket?.id ?? '?'} and ${quoteMarket?.id ?? '?'}`);
1161
1031
  console.log(`Output pair: ${upper(config.base)}/${upper(config.quote)}`);
1162
1032
  }
1163
1033
  }
1164
1034
  main().catch((err) => {
1165
- console.error(err?.stack || err?.message || String(err));
1035
+ const e = err;
1036
+ console.error(e?.stack || e?.message || String(err));
1166
1037
  process.exit(1);
1167
1038
  });
1168
1039
  //# sourceMappingURL=fetch_cex_synthetic_data.js.map
@@ -1,13 +1,48 @@
1
- declare function outputPath(poolId: any, intervalSeconds: any, assetA: any, assetB: any): string;
2
- declare function applyPrecisionOverrides(assetA: any, assetB: any, precA: any, precB: any): {
3
- assetA: any;
4
- assetB: any;
1
+ interface AssetRef {
2
+ id?: string;
3
+ precision?: number;
4
+ symbol?: string | null;
5
+ [key: string]: unknown;
6
+ }
7
+ interface LpPageInfo {
8
+ event?: string;
9
+ direction?: string;
10
+ page?: number;
11
+ attempt?: number;
12
+ error?: string;
13
+ [key: string]: unknown;
14
+ }
15
+ interface LpConfig {
16
+ intervalSeconds: number;
17
+ lookbackHours?: number;
18
+ apiKey?: string | null;
19
+ chunkMonths: number;
20
+ timeRange?: {
21
+ gte?: string;
22
+ lte?: string;
23
+ };
24
+ outPath?: string;
25
+ onPage?: (info: LpPageInfo) => void;
26
+ [key: string]: unknown;
27
+ }
28
+ interface BotConfig {
29
+ name?: string;
30
+ active?: boolean;
31
+ startPrice?: unknown;
32
+ assetA?: string;
33
+ assetB?: string;
34
+ [key: string]: unknown;
35
+ }
36
+ declare function outputPath(poolId: unknown, intervalSeconds: number, assetA: AssetRef, assetB: AssetRef): string;
37
+ declare function applyPrecisionOverrides(assetA: AssetRef, assetB: AssetRef, precA: number | null, precB: number | null): {
38
+ assetA: AssetRef;
39
+ assetB: AssetRef;
5
40
  };
6
- declare function fetchCandlesSequentially(fullPoolId: any, assetA: any, assetB: any, config: any, outPath: any): Promise<any[]>;
7
- declare function parseBotsConfig(raw: any, sourceLabel?: any): any;
41
+ declare function fetchCandlesSequentially(fullPoolId: string, assetA: AssetRef, assetB: AssetRef, config: LpConfig, outPath: string): Promise<number[][]>;
42
+ declare function parseBotsConfig(raw: string, sourceLabel?: string): BotConfig[];
8
43
  /**
9
44
  * Pick a bot: by name if given, otherwise first active bot with startPrice: "pool".
10
45
  */
11
- declare function selectBot(bots: any, botName: any): any;
46
+ declare function selectBot(bots: BotConfig[], botName: string | null | undefined): BotConfig;
12
47
  export { applyPrecisionOverrides, parseBotsConfig, selectBot, fetchCandlesSequentially, outputPath };
13
48
  //# sourceMappingURL=fetch_lp_data.d.ts.map