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.
- package/CHANGELOG.md +50 -3
- package/README.md +3 -1
- package/analysis/README.md +51 -11
- package/analysis/bot_fitting/README.md +12 -0
- package/analysis/tradingview/README.md +3 -3
- package/analysis/trend_detection/DYNAMIC_WEIGHT_RESEARCH.md +11 -37
- package/analysis/trend_detection/README.md +31 -0
- package/claw/docs/DEXBOT2_TUNING_CHEAT_SHEET.md +4 -3
- package/claw/modules/chain_broadcast.ts +7 -1
- package/claw/modules/claw_launcher.ts +1 -1
- package/claw/modules/launcher_mode_detector.ts +9 -2
- package/claw/package.json +1 -1
- package/claw/runtimes/openclaw-plugin/openclaw.plugin.json +1 -1
- package/claw/runtimes/openclaw-plugin/package.json +1 -1
- package/dist/analysis/account_resolver.d.ts +1 -1
- package/dist/analysis/account_resolver.js +15 -2
- package/dist/analysis/ama_fitting/analyze_ama_price_changes.js +3 -4
- package/dist/analysis/ama_fitting/analyze_lambda_vs_slow.js +2 -7
- package/dist/analysis/ama_fitting/calibrate_convergence_er.js +0 -1
- package/dist/analysis/ama_fitting/fetch_lp_candles.js +4 -4
- package/dist/analysis/ama_fitting/generate_unified_comparison_chart.d.ts +20 -4
- package/dist/analysis/ama_fitting/generate_unified_comparison_chart.js +9 -6
- package/dist/analysis/ama_fitting/optimizer_high_resolution.js +16 -12
- package/dist/analysis/analyze_args.d.ts +31 -0
- package/dist/analysis/analyze_args.js +41 -0
- package/dist/analysis/analyze_dynamic_weight.js +7 -20
- 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 +220 -12
- package/dist/analysis/bot_fitting/backtest_ama_sweep.js +55 -10
- package/dist/analysis/bot_fitting/backtest_bot_fitting.d.ts +34 -4
- package/dist/analysis/bot_fitting/backtest_bot_fitting.js +72 -66
- package/dist/analysis/bot_fitting/backtest_lookback_drawdown.d.ts +21 -0
- package/dist/analysis/bot_fitting/backtest_lookback_drawdown.js +315 -0
- package/dist/analysis/bot_fitting/shared_utils.d.ts +7 -7
- package/dist/analysis/bot_fitting/shared_utils.js +2 -2
- package/dist/analysis/bot_key_utils.d.ts +18 -10
- package/dist/analysis/bot_key_utils.js +10 -17
- 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 +5 -2
- package/dist/analysis/chart_ui.js +6 -3
- package/dist/analysis/chart_utils.d.ts +5 -5
- package/dist/analysis/chart_utils.js +9 -0
- package/dist/analysis/fills_cache.d.ts +64 -0
- package/dist/analysis/fills_cache.js +254 -0
- package/dist/analysis/fills_source.d.ts +2 -2
- package/dist/analysis/fills_source.js +19 -14
- package/dist/analysis/grid_correction_check.d.ts +1 -1
- package/dist/analysis/grid_correction_check.js +12 -11
- package/dist/analysis/math_utils.d.ts +7 -6
- package/dist/analysis/math_utils.js +5 -8
- package/dist/analysis/pnl_report.d.ts +39 -0
- package/dist/analysis/pnl_report.js +325 -0
- package/dist/analysis/price_sources.d.ts +8 -8
- package/dist/analysis/price_sources.js +5 -4
- package/dist/analysis/resolve_bot_accounts.js +2 -2
- package/dist/analysis/resolve_source.d.ts +1 -2
- package/dist/analysis/trade_profitability.d.ts +32 -2
- package/dist/analysis/trade_profitability.js +232 -106
- package/dist/analysis/tradingview/analyze_tradingview.d.ts +17 -6
- package/dist/analysis/tradingview/analyze_tradingview.js +9 -10
- package/dist/analysis/tradingview/grid_reset_config.d.ts +42 -31
- package/dist/analysis/tradingview/grid_reset_config.js +35 -6
- package/dist/analysis/tradingview/grid_reset_sim.d.ts +75 -8
- package/dist/analysis/tradingview/grid_reset_sim.js +42 -5
- package/dist/analysis/tradingview/tradingview_uplot_chart_generator.d.ts +69 -4
- package/dist/analysis/tradingview/tradingview_uplot_chart_generator.js +20 -20
- package/dist/analysis/trend_detection/backtest_ama_slope_huber.d.ts +102 -0
- package/dist/analysis/trend_detection/backtest_ama_slope_huber.js +725 -0
- package/dist/analysis/trend_detection/dynamic_weight_chart_generator.d.ts +63 -1
- package/dist/analysis/trend_detection/dynamic_weight_chart_generator.js +27 -112
- package/dist/analysis/trend_detection/huber_scale_variants.d.ts +40 -0
- package/dist/analysis/trend_detection/huber_scale_variants.js +176 -0
- 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/credential-daemon.js +34 -20
- package/dist/dexbot.js +17 -14
- package/dist/market_adapter/candle_utils.d.ts +22 -18
- package/dist/market_adapter/candle_utils.js +24 -20
- 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/kibana_candles.d.ts +53 -18
- package/dist/market_adapter/core/kibana_candles.js +9 -7
- 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 +297 -115
- package/dist/market_adapter/core/market_adapter_service.js +184 -101
- package/dist/market_adapter/core/strategies/ama.d.ts +10 -2
- package/dist/market_adapter/core/strategies/ama.js +7 -32
- 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 +36 -8
- package/dist/market_adapter/core/strategies/dynamic_weight_series.js +9 -9
- 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 -1
- package/dist/market_adapter/inputs/fetch_cex_synthetic_data.js +97 -226
- package/dist/market_adapter/inputs/fetch_lp_data.d.ts +42 -7
- package/dist/market_adapter/inputs/fetch_lp_data.js +22 -15
- package/dist/market_adapter/inputs/kibana_feed_source.d.ts +74 -15
- package/dist/market_adapter/inputs/kibana_feed_source.js +29 -22
- 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 +99 -94
- package/dist/market_adapter/inputs/window_cache.js +8 -8
- package/dist/market_adapter/interval_utils.d.ts +4 -4
- package/dist/market_adapter/log_format.d.ts +6 -6
- package/dist/market_adapter/log_format.js +28 -22
- 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 +7 -7
- 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 -33
- package/dist/market_adapter/market_adapter.js +69 -75
- 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 +4 -1
- 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/native_history.d.ts +9 -2
- package/dist/market_adapter/utils/native_history.js +35 -28
- package/dist/modules/account_bots.d.ts +577 -21
- package/dist/modules/account_bots.js +182 -158
- package/dist/modules/account_orders.d.ts +66 -30
- package/dist/modules/account_orders.js +22 -20
- 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 +38 -3
- package/dist/modules/bitshares-native/chain_client.js +45 -46
- 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/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 +55 -62
- 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 +6 -15
- 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 +2 -2
- 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 +93 -59
- package/dist/modules/chain_orders.js +31 -23
- package/dist/modules/constants.d.ts +530 -32
- package/dist/modules/constants.js +52 -60
- package/dist/modules/cr_planner.d.ts +40 -2
- 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 +42 -6
- package/dist/modules/credit_pricing.js +44 -30
- package/dist/modules/credit_runtime.d.ts +276 -118
- package/dist/modules/credit_runtime.js +462 -165
- 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/dexbot_class.d.ts +195 -139
- package/dist/modules/dexbot_class.js +78 -28
- package/dist/modules/dexbot_cow_runtime.d.ts +167 -87
- package/dist/modules/dexbot_cow_runtime.js +248 -206
- package/dist/modules/dexbot_credential_client.d.ts +19 -11
- package/dist/modules/dexbot_fill_runtime.d.ts +63 -48
- package/dist/modules/dexbot_fill_runtime.js +48 -41
- package/dist/modules/dexbot_maintenance_runtime.d.ts +109 -70
- package/dist/modules/dexbot_maintenance_runtime.js +117 -80
- package/dist/modules/dexbot_startup_runtime.d.ts +11 -10
- package/dist/modules/dexbot_startup_runtime.js +43 -43
- 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 +2 -2
- 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 -6
- 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/market_adapter_whitelist.d.ts +9 -3
- package/dist/modules/market_adapter_whitelist.js +15 -3
- 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 +40 -14
- 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 +39 -19
- package/dist/modules/order/format.js +62 -16
- package/dist/modules/order/genesis_policy.d.ts +21 -18
- package/dist/modules/order/genesis_policy.js +12 -8
- package/dist/modules/order/grid.d.ts +142 -36
- package/dist/modules/order/grid.js +148 -123
- 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 +263 -1
- package/dist/modules/order/logger.d.ts +45 -11
- package/dist/modules/order/logger.js +38 -40
- package/dist/modules/order/logger_state.d.ts +4 -4
- package/dist/modules/order/manager.d.ts +226 -180
- package/dist/modules/order/manager.js +101 -83
- 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 +99 -54
- 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 +326 -106
- package/dist/modules/order/utils/order.js +200 -99
- package/dist/modules/order/utils/slot.d.ts +1 -1
- package/dist/modules/order/utils/system.d.ts +176 -26
- package/dist/modules/order/utils/system.js +86 -69
- package/dist/modules/order/utils/validate.d.ts +89 -41
- package/dist/modules/order/utils/validate.js +24 -22
- package/dist/modules/order/utils/withPoolRef.d.ts +4 -3
- 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 +3 -4
- package/dist/modules/paths.js +3 -27
- 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 +15 -10
- 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 +7 -4
- 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 +1071 -2
- 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 +23 -1
- package/dist/modules/utils/time_range.d.ts +4 -0
- package/dist/modules/utils/time_range.js +18 -0
- package/dist/modules/validate_profiles.js +53 -43
- package/dist/modules/version_notice.d.ts +14 -3
- package/dist/modules/version_notice.js +6 -4
- package/dist/pm2.d.ts +29 -27
- package/dist/pm2.js +5 -5
- package/dist/scripts/analyze-credit.d.ts +2 -1
- package/dist/scripts/analyze-credit.js +23 -24
- package/dist/scripts/analyze-orders.d.ts +77 -9
- package/dist/scripts/analyze-orders.js +66 -84
- package/dist/scripts/chart_command.d.ts +27 -18
- package/dist/scripts/chart_command.js +16 -15
- package/dist/scripts/check_any.d.ts +18 -0
- package/dist/scripts/check_any.js +126 -0
- package/dist/scripts/diagnose-pool-history.js +12 -7
- package/dist/scripts/pnl.d.ts +3 -0
- package/dist/scripts/pnl.js +40 -0
- package/dist/scripts/print_grid.js +0 -1
- package/dist/scripts/run-tests.js +39 -7
- package/dist/scripts/runner.js +1 -1
- 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 +72 -10
- package/docs/BITSHARES_ONBOARDING.md +2 -0
- package/docs/COPY_ON_WRITE_MASTER_PLAN.md +1 -1
- package/docs/COW_INVARIANTS.md +13 -6
- package/docs/DEXBOT_COMPARISON.md +8 -8
- package/docs/EVOLUTION.md +12 -10
- package/docs/FUND_MOVEMENT_AND_ACCOUNTING.md +5 -5
- package/docs/GRID_RECALCULATION.md +15 -16
- 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 +15 -4
- package/docs/WORKFLOW.md +1 -0
- package/docs/architecture.md +12 -9
- package/docs/developer_guide.md +6 -6
- package/market_adapter/README.md +9 -26
- package/modules/README.md +4 -1
- package/package.json +4 -1
- 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,
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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'
|
|
47
|
-
|
|
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
|
-
*
|
|
140
|
-
*
|
|
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
|
|
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 (
|
|
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
|
|
162
|
-
|
|
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:
|
|
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,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:
|
|
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
|
-
_getCollateralPercentageBase(accountId:
|
|
91
|
-
_enforceMaxCollateralAmount(policy:
|
|
92
|
-
_calculateDailyFeeRate(offer:
|
|
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:
|
|
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?:
|
|
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?:
|
|
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
|
-
|
|
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?:
|
|
139
|
-
collateralAssetId?:
|
|
140
|
-
policy?:
|
|
141
|
-
collateralAmount?:
|
|
296
|
+
debtAssetId?: unknown;
|
|
297
|
+
collateralAssetId?: unknown;
|
|
298
|
+
policy?: UnknownRecord;
|
|
299
|
+
collateralAmount?: unknown;
|
|
142
300
|
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():
|
|
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
|