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
@@ -45,9 +45,65 @@
45
45
  *
46
46
  * ===============================================================================
47
47
  */
48
+ import type { OrderManagerLike, BotLike, AccountOrdersLike, ManagedOrder, AccountTotals, CowAction } from '../../types.js';
49
+ import type { WorkingGrid as WorkingGridType } from '../working_grid.js';
48
50
  declare const ensureDir: (path: string, options?: {
49
51
  mode?: number;
50
52
  }) => void;
53
+ /** Minimal structural views of the external BitShares client used here. */
54
+ export interface AssetMeta {
55
+ id?: string;
56
+ precision?: number;
57
+ symbol?: string;
58
+ [key: string]: unknown;
59
+ }
60
+ export interface PoolReserve {
61
+ asset_id?: string;
62
+ amount?: number | string;
63
+ [key: string]: unknown;
64
+ }
65
+ export interface PoolEntry {
66
+ id?: string;
67
+ asset_a?: string;
68
+ asset_b?: string;
69
+ asset_ids?: string[];
70
+ balance_a?: number | string;
71
+ balance_b?: number | string;
72
+ reserves?: PoolReserve[];
73
+ [key: string]: unknown;
74
+ }
75
+ export interface BitSharesDb {
76
+ lookup_asset_symbols?: (refs: string[]) => Promise<unknown[]>;
77
+ get_assets?: (refs: string[]) => Promise<unknown[]>;
78
+ get_objects?: (ids: string[]) => Promise<unknown[]>;
79
+ get_order_book?: (base: string, quote: string, depth: number) => Promise<{
80
+ bids?: Array<{
81
+ price?: unknown;
82
+ }>;
83
+ asks?: Array<{
84
+ price?: unknown;
85
+ }>;
86
+ }>;
87
+ get_ticker?: (base: string, quote: string) => Promise<{
88
+ latest?: unknown;
89
+ latest_price?: unknown;
90
+ }>;
91
+ get_liquidity_pools_by_both_assets?: (a: string, b: string) => Promise<PoolEntry[]>;
92
+ get_liquidity_pools_by_share_asset?: (ids: string[], a: boolean, b: boolean) => Promise<PoolEntry[]>;
93
+ list_liquidity_pools?: (pageSize: number, startId: string) => Promise<PoolEntry[]>;
94
+ get_liquidity_pools?: (pageSize: number, startId: string) => Promise<PoolEntry[]>;
95
+ getGlobalProperties?: () => Promise<unknown>;
96
+ call?: (method: string, args: unknown[]) => Promise<unknown>;
97
+ [key: string]: unknown;
98
+ }
99
+ export interface BitSharesAssets {
100
+ [symbol: string]: Promise<unknown> | unknown;
101
+ }
102
+ export interface BitSharesClient {
103
+ db?: BitSharesDb;
104
+ assets?: BitSharesAssets;
105
+ [key: string]: unknown;
106
+ }
51
107
  /**
52
108
  * @private Lookup asset by symbol from BitShares blockchain.
53
109
  * Tries cached assets first, then falls back to lookup API methods.
@@ -57,7 +113,7 @@ declare const ensureDir: (path: string, options?: {
57
113
  * @returns {Promise<Object>} Asset metadata with id, symbol, precision
58
114
  * @throws {Error} If asset cannot be found on blockchain
59
115
  */
60
- export declare const lookupAsset: (BitShares: any, s: string) => Promise<any>;
116
+ export declare const lookupAsset: (BitShares: BitSharesClient, s: string) => Promise<AssetMeta | null>;
61
117
  /**
62
118
  * Resolve a full asset object from an asset reference (object ID like 1.3.x or symbol).
63
119
  * Routes object IDs to get_assets and symbols to lookup_asset_symbols, trying
@@ -68,7 +124,7 @@ export declare const lookupAsset: (BitShares: any, s: string) => Promise<any>;
68
124
  * @param {*} ref - Asset ID (e.g. '1.3.0') or symbol (e.g. 'BTS')
69
125
  * @returns {Promise<Object|null>} Asset object or null if unresolvable
70
126
  */
