dexbot 1.6.11 → 1.6.13

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 (398) hide show
  1. package/CHANGELOG.md +67 -4
  2. package/README.md +2 -1
  3. package/analysis/README.md +11 -11
  4. package/analysis/ama_fitting/README.md +5 -3
  5. package/analysis/tradingview/README.md +1 -1
  6. package/analysis/trend_detection/DYNAMIC_WEIGHT_RESEARCH.md +3 -3
  7. package/claw/README.md +1 -0
  8. package/claw/docs/AI_BOT_LIBRARY_API.md +2 -0
  9. package/claw/docs/DEXBOT2_TUNING_CHEAT_SHEET.md +4 -3
  10. package/claw/modules/chain_broadcast.ts +7 -1
  11. package/claw/modules/claw_bridge.ts +0 -3
  12. package/claw/modules/claw_launcher.ts +1 -1
  13. package/claw/modules/claw_skill_md.ts +1 -0
  14. package/claw/modules/launcher_mode_detector.ts +9 -2
  15. package/claw/package.json +3 -3
  16. package/claw/runtimes/openclaw-plugin/openclaw.plugin.json +1 -1
  17. package/claw/runtimes/openclaw-plugin/package.json +1 -1
  18. package/claw/tsconfig.json +2 -2
  19. package/dist/analysis/account_resolver.d.ts +1 -1
  20. package/dist/analysis/account_resolver.js +2 -1
  21. package/dist/analysis/ama_fitting/analyze_ama_price_changes.js +3 -4
  22. package/dist/analysis/ama_fitting/analyze_lambda_vs_slow.js +3 -21
  23. package/dist/analysis/ama_fitting/calibrate_convergence_er.js +0 -1
  24. package/dist/analysis/ama_fitting/fetch_lp_candles.js +55 -45
  25. package/dist/analysis/ama_fitting/generate_unified_comparison_chart.d.ts +1 -8
  26. package/dist/analysis/ama_fitting/generate_unified_comparison_chart.js +45 -24
  27. package/dist/analysis/ama_fitting/optimizer_high_resolution.js +34 -78
  28. package/dist/analysis/analyze_args.d.ts +43 -0
  29. package/dist/analysis/analyze_args.js +61 -0
  30. package/dist/analysis/analyze_dynamic_weight.js +7 -17
  31. package/dist/analysis/analyze_kalman.js +7 -17
  32. package/dist/analysis/analyze_regime.js +7 -17
  33. package/dist/analysis/analyze_regime_windows.js +8 -18
  34. package/dist/analysis/analyze_risk_profile.js +8 -18
  35. package/dist/analysis/analyze_trade_heatmap.js +7 -17
  36. package/dist/analysis/analyze_volatility.js +7 -17
  37. package/dist/analysis/bot_fitting/backtest_ama_sweep.d.ts +221 -28
  38. package/dist/analysis/bot_fitting/backtest_ama_sweep.js +23 -103
  39. package/dist/analysis/bot_fitting/backtest_bot_fitting.d.ts +34 -4
  40. package/dist/analysis/bot_fitting/backtest_bot_fitting.js +32 -150
  41. package/dist/analysis/bot_fitting/backtest_lookback_drawdown.js +19 -34
  42. package/dist/analysis/bot_fitting/shared_utils.d.ts +77 -9
  43. package/dist/analysis/bot_fitting/shared_utils.js +125 -9
  44. package/dist/analysis/bot_key_utils.d.ts +18 -10
  45. package/dist/analysis/bot_key_utils.js +7 -4
  46. package/dist/analysis/bot_usage/discover_bot_accounts.js +44 -47
  47. package/dist/analysis/bot_usage/kibana_bot_queries.d.ts +1 -21
  48. package/dist/analysis/chain_pool.d.ts +3 -1
  49. package/dist/analysis/chart_ui.d.ts +35 -3
  50. package/dist/analysis/chart_ui.js +43 -4
  51. package/dist/analysis/chart_utils.d.ts +5 -5
  52. package/dist/analysis/chart_utils.js +9 -0
  53. package/dist/analysis/fills_cache.d.ts +4 -24
  54. package/dist/analysis/fills_cache.js +3 -84
  55. package/dist/analysis/fills_source.d.ts +33 -3
  56. package/dist/analysis/fills_source.js +83 -13
  57. package/dist/analysis/grid_correction_check.d.ts +2 -24
  58. package/dist/analysis/grid_correction_check.js +27 -69
  59. package/dist/analysis/math_utils.d.ts +91 -6
  60. package/dist/analysis/math_utils.js +119 -7
  61. package/dist/analysis/pnl_report.js +29 -29
  62. package/dist/analysis/price_sources.d.ts +30 -9
  63. package/dist/analysis/price_sources.js +28 -4
  64. package/dist/analysis/resolve_bot_accounts.js +2 -2
  65. package/dist/analysis/resolve_source.d.ts +1 -1
  66. package/dist/analysis/resolve_source.js +31 -10
  67. package/dist/analysis/trade_profitability.d.ts +29 -2
  68. package/dist/analysis/trade_profitability.js +73 -147
  69. package/dist/analysis/tradingview/analyze_tradingview.d.ts +3 -8
  70. package/dist/analysis/tradingview/analyze_tradingview.js +7 -6
  71. package/dist/analysis/tradingview/grid_reset_config.d.ts +41 -32
  72. package/dist/analysis/tradingview/grid_reset_config.js +23 -11
  73. package/dist/analysis/tradingview/grid_reset_sim.d.ts +75 -9
  74. package/dist/analysis/tradingview/grid_reset_sim.js +4 -3
  75. package/dist/analysis/tradingview/tradingview_uplot_chart_generator.d.ts +69 -4
  76. package/dist/analysis/tradingview/tradingview_uplot_chart_generator.js +20 -34
  77. package/dist/analysis/trend_detection/backtest_ama_slope_huber.d.ts +1 -101
  78. package/dist/analysis/trend_detection/backtest_ama_slope_huber.js +26 -84
  79. package/dist/analysis/trend_detection/dynamic_weight_chart_generator.d.ts +63 -1
  80. package/dist/analysis/trend_detection/dynamic_weight_chart_generator.js +16 -41
  81. package/dist/analysis/trend_detection/huber_scale_variants.d.ts +9 -3
  82. package/dist/analysis/trend_detection/huber_scale_variants.js +4 -4
  83. package/dist/analysis/trend_detection/kalman_chart_generator.d.ts +30 -1
  84. package/dist/analysis/trend_detection/kalman_chart_generator.js +3 -3
  85. package/dist/analysis/trend_detection/regime_chart_generator.d.ts +31 -1
  86. package/dist/analysis/trend_detection/regime_chart_generator.js +2 -2
  87. package/dist/analysis/trend_detection/volatility_chart_generator.d.ts +33 -1
  88. package/dist/analysis/trend_detection/volatility_chart_generator.js +9 -10
  89. package/dist/analysis/worker_pool.d.ts +38 -0
  90. package/dist/analysis/worker_pool.js +67 -0
  91. package/dist/credential-daemon.js +34 -20
  92. package/dist/dexbot.js +78 -59
  93. package/dist/market_adapter/ama_signal_runner.js +21 -54
  94. package/dist/market_adapter/candle_utils.d.ts +29 -19
  95. package/dist/market_adapter/candle_utils.js +35 -21
  96. package/dist/market_adapter/cli_args.d.ts +22 -0
  97. package/dist/market_adapter/cli_args.js +30 -0
  98. package/dist/market_adapter/core/asymmetric_bounds.d.ts +13 -4
  99. package/dist/market_adapter/core/config_normalizers.d.ts +3 -3
  100. package/dist/market_adapter/core/config_normalizers.js +11 -6
  101. package/dist/market_adapter/core/kibana_candles.d.ts +56 -19
  102. package/dist/market_adapter/core/kibana_candles.js +12 -9
  103. package/dist/market_adapter/core/kibana_client.d.ts +9 -1
  104. package/dist/market_adapter/core/kibana_client.js +8 -7
  105. package/dist/market_adapter/core/kibana_market_candles.d.ts +3 -2
  106. package/dist/market_adapter/core/market_adapter_service.d.ts +320 -153
  107. package/dist/market_adapter/core/market_adapter_service.js +228 -269
  108. package/dist/market_adapter/core/signals/hurst_analyzer.d.ts +1 -6
  109. package/dist/market_adapter/core/signals/hurst_analyzer.js +1 -1
  110. package/dist/market_adapter/core/signals/permutation_entropy_analyzer.d.ts +1 -11
  111. package/dist/market_adapter/core/signals/permutation_entropy_analyzer.js +1 -1
  112. package/dist/market_adapter/core/strategies/ama.d.ts +10 -2
  113. package/dist/market_adapter/core/strategies/ama.js +2 -4
  114. package/dist/market_adapter/core/strategies/ama_slope_model.d.ts +14 -1
  115. package/dist/market_adapter/core/strategies/ama_slope_model.js +12 -34
  116. package/dist/market_adapter/core/strategies/atr/calculator.d.ts +7 -2
  117. package/dist/market_adapter/core/strategies/atr/calculator.js +2 -34
  118. package/dist/market_adapter/core/strategies/collateral_manager.d.ts +7 -1
  119. package/dist/market_adapter/core/strategies/collateral_manager.js +0 -22
  120. package/dist/market_adapter/core/strategies/dynamic_weight_series.d.ts +34 -6
  121. package/dist/market_adapter/core/strategies/dynamic_weight_series.js +7 -7
  122. package/dist/market_adapter/core/strategies/regime_gate.d.ts +24 -15
  123. package/dist/market_adapter/core/strategies/regime_gate.js +4 -31
  124. package/dist/market_adapter/core/strategies/regime_interp.d.ts +7 -1
  125. package/dist/market_adapter/core/strategies/regime_interp.js +14 -22
  126. package/dist/market_adapter/core/strategies/volatility_shift.d.ts +11 -1
  127. package/dist/market_adapter/core/strategies/volatility_shift.js +0 -13
  128. package/dist/market_adapter/inputs/cex_candle_parsing.d.ts +29 -0
  129. package/dist/market_adapter/inputs/cex_candle_parsing.js +52 -0
  130. package/dist/market_adapter/inputs/fetch_book_data.d.ts +20 -4
  131. package/dist/market_adapter/inputs/fetch_book_data.js +3 -2
  132. package/dist/market_adapter/inputs/fetch_cex_synthetic_data.js +160 -332
  133. package/dist/market_adapter/inputs/fetch_lp_data.d.ts +50 -8
  134. package/dist/market_adapter/inputs/fetch_lp_data.js +47 -22
  135. package/dist/market_adapter/inputs/kibana_feed_source.d.ts +74 -15
  136. package/dist/market_adapter/inputs/kibana_feed_source.js +26 -41
  137. package/dist/market_adapter/inputs/kibana_source.d.ts +25 -3
  138. package/dist/market_adapter/inputs/kibana_source.js +2 -2
  139. package/dist/market_adapter/inputs/window_cache.d.ts +93 -156
  140. package/dist/market_adapter/inputs/window_cache.js +59 -184
  141. package/dist/market_adapter/interval_utils.d.ts +15 -5
  142. package/dist/market_adapter/interval_utils.js +16 -1
  143. package/dist/market_adapter/log_format.d.ts +6 -6
  144. package/dist/market_adapter/log_format.js +28 -21
  145. package/dist/market_adapter/lp_chart_core.d.ts +22 -1
  146. package/dist/market_adapter/lp_chart_core.js +26 -192
  147. package/dist/market_adapter/lp_chart_runner.d.ts +10 -7
  148. package/dist/market_adapter/lp_chart_runner.js +37 -19
  149. package/dist/market_adapter/lp_chart_strategy_loader.d.ts +41 -6
  150. package/dist/market_adapter/lp_chart_strategy_loader.js +8 -7
  151. package/dist/market_adapter/market_adapter.d.ts +94 -32
  152. package/dist/market_adapter/market_adapter.js +94 -120
  153. package/dist/market_adapter/utils/adapter_client.d.ts +3 -3
  154. package/dist/market_adapter/utils/adapter_client.js +2 -2
  155. package/dist/market_adapter/utils/atomic_write.d.ts +8 -1
  156. package/dist/market_adapter/utils/chain.d.ts +50 -41
  157. package/dist/market_adapter/utils/chain.js +40 -46
  158. package/dist/market_adapter/utils/data_discovery.d.ts +49 -2
  159. package/dist/market_adapter/utils/data_discovery.js +220 -27
  160. package/dist/market_adapter/utils/dynamic_grid_snapshot.d.ts +12 -3
  161. package/dist/market_adapter/utils/file_json_cache.d.ts +2 -2
  162. package/dist/market_adapter/utils/file_lock.d.ts +28 -14
  163. package/dist/market_adapter/utils/file_lock.js +36 -32
  164. package/dist/market_adapter/utils/month_shards.d.ts +84 -0
  165. package/dist/market_adapter/utils/month_shards.js +237 -0
  166. package/dist/market_adapter/utils/native_history.d.ts +9 -2
  167. package/dist/market_adapter/utils/native_history.js +35 -28
  168. package/dist/modules/account_bots.d.ts +578 -21
  169. package/dist/modules/account_bots.js +272 -267
  170. package/dist/modules/account_orders.d.ts +79 -30
  171. package/dist/modules/account_orders.js +60 -64
  172. package/dist/modules/authority_resolver.d.ts +12 -2
  173. package/dist/modules/authority_resolver.js +15 -8
  174. package/dist/modules/bitshares-native/chain_client.d.ts +39 -4
  175. package/dist/modules/bitshares-native/chain_client.js +59 -59
  176. package/dist/modules/bitshares-native/crypto/ecc.browser.js +11 -171
  177. package/dist/modules/bitshares-native/crypto/ecc.js +13 -176
  178. package/dist/modules/bitshares-native/crypto/ecc_core.d.ts +33 -0
  179. package/dist/modules/bitshares-native/crypto/ecc_core.js +213 -0
  180. package/dist/modules/bitshares-native/crypto/ecc_selector.d.ts +2 -1
  181. package/dist/modules/bitshares-native/crypto/ecc_selector.js +1 -13
  182. package/dist/modules/bitshares-native/index.d.ts +1 -1
  183. package/dist/modules/bitshares-native/lru_cache.d.ts +7 -7
  184. package/dist/modules/bitshares-native/resolvers.d.ts +18 -6
  185. package/dist/modules/bitshares-native/resolvers.js +22 -25
  186. package/dist/modules/bitshares-native/serial/lazy_buffer.d.ts +4 -0
  187. package/dist/modules/bitshares-native/serial/lazy_buffer.js +21 -0
  188. package/dist/modules/bitshares-native/serial/operations.d.ts +1 -1
  189. package/dist/modules/bitshares-native/serial/serializer.d.ts +16 -12
  190. package/dist/modules/bitshares-native/serial/serializer.js +7 -13
  191. package/dist/modules/bitshares-native/serial/types.d.ts +25 -16
  192. package/dist/modules/bitshares-native/serial/types.js +73 -108
  193. package/dist/modules/bitshares-native/signing_client.d.ts +32 -2
  194. package/dist/modules/bitshares-native/signing_client.js +19 -14
  195. package/dist/modules/bitshares-native/subscriptions.d.ts +81 -1
  196. package/dist/modules/bitshares-native/subscriptions.js +12 -12
  197. package/dist/modules/bitshares-native/transport.d.ts +5 -4
  198. package/dist/modules/bitshares-native/transport.js +5 -4
  199. package/dist/modules/bitshares-native/tx/builder.d.ts +40 -5
  200. package/dist/modules/bitshares-native/tx/builder.js +4 -3
  201. package/dist/modules/bitshares-native/tx/tx_cache.d.ts +4 -4
  202. package/dist/modules/bitshares_client.d.ts +45 -13
  203. package/dist/modules/bitshares_client.js +28 -19
  204. package/dist/modules/bot_defaults.d.ts +8 -16
  205. package/dist/modules/bot_defaults.js +1 -5
  206. package/dist/modules/bot_settings.d.ts +44 -10
  207. package/dist/modules/bot_settings.js +11 -8
  208. package/dist/modules/bots_file_lock.d.ts +6 -6
  209. package/dist/modules/bots_file_lock.js +16 -12
  210. package/dist/modules/broadcast_failure.d.ts +4 -3
  211. package/dist/modules/broadcast_failure.js +5 -4
  212. package/dist/modules/chain_keys.d.ts +42 -40
  213. package/dist/modules/chain_keys.js +53 -45
  214. package/dist/modules/chain_orders.d.ts +94 -60
  215. package/dist/modules/chain_orders.js +81 -118
  216. package/dist/modules/cli_start_onboarding.d.ts +2 -1
  217. package/dist/modules/constants.d.ts +534 -32
  218. package/dist/modules/constants.js +35 -48
  219. package/dist/modules/cr_planner.d.ts +41 -3
  220. package/dist/modules/cr_planner.js +1 -5
  221. package/dist/modules/credential_policy.d.ts +68 -8
  222. package/dist/modules/credential_policy.js +37 -31
  223. package/dist/modules/credential_session_cache.d.ts +2 -2
  224. package/dist/modules/credit_pricing.d.ts +43 -6
  225. package/dist/modules/credit_pricing.js +70 -60
  226. package/dist/modules/credit_runtime.d.ts +283 -118
  227. package/dist/modules/credit_runtime.js +500 -231
  228. package/dist/modules/crypto/browser_provider.js +6 -4
  229. package/dist/modules/crypto/node_provider.js +1 -1
  230. package/dist/modules/crypto/pure_scrypt.js +35 -4
  231. package/dist/modules/crypto/pure_secp256k1.js +72 -26
  232. package/dist/modules/crypto/sync.d.ts +9 -9
  233. package/dist/modules/crypto/sync.js +16 -9
  234. package/dist/modules/daemon_node_health.d.ts +4 -3
  235. package/dist/modules/dexbot_class.d.ts +213 -146
  236. package/dist/modules/dexbot_class.js +183 -86
  237. package/dist/modules/dexbot_cow_runtime.d.ts +160 -87
  238. package/dist/modules/dexbot_cow_runtime.js +302 -234
  239. package/dist/modules/dexbot_credential_client.d.ts +19 -18
  240. package/dist/modules/dexbot_credential_client.js +1 -2
  241. package/dist/modules/dexbot_fill_runtime.d.ts +63 -49
  242. package/dist/modules/dexbot_fill_runtime.js +53 -47
  243. package/dist/modules/dexbot_maintenance_runtime.d.ts +127 -71
  244. package/dist/modules/dexbot_maintenance_runtime.js +187 -147
  245. package/dist/modules/dexbot_startup_runtime.d.ts +11 -11
  246. package/dist/modules/dexbot_startup_runtime.js +56 -57
  247. package/dist/modules/dexbot_state_recovery.d.ts +13 -12
  248. package/dist/modules/dexbot_state_recovery.js +18 -13
  249. package/dist/modules/fund_registry.d.ts +4 -2
  250. package/dist/modules/fund_registry.js +10 -10
  251. package/dist/modules/general_settings.d.ts +30 -4
  252. package/dist/modules/graceful_shutdown.d.ts +3 -3
  253. package/dist/modules/graceful_shutdown.js +19 -13
  254. package/dist/modules/grid_price_source.d.ts +1 -1
  255. package/dist/modules/key_store.d.ts +14 -8
  256. package/dist/modules/key_store.js +7 -7
  257. package/dist/modules/launcher/adapter_requirement.d.ts +11 -5
  258. package/dist/modules/launcher/adapter_requirement.js +5 -5
  259. package/dist/modules/launcher/bot_supervisor.d.ts +106 -24
  260. package/dist/modules/launcher/bot_supervisor.js +12 -11
  261. package/dist/modules/launcher/credential_bootstrap.d.ts +1 -1
  262. package/dist/modules/launcher/credential_bootstrap.js +1 -1
  263. package/dist/modules/launcher/credential_daemon.d.ts +4 -4
  264. package/dist/modules/launcher/credential_daemon.js +2 -2
  265. package/dist/modules/launcher/credential_secret.d.ts +1 -1
  266. package/dist/modules/launcher/foreign_cred_daemon.d.ts +2 -2
  267. package/dist/modules/launcher/market_adapter_runtime.d.ts +61 -6
  268. package/dist/modules/launcher/market_adapter_watchdog.d.ts +10 -2
  269. package/dist/modules/launcher/market_adapter_watchdog.js +4 -0
  270. package/dist/modules/launcher/monolithic_runtime.d.ts +18 -16
  271. package/dist/modules/launcher/status_reporting.d.ts +22 -14
  272. package/dist/modules/launcher/supervisor_control.d.ts +8 -1
  273. package/dist/modules/launcher/supervisor_control.js +4 -2
  274. package/dist/modules/lazy_shim.d.ts +11 -0
  275. package/dist/modules/lazy_shim.js +16 -0
  276. package/dist/modules/market_adapter_whitelist.d.ts +9 -3
  277. package/dist/modules/market_adapter_whitelist.js +15 -3
  278. package/dist/modules/node_connect_policy.d.ts +3 -2
  279. package/dist/modules/node_failure_ledger.d.ts +6 -5
  280. package/dist/modules/node_manager.d.ts +41 -11
  281. package/dist/modules/node_manager.js +5 -4
  282. package/dist/modules/order/accounting.d.ts +53 -24
  283. package/dist/modules/order/accounting.js +16 -15
  284. package/dist/modules/order/async_lock.d.ts +5 -2
  285. package/dist/modules/order/async_lock.js +1 -1
  286. package/dist/modules/order/export.d.ts +7 -6
  287. package/dist/modules/order/export.js +1 -7
  288. package/dist/modules/order/format.d.ts +16 -7
  289. package/dist/modules/order/format.js +15 -3
  290. package/dist/modules/order/genesis_policy.d.ts +24 -21
  291. package/dist/modules/order/genesis_policy.js +17 -10
  292. package/dist/modules/order/grid.d.ts +144 -36
  293. package/dist/modules/order/grid.js +226 -145
  294. package/dist/modules/order/grid_reconcile.d.ts +21 -20
  295. package/dist/modules/order/grid_reconcile.js +13 -12
  296. package/dist/modules/order/grid_reconcile_internal.d.ts +85 -72
  297. package/dist/modules/order/grid_reconcile_internal.js +28 -19
  298. package/dist/modules/order/index.d.ts +264 -1
  299. package/dist/modules/order/logger.d.ts +46 -19
  300. package/dist/modules/order/logger.js +38 -49
  301. package/dist/modules/order/logger_state.d.ts +4 -4
  302. package/dist/modules/order/manager.d.ts +232 -191
  303. package/dist/modules/order/manager.js +110 -130
  304. package/dist/modules/order/processed_fill_store.d.ts +18 -3
  305. package/dist/modules/order/processed_fill_store.js +16 -27
  306. package/dist/modules/order/strategy.d.ts +21 -13
  307. package/dist/modules/order/strategy.js +5 -6
  308. package/dist/modules/order/sync_engine.d.ts +91 -33
  309. package/dist/modules/order/sync_engine.js +84 -53
  310. package/dist/modules/order/utils/math.d.ts +157 -102
  311. package/dist/modules/order/utils/math.js +77 -38
  312. package/dist/modules/order/utils/order.d.ts +310 -110
  313. package/dist/modules/order/utils/order.js +153 -126
  314. package/dist/modules/order/utils/slot.d.ts +1 -1
  315. package/dist/modules/order/utils/system.d.ts +156 -26
  316. package/dist/modules/order/utils/system.js +103 -71
  317. package/dist/modules/order/utils/validate.d.ts +89 -41
  318. package/dist/modules/order/utils/validate.js +26 -24
  319. package/dist/modules/order/utils/withPoolRef.d.ts +6 -4
  320. package/dist/modules/order/utils/withPoolRef.js +18 -12
  321. package/dist/modules/order/working_grid.d.ts +14 -13
  322. package/dist/modules/paths.d.ts +1 -4
  323. package/dist/modules/paths.js +33 -61
  324. package/dist/modules/process_discovery.d.ts +1 -1
  325. package/dist/modules/process_discovery.js +2 -1
  326. package/dist/modules/runtime.d.ts +7 -3
  327. package/dist/modules/runtime.js +4 -3
  328. package/dist/modules/runtime_settings.d.ts +14 -11
  329. package/dist/modules/runtime_settings.js +30 -24
  330. package/dist/modules/settings_merge.d.ts +29 -3
  331. package/dist/modules/settings_merge.js +56 -78
  332. package/dist/modules/socket_json_client.d.ts +9 -5
  333. package/dist/modules/storage/browser_adapter.d.ts +38 -53
  334. package/dist/modules/storage/browser_adapter.js +7 -30
  335. package/dist/modules/storage/index.d.ts +1 -1
  336. package/dist/modules/storage/node_adapter.d.ts +45 -27
  337. package/dist/modules/storage/node_adapter.js +9 -9
  338. package/dist/modules/storage/types.d.ts +5 -4
  339. package/dist/modules/types.d.ts +1090 -6
  340. package/dist/modules/types.js +4 -1
  341. package/dist/modules/utils/asset_symbols.d.ts +2 -1
  342. package/dist/modules/utils/asset_symbols.js +2 -1
  343. package/dist/modules/utils/errors.d.ts +9 -0
  344. package/dist/modules/utils/errors.js +24 -4
  345. package/dist/modules/utils/time_range.d.ts +1 -12
  346. package/dist/modules/utils/time_range.js +1 -1
  347. package/dist/modules/validate_profiles.js +53 -43
  348. package/dist/modules/version_notice.d.ts +23 -11
  349. package/dist/modules/version_notice.js +6 -4
  350. package/dist/pm2.d.ts +28 -27
  351. package/dist/pm2.js +61 -40
  352. package/dist/scripts/analyze-credit.d.ts +2 -1
  353. package/dist/scripts/analyze-credit.js +23 -24
  354. package/dist/scripts/analyze-git.js +2 -15
  355. package/dist/scripts/analyze-orders.d.ts +77 -9
  356. package/dist/scripts/analyze-orders.js +65 -40
  357. package/dist/scripts/chart_command.d.ts +27 -18
  358. package/dist/scripts/chart_command.js +15 -13
  359. package/dist/scripts/check_any.d.ts +22 -0
  360. package/dist/scripts/check_any.js +158 -0
  361. package/dist/scripts/diagnose-pool-history.js +13 -13
  362. package/dist/scripts/print_grid.js +0 -1
  363. package/dist/scripts/run-tests.js +39 -8
  364. package/dist/scripts/runner.js +1 -1
  365. package/dist/scripts/sync-version.js +0 -10
  366. package/dist/scripts/test-credit-renewal.js +30 -21
  367. package/dist/scripts/update.d.ts +10 -5
  368. package/dist/scripts/update.js +168 -103
  369. package/dist/scripts/update_dist_freshness.js +1 -0
  370. package/dist/scripts/update_layout.d.ts +61 -0
  371. package/dist/scripts/update_layout.js +180 -0
  372. package/dist/scripts/validate_bots.js +2 -1
  373. package/dist/scripts/verify-browser-bundle.js +8 -0
  374. package/dist/unlock.d.ts +28 -3
  375. package/dist/unlock.js +63 -35
  376. package/docs/BITSHARES_ONBOARDING.md +10 -12
  377. package/docs/COPY_ON_WRITE_MASTER_PLAN.md +2 -2
  378. package/docs/COW_INVARIANTS.md +13 -6
  379. package/docs/DEXBOT_COMPARISON.md +8 -8
  380. package/docs/EVOLUTION.md +10 -8
  381. package/docs/FUND_MOVEMENT_AND_ACCOUNTING.md +5 -5
  382. package/docs/GRID_RECALCULATION.md +4 -2
  383. package/docs/GRID_RECONCILE.md +14 -3
  384. package/docs/LIFECYCLE.md +11 -11
  385. package/docs/MPA_CREDIT_USAGE.md +22 -3
  386. package/docs/README.md +14 -3
  387. package/docs/WORKFLOW.md +1 -0
  388. package/docs/architecture.md +31 -19
  389. package/docs/developer_guide.md +6 -6
  390. package/market_adapter/README.md +12 -5
  391. package/modules/README.md +4 -1
  392. package/package.json +9 -9
  393. package/scripts/README.md +43 -38
  394. package/tests/README.md +25 -10
  395. package/dist/scripts/diagnose-kibana-candles.d.ts +0 -3
  396. package/dist/scripts/diagnose-kibana-candles.js +0 -82
  397. package/scripts/git-viewer.sh +0 -489
  398. package/scripts/postinstall.js +0 -16
