dexbot 1.6.10 → 1.6.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (365) hide show
  1. package/CHANGELOG.md +50 -3
  2. package/README.md +3 -1
  3. package/analysis/README.md +51 -11
  4. package/analysis/bot_fitting/README.md +12 -0
  5. package/analysis/tradingview/README.md +3 -3
  6. package/analysis/trend_detection/DYNAMIC_WEIGHT_RESEARCH.md +11 -37
  7. package/analysis/trend_detection/README.md +31 -0
  8. package/claw/docs/DEXBOT2_TUNING_CHEAT_SHEET.md +4 -3
  9. package/claw/modules/chain_broadcast.ts +7 -1
  10. package/claw/modules/claw_launcher.ts +1 -1
  11. package/claw/modules/launcher_mode_detector.ts +9 -2
  12. package/claw/package.json +1 -1
  13. package/claw/runtimes/openclaw-plugin/openclaw.plugin.json +1 -1
  14. package/claw/runtimes/openclaw-plugin/package.json +1 -1
  15. package/dist/analysis/account_resolver.d.ts +1 -1
  16. package/dist/analysis/account_resolver.js +15 -2
  17. package/dist/analysis/ama_fitting/analyze_ama_price_changes.js +3 -4
  18. package/dist/analysis/ama_fitting/analyze_lambda_vs_slow.js +2 -7
  19. package/dist/analysis/ama_fitting/calibrate_convergence_er.js +0 -1
  20. package/dist/analysis/ama_fitting/fetch_lp_candles.js +4 -4
  21. package/dist/analysis/ama_fitting/generate_unified_comparison_chart.d.ts +20 -4
  22. package/dist/analysis/ama_fitting/generate_unified_comparison_chart.js +9 -6
  23. package/dist/analysis/ama_fitting/optimizer_high_resolution.js +16 -12
  24. package/dist/analysis/analyze_args.d.ts +31 -0
  25. package/dist/analysis/analyze_args.js +41 -0
  26. package/dist/analysis/analyze_dynamic_weight.js +7 -20
  27. package/dist/analysis/analyze_kalman.js +7 -17
  28. package/dist/analysis/analyze_regime.js +7 -17
  29. package/dist/analysis/analyze_regime_windows.js +8 -18
  30. package/dist/analysis/analyze_risk_profile.js +8 -18
  31. package/dist/analysis/analyze_trade_heatmap.js +7 -17
  32. package/dist/analysis/analyze_volatility.js +7 -17
  33. package/dist/analysis/bot_fitting/backtest_ama_sweep.d.ts +220 -12
  34. package/dist/analysis/bot_fitting/backtest_ama_sweep.js +55 -10
  35. package/dist/analysis/bot_fitting/backtest_bot_fitting.d.ts +34 -4
  36. package/dist/analysis/bot_fitting/backtest_bot_fitting.js +72 -66
  37. package/dist/analysis/bot_fitting/backtest_lookback_drawdown.d.ts +21 -0
  38. package/dist/analysis/bot_fitting/backtest_lookback_drawdown.js +315 -0
  39. package/dist/analysis/bot_fitting/shared_utils.d.ts +7 -7
  40. package/dist/analysis/bot_fitting/shared_utils.js +2 -2
  41. package/dist/analysis/bot_key_utils.d.ts +18 -10
  42. package/dist/analysis/bot_key_utils.js +10 -17
  43. package/dist/analysis/bot_usage/discover_bot_accounts.js +44 -47
  44. package/dist/analysis/bot_usage/kibana_bot_queries.d.ts +1 -21
  45. package/dist/analysis/chain_pool.d.ts +3 -1
  46. package/dist/analysis/chart_ui.d.ts +5 -2
  47. package/dist/analysis/chart_ui.js +6 -3
  48. package/dist/analysis/chart_utils.d.ts +5 -5
  49. package/dist/analysis/chart_utils.js +9 -0
  50. package/dist/analysis/fills_cache.d.ts +64 -0
  51. package/dist/analysis/fills_cache.js +254 -0
  52. package/dist/analysis/fills_source.d.ts +2 -2
  53. package/dist/analysis/fills_source.js +19 -14
  54. package/dist/analysis/grid_correction_check.d.ts +1 -1
  55. package/dist/analysis/grid_correction_check.js +12 -11
  56. package/dist/analysis/math_utils.d.ts +7 -6
  57. package/dist/analysis/math_utils.js +5 -8
  58. package/dist/analysis/pnl_report.d.ts +39 -0
  59. package/dist/analysis/pnl_report.js +325 -0
  60. package/dist/analysis/price_sources.d.ts +8 -8
  61. package/dist/analysis/price_sources.js +5 -4
  62. package/dist/analysis/resolve_bot_accounts.js +2 -2
  63. package/dist/analysis/resolve_source.d.ts +1 -2
  64. package/dist/analysis/trade_profitability.d.ts +32 -2
  65. package/dist/analysis/trade_profitability.js +232 -106
  66. package/dist/analysis/tradingview/analyze_tradingview.d.ts +17 -6
  67. package/dist/analysis/tradingview/analyze_tradingview.js +9 -10
  68. package/dist/analysis/tradingview/grid_reset_config.d.ts +42 -31
  69. package/dist/analysis/tradingview/grid_reset_config.js +35 -6
  70. package/dist/analysis/tradingview/grid_reset_sim.d.ts +75 -8
  71. package/dist/analysis/tradingview/grid_reset_sim.js +42 -5
  72. package/dist/analysis/tradingview/tradingview_uplot_chart_generator.d.ts +69 -4
  73. package/dist/analysis/tradingview/tradingview_uplot_chart_generator.js +20 -20
  74. package/dist/analysis/trend_detection/backtest_ama_slope_huber.d.ts +102 -0
  75. package/dist/analysis/trend_detection/backtest_ama_slope_huber.js +725 -0
  76. package/dist/analysis/trend_detection/dynamic_weight_chart_generator.d.ts +63 -1
  77. package/dist/analysis/trend_detection/dynamic_weight_chart_generator.js +27 -112
  78. package/dist/analysis/trend_detection/huber_scale_variants.d.ts +40 -0
  79. package/dist/analysis/trend_detection/huber_scale_variants.js +176 -0
  80. package/dist/analysis/trend_detection/kalman_chart_generator.d.ts +30 -1
  81. package/dist/analysis/trend_detection/kalman_chart_generator.js +3 -3
  82. package/dist/analysis/trend_detection/regime_chart_generator.d.ts +31 -1
  83. package/dist/analysis/trend_detection/regime_chart_generator.js +2 -2
  84. package/dist/analysis/trend_detection/volatility_chart_generator.d.ts +33 -1
  85. package/dist/credential-daemon.js +34 -20
  86. package/dist/dexbot.js +17 -14
  87. package/dist/market_adapter/candle_utils.d.ts +22 -18
  88. package/dist/market_adapter/candle_utils.js +24 -20
  89. package/dist/market_adapter/core/asymmetric_bounds.d.ts +13 -4
  90. package/dist/market_adapter/core/config_normalizers.d.ts +3 -3
  91. package/dist/market_adapter/core/kibana_candles.d.ts +53 -18
  92. package/dist/market_adapter/core/kibana_candles.js +9 -7
  93. package/dist/market_adapter/core/kibana_client.d.ts +9 -1
  94. package/dist/market_adapter/core/kibana_client.js +8 -7
  95. package/dist/market_adapter/core/kibana_market_candles.d.ts +3 -2
  96. package/dist/market_adapter/core/market_adapter_service.d.ts +297 -115
  97. package/dist/market_adapter/core/market_adapter_service.js +184 -101
  98. package/dist/market_adapter/core/strategies/ama.d.ts +10 -2
  99. package/dist/market_adapter/core/strategies/ama.js +7 -32
  100. package/dist/market_adapter/core/strategies/ama_slope_model.d.ts +14 -1
  101. package/dist/market_adapter/core/strategies/ama_slope_model.js +12 -34
  102. package/dist/market_adapter/core/strategies/atr/calculator.d.ts +7 -2
  103. package/dist/market_adapter/core/strategies/atr/calculator.js +2 -34
  104. package/dist/market_adapter/core/strategies/collateral_manager.d.ts +7 -1
  105. package/dist/market_adapter/core/strategies/collateral_manager.js +0 -22
  106. package/dist/market_adapter/core/strategies/dynamic_weight_series.d.ts +36 -8
  107. package/dist/market_adapter/core/strategies/dynamic_weight_series.js +9 -9
  108. package/dist/market_adapter/core/strategies/regime_gate.d.ts +24 -15
  109. package/dist/market_adapter/core/strategies/regime_gate.js +4 -31
  110. package/dist/market_adapter/core/strategies/regime_interp.d.ts +7 -1
  111. package/dist/market_adapter/core/strategies/regime_interp.js +14 -22
  112. package/dist/market_adapter/core/strategies/volatility_shift.d.ts +11 -1
  113. package/dist/market_adapter/core/strategies/volatility_shift.js +0 -13
  114. package/dist/market_adapter/inputs/cex_candle_parsing.d.ts +29 -0
  115. package/dist/market_adapter/inputs/cex_candle_parsing.js +52 -0
  116. package/dist/market_adapter/inputs/fetch_book_data.d.ts +20 -4
  117. package/dist/market_adapter/inputs/fetch_book_data.js +3 -1
  118. package/dist/market_adapter/inputs/fetch_cex_synthetic_data.js +97 -226
  119. package/dist/market_adapter/inputs/fetch_lp_data.d.ts +42 -7
  120. package/dist/market_adapter/inputs/fetch_lp_data.js +22 -15
  121. package/dist/market_adapter/inputs/kibana_feed_source.d.ts +74 -15
  122. package/dist/market_adapter/inputs/kibana_feed_source.js +29 -22
  123. package/dist/market_adapter/inputs/kibana_source.d.ts +25 -3
  124. package/dist/market_adapter/inputs/kibana_source.js +2 -2
  125. package/dist/market_adapter/inputs/window_cache.d.ts +99 -94
  126. package/dist/market_adapter/inputs/window_cache.js +8 -8
  127. package/dist/market_adapter/interval_utils.d.ts +4 -4
  128. package/dist/market_adapter/log_format.d.ts +6 -6
  129. package/dist/market_adapter/log_format.js +28 -22
  130. package/dist/market_adapter/lp_chart_core.d.ts +22 -1
  131. package/dist/market_adapter/lp_chart_core.js +26 -192
  132. package/dist/market_adapter/lp_chart_runner.d.ts +7 -7
  133. package/dist/market_adapter/lp_chart_strategy_loader.d.ts +41 -6
  134. package/dist/market_adapter/lp_chart_strategy_loader.js +8 -7
  135. package/dist/market_adapter/market_adapter.d.ts +94 -33
  136. package/dist/market_adapter/market_adapter.js +69 -75
  137. package/dist/market_adapter/utils/adapter_client.d.ts +3 -3
  138. package/dist/market_adapter/utils/adapter_client.js +2 -2
  139. package/dist/market_adapter/utils/atomic_write.d.ts +8 -1
  140. package/dist/market_adapter/utils/chain.d.ts +50 -41
  141. package/dist/market_adapter/utils/chain.js +40 -46
  142. package/dist/market_adapter/utils/data_discovery.d.ts +4 -1
  143. package/dist/market_adapter/utils/dynamic_grid_snapshot.d.ts +12 -3
  144. package/dist/market_adapter/utils/file_json_cache.d.ts +2 -2
  145. package/dist/market_adapter/utils/file_lock.d.ts +28 -14
  146. package/dist/market_adapter/utils/file_lock.js +36 -32
  147. package/dist/market_adapter/utils/native_history.d.ts +9 -2
  148. package/dist/market_adapter/utils/native_history.js +35 -28
  149. package/dist/modules/account_bots.d.ts +577 -21
  150. package/dist/modules/account_bots.js +182 -158
  151. package/dist/modules/account_orders.d.ts +66 -30
  152. package/dist/modules/account_orders.js +22 -20
  153. package/dist/modules/authority_resolver.d.ts +12 -2
  154. package/dist/modules/authority_resolver.js +15 -8
  155. package/dist/modules/bitshares-native/chain_client.d.ts +38 -3
  156. package/dist/modules/bitshares-native/chain_client.js +45 -46
  157. package/dist/modules/bitshares-native/crypto/ecc.browser.js +11 -171
  158. package/dist/modules/bitshares-native/crypto/ecc.js +13 -176
  159. package/dist/modules/bitshares-native/crypto/ecc_core.d.ts +33 -0
  160. package/dist/modules/bitshares-native/crypto/ecc_core.js +213 -0
  161. package/dist/modules/bitshares-native/crypto/ecc_selector.d.ts +2 -1
  162. package/dist/modules/bitshares-native/crypto/ecc_selector.js +1 -13
  163. package/dist/modules/bitshares-native/index.d.ts +1 -1
  164. package/dist/modules/bitshares-native/lru_cache.d.ts +7 -7
  165. package/dist/modules/bitshares-native/resolvers.d.ts +18 -6
  166. package/dist/modules/bitshares-native/serial/lazy_buffer.d.ts +4 -0
  167. package/dist/modules/bitshares-native/serial/lazy_buffer.js +21 -0
  168. package/dist/modules/bitshares-native/serial/operations.d.ts +1 -1
  169. package/dist/modules/bitshares-native/serial/serializer.d.ts +16 -12
  170. package/dist/modules/bitshares-native/serial/serializer.js +7 -13
  171. package/dist/modules/bitshares-native/serial/types.d.ts +25 -16
  172. package/dist/modules/bitshares-native/serial/types.js +55 -62
  173. package/dist/modules/bitshares-native/signing_client.d.ts +32 -2
  174. package/dist/modules/bitshares-native/signing_client.js +19 -14
  175. package/dist/modules/bitshares-native/subscriptions.d.ts +81 -1
  176. package/dist/modules/bitshares-native/subscriptions.js +12 -12
  177. package/dist/modules/bitshares-native/transport.d.ts +5 -4
  178. package/dist/modules/bitshares-native/transport.js +5 -4
  179. package/dist/modules/bitshares-native/tx/builder.d.ts +40 -5
  180. package/dist/modules/bitshares-native/tx/builder.js +4 -3
  181. package/dist/modules/bitshares-native/tx/tx_cache.d.ts +4 -4
  182. package/dist/modules/bitshares_client.d.ts +45 -13
  183. package/dist/modules/bitshares_client.js +28 -19
  184. package/dist/modules/bot_defaults.d.ts +6 -15
  185. package/dist/modules/bot_defaults.js +1 -5
  186. package/dist/modules/bot_settings.d.ts +44 -10
  187. package/dist/modules/bot_settings.js +11 -8
  188. package/dist/modules/bots_file_lock.d.ts +6 -6
  189. package/dist/modules/bots_file_lock.js +16 -12
  190. package/dist/modules/broadcast_failure.d.ts +2 -2
  191. package/dist/modules/broadcast_failure.js +5 -4
  192. package/dist/modules/chain_keys.d.ts +42 -40
  193. package/dist/modules/chain_keys.js +53 -45
  194. package/dist/modules/chain_orders.d.ts +93 -59
  195. package/dist/modules/chain_orders.js +31 -23
  196. package/dist/modules/constants.d.ts +530 -32
  197. package/dist/modules/constants.js +52 -60
  198. package/dist/modules/cr_planner.d.ts +40 -2
  199. package/dist/modules/credential_policy.d.ts +68 -8
  200. package/dist/modules/credential_policy.js +37 -31
  201. package/dist/modules/credential_session_cache.d.ts +2 -2
  202. package/dist/modules/credit_pricing.d.ts +42 -6
  203. package/dist/modules/credit_pricing.js +44 -30
  204. package/dist/modules/credit_runtime.d.ts +276 -118
  205. package/dist/modules/credit_runtime.js +462 -165
  206. package/dist/modules/crypto/browser_provider.js +6 -4
  207. package/dist/modules/crypto/node_provider.js +1 -1
  208. package/dist/modules/crypto/pure_scrypt.js +35 -4
  209. package/dist/modules/crypto/pure_secp256k1.js +72 -26
  210. package/dist/modules/crypto/sync.d.ts +9 -9
  211. package/dist/modules/crypto/sync.js +16 -9
  212. package/dist/modules/dexbot_class.d.ts +195 -139
  213. package/dist/modules/dexbot_class.js +78 -28
  214. package/dist/modules/dexbot_cow_runtime.d.ts +167 -87
  215. package/dist/modules/dexbot_cow_runtime.js +248 -206
  216. package/dist/modules/dexbot_credential_client.d.ts +19 -11
  217. package/dist/modules/dexbot_fill_runtime.d.ts +63 -48
  218. package/dist/modules/dexbot_fill_runtime.js +48 -41
  219. package/dist/modules/dexbot_maintenance_runtime.d.ts +109 -70
  220. package/dist/modules/dexbot_maintenance_runtime.js +117 -80
  221. package/dist/modules/dexbot_startup_runtime.d.ts +11 -10
  222. package/dist/modules/dexbot_startup_runtime.js +43 -43
  223. package/dist/modules/dexbot_state_recovery.d.ts +13 -12
  224. package/dist/modules/dexbot_state_recovery.js +18 -13
  225. package/dist/modules/fund_registry.d.ts +4 -2
  226. package/dist/modules/fund_registry.js +10 -10
  227. package/dist/modules/general_settings.d.ts +30 -4
  228. package/dist/modules/graceful_shutdown.d.ts +3 -3
  229. package/dist/modules/graceful_shutdown.js +2 -2
  230. package/dist/modules/grid_price_source.d.ts +1 -1
  231. package/dist/modules/key_store.d.ts +14 -8
  232. package/dist/modules/key_store.js +7 -6
  233. package/dist/modules/launcher/adapter_requirement.d.ts +11 -5
  234. package/dist/modules/launcher/adapter_requirement.js +5 -5
  235. package/dist/modules/launcher/bot_supervisor.d.ts +106 -24
  236. package/dist/modules/launcher/bot_supervisor.js +12 -11
  237. package/dist/modules/launcher/credential_bootstrap.d.ts +1 -1
  238. package/dist/modules/launcher/credential_bootstrap.js +1 -1
  239. package/dist/modules/launcher/credential_daemon.d.ts +4 -4
  240. package/dist/modules/launcher/credential_daemon.js +2 -2
  241. package/dist/modules/launcher/credential_secret.d.ts +1 -1
  242. package/dist/modules/launcher/foreign_cred_daemon.d.ts +2 -2
  243. package/dist/modules/launcher/market_adapter_runtime.d.ts +61 -6
  244. package/dist/modules/launcher/market_adapter_watchdog.d.ts +10 -2
  245. package/dist/modules/launcher/market_adapter_watchdog.js +4 -0
  246. package/dist/modules/launcher/monolithic_runtime.d.ts +18 -16
  247. package/dist/modules/launcher/status_reporting.d.ts +22 -14
  248. package/dist/modules/launcher/supervisor_control.d.ts +8 -1
  249. package/dist/modules/launcher/supervisor_control.js +4 -2
  250. package/dist/modules/market_adapter_whitelist.d.ts +9 -3
  251. package/dist/modules/market_adapter_whitelist.js +15 -3
  252. package/dist/modules/node_manager.d.ts +41 -11
  253. package/dist/modules/node_manager.js +5 -4
  254. package/dist/modules/order/accounting.d.ts +53 -24
  255. package/dist/modules/order/accounting.js +40 -14
  256. package/dist/modules/order/async_lock.d.ts +5 -2
  257. package/dist/modules/order/async_lock.js +1 -1
  258. package/dist/modules/order/export.d.ts +7 -6
  259. package/dist/modules/order/export.js +1 -7
  260. package/dist/modules/order/format.d.ts +39 -19
  261. package/dist/modules/order/format.js +62 -16
  262. package/dist/modules/order/genesis_policy.d.ts +21 -18
  263. package/dist/modules/order/genesis_policy.js +12 -8
  264. package/dist/modules/order/grid.d.ts +142 -36
  265. package/dist/modules/order/grid.js +148 -123
  266. package/dist/modules/order/grid_reconcile.d.ts +21 -20
  267. package/dist/modules/order/grid_reconcile.js +13 -12
  268. package/dist/modules/order/grid_reconcile_internal.d.ts +85 -72
  269. package/dist/modules/order/grid_reconcile_internal.js +28 -19
  270. package/dist/modules/order/index.d.ts +263 -1
  271. package/dist/modules/order/logger.d.ts +45 -11
  272. package/dist/modules/order/logger.js +38 -40
  273. package/dist/modules/order/logger_state.d.ts +4 -4
  274. package/dist/modules/order/manager.d.ts +226 -180
  275. package/dist/modules/order/manager.js +101 -83
  276. package/dist/modules/order/processed_fill_store.d.ts +18 -3
  277. package/dist/modules/order/processed_fill_store.js +16 -27
  278. package/dist/modules/order/strategy.d.ts +21 -13
  279. package/dist/modules/order/strategy.js +5 -6
  280. package/dist/modules/order/sync_engine.d.ts +91 -33
  281. package/dist/modules/order/sync_engine.js +99 -54
  282. package/dist/modules/order/utils/math.d.ts +157 -102
  283. package/dist/modules/order/utils/math.js +77 -38
  284. package/dist/modules/order/utils/order.d.ts +326 -106
  285. package/dist/modules/order/utils/order.js +200 -99
  286. package/dist/modules/order/utils/slot.d.ts +1 -1
  287. package/dist/modules/order/utils/system.d.ts +176 -26
  288. package/dist/modules/order/utils/system.js +86 -69
  289. package/dist/modules/order/utils/validate.d.ts +89 -41
  290. package/dist/modules/order/utils/validate.js +24 -22
  291. package/dist/modules/order/utils/withPoolRef.d.ts +4 -3
  292. package/dist/modules/order/utils/withPoolRef.js +18 -12
  293. package/dist/modules/order/working_grid.d.ts +14 -13
  294. package/dist/modules/paths.d.ts +3 -4
  295. package/dist/modules/paths.js +3 -27
  296. package/dist/modules/process_discovery.d.ts +1 -1
  297. package/dist/modules/process_discovery.js +2 -1
  298. package/dist/modules/runtime.d.ts +7 -3
  299. package/dist/modules/runtime.js +4 -3
  300. package/dist/modules/runtime_settings.d.ts +15 -10
  301. package/dist/modules/runtime_settings.js +30 -24
  302. package/dist/modules/settings_merge.d.ts +29 -3
  303. package/dist/modules/settings_merge.js +56 -78
  304. package/dist/modules/socket_json_client.d.ts +7 -4
  305. package/dist/modules/storage/browser_adapter.d.ts +38 -53
  306. package/dist/modules/storage/browser_adapter.js +7 -30
  307. package/dist/modules/storage/index.d.ts +1 -1
  308. package/dist/modules/storage/node_adapter.d.ts +45 -27
  309. package/dist/modules/storage/node_adapter.js +9 -9
  310. package/dist/modules/storage/types.d.ts +5 -4
  311. package/dist/modules/types.d.ts +1071 -2
  312. package/dist/modules/types.js +4 -1
  313. package/dist/modules/utils/asset_symbols.d.ts +2 -1
  314. package/dist/modules/utils/asset_symbols.js +2 -1
  315. package/dist/modules/utils/errors.d.ts +9 -0
  316. package/dist/modules/utils/errors.js +23 -1
  317. package/dist/modules/utils/time_range.d.ts +4 -0
  318. package/dist/modules/utils/time_range.js +18 -0
  319. package/dist/modules/validate_profiles.js +53 -43
  320. package/dist/modules/version_notice.d.ts +14 -3
  321. package/dist/modules/version_notice.js +6 -4
  322. package/dist/pm2.d.ts +29 -27
  323. package/dist/pm2.js +5 -5
  324. package/dist/scripts/analyze-credit.d.ts +2 -1
  325. package/dist/scripts/analyze-credit.js +23 -24
  326. package/dist/scripts/analyze-orders.d.ts +77 -9
  327. package/dist/scripts/analyze-orders.js +66 -84
  328. package/dist/scripts/chart_command.d.ts +27 -18
  329. package/dist/scripts/chart_command.js +16 -15
  330. package/dist/scripts/check_any.d.ts +18 -0
  331. package/dist/scripts/check_any.js +126 -0
  332. package/dist/scripts/diagnose-pool-history.js +12 -7
  333. package/dist/scripts/pnl.d.ts +3 -0
  334. package/dist/scripts/pnl.js +40 -0
  335. package/dist/scripts/print_grid.js +0 -1
  336. package/dist/scripts/run-tests.js +39 -7
  337. package/dist/scripts/runner.js +1 -1
  338. package/dist/scripts/test-credit-renewal.js +30 -21
  339. package/dist/scripts/update.d.ts +10 -5
  340. package/dist/scripts/update.js +168 -103
  341. package/dist/scripts/update_dist_freshness.js +1 -0
  342. package/dist/scripts/update_layout.d.ts +61 -0
  343. package/dist/scripts/update_layout.js +180 -0
  344. package/dist/scripts/validate_bots.js +2 -1
  345. package/dist/scripts/verify-browser-bundle.js +8 -0
  346. package/dist/unlock.d.ts +28 -3
  347. package/dist/unlock.js +72 -10
  348. package/docs/BITSHARES_ONBOARDING.md +2 -0
  349. package/docs/COPY_ON_WRITE_MASTER_PLAN.md +1 -1
  350. package/docs/COW_INVARIANTS.md +13 -6
  351. package/docs/DEXBOT_COMPARISON.md +8 -8
  352. package/docs/EVOLUTION.md +12 -10
  353. package/docs/FUND_MOVEMENT_AND_ACCOUNTING.md +5 -5
  354. package/docs/GRID_RECALCULATION.md +15 -16
  355. package/docs/GRID_RECONCILE.md +14 -3
  356. package/docs/LIFECYCLE.md +11 -11
  357. package/docs/MPA_CREDIT_USAGE.md +22 -3
  358. package/docs/README.md +15 -4
  359. package/docs/WORKFLOW.md +1 -0
  360. package/docs/architecture.md +12 -9
  361. package/docs/developer_guide.md +6 -6
  362. package/market_adapter/README.md +9 -26
  363. package/modules/README.md +4 -1
  364. package/package.json +4 -1
  365. package/scripts/README.md +14 -0