71
- export declare const resolveAssetByRef: (BitShares: any, ref: any) => Promise<any>;
127
+ export declare const resolveAssetByRef: (BitShares: BitSharesClient, ref: unknown) => Promise<AssetMeta | null>;
72
128
  /**
73
129
  * Derive price from BitShares DEX order book.
74
130
  * Returns price in B/A format (units of asset B per 1 unit of asset A).
@@ -79,7 +135,7 @@ export declare const resolveAssetByRef: (BitShares: any, ref: any) => Promise<an
79
135
  * @param {string} symB - Second asset symbol
80
136
  * @returns {Promise<number|null>} Derived market price or null if unavailable
81
137
  */
82
- export declare const deriveMarketPrice: (BitShares: any, symA: string, symB: string) => Promise<number | null>;
138
+ export declare const deriveMarketPrice: (BitShares: BitSharesClient, symA: string, symB: string) => Promise<number | null>;
83
139
  /**
84
140
  * Derive price from BitShares Liquidity Pool (AMM).
85
141
  * Returns price in B/A format (units of asset B per 1 unit of asset A).
@@ -90,13 +146,13 @@ export declare const deriveMarketPrice: (BitShares: any, symA: string, symB: str
90
146
  * @param {string} symB - Second asset symbol
91
147
  * @returns {Promise<number|null>} Derived pool price or null if unavailable
92
148
  */
93
- export declare const derivePoolPrice: (BitShares: any, symA: string, symB: string) => Promise<number | null>;
149
+ export declare const derivePoolPrice: (BitShares: BitSharesClient, symA: string, symB: string) => Promise<number | null>;
94
150
  /**
95
151
  * Test-only seam: compiled ESM exports cannot be monkey-patched, so tests
96
152
  * install a hook here to short-circuit price derivation (offline runs).
97
153
  */
98
- export declare const setDerivePriceTestHook: (fn: ((...args: any[]) => any) | null) => void;
99
- export declare const derivePrice: (BitShares: any, symA: string, symB: string, mode?: string) => Promise<number | null>;
154
+ export declare const setDerivePriceTestHook: (fn: ((...args: unknown[]) => number | null | Promise<number | null>) | null) => void;
155
+ export declare const derivePrice: (BitShares: BitSharesClient, symA: string, symB: string, mode?: string) => Promise<number | null>;
100
156
  /**
101
157
  * Derive price via bridge assets only (no direct market attempt).
102
158
  * Returns price in B/A format (units of asset B per 1 unit of asset A) as
@@ -110,7 +166,7 @@ export declare const derivePrice: (BitShares: any, symA: string, symB: string, m
110
166
  * @param {string} [mode='auto'] - Price derivation mode passed to derivePrice
111
167
  * @returns {Promise<{rate:number,path:string}|null>} Rate plus 'bridge:<ref>' path, or null
112
168
  */
