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
|
@@ -58,6 +58,7 @@
|
|
|
58
58
|
*
|
|
59
59
|
* ===============================================================================
|
|
60
60
|
*/
|
|
61
|
+
import AsyncLock from './order/async_lock.js';
|
|
61
62
|
import { sanitizeKey } from './utils/sanitize_key.js';
|
|
62
63
|
/**
|
|
63
64
|
* Generate a unique key for identifying a bot in storage.
|
|
@@ -68,7 +69,47 @@ import { sanitizeKey } from './utils/sanitize_key.js';
|
|
|
68
69
|
* @param {number} index - Index in bots array (used for unnamed fallback)
|
|
69
70
|
* @returns {string} Sanitized key
|
|
70
71
|
*/
|
|
71
|
-
declare function createBotKey(bot:
|
|
72
|
+
declare function createBotKey(bot: Record<string, unknown> | null | undefined, index: number): string;
|
|
73
|
+
interface BotMeta {
|
|
74
|
+
key: string;
|
|
75
|
+
name: string | null;
|
|
76
|
+
assetA: string | null;
|
|
77
|
+
assetB: string | null;
|
|
78
|
+
active: boolean;
|
|
79
|
+
index: number;
|
|
80
|
+
createdAt: string;
|
|
81
|
+
updatedAt: string;
|
|
82
|
+
}
|
|
83
|
+
interface SerializedOrder {
|
|
84
|
+
id: string | null;
|
|
85
|
+
type: string | null;
|
|
86
|
+
state: string | null;
|
|
87
|
+
price: number;
|
|
88
|
+
size: number;
|
|
89
|
+
orderId: string;
|
|
90
|
+
createUncertain?: boolean;
|
|
91
|
+
}
|
|
92
|
+
interface BotData {
|
|
93
|
+
meta: BotMeta | null;
|
|
94
|
+
grid: SerializedOrder[];
|
|
95
|
+
btsFeesOwed: number;
|
|
96
|
+
btsBalance: Record<string, unknown> | null;
|
|
97
|
+
boundaryIdx: number | null;
|
|
98
|
+
assets: Record<string, unknown> | null;
|
|
99
|
+
debugInputs: Record<string, unknown> | null;
|
|
100
|
+
processedFills: Record<string, number>;
|
|
101
|
+
recentFillKeys: Record<string, unknown>;
|
|
102
|
+
genesis: Record<string, unknown> | null;
|
|
103
|
+
createdAt: string;
|
|
104
|
+
lastUpdated: string;
|
|
105
|
+
gapEvacStreaks?: Record<string, number>;
|
|
106
|
+
pendingFillCrawls?: {
|
|
107
|
+
slotId: string;
|
|
108
|
+
side: string;
|
|
109
|
+
ts: number;
|
|
110
|
+
}[];
|
|
111
|
+
lastFillPivot?: unknown;
|
|
112
|
+
}
|
|
72
113
|
/**
|
|
73
114
|
* AccountOrders class - manages order grid persistence
|
|
74
115
|
*
|
|
@@ -85,9 +126,13 @@ declare function createBotKey(bot: any, index: any): string;
|
|
|
85
126
|
declare class AccountOrders {
|
|
86
127
|
botKey: string;
|
|
87
128
|
profilesPath: string;
|
|
88
|
-
_persistenceLock:
|
|
129
|
+
_persistenceLock: AsyncLock;
|
|
89
130
|
_needsBootstrapSave: boolean;
|
|
90
|
-
data:
|
|
131
|
+
data: BotData;
|
|
132
|
+
_rejectedGenesis?: {
|
|
133
|
+
reason: string;
|
|
134
|
+
at: number;
|
|
135
|
+
};
|
|
91
136
|
/**
|
|
92
137
|
* Create an AccountOrders instance.
|
|
93
138
|
* @param {Object} options - Configuration options
|
|
@@ -105,14 +150,14 @@ declare class AccountOrders {
|
|
|
105
150
|
* @returns {Object|null} The loaded data or null if not found.
|
|
106
151
|
* @private
|
|
107
152
|
*/
|
|
108
|
-
_loadData():
|
|
153
|
+
_loadData(): BotData | null;
|
|
109
154
|
/**
|
|
110
155
|
* Reads and parses a JSON file.
|
|
111
156
|
* @param {string} filePath - The path to the file.
|
|
112
157
|
* @returns {Object|null} The parsed object or null on failure.
|
|
113
158
|
* @private
|
|
114
159
|
*/
|
|
115
|
-
_readFile(filePath:
|
|
160
|
+
_readFile(filePath: string): BotData | null;
|
|
116
161
|
/**
|
|
117
162
|
* Persists the current data to the profile file.
|
|
118
163
|
* @private
|
|
@@ -124,7 +169,7 @@ declare class AccountOrders {
|
|
|
124
169
|
* meta in place if it has drifted. The grid and other state are not touched.
|
|
125
170
|
* @param {Object} botConfig - The bot config matching this.botKey
|
|
126
171
|
*/
|
|
127
|
-
syncMeta(botConfig:
|
|
172
|
+
syncMeta(botConfig: unknown): Promise<void>;
|
|
128
173
|
/**
|
|
129
174
|
* Checks whether two meta objects differ on the relevant fields.
|
|
130
175
|
* @param {Object} existing - The existing meta (possibly null).
|
|
@@ -132,7 +177,7 @@ declare class AccountOrders {
|
|
|
132
177
|
* @returns {boolean} True if meta has changed.
|
|
133
178
|
* @private
|
|
134
179
|
*/
|
|
135
|
-
_metaChanged(existing:
|
|
180
|
+
_metaChanged(existing: BotMeta | null, next: BotMeta): boolean;
|
|
136
181
|
/**
|
|
137
182
|
* Builds a metadata object for a bot.
|
|
138
183
|
* @param {Object} bot - The bot configuration.
|
|
@@ -142,18 +187,9 @@ declare class AccountOrders {
|
|
|
142
187
|
* @returns {Object} The new meta object.
|
|
143
188
|
* @private
|
|
144
189
|
*/
|
|
145
|
-
_buildMeta(bot:
|
|
190
|
+
_buildMeta(bot: unknown, key: string, index: number, existing?: {
|
|
146
191
|
createdAt?: string;
|
|
147
|
-
} | null):
|
|
148
|
-
key: string;
|
|
149
|
-
name: any;
|
|
150
|
-
assetA: any;
|
|
151
|
-
assetB: any;
|
|
152
|
-
active: boolean;
|
|
153
|
-
index: number;
|
|
154
|
-
createdAt: string;
|
|
155
|
-
updatedAt: string;
|
|
156
|
-
};
|
|
192
|
+
} | null): BotMeta;
|
|
157
193
|
/**
|
|
158
194
|
* Save the current order grid snapshot for this bot.
|
|
159
195
|
* Called after grid changes (initialization, fills, syncs).
|
|
@@ -165,7 +201,7 @@ declare class AccountOrders {
|
|
|
165
201
|
* @param {Object|null} recentFillKeys - Optional fill key dedup snapshot for crash recovery
|
|
166
202
|
* @param {Object|null} genesis - Optional frozen genesis (priceLevels etc)
|
|
167
203
|
*/
|
|
168
|
-
storeMasterGrid(orders?:
|
|
204
|
+
storeMasterGrid(orders?: unknown[], btsFeesOwed?: number | null, boundaryIdx?: number | null, assets?: Record<string, unknown> | null, debugInputs?: unknown, recentFillKeys?: Record<string, unknown> | null, genesis?: unknown, gapEvacStreaks?: unknown, pendingFillCrawls?: unknown, lastFillPivot?: unknown): Promise<void>;
|
|
169
205
|
/**
|
|
170
206
|
* Erase a poisoned persisted boundary after GRID-LOAD rejects it with no
|
|
171
207
|
* safe re-derivation. storeMasterGrid deliberately never writes a null
|
|
@@ -194,7 +230,7 @@ declare class AccountOrders {
|
|
|
194
230
|
* @param {boolean} forceReload - If true, reload from disk to ensure fresh data
|
|
195
231
|
* @returns {Array|null} Order grid array or null if not found
|
|
196
232
|
*/
|
|
197
|
-
loadGrid(forceReload?: boolean):
|
|
233
|
+
loadGrid(forceReload?: boolean): SerializedOrder[] | null;
|
|
198
234
|
/**
|
|
199
235
|
* Load the persisted price-ladder (genesis) for this bot.
|
|
200
236
|
*
|
|
@@ -212,7 +248,7 @@ declare class AccountOrders {
|
|
|
212
248
|
* @param {boolean} forceReload - If true, reload from disk
|
|
213
249
|
* @returns {Object|null} The genesis object, or null when absent/invalid
|
|
214
250
|
*/
|
|
215
|
-
loadGenesis(forceReload?: boolean):
|
|
251
|
+
loadGenesis(forceReload?: boolean): import("./order/utils/math.js").GridGenesis | null;
|
|
216
252
|
/**
|
|
217
253
|
* Record why a persisted genesis row was refused (observability for the
|
|
218
254
|
* schema gate above; loadGrid cannot report a row it never receives).
|
|
@@ -223,7 +259,7 @@ declare class AccountOrders {
|
|
|
223
259
|
* @param {boolean} forceReload - If true, reload from disk
|
|
224
260
|
* @returns {Object|null} {slotId: count} map or null when absent
|
|
225
261
|
*/
|
|
226
|
-
loadGapEvacStreaks(forceReload?: boolean):
|
|
262
|
+
loadGapEvacStreaks(forceReload?: boolean): Record<string, number> | null;
|
|
227
263
|
loadLastFillPivot(forceReload?: boolean): {
|
|
228
264
|
price: number;
|
|
229
265
|
type: string;
|
|
@@ -245,13 +281,13 @@ declare class AccountOrders {
|
|
|
245
281
|
* @param {boolean} forceReload - If true, reload from disk
|
|
246
282
|
* @returns {Object|null} Recent fill keys map or null if not found
|
|
247
283
|
*/
|
|
248
|
-
loadRecentFillKeys(forceReload?: boolean):
|
|
284
|
+
loadRecentFillKeys(forceReload?: boolean): Record<string, unknown> | null;
|
|
249
285
|
/**
|
|
250
286
|
* Load persisted asset metadata for this bot.
|
|
251
287
|
* @param {boolean} forceReload - If true, reload from disk
|
|
252
288
|
* @returns {Object|null} Asset metadata { assetA, assetB } or null if not found
|
|
253
289
|
*/
|
|
254
|
-
loadPersistedAssets(forceReload?: boolean):
|
|
290
|
+
loadPersistedAssets(forceReload?: boolean): Record<string, unknown> | null;
|
|
255
291
|
/**
|
|
256
292
|
* Load the master boundary index for this bot.
|
|
257
293
|
* @param {boolean} forceReload - If true, reload from disk
|
|
@@ -263,7 +299,7 @@ declare class AccountOrders {
|
|
|
263
299
|
* @param {boolean} forceReload - If true, reload from disk
|
|
264
300
|
* @returns {Object|null} BTS balance { free, total, locked } or null if not found
|
|
265
301
|
*/
|
|
266
|
-
loadBtsBalance(forceReload?: boolean):
|
|
302
|
+
loadBtsBalance(forceReload?: boolean): Record<string, unknown> | null;
|
|
267
303
|
/**
|
|
268
304
|
* Load BTS blockchain fees owed for this bot.
|
|
269
305
|
* BTS fees accumulate during fill processing and must persist across restarts
|
|
@@ -276,7 +312,7 @@ declare class AccountOrders {
|
|
|
276
312
|
* Clear the persisted grid for this bot.
|
|
277
313
|
* @returns {Promise<boolean>} true if cleared successfully
|
|
278
314
|
*/
|
|
279
|
-
clearGrid(): Promise<
|
|
315
|
+
clearGrid(): Promise<boolean>;
|
|
280
316
|
/**
|
|
281
317
|
* Load processed fill IDs for this bot to prevent reprocessing fills across
|
|
282
318
|
* restarts. Returns a Map of fillKey => timestamp for fills already processed.
|
|
@@ -315,9 +351,9 @@ declare class AccountOrders {
|
|
|
315
351
|
};
|
|
316
352
|
meta: {
|
|
317
353
|
key: string;
|
|
318
|
-
name:
|
|
319
|
-
assetA:
|
|
320
|
-
assetB:
|
|
354
|
+
name: string | null;
|
|
355
|
+
assetA: string | null;
|
|
356
|
+
assetB: string | null;
|
|
321
357
|
};
|
|
322
358
|
} | null;
|
|
323
359
|
/**
|
|
@@ -326,7 +362,7 @@ declare class AccountOrders {
|
|
|
326
362
|
* @returns {Object} The serialized order.
|
|
327
363
|
* @private
|
|
328
364
|
*/
|
|
329
|
-
_serializeOrder(order?:
|
|
365
|
+
_serializeOrder(order?: unknown): SerializedOrder;
|
|
330
366
|
}
|
|
331
367
|
export { AccountOrders, createBotKey, sanitizeKey };
|
|
332
368
|
//# sourceMappingURL=account_orders.d.ts.map
|
|
@@ -68,7 +68,7 @@ import { hasGenesisLadder } from './order/genesis_policy.js';
|
|
|
68
68
|
import * as Format from './order/format.js';
|
|
69
69
|
import { ensureDir, nowIso, normalizeLastFillPivot } from './order/utils/system.js';
|
|
70
70
|
import Logger from './order/logger.js';
|
|
71
|
-
import { getErrorMessage } from './utils/errors.js';
|
|
71
|
+
import { getErrorMessage, getErrorCode } from './utils/errors.js';
|
|
72
72
|
import { sanitizeKey } from './utils/sanitize_key.js';
|
|
73
73
|
const storage = getStorage();
|
|
74
74
|
const { toFiniteNumber } = Format;
|
|
@@ -176,6 +176,7 @@ class AccountOrders {
|
|
|
176
176
|
_persistenceLock;
|
|
177
177
|
_needsBootstrapSave;
|
|
178
178
|
data;
|
|
179
|
+
_rejectedGenesis;
|
|
179
180
|
/**
|
|
180
181
|
* Create an AccountOrders instance.
|
|
181
182
|
* @param {Object} options - Configuration options
|
|
@@ -220,7 +221,7 @@ class AccountOrders {
|
|
|
220
221
|
return parsed;
|
|
221
222
|
}
|
|
222
223
|
catch (err) {
|
|
223
|
-
if (err
|
|
224
|
+
if (getErrorCode(err) === 'ENOENT') {
|
|
224
225
|
return null;
|
|
225
226
|
}
|
|
226
227
|
if (err instanceof SyntaxError) {
|
|
@@ -252,7 +253,8 @@ class AccountOrders {
|
|
|
252
253
|
await this._persistenceLock.acquire(async () => {
|
|
253
254
|
// Reload from disk to ensure we have the latest state
|
|
254
255
|
this.data = this._loadData() || emptyData();
|
|
255
|
-
const
|
|
256
|
+
const cfg = botConfig;
|
|
257
|
+
const newMeta = this._buildMeta(botConfig, this.botKey, typeof cfg.botIndex === 'number' ? cfg.botIndex : 0, this.data.meta);
|
|
256
258
|
const prevMeta = this.data.meta;
|
|
257
259
|
if (this._metaChanged(prevMeta, newMeta)) {
|
|
258
260
|
accountOrdersLogger.info(`Metadata changed for bot ${this.botKey}: updating from old metadata to new`);
|
|
@@ -296,12 +298,13 @@ class AccountOrders {
|
|
|
296
298
|
*/
|
|
297
299
|
_buildMeta(bot, key, index, existing = null) {
|
|
298
300
|
const timestamp = nowIso();
|
|
301
|
+
const b = bot;
|
|
299
302
|
return {
|
|
300
303
|
key,
|
|
301
|
-
name:
|
|
302
|
-
assetA:
|
|
303
|
-
assetB:
|
|
304
|
-
active: !!
|
|
304
|
+
name: b.name || null,
|
|
305
|
+
assetA: b.assetA || null,
|
|
306
|
+
assetB: b.assetB || null,
|
|
307
|
+
active: !!b.active,
|
|
305
308
|
index,
|
|
306
309
|
createdAt: (existing && existing.createdAt) || timestamp,
|
|
307
310
|
updatedAt: timestamp
|
|
@@ -342,10 +345,6 @@ class AccountOrders {
|
|
|
342
345
|
if (debugSnapshot && debugSnapshot.btsBalance) {
|
|
343
346
|
this.data.btsBalance = debugSnapshot.btsBalance;
|
|
344
347
|
}
|
|
345
|
-
// Initialize processedFills if missing (backward compat)
|
|
346
|
-
if (!this.data.processedFills) {
|
|
347
|
-
this.data.processedFills = {};
|
|
348
|
-
}
|
|
349
348
|
// Persist recent fill keys for crash-durable dedup window
|
|
350
349
|
if (recentFillKeys) {
|
|
351
350
|
this.data.recentFillKeys = recentFillKeys;
|
|
@@ -517,9 +516,11 @@ class AccountOrders {
|
|
|
517
516
|
*/
|
|
518
517
|
_noteRejectedGenesis(genesis) {
|
|
519
518
|
try {
|
|
520
|
-
const
|
|
519
|
+
const g = (genesis && typeof genesis === 'object') ? genesis : null;
|
|
520
|
+
const levels = g?.priceLevels;
|
|
521
|
+
const reason = !Array.isArray(levels)
|
|
521
522
|
? 'priceLevels is not an array'
|
|
522
|
-
: (
|
|
523
|
+
: (levels.length === 0 ? 'priceLevels is empty' : 'malformed');
|
|
523
524
|
this._rejectedGenesis = { reason, at: Date.now() };
|
|
524
525
|
}
|
|
525
526
|
catch { /* never fail a load for telemetry */ }
|
|
@@ -788,20 +789,21 @@ class AccountOrders {
|
|
|
788
789
|
* @private
|
|
789
790
|
*/
|
|
790
791
|
_serializeOrder(order = {}) {
|
|
791
|
-
const
|
|
792
|
-
const
|
|
792
|
+
const o = order;
|
|
793
|
+
const priceValue = toFiniteNumber(o.price);
|
|
794
|
+
const sizeValue = toFiniteNumber(o.size);
|
|
793
795
|
// SANITY CHECK: If order is ACTIVE/PARTIAL but has no orderId, it's corrupted.
|
|
794
796
|
// Downgrade to VIRTUAL to prevent persisting phantom active orders.
|
|
795
797
|
// This fixes the root cause of "Active No ID" state in JSON files.
|
|
796
|
-
let state =
|
|
797
|
-
let orderId =
|
|
798
|
+
let state = o.state || null;
|
|
799
|
+
let orderId = o.orderId || '';
|
|
798
800
|
if (isPhantomOrder(order)) {
|
|
799
801
|
state = ORDER_STATES.VIRTUAL;
|
|
800
802
|
orderId = '';
|
|
801
803
|
}
|
|
802
804
|
const serialized = {
|
|
803
|
-
id:
|
|
804
|
-
type:
|
|
805
|
+
id: o.id || null,
|
|
806
|
+
type: o.type || null,
|
|
805
807
|
state: state,
|
|
806
808
|
price: Number.isFinite(priceValue) ? priceValue : 0,
|
|
807
809
|
size: Number.isFinite(sizeValue) ? sizeValue : 0,
|
|
@@ -811,7 +813,7 @@ class AccountOrders {
|
|
|
811
813
|
// leaves the slot VIRTUAL with its planned size. Only that flagged state
|
|
812
814
|
// is a true sized-orphan candidate at load (grid.ts sanitizer) — plain
|
|
813
815
|
// sized VIRTUAL slots are the normal planned-but-unplaced grid state.
|
|
814
|
-
if (
|
|
816
|
+
if (o.createUncertain === true) {
|
|
815
817
|
serialized.createUncertain = true;
|
|
816
818
|
}
|
|
817
819
|
return serialized;
|
|
@@ -1,3 +1,13 @@
|
|
|
1
|
+
interface ChainClientLike {
|
|
2
|
+
db: {
|
|
3
|
+
get_full_accounts(accounts: string[], subscribe: boolean): Promise<unknown>;
|
|
4
|
+
};
|
|
5
|
+
getConfig?(): {
|
|
6
|
+
addressPrefix?: string;
|
|
7
|
+
} | null;
|
|
8
|
+
}
|
|
9
|
+
type TryGetKey = (name: string) => Promise<string | null>;
|
|
10
|
+
type ListNames = () => string[];
|
|
1
11
|
/**
|
|
2
12
|
* Resolve a signing key for an account by walking on-chain authority structures.
|
|
3
13
|
*
|
|
@@ -24,10 +34,10 @@
|
|
|
24
34
|
* @param {Map<string,string>} [pubKeyCache] - Per-call cache for derived public keys (internal)
|
|
25
35
|
* @returns {Promise<string>} Private key WIF string
|
|
26
36
|
*/
|
|
27
|
-
declare function resolvePrivateKey(accountName:
|
|
37
|
+
declare function resolvePrivateKey(accountName: string, chainClient: ChainClientLike, tryGetKey: TryGetKey, listNames: ListNames, depth?: number, pubKeyCache?: Map<string, string>): Promise<string>;
|
|
28
38
|
/**
|
|
29
39
|
* Resolve account ID (1.2.x) to account name via chain.
|
|
30
40
|
*/
|
|
31
|
-
declare function resolveAccountIdToName(chainClient:
|
|
41
|
+
declare function resolveAccountIdToName(chainClient: ChainClientLike, accountId: string | number): Promise<string>;
|
|
32
42
|
export { resolvePrivateKey, resolveAccountIdToName };
|
|
33
43
|
//# sourceMappingURL=authority_resolver.d.ts.map
|
|
@@ -49,10 +49,11 @@ async function resolvePrivateKey(accountName, chainClient, tryGetKey, listNames,
|
|
|
49
49
|
catch (e) {
|
|
50
50
|
throw new Error(`Failed to fetch account '${accountName}' from chain: ${getErrorMessage(e)}`);
|
|
51
51
|
}
|
|
52
|
-
|
|
52
|
+
const fullRows = full;
|
|
53
|
+
if (!fullRows || !fullRows[0] || !fullRows[0][1] || !fullRows[0][1].account) {
|
|
53
54
|
throw new Error(`Account '${accountName}' not found on chain`);
|
|
54
55
|
}
|
|
55
|
-
const account =
|
|
56
|
+
const account = fullRows[0][1].account;
|
|
56
57
|
const active = account.active;
|
|
57
58
|
if (!active || typeof active.weight_threshold === 'undefined') {
|
|
58
59
|
throw new Error(`Account '${accountName}' has no active authority`);
|
|
@@ -130,7 +131,7 @@ function normalizeAuthMap(auth) {
|
|
|
130
131
|
return [];
|
|
131
132
|
if (Array.isArray(auth))
|
|
132
133
|
return auth;
|
|
133
|
-
return Object.entries(auth);
|
|
134
|
+
return Object.entries(auth).map(([k, v]) => [k, Number(v)]);
|
|
134
135
|
}
|
|
135
136
|
/**
|
|
136
137
|
* Resolve account ID (1.2.x) to account name via chain.
|
|
@@ -138,9 +139,10 @@ function normalizeAuthMap(auth) {
|
|
|
138
139
|
async function resolveAccountIdToName(chainClient, accountId) {
|
|
139
140
|
if (!/^1\.2\./.test(String(accountId)))
|
|
140
141
|
return String(accountId);
|
|
141
|
-
const full = await chainClient.db.get_full_accounts([accountId], false);
|
|
142
|
-
|
|
143
|
-
|
|
142
|
+
const full = await chainClient.db.get_full_accounts([String(accountId)], false);
|
|
143
|
+
const fullRows = full;
|
|
144
|
+
if (fullRows && fullRows[0] && fullRows[0][1] && fullRows[0][1].account && fullRows[0][1].account.name) {
|
|
145
|
+
return fullRows[0][1].account.name;
|
|
144
146
|
}
|
|
145
147
|
throw new Error(`Could not resolve account ID '${accountId}' to name`);
|
|
146
148
|
}
|
|
@@ -184,8 +186,13 @@ function matchKeyByPublicKey(targetPubKey, storedKeys, prefix, pubKeyCache) {
|
|
|
184
186
|
if (!pubKeyStr) {
|
|
185
187
|
const { privateKey } = ecc.wifDecode(wif);
|
|
186
188
|
const pubKeyBuf = ecc.privateKeyToPublicKey(privateKey);
|
|
187
|
-
|
|
188
|
-
|
|
189
|
+
if (!pubKeyBuf)
|
|
190
|
+
continue;
|
|
191
|
+
const derived = ecc.publicKeyToString(pubKeyBuf, prefix);
|
|
192
|
+
if (!derived || typeof derived !== 'string')
|
|
193
|
+
continue;
|
|
194
|
+
pubKeyStr = derived;
|
|
195
|
+
pubKeyCache.set(wif, derived);
|
|
189
196
|
}
|
|
190
197
|
if (pubKeyStr === targetPubKey)
|
|
191
198
|
return wif;
|
|
@@ -13,6 +13,11 @@ interface ChainClientConfig {
|
|
|
13
13
|
validateChainId?: boolean;
|
|
14
14
|
expectedChainId?: string;
|
|
15
15
|
}
|
|
16
|
+
interface ChainConfig {
|
|
17
|
+
chainId: string;
|
|
18
|
+
addressPrefix: string;
|
|
19
|
+
coreAsset: string;
|
|
20
|
+
}
|
|
16
21
|
/**
|
|
17
22
|
* Outcome of a forced-reconnect request.
|
|
18
23
|
* - `issued` a fresh teardown/reconnect was started by this call.
|
|
@@ -22,7 +27,37 @@ interface ChainClientConfig {
|
|
|
22
27
|
* - `unavailable` no live socket to tear down, so no recovery attempt exists.
|
|
23
28
|
*/
|
|
24
29
|
export type ForcedReconnectOutcome = 'issued' | 'coalesced' | 'unavailable';
|
|
25
|
-
declare function createChainClient(config?: ChainClientConfig):
|
|
30
|
+
declare function createChainClient(config?: ChainClientConfig): {
|
|
31
|
+
transport: {
|
|
32
|
+
connect: (servers?: string[], autoReconnect?: boolean) => Promise<void>;
|
|
33
|
+
disconnect: () => void;
|
|
34
|
+
forceReconnect: (reason?: string) => void;
|
|
35
|
+
call: (method: string, params: unknown[], timeoutMs?: number) => Promise<unknown>;
|
|
36
|
+
addMessageHandler: (handler: (params: unknown) => void) => (() => void) & {
|
|
37
|
+
isActive: () => boolean;
|
|
38
|
+
};
|
|
39
|
+
getStatus: () => string;
|
|
40
|
+
getNodeUrl: () => string | null;
|
|
41
|
+
isConnected: () => boolean;
|
|
42
|
+
_setNodes: (nodes: string[]) => void;
|
|
43
|
+
_getNodes: () => string[];
|
|
44
|
+
_setAutoReconnect: (flag: boolean) => void;
|
|
45
|
+
};
|
|
46
|
+
connect: (servers?: string[]) => Promise<void>;
|
|
47
|
+
disconnect: () => void;
|
|
48
|
+
forceReconnect: (reason?: string) => ForcedReconnectOutcome;
|
|
49
|
+
setNodes: (servers: string[]) => void;
|
|
50
|
+
getNodes: () => string[];
|
|
51
|
+
getStatus: () => string;
|
|
52
|
+
getConfig: () => ChainConfig | null;
|
|
53
|
+
getCoreAsset: () => string;
|
|
54
|
+
getApiLimitGetAccountHistory: () => number | null;
|
|
55
|
+
db: Record<string, (...args: never[]) => Promise<unknown>>;
|
|
56
|
+
history: Record<string, (...args: never[]) => Promise<unknown>>;
|
|
57
|
+
broadcast: Record<string, (...args: never[]) => Promise<unknown>>;
|
|
58
|
+
login: () => Promise<ChainConfig | undefined>;
|
|
59
|
+
onReconnect: (() => Promise<void>) | null;
|
|
60
|
+
};
|
|
26
61
|
interface ReadOnlyClientConfig {
|
|
27
62
|
nodes?: string[];
|
|
28
63
|
rpcTimeoutMs?: number;
|
|
@@ -34,8 +69,8 @@ declare function createReadOnlyClient(config?: ReadOnlyClientConfig): {
|
|
|
34
69
|
connect: (servers?: string[]) => Promise<void>;
|
|
35
70
|
disconnect: () => void;
|
|
36
71
|
forceReconnect: (reason?: string) => ForcedReconnectOutcome;
|
|
37
|
-
db: (method: string, args?:
|
|
38
|
-
history: (method: string, args?:
|
|
72
|
+
db: (method: string, args?: unknown[]) => Promise<unknown>;
|
|
73
|
+
history: (method: string, args?: unknown[]) => Promise<unknown>;
|
|
39
74
|
setNodes: (servers: string[]) => void;
|
|
40
75
|
getNodes: () => string[];
|
|
41
76
|
getNodeUrl: () => string | null;
|
|
@@ -23,7 +23,8 @@ function toRpcMethodName(method) {
|
|
|
23
23
|
* server-side; the id then points past the new session's _local_apis map.
|
|
24
24
|
*/
|
|
25
25
|
function isStaleApiIdError(err) {
|
|
26
|
-
const
|
|
26
|
+
const e = err;
|
|
27
|
+
const message = e && e.message ? String(e.message) : String(err ?? '');
|
|
27
28
|
if (!message)
|
|
28
29
|
return false;
|
|
29
30
|
return message.includes('_local_apis') || (message.includes('api_id') && message.includes('Assert Exception'));
|
|
@@ -63,6 +64,44 @@ function createForcedReconnectGate(transport) {
|
|
|
63
64
|
return 'issued';
|
|
64
65
|
};
|
|
65
66
|
}
|
|
67
|
+
/**
|
|
68
|
+
* Build the windowed stale-api-id escalation shared by the main and read-only
|
|
69
|
+
* clients. Counting is windowed: a rare stale id (the normal reconnect-race
|
|
70
|
+
* case) never trips the escalation, while a session that fails every call
|
|
71
|
+
* trips it within a few RPCs. The window/threshold/reset policy lives here
|
|
72
|
+
* once; each caller supplies its own reconnect request and reason wording.
|
|
73
|
+
*
|
|
74
|
+
* @param forceReconnect - Client-local forced-reconnect request
|
|
75
|
+
* @param describe - Builds the reconnect reason from the api name and threshold
|
|
76
|
+
* @returns A controller exposing note() and reset()
|
|
77
|
+
*/
|
|
78
|
+
function createStaleApiEscalation(forceReconnect, describe) {
|
|
79
|
+
let errorCount = 0;
|
|
80
|
+
let windowStartedAt = 0;
|
|
81
|
+
return {
|
|
82
|
+
reset() {
|
|
83
|
+
errorCount = 0;
|
|
84
|
+
windowStartedAt = 0;
|
|
85
|
+
},
|
|
86
|
+
note(apiName) {
|
|
87
|
+
const now = Date.now();
|
|
88
|
+
const windowMs = Number.isFinite(TRANSPORT.STALE_API_WINDOW_MS) ? TRANSPORT.STALE_API_WINDOW_MS : 60000;
|
|
89
|
+
const threshold = Number.isFinite(TRANSPORT.STALE_API_FORCE_RECONNECT_AFTER)
|
|
90
|
+
? TRANSPORT.STALE_API_FORCE_RECONNECT_AFTER
|
|
91
|
+
: 3;
|
|
92
|
+
if (now - windowStartedAt > windowMs) {
|
|
93
|
+
windowStartedAt = now;
|
|
94
|
+
errorCount = 0;
|
|
95
|
+
}
|
|
96
|
+
errorCount++;
|
|
97
|
+
if (errorCount < threshold)
|
|
98
|
+
return;
|
|
99
|
+
errorCount = 0;
|
|
100
|
+
windowStartedAt = now;
|
|
101
|
+
forceReconnect(describe(apiName, threshold));
|
|
102
|
+
},
|
|
103
|
+
};
|
|
104
|
+
}
|
|
66
105
|
function createChainClient(config = {}) {
|
|
67
106
|
const { nodes = [], onStatusChange = null, onNodeFailure = null, shouldSkipNode = null, rpcTimeoutMs, connectTimeoutMs, autoreconnect = true, validateChainId = true, expectedChainId = GRAPHENE_CHAIN_ID, } = config;
|
|
68
107
|
const wrappedOnStatusChange = (status, nodeUrl) => {
|
|
@@ -99,12 +138,6 @@ function createChainClient(config = {}) {
|
|
|
99
138
|
}
|
|
100
139
|
let _loginPromise = null;
|
|
101
140
|
let _apiLimitGetAccountHistory = null;
|
|
102
|
-
// Escalation state for a login session that keeps rejecting cached api ids.
|
|
103
|
-
// A single stale error is handled in place (re-register + retry once); a
|
|
104
|
-
// sustained run means the session is wedged and only a fresh socket (on a
|
|
105
|
-
// different node) clears it.
|
|
106
|
-
let _staleApiErrorCount = 0;
|
|
107
|
-
let _staleApiWindowStartedAt = 0;
|
|
108
141
|
// Shared forced-reconnect debounce. Both escalation sources — the stale
|
|
109
142
|
// api_id window below and the subscriptions fill-channel watchdog — call
|
|
110
143
|
// forceReconnect(), so the cooldown lives here, once per client, instead of
|
|
@@ -116,6 +149,7 @@ function createChainClient(config = {}) {
|
|
|
116
149
|
// a session that is nominally connected but rejecting every call.
|
|
117
150
|
// @returns the {@link ForcedReconnectOutcome} of the request.
|
|
118
151
|
const forceReconnect = createForcedReconnectGate(transport);
|
|
152
|
+
const staleApiEscalation = createStaleApiEscalation(forceReconnect, (apiName, threshold) => `repeated stale api_id for ${apiName} (${threshold}x)`);
|
|
119
153
|
if (Array.isArray(nodes) && nodes.length > 0) {
|
|
120
154
|
transport._setNodes(nodes);
|
|
121
155
|
}
|
|
@@ -130,8 +164,7 @@ function createChainClient(config = {}) {
|
|
|
130
164
|
// Drop them so every accessor re-registers against this session.
|
|
131
165
|
resetApiIds();
|
|
132
166
|
// A fresh login session is a clean slate for the stale-id escalation.
|
|
133
|
-
|
|
134
|
-
_staleApiWindowStartedAt = 0;
|
|
167
|
+
staleApiEscalation.reset();
|
|
135
168
|
const result = await transport.call('call', [1, 'login', ['', '']]);
|
|
136
169
|
if (!result) {
|
|
137
170
|
throw new ConnectionError('Login error');
|
|
@@ -230,23 +263,7 @@ function createChainClient(config = {}) {
|
|
|
230
263
|
* marks the active node failed, so the transport prefers another node.
|
|
231
264
|
*/
|
|
232
265
|
function noteStaleApiError(apiName) {
|
|
233
|
-
|
|
234
|
-
const windowMs = Number.isFinite(TRANSPORT.STALE_API_WINDOW_MS) ? TRANSPORT.STALE_API_WINDOW_MS : 60000;
|
|
235
|
-
const threshold = Number.isFinite(TRANSPORT.STALE_API_FORCE_RECONNECT_AFTER)
|
|
236
|
-
? TRANSPORT.STALE_API_FORCE_RECONNECT_AFTER
|
|
237
|
-
: 3;
|
|
238
|
-
if (now - _staleApiWindowStartedAt > windowMs) {
|
|
239
|
-
_staleApiWindowStartedAt = now;
|
|
240
|
-
_staleApiErrorCount = 0;
|
|
241
|
-
}
|
|
242
|
-
_staleApiErrorCount++;
|
|
243
|
-
if (_staleApiErrorCount < threshold)
|
|
244
|
-
return;
|
|
245
|
-
_staleApiErrorCount = 0;
|
|
246
|
-
_staleApiWindowStartedAt = now;
|
|
247
|
-
// Go through the local wrapper so this escalation shares the one
|
|
248
|
-
// per-client cooldown with the subscriptions watchdog.
|
|
249
|
-
forceReconnect(`repeated stale api_id for ${apiName} (${threshold}x)`);
|
|
266
|
+
staleApiEscalation.note(apiName);
|
|
250
267
|
}
|
|
251
268
|
async function dbCall(method, args) {
|
|
252
269
|
return callWithApiRecovery('database', toRpcMethodName(method), args || [], () => _dbApiId, (id) => { _dbApiId = id; });
|
|
@@ -337,9 +354,6 @@ function createReadOnlyClient(config = {}) {
|
|
|
337
354
|
let _dbApiId = null;
|
|
338
355
|
let _historyApiId = null;
|
|
339
356
|
let _recoverPromise = null;
|
|
340
|
-
// Windowed escalation for a read channel whose session keeps rejecting ids.
|
|
341
|
-
let _staleApiErrorCount = 0;
|
|
342
|
-
let _staleApiWindowStartedAt = 0;
|
|
343
357
|
function resetApiIds() {
|
|
344
358
|
_dbApiId = null;
|
|
345
359
|
_historyApiId = null;
|
|
@@ -356,6 +370,7 @@ function createReadOnlyClient(config = {}) {
|
|
|
356
370
|
// client: one cooldown and one outcome for every forced reconnect raised on
|
|
357
371
|
// this client (stale api_id escalation today).
|
|
358
372
|
const forceReconnect = createForcedReconnectGate(transport);
|
|
373
|
+
const staleApiEscalation = createStaleApiEscalation(forceReconnect, (_apiName, threshold) => `repeated stale api_id on read channel (${threshold}x)`);
|
|
359
374
|
async function connect(servers) {
|
|
360
375
|
const effectiveNodes = Array.isArray(servers) && servers.length > 0
|
|
361
376
|
? servers
|
|
@@ -447,23 +462,7 @@ function createReadOnlyClient(config = {}) {
|
|
|
447
462
|
* run forces a fresh connection on another node.
|
|
448
463
|
*/
|
|
449
464
|
function noteStaleApiError() {
|
|
450
|
-
|
|
451
|
-
const windowMs = Number.isFinite(TRANSPORT.STALE_API_WINDOW_MS) ? TRANSPORT.STALE_API_WINDOW_MS : 60000;
|
|
452
|
-
const threshold = Number.isFinite(TRANSPORT.STALE_API_FORCE_RECONNECT_AFTER)
|
|
453
|
-
? TRANSPORT.STALE_API_FORCE_RECONNECT_AFTER
|
|
454
|
-
: 3;
|
|
455
|
-
if (now - _staleApiWindowStartedAt > windowMs) {
|
|
456
|
-
_staleApiWindowStartedAt = now;
|
|
457
|
-
_staleApiErrorCount = 0;
|
|
458
|
-
}
|
|
459
|
-
_staleApiErrorCount++;
|
|
460
|
-
if (_staleApiErrorCount < threshold)
|
|
461
|
-
return;
|
|
462
|
-
_staleApiErrorCount = 0;
|
|
463
|
-
_staleApiWindowStartedAt = now;
|
|
464
|
-
// Route through the shared wrapper so both stale-id escalations on this
|
|
465
|
-
// client obey one cooldown.
|
|
466
|
-
forceReconnect(`repeated stale api_id on read channel (${threshold}x)`);
|
|
465
|
+
staleApiEscalation.note();
|
|
467
466
|
}
|
|
468
467
|
async function db(method, args) {
|
|
469
468
|
return callWithRecovery(toRpcMethodName(method), args || [], () => _dbApiId, (id) => { _dbApiId = id; });
|