@@ -1,9 +1,34 @@
1
+ /**
2
+ * modules/credit_pricing.ts — Canonical credit-pricing math (single source of truth).
3
+ *
4
+ * Pure functions only: no imports, no I/O, browser-safe. Both the live
5
+ * credit runtime (modules/credit_runtime.ts) and the offline analyzer
6
+ * (scripts/analyze-credit.ts) delegate to these helpers so offer-price
7
+ * orientation, conversion rates, and collateral-ratio math cannot drift
8
+ * apart between surfaces.
9
+ *
10
+ * Conventions (mirror the chain's credit_offer_object price layout):
11
+ * - A 'core' price has base == debt asset / quote == collateral asset and
12
+ * the conversion rate (debt per 1 collateral) is base / quote.
13
+ * - A 'legacy-reversed' price has base == collateral / quote == debt and
14
+ * the rate is quote / base. Unknown layouts default to 'core'.
15
+ * - Credit CR = collateralValueInDebt / debtAmount, where
16
+ * collateralValueInDebt = collateralAmount * conversionRate.
17
+ */
18
+ interface PriceLeg {
19
+ amount?: unknown;
20
+ asset_id?: unknown;
21
+ }
22
+ interface OfferPrice {
23
+ base?: PriceLeg;
24
+ quote?: PriceLeg;
25
+ }
1
26
  /**
2
27
  * Tolerantly normalize an offer's acceptable_collateral map, which arrives
3
28
  * in different shapes depending on the API path (Map, [[id, price]] pairs,
4
29
  * [{key, value}] entries, or a plain {assetId: price} object).
5
30
  */
