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.
- package/CHANGELOG.md +67 -4
- package/README.md +2 -1
- package/analysis/README.md +11 -11
- package/analysis/ama_fitting/README.md +5 -3
- package/analysis/tradingview/README.md +1 -1
- package/analysis/trend_detection/DYNAMIC_WEIGHT_RESEARCH.md +3 -3
- package/claw/README.md +1 -0
- package/claw/docs/AI_BOT_LIBRARY_API.md +2 -0
- package/claw/docs/DEXBOT2_TUNING_CHEAT_SHEET.md +4 -3
- package/claw/modules/chain_broadcast.ts +7 -1
- package/claw/modules/claw_bridge.ts +0 -3
- package/claw/modules/claw_launcher.ts +1 -1
- package/claw/modules/claw_skill_md.ts +1 -0
- package/claw/modules/launcher_mode_detector.ts +9 -2
- package/claw/package.json +3 -3
- package/claw/runtimes/openclaw-plugin/openclaw.plugin.json +1 -1
- package/claw/runtimes/openclaw-plugin/package.json +1 -1
- package/claw/tsconfig.json +2 -2
- package/dist/analysis/account_resolver.d.ts +1 -1
- package/dist/analysis/account_resolver.js +2 -1
- package/dist/analysis/ama_fitting/analyze_ama_price_changes.js +3 -4
- package/dist/analysis/ama_fitting/analyze_lambda_vs_slow.js +3 -21
- package/dist/analysis/ama_fitting/calibrate_convergence_er.js +0 -1
- package/dist/analysis/ama_fitting/fetch_lp_candles.js +55 -45
- package/dist/analysis/ama_fitting/generate_unified_comparison_chart.d.ts +1 -8
- package/dist/analysis/ama_fitting/generate_unified_comparison_chart.js +45 -24
- package/dist/analysis/ama_fitting/optimizer_high_resolution.js +34 -78
- package/dist/analysis/analyze_args.d.ts +43 -0
- package/dist/analysis/analyze_args.js +61 -0
- package/dist/analysis/analyze_dynamic_weight.js +7 -17
- package/dist/analysis/analyze_kalman.js +7 -17
- package/dist/analysis/analyze_regime.js +7 -17
- package/dist/analysis/analyze_regime_windows.js +8 -18
- package/dist/analysis/analyze_risk_profile.js +8 -18
- package/dist/analysis/analyze_trade_heatmap.js +7 -17
- package/dist/analysis/analyze_volatility.js +7 -17
- package/dist/analysis/bot_fitting/backtest_ama_sweep.d.ts +221 -28
- package/dist/analysis/bot_fitting/backtest_ama_sweep.js +23 -103
- package/dist/analysis/bot_fitting/backtest_bot_fitting.d.ts +34 -4
- package/dist/analysis/bot_fitting/backtest_bot_fitting.js +32 -150
- package/dist/analysis/bot_fitting/backtest_lookback_drawdown.js +19 -34
- package/dist/analysis/bot_fitting/shared_utils.d.ts +77 -9
- package/dist/analysis/bot_fitting/shared_utils.js +125 -9
- package/dist/analysis/bot_key_utils.d.ts +18 -10
- package/dist/analysis/bot_key_utils.js +7 -4
- package/dist/analysis/bot_usage/discover_bot_accounts.js +44 -47
- package/dist/analysis/bot_usage/kibana_bot_queries.d.ts +1 -21
- package/dist/analysis/chain_pool.d.ts +3 -1
- package/dist/analysis/chart_ui.d.ts +35 -3
- package/dist/analysis/chart_ui.js +43 -4
- package/dist/analysis/chart_utils.d.ts +5 -5
- package/dist/analysis/chart_utils.js +9 -0
- package/dist/analysis/fills_cache.d.ts +4 -24
- package/dist/analysis/fills_cache.js +3 -84
- package/dist/analysis/fills_source.d.ts +33 -3
- package/dist/analysis/fills_source.js +83 -13
- package/dist/analysis/grid_correction_check.d.ts +2 -24
- package/dist/analysis/grid_correction_check.js +27 -69
- package/dist/analysis/math_utils.d.ts +91 -6
- package/dist/analysis/math_utils.js +119 -7
- package/dist/analysis/pnl_report.js +29 -29
- package/dist/analysis/price_sources.d.ts +30 -9
- package/dist/analysis/price_sources.js +28 -4
- package/dist/analysis/resolve_bot_accounts.js +2 -2
- package/dist/analysis/resolve_source.d.ts +1 -1
- package/dist/analysis/resolve_source.js +31 -10
- package/dist/analysis/trade_profitability.d.ts +29 -2
- package/dist/analysis/trade_profitability.js +73 -147
- package/dist/analysis/tradingview/analyze_tradingview.d.ts +3 -8
- package/dist/analysis/tradingview/analyze_tradingview.js +7 -6
- package/dist/analysis/tradingview/grid_reset_config.d.ts +41 -32
- package/dist/analysis/tradingview/grid_reset_config.js +23 -11
- package/dist/analysis/tradingview/grid_reset_sim.d.ts +75 -9
- package/dist/analysis/tradingview/grid_reset_sim.js +4 -3
- package/dist/analysis/tradingview/tradingview_uplot_chart_generator.d.ts +69 -4
- package/dist/analysis/tradingview/tradingview_uplot_chart_generator.js +20 -34
- package/dist/analysis/trend_detection/backtest_ama_slope_huber.d.ts +1 -101
- package/dist/analysis/trend_detection/backtest_ama_slope_huber.js +26 -84
- package/dist/analysis/trend_detection/dynamic_weight_chart_generator.d.ts +63 -1
- package/dist/analysis/trend_detection/dynamic_weight_chart_generator.js +16 -41
- package/dist/analysis/trend_detection/huber_scale_variants.d.ts +9 -3
- package/dist/analysis/trend_detection/huber_scale_variants.js +4 -4
- package/dist/analysis/trend_detection/kalman_chart_generator.d.ts +30 -1
- package/dist/analysis/trend_detection/kalman_chart_generator.js +3 -3
- package/dist/analysis/trend_detection/regime_chart_generator.d.ts +31 -1
- package/dist/analysis/trend_detection/regime_chart_generator.js +2 -2
- package/dist/analysis/trend_detection/volatility_chart_generator.d.ts +33 -1
- package/dist/analysis/trend_detection/volatility_chart_generator.js +9 -10
- package/dist/analysis/worker_pool.d.ts +38 -0
- package/dist/analysis/worker_pool.js +67 -0
- package/dist/credential-daemon.js +34 -20
- package/dist/dexbot.js +78 -59
- package/dist/market_adapter/ama_signal_runner.js +21 -54
- package/dist/market_adapter/candle_utils.d.ts +29 -19
- package/dist/market_adapter/candle_utils.js +35 -21
- package/dist/market_adapter/cli_args.d.ts +22 -0
- package/dist/market_adapter/cli_args.js +30 -0
- package/dist/market_adapter/core/asymmetric_bounds.d.ts +13 -4
- package/dist/market_adapter/core/config_normalizers.d.ts +3 -3
- package/dist/market_adapter/core/config_normalizers.js +11 -6
- package/dist/market_adapter/core/kibana_candles.d.ts +56 -19
- package/dist/market_adapter/core/kibana_candles.js +12 -9
- package/dist/market_adapter/core/kibana_client.d.ts +9 -1
- package/dist/market_adapter/core/kibana_client.js +8 -7
- package/dist/market_adapter/core/kibana_market_candles.d.ts +3 -2
- package/dist/market_adapter/core/market_adapter_service.d.ts +320 -153
- package/dist/market_adapter/core/market_adapter_service.js +228 -269
- package/dist/market_adapter/core/signals/hurst_analyzer.d.ts +1 -6
- package/dist/market_adapter/core/signals/hurst_analyzer.js +1 -1
- package/dist/market_adapter/core/signals/permutation_entropy_analyzer.d.ts +1 -11
- package/dist/market_adapter/core/signals/permutation_entropy_analyzer.js +1 -1
- package/dist/market_adapter/core/strategies/ama.d.ts +10 -2
- package/dist/market_adapter/core/strategies/ama.js +2 -4
- package/dist/market_adapter/core/strategies/ama_slope_model.d.ts +14 -1
- package/dist/market_adapter/core/strategies/ama_slope_model.js +12 -34
- package/dist/market_adapter/core/strategies/atr/calculator.d.ts +7 -2
- package/dist/market_adapter/core/strategies/atr/calculator.js +2 -34
- package/dist/market_adapter/core/strategies/collateral_manager.d.ts +7 -1
- package/dist/market_adapter/core/strategies/collateral_manager.js +0 -22
- package/dist/market_adapter/core/strategies/dynamic_weight_series.d.ts +34 -6
- package/dist/market_adapter/core/strategies/dynamic_weight_series.js +7 -7
- package/dist/market_adapter/core/strategies/regime_gate.d.ts +24 -15
- package/dist/market_adapter/core/strategies/regime_gate.js +4 -31
- package/dist/market_adapter/core/strategies/regime_interp.d.ts +7 -1
- package/dist/market_adapter/core/strategies/regime_interp.js +14 -22
- package/dist/market_adapter/core/strategies/volatility_shift.d.ts +11 -1
- package/dist/market_adapter/core/strategies/volatility_shift.js +0 -13
- package/dist/market_adapter/inputs/cex_candle_parsing.d.ts +29 -0
- package/dist/market_adapter/inputs/cex_candle_parsing.js +52 -0
- package/dist/market_adapter/inputs/fetch_book_data.d.ts +20 -4
- package/dist/market_adapter/inputs/fetch_book_data.js +3 -2
- package/dist/market_adapter/inputs/fetch_cex_synthetic_data.js +160 -332
- package/dist/market_adapter/inputs/fetch_lp_data.d.ts +50 -8
- package/dist/market_adapter/inputs/fetch_lp_data.js +47 -22
- package/dist/market_adapter/inputs/kibana_feed_source.d.ts +74 -15
- package/dist/market_adapter/inputs/kibana_feed_source.js +26 -41
- package/dist/market_adapter/inputs/kibana_source.d.ts +25 -3
- package/dist/market_adapter/inputs/kibana_source.js +2 -2
- package/dist/market_adapter/inputs/window_cache.d.ts +93 -156
- package/dist/market_adapter/inputs/window_cache.js +59 -184
- package/dist/market_adapter/interval_utils.d.ts +15 -5
- package/dist/market_adapter/interval_utils.js +16 -1
- package/dist/market_adapter/log_format.d.ts +6 -6
- package/dist/market_adapter/log_format.js +28 -21
- package/dist/market_adapter/lp_chart_core.d.ts +22 -1
- package/dist/market_adapter/lp_chart_core.js +26 -192
- package/dist/market_adapter/lp_chart_runner.d.ts +10 -7
- package/dist/market_adapter/lp_chart_runner.js +37 -19
- package/dist/market_adapter/lp_chart_strategy_loader.d.ts +41 -6
- package/dist/market_adapter/lp_chart_strategy_loader.js +8 -7
- package/dist/market_adapter/market_adapter.d.ts +94 -32
- package/dist/market_adapter/market_adapter.js +94 -120
- package/dist/market_adapter/utils/adapter_client.d.ts +3 -3
- package/dist/market_adapter/utils/adapter_client.js +2 -2
- package/dist/market_adapter/utils/atomic_write.d.ts +8 -1
- package/dist/market_adapter/utils/chain.d.ts +50 -41
- package/dist/market_adapter/utils/chain.js +40 -46
- package/dist/market_adapter/utils/data_discovery.d.ts +49 -2
- package/dist/market_adapter/utils/data_discovery.js +220 -27
- package/dist/market_adapter/utils/dynamic_grid_snapshot.d.ts +12 -3
- package/dist/market_adapter/utils/file_json_cache.d.ts +2 -2
- package/dist/market_adapter/utils/file_lock.d.ts +28 -14
- package/dist/market_adapter/utils/file_lock.js +36 -32
- package/dist/market_adapter/utils/month_shards.d.ts +84 -0
- package/dist/market_adapter/utils/month_shards.js +237 -0
- package/dist/market_adapter/utils/native_history.d.ts +9 -2
- package/dist/market_adapter/utils/native_history.js +35 -28
- package/dist/modules/account_bots.d.ts +578 -21
- package/dist/modules/account_bots.js +272 -267
- package/dist/modules/account_orders.d.ts +79 -30
- package/dist/modules/account_orders.js +60 -64
- package/dist/modules/authority_resolver.d.ts +12 -2
- package/dist/modules/authority_resolver.js +15 -8
- package/dist/modules/bitshares-native/chain_client.d.ts +39 -4
- package/dist/modules/bitshares-native/chain_client.js +59 -59
- package/dist/modules/bitshares-native/crypto/ecc.browser.js +11 -171
- package/dist/modules/bitshares-native/crypto/ecc.js +13 -176
- package/dist/modules/bitshares-native/crypto/ecc_core.d.ts +33 -0
- package/dist/modules/bitshares-native/crypto/ecc_core.js +213 -0
- package/dist/modules/bitshares-native/crypto/ecc_selector.d.ts +2 -1
- package/dist/modules/bitshares-native/crypto/ecc_selector.js +1 -13
- package/dist/modules/bitshares-native/index.d.ts +1 -1
- package/dist/modules/bitshares-native/lru_cache.d.ts +7 -7
- package/dist/modules/bitshares-native/resolvers.d.ts +18 -6
- package/dist/modules/bitshares-native/resolvers.js +22 -25
- package/dist/modules/bitshares-native/serial/lazy_buffer.d.ts +4 -0
- package/dist/modules/bitshares-native/serial/lazy_buffer.js +21 -0
- package/dist/modules/bitshares-native/serial/operations.d.ts +1 -1
- package/dist/modules/bitshares-native/serial/serializer.d.ts +16 -12
- package/dist/modules/bitshares-native/serial/serializer.js +7 -13
- package/dist/modules/bitshares-native/serial/types.d.ts +25 -16
- package/dist/modules/bitshares-native/serial/types.js +73 -108
- package/dist/modules/bitshares-native/signing_client.d.ts +32 -2
- package/dist/modules/bitshares-native/signing_client.js +19 -14
- package/dist/modules/bitshares-native/subscriptions.d.ts +81 -1
- package/dist/modules/bitshares-native/subscriptions.js +12 -12
- package/dist/modules/bitshares-native/transport.d.ts +5 -4
- package/dist/modules/bitshares-native/transport.js +5 -4
- package/dist/modules/bitshares-native/tx/builder.d.ts +40 -5
- package/dist/modules/bitshares-native/tx/builder.js +4 -3
- package/dist/modules/bitshares-native/tx/tx_cache.d.ts +4 -4
- package/dist/modules/bitshares_client.d.ts +45 -13
- package/dist/modules/bitshares_client.js +28 -19
- package/dist/modules/bot_defaults.d.ts +8 -16
- package/dist/modules/bot_defaults.js +1 -5
- package/dist/modules/bot_settings.d.ts +44 -10
- package/dist/modules/bot_settings.js +11 -8
- package/dist/modules/bots_file_lock.d.ts +6 -6
- package/dist/modules/bots_file_lock.js +16 -12
- package/dist/modules/broadcast_failure.d.ts +4 -3
- package/dist/modules/broadcast_failure.js +5 -4
- package/dist/modules/chain_keys.d.ts +42 -40
- package/dist/modules/chain_keys.js +53 -45
- package/dist/modules/chain_orders.d.ts +94 -60
- package/dist/modules/chain_orders.js +81 -118
- package/dist/modules/cli_start_onboarding.d.ts +2 -1
- package/dist/modules/constants.d.ts +534 -32
- package/dist/modules/constants.js +35 -48
- package/dist/modules/cr_planner.d.ts +41 -3
- package/dist/modules/cr_planner.js +1 -5
- package/dist/modules/credential_policy.d.ts +68 -8
- package/dist/modules/credential_policy.js +37 -31
- package/dist/modules/credential_session_cache.d.ts +2 -2
- package/dist/modules/credit_pricing.d.ts +43 -6
- package/dist/modules/credit_pricing.js +70 -60
- package/dist/modules/credit_runtime.d.ts +283 -118
- package/dist/modules/credit_runtime.js +500 -231
- package/dist/modules/crypto/browser_provider.js +6 -4
- package/dist/modules/crypto/node_provider.js +1 -1
- package/dist/modules/crypto/pure_scrypt.js +35 -4
- package/dist/modules/crypto/pure_secp256k1.js +72 -26
- package/dist/modules/crypto/sync.d.ts +9 -9
- package/dist/modules/crypto/sync.js +16 -9
- package/dist/modules/daemon_node_health.d.ts +4 -3
- package/dist/modules/dexbot_class.d.ts +213 -146
- package/dist/modules/dexbot_class.js +183 -86
- package/dist/modules/dexbot_cow_runtime.d.ts +160 -87
- package/dist/modules/dexbot_cow_runtime.js +302 -234
- package/dist/modules/dexbot_credential_client.d.ts +19 -18
- package/dist/modules/dexbot_credential_client.js +1 -2
- package/dist/modules/dexbot_fill_runtime.d.ts +63 -49
- package/dist/modules/dexbot_fill_runtime.js +53 -47
- package/dist/modules/dexbot_maintenance_runtime.d.ts +127 -71
- package/dist/modules/dexbot_maintenance_runtime.js +187 -147
- package/dist/modules/dexbot_startup_runtime.d.ts +11 -11
- package/dist/modules/dexbot_startup_runtime.js +56 -57
- package/dist/modules/dexbot_state_recovery.d.ts +13 -12
- package/dist/modules/dexbot_state_recovery.js +18 -13
- package/dist/modules/fund_registry.d.ts +4 -2
- package/dist/modules/fund_registry.js +10 -10
- package/dist/modules/general_settings.d.ts +30 -4
- package/dist/modules/graceful_shutdown.d.ts +3 -3
- package/dist/modules/graceful_shutdown.js +19 -13
- package/dist/modules/grid_price_source.d.ts +1 -1
- package/dist/modules/key_store.d.ts +14 -8
- package/dist/modules/key_store.js +7 -7
- package/dist/modules/launcher/adapter_requirement.d.ts +11 -5
- package/dist/modules/launcher/adapter_requirement.js +5 -5
- package/dist/modules/launcher/bot_supervisor.d.ts +106 -24
- package/dist/modules/launcher/bot_supervisor.js +12 -11
- package/dist/modules/launcher/credential_bootstrap.d.ts +1 -1
- package/dist/modules/launcher/credential_bootstrap.js +1 -1
- package/dist/modules/launcher/credential_daemon.d.ts +4 -4
- package/dist/modules/launcher/credential_daemon.js +2 -2
- package/dist/modules/launcher/credential_secret.d.ts +1 -1
- package/dist/modules/launcher/foreign_cred_daemon.d.ts +2 -2
- package/dist/modules/launcher/market_adapter_runtime.d.ts +61 -6
- package/dist/modules/launcher/market_adapter_watchdog.d.ts +10 -2
- package/dist/modules/launcher/market_adapter_watchdog.js +4 -0
- package/dist/modules/launcher/monolithic_runtime.d.ts +18 -16
- package/dist/modules/launcher/status_reporting.d.ts +22 -14
- package/dist/modules/launcher/supervisor_control.d.ts +8 -1
- package/dist/modules/launcher/supervisor_control.js +4 -2
- package/dist/modules/lazy_shim.d.ts +11 -0
- package/dist/modules/lazy_shim.js +16 -0
- package/dist/modules/market_adapter_whitelist.d.ts +9 -3
- package/dist/modules/market_adapter_whitelist.js +15 -3
- package/dist/modules/node_connect_policy.d.ts +3 -2
- package/dist/modules/node_failure_ledger.d.ts +6 -5
- package/dist/modules/node_manager.d.ts +41 -11
- package/dist/modules/node_manager.js +5 -4
- package/dist/modules/order/accounting.d.ts +53 -24
- package/dist/modules/order/accounting.js +16 -15
- package/dist/modules/order/async_lock.d.ts +5 -2
- package/dist/modules/order/async_lock.js +1 -1
- package/dist/modules/order/export.d.ts +7 -6
- package/dist/modules/order/export.js +1 -7
- package/dist/modules/order/format.d.ts +16 -7
- package/dist/modules/order/format.js +15 -3
- package/dist/modules/order/genesis_policy.d.ts +24 -21
- package/dist/modules/order/genesis_policy.js +17 -10
- package/dist/modules/order/grid.d.ts +144 -36
- package/dist/modules/order/grid.js +226 -145
- package/dist/modules/order/grid_reconcile.d.ts +21 -20
- package/dist/modules/order/grid_reconcile.js +13 -12
- package/dist/modules/order/grid_reconcile_internal.d.ts +85 -72
- package/dist/modules/order/grid_reconcile_internal.js +28 -19
- package/dist/modules/order/index.d.ts +264 -1
- package/dist/modules/order/logger.d.ts +46 -19
- package/dist/modules/order/logger.js +38 -49
- package/dist/modules/order/logger_state.d.ts +4 -4
- package/dist/modules/order/manager.d.ts +232 -191
- package/dist/modules/order/manager.js +110 -130
- package/dist/modules/order/processed_fill_store.d.ts +18 -3
- package/dist/modules/order/processed_fill_store.js +16 -27
- package/dist/modules/order/strategy.d.ts +21 -13
- package/dist/modules/order/strategy.js +5 -6
- package/dist/modules/order/sync_engine.d.ts +91 -33
- package/dist/modules/order/sync_engine.js +84 -53
- package/dist/modules/order/utils/math.d.ts +157 -102
- package/dist/modules/order/utils/math.js +77 -38
- package/dist/modules/order/utils/order.d.ts +310 -110
- package/dist/modules/order/utils/order.js +153 -126
- package/dist/modules/order/utils/slot.d.ts +1 -1
- package/dist/modules/order/utils/system.d.ts +156 -26
- package/dist/modules/order/utils/system.js +103 -71
- package/dist/modules/order/utils/validate.d.ts +89 -41
- package/dist/modules/order/utils/validate.js +26 -24
- package/dist/modules/order/utils/withPoolRef.d.ts +6 -4
- package/dist/modules/order/utils/withPoolRef.js +18 -12
- package/dist/modules/order/working_grid.d.ts +14 -13
- package/dist/modules/paths.d.ts +1 -4
- package/dist/modules/paths.js +33 -61
- package/dist/modules/process_discovery.d.ts +1 -1
- package/dist/modules/process_discovery.js +2 -1
- package/dist/modules/runtime.d.ts +7 -3
- package/dist/modules/runtime.js +4 -3
- package/dist/modules/runtime_settings.d.ts +14 -11
- package/dist/modules/runtime_settings.js +30 -24
- package/dist/modules/settings_merge.d.ts +29 -3
- package/dist/modules/settings_merge.js +56 -78
- package/dist/modules/socket_json_client.d.ts +9 -5
- package/dist/modules/storage/browser_adapter.d.ts +38 -53
- package/dist/modules/storage/browser_adapter.js +7 -30
- package/dist/modules/storage/index.d.ts +1 -1
- package/dist/modules/storage/node_adapter.d.ts +45 -27
- package/dist/modules/storage/node_adapter.js +9 -9
- package/dist/modules/storage/types.d.ts +5 -4
- package/dist/modules/types.d.ts +1090 -6
- package/dist/modules/types.js +4 -1
- package/dist/modules/utils/asset_symbols.d.ts +2 -1
- package/dist/modules/utils/asset_symbols.js +2 -1
- package/dist/modules/utils/errors.d.ts +9 -0
- package/dist/modules/utils/errors.js +24 -4
- package/dist/modules/utils/time_range.d.ts +1 -12
- package/dist/modules/utils/time_range.js +1 -1
- package/dist/modules/validate_profiles.js +53 -43
- package/dist/modules/version_notice.d.ts +23 -11
- package/dist/modules/version_notice.js +6 -4
- package/dist/pm2.d.ts +28 -27
- package/dist/pm2.js +61 -40
- package/dist/scripts/analyze-credit.d.ts +2 -1
- package/dist/scripts/analyze-credit.js +23 -24
- package/dist/scripts/analyze-git.js +2 -15
- package/dist/scripts/analyze-orders.d.ts +77 -9
- package/dist/scripts/analyze-orders.js +65 -40
- package/dist/scripts/chart_command.d.ts +27 -18
- package/dist/scripts/chart_command.js +15 -13
- package/dist/scripts/check_any.d.ts +22 -0
- package/dist/scripts/check_any.js +158 -0
- package/dist/scripts/diagnose-pool-history.js +13 -13
- package/dist/scripts/print_grid.js +0 -1
- package/dist/scripts/run-tests.js +39 -8
- package/dist/scripts/runner.js +1 -1
- package/dist/scripts/sync-version.js +0 -10
- package/dist/scripts/test-credit-renewal.js +30 -21
- package/dist/scripts/update.d.ts +10 -5
- package/dist/scripts/update.js +168 -103
- package/dist/scripts/update_dist_freshness.js +1 -0
- package/dist/scripts/update_layout.d.ts +61 -0
- package/dist/scripts/update_layout.js +180 -0
- package/dist/scripts/validate_bots.js +2 -1
- package/dist/scripts/verify-browser-bundle.js +8 -0
- package/dist/unlock.d.ts +28 -3
- package/dist/unlock.js +63 -35
- package/docs/BITSHARES_ONBOARDING.md +10 -12
- package/docs/COPY_ON_WRITE_MASTER_PLAN.md +2 -2
- package/docs/COW_INVARIANTS.md +13 -6
- package/docs/DEXBOT_COMPARISON.md +8 -8
- package/docs/EVOLUTION.md +10 -8
- package/docs/FUND_MOVEMENT_AND_ACCOUNTING.md +5 -5
- package/docs/GRID_RECALCULATION.md +4 -2
- package/docs/GRID_RECONCILE.md +14 -3
- package/docs/LIFECYCLE.md +11 -11
- package/docs/MPA_CREDIT_USAGE.md +22 -3
- package/docs/README.md +14 -3
- package/docs/WORKFLOW.md +1 -0
- package/docs/architecture.md +31 -19
- package/docs/developer_guide.md +6 -6
- package/market_adapter/README.md +12 -5
- package/modules/README.md +4 -1
- package/package.json +9 -9
- package/scripts/README.md +43 -38
- package/tests/README.md +25 -10
- package/dist/scripts/diagnose-kibana-candles.d.ts +0 -3
- package/dist/scripts/diagnose-kibana-candles.js +0 -82
- package/scripts/git-viewer.sh +0 -489
- 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'
|
|
47
|
-
|
|
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 =
|
|
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 =
|
|
124
|
-
const collPrec =
|
|
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
|
-
*
|
|
140
|
-
*
|
|
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
|
|
143
|
-
const
|
|
144
|
-
const
|
|
145
|
-
|
|
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
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
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
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
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
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
return Math.
|
|
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 =
|
|
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 =
|
|
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 =
|
|
212
|
-
const maxDurationSeconds =
|
|
213
|
-
const denom =
|
|
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 =
|
|
225
|
-
const rateRaw =
|
|
226
|
-
const denomRaw =
|
|
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:
|
|
3
|
-
config:
|
|
4
|
-
options:
|
|
5
|
-
|
|
6
|
-
|
|
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<
|
|
11
|
-
_objectCache: Map<
|
|
12
|
-
_fullAccountCache:
|
|
13
|
-
|
|
14
|
-
|
|
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:
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
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:
|
|
47
|
-
_resolveAccountId(accountRef:
|
|
48
|
-
_resolveAccountName(accountRef:
|
|
49
|
-
_getFullAccount(accountRef:
|
|
50
|
-
_resolveAsset(assetRef:
|
|
51
|
-
_resolveBitassetData(assetRef:
|
|
52
|
-
_computeBtsPerDebt(settlementPrice:
|
|
53
|
-
_normalizePolicyList(value:
|
|
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?:
|
|
56
|
-
_resolveAmountToBlockchainInt(spec:
|
|
57
|
-
|
|
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:
|
|
172
|
+
_resolveMpaFeedPrice(debtAssetId: unknown, collateralAssetId: unknown, options?: {
|
|
68
173
|
includeSource?: boolean;
|
|
69
|
-
}): Promise<
|
|
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:
|
|
188
|
+
_resolveCreditConversionRate(lendingItem: UnknownRecord | null | undefined, debtAssetId: unknown, collateralAssetId: unknown, options?: {
|
|
81
189
|
includeSource?: boolean;
|
|
82
|
-
}): Promise<
|
|
190
|
+
}): Promise<number | {
|
|
191
|
+
price: number | null;
|
|
192
|
+
source: string;
|
|
193
|
+
} | null>;
|
|
83
194
|
_calculateCollateralDistribution(): Promise<void>;
|
|
84
|
-
_precisionOfPair(debtAsset:
|
|
85
|
-
_extractRateFromCollateralMap(collateralMap:
|
|
86
|
-
_calculateBorrowAmountFromCollateral(collateralAmountInt:
|
|
87
|
-
_enforceMaxBorrowAmount(policy:
|
|
88
|
-
_getCreditDebtForAsset(asset:
|
|
89
|
-
_getCreditCollateralForAsset(asset:
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
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:
|
|
95
|
-
_calculateCollateralValueInDebtAsset(collateralAmountInt:
|
|
96
|
-
_calculateCreditOfferCollateralValueInDebtAsset(collateralAmountInt:
|
|
97
|
-
_fetchBorrowerDeals(): Promise<
|
|
98
|
-
_fetchOwnedCreditOffers(): Promise<
|
|
99
|
-
_buildDebtSnapshot(): Promise<
|
|
100
|
-
refreshMpaState(lendingItem:
|
|
101
|
-
refreshCreditState(options:
|
|
102
|
-
refreshState(): Promise<
|
|
103
|
-
_buildMpaPlanFromState(lendingItem:
|
|
104
|
-
buildMpaUpdateOperation(plan:
|
|
105
|
-
buildCreditOfferAcceptOperation({ offer, borrowAmount, collateralAmount, autoRepay, specificPolicy, pendingRepayAmount, pendingReleaseCollateralAmount }?: {
|
|
106
|
-
offer?:
|
|
107
|
-
borrowAmount?:
|
|
108
|
-
collateralAmount?:
|
|
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?:
|
|
111
|
-
pendingRepayAmount?:
|
|
112
|
-
pendingReleaseCollateralAmount?:
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
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?:
|
|
139
|
-
collateralAssetId?:
|
|
140
|
-
policy?:
|
|
141
|
-
collateralAmount?:
|
|
303
|
+
debtAssetId?: unknown;
|
|
304
|
+
collateralAssetId?: unknown;
|
|
305
|
+
policy?: UnknownRecord;
|
|
306
|
+
collateralAmount?: unknown;
|
|
142
307
|
minCollateralIncrease?: number;
|
|
143
|
-
remainingBorrowCapacity?:
|
|
144
|
-
autoRepay?:
|
|
145
|
-
}): Promise<
|
|
146
|
-
_buildCreditIncreasePlan(lendingItem:
|
|
147
|
-
_splitOversizedCreditDeals(lendingItem:
|
|
148
|
-
_doSplitOversizedCreditDeals(lendingItem:
|
|
149
|
-
_getDealById(dealId:
|
|
150
|
-
processPendingReborrows(): Promise<
|
|
151
|
-
_runMpaMaintenance(context:
|
|
152
|
-
_runCreditMaintenance(lendingItem:
|
|
153
|
-
runMaintenance(context?:
|
|
154
|
-
runCreditWatchdog(): Promise<
|
|
155
|
-
getStateSnapshot():
|
|
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
|