dexbot 1.6.11 → 1.6.12
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +35 -4
- package/README.md +2 -1
- package/analysis/README.md +2 -0
- package/analysis/tradingview/README.md +1 -1
- package/analysis/trend_detection/DYNAMIC_WEIGHT_RESEARCH.md +3 -3
- 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 +2 -1
- 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 -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 +220 -12
- package/dist/analysis/bot_fitting/backtest_ama_sweep.js +6 -5
- package/dist/analysis/bot_fitting/backtest_bot_fitting.d.ts +34 -4
- package/dist/analysis/bot_fitting/backtest_bot_fitting.js +11 -63
- 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 +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 +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 +1 -1
- package/dist/analysis/fills_source.d.ts +2 -2
- package/dist/analysis/fills_source.js +14 -12
- 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.js +29 -29
- 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 -1
- package/dist/analysis/trade_profitability.d.ts +23 -2
- package/dist/analysis/trade_profitability.js +50 -50
- package/dist/analysis/tradingview/analyze_tradingview.d.ts +17 -6
- package/dist/analysis/tradingview/analyze_tradingview.js +6 -5
- 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 +18 -19
- package/dist/analysis/trend_detection/backtest_ama_slope_huber.d.ts +1 -1
- package/dist/analysis/trend_detection/backtest_ama_slope_huber.js +5 -5
- package/dist/analysis/trend_detection/dynamic_weight_chart_generator.d.ts +63 -1
- package/dist/analysis/trend_detection/dynamic_weight_chart_generator.js +5 -4
- 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/credential-daemon.js +34 -20
- package/dist/dexbot.js +11 -11
- 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 +284 -117
- package/dist/market_adapter/core/market_adapter_service.js +137 -113
- 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 -1
- package/dist/market_adapter/inputs/fetch_cex_synthetic_data.js +96 -224
- 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 -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 +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 -32
- package/dist/market_adapter/market_adapter.js +67 -48
- 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 +527 -31
- package/dist/modules/constants.js +15 -47
- 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 +108 -83
- 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 +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 +4 -4
- 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 +225 -180
- package/dist/modules/order/manager.js +80 -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 +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 +122 -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 +1 -4
- package/dist/modules/paths.js +1 -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 +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 +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 +65 -40
- package/dist/scripts/chart_command.d.ts +27 -18
- package/dist/scripts/chart_command.js +13 -11
- 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/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 +63 -35
- 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 +10 -9
- 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/architecture.md +12 -9
- package/docs/developer_guide.md +6 -6
- package/market_adapter/README.md +6 -1
- package/modules/README.md +4 -1
- package/package.json +4 -1
package/dist/modules/types.d.ts
CHANGED
|
@@ -8,6 +8,299 @@
|
|
|
8
8
|
*/
|
|
9
9
|
export type OrderType = 'sell' | 'buy' | 'spread';
|
|
10
10
|
export type OrderState = 'virtual' | 'active' | 'partial';
|
|
11
|
+
/**
|
|
12
|
+
* Dict with unknown values. The canonical replacement for
|
|
13
|
+
* `Record<string, any>`; callers must narrow a value before using it.
|
|
14
|
+
*/
|
|
15
|
+
export type UnknownRecord = Record<string, unknown>;
|
|
16
|
+
/** A value that survives JSON round-tripping. */
|
|
17
|
+
export type JsonPrimitive = string | number | boolean | null;
|
|
18
|
+
export type JsonValue = JsonPrimitive | JsonObject | JsonValue[];
|
|
19
|
+
export type JsonArray = JsonValue[];
|
|
20
|
+
export interface JsonObject {
|
|
21
|
+
[key: string]: JsonValue;
|
|
22
|
+
}
|
|
23
|
+
/**
|
|
24
|
+
* Function-shaped logger callback. `level` is intentionally an open string:
|
|
25
|
+
* call sites use labels such as `info`, `warn`, `error`, `debug`.
|
|
26
|
+
*/
|
|
27
|
+
export type LogFn = (message: string, level?: string) => void;
|
|
28
|
+
/**
|
|
29
|
+
* Anything logger-like. Mirrors how callers use injected loggers
|
|
30
|
+
* (`logger?.log?.()` / `logger.warn?.()`).
|
|
31
|
+
*/
|
|
32
|
+
export interface LoggerLike {
|
|
33
|
+
log?: LogFn;
|
|
34
|
+
warn?: LogFn;
|
|
35
|
+
info?: LogFn;
|
|
36
|
+
debug?: LogFn;
|
|
37
|
+
error?: LogFn;
|
|
38
|
+
}
|
|
39
|
+
/**
|
|
40
|
+
* The `{ promise, resolve, reject }` pattern used by async gates.
|
|
41
|
+
* Prefer this over hand-rolled `Promise<any>` + `any` callbacks.
|
|
42
|
+
*/
|
|
43
|
+
export interface Deferred<T> {
|
|
44
|
+
promise: Promise<T>;
|
|
45
|
+
resolve: (value: T | PromiseLike<T>) => void;
|
|
46
|
+
reject: (reason?: unknown) => void;
|
|
47
|
+
}
|
|
48
|
+
/** Runtime narrowing guard for `UnknownRecord` at I/O boundaries. */
|
|
49
|
+
export declare function isUnknownRecord(value: unknown): value is UnknownRecord;
|
|
50
|
+
/** Graphene `asset_amount` (e.g. `{ amount: 12345, asset_id: '1.3.0' }`). */
|
|
51
|
+
export interface ChainAssetAmount {
|
|
52
|
+
amount: number | string;
|
|
53
|
+
asset_id: string;
|
|
54
|
+
}
|
|
55
|
+
/** Graphene `price` (sell_price.base / sell_price.quote). */
|
|
56
|
+
export interface ChainPrice {
|
|
57
|
+
base: ChainAssetAmount;
|
|
58
|
+
quote: ChainAssetAmount;
|
|
59
|
+
}
|
|
60
|
+
/**
|
|
61
|
+
* A raw BitShares `limit_order_object` as returned by the node (before
|
|
62
|
+
* `parseChainOrder` converts it to a grid `Order`). Extra protocol fields
|
|
63
|
+
* remain accessible via the index signature.
|
|
64
|
+
*/
|
|
65
|
+
export interface ChainOrder {
|
|
66
|
+
id: string;
|
|
67
|
+
seller?: string;
|
|
68
|
+
sell_price: ChainPrice;
|
|
69
|
+
for_sale: number | string;
|
|
70
|
+
expiration?: string;
|
|
71
|
+
[key: string]: unknown;
|
|
72
|
+
}
|
|
73
|
+
/** The result of `parseChainOrder()`: a chain order normalized to grid terms. */
|
|
74
|
+
export interface ParsedChainOrder {
|
|
75
|
+
orderId: string;
|
|
76
|
+
price: number;
|
|
77
|
+
type: OrderType;
|
|
78
|
+
size: number | undefined;
|
|
79
|
+
}
|
|
80
|
+
/** A raw chain order paired with its parsed form (holds the pre-filter join). */
|
|
81
|
+
export interface ParsedChainEntry {
|
|
82
|
+
chain: ChainOrder;
|
|
83
|
+
parsed: ParsedChainOrder;
|
|
84
|
+
}
|
|
85
|
+
/**
|
|
86
|
+
* The subset of the `chain_orders` module surface the order engine calls.
|
|
87
|
+
* Methods are variadic (`unknown` args) because their real parameter lists are
|
|
88
|
+
* still being typed; the named members keep them callable without `any`.
|
|
89
|
+
*/
|
|
90
|
+
export interface ChainOrdersLike {
|
|
91
|
+
cancelOrder(...args: unknown[]): Promise<{
|
|
92
|
+
verifiedAfterFailure?: boolean;
|
|
93
|
+
[key: string]: unknown;
|
|
94
|
+
} | null | undefined>;
|
|
95
|
+
createOrder(...args: unknown[]): Promise<{
|
|
96
|
+
skipped?: boolean;
|
|
97
|
+
[key: string]: unknown;
|
|
98
|
+
} | null | undefined>;
|
|
99
|
+
readOpenOrders(...args: unknown[]): Promise<unknown>;
|
|
100
|
+
buildUpdateOrderOp?(...args: unknown[]): Promise<{
|
|
101
|
+
op?: unknown;
|
|
102
|
+
[key: string]: unknown;
|
|
103
|
+
} | null | undefined>;
|
|
104
|
+
executeBatch?(...args: unknown[]): Promise<unknown>;
|
|
105
|
+
updateOrder?(...args: unknown[]): Promise<{
|
|
106
|
+
[key: string]: unknown;
|
|
107
|
+
} | null | undefined>;
|
|
108
|
+
wasRecentlyOwnCancelled?(orderId: string): boolean;
|
|
109
|
+
[key: string]: unknown;
|
|
110
|
+
}
|
|
111
|
+
/**
|
|
112
|
+
* Minimal runtime surface shared by the `dexbot_*_runtime.ts` layer. This is
|
|
113
|
+
* a seeded interface to grow as each runtime file is typed — the index
|
|
114
|
+
* signature keeps the many `_camelCase` internals reachable (as `unknown`)
|
|
115
|
+
* while the common surface gets real types. Replace index-signature reads with
|
|
116
|
+
* named fields as the relevant owners are typed.
|
|
117
|
+
*/
|
|
118
|
+
/**
|
|
119
|
+
* The DexBot runtime surface used by the `dexbot_*_runtime.ts` layer (and the
|
|
120
|
+
* `DexBot` class itself, which structurally satisfies it). No index signature:
|
|
121
|
+
* every member the runtime touches is enumerated, so a typo or an undeclared
|
|
122
|
+
* internal is a compile error instead of a silent `unknown`.
|
|
123
|
+
*/
|
|
124
|
+
/** Credential-daemon signing token (used until the private key is unlocked). */
|
|
125
|
+
export interface SigningToken {
|
|
126
|
+
accountName: string;
|
|
127
|
+
socketPath?: string;
|
|
128
|
+
}
|
|
129
|
+
export interface BotLike {
|
|
130
|
+
config: GridConfig;
|
|
131
|
+
manager: OrderManagerLike;
|
|
132
|
+
account: string | null;
|
|
133
|
+
accountId: string | null;
|
|
134
|
+
privateKey: string | SigningToken | null;
|
|
135
|
+
accountOrders: AccountOrdersLike;
|
|
136
|
+
assets: AssetPair | null;
|
|
137
|
+
botKey: string;
|
|
138
|
+
name: string;
|
|
139
|
+
triggerFile: string;
|
|
140
|
+
logPrefix: string;
|
|
141
|
+
_log: LogFn;
|
|
142
|
+
_warn: LogFn;
|
|
143
|
+
_baseWeightDistribution: {
|
|
144
|
+
sell: number;
|
|
145
|
+
buy: number;
|
|
146
|
+
};
|
|
147
|
+
_metrics: BotMetrics;
|
|
148
|
+
_recentlyQueuedFills: Map<string, number>;
|
|
149
|
+
_recentlyProcessedFills: Map<string, number>;
|
|
150
|
+
_incomingFillQueue: IncomingFill[];
|
|
151
|
+
_processedFillStore: ProcessedFillStoreLike;
|
|
152
|
+
_staleCleanedOrderIds: Map<string, number>;
|
|
153
|
+
_staleCleanupRetentionMs: number;
|
|
154
|
+
_fillCleanupCounter: number;
|
|
155
|
+
_fillDedupeWindowMs: number;
|
|
156
|
+
_fillRecordRetentionMs: number;
|
|
157
|
+
_targetedDriftSyncCooldownMs: number;
|
|
158
|
+
_maintenanceCooldownCycles: number;
|
|
159
|
+
_lastGridActivityAt: number;
|
|
160
|
+
_currentCycleId: number;
|
|
161
|
+
_consecutiveConsumeFailures: number;
|
|
162
|
+
_consumeFailureFirstAt: number;
|
|
163
|
+
_fillTotalsRetryAttempt: number;
|
|
164
|
+
_gridPriceInvariantRejectStreak: Map<string, number>;
|
|
165
|
+
_structuralGridResyncRunning: number;
|
|
166
|
+
_structuralGridResyncDeferCount: number;
|
|
167
|
+
_structuralGridResyncDeferStartedAt: number | null;
|
|
168
|
+
_postRecoveryRebalanceDefers: number;
|
|
169
|
+
_lastDeferredDustCount: number;
|
|
170
|
+
_deferredFillRetryWaits: number;
|
|
171
|
+
_deferredFillRetryDelayMs: number;
|
|
172
|
+
_lastTargetedDriftSyncAt: number;
|
|
173
|
+
_lightweightSyncCheckAt: number;
|
|
174
|
+
_lastUncertainResyncAt: number;
|
|
175
|
+
_lastResolvedPollIntervalMs: number;
|
|
176
|
+
_fillBroadcastDeferSince: number;
|
|
177
|
+
_fillBroadcastDeferRegionAt: number;
|
|
178
|
+
_fillTotalsParkedFills: IncomingFill[];
|
|
179
|
+
_fillTotalsRetryTimer: ReturnType<typeof setTimeout> | null;
|
|
180
|
+
_fillTotalsRetryDelayMs: number;
|
|
181
|
+
_currentBatchId: string | number | null | undefined;
|
|
182
|
+
_lastBroadcastHeartbeatAt: number | undefined;
|
|
183
|
+
_appliedBotConfigFingerprint: string | null;
|
|
184
|
+
_lastBotConfigHintFingerprint: string | null;
|
|
185
|
+
_marketAdapterWatchdogFingerprint: string | null;
|
|
186
|
+
_lastHeldChainOrderSignature: string | null;
|
|
187
|
+
_lastHeldChainOrderSignatureSince: number;
|
|
188
|
+
_lastHeldChainOrderWarnAt: number;
|
|
189
|
+
_lastDeferredHoldResyncAt: number;
|
|
190
|
+
_lastGridPriceInvariantResyncAt: number;
|
|
191
|
+
_lastSpreadStaleResyncAt: number;
|
|
192
|
+
_gridLockHoldWarnAt: number;
|
|
193
|
+
_outOfSpreadSince: number;
|
|
194
|
+
_outOfSpreadStaleWarned: boolean;
|
|
195
|
+
_strandedHoldSince: Map<string, number>;
|
|
196
|
+
_recoverySyncInFlight: number;
|
|
197
|
+
_batchInFlight: number;
|
|
198
|
+
_cowBroadcastInFlight: boolean;
|
|
199
|
+
_deferredFillsPending: boolean;
|
|
200
|
+
_credentialRecoveryNeeded: boolean;
|
|
201
|
+
_shuttingDown: boolean;
|
|
202
|
+
_mainLoopActive: boolean;
|
|
203
|
+
_botsConfigPollInFlight: boolean;
|
|
204
|
+
_marketAdapterWatchdogInFlight: boolean;
|
|
205
|
+
_blockchainFetchInFlight: number;
|
|
206
|
+
_blockchainFetchIntervalMin: number;
|
|
207
|
+
_spreadFundsExhausted: boolean;
|
|
208
|
+
_skipEmptyReadConfirmDelay: boolean;
|
|
209
|
+
_testPollIntervalMs?: number;
|
|
210
|
+
_appliedBotConfigEntry: unknown;
|
|
211
|
+
_creditRuntime: CreditRuntimeLike | null;
|
|
212
|
+
_gridModule: unknown;
|
|
213
|
+
_gridReconcileModule: unknown;
|
|
214
|
+
_blockchainFetchInterval: ReturnType<typeof setInterval> | null;
|
|
215
|
+
_botsConfigPollInterval: ReturnType<typeof setInterval> | null;
|
|
216
|
+
_credentialDaemonWatchdogInterval: ReturnType<typeof setInterval> | null;
|
|
217
|
+
_creditWatchdogInterval: ReturnType<typeof setInterval> | null;
|
|
218
|
+
_dustHealthCheckTimer: ReturnType<typeof setInterval> | null;
|
|
219
|
+
_deferredFillRetryTimer: ReturnType<typeof setTimeout> | null;
|
|
220
|
+
_postRecoveryRebalanceTimer: ReturnType<typeof setTimeout> | null;
|
|
221
|
+
_structuralGridResyncTimer: ReturnType<typeof setTimeout> | null;
|
|
222
|
+
_triggerDebounceTimer: ReturnType<typeof setTimeout> | null;
|
|
223
|
+
_fillsUnsubscribe: (() => Promise<unknown>) | null;
|
|
224
|
+
_reconnectUnregister: (() => void) | null;
|
|
225
|
+
_triggerWatcher: {
|
|
226
|
+
close?: () => void;
|
|
227
|
+
} | null;
|
|
228
|
+
_mainLoopPromise: Promise<unknown> | null;
|
|
229
|
+
_abortFlowIfIllegalState(...args: unknown[]): unknown;
|
|
230
|
+
_applyRecoverableGridUpdates(...args: unknown[]): unknown;
|
|
231
|
+
_applyReplaySafeTrackedFillAccounting(...args: unknown[]): Promise<FillAccountingResult>;
|
|
232
|
+
_applyReplaySafeOrphanFillAccounting(...args: unknown[]): Promise<FillAccountingResult>;
|
|
233
|
+
_buildOrphanFillFallbackKey(...args: unknown[]): unknown;
|
|
234
|
+
_buildOutsideInPairGroupsForOrders(...args: unknown[]): unknown[];
|
|
235
|
+
_cancelDustOrders(options?: unknown): Promise<unknown>;
|
|
236
|
+
_consumeFillQueue(...args: unknown[]): Promise<unknown>;
|
|
237
|
+
_createFillCallback(...args: unknown[]): unknown;
|
|
238
|
+
_ensureCredentialDaemonWritable(contextLabel?: unknown): unknown;
|
|
239
|
+
_executeBatchIfNeeded(rebalanceResult: unknown, contextLabel?: unknown): Promise<unknown>;
|
|
240
|
+
_flushProcessedFillPersistence(...args: unknown[]): unknown;
|
|
241
|
+
_flushProcessedFillPersistenceForKeys(...args: unknown[]): unknown;
|
|
242
|
+
_formatUnmatchedChainOrderForLog(...args: unknown[]): unknown;
|
|
243
|
+
_getGapSlotBatchSize(...args: unknown[]): unknown;
|
|
244
|
+
_getMaxOpsPerBroadcast(...args: unknown[]): unknown;
|
|
245
|
+
_getPipelineSignals(...args: unknown[]): unknown;
|
|
246
|
+
_getPm2ProcessNames(...args: unknown[]): Promise<string[]>;
|
|
247
|
+
_getRecentFillKeysSnapshot(...args: unknown[]): Record<string, number> | null;
|
|
248
|
+
_handleBatchHardAbort(...args: unknown[]): unknown;
|
|
249
|
+
_handlePendingTriggerReset(...args: unknown[]): unknown;
|
|
250
|
+
_isCredentialDaemonError(err: unknown): unknown;
|
|
251
|
+
_isNewFillKey(...args: unknown[]): unknown;
|
|
252
|
+
_isOpenOrdersSyncLoopEnabled(...args: unknown[]): unknown;
|
|
253
|
+
_listenForFillsHook(...args: unknown[]): unknown;
|
|
254
|
+
_loadBotsConfigSnapshot(...args: unknown[]): unknown;
|
|
255
|
+
_markGridActivity(...args: unknown[]): unknown;
|
|
256
|
+
_performGridResync(options?: UnknownRecord): Promise<unknown>;
|
|
257
|
+
_persistAndRecoverIfNeeded(...args: unknown[]): unknown;
|
|
258
|
+
_processFillsWithBatching(fills: unknown, excl: unknown, contextLabel: unknown, options?: unknown): Promise<FillBatchResult>;
|
|
259
|
+
_processFillsWithBootstrapMode(...args: unknown[]): unknown;
|
|
260
|
+
_readOpenOrdersHook(...args: unknown[]): unknown;
|
|
261
|
+
_recoverBatchSizeDrift(...args: unknown[]): unknown;
|
|
262
|
+
_recoverExplicitStaleOrders(...args: unknown[]): unknown;
|
|
263
|
+
_recoverFromPersistedGrid(...args: unknown[]): unknown;
|
|
264
|
+
_refreshAndSyncCreditRuntime(...args: unknown[]): unknown;
|
|
265
|
+
_refreshDynamicWeightDistribution(...args: unknown[]): unknown;
|
|
266
|
+
_rejectCorruptedGridSnapshot(...args: unknown[]): unknown;
|
|
267
|
+
_runCreditRuntimeMaintenance(context?: unknown, options?: unknown): unknown;
|
|
268
|
+
_runDustHealthCheck(...args: unknown[]): unknown;
|
|
269
|
+
_runGridMaintenance(context?: unknown, options?: unknown): unknown;
|
|
270
|
+
_scheduleFillConsumerRestart(...args: unknown[]): unknown;
|
|
271
|
+
_setupBlockchainFetchInterval(...args: unknown[]): unknown;
|
|
272
|
+
_setupBotsConfigPollInterval(...args: unknown[]): unknown;
|
|
273
|
+
_setupCredentialDaemonWatchdogInterval(...args: unknown[]): unknown;
|
|
274
|
+
_setupCreditRuntime(...args: unknown[]): unknown;
|
|
275
|
+
_setupCreditWatchdogInterval(...args: unknown[]): unknown;
|
|
276
|
+
_setupDustHealthCheckInterval(...args: unknown[]): unknown;
|
|
277
|
+
_setupTriggerFileDetection(...args: unknown[]): unknown;
|
|
278
|
+
_startMarketAdapterPm2(...args: unknown[]): unknown;
|
|
279
|
+
_startOpenOrdersSyncLoop(...args: unknown[]): unknown;
|
|
280
|
+
_stopCreditWatchdogInterval(...args: unknown[]): unknown;
|
|
281
|
+
_stopMarketAdapterPm2(...args: unknown[]): unknown;
|
|
282
|
+
_submitCancelOrder(...args: unknown[]): unknown;
|
|
283
|
+
_suspendGridPersistenceForCredentialOutage(reason: unknown): unknown;
|
|
284
|
+
_resumeGridPersistenceAfterCredentialRecovery(reason: unknown): unknown;
|
|
285
|
+
_syncMarketAdapterHook(...args: unknown[]): unknown;
|
|
286
|
+
_syncOpenOrdersAndProcessFills(...args: unknown[]): Promise<{
|
|
287
|
+
aborted?: boolean;
|
|
288
|
+
hasUnmatched?: number;
|
|
289
|
+
syncResult?: SyncResult | null;
|
|
290
|
+
openOrders?: unknown[] | null;
|
|
291
|
+
[key: string]: unknown;
|
|
292
|
+
}>;
|
|
293
|
+
_targetedOrderRepair(...args: unknown[]): unknown;
|
|
294
|
+
_triggerStateRecoverySync(...args: unknown[]): unknown;
|
|
295
|
+
_wireBroadcastRegionEndDrain(...args: unknown[]): unknown;
|
|
296
|
+
_wireProcessedFillTracking(...args: unknown[]): unknown;
|
|
297
|
+
_wireStructuralGridResyncRequest(...args: unknown[]): unknown;
|
|
298
|
+
placeInitialOrders(...args: unknown[]): unknown;
|
|
299
|
+
requestGridReset(reason?: unknown, options?: unknown): Promise<unknown>;
|
|
300
|
+
shutdown(...args: unknown[]): unknown;
|
|
301
|
+
updateOrdersOnChainBatch(rebalanceResult: unknown): unknown;
|
|
302
|
+
updateOrdersOnChainPlan(...args: unknown[]): unknown;
|
|
303
|
+
}
|
|
11
304
|
export interface OrderBase {
|
|
12
305
|
id: string;
|
|
13
306
|
price: number;
|
|
@@ -17,9 +310,14 @@ export interface OrderBase {
|
|
|
17
310
|
orderId: string | null;
|
|
18
311
|
committedSide?: OrderType;
|
|
19
312
|
rawOnChain?: {
|
|
20
|
-
for_sale?: number;
|
|
313
|
+
for_sale?: number | string;
|
|
314
|
+
fetchedAt?: number;
|
|
315
|
+
} | null;
|
|
316
|
+
btsFeeState?: {
|
|
317
|
+
deferredFee?: number;
|
|
318
|
+
[key: string]: unknown;
|
|
21
319
|
};
|
|
22
|
-
metadata?:
|
|
320
|
+
metadata?: JsonObject;
|
|
23
321
|
gridIndex?: number;
|
|
24
322
|
idealSize?: number;
|
|
25
323
|
sideHint?: string;
|
|
@@ -39,4 +337,775 @@ export interface PartialOrder extends OrderBase {
|
|
|
39
337
|
size: number;
|
|
40
338
|
}
|
|
41
339
|
export type Order = VirtualOrder | ActiveOrder | PartialOrder;
|
|
340
|
+
/** Asset metadata used by the grid engine (precision is the only required bit). */
|
|
341
|
+
export interface AssetInfo {
|
|
342
|
+
id?: string;
|
|
343
|
+
symbol?: string;
|
|
344
|
+
precision: number;
|
|
345
|
+
amount?: number;
|
|
346
|
+
[key: string]: unknown;
|
|
347
|
+
}
|
|
348
|
+
/** The two-asset pair held by an order manager. */
|
|
349
|
+
export interface AssetPair {
|
|
350
|
+
assetA: AssetInfo;
|
|
351
|
+
assetB: AssetInfo;
|
|
352
|
+
[key: string]: unknown;
|
|
353
|
+
}
|
|
354
|
+
/** Blockchain balance snapshot (nulls until the first successful fetch). */
|
|
355
|
+
export interface AccountTotals {
|
|
356
|
+
buy: number | null;
|
|
357
|
+
sell: number | null;
|
|
358
|
+
buyFree: number | null;
|
|
359
|
+
sellFree: number | null;
|
|
360
|
+
_lastFetchedAt?: number;
|
|
361
|
+
buyLocked?: number;
|
|
362
|
+
sellLocked?: number;
|
|
363
|
+
[key: string]: unknown;
|
|
364
|
+
}
|
|
365
|
+
/** Per-side fund amounts. */
|
|
366
|
+
export interface SideFunds {
|
|
367
|
+
buy: number;
|
|
368
|
+
sell: number;
|
|
369
|
+
}
|
|
370
|
+
/** Chain/grid split of a fund category. */
|
|
371
|
+
export interface ChainGridFunds {
|
|
372
|
+
chain: SideFunds;
|
|
373
|
+
grid: SideFunds;
|
|
374
|
+
}
|
|
375
|
+
/** `manager.funds` — the accountant's derived fund view. */
|
|
376
|
+
export interface ManagerFunds {
|
|
377
|
+
available: SideFunds;
|
|
378
|
+
total: ChainGridFunds;
|
|
379
|
+
virtual: SideFunds;
|
|
380
|
+
committed: ChainGridFunds;
|
|
381
|
+
btsFeesOwed: number;
|
|
382
|
+
btsBalance: {
|
|
383
|
+
free: number;
|
|
384
|
+
total: number;
|
|
385
|
+
locked: number;
|
|
386
|
+
};
|
|
387
|
+
allocated?: SideFunds;
|
|
388
|
+
allocatedBuy?: number;
|
|
389
|
+
allocatedSell?: number;
|
|
390
|
+
chainFreeBuy?: number;
|
|
391
|
+
chainFreeSell?: number;
|
|
392
|
+
[key: string]: unknown;
|
|
393
|
+
}
|
|
394
|
+
/** `manager.persistGrid()` result — validation outcome plus skip flags. */
|
|
395
|
+
export interface PersistGridResult extends UnknownRecord {
|
|
396
|
+
isValid: boolean;
|
|
397
|
+
skipped?: boolean;
|
|
398
|
+
suspended?: boolean;
|
|
399
|
+
reason?: string | null;
|
|
400
|
+
}
|
|
401
|
+
/** Signal raised by the manager on an illegal order state. */
|
|
402
|
+
export interface IllegalStateSignal extends UnknownRecord {
|
|
403
|
+
context?: string;
|
|
404
|
+
message?: string;
|
|
405
|
+
}
|
|
406
|
+
/** Signal raised by the manager on an accounting commitment failure. */
|
|
407
|
+
export interface AccountingFailureSignal extends UnknownRecord {
|
|
408
|
+
side?: string;
|
|
409
|
+
amount: number;
|
|
410
|
+
context?: string;
|
|
411
|
+
message?: string;
|
|
412
|
+
}
|
|
413
|
+
/** Result of `manager.checkFundDriftAfterFills()`. */
|
|
414
|
+
export interface FundDriftCheck extends UnknownRecord {
|
|
415
|
+
isValid: boolean;
|
|
416
|
+
driftSell?: number;
|
|
417
|
+
driftBuy?: number;
|
|
418
|
+
reason?: string | null;
|
|
419
|
+
}
|
|
420
|
+
/** Result of `manager.performSafeRebalance()`. */
|
|
421
|
+
export interface RebalanceResult extends UnknownRecord {
|
|
422
|
+
aborted?: boolean;
|
|
423
|
+
reason?: string | null;
|
|
424
|
+
deferred?: boolean;
|
|
425
|
+
actions?: unknown[];
|
|
426
|
+
needsResync?: boolean;
|
|
427
|
+
resyncReason?: string;
|
|
428
|
+
targetGrid?: unknown;
|
|
429
|
+
committed?: boolean;
|
|
430
|
+
}
|
|
431
|
+
/** Result of a chain open-orders sync pass. */
|
|
432
|
+
export interface SyncResult extends UnknownRecord {
|
|
433
|
+
filledOrders: unknown[];
|
|
434
|
+
updatedOrders: unknown[];
|
|
435
|
+
ordersNeedingCorrection: unknown[];
|
|
436
|
+
unmatchedChainOrders?: UnmatchedChainOrder[];
|
|
437
|
+
partialFill?: boolean;
|
|
438
|
+
requiresOpenOrdersSync?: boolean;
|
|
439
|
+
deferred?: boolean;
|
|
440
|
+
newOrders?: unknown[];
|
|
441
|
+
}
|
|
442
|
+
/** Result of a single/batch fill-history sync (`syncFromFillHistory*`). */
|
|
443
|
+
export interface FillHistorySyncResult extends UnknownRecord {
|
|
444
|
+
deferred?: boolean;
|
|
445
|
+
filledOrders?: unknown[];
|
|
446
|
+
residualCancels?: unknown[];
|
|
447
|
+
requiresOpenOrdersSync?: boolean;
|
|
448
|
+
}
|
|
449
|
+
/** Result of `_processFillsWithBatching` / `_processFillsWithBootstrapMode`. */
|
|
450
|
+
export interface FillBatchResult extends UnknownRecord {
|
|
451
|
+
aborted?: boolean;
|
|
452
|
+
deferred?: boolean;
|
|
453
|
+
}
|
|
454
|
+
/** Result of `_cancelDustOrders`. */
|
|
455
|
+
export interface DustCancelResult extends UnknownRecord {
|
|
456
|
+
batchResult?: {
|
|
457
|
+
aborted?: boolean;
|
|
458
|
+
[key: string]: unknown;
|
|
459
|
+
};
|
|
460
|
+
}
|
|
461
|
+
/** Result of `manager.checkGridHealth()`. */
|
|
462
|
+
export interface GridHealthResult extends UnknownRecord {
|
|
463
|
+
buyDustOrders?: unknown[];
|
|
464
|
+
sellDustOrders?: unknown[];
|
|
465
|
+
}
|
|
466
|
+
/** Runtime metrics counters. */
|
|
467
|
+
export interface BotMetrics extends UnknownRecord {
|
|
468
|
+
fillsProcessed: number;
|
|
469
|
+
batchesExecuted: number;
|
|
470
|
+
fillProcessingTimeMs: number;
|
|
471
|
+
lockContentionEvents: number;
|
|
472
|
+
maxQueueDepth: number;
|
|
473
|
+
gridLockContention: number;
|
|
474
|
+
fundRecalcCount: number;
|
|
475
|
+
}
|
|
476
|
+
/** An unmatched chain order surfaced by a sync pass. */
|
|
477
|
+
export interface UnmatchedChainOrder extends UnknownRecord {
|
|
478
|
+
chainOrderId?: string;
|
|
479
|
+
orderId?: string;
|
|
480
|
+
price?: number;
|
|
481
|
+
size?: number;
|
|
482
|
+
reason?: string;
|
|
483
|
+
}
|
|
484
|
+
/** A raw fill/operation entry carried on the incoming fill queue. */
|
|
485
|
+
export interface IncomingFill extends UnknownRecord {
|
|
486
|
+
op?: [unknown, {
|
|
487
|
+
order_id: string;
|
|
488
|
+
is_maker?: boolean;
|
|
489
|
+
pays?: {
|
|
490
|
+
amount?: unknown;
|
|
491
|
+
asset_id?: unknown;
|
|
492
|
+
};
|
|
493
|
+
receives?: {
|
|
494
|
+
amount?: unknown;
|
|
495
|
+
asset_id?: unknown;
|
|
496
|
+
};
|
|
497
|
+
}];
|
|
498
|
+
block_num?: number;
|
|
499
|
+
id?: string;
|
|
500
|
+
}
|
|
501
|
+
/** Aggregate chain-funds summary produced by `computeChainFundTotals`. */
|
|
502
|
+
export interface ChainFundsTotals {
|
|
503
|
+
chainFreeBuy: number;
|
|
504
|
+
chainFreeSell: number;
|
|
505
|
+
committedChainBuy: number;
|
|
506
|
+
committedChainSell: number;
|
|
507
|
+
freePlusLockedBuy: number;
|
|
508
|
+
freePlusLockedSell: number;
|
|
509
|
+
chainTotalBuy: number;
|
|
510
|
+
chainTotalSell: number;
|
|
511
|
+
[key: string]: unknown;
|
|
512
|
+
}
|
|
513
|
+
/** `manager.getChainFundsSnapshot()` result. */
|
|
514
|
+
export interface ChainFundsSnapshot extends ChainFundsTotals {
|
|
515
|
+
allocatedBuy: number;
|
|
516
|
+
allocatedSell: number;
|
|
517
|
+
btsBalance: {
|
|
518
|
+
free: number;
|
|
519
|
+
total: number;
|
|
520
|
+
locked: number;
|
|
521
|
+
} | null;
|
|
522
|
+
}
|
|
523
|
+
/**
|
|
524
|
+
* The mutable order record the grid engine operates on. Deliberately NOT the
|
|
525
|
+
* discriminated `Order` union: the engine transitions a single record across
|
|
526
|
+
* `virtual`/`active`/`partial` in place, so `state`/`orderId` must stay
|
|
527
|
+
* independently writable.
|
|
528
|
+
*/
|
|
529
|
+
export interface ManagedOrder {
|
|
530
|
+
id: string;
|
|
531
|
+
price: number;
|
|
532
|
+
type: OrderType;
|
|
533
|
+
state: OrderState;
|
|
534
|
+
size: number;
|
|
535
|
+
orderId: string | null;
|
|
536
|
+
committedSide?: OrderType;
|
|
537
|
+
rawOnChain?: {
|
|
538
|
+
for_sale?: number | string;
|
|
539
|
+
fetchedAt?: number;
|
|
540
|
+
} | null;
|
|
541
|
+
metadata?: UnknownRecord;
|
|
542
|
+
btsFeeState?: {
|
|
543
|
+
deferredFee?: number;
|
|
544
|
+
deferredPaidFee?: number;
|
|
545
|
+
[key: string]: unknown;
|
|
546
|
+
} | null;
|
|
547
|
+
createUncertain?: boolean;
|
|
548
|
+
gridIndex?: number;
|
|
549
|
+
idealSize?: number;
|
|
550
|
+
sideHint?: string;
|
|
551
|
+
[key: string]: unknown;
|
|
552
|
+
}
|
|
553
|
+
/** Active-order target counts. */
|
|
554
|
+
export interface ActiveOrdersConfig extends UnknownRecord {
|
|
555
|
+
buy?: number;
|
|
556
|
+
sell?: number;
|
|
557
|
+
}
|
|
558
|
+
/** Grid-limit knobs (mirrors `GRID_LIMITS` profile overrides). */
|
|
559
|
+
export interface GridLimitsLike extends UnknownRecord {
|
|
560
|
+
GRID_COMPARISON?: {
|
|
561
|
+
RMS_PERCENTAGE?: number;
|
|
562
|
+
[key: string]: unknown;
|
|
563
|
+
};
|
|
564
|
+
MIN_SPREAD_ORDERS?: number;
|
|
565
|
+
MIN_SPREAD_FACTOR?: number;
|
|
566
|
+
MIN_ORDER_SIZE_FACTOR?: number;
|
|
567
|
+
PARTIAL_DUST_THRESHOLD_PERCENTAGE?: number;
|
|
568
|
+
}
|
|
569
|
+
/** Per-side weight distribution for fund allocation. */
|
|
570
|
+
export interface WeightDistributionConfig extends UnknownRecord {
|
|
571
|
+
buy?: number;
|
|
572
|
+
sell?: number;
|
|
573
|
+
}
|
|
574
|
+
/**
|
|
575
|
+
* Bot/grid configuration. Only the fields the engine reads directly are named;
|
|
576
|
+
* the index signature keeps profile-defined extras reachable as `unknown`.
|
|
577
|
+
*/
|
|
578
|
+
export interface GridConfig extends UnknownRecord {
|
|
579
|
+
startPrice?: number | string;
|
|
580
|
+
minPrice?: number | null;
|
|
581
|
+
maxPrice?: number | null;
|
|
582
|
+
incrementPercent?: number;
|
|
583
|
+
incrementBounds?: {
|
|
584
|
+
MIN_PERCENT: number;
|
|
585
|
+
MAX_PERCENT: number;
|
|
586
|
+
[key: string]: unknown;
|
|
587
|
+
};
|
|
588
|
+
targetSpreadPercent?: number;
|
|
589
|
+
activeOrders?: ActiveOrdersConfig;
|
|
590
|
+
assetA?: string;
|
|
591
|
+
assetB?: string;
|
|
592
|
+
botKey?: string;
|
|
593
|
+
market?: string;
|
|
594
|
+
accountId?: string;
|
|
595
|
+
preferredAccount?: string;
|
|
596
|
+
maintenance?: {
|
|
597
|
+
uncertainReadResyncCooldownMs?: number;
|
|
598
|
+
[key: string]: unknown;
|
|
599
|
+
};
|
|
600
|
+
min_BTS_value?: number;
|
|
601
|
+
priceMode?: string;
|
|
602
|
+
poolRef?: string | null;
|
|
603
|
+
gridLimits?: GridLimitsLike;
|
|
604
|
+
weightDistribution?: WeightDistributionConfig;
|
|
605
|
+
asymmetricBounds?: UnknownRecord;
|
|
606
|
+
rotation?: UnknownRecord;
|
|
607
|
+
botFunds?: UnknownRecord;
|
|
608
|
+
feeParams?: GridFeeParams;
|
|
609
|
+
fillProcessing?: FillProcessingConfig;
|
|
610
|
+
timing?: TimingConfig;
|
|
611
|
+
accountTotals?: AccountTotals;
|
|
612
|
+
pipelineTiming?: {
|
|
613
|
+
TIMEOUT_MS?: number;
|
|
614
|
+
[key: string]: unknown;
|
|
615
|
+
};
|
|
616
|
+
logging?: {
|
|
617
|
+
level?: string;
|
|
618
|
+
config?: Record<string, unknown>;
|
|
619
|
+
[key: string]: unknown;
|
|
620
|
+
};
|
|
621
|
+
}
|
|
622
|
+
/** Fee-schedule override block inside `config.feeParams`. */
|
|
623
|
+
export interface GridFeeParams extends UnknownRecord {
|
|
624
|
+
MAKER_REFUND_PERCENT?: number;
|
|
625
|
+
TAKER_FEE_PERCENT?: number;
|
|
626
|
+
DEFAULT_MAX_FEE_RATE_PER_DAY?: number;
|
|
627
|
+
BTS_ACQUIRE_THRESHOLD?: number;
|
|
628
|
+
BTS_ACQUIRE_TARGET_MULTIPLIER?: number;
|
|
629
|
+
BTS_RESERVATION_MULTIPLIER?: number;
|
|
630
|
+
POOL_SLIPPAGE_TOLERANCE?: number;
|
|
631
|
+
}
|
|
632
|
+
/** `config.timing` knobs. */
|
|
633
|
+
export interface TimingConfig extends UnknownRecord {
|
|
634
|
+
SAFETY_NET_SYNC_TIMEOUT_MS?: number;
|
|
635
|
+
CREDIT_DEAL_EXPIRY_THRESHOLD_HOURS?: number;
|
|
636
|
+
CREDIT_REBORROW_MAX_ATTEMPTS?: number;
|
|
637
|
+
BLOCKCHAIN_FETCH_INTERVAL_MIN?: number;
|
|
638
|
+
BOTS_CONFIG_POLL_INTERVAL_MS?: number;
|
|
639
|
+
BTS_ACQUIRE_COOLDOWN_MIN?: number;
|
|
640
|
+
}
|
|
641
|
+
/** `config.fillProcessing` knobs read by the fill consumer. */
|
|
642
|
+
export interface FillProcessingConfig extends UnknownRecord {
|
|
643
|
+
CONSUMER_BACKOFF_INITIAL_MS?: number;
|
|
644
|
+
CONSUMER_BACKOFF_MAX_MS?: number;
|
|
645
|
+
MAX_CONSECUTIVE_CONSUMER_FAILURES?: number;
|
|
646
|
+
OPERATION_TYPE?: number;
|
|
647
|
+
}
|
|
648
|
+
/** Async mutex surface (AsyncLock) used by the manager. */
|
|
649
|
+
export interface ManagerLock {
|
|
650
|
+
acquire<T>(fn: () => T | Promise<T>, options?: number | {
|
|
651
|
+
timeout?: number;
|
|
652
|
+
}): Promise<T>;
|
|
653
|
+
isReentrant(): boolean;
|
|
654
|
+
isLocked(): boolean;
|
|
655
|
+
forceRelease(reason?: string): unknown;
|
|
656
|
+
getQueueLength(): number;
|
|
657
|
+
heldForMs(): number;
|
|
658
|
+
}
|
|
659
|
+
/** `refreshAccountTotalsIfStale()` freshness gate. */
|
|
660
|
+
export interface AccountTotalsGate {
|
|
661
|
+
ok: boolean;
|
|
662
|
+
[key: string]: unknown;
|
|
663
|
+
}
|
|
664
|
+
/** Accountant surface the sync engine calls directly. */
|
|
665
|
+
/** Result of `accountant.processFillAccounting()`. */
|
|
666
|
+
export interface FillAccountingResult extends UnknownRecord {
|
|
667
|
+
status: string;
|
|
668
|
+
}
|
|
669
|
+
export interface AccountantLike {
|
|
670
|
+
processFillAccounting(fillOp: unknown, fillKey: string, options?: UnknownRecord): Promise<boolean>;
|
|
671
|
+
adjustTotalBalance(orderType: string, delta: number, operation: string): Promise<unknown>;
|
|
672
|
+
addToChainFree(orderType: string, size: number, operation: string): Promise<unknown>;
|
|
673
|
+
_performStateRecovery(...args: unknown[]): {
|
|
674
|
+
isValid: boolean;
|
|
675
|
+
reason?: string | null;
|
|
676
|
+
[key: string]: unknown;
|
|
677
|
+
} | Promise<{
|
|
678
|
+
isValid: boolean;
|
|
679
|
+
reason?: string | null;
|
|
680
|
+
[key: string]: unknown;
|
|
681
|
+
}>;
|
|
682
|
+
updateOptimisticFreeBalance(...args: unknown[]): Promise<unknown>;
|
|
683
|
+
recalculateFunds(): Promise<unknown>;
|
|
684
|
+
resetFunds(): unknown;
|
|
685
|
+
_getBtsOrderType?(): string | null;
|
|
686
|
+
resetRecoveryState?(): unknown;
|
|
687
|
+
}
|
|
688
|
+
/** A pending price-correction queue entry. */
|
|
689
|
+
export interface PendingPriceCorrection extends UnknownRecord {
|
|
690
|
+
chainOrderId?: string;
|
|
691
|
+
isSurplus?: boolean;
|
|
692
|
+
cancelOnly?: boolean;
|
|
693
|
+
gapEvacuation?: boolean;
|
|
694
|
+
queuedBy?: string;
|
|
695
|
+
queuedAt?: number;
|
|
696
|
+
reason?: string;
|
|
697
|
+
gridOrder?: ManagedOrder | null;
|
|
698
|
+
}
|
|
699
|
+
/** A startup Phase-1 cancel plan executed in Phase 2. */
|
|
700
|
+
export interface StartupCancelPlan {
|
|
701
|
+
chainOrderId: string;
|
|
702
|
+
chainOrderObj: ChainOrder | ManagedOrder | null;
|
|
703
|
+
releaseUntrackedFunds?: boolean;
|
|
704
|
+
orderType?: OrderType;
|
|
705
|
+
boundaryIdx?: number | null;
|
|
706
|
+
gapSlots?: number;
|
|
707
|
+
gridOrderId?: string;
|
|
708
|
+
gridOrder?: ManagedOrder;
|
|
709
|
+
}
|
|
710
|
+
/** A startup Phase-1 update plan executed in Phase 2. */
|
|
711
|
+
export interface StartupUpdatePlan {
|
|
712
|
+
orderType: OrderType;
|
|
713
|
+
chainOrderId: string;
|
|
714
|
+
chainOrderObj: ChainOrder;
|
|
715
|
+
gridOrderId: string;
|
|
716
|
+
gridOrder: ManagedOrder;
|
|
717
|
+
}
|
|
718
|
+
/** A startup Phase-1 create plan executed in Phase 2. */
|
|
719
|
+
export interface StartupCreatePlan {
|
|
720
|
+
orderType: OrderType;
|
|
721
|
+
gridOrder: ManagedOrder;
|
|
722
|
+
orderLabel?: string;
|
|
723
|
+
recovery?: {
|
|
724
|
+
triggerMessage: string;
|
|
725
|
+
source: string;
|
|
726
|
+
};
|
|
727
|
+
extraOptions?: UnknownRecord;
|
|
728
|
+
}
|
|
729
|
+
/** A validation error/warning emitted by `validateOrder()`. */
|
|
730
|
+
export interface ValidationIssue {
|
|
731
|
+
code: string;
|
|
732
|
+
message: string;
|
|
733
|
+
isFatal?: boolean;
|
|
734
|
+
autoCorrect?: UnknownRecord;
|
|
735
|
+
[key: string]: unknown;
|
|
736
|
+
}
|
|
737
|
+
/** A per-asset fund shortfall emitted by `validateWorkingGridFunds()`. */
|
|
738
|
+
export interface FundShortfall {
|
|
739
|
+
asset: string;
|
|
740
|
+
required: number;
|
|
741
|
+
available: number;
|
|
742
|
+
deficit: number;
|
|
743
|
+
}
|
|
744
|
+
/**
|
|
745
|
+
* A copy-on-write reconcile action (`reconcileGrid` / the COW executor).
|
|
746
|
+
* `type` is one of the `COW_ACTIONS` values; the remaining fields are populated
|
|
747
|
+
* per action kind (CREATE carries `order`, CANCEL carries `orderId`+`reason`,
|
|
748
|
+
* UPDATE carries `newGridId`/`newSize`/`newPrice`/`isRotation`).
|
|
749
|
+
*/
|
|
750
|
+
export interface CowAction {
|
|
751
|
+
type: string;
|
|
752
|
+
id: string;
|
|
753
|
+
orderId?: string | null;
|
|
754
|
+
reason?: string;
|
|
755
|
+
order?: ManagedOrder;
|
|
756
|
+
newGridId?: string;
|
|
757
|
+
newSize?: number;
|
|
758
|
+
newPrice?: number;
|
|
759
|
+
isRotation?: boolean;
|
|
760
|
+
origin?: string;
|
|
761
|
+
evacBoundary?: number;
|
|
762
|
+
evacGapSlots?: number;
|
|
763
|
+
[key: string]: unknown;
|
|
764
|
+
}
|
|
765
|
+
/** A CREATE-target violation from `validateCreateTargetSlots()`. */
|
|
766
|
+
export interface CreateTargetViolation {
|
|
767
|
+
targetId: string;
|
|
768
|
+
currentOrderId?: string | null;
|
|
769
|
+
currentType?: string;
|
|
770
|
+
currentState?: string;
|
|
771
|
+
reason: string;
|
|
772
|
+
duplicateOf?: string;
|
|
773
|
+
[key: string]: unknown;
|
|
774
|
+
}
|
|
775
|
+
/** Asset precisions used by the fund validators (per side). */
|
|
776
|
+
export interface FundPrecisions {
|
|
777
|
+
buyPrecision?: number;
|
|
778
|
+
sellPrecision?: number;
|
|
779
|
+
}
|
|
780
|
+
/** Optimistic/projected fund figures consumed by `validateWorkingGridFunds()`. */
|
|
781
|
+
export interface ProjectedFunds {
|
|
782
|
+
allocatedBuy?: number;
|
|
783
|
+
allocatedSell?: number;
|
|
784
|
+
chainTotalBuy?: number;
|
|
785
|
+
chainTotalSell?: number;
|
|
786
|
+
freeBuy?: number;
|
|
787
|
+
freeSell?: number;
|
|
788
|
+
chainFreeBuy?: number;
|
|
789
|
+
chainFreeSell?: number;
|
|
790
|
+
btsBalance?: {
|
|
791
|
+
free?: number;
|
|
792
|
+
total?: number;
|
|
793
|
+
locked?: number;
|
|
794
|
+
} | null;
|
|
795
|
+
[key: string]: unknown;
|
|
796
|
+
}
|
|
797
|
+
/** A queued broadcast-region entry. */
|
|
798
|
+
export interface PendingBroadcast {
|
|
799
|
+
slotId?: string;
|
|
800
|
+
order?: ManagedOrder | null;
|
|
801
|
+
[key: string]: unknown;
|
|
802
|
+
}
|
|
803
|
+
/** Account-orders adapter surface the engine calls directly. */
|
|
804
|
+
export interface AccountOrdersLike {
|
|
805
|
+
syncMeta(botConfig: unknown): Promise<unknown>;
|
|
806
|
+
storeMasterGrid(...args: unknown[]): Promise<unknown>;
|
|
807
|
+
loadGrid(forceReload?: boolean): unknown[] | null;
|
|
808
|
+
loadBoundaryIdx(forceReload?: boolean): number | null;
|
|
809
|
+
loadGenesis(forceReload?: boolean): unknown;
|
|
810
|
+
loadGapEvacStreaks(forceReload?: boolean): unknown;
|
|
811
|
+
loadLastFillPivot?(forceReload?: boolean): unknown;
|
|
812
|
+
loadPendingFillCrawls(forceReload?: boolean): unknown[];
|
|
813
|
+
loadRecentFillKeys(forceReload?: boolean): unknown;
|
|
814
|
+
loadPersistedAssets(forceReload?: boolean): {
|
|
815
|
+
assetA?: AssetInfo;
|
|
816
|
+
assetB?: AssetInfo;
|
|
817
|
+
} | null;
|
|
818
|
+
loadBtsBalance(forceReload?: boolean): unknown;
|
|
819
|
+
loadBtsFeesOwed(forceReload?: boolean): unknown;
|
|
820
|
+
clearGrid(): Promise<unknown>;
|
|
821
|
+
clearPersistedBoundary(...args: unknown[]): Promise<unknown>;
|
|
822
|
+
clearPersistedLastFillPivot(...args: unknown[]): Promise<unknown>;
|
|
823
|
+
loadProcessedFills(options?: boolean | {
|
|
824
|
+
forceReload?: boolean;
|
|
825
|
+
minTimestamp?: number | null;
|
|
826
|
+
}): Map<string, number>;
|
|
827
|
+
updateProcessedFillsBatch(fills: Map<string, number>): Promise<unknown>;
|
|
828
|
+
cleanOldProcessedFills(olderThanMs?: number): Promise<unknown>;
|
|
829
|
+
getAssetBalances?(forceReload?: boolean): unknown;
|
|
830
|
+
}
|
|
831
|
+
/** Batch-persistence handle for processed fill keys. */
|
|
832
|
+
export interface ProcessedFillStoreLike {
|
|
833
|
+
configure(options?: {
|
|
834
|
+
accountOrders?: AccountOrdersLike | null;
|
|
835
|
+
}): void;
|
|
836
|
+
setShuttingDown(value: boolean): void;
|
|
837
|
+
loadPersisted(options?: {
|
|
838
|
+
forceReload?: boolean;
|
|
839
|
+
minTimestamp?: number | null;
|
|
840
|
+
}): number;
|
|
841
|
+
mergeTracker(sourceTracker: Map<string, number>): void;
|
|
842
|
+
persist(fillKey: string, timestamp: number, options?: {
|
|
843
|
+
mode?: string;
|
|
844
|
+
}): Promise<void>;
|
|
845
|
+
discard(fillKey: string, timestamp?: number): void;
|
|
846
|
+
flush(reason?: string, options?: {
|
|
847
|
+
throwOnError?: boolean;
|
|
848
|
+
}): Promise<void>;
|
|
849
|
+
flushKeys(fillKeys: string[] | Set<string>, reason?: string, options?: {
|
|
850
|
+
throwOnError?: boolean;
|
|
851
|
+
}): Promise<void>;
|
|
852
|
+
[key: string]: unknown;
|
|
853
|
+
}
|
|
854
|
+
/** The manager's logger surface (all levels are present on `Logger`). */
|
|
855
|
+
export interface ManagerLogger {
|
|
856
|
+
log: LogFn;
|
|
857
|
+
warn: LogFn;
|
|
858
|
+
info: LogFn;
|
|
859
|
+
debug: LogFn;
|
|
860
|
+
error: LogFn;
|
|
861
|
+
level?: string;
|
|
862
|
+
marketName?: unknown;
|
|
863
|
+
logFundsStatus(manager: unknown, context?: string, forceDetailed?: boolean): void;
|
|
864
|
+
logOrderGrid?(orders: ManagedOrder[], startPrice: number): void;
|
|
865
|
+
flush?(): Promise<void>;
|
|
866
|
+
}
|
|
867
|
+
/** Mutable recovery-state record (all fields optional to allow partial writes). */
|
|
868
|
+
export interface ManagerRecoveryState {
|
|
869
|
+
phase?: string;
|
|
870
|
+
attemptCount?: number;
|
|
871
|
+
lastAttemptAt?: number;
|
|
872
|
+
inFlight?: boolean;
|
|
873
|
+
lastFailureAt?: number;
|
|
874
|
+
structuralResyncRequested?: boolean;
|
|
875
|
+
[key: string]: unknown;
|
|
876
|
+
}
|
|
877
|
+
/**
|
|
878
|
+
* The contract the order engine consumes from `OrderManager`. This is the
|
|
879
|
+
* decoupled interface the `modules/order/**` layer types its `manager`
|
|
880
|
+
* parameters against, so the engine does not need to import the concrete
|
|
881
|
+
* class (avoiding a runtime import cycle). `OrderManager` structurally
|
|
882
|
+
* satisfies it.
|
|
883
|
+
*
|
|
884
|
+
* Optional members are either wired in later by the runtime layer
|
|
885
|
+
* (e.g. `requestStructuralGridResync`, `notifyBoundaryUpdate`) or read only
|
|
886
|
+
* defensively; keep them optional so partial test doubles still type-check.
|
|
887
|
+
*/
|
|
888
|
+
/** Minimal surface of the credit runtime consumed by the bot/manager layer. */
|
|
889
|
+
export interface CreditRuntimeLike {
|
|
890
|
+
config: GridConfig;
|
|
891
|
+
loadState(): Promise<unknown>;
|
|
892
|
+
refreshState(): Promise<unknown>;
|
|
893
|
+
runMaintenance(context?: unknown, options?: unknown): Promise<unknown>;
|
|
894
|
+
runCreditWatchdog(): Promise<unknown>;
|
|
895
|
+
shutdown(): Promise<unknown>;
|
|
896
|
+
}
|
|
897
|
+
export interface OrderManagerLike {
|
|
898
|
+
_consecutiveBoundaryHolds?: number;
|
|
899
|
+
_boundaryShiftBudgetBase?: number;
|
|
900
|
+
_lastBoundaryHoldInfo?: unknown;
|
|
901
|
+
_lastHeldPlanSignature?: {
|
|
902
|
+
boundaryIdx?: number | null;
|
|
903
|
+
pivot?: number | null;
|
|
904
|
+
fillsAt?: number | null;
|
|
905
|
+
[key: string]: unknown;
|
|
906
|
+
} | null;
|
|
907
|
+
config: GridConfig;
|
|
908
|
+
marketName: string | null;
|
|
909
|
+
logger: ManagerLogger;
|
|
910
|
+
accountId: string | null;
|
|
911
|
+
account?: unknown;
|
|
912
|
+
accountant: AccountantLike;
|
|
913
|
+
strategy?: unknown;
|
|
914
|
+
sync?: unknown;
|
|
915
|
+
orders: Map<string, ManagedOrder>;
|
|
916
|
+
assets: AssetPair;
|
|
917
|
+
funds: ManagerFunds;
|
|
918
|
+
accountTotals: AccountTotals;
|
|
919
|
+
accountOrders: AccountOrdersLike;
|
|
920
|
+
flushGridDirty(contextLabel?: string): Promise<unknown>;
|
|
921
|
+
recordLastFilledPrices(fills: unknown[]): void;
|
|
922
|
+
suspendGridPersistence(reason?: string): unknown;
|
|
923
|
+
resumeGridPersistence(reason?: string | null): unknown;
|
|
924
|
+
boundaryIdx: number | null;
|
|
925
|
+
_deferredRebalanceAt?: number;
|
|
926
|
+
_onBroadcastRegionEndListeners?: Array<() => void>;
|
|
927
|
+
targetGrid?: unknown;
|
|
928
|
+
initialSpreadCount: number;
|
|
929
|
+
currentSpreadCount: number;
|
|
930
|
+
outOfSpread: number;
|
|
931
|
+
btsBalance?: {
|
|
932
|
+
free: number;
|
|
933
|
+
total: number;
|
|
934
|
+
locked: number;
|
|
935
|
+
};
|
|
936
|
+
ordersNeedingPriceCorrection: PendingPriceCorrection[];
|
|
937
|
+
_gapSlots: number;
|
|
938
|
+
_gridVersion: number;
|
|
939
|
+
_gridLock: ManagerLock;
|
|
940
|
+
_fundLock: ManagerLock;
|
|
941
|
+
_accountTotalsPromise: Promise<unknown> | null;
|
|
942
|
+
accountTotalsStale: boolean;
|
|
943
|
+
_placedAt: Map<string, number>;
|
|
944
|
+
_orderIdAssignedAt: Map<string, number>;
|
|
945
|
+
_pendingBroadcasts: Map<string, PendingBroadcast>;
|
|
946
|
+
_pendingFillCrawls: Array<{
|
|
947
|
+
slotId: string;
|
|
948
|
+
side: string;
|
|
949
|
+
ts: number;
|
|
950
|
+
}>;
|
|
951
|
+
_recentFillKeysSnapshot: Record<string, number> | null;
|
|
952
|
+
_gridSidesUpdated: Set<string>;
|
|
953
|
+
shadowOrderIds: Map<string, number>;
|
|
954
|
+
processedFillTracker: Map<string, number>;
|
|
955
|
+
processedFillStore: ProcessedFillStoreLike | null;
|
|
956
|
+
_pauseFundRecalc: number;
|
|
957
|
+
_pauseRecalcLogging: boolean;
|
|
958
|
+
_throwOnIllegalState: boolean;
|
|
959
|
+
_fillBatchInFlight: number;
|
|
960
|
+
_fillProcessingLock: ManagerLock;
|
|
961
|
+
_syncLock: ManagerLock;
|
|
962
|
+
_divergenceLock: ManagerLock;
|
|
963
|
+
_resetLastFillPivot?(reason?: string): boolean;
|
|
964
|
+
_rateLimitStaleTotalsWarn(kind: string): boolean;
|
|
965
|
+
clearStalePipelineOperations(): void;
|
|
966
|
+
isPipelineEmpty(...args: unknown[]): {
|
|
967
|
+
isEmpty: boolean;
|
|
968
|
+
reasons: string[];
|
|
969
|
+
};
|
|
970
|
+
_cleanExpiredLocks(): void;
|
|
971
|
+
getActiveShadowLockCount(): number;
|
|
972
|
+
_clearStaleBroadcastFlag(): void;
|
|
973
|
+
_orphanFillsCreditedAt?: number | null;
|
|
974
|
+
_broadcastingStartedAt: number;
|
|
975
|
+
_recoveryState: ManagerRecoveryState;
|
|
976
|
+
_committedOrderIdsBuiltAt?: number;
|
|
977
|
+
_committedOrderIds?: Set<string>;
|
|
978
|
+
_recoveryAttempted?: boolean;
|
|
979
|
+
_gapEvacStreaks: Map<string, number>;
|
|
980
|
+
_gapEvacCancelQueued?: Set<string>;
|
|
981
|
+
_genesis?: {
|
|
982
|
+
startPrice?: number;
|
|
983
|
+
incrementPercent?: number;
|
|
984
|
+
gapSlots?: number;
|
|
985
|
+
priceLevels?: readonly unknown[];
|
|
986
|
+
priceLevelsHash?: string;
|
|
987
|
+
createdAt?: number;
|
|
988
|
+
} | null;
|
|
989
|
+
_missingGenesis?: unknown;
|
|
990
|
+
_genesisInvariantViolations?: number;
|
|
991
|
+
_genesisInvariantLoggedAt?: number;
|
|
992
|
+
_fundDriftLedger?: {
|
|
993
|
+
side: string;
|
|
994
|
+
direction: string;
|
|
995
|
+
count: number;
|
|
996
|
+
firstAt: number;
|
|
997
|
+
lastAt: number;
|
|
998
|
+
} | null;
|
|
999
|
+
_lastFilledBuyPrice: number | null;
|
|
1000
|
+
_lastFilledSellPrice: number | null;
|
|
1001
|
+
_lastFilledPrice: number | null;
|
|
1002
|
+
_lastFilledType: string | null;
|
|
1003
|
+
_lastFilledAt: number | null;
|
|
1004
|
+
lastFillPivotSource: 'fill' | 'book' | null;
|
|
1005
|
+
_lastUnmatchedChainOrders?: UnmatchedChainOrder[];
|
|
1006
|
+
_lastUnmatchedChainOrdersAt?: number;
|
|
1007
|
+
_lastAccountingFailure?: unknown;
|
|
1008
|
+
_pendingRecovery: Promise<unknown> | null;
|
|
1009
|
+
_lastGridPricingContext?: {
|
|
1010
|
+
gridPrice?: unknown;
|
|
1011
|
+
gridPriceOffsetPct?: unknown;
|
|
1012
|
+
offsetAdjustedStartPrice?: unknown;
|
|
1013
|
+
startPrice?: unknown;
|
|
1014
|
+
configuredMinPrice?: unknown;
|
|
1015
|
+
configuredMaxPrice?: unknown;
|
|
1016
|
+
rangeScalingFactor?: unknown;
|
|
1017
|
+
[key: string]: unknown;
|
|
1018
|
+
} | null;
|
|
1019
|
+
_boundaryShiftBudget?: unknown;
|
|
1020
|
+
_persistenceWarning?: unknown;
|
|
1021
|
+
_recoveryExhaustedAt?: number | null;
|
|
1022
|
+
_skipEmptyReadConfirmDelay?: unknown;
|
|
1023
|
+
_readSingleOrderFn?: unknown;
|
|
1024
|
+
_batchReadOrdersFn?: unknown;
|
|
1025
|
+
_confirmEmptyReadFn?: unknown;
|
|
1026
|
+
_syncGeneration?: number;
|
|
1027
|
+
_suspectEmptyReads?: {
|
|
1028
|
+
count: number;
|
|
1029
|
+
firstAt: number;
|
|
1030
|
+
};
|
|
1031
|
+
_correctionQueueWarnAt?: number;
|
|
1032
|
+
_gridBloatDetectedAt?: number;
|
|
1033
|
+
isRebalancing(): boolean;
|
|
1034
|
+
isBootstrapping(): boolean;
|
|
1035
|
+
isBroadcastingActive(): boolean;
|
|
1036
|
+
isPlanningActive(): boolean;
|
|
1037
|
+
setShuttingDown(value: boolean): void;
|
|
1038
|
+
startBootstrap(): void;
|
|
1039
|
+
finishBootstrap(): void;
|
|
1040
|
+
startBroadcasting(): void;
|
|
1041
|
+
stopBroadcasting(): void;
|
|
1042
|
+
addBroadcastRegionEndListener(listener: () => void): void;
|
|
1043
|
+
_applySync(data: unknown, src: string): Promise<unknown>;
|
|
1044
|
+
synchronizeWithChain(data: unknown, src: string): Promise<SyncResult>;
|
|
1045
|
+
requestStructuralGridResync?: (reason?: string, details?: UnknownRecord) => Promise<{
|
|
1046
|
+
skipped?: boolean;
|
|
1047
|
+
reason?: string;
|
|
1048
|
+
[key: string]: unknown;
|
|
1049
|
+
} | undefined>;
|
|
1050
|
+
validateGridStateForPersistence(options?: {
|
|
1051
|
+
allowBootstrapTransient?: boolean;
|
|
1052
|
+
[key: string]: unknown;
|
|
1053
|
+
}): {
|
|
1054
|
+
isValid: boolean;
|
|
1055
|
+
[key: string]: unknown;
|
|
1056
|
+
};
|
|
1057
|
+
notifyBoundaryUpdate?: (boundaryIdx: number | null) => unknown;
|
|
1058
|
+
resetFunds(): Promise<void>;
|
|
1059
|
+
recalculateFunds(): Promise<void>;
|
|
1060
|
+
applyBotFundsAllocation(): void;
|
|
1061
|
+
setAccountTotals(totals?: Partial<AccountTotals>): Promise<unknown>;
|
|
1062
|
+
refreshAccountTotalsIfStale(options?: {
|
|
1063
|
+
force?: boolean;
|
|
1064
|
+
}): Promise<AccountTotalsGate>;
|
|
1065
|
+
reanchorAccountTotals(label?: string): Promise<unknown>;
|
|
1066
|
+
lockOrders(orderIds: unknown): void;
|
|
1067
|
+
unlockOrders(orderIds: unknown): void;
|
|
1068
|
+
pauseFundRecalc(): void;
|
|
1069
|
+
resumeFundRecalc(): Promise<void>;
|
|
1070
|
+
pauseRecalcLogging(): void;
|
|
1071
|
+
resumeRecalcLogging(): void;
|
|
1072
|
+
fetchAccountTotals(accountId?: string | null): Promise<void>;
|
|
1073
|
+
waitForAccountTotals(timeoutMs?: number): Promise<void>;
|
|
1074
|
+
getChainFundsSnapshot(): ChainFundsSnapshot;
|
|
1075
|
+
_initializeAssets(): Promise<unknown>;
|
|
1076
|
+
_updateOrder(order: ManagedOrder, context?: string, options?: UnknownRecord): Promise<boolean>;
|
|
1077
|
+
_applyOrderUpdate(order: ManagedOrder, context?: string, options?: UnknownRecord): Promise<boolean>;
|
|
1078
|
+
applyGridUpdateBatch(updates: unknown, context?: string, options?: UnknownRecord): Promise<boolean>;
|
|
1079
|
+
getOrdersByTypeAndState(type?: OrderType | null, state?: OrderState): ManagedOrder[];
|
|
1080
|
+
_markGridDirty(): void;
|
|
1081
|
+
_restoreBoundary(newIdx: number | null): void;
|
|
1082
|
+
_clearPendingFillCrawls(reason?: string): void;
|
|
1083
|
+
syncFromOpenOrders(orders: unknown, info?: unknown): Promise<SyncResult>;
|
|
1084
|
+
syncFromFillHistory(fill: unknown, options?: UnknownRecord): Promise<FillHistorySyncResult>;
|
|
1085
|
+
syncFromFillHistoryBatch(fills: unknown, options?: UnknownRecord): Promise<FillHistorySyncResult>;
|
|
1086
|
+
checkSpreadCondition(...args: unknown[]): Promise<{
|
|
1087
|
+
ordersPlaced?: number;
|
|
1088
|
+
[key: string]: unknown;
|
|
1089
|
+
}>;
|
|
1090
|
+
_fetchAccountBalancesAndSetTotals(...args: unknown[]): Promise<unknown>;
|
|
1091
|
+
getInitialOrdersToActivate(): ManagedOrder[];
|
|
1092
|
+
seedLastFilledPricesFromBook(...args: unknown[]): void;
|
|
1093
|
+
checkGridHealth(...args: unknown[]): Promise<GridHealthResult>;
|
|
1094
|
+
processFilledOrders(orders: unknown, excl: unknown, options?: UnknownRecord): Promise<unknown>;
|
|
1095
|
+
performSafeRebalance(fills?: unknown, excludeIds?: Set<string>, options?: UnknownRecord): Promise<RebalanceResult>;
|
|
1096
|
+
consumeIllegalStateSignal(): IllegalStateSignal | null;
|
|
1097
|
+
consumeAccountingFailureSignal(): AccountingFailureSignal | null;
|
|
1098
|
+
checkFundDriftAfterFills(...args: unknown[]): FundDriftCheck;
|
|
1099
|
+
_popWorkingGridRef?(result?: unknown): void;
|
|
1100
|
+
_pushWorkingGridRef(...args: unknown[]): unknown;
|
|
1101
|
+
_resetRebalanceStateToDepth(...args: unknown[]): void;
|
|
1102
|
+
_setRebalanceState(...args: unknown[]): void;
|
|
1103
|
+
_lastBoundaryHoldResyncAt: number;
|
|
1104
|
+
_commitWorkingGrid(workingGrid: unknown, workingIndexes: unknown, workingBoundary: unknown, options?: UnknownRecord): Promise<boolean>;
|
|
1105
|
+
persistGrid(snapshotOrders?: unknown, recentFillKeys?: unknown, fundSnapshot?: {
|
|
1106
|
+
btsFeesOwed: number;
|
|
1107
|
+
accountTotals: AccountTotals;
|
|
1108
|
+
}): Promise<PersistGridResult>;
|
|
1109
|
+
calculateCurrentSpread(): number;
|
|
1110
|
+
}
|
|
42
1111
|
//# sourceMappingURL=types.d.ts.map
|