6
- declare function normalizeCollateralMap(raw: unknown): Map<string, any>;
31
+ declare function normalizeCollateralMap(raw: unknown): Map<string, OfferPrice>;
7
32
  declare function creditPriceOrientation(baseAssetId: string, quoteAssetId: string, debtAssetId: string, collateralAssetId: string): 'core' | 'legacy-reversed';
8
33
  /**
9
34
  * Extract the conversion rate (debt asset per 1 collateral unit) for a
@@ -20,17 +45,25 @@ declare function extractOfferConversionRate(offerCollateral: unknown, collateral
20
45
  * Value collateral (raw int) in debt-asset units via an offer price.
21
46
  * Pure offer-math leg of the runtime's pool-aware valuation.
22
47
  */
23
- declare function collateralValueFromOfferPrice(collateralAmountInt: unknown, collateralPrecision: unknown, collateralPriceOrMap: any, debtAssetId: string, collateralAssetId: string, precisionOf: (assetId: string) => number | null): number | null;
48
+ declare function collateralValueFromOfferPrice(collateralAmountInt: unknown, collateralPrecision: unknown, collateralPriceOrMap: unknown, debtAssetId: string, collateralAssetId: string, precisionOf: (assetId: string) => number | null): number | null;
24
49
  /**
25
50
  * Minimum raw collateral required to borrow a raw debt amount at a price.
26
51
  * Integer ceil so the borrow is never under-collateralized by rounding.
27
52
  */