@@ -1,29 +1,5 @@
1
1
  'use strict';
2
- /**
3
- * modules/credit_pricing.ts — Canonical credit-pricing math (single source of truth).
4
- *
5
- * Pure functions only: no imports, no I/O, browser-safe. Both the live
6
- * credit runtime (modules/credit_runtime.ts) and the offline analyzer
7
- * (scripts/analyze-credit.ts) delegate to these helpers so offer-price
8
- * orientation, conversion rates, and collateral-ratio math cannot drift
9
- * apart between surfaces.
10
- *
11
- * Conventions (mirror the chain's credit_offer_object price layout):
12
- * - A 'core' price has base == debt asset / quote == collateral asset and
13
- * the conversion rate (debt per 1 collateral) is base / quote.
14
- * - A 'legacy-reversed' price has base == collateral / quote == debt and
15
- * the rate is quote / base. Unknown layouts default to 'core'.
16
- * - Credit CR = collateralValueInDebt / debtAmount, where
17
- * collateralValueInDebt = collateralAmount * conversionRate.
18
- */
19
- function toFiniteOrNull(value) {
20
- const num = typeof value === 'string' && value.trim() !== '' ? Number(value) : Number(value);
21
- return Number.isFinite(num) ? num : null;
22
- }
23
- function positiveOrNull(value) {
24
- const num = toFiniteOrNull(value);
25
- return num !== null && num > 0 ? num : null;
26
- }
2
+ import { positiveOrNull, toFiniteNumber } from './order/format.js';
27
3
  /**
28
4
  * Tolerantly normalize an offer's acceptable_collateral map, which arrives
29
5
  * in different shapes depending on the API path (Map, [[id, price]] pairs,
@@ -43,8 +19,10 @@ function normalizeCollateralMap(raw) {
43
19
  if (Array.isArray(entry) && entry.length >= 2 && entry[0] && entry[1]) {
44
20
  out.set(String(entry[0]), entry[1]);
45
21
  }
46
- else if (entry && typeof entry === 'object' && entry.key && entry.value) {
47
- out.set(String(entry.key), entry.value);
22
+ else if (entry && typeof entry === 'object') {
23
+ const pair = entry;
24
+ if (pair.key && pair.value)
25
+ out.set(String(pair.key), pair.value);
48
26
  }
49
27
  }
50
28
  return out;
@@ -67,7 +45,7 @@ function creditPriceOrientation(baseAssetId, quoteAssetId, debtAssetId, collater
67
45
  return 'core';
68
46
  }
69
47
  function priceLegToFloat(leg, precision) {
70
- const raw = toFiniteOrNull(leg?.amount);
48
+ const raw = toFiniteNumber(leg?.amount, null);
71
49
  if (raw === null || raw <= 0 || precision === null || !Number.isFinite(precision) || precision < 0) {
72
50
  return null;
73
51
  }
@@ -120,8 +98,8 @@ function asOfferPrice(collateralPriceOrMap, collateralAssetId) {
120
98
  * Pure offer-math leg of the runtime's pool-aware valuation.
121
99
  */
