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,24 +1,38 @@
1
- declare function isLikelyMarketAdapterProcess(pid: any): boolean;
1
+ import type { UnknownRecord } from '../../modules/types.js';
2
+ interface AcquireLockOptions {
3
+ staleMs?: number;
4
+ timeoutMs?: number;
5
+ retryMs?: number;
6
+ maxAttempts?: number;
7
+ contention?: 'throw' | 'wait';
8
+ aliveCheck?: ((pid: number) => boolean) | null;
9
+ buildPayload?: () => UnknownRecord;
10
+ alreadyRunningMsg?: string | (() => string);
11
+ timeoutMsg?: string;
12
+ }
13
+ interface AcquiredLock {
14
+ fd: number | null;
15
+ lockPath: string;
16
+ heartbeat: ReturnType<typeof setInterval> | null;
17
+ ownerId: number | string;
18
+ }
19
+ declare function isLikelyMarketAdapterProcess(pid: number): boolean;
2
20
  /**
3
21
  * Market-adapter lifecycle lock: long stale window + heartbeat + process-aware
4
22
  * ownership check, so a live adapter lock is never stolen by a newer process.
5
23
  */
6
- declare function acquireFileLockSync(lockPath: any, opts?: any): {
7
- fd: number;
8
- lockPath: any;
9
- heartbeat: any;
10
- ownerId: string | number;
11
- };
12
- declare function releaseFileLockSync(lock: any): void;
24
+ declare function acquireFileLockSync(lockPath: string, opts?: AcquireLockOptions): AcquiredLock;
25
+ declare function releaseFileLockSync(lock: {
26
+ heartbeat?: ReturnType<typeof setInterval> | null;
27
+ fd?: number | null;
28
+ lockPath?: string;
29
+ ownerId?: number | string;
30
+ } | null): void;
13
31
  /**
14
32
  * Short-lived per-path lock (e.g. dynamic grid snapshots): waits for the holder
15
33
  * to release (or for the lock to go stale) up to timeoutMs.
16
34
  */
17
- declare function acquirePathLockSync(filePath: any, opts?: any): {
18
- fd: number;
19
- lockPath: any;
20
- ownerId: string | number;
21
- };
22
- declare function acquireFileLock(filePath: any, opts?: any): Promise<() => void>;
35
+ declare function acquirePathLockSync(filePath: string, opts?: AcquireLockOptions): AcquiredLock;
36
+ declare function acquireFileLock(filePath: string, opts?: AcquireLockOptions): Promise<() => void>;
23
37
  export { acquireFileLockSync, releaseFileLockSync, acquirePathLockSync, acquireFileLock, isLikelyMarketAdapterProcess };
24
38
  //# sourceMappingURL=file_lock.d.ts.map
@@ -1,4 +1,5 @@
1
1
  'use strict';
2
+ import { getErrorCode } from '../../modules/utils/errors.js';
2
3
  import { getStorage } from '../../modules/storage/index.js';
3
4
  import { getProcessDiscovery } from '../../modules/process_discovery.js';
4
5
  import { runtime } from '../../modules/runtime.js';
@@ -74,6 +75,23 @@ function _isLockStaleOrDead(lockPath, staleMs, now, aliveCheck) {
74
75
  }
75
76
  return false;
76
77
  }
78
+ /**
79
+ * Resolve the ownership token, payload builder, and lazy error messages shared
80
+ * by the sync and async lock cores.
81
+ */
82
+ function _resolveLockPayload(lockPath, opts, timeoutMs) {
83
+ const ownerId = _lockOwnerId();
84
+ const buildPayloadFn = opts.buildPayload;
85
+ const buildPayload = typeof buildPayloadFn === 'function'
86
+ ? () => ({ ...buildPayloadFn(), ownerId })
87
+ : () => ({ pid: _lockOwnerId(), at: Date.now(), ownerId });
88
+ const alreadyRunningMsg = opts.alreadyRunningMsg;
89
+ const resolveRunningMsg = typeof alreadyRunningMsg === 'function'
90
+ ? alreadyRunningMsg
91
+ : () => (alreadyRunningMsg || `already locked: `);
92
+ const timeoutMsg = opts.timeoutMsg || `Could not acquire lock on ${lockPath} within ${timeoutMs}ms`;
93
+ return { ownerId, buildPayload, resolveRunningMsg, timeoutMsg };
94
+ }
77
95
  /**
78
96
  * Shared file-lock primitive.
79
97
  *
@@ -95,23 +113,16 @@ function _isLockStaleOrDead(lockPath, staleMs, now, aliveCheck) {
95
113
  * from the lock file only when contention is actually hit)
96
114
  */
97
115
  function _acquireLockCore(lockPath, opts = {}) {
98
- const staleMs = Number.isFinite(opts.staleMs) && opts.staleMs > 0 ? opts.staleMs : 30000;
99
- const timeoutMs = Number.isFinite(opts.timeoutMs) && opts.timeoutMs > 0 ? opts.timeoutMs : Infinity;
100
- const retryMs = Number.isFinite(opts.retryMs) && opts.retryMs > 0 ? opts.retryMs : 0;
101
- const maxAttempts = Number.isFinite(opts.maxAttempts) && opts.maxAttempts > 0 ? opts.maxAttempts : Infinity;
116
+ const staleMs = typeof opts.staleMs === 'number' && Number.isFinite(opts.staleMs) && opts.staleMs > 0 ? opts.staleMs : 30000;
117
+ const timeoutMs = typeof opts.timeoutMs === 'number' && Number.isFinite(opts.timeoutMs) && opts.timeoutMs > 0 ? opts.timeoutMs : Infinity;
118
+ const retryMs = typeof opts.retryMs === 'number' && Number.isFinite(opts.retryMs) && opts.retryMs > 0 ? opts.retryMs : 0;
119
+ const maxAttempts = typeof opts.maxAttempts === 'number' && Number.isFinite(opts.maxAttempts) && opts.maxAttempts > 0 ? opts.maxAttempts : Infinity;
102
120
  const contention = opts.contention === 'wait' ? 'wait' : 'throw';
103
121
  const aliveCheck = typeof opts.aliveCheck === 'function' ? opts.aliveCheck : null;
104
122
  // The heartbeat must fire strictly inside the staleness window, otherwise a
105
123
  // live-held lock looks stale between beats and can be stolen.
106
124
  const heartbeatMs = Math.min(MARKET_ADAPTER.FILE_LOCK_HEARTBEAT_MAX_MS, Math.max(MARKET_ADAPTER.FILE_LOCK_HEARTBEAT_MIN_MS, Math.floor(staleMs / 2)));
107
- const ownerId = _lockOwnerId();
108
- const buildPayload = typeof opts.buildPayload === 'function'
109
- ? () => ({ ...opts.buildPayload(), ownerId })
110
- : () => ({ pid: _lockOwnerId(), at: Date.now(), ownerId });
111
- const resolveRunningMsg = typeof opts.alreadyRunningMsg === 'function'
112
- ? opts.alreadyRunningMsg
113
- : () => (opts.alreadyRunningMsg || `already locked: ${lockPath}`);
114
- const timeoutMsg = opts.timeoutMsg || `Could not acquire lock on ${lockPath} within ${timeoutMs}ms`;
125
+ const { ownerId, buildPayload, resolveRunningMsg, timeoutMsg } = _resolveLockPayload(lockPath, opts, timeoutMs);
115
126
  const deadline = Number.isFinite(timeoutMs) ? Date.now() + timeoutMs : Infinity;
116
127
  let attempts = 0;
117
128
  while (attempts < maxAttempts && Date.now() < deadline) {
@@ -151,7 +162,7 @@ function _acquireLockCore(lockPath, opts = {}) {
151
162
  }
152
163
  catch (_) { }
153
164
  }
154
- if (err.code !== 'EEXIST')
165
+ if (getErrorCode(err) !== 'EEXIST')
155
166
  throw err;
156
167
  attempts++;
157
168
  if (_isLockStaleOrDead(lockPath, staleMs, Date.now(), aliveCheck)) {
@@ -184,18 +195,11 @@ function _releaseOwnedLock(lockPath, ownerId, unlinkFn) {
184
195
  return true;
185
196
  }
186
197
  async function _acquireLockCoreAsync(lockPath, opts = {}) {
187
- const staleMs = Number.isFinite(opts.staleMs) && opts.staleMs > 0 ? opts.staleMs : 30000;
188
- const timeoutMs = Number.isFinite(opts.timeoutMs) && opts.timeoutMs > 0 ? opts.timeoutMs : 5000;
189
- const retryMs = Number.isFinite(opts.retryMs) && opts.retryMs > 0 ? opts.retryMs : 50;
198
+ const staleMs = typeof opts.staleMs === 'number' && Number.isFinite(opts.staleMs) && opts.staleMs > 0 ? opts.staleMs : 30000;
199
+ const timeoutMs = typeof opts.timeoutMs === 'number' && Number.isFinite(opts.timeoutMs) && opts.timeoutMs > 0 ? opts.timeoutMs : 5000;
200
+ const retryMs = typeof opts.retryMs === 'number' && Number.isFinite(opts.retryMs) && opts.retryMs > 0 ? opts.retryMs : 50;
190
201
  const aliveCheck = typeof opts.aliveCheck === 'function' ? opts.aliveCheck : null;
191
- const ownerId = _lockOwnerId();
192
- const buildPayload = typeof opts.buildPayload === 'function'
193
- ? () => ({ ...opts.buildPayload(), ownerId })
194
- : () => ({ pid: _lockOwnerId(), at: Date.now(), ownerId });
195
- const resolveRunningMsg = typeof opts.alreadyRunningMsg === 'function'
196
- ? opts.alreadyRunningMsg
197
- : () => (opts.alreadyRunningMsg || `already locked: ${lockPath}`);
198
- const timeoutMsg = opts.timeoutMsg || `Could not acquire lock on ${lockPath} within ${timeoutMs}ms`;
202
+ const { ownerId, buildPayload, resolveRunningMsg, timeoutMsg } = _resolveLockPayload(lockPath, opts, timeoutMs);
199
203
  const deadline = Date.now() + timeoutMs;
200
204
  while (Date.now() < deadline) {
201
205
  try {
@@ -205,7 +209,7 @@ async function _acquireLockCoreAsync(lockPath, opts = {}) {
205
209
  };
206
210
  }
207
211
  catch (err) {
208
- if (err.code !== 'EEXIST') {
212
+ if (getErrorCode(err) !== 'EEXIST') {
209
213
  // A non-EEXIST failure may have left a partially written lock
210
214
  // file behind — clean it up if it still carries our token.
211
215
  try {
@@ -244,7 +248,7 @@ async function _acquireLockCoreAsync(lockPath, opts = {}) {
244
248
  * ownership check, so a live adapter lock is never stolen by a newer process.
245
249
  */
246
250
  function acquireFileLockSync(lockPath, opts = {}) {
247
- const staleMs = Number.isFinite(opts.staleMs) && opts.staleMs > 0 ? opts.staleMs : (6 * 3600 * 1000);
251
+ const staleMs = typeof opts.staleMs === 'number' && Number.isFinite(opts.staleMs) && opts.staleMs > 0 ? opts.staleMs : (6 * 3600 * 1000);
248
252
  return _acquireLockCore(lockPath, {
249
253
  staleMs,
250
254
  maxAttempts: 2,
@@ -287,9 +291,9 @@ function releaseFileLockSync(lock) {
287
291
  */
288
292
  function acquirePathLockSync(filePath, opts = {}) {
289
293
  const lockPath = `${filePath}.lock`;
290
- const staleMs = Number.isFinite(opts.staleMs) && opts.staleMs > 0 ? opts.staleMs : 30000;
291
- const timeoutMs = Number.isFinite(opts.timeoutMs) && opts.timeoutMs > 0 ? opts.timeoutMs : 5000;
292
- const retryMs = Number.isFinite(opts.retryMs) && opts.retryMs > 0 ? opts.retryMs : 50;
294
+ const staleMs = typeof opts.staleMs === 'number' && Number.isFinite(opts.staleMs) && opts.staleMs > 0 ? opts.staleMs : 30000;
295
+ const timeoutMs = typeof opts.timeoutMs === 'number' && Number.isFinite(opts.timeoutMs) && opts.timeoutMs > 0 ? opts.timeoutMs : 5000;
296
+ const retryMs = typeof opts.retryMs === 'number' && Number.isFinite(opts.retryMs) && opts.retryMs > 0 ? opts.retryMs : 50;
293
297
  const lock = _acquireLockCore(lockPath, {
294
298
  staleMs,
295
299
  timeoutMs,
@@ -297,12 +301,12 @@ function acquirePathLockSync(filePath, opts = {}) {
297
301
  contention: 'wait',
298
302
  timeoutMsg: `Could not acquire lock on ${filePath} within ${timeoutMs}ms`,
299
303
  });
300
- return { fd: lock.fd, lockPath: lock.lockPath, ownerId: lock.ownerId };
304
+ return { fd: lock.fd, lockPath: lock.lockPath, heartbeat: lock.heartbeat, ownerId: lock.ownerId };
301
305
  }
302
306
  async function acquireFileLock(filePath, opts = {}) {
303
307
  const lockPath = `${filePath}.lock`;
304
- const staleMs = Number.isFinite(opts.staleMs) && opts.staleMs > 0 ? opts.staleMs : 30000;
305
- const timeoutMs = Number.isFinite(opts.timeoutMs) && opts.timeoutMs > 0 ? opts.timeoutMs : 5000;
308
+ const staleMs = typeof opts.staleMs === 'number' && Number.isFinite(opts.staleMs) && opts.staleMs > 0 ? opts.staleMs : 30000;
309
+ const timeoutMs = typeof opts.timeoutMs === 'number' && Number.isFinite(opts.timeoutMs) && opts.timeoutMs > 0 ? opts.timeoutMs : 5000;
306
310
  return _acquireLockCoreAsync(lockPath, {
307
311
  staleMs,
308
312
  timeoutMs,
@@ -1,3 +1,10 @@
1
+ /** Asset identity/precision needed to convert chain amounts. */
2
+ export interface NativeHistoryAssetMeta {
3
+ id?: unknown;
4
+ precision?: number;
5
+ }
6
+ /** Normalized OHLCV candle: [tsMs, open, high, low, close, volume]. */
7
+ export type NativeHistoryCandle = [number, number, number, number, number, number];
1
8
  /**
2
9
  * Native BitShares market history parsing utilities.
3
10
  *
@@ -5,7 +12,7 @@
5
12
  * normalized OHLCV candles. Handles both the compact array format and
6
13
  * the raw object format with key.base / key.quote / open_base / etc.
7
14
  */
8
- declare function parseNativeMarketHistoryTimestamp(entry: any): number | null;
9
- declare function normalizeNativeMarketHistoryCandles(history: any, assetA: any, assetB: any, _intervalSeconds: any): any[];
15
+ declare function parseNativeMarketHistoryTimestamp(entry: unknown): number | null;
16
+ declare function normalizeNativeMarketHistoryCandles(history: unknown, assetA: NativeHistoryAssetMeta, assetB: NativeHistoryAssetMeta): NativeHistoryCandle[];
10
17
  export { parseNativeMarketHistoryTimestamp, normalizeNativeMarketHistoryCandles };
11
18
  //# sourceMappingURL=native_history.d.ts.map
@@ -1,5 +1,6 @@
1
1
  'use strict';
2
2
  import { blockchainToFloat } from '../../modules/order/utils/math.js';
3
+ import { isUnknownRecord } from '../../modules/types.js';
3
4
  /**
4
5
  * Native BitShares market history parsing utilities.
5
6
  *
@@ -8,15 +9,18 @@ import { blockchainToFloat } from '../../modules/order/utils/math.js';
8
9
  * the raw object format with key.base / key.quote / open_base / etc.
9
10
  */
10
11
  function parseNativeMarketHistoryTimestamp(entry) {
12
+ if (!isUnknownRecord(entry))
13
+ return null;
14
+ const historyEntry = entry;
11
15
  const candidates = [
12
- entry?.key?.open,
13
- entry?.key?.time,
14
- entry?.key?.timestamp,
15
- entry?.key?.date,
16
- entry?.open_time,
17
- entry?.time,
18
- entry?.timestamp,
19
- entry?.block_time,
16
+ historyEntry.key?.open,
17
+ historyEntry.key?.time,
18
+ historyEntry.key?.timestamp,
19
+ historyEntry.key?.date,
20
+ historyEntry.open_time,
21
+ historyEntry.time,
22
+ historyEntry.timestamp,
23
+ historyEntry.block_time,
20
24
  ];
21
25
  for (const candidate of candidates) {
22
26
  if (candidate == null)
@@ -75,8 +79,9 @@ function resolveNativeMarketHistoryRatio(entry, field, assetA, assetB) {
75
79
  }
76
80
  const nested = entry?.[field];
77
81
  if (nested && typeof nested === 'object') {
78
- const base = Number(nested.base ?? nested.amount_base ?? nested.base_amount ?? nested.amount);
79
- const quote = Number(nested.quote ?? nested.amount_quote ?? nested.quote_amount ?? nested.value);
82
+ const nestedRecord = nested;
83
+ const base = Number(nestedRecord.base ?? nestedRecord.amount_base ?? nestedRecord.base_amount ?? nestedRecord.amount);
84
+ const quote = Number(nestedRecord.quote ?? nestedRecord.amount_quote ?? nestedRecord.quote_amount ?? nestedRecord.value);
80
85
  if (!Number.isFinite(base) || !Number.isFinite(quote) || base <= 0 || quote <= 0) {
81
86
  return Number.NaN;
82
87
  }
@@ -84,15 +89,16 @@ function resolveNativeMarketHistoryRatio(entry, field, assetA, assetB) {
84
89
  }
85
90
  return Number.NaN;
86
91
  }
87
- function normalizeNativeMarketHistoryCandles(history, assetA, assetB, _intervalSeconds) {
92
+ function normalizeNativeMarketHistoryCandles(history, assetA, assetB) {
93
+ const historyRecord = isUnknownRecord(history) ? history : undefined;
88
94
  const source = Array.isArray(history)
89
95
  ? history
90
- : Array.isArray(history?.buckets)
91
- ? history.buckets
92
- : Array.isArray(history?.history)
93
- ? history.history
94
- : Array.isArray(history?.result)
95
- ? history.result
96
+ : Array.isArray(historyRecord?.buckets)
97
+ ? historyRecord.buckets
98
+ : Array.isArray(historyRecord?.history)
99
+ ? historyRecord.history
100
+ : Array.isArray(historyRecord?.result)
101
+ ? historyRecord.result
96
102
  : [];
97
103
  if (!Array.isArray(source) || source.length === 0)
98
104
  return [];
@@ -117,25 +123,26 @@ function normalizeNativeMarketHistoryCandles(history, assetA, assetB, _intervalS
117
123
  }
118
124
  const candles = [];
119
125
  for (const entry of source) {
120
- if (!entry || typeof entry !== 'object')
126
+ if (!isUnknownRecord(entry))
121
127
  continue;
122
- const tsMs = parseNativeMarketHistoryTimestamp(entry);
123
- if (!Number.isFinite(tsMs))
128
+ const historyEntry = entry;
129
+ const tsMs = parseNativeMarketHistoryTimestamp(historyEntry);
130
+ if (tsMs === null || !Number.isFinite(tsMs))
124
131
  continue;
125
- const keyBase = String(entry?.key?.base || '');
126
- const keyQuote = String(entry?.key?.quote || '');
132
+ const keyBase = String(historyEntry?.key?.base || '');
133
+ const keyQuote = String(historyEntry?.key?.quote || '');
127
134
  const orientation = resolvePairOrientation(keyBase, keyQuote, assetA, assetB);
128
135
  if (!orientation)
129
136
  continue;
130
137
  const { baseIsAssetA, basePrecision, quotePrecision } = orientation;
131
- const baseVolume = Number(entry?.base_volume);
132
- const quoteVolume = Number(entry?.quote_volume);
133
- const open = resolveNativeMarketHistoryRatio(entry, 'open', assetA, assetB);
134
- const resolvedHigh = resolveNativeMarketHistoryRatio(entry, 'high', assetA, assetB);
135
- const resolvedLow = resolveNativeMarketHistoryRatio(entry, 'low', assetA, assetB);
138
+ const baseVolume = Number(historyEntry?.base_volume);
139
+ const quoteVolume = Number(historyEntry?.quote_volume);
140
+ const open = resolveNativeMarketHistoryRatio(historyEntry, 'open', assetA, assetB);
141
+ const resolvedHigh = resolveNativeMarketHistoryRatio(historyEntry, 'high', assetA, assetB);
142
+ const resolvedLow = resolveNativeMarketHistoryRatio(historyEntry, 'low', assetA, assetB);
136
143
  const high = Math.max(resolvedHigh, resolvedLow);
137
144
  const low = Math.min(resolvedHigh, resolvedLow);
138
- const close = resolveNativeMarketHistoryRatio(entry, 'close', assetA, assetB);
145
+ const close = resolveNativeMarketHistoryRatio(historyEntry, 'close', assetA, assetB);
139
146
  if (![open, high, low, close].every((value) => Number.isFinite(value) && value > 0)) {
140
147
  continue;
141
148
  }