28
- declare function requiredCollateralForBorrow(borrowAmountInt: unknown, collateralPrice: any, debtAssetId?: string | null, collateralAssetId?: string | null): number | null;
53
+ declare function requiredCollateralForBorrow(borrowAmountInt: unknown, collateralPrice: OfferPrice | null | undefined, debtAssetId?: string | null, collateralAssetId?: string | null): number | null;
29
54
  /**
30
55
  * Raw debt yielded by raw collateral at a price. Integer floor so the
31
56
  * borrow never exceeds what the collateral covers.
32
57
  */
33
- declare function borrowAmountForCollateral(collateralAmountInt: unknown, collateralPrice: any, debtAssetId?: string | null, collateralAssetId?: string | null): number | null;
58
+ declare function borrowAmountForCollateral(collateralAmountInt: unknown, collateralPrice: OfferPrice | null | undefined, debtAssetId?: string | null, collateralAssetId?: string | null): number | null;
59
+ /**
60
+ * Raw debt yielded by a raw collateral budget, never exceeding the requested
61
+ * raw debt. Returns `requestedBorrowInt` when no budget is supplied or the
62
+ * budget already covers it; `null` when a supplied budget cannot support any
63
+ * borrow at the offer price (caller should back off rather than emit a doomed
64
+ * accept op).
65
+ */
66
+ declare function capBorrowToCollateral(requestedBorrowInt: unknown, availableCollateralInt: unknown, collateralPrice: OfferPrice | null | undefined, debtAssetId?: string | null, collateralAssetId?: string | null): number | null;
34
67
  /**
35
68
  * Per-deal CR from floats plus a conversion rate:
36
69
  * (collateralFloat * rate) / debtFloat.
@@ -51,11 +84,14 @@ declare function averageCollateralRatio(entries: Array<{
51
84
  * Returns 0 for missing/non-positive inputs (matches runtime gating, where
52
85
  * a zero daily rate never exceeds maxFeeRatePerDay).
53
86
  */