122
100
  function collateralValueFromOfferPrice(collateralAmountInt, collateralPrecision, collateralPriceOrMap, debtAssetId, collateralAssetId, precisionOf) {
123
- const collRaw = toFiniteOrNull(collateralAmountInt);
124
- const collPrec = toFiniteOrNull(collateralPrecision);
101
+ const collRaw = toFiniteNumber(collateralAmountInt, null);
102
+ const collPrec = toFiniteNumber(collateralPrecision, null);
125
103
  if (collRaw === null || collRaw <= 0 || collPrec === null)
126
104
  return null;
127
105
  const collateralFloat = collRaw / Math.pow(10, collPrec);
@@ -136,38 +114,70 @@ function collateralValueFromOfferPrice(collateralAmountInt, collateralPrecision,
136
114
  return collateralFloat * rate;
137
115
  }
138
116
  /**
139
- * Minimum raw collateral required to borrow a raw debt amount at a price.
140
- * Integer ceil so the borrow is never under-collateralized by rounding.
117
+ * Shared orientation resolution for the borrow/collateral conversion pair.
118
+ * Validates the offer price amounts and returns the base/quote factors plus
119
+ * the price orientation, so both directions cannot disagree on which way the
120
+ * factor applies. Null when the price is missing or unusable.
141
121
  */
142
- function requiredCollateralForBorrow(borrowAmountInt, collateralPrice, debtAssetId = null, collateralAssetId = null) {
143
- const borrowRaw = toFiniteOrNull(borrowAmountInt);
144
- const baseAmount = toFiniteOrNull(collateralPrice?.base?.amount);
145
- const quoteAmount = toFiniteOrNull(collateralPrice?.quote?.amount);
146
- if (borrowRaw === null || borrowRaw <= 0 || baseAmount === null || quoteAmount === null || baseAmount <= 0 || quoteAmount <= 0) {
122
+ function resolvePriceFactors(collateralPrice, debtAssetId, collateralAssetId) {
123
+ const baseAmount = toFiniteNumber(collateralPrice?.base?.amount, null);
124
+ const quoteAmount = toFiniteNumber(collateralPrice?.quote?.amount, null);
125
+ if (baseAmount === null || quoteAmount === null || baseAmount <= 0 || quoteAmount <= 0) {
147
126
  return null;
148
127
  }
149
128
  const orientation = creditPriceOrientation(String(collateralPrice?.base?.asset_id || ''), String(collateralPrice?.quote?.asset_id || ''), String(debtAssetId || ''), String(collateralAssetId || ''));
150
- if (orientation === 'legacy-reversed') {
151
- return Math.ceil((Number(borrowAmountInt) * baseAmount) / quoteAmount);
152
- }
153
- return Math.ceil((Number(borrowAmountInt) * quoteAmount) / baseAmount);
129
+ return { baseAmount, quoteAmount, orientation };
130
+ }
131
+ /**
132
+ * Convert a raw amount along the borrow<->collateral price ratio, applying the
133
+ * price orientation and integer rounding direction. Shared by the two
134
+ * conversions below so they cannot disagree on which factor applies; the two
135
+ * directions are reciprocal, so `direction` flips the numerator/denominator.
136
+ */
137
+ function convertAtPrice(amountInt, direction, rounding, collateralPrice, debtAssetId, collateralAssetId) {
138
+ const amount = toFiniteNumber(amountInt, null);
139
+ const factors = resolvePriceFactors(collateralPrice, debtAssetId, collateralAssetId);
140
+ if (amount === null || amount <= 0 || factors === null)
141
+ return null;
142
+ const { baseAmount, quoteAmount, orientation } = factors;
143
+ const legacyNumerator = direction === 'debtToCollateral' ? baseAmount : quoteAmount;
144
+ const legacyDenominator = direction === 'debtToCollateral' ? quoteAmount : baseAmount;
145
+ const numerator = orientation === 'legacy-reversed' ? legacyNumerator : legacyDenominator;
146
+ const denominator = orientation === 'legacy-reversed' ? legacyDenominator : legacyNumerator;
147
+ const round = rounding === 'ceil' ? Math.ceil : Math.floor;
148
+ return round((Number(amountInt) * numerator) / denominator);
149
+ }
150
+ /**
151
+ * Minimum raw collateral required to borrow a raw debt amount at a price.
152
+ * Integer ceil so the borrow is never under-collateralized by rounding.
153
+ */
154
+ function requiredCollateralForBorrow(borrowAmountInt, collateralPrice, debtAssetId = null, collateralAssetId = null) {
155
+ return convertAtPrice(borrowAmountInt, 'debtToCollateral', 'ceil', collateralPrice, debtAssetId, collateralAssetId);
154
156
  }
155
157
  /**
156
158
  * Raw debt yielded by raw collateral at a price. Integer floor so the
157
159
  * borrow never exceeds what the collateral covers.
158
160
  */
159
161
  function borrowAmountForCollateral(collateralAmountInt, collateralPrice, debtAssetId = null, collateralAssetId = null) {
160
- const collRaw = toFiniteOrNull(collateralAmountInt);
161
- const baseAmount = toFiniteOrNull(collateralPrice?.base?.amount);
162
- const quoteAmount = toFiniteOrNull(collateralPrice?.quote?.amount);
163
- if (collRaw === null || collRaw <= 0 || baseAmount === null || quoteAmount === null || baseAmount <= 0 || quoteAmount <= 0) {
162
+ return convertAtPrice(collateralAmountInt, 'collateralToDebt', 'floor', collateralPrice, debtAssetId, collateralAssetId);
163
+ }
164
+ /**
165
+ * Raw debt yielded by a raw collateral budget, never exceeding the requested
166
+ * raw debt. Returns `requestedBorrowInt` when no budget is supplied or the
167
+ * budget already covers it; `null` when a supplied budget cannot support any
168
+ * borrow at the offer price (caller should back off rather than emit a doomed
169
+ * accept op).
170
+ */
171
+ function capBorrowToCollateral(requestedBorrowInt, availableCollateralInt, collateralPrice, debtAssetId = null, collateralAssetId = null) {
172
+ const requested = toFiniteNumber(requestedBorrowInt, null);
173
+ if (requested === null || requested <= 0)
164
174
  return null;
165
- }
166
- const orientation = creditPriceOrientation(String(collateralPrice?.base?.asset_id || ''), String(collateralPrice?.quote?.asset_id || ''), String(debtAssetId || ''), String(collateralAssetId || ''));
167
- if (orientation === 'legacy-reversed') {
168
- return Math.floor((Number(collateralAmountInt) * quoteAmount) / baseAmount);
169
- }
170
- return Math.floor((Number(collateralAmountInt) * baseAmount) / quoteAmount);
175
+ if (availableCollateralInt === null || availableCollateralInt === undefined)
176
+ return requested;
177
+ const budgetBorrow = borrowAmountForCollateral(availableCollateralInt, collateralPrice, debtAssetId, collateralAssetId);
178
+ if (budgetBorrow === null || budgetBorrow <= 0)
179
+ return null;
180
+ return Math.min(requested, budgetBorrow);
171
181
  }
172
182
  /**
173
183
  * Per-deal CR from floats plus a conversion rate:
@@ -175,7 +185,7 @@ function borrowAmountForCollateral(collateralAmountInt, collateralPrice, debtAss
175
185
  */
176
186
  function creditDealCollateralRatio(debtFloat, collateralFloat, rate) {
177
187
  const debt = positiveOrNull(debtFloat);
178
- const coll = toFiniteOrNull(collateralFloat);
188
+ const coll = toFiniteNumber(collateralFloat, null);
179
189
  const price = positiveOrNull(rate);
180
190
  if (debt === null || coll === null || coll < 0 || price === null)
181
191
  return null;
@@ -192,7 +202,7 @@ function averageCollateralRatio(entries) {
192
202
  let valueSum = 0;
193
203
  for (const entry of entries || []) {
194
204
  const debt = positiveOrNull(entry?.debt);
195
- const value = toFiniteOrNull(entry?.value);
205
+ const value = toFiniteNumber(entry?.value, null);
196
206
  if (debt === null || value === null || value < 0)
197
207
  continue;
198
208
  debtSum += debt;
@@ -208,9 +218,9 @@ function averageCollateralRatio(entries) {
208
218
  * a zero daily rate never exceeds maxFeeRatePerDay).
209
219
  */
210
220
  function dailyOfferFeeRate(offer, feeDenom) {
211
- const feeRate = toFiniteOrNull(offer?.fee_rate);
212
- const maxDurationSeconds = toFiniteOrNull(offer?.max_duration_seconds);
213
- const denom = toFiniteOrNull(feeDenom);
221
+ const feeRate = toFiniteNumber(offer?.fee_rate, null);
222
+ const maxDurationSeconds = toFiniteNumber(offer?.max_duration_seconds, null);
223
+ const denom = toFiniteNumber(feeDenom, null);
214
224
  if (feeRate === null || maxDurationSeconds === null || denom === null || feeRate <= 0 || maxDurationSeconds <= 0 || denom <= 0) {
215
225
  return 0;
216
226
  }
@@ -221,9 +231,9 @@ function dailyOfferFeeRate(offer, feeDenom) {
221
231
  * (repay * feeRate + denom - 1) / denom. Zero when nothing is owed.
222
232
  */
223
233
  function creditDealFee(repayAmountInt, feeRate, feeDenom) {
224
- const repayRaw = toFiniteOrNull(repayAmountInt);
225
- const rateRaw = toFiniteOrNull(feeRate);
226
- const denomRaw = toFiniteOrNull(feeDenom);
234
+ const repayRaw = toFiniteNumber(repayAmountInt, null);
235
+ const rateRaw = toFiniteNumber(feeRate, null);
236
+ const denomRaw = toFiniteNumber(feeDenom, null);
227
237
  if (repayRaw === null || rateRaw === null || denomRaw === null || denomRaw <= 0)
228
238
  return 0;
229
239
  const repay = BigInt(Math.max(0, Math.trunc(repayRaw)));
@@ -233,5 +243,5 @@ function creditDealFee(repayAmountInt, feeRate, feeDenom) {
233
243
  return 0;
234
244
  return Number(((repay * rate) + denom - 1n) / denom);
235
245
  }
236
- export { normalizeCollateralMap, creditPriceOrientation, extractOfferConversionRate, collateralValueFromOfferPrice, requiredCollateralForBorrow, borrowAmountForCollateral, creditDealCollateralRatio, averageCollateralRatio, dailyOfferFeeRate, creditDealFee, };
246
+ export { normalizeCollateralMap, creditPriceOrientation, extractOfferConversionRate, collateralValueFromOfferPrice, requiredCollateralForBorrow, borrowAmountForCollateral, capBorrowToCollateral, creditDealCollateralRatio, averageCollateralRatio, dailyOfferFeeRate, creditDealFee, };
237
247
  //# sourceMappingURL=credit_pricing.js.map
@@ -1,60 +1,165 @@
1
+ import * as chainOrders from './chain_orders.js';
2
+ import { borrowAmountForCollateral as sharedBorrowAmountForCollateral, requiredCollateralForBorrow as sharedRequiredCollateralForBorrow } from './credit_pricing.js';
3
+ import type { BotLike, GridConfig, LogFn, UnknownRecord } from './types.js';
4
+ interface DebtAssetSnapshot {
5
+ assetId: string;
6
+ mpaDebt: number;
7
+ mpaCollateral: number;
8
+ creditDebt: number;
9
+ creditCollateral: number;
10
+ offeredBalance: number;
11
+ totalDebt: number;
12
+ totalCollateral: number;
13
+ [key: string]: unknown;
14
+ }
15
+ interface DebtSnapshot {
16
+ assets: Record<string, DebtAssetSnapshot>;
17
+ mpaCallOrders: unknown[];
18
+ creditDeals: unknown[];
19
+ ownedCreditOffers: unknown[];
20
+ [key: string]: unknown;
21
+ }
22
+ interface FallbackOfferCandidate extends UnknownRecord {
23
+ offer: UnknownRecord;
24
+ op: unknown;
25
+ dailyRate: number;
26
+ feeRate: number;
27
+ balance: number;
28
+ duration: number;
29
+ }
30
+ interface IncreaseOfferCandidate extends FallbackOfferCandidate {
31
+ borrowAmount: number;
32
+ collateralAmount: number;
33
+ capped: boolean;
34
+ }
35
+ interface DealSummary {
36
+ id: unknown;
37
+ borrower: unknown;
38
+ offerId: unknown;
39
+ offerOwner: unknown;
40
+ debtAssetId: unknown;
41
+ debtAmount: number;
42
+ collateralAssetId: unknown;
43
+ collateralAmount: number;
44
+ feeRate: number;
45
+ latestRepayTime: unknown;
46
+ autoRepay: number;
47
+ }
48
+ interface CreditOfferSummary {
49
+ id: unknown;
50
+ ownerAccount: unknown;
51
+ assetType: unknown;
52
+ totalBalance: number;
53
+ currentBalance: number;
54
+ feeRate: number;
55
+ maxDurationSeconds: number;
56
+ minDealAmount: number;
57
+ enabled: boolean;
58
+ acceptableCollateral: unknown;
59
+ }
60
+ /** A configured lending item (MPA or credit-offer policy). */
61
+ interface LendingItem extends UnknownRecord {
62
+ type?: string;
63
+ asset?: unknown;
64
+ collateralAsset?: unknown;
65
+ collateralAssetId?: unknown;
66
+ minCollateralRatio?: number;
67
+ maxCollateralRatio?: number;
68
+ targetCollateralRatio?: number;
69
+ maxBorrowAmount?: number;
70
+ maxBorrowAmountPerOperation?: number;
71
+ maxCollateralAmount?: number | string;
72
+ minCollateralIncreaseThreshold?: number;
73
+ debtOnly?: boolean;
74
+ autoRepay?: boolean;
75
+ autoReborrow?: boolean;
76
+ disallowedDealIds?: unknown;
77
+ }
78
+ /** The `config.debtPolicy` surface. */
79
+ interface DebtPolicy extends UnknownRecord {
80
+ lending: LendingItem[];
81
+ }
82
+ /** Persisted per-position credit-runtime state. */
83
+ interface PositionState extends UnknownRecord {
84
+ currentCollateralAmount?: number;
85
+ currentDebtAmount?: number;
86
+ feedPrice?: number;
87
+ assignedCollateralBudget?: number;
88
+ currentCollateralFundsTotal?: number;
89
+ creditDeals?: UnknownRecord[];
90
+ lastCreditIncrease?: UnknownRecord;
91
+ lastMpaAction?: UnknownRecord;
92
+ mpaSelectionConflict?: unknown;
93
+ }
94
+ interface CreditState extends UnknownRecord {
95
+ positions: Record<string, PositionState>;
96
+ pendingReborrows: UnknownRecord[];
97
+ activeDealIds: unknown[];
98
+ activeOfferIds: unknown[];
99
+ mpaCallOrders: unknown[];
100
+ ownedCreditOffers: Record<string, unknown>[];
101
+ creditDeals: Record<string, unknown>[];
102
+ reborrowPending: boolean;
103
+ botKey: string;
104
+ }
1
105
  declare class CreditRuntime {
2
- bot: any;
3
- config: any;
4
- options: any;
5
- log: any;
6
- warn: any;
106
+ bot: BotLike;
107
+ config: GridConfig;
108
+ options: {
109
+ stateDir?: string;
110
+ [key: string]: unknown;
111
+ };
112
+ log: LogFn;
113
+ warn: LogFn;
7
114
  botKey: string;
115
+ _getOnChainAssetBalancesFn?: typeof chainOrders.getOnChainAssetBalances | null;
116
+ _lastResolvedSettleDelayMs?: number;
8
117
  stateDir: string;
9
118
  statePath: string;
10
- _assetCache: Map<any, any>;
11
- _objectCache: Map<any, any>;
12
- _fullAccountCache: any;
13
- _borrowerDealsCache: any;
14
- state: any;
119
+ _assetCache: Map<string, Record<string, unknown>>;
120
+ _objectCache: Map<string, Record<string, unknown>>;
121
+ _fullAccountCache: {
122
+ ref?: unknown;
123
+ account: UnknownRecord | null;
124
+ } | null;
125
+ _borrowerDealsCache: DealSummary[] | null;
126
+ state: CreditState;
15
127
  _loaded: boolean;
16
128
  _maintenanceInFlight: boolean;
17
129
  _watchdogInFlight: boolean;
18
130
  _reborrowsInFlight: boolean;
19
131
  _splitInFlight: boolean;
20
- constructor(bot: any, options?: any);
21
- _createDefaultState(): {
22
- botKey: string;
23
- updatedAt: null;
24
- mpaCallOrders: never[];
25
- activeDealIds: never[];
26
- activeOfferIds: never[];
27
- ownedCreditOffers: never[];
28
- creditDeals: never[];
29
- debtSnapshot: null;
30
- lastBorrowRequest: null;
31
- lastRepayAt: null;
32
- lastGridResetAt: null;
33
- lastCrAdjustment: null;
34
- reborrowPending: boolean;
35
- pendingReborrows: never[];
36
- positions: {};
37
- };
38
- get debtPolicy(): any;
39
- isEnabled(): any;
40
- _positionKey(debtAssetId: any, collateralAssetId: any): string;
41
- _findLendingItemForAsset(assetId: any, typeFilter: any): Promise<any>;
42
- _stateWithDefaults(state?: any): any;
43
- loadState({ forceReload }?: any): Promise<any>;
44
- persistState(reason?: any): Promise<any>;
132
+ constructor(bot: BotLike, options?: {
133
+ stateDir?: string;
134
+ [key: string]: unknown;
135
+ });
136
+ _createDefaultState(): CreditState;
137
+ get debtPolicy(): DebtPolicy | null;
138
+ isEnabled(): boolean;
139
+ _positionKey(debtAssetId: unknown, collateralAssetId: unknown): string;
140
+ _findLendingItemForAsset(assetId: unknown, typeFilter: unknown): Promise<UnknownRecord | null>;
141
+ _stateWithDefaults(state?: unknown): CreditState;
142
+ loadState({ forceReload }?: {
143
+ forceReload?: boolean;
144
+ }): Promise<unknown>;
145
+ persistState(reason?: unknown): Promise<unknown>;
45
146
  shutdown(): Promise<void>;
46
- _dbCall(method: any, args?: any[]): Promise<any>;
47
- _resolveAccountId(accountRef: any): Promise<any>;
48
- _resolveAccountName(accountRef: any): Promise<any>;
49
- _getFullAccount(accountRef: any): Promise<any>;
50
- _resolveAsset(assetRef: any): Promise<any>;
51
- _resolveBitassetData(assetRef: any): Promise<any>;
52
- _computeBtsPerDebt(settlementPrice: any, debtAsset: any, backingAsset: any): number | null;
53
- _normalizePolicyList(value: any): string[];
147
+ _dbCall(method: string, args?: unknown[]): Promise<unknown>;
148
+ _resolveAccountId(accountRef: unknown): Promise<string | null>;
149
+ _resolveAccountName(accountRef: unknown): Promise<string | null>;
150
+ _getFullAccount(accountRef: unknown): Promise<UnknownRecord | null>;
151
+ _resolveAsset(assetRef: unknown): Promise<UnknownRecord | null>;
152
+ _resolveBitassetData(assetRef: unknown): Promise<UnknownRecord | null>;
153
+ _computeBtsPerDebt(settlementPrice: UnknownRecord | null | undefined, debtAsset: UnknownRecord | null | undefined, backingAsset: UnknownRecord | null | undefined): number | null;
154
+ _normalizePolicyList(value: unknown): string[];
54
155
  _rebuildCreditTrackingFromPositions(): void;
55
- _pruneCreditStateForPolicy(lendingItems?: any[]): Promise<void>;
56
- _resolveAmountToBlockchainInt(spec: any, asset: any, accountRef: any, { balanceField, referenceAmount, referenceLabel }?: any): Promise<any>;
57
- _resolveLendingPolicyForOffer(offer: any): Promise<any>;
156
+ _pruneCreditStateForPolicy(lendingItems?: UnknownRecord[]): Promise<void>;
157
+ _resolveAmountToBlockchainInt(spec: unknown, asset: UnknownRecord, accountRef: unknown, { balanceField, referenceAmount, referenceLabel }?: {
158
+ balanceField?: string;
159
+ referenceAmount?: number | null;
160
+ referenceLabel?: string;
161
+ }): Promise<number | null>;
162
+ _resolveLendingPolicyForOffer(offer: UnknownRecord | null | undefined): Promise<unknown>;
58
163
  /**
59
164
  * Resolve the MPA feed price for a given debt/collateral pair.
60
165
  * Uses cached value if fresh, otherwise fetches from the blockchain.
@@ -64,9 +169,12 @@ declare class CreditRuntime {
64
169
  * @param {boolean} [options.includeSource] - When true, returns { price, source } object
65
170
  * @returns {number|Object|null} Price number, { price, source } object, or null
66
171
  */
67
- _resolveMpaFeedPrice(debtAssetId: any, collateralAssetId: any, options?: {
172
+ _resolveMpaFeedPrice(debtAssetId: unknown, collateralAssetId: unknown, options?: {
68
173
  includeSource?: boolean;
69
- }): Promise<any>;
174
+ }): Promise<number | {
175
+ price: number | null;
176
+ source: string;
177
+ } | null>;
70
178
  /**
71
179
  * Resolve the credit conversion rate for a given lending item.
72
180
  * Uses cached value if fresh, otherwise derives from credit deals.
@@ -77,82 +185,139 @@ declare class CreditRuntime {
77
185
  * @param {boolean} [options.includeSource] - When true, returns { price, source } object
78
186
  * @returns {number|Object|null} Rate number, { price, source } object, or null
79
187
  */
80
- _resolveCreditConversionRate(lendingItem: any, debtAssetId: any, collateralAssetId: any, options?: {
188
+ _resolveCreditConversionRate(lendingItem: UnknownRecord | null | undefined, debtAssetId: unknown, collateralAssetId: unknown, options?: {
81
189
  includeSource?: boolean;
82
- }): Promise<any>;
190
+ }): Promise<number | {
191
+ price: number | null;
192
+ source: string;
193
+ } | null>;
83
194
  _calculateCollateralDistribution(): Promise<void>;
84
- _precisionOfPair(debtAsset: any, collateralAsset: any): (assetId: string) => number | null;
85
- _extractRateFromCollateralMap(collateralMap: Map<string, any>, collateralAssetId: string, debtAsset: any, collateralAsset: any): number | null;
86
- _calculateBorrowAmountFromCollateral(collateralAmountInt: any, collateralPrice: any, debtAsset?: any, collateralAsset?: any): number | null;
87
- _enforceMaxBorrowAmount(policy: any, borrowInt: any, debtAsset: any, options?: Record<string, any>): void;
88
- _getCreditDebtForAsset(asset: any): number;
89
- _getCreditCollateralForAsset(asset: any): number;
90
- _getCollateralPercentageBase(accountId: any, assetId: any): Promise<any>;
91
- _enforceMaxCollateralAmount(policy: any, collateralInt: any, collateralAsset: any, accountId: any, options?: Record<string, any>): Promise<void>;
92
- _calculateDailyFeeRate(offer: any): number;
195
+ _precisionOfPair(debtAsset: UnknownRecord | null, collateralAsset: UnknownRecord | null): (assetId: string) => number | null;
196
+ _extractRateFromCollateralMap(collateralMap: ReadonlyMap<string, unknown> | null | undefined, collateralAssetId: string, debtAsset: UnknownRecord | null, collateralAsset: UnknownRecord | null): number | null;
197
+ _calculateBorrowAmountFromCollateral(collateralAmountInt: unknown, collateralPrice: Parameters<typeof sharedBorrowAmountForCollateral>[1], debtAsset?: UnknownRecord | null, collateralAsset?: UnknownRecord | null): number | null;
198
+ _enforceMaxBorrowAmount(policy: UnknownRecord, borrowInt: unknown, debtAsset: UnknownRecord, options?: UnknownRecord): void;
199
+ _getCreditDebtForAsset(asset: unknown): number;
200
+ _getCreditCollateralForAsset(asset: unknown): number;
201
+ /**
202
+ * Sum a raw credit-deal amount across all deals matching `asset` on the
203
+ * given asset-id field, converted to float at the asset's precision.
204
+ * Shared by the debt and collateral totals (see _getCreditDebtForAsset and
205
+ * _getCreditCollateralForAsset).
206
+ */
207
+ _sumCreditFieldForAsset(asset: unknown, assetField: string, amountField: string): number;
208
+ _getCollateralPercentageBase(accountId: unknown, assetId: unknown): Promise<number | null>;
209
+ _enforceMaxCollateralAmount(policy: UnknownRecord, collateralInt: unknown, collateralAsset: UnknownRecord, accountId: unknown, options?: UnknownRecord): Promise<void>;
210
+ _calculateDailyFeeRate(offer: UnknownRecord): number;
93
211
  _getDefaultMaxFeeRatePerDay(): number;
94
- _validateCreditPolicy(policy: any, offer: any, deal?: any): any;
95
- _calculateCollateralValueInDebtAsset(collateralAmountInt: any, collateralAsset: any, debtAsset: any, collateralPrice: any): Promise<any>;
96
- _calculateCreditOfferCollateralValueInDebtAsset(collateralAmountInt: any, collateralAsset: any, debtAsset: any, collateralPrice: any): number | null;
97
- _fetchBorrowerDeals(): Promise<any[]>;
98
- _fetchOwnedCreditOffers(): Promise<any[]>;
99
- _buildDebtSnapshot(): Promise<any>;
100
- refreshMpaState(lendingItem: any): Promise<any>;
101
- refreshCreditState(options: Record<string, any> | undefined, lendingItem: any): Promise<any>;
102
- refreshState(): Promise<any>;
103
- _buildMpaPlanFromState(lendingItem: any, assetId: any): Promise<any>;
104
- buildMpaUpdateOperation(plan: any, options: Record<string, any> | undefined, lendingItem: any, assetId: any): Promise<any>;
105
- buildCreditOfferAcceptOperation({ offer, borrowAmount, collateralAmount, autoRepay, specificPolicy, pendingRepayAmount, pendingReleaseCollateralAmount }?: {
106
- offer?: any;
107
- borrowAmount?: any;
108
- collateralAmount?: any;
212
+ _validateCreditPolicy(policy: UnknownRecord, offer: UnknownRecord | null | undefined, deal?: UnknownRecord | null): UnknownRecord;
213
+ _calculateCollateralValueInDebtAsset(collateralAmountInt: unknown, collateralAsset: UnknownRecord, debtAsset: UnknownRecord, collateralPrice: unknown): Promise<number | null>;
214
+ _calculateCreditOfferCollateralValueInDebtAsset(collateralAmountInt: unknown, collateralAsset: UnknownRecord, debtAsset: UnknownRecord, collateralPrice: unknown): number | null;
215
+ _fetchBorrowerDeals(): Promise<DealSummary[]>;
216
+ _fetchOwnedCreditOffers(): Promise<CreditOfferSummary[]>;
217
+ _buildDebtSnapshot(): Promise<DebtSnapshot>;
218
+ refreshMpaState(lendingItem: UnknownRecord | null | undefined): Promise<unknown>;
219
+ refreshCreditState(options: UnknownRecord | undefined, lendingItem: UnknownRecord): Promise<unknown>;
220
+ refreshState(): Promise<unknown>;
221
+ _buildMpaPlanFromState(lendingItem: UnknownRecord, assetId: unknown): Promise<UnknownRecord | null>;
222
+ buildMpaUpdateOperation(plan: UnknownRecord, options: UnknownRecord | undefined, lendingItem: UnknownRecord, assetId: unknown): Promise<UnknownRecord | null>;
223
+ buildCreditOfferAcceptOperation({ offer, borrowAmount, collateralAmount, autoRepay, specificPolicy, pendingRepayAmount, pendingReleaseCollateralAmount, availableCollateralAmount }?: {
224
+ offer?: UnknownRecord | null;
225
+ borrowAmount?: unknown;
226
+ collateralAmount?: unknown;
109
227
  autoRepay?: boolean;
110
- specificPolicy?: any;
111
- pendingRepayAmount?: any;
112
- pendingReleaseCollateralAmount?: any;
113
- }): Promise<any>;
114
- _calculateRequiredCollateral(borrowAmountInt: any, collateralPrice: any, debtAsset?: any, collateralAsset?: any): number | null;
115
- _calculateCreditFee(repayAmountInt: any, feeRate: any): number;
116
- buildCreditDealRepayOperation(deal: any, repayAmount: any): Promise<any>;
117
- buildCreditDealUpdateOperation(deal: any, autoRepay: any): Promise<any>;
118
- executeOperations(operations: any, reason?: any): Promise<any>;
119
- _checkGridMaintenanceAfterCreditUpdate(context?: any, options?: Record<string, any>): Promise<any>;
120
- repayCreditDeal(deal: any, repayAmount: any, options?: Record<string, any>): Promise<any>;
121
- queueReborrow(request: any): void;
122
- _extractDealNumericId(id: any): number;
123
- _getOfferById(offerId: any): Promise<any>;
124
- _fetchCreditOffersByAsset(assetId: any): Promise<any[]>;
125
- _resolveFallbackAssetIds(policy: any, offer?: any): Promise<any>;
126
- _selectFallbackCreditOffer({ debtAssetId, collateralAssetId, policy, borrowAmount, collateralAmount, autoRepay, pendingRepayAmount, pendingReleaseCollateralAmount, excludeOfferId }?: {
127
- debtAssetId?: any;
128
- collateralAssetId?: any;
129
- policy?: any;
130
- borrowAmount?: any;
131
- collateralAmount?: any;
132
- autoRepay?: any;
133
- pendingRepayAmount?: any;
134
- pendingReleaseCollateralAmount?: any;
135
- excludeOfferId?: any;
136
- }): Promise<any>;
228
+ specificPolicy?: UnknownRecord | null;
229
+ pendingRepayAmount?: unknown;
230
+ pendingReleaseCollateralAmount?: unknown;
231
+ availableCollateralAmount?: number | null;
232
+ }): Promise<UnknownRecord>;
233
+ _calculateRequiredCollateral(borrowAmountInt: unknown, collateralPrice: Parameters<typeof sharedRequiredCollateralForBorrow>[1], debtAsset?: UnknownRecord | null, collateralAsset?: UnknownRecord | null): number | null;
234
+ _calculateCreditFee(repayAmountInt: unknown, feeRate: unknown): number;
235
+ buildCreditDealRepayOperation(deal: unknown, repayAmount: unknown): Promise<UnknownRecord>;
236
+ buildCreditDealUpdateOperation(deal: unknown, autoRepay: unknown): Promise<UnknownRecord>;
237
+ executeOperations(operations: unknown[], reason?: string): Promise<unknown>;
238
+ _checkGridMaintenanceAfterCreditUpdate(context?: unknown, options?: UnknownRecord): Promise<unknown>;
239
+ repayCreditDeal(deal: UnknownRecord, repayAmount: unknown, options?: UnknownRecord): Promise<unknown>;
240
+ queueReborrow(request: UnknownRecord): void;
241
+ _extractDealNumericId(id: unknown): number;
242
+ _collectActiveDealIds(): string[];
243
+ /**
244
+ * Pick a balance entry from a `getOnChainAssetBalances` result by asset id,
245
+ * falling back to the asset symbol. Centralizes the lookup shape shared by
246
+ * the percentage/amount resolvers and the credit helpers.
247
+ */
248
+ _pickOnChainBalanceEntry(balances: unknown, assetId: unknown, asset: UnknownRecord | null): UnknownRecord | null;
249
+ /**
250
+ * Read the chain-free balance of the debt asset. Returns null when the
251
+ * balance cannot be determined so callers can fall back to the legacy
252
+ * (full-deal) renewal path instead of guessing.
253
+ */
254
+ _getFreeDebtAssetBalance(debtAssetId: unknown, debtAsset: UnknownRecord | null): Promise<number | null>;
255
+ /**
256
+ * Raw collateral freed by a repay, used as the ceiling a reborrow can lock.
257
+ * Precedence:
258
+ * 1. explicit raw `options.availableCollateralAmount` (collateral-switch flow),
259
+ * 2. exact on-chain `floor(repay * collateral / debt)` when the deal's own
260
+ * collateral asset is used,
261
+ * 3. explicit `options.pendingReleaseCollateralAmount` (float) as a fallback.
262
+ * Returns null when it cannot be determined, so the accept builder keeps the
263
+ * legacy (unclamped) behaviour.
264
+ */
265
+ _computeReleasedCollateralInt(dealSummary: DealSummary | UnknownRecord | null, repayAmount: unknown, options: UnknownRecord): Promise<number | null>;
266
+ /**
267
+ * Decide how much of a maturing deal can actually be repaid and reborrowed
268
+ * with the currently free debt-asset balance. The repay leg is funded from
269
+ * the borrower's free balance before the atomic reborrow returns anything,
270
+ * so when the borrowed asset has been deployed into the grid the full deal
271
+ * cannot be renewed in one shot. In that case we roll the largest affordable
272
+ * piece (bounded by min_deal_amount and maxBorrowAmountPerOperation) and let
273
+ * the remaining debt be handled on the next cycle.
274
+ *
275
+ * Returns null when sizing is not possible (unknown balance / malformed
276
+ * deal) so the caller keeps the existing full-renewal behaviour.
277
+ */
278
+ _resolveRenewalSizing({ deal, debtAsset, offer, policy }: {
279
+ deal: UnknownRecord | null;
280
+ debtAsset: UnknownRecord | null;
281
+ offer: UnknownRecord | null;
282
+ policy: UnknownRecord | null;
283
+ }): Promise<UnknownRecord | null>;
284
+ _getOfferById(offerId: unknown): Promise<UnknownRecord | null>;
285
+ _fetchCreditOffersByAsset(assetId: unknown): Promise<UnknownRecord[]>;
286
+ _resolveFallbackAssetIds(policy: UnknownRecord, offer?: UnknownRecord | null): Promise<{
287
+ debtAssetId: string | null;
288
+ collateralAssetId: string | null;
289
+ }>;
290
+ _selectFallbackCreditOffer({ debtAssetId, collateralAssetId, policy, borrowAmount, collateralAmount, autoRepay, pendingRepayAmount, pendingReleaseCollateralAmount, availableCollateralAmount, excludeOfferId }?: {
291
+ debtAssetId?: unknown;
292
+ collateralAssetId?: unknown;
293
+ policy?: UnknownRecord;
294
+ borrowAmount?: unknown;
295
+ collateralAmount?: unknown;
296
+ autoRepay?: unknown;
297
+ pendingRepayAmount?: unknown;
298
+ pendingReleaseCollateralAmount?: unknown;
299
+ availableCollateralAmount?: number | null;
300
+ excludeOfferId?: unknown;
301
+ }): Promise<FallbackOfferCandidate | null>;
137
302
  _selectCreditOfferForIncrease({ debtAssetId, collateralAssetId, policy, collateralAmount, minCollateralIncrease, remainingBorrowCapacity, autoRepay }?: {
138
- debtAssetId?: any;
139
- collateralAssetId?: any;
140
- policy?: any;
141
- collateralAmount?: any;
303
+ debtAssetId?: unknown;
304
+ collateralAssetId?: unknown;
305
+ policy?: UnknownRecord;
306
+ collateralAmount?: unknown;
142
307
  minCollateralIncrease?: number;
143
- remainingBorrowCapacity?: any;
144
- autoRepay?: any;
145
- }): Promise<any>;
146
- _buildCreditIncreasePlan(lendingItem: any, assetId: any, posState: any): Promise<any>;
147
- _splitOversizedCreditDeals(lendingItem: any, assetId: any, posState: any, runtimeContext?: Record<string, any>): Promise<any>;
148
- _doSplitOversizedCreditDeals(lendingItem: any, assetId: any, posState: any, _runtimeContext?: Record<string, any>): Promise<any>;
149
- _getDealById(dealId: any): Promise<any>;
150
- processPendingReborrows(): Promise<any>;
151
- _runMpaMaintenance(context: any, _options: Record<string, any>, lendingItem: any, assetId: any): Promise<any>;
152
- _runCreditMaintenance(lendingItem: any, assetId: any, runtimeContext?: Record<string, any>): Promise<any>;
153
- runMaintenance(context?: any, options?: Record<string, any>): Promise<any>;
154
- runCreditWatchdog(): Promise<any>;
155
- getStateSnapshot(): any;
308
+ remainingBorrowCapacity?: unknown;
309
+ autoRepay?: unknown;
310
+ }): Promise<IncreaseOfferCandidate | null>;
311
+ _buildCreditIncreasePlan(lendingItem: UnknownRecord, assetId: unknown, posState: UnknownRecord): Promise<UnknownRecord | null>;
312
+ _splitOversizedCreditDeals(lendingItem: UnknownRecord, assetId: unknown, posState: UnknownRecord, runtimeContext?: UnknownRecord): Promise<unknown>;
313
+ _doSplitOversizedCreditDeals(lendingItem: UnknownRecord, assetId: unknown, posState: UnknownRecord, _runtimeContext?: UnknownRecord): Promise<unknown>;
314
+ _getDealById(dealId: unknown): Promise<UnknownRecord | null>;
315
+ processPendingReborrows(): Promise<unknown>;
316
+ _runMpaMaintenance(context: unknown, _options: UnknownRecord, lendingItem: UnknownRecord, assetId: unknown): Promise<unknown>;
317
+ _runCreditMaintenance(lendingItem: UnknownRecord, assetId: unknown, runtimeContext?: UnknownRecord): Promise<unknown>;
318
+ runMaintenance(context?: unknown, options?: UnknownRecord): Promise<unknown>;
319
+ runCreditWatchdog(): Promise<unknown>;
320
+ getStateSnapshot(): unknown;
156
321
  }
157
322
  export default CreditRuntime;
158
323
  //# sourceMappingURL=credit_runtime.d.ts.map