113
- export declare function derivePriceViaBridges(BitShares: any, symA: string, symB: string, bridges?: string[], mode?: string): Promise<{
169
+ export declare function derivePriceViaBridges(BitShares: BitSharesClient, symA: string, symB: string, bridges?: string[], mode?: string): Promise<{
114
170
  rate: number;
115
171
  path: string;
116
172
  } | null>;
@@ -129,10 +185,19 @@ export declare function derivePriceViaBridges(BitShares: any, symA: string, symB
129
185
  * @param {string} [mode='auto'] - Price derivation mode passed to derivePrice
130
186
  * @returns {Promise<{rate:number,path:string}|null>} Rate plus 'direct' | 'identity' | 'bridge:<ref>' path, or null
131
187
  */
132
- export declare function derivePriceWithBridges(BitShares: any, symA: string, symB: string, bridges?: string[], mode?: string): Promise<{
188
+ export declare function derivePriceWithBridges(BitShares: BitSharesClient, symA: string, symB: string, bridges?: string[], mode?: string): Promise<{
133
189
  rate: number;
134
190
  path: string;
135
191
  } | null>;
192
+ export interface ExtendedAssetMeta extends AssetMeta {
193
+ current_supply?: number | string | {
194
+ amount?: number;
195
+ value?: number;
196
+ };
197
+ dynamic_asset_data_id?: string;
198
+ dynamicDataId?: string;
199
+ dynamic_data_id?: string;
200
+ }
136
201
  /**
137
202
  * Derive the value of a liquidity pool share token in a denomination asset.
138
203
  * Resolves the pool, fetches reserves and supply, then prices both pool assets
@@ -148,7 +213,7 @@ export declare function derivePriceWithBridges(BitShares: any, symA: string, sym
148
213
  * behavior; the credit runtime opts in explicitly.
149
214
  * @returns {Promise<number|null>} Value per share in denomination asset, or null
150
215
  */
151
- export declare function deriveLiquidityPoolTokenValue(BitShares: any, shareAssetRef: string, denominationAssetRef: string, mode?: string, allowBridges?: boolean): Promise<number | null>;
216
+ export declare function deriveLiquidityPoolTokenValue(BitShares: BitSharesClient, shareAssetRef: string, denominationAssetRef: string, mode?: string, allowBridges?: boolean): Promise<number | null>;
152
217
  /**
153
218
  * Load the full dynamic grid snapshot written by market_adapter for a bot.
154
219
  * The snapshot is stored atomically at profiles/orders/<botKey>.dynamicgrid.json
@@ -164,7 +229,22 @@ export declare function deriveLiquidityPoolTokenValue(BitShares: any, shareAsset
164
229
  * @param {string} botKey - Bot key (e.g. "iob-aaa-bbb-0")
165
230
  * @returns {Object|null} Snapshot with center and optional dynamicWeights fields, or null if invalid
166
231
  */
167
- export declare function loadAmaCenterSnapshot(botKey: string): any;
232
+ export interface AmaCenterSnapshot {
233
+ gridCenterPrice: number;
234
+ centerPrice: number;
235
+ amaCenterPrice: number | null;
236
+ source: string | null;
237
+ updatedAt: string | null;
238
+ amaSlopePercentMode: unknown;
239
+ amaSlope: unknown;
240
+ gridRangeScalingAmaSlope: unknown;
241
+ gridPriceOffsetPct: number | null;
242
+ amaSlopeDeltaPercent: number | null;
243
+ amaSlopeThresholdPercent: number | null;
244
+ dynamicWeights: unknown;
245
+ asymmetricBounds: unknown;
246
+ }
247
+ export declare function loadAmaCenterSnapshot(botKey: string): AmaCenterSnapshot | null;
168
248
  /**
169
249
  * Load the AMA grid center price written by market_adapter for a bot.
170
250
  * This is the numeric accessor used by the order engine.
@@ -172,6 +252,56 @@ export declare function loadAmaCenterSnapshot(botKey: string): any;
172
252
  * @returns {number|null} Grid center price in B/A format, or null if file absent/invalid
173
253
  */
174
254
  export declare function loadAmaCenterPrice(botKey: string): number | null;
255
+ export interface AssetOptions {
256
+ flags?: number | string;
257
+ market_fee_percent?: number;
258
+ taker_fee_percent?: number;
259
+ max_market_fee?: number | string;
260
+ }
261
+ export interface FeeCacheEntryData {
262
+ assetId?: string;
263
+ symbol?: string;
264
+ precision?: number;
265
+ chargesMarketFees?: boolean;
266
+ marketFee?: {
267
+ percent: number;
268
+ };
269
+ takerFee?: {
270
+ percent: number;
271
+ } | null;
272
+ maxMarketFee?: {
273
+ raw: number | string;
274
+ float: number;
275
+ };
276
+ limitOrderCreate?: {
277
+ raw: number;
278
+ satoshis: number;
279
+ bts: number;
280
+ };
281
+ limitOrderCancel?: {
282
+ raw: number;
283
+ satoshis: number;
284
+ bts: number;
285
+ };
286
+ limitOrderUpdate?: {
287
+ raw: number;
288
+ satoshis: number;
289
+ bts: number;
290
+ };
291
+ makerFeeDiscountPercent?: number;
292
+ }
293
+ export interface GlobalProps {
294
+ parameters?: {
295
+ current_fees?: {
296
+ parameters?: Array<[number, {
297
+ fee?: number | string;
298
+ }]>;
299
+ };
300
+ extensions?: {
301
+ maker_fee_discount_percent?: number;
302
+ };
303
+ };
304
+ }
175
305
  /**
176
306
  * Initialize fee cache from blockchain.
177
307
  * Fetches BTS operation fees and asset market fees for all unique assets in config.
@@ -182,7 +312,10 @@ export declare function loadAmaCenterPrice(botKey: string): number | null;
182
312
  * @param {Object} BitShares - BitShares client instance
183
313
  * @returns {Promise<Object>} Fee cache object keyed by asset symbol
184
314
  */
185
- export declare function initializeFeeCache(botsConfig: any[], BitShares: any): Promise<Record<string, any>>;
315
+ export declare function initializeFeeCache(botsConfig: Array<{
316
+ assetA?: string;
317
+ assetB?: string;
318
+ }>, BitShares: BitSharesClient): Promise<Record<string, FeeCacheEntryData>>;
186
319
  /**
187
320
  * Persist current grid state to storage.
188
321
  * Saves all orders, cache funds, fees, boundary index, and asset info.
@@ -191,9 +324,9 @@ export declare function initializeFeeCache(botsConfig: any[], BitShares: any): P
191
324
  * @param {Object} accountOrders - AccountOrders data accessor
192
325
  * @returns {Promise<boolean>} True if persistence succeeded, false on error
193
326
  */
194
- export declare function persistGridSnapshot(manager: any, accountOrders: any, snapshotOrders?: any[], recentFillKeys?: Record<string, number>, fundSnapshot?: {
327
+ export declare function persistGridSnapshot(manager: OrderManagerLike, accountOrders: AccountOrdersLike, snapshotOrders?: ManagedOrder[], recentFillKeys?: Record<string, number>, fundSnapshot?: {
195
328
  btsFeesOwed: number;
196
- accountTotals: any;
329
+ accountTotals: AccountTotals | null;
197
330
  }): Promise<boolean>;
198
331
  /**
199
332
  * Restore persisted gap-evacuation streaks into the manager (Phase 3
@@ -208,7 +341,7 @@ export declare function persistGridSnapshot(manager: any, accountOrders: any, sn
208
341
  * @param {Object|null} persisted - {slotId: count} from loadGapEvacStreaks
209
342
  * @returns {number} Number of streak entries restored
210
343
  */
211
- export declare function restoreGapEvacStreaks(manager: any, persisted: any): number;
344
+ export declare function restoreGapEvacStreaks(manager: OrderManagerLike, persisted: unknown): number;
212
345
  /**
213
346
  * Normalize a persisted LAST-FILL-GUARD pivot row (shared by the
214
347
  * AccountOrders sanitizer/loader and the payload builder's row contract).
@@ -220,10 +353,10 @@ export declare function restoreGapEvacStreaks(manager: any, persisted: any): num
220
353
  * - finite fillsAt > 0
221
354
  * - non-empty string genesisHash
222
355
  *
223
- * @param {any} row - Raw candidate row
356
+ * @param {unknown} row - Raw candidate row
224
357
  * @returns {Object|null} Normalized row or null
225
358
  */
226
- export declare function normalizeLastFillPivot(row: any): {
359
+ export declare function normalizeLastFillPivot(row: unknown): {
227
360
  price: number;
228
361
  type: string;
229
362
  fillsAt: number;
@@ -248,7 +381,7 @@ export declare function normalizeLastFillPivot(row: any): {
248
381
  * @param {number} [atMs] - Fill timestamp to preserve (defaults to now)
249
382
  * @returns {boolean} True when the pivot was written
250
383
  */
251
- export declare function setLastFillPivot(manager: any, type: any, price: any, provenance: 'fill' | 'book', atMs?: number): boolean;
384
+ export declare function setLastFillPivot(manager: OrderManagerLike, type: string, price: unknown, provenance: 'fill' | 'book', atMs?: number): boolean;
252
385
  /**
253
386
  * Clear the manager's LAST-FILL-GUARD pivot to cold state — the FULL scalar
254
387
  * family, per-side mirrors included. Clearing only the primary fields would
@@ -267,7 +400,7 @@ export declare function setLastFillPivot(manager: any, type: any, price: any, pr
267
400
  * @param {string} reason - Log/debug label
268
401
  * @returns {boolean} True when an armed pivot was cleared
269
402
  */
270
- export declare function resetLastFillPivot(manager: any, reason?: string): boolean;
403
+ export declare function resetLastFillPivot(manager: OrderManagerLike, reason?: string): boolean;
271
404
  /**
272
405
  * Restore the persisted LAST-FILL-GUARD pivot into the manager.
273
406
  *
@@ -303,9 +436,23 @@ export declare function resetLastFillPivot(manager: any, reason?: string): boole
303
436
  * @param {number} [options.now] - Injectable clock (tests)
304
437
  * @returns {boolean} True when the guard was re-armed from the snapshot
305
438
  */
306
- export declare function restoreLastFillPivot(manager: any, persisted: any, options?: {
439
+ export declare function restoreLastFillPivot(manager: OrderManagerLike, persisted: unknown, options?: {
307
440
  now?: number;
308
441
  }): boolean;
442
+ export interface GridResizeResult {
443
+ workingGrid?: WorkingGridType;
444
+ actions?: CowAction[];
445
+ hasWorkingChanges?: boolean;
446
+ }
447
+ export interface CowResult {
448
+ actions: CowAction[];
449
+ workingGrid: WorkingGridType;
450
+ workingIndexes: unknown;
451
+ workingBoundary: number | null;
452
+ refillSlotIds?: unknown;
453
+ aborted: boolean;
454
+ localOnly?: boolean;
455
+ }
309
456
  /**
310
457
  * Retry grid persistence if previous attempt failed.
311
458
  * Clears persistence warning flag if successful.
@@ -313,7 +460,7 @@ export declare function restoreLastFillPivot(manager: any, persisted: any, optio
313
460
  * @param {Object} manager - OrderManager instance
314
461
  * @returns {Promise<boolean>} True if persisted successfully or no warning, false on error
315
462
  */
316
- export declare function retryPersistenceIfNeeded(manager: any): Promise<boolean>;
463
+ export declare function retryPersistenceIfNeeded(manager: OrderManagerLike): Promise<boolean>;
317
464
  /**
318
465
  * Apply grid corrections for divergence between calculated and active orders.
319
466
  * Uses COW (Copy-on-Write): builds a working grid, plans updates/cancels/creates,
@@ -329,7 +476,10 @@ export declare function retryPersistenceIfNeeded(manager: any): Promise<boolean>
329
476
  * @param {Function} updateGridFromBlockchainSnapshotFn - Grid resize function (injected to avoid circular dependency with grid.ts)
330
477
  * @returns {Promise<void>}
331
478
  */
332
- export declare function applyGridDivergenceCorrections(manager: any, accountOrders: any, _botKey: string, updateOrdersOnChainBatchFn: Function, updateGridFromBlockchainSnapshotFn: Function): Promise<{
479
+ export declare function applyGridDivergenceCorrections(manager: OrderManagerLike, accountOrders: AccountOrdersLike, _botKey: string, updateOrdersOnChainBatchFn: (cowResult: unknown) => Promise<{
480
+ executed?: boolean;
481
+ reason?: string;
482
+ } | null | undefined>, updateGridFromBlockchainSnapshotFn: (manager: OrderManagerLike, orderType: string, force: boolean, pendingBoundaryIdx: number | null) => Promise<GridResizeResult | undefined>): Promise<{
333
483
  committed: boolean;
334
484
  reason?: string;
335
485
  } | undefined>;
@@ -438,13 +588,13 @@ export declare function withBlockchainRetry<T>(fn: () => Promise<T>, label: stri
438
588
  * @param {string} account - Account name (optional)
439
589
  * @returns {string|null} Resolved account reference or null
440
590
  */
441
- export declare function resolveAccountRef(manager: any, account: string): string | null;
591
+ export declare function resolveAccountRef(manager: OrderManagerLike, account: string): string | null;
442
592
  /**
443
593
  * Recursively freezes an object to ensure immutability.
444
594
  * @param {Object} obj
445
595
  * @returns {Object}
446
596
  */
447
- export declare function deepFreeze(obj: any): any;
597
+ export declare function deepFreeze<T>(obj: T): T;
448
598
  /**
449
599
  * Creates a shallow clone of a Map.
450
600
  * @param {Map} map
@@ -457,7 +607,7 @@ export declare function cloneMap<K, V>(map: Map<K, V>): Map<K, V>;
457
607
  * @param {string} raw - The raw string content with possible comments.
458
608
  * @returns {Object} The parsed JSON object.
459
609
  */
460
- export declare function parseJsonWithComments(raw: string): any;
610
+ export declare function parseJsonWithComments(raw: string): Record<string, unknown>;
461
611
  export { ensureDir };
462
612
  /**
463
613
  * Apply persisted-but-uncommitted fill crawls onto the restored boundary.
@@ -485,8 +635,8 @@ export { ensureDir };
485
635
  * freshly-constructed store)
486
636
  * @returns {Promise<{applied: boolean, from?: number, to?: number, count?: number, reason?: string}>}
487
637
  */
488
- export declare function applyPersistedPendingCrawls(bot: any, options?: {
489
- log?: (message: string, level?: any) => void;
638
+ export declare function applyPersistedPendingCrawls(bot: BotLike, options?: {
639
+ log?: (message: string, level?: string) => void;
490
640
  forceReload?: boolean;
491
641
  }): Promise<{
492
642
  applied: boolean;