54
- declare function dailyOfferFeeRate(offer: any, feeDenom: unknown): number;
87
+ declare function dailyOfferFeeRate(offer: {
88
+ fee_rate?: unknown;
89
+ max_duration_seconds?: unknown;
90
+ } | null | undefined, feeDenom: unknown): number;
55
91
  /**
56
92
  * Credit-deal repay fee in raw debt units, rounded up (Graphene ceil):
57
93
  * (repay * feeRate + denom - 1) / denom. Zero when nothing is owed.
58
94
  */
59
95
  declare function creditDealFee(repayAmountInt: unknown, feeRate: unknown, feeDenom: unknown): number;
60
- export { normalizeCollateralMap, creditPriceOrientation, extractOfferConversionRate, collateralValueFromOfferPrice, requiredCollateralForBorrow, borrowAmountForCollateral, creditDealCollateralRatio, averageCollateralRatio, dailyOfferFeeRate, creditDealFee, };
96
+ export { normalizeCollateralMap, creditPriceOrientation, extractOfferConversionRate, collateralValueFromOfferPrice, requiredCollateralForBorrow, borrowAmountForCollateral, capBorrowToCollateral, creditDealCollateralRatio, averageCollateralRatio, dailyOfferFeeRate, creditDealFee, };
61
97
  //# sourceMappingURL=credit_pricing.d.ts.map
@@ -1,21 +1,4 @@
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
2
  function toFiniteOrNull(value) {
20
3
  const num = typeof value === 'string' && value.trim() !== '' ? Number(value) : Number(value);
21
4
  return Number.isFinite(num) ? num : null;
@@ -43,8 +26,10 @@ function normalizeCollateralMap(raw) {
43
26
  if (Array.isArray(entry) && entry.length >= 2 && entry[0] && entry[1]) {
44
27
  out.set(String(entry[0]), entry[1]);
45
28
  }
46
- else if (entry && typeof entry === 'object' && entry.key && entry.value) {
47
- out.set(String(entry.key), entry.value);
29
+ else if (entry && typeof entry === 'object') {
30
+ const pair = entry;
31
+ if (pair.key && pair.value)
32
+ out.set(String(pair.key), pair.value);
48
33
  }
49
34
  }
50
35
  return out;
@@ -136,17 +121,30 @@ function collateralValueFromOfferPrice(collateralAmountInt, collateralPrecision,
136
121
  return collateralFloat * rate;
137
122
  }
138
123
  /**
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.
124
+ * Shared orientation resolution for the borrow/collateral conversion pair.
125
+ * Validates the offer price amounts and returns the base/quote factors plus
126
+ * the price orientation, so both directions cannot disagree on which way the
127
+ * factor applies. Null when the price is missing or unusable.
141
128
  */
142
- function requiredCollateralForBorrow(borrowAmountInt, collateralPrice, debtAssetId = null, collateralAssetId = null) {
143
- const borrowRaw = toFiniteOrNull(borrowAmountInt);
129
+ function resolvePriceFactors(collateralPrice, debtAssetId, collateralAssetId) {
144
130
  const baseAmount = toFiniteOrNull(collateralPrice?.base?.amount);
145
131
  const quoteAmount = toFiniteOrNull(collateralPrice?.quote?.amount);
146
- if (borrowRaw === null || borrowRaw <= 0 || baseAmount === null || quoteAmount === null || baseAmount <= 0 || quoteAmount <= 0) {
132
+ if (baseAmount === null || quoteAmount === null || baseAmount <= 0 || quoteAmount <= 0) {
147
133
  return null;
148
134
  }
149
135
  const orientation = creditPriceOrientation(String(collateralPrice?.base?.asset_id || ''), String(collateralPrice?.quote?.asset_id || ''), String(debtAssetId || ''), String(collateralAssetId || ''));
136
+ return { baseAmount, quoteAmount, orientation };
137
+ }
138
+ /**
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.
141
+ */
142
+ function requiredCollateralForBorrow(borrowAmountInt, collateralPrice, debtAssetId = null, collateralAssetId = null) {
143
+ const borrowRaw = toFiniteOrNull(borrowAmountInt);
144
+ const factors = resolvePriceFactors(collateralPrice, debtAssetId, collateralAssetId);
145
+ if (borrowRaw === null || borrowRaw <= 0 || factors === null)
146
+ return null;
147
+ const { baseAmount, quoteAmount, orientation } = factors;
150
148
  if (orientation === 'legacy-reversed') {
151
149
  return Math.ceil((Number(borrowAmountInt) * baseAmount) / quoteAmount);
152
150
  }
@@ -158,17 +156,33 @@ function requiredCollateralForBorrow(borrowAmountInt, collateralPrice, debtAsset
158
156
  */
159
157
  function borrowAmountForCollateral(collateralAmountInt, collateralPrice, debtAssetId = null, collateralAssetId = null) {
160
158
  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) {
159
+ const factors = resolvePriceFactors(collateralPrice, debtAssetId, collateralAssetId);
160
+ if (collRaw === null || collRaw <= 0 || factors === null)
164
161
  return null;
165
- }
166
- const orientation = creditPriceOrientation(String(collateralPrice?.base?.asset_id || ''), String(collateralPrice?.quote?.asset_id || ''), String(debtAssetId || ''), String(collateralAssetId || ''));
162
+ const { baseAmount, quoteAmount, orientation } = factors;
167
163
  if (orientation === 'legacy-reversed') {
168
164
  return Math.floor((Number(collateralAmountInt) * quoteAmount) / baseAmount);
169
165
  }
170
166
  return Math.floor((Number(collateralAmountInt) * baseAmount) / quoteAmount);
171
167
  }
168
+ /**
169
+ * Raw debt yielded by a raw collateral budget, never exceeding the requested
170
+ * raw debt. Returns `requestedBorrowInt` when no budget is supplied or the
171
+ * budget already covers it; `null` when a supplied budget cannot support any
172
+ * borrow at the offer price (caller should back off rather than emit a doomed
173
+ * accept op).
174
+ */
175
+ function capBorrowToCollateral(requestedBorrowInt, availableCollateralInt, collateralPrice, debtAssetId = null, collateralAssetId = null) {
176
+ const requested = toFiniteOrNull(requestedBorrowInt);
177
+ if (requested === null || requested <= 0)
178
+ return null;
179
+ if (availableCollateralInt === null || availableCollateralInt === undefined)
180
+ return requested;
181
+ const budgetBorrow = borrowAmountForCollateral(availableCollateralInt, collateralPrice, debtAssetId, collateralAssetId);
182
+ if (budgetBorrow === null || budgetBorrow <= 0)
183
+ return null;
184
+ return Math.min(requested, budgetBorrow);
185
+ }
172
186
  /**
173
187
  * Per-deal CR from floats plus a conversion rate:
174
188
  * (collateralFloat * rate) / debtFloat.
@@ -233,5 +247,5 @@ function creditDealFee(repayAmountInt, feeRate, feeDenom) {
233
247
  return 0;
234
248
  return Number(((repay * rate) + denom - 1n) / denom);
235
249
  }
236
- export { normalizeCollateralMap, creditPriceOrientation, extractOfferConversionRate, collateralValueFromOfferPrice, requiredCollateralForBorrow, borrowAmountForCollateral, creditDealCollateralRatio, averageCollateralRatio, dailyOfferFeeRate, creditDealFee, };
250
+ export { normalizeCollateralMap, creditPriceOrientation, extractOfferConversionRate, collateralValueFromOfferPrice, requiredCollateralForBorrow, borrowAmountForCollateral, capBorrowToCollateral, creditDealCollateralRatio, averageCollateralRatio, dailyOfferFeeRate, creditDealFee, };
237
251
  //# 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,132 @@ 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
+ _getCollateralPercentageBase(accountId: unknown, assetId: unknown): Promise<number | null>;
202
+ _enforceMaxCollateralAmount(policy: UnknownRecord, collateralInt: unknown, collateralAsset: UnknownRecord, accountId: unknown, options?: UnknownRecord): Promise<void>;
203
+ _calculateDailyFeeRate(offer: UnknownRecord): number;
93
204
  _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;
205
+ _validateCreditPolicy(policy: UnknownRecord, offer: UnknownRecord | null | undefined, deal?: UnknownRecord | null): UnknownRecord;
206
+ _calculateCollateralValueInDebtAsset(collateralAmountInt: unknown, collateralAsset: UnknownRecord, debtAsset: UnknownRecord, collateralPrice: unknown): Promise<number | null>;
207
+ _calculateCreditOfferCollateralValueInDebtAsset(collateralAmountInt: unknown, collateralAsset: UnknownRecord, debtAsset: UnknownRecord, collateralPrice: unknown): number | null;
208
+ _fetchBorrowerDeals(): Promise<DealSummary[]>;
209
+ _fetchOwnedCreditOffers(): Promise<CreditOfferSummary[]>;
210
+ _buildDebtSnapshot(): Promise<DebtSnapshot>;
211
+ refreshMpaState(lendingItem: UnknownRecord | null | undefined): Promise<unknown>;
212
+ refreshCreditState(options: UnknownRecord | undefined, lendingItem: UnknownRecord): Promise<unknown>;
213
+ refreshState(): Promise<unknown>;
214
+ _buildMpaPlanFromState(lendingItem: UnknownRecord, assetId: unknown): Promise<UnknownRecord | null>;
215
+ buildMpaUpdateOperation(plan: UnknownRecord, options: UnknownRecord | undefined, lendingItem: UnknownRecord, assetId: unknown): Promise<UnknownRecord | null>;
216
+ buildCreditOfferAcceptOperation({ offer, borrowAmount, collateralAmount, autoRepay, specificPolicy, pendingRepayAmount, pendingReleaseCollateralAmount, availableCollateralAmount }?: {
217
+ offer?: UnknownRecord | null;
218
+ borrowAmount?: unknown;
219
+ collateralAmount?: unknown;
109
220
  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>;
221
+ specificPolicy?: UnknownRecord | null;
222
+ pendingRepayAmount?: unknown;
223
+ pendingReleaseCollateralAmount?: unknown;
224
+ availableCollateralAmount?: number | null;
225
+ }): Promise<UnknownRecord>;
226
+ _calculateRequiredCollateral(borrowAmountInt: unknown, collateralPrice: Parameters<typeof sharedRequiredCollateralForBorrow>[1], debtAsset?: UnknownRecord | null, collateralAsset?: UnknownRecord | null): number | null;
227
+ _calculateCreditFee(repayAmountInt: unknown, feeRate: unknown): number;
228
+ buildCreditDealRepayOperation(deal: unknown, repayAmount: unknown): Promise<UnknownRecord>;
229
+ buildCreditDealUpdateOperation(deal: unknown, autoRepay: unknown): Promise<UnknownRecord>;
230
+ executeOperations(operations: unknown[], reason?: string): Promise<unknown>;
231
+ _checkGridMaintenanceAfterCreditUpdate(context?: unknown, options?: UnknownRecord): Promise<unknown>;
232
+ repayCreditDeal(deal: UnknownRecord, repayAmount: unknown, options?: UnknownRecord): Promise<unknown>;
233
+ queueReborrow(request: UnknownRecord): void;
234
+ _extractDealNumericId(id: unknown): number;
235
+ _collectActiveDealIds(): string[];
236
+ /**
237
+ * Pick a balance entry from a `getOnChainAssetBalances` result by asset id,
238
+ * falling back to the asset symbol. Centralizes the lookup shape shared by
239
+ * the percentage/amount resolvers and the credit helpers.
240
+ */
241
+ _pickOnChainBalanceEntry(balances: unknown, assetId: unknown, asset: UnknownRecord | null): UnknownRecord | null;
242
+ /**
243
+ * Read the chain-free balance of the debt asset. Returns null when the
244
+ * balance cannot be determined so callers can fall back to the legacy
245
+ * (full-deal) renewal path instead of guessing.
246
+ */
247
+ _getFreeDebtAssetBalance(debtAssetId: unknown, debtAsset: UnknownRecord | null): Promise<number | null>;
248
+ /**
249
+ * Raw collateral freed by a repay, used as the ceiling a reborrow can lock.
250
+ * Precedence:
251
+ * 1. explicit raw `options.availableCollateralAmount` (collateral-switch flow),
252
+ * 2. exact on-chain `floor(repay * collateral / debt)` when the deal's own
253
+ * collateral asset is used,
254
+ * 3. explicit `options.pendingReleaseCollateralAmount` (float) as a fallback.
255
+ * Returns null when it cannot be determined, so the accept builder keeps the
256
+ * legacy (unclamped) behaviour.
257
+ */
258
+ _computeReleasedCollateralInt(dealSummary: DealSummary | UnknownRecord | null, repayAmount: unknown, options: UnknownRecord): Promise<number | null>;
259
+ /**
260
+ * Decide how much of a maturing deal can actually be repaid and reborrowed
261
+ * with the currently free debt-asset balance. The repay leg is funded from
262
+ * the borrower's free balance before the atomic reborrow returns anything,
263
+ * so when the borrowed asset has been deployed into the grid the full deal
264
+ * cannot be renewed in one shot. In that case we roll the largest affordable
265
+ * piece (bounded by min_deal_amount and maxBorrowAmountPerOperation) and let
266
+ * the remaining debt be handled on the next cycle.
267
+ *
268
+ * Returns null when sizing is not possible (unknown balance / malformed
269
+ * deal) so the caller keeps the existing full-renewal behaviour.
270
+ */
271
+ _resolveRenewalSizing({ deal, debtAsset, offer, policy }: {
272
+ deal: UnknownRecord | null;
273
+ debtAsset: UnknownRecord | null;
274
+ offer: UnknownRecord | null;
275
+ policy: UnknownRecord | null;
276
+ }): Promise<UnknownRecord | null>;
277
+ _getOfferById(offerId: unknown): Promise<UnknownRecord | null>;
278
+ _fetchCreditOffersByAsset(assetId: unknown): Promise<UnknownRecord[]>;
279
+ _resolveFallbackAssetIds(policy: UnknownRecord, offer?: UnknownRecord | null): Promise<{
280
+ debtAssetId: string | null;
281
+ collateralAssetId: string | null;
282
+ }>;
283
+ _selectFallbackCreditOffer({ debtAssetId, collateralAssetId, policy, borrowAmount, collateralAmount, autoRepay, pendingRepayAmount, pendingReleaseCollateralAmount, availableCollateralAmount, excludeOfferId }?: {
284
+ debtAssetId?: unknown;
285
+ collateralAssetId?: unknown;
286
+ policy?: UnknownRecord;
287
+ borrowAmount?: unknown;
288
+ collateralAmount?: unknown;
289
+ autoRepay?: unknown;
290
+ pendingRepayAmount?: unknown;
291
+ pendingReleaseCollateralAmount?: unknown;
292
+ availableCollateralAmount?: number | null;
293
+ excludeOfferId?: unknown;
294
+ }): Promise<FallbackOfferCandidate | null>;
137
295
  _selectCreditOfferForIncrease({ debtAssetId, collateralAssetId, policy, collateralAmount, minCollateralIncrease, remainingBorrowCapacity, autoRepay }?: {
138
- debtAssetId?: any;
139
- collateralAssetId?: any;
140
- policy?: any;
141
- collateralAmount?: any;
296
+ debtAssetId?: unknown;
297
+ collateralAssetId?: unknown;
298
+ policy?: UnknownRecord;
299
+ collateralAmount?: unknown;
142
300
  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;
301
+ remainingBorrowCapacity?: unknown;
302
+ autoRepay?: unknown;
303
+ }): Promise<IncreaseOfferCandidate | null>;
304
+ _buildCreditIncreasePlan(lendingItem: UnknownRecord, assetId: unknown, posState: UnknownRecord): Promise<UnknownRecord | null>;
305
+ _splitOversizedCreditDeals(lendingItem: UnknownRecord, assetId: unknown, posState: UnknownRecord, runtimeContext?: UnknownRecord): Promise<unknown>;
306
+ _doSplitOversizedCreditDeals(lendingItem: UnknownRecord, assetId: unknown, posState: UnknownRecord, _runtimeContext?: UnknownRecord): Promise<unknown>;
307
+ _getDealById(dealId: unknown): Promise<UnknownRecord | null>;
308
+ processPendingReborrows(): Promise<unknown>;
309
+ _runMpaMaintenance(context: unknown, _options: UnknownRecord, lendingItem: UnknownRecord, assetId: unknown): Promise<unknown>;
310
+ _runCreditMaintenance(lendingItem: UnknownRecord, assetId: unknown, runtimeContext?: UnknownRecord): Promise<unknown>;
311
+ runMaintenance(context?: unknown, options?: UnknownRecord): Promise<unknown>;
312
+ runCreditWatchdog(): Promise<unknown>;
313
+ getStateSnapshot(): unknown;
156
314
  }
157
315
  export default CreditRuntime;
158
316
  //# sourceMappingURL=credit_runtime.d.ts.map