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
package/docs/MPA_CREDIT_USAGE.md
CHANGED
|
@@ -266,6 +266,26 @@ When a deal's `latest_repay_time` is within `CREDIT_DEAL_EXPIRY_THRESHOLD_HOURS`
|
|
|
266
266
|
|
|
267
267
|
If inline reborrow cannot be built safely, the runtime stores a deferred reborrow request in `profiles/credit_runtime/<botKey>.json` and retries later.
|
|
268
268
|
|
|
269
|
+
#### Shortfall-Aware Partial Renewal
|
|
270
|
+
|
|
271
|
+
The repay leg is funded from the borrower's *free* debt-asset balance before the atomic reborrow returns anything. If that balance is below principal + credit fee (the borrowed asset was spent into the grid), a full renewal fails on-chain with `Insufficient Balance`. The runtime renews the largest affordable piece instead:
|
|
272
|
+
|
|
273
|
+
- `free >= principal + fee` → full renewal (legacy behaviour).
|
|
274
|
+
- Otherwise repay/reborrow the largest piece that fits, floored to the debt-asset precision, clamped to the offer's `min_deal_amount` and the policy's `maxBorrowAmountPerOperation`, and leaving one raw unit unspent as a balance-drift buffer.
|
|
275
|
+
- The remainder keeps its original `latest_repay_time` (the rolled piece gets a fresh one), so later cycles chip it away.
|
|
276
|
+
- If no piece can be formed, it falls back to the full renewal so the chain error still surfaces.
|
|
277
|
+
|
|
278
|
+
The reborrow snapshots the pre-repay deal IDs, so the stale-entry guard only drops a request when a deal *appeared after* the repay on the same offer — sibling deals no longer block a legitimate reborrow.
|
|
279
|
+
|
|
280
|
+
#### Collateral Shortfall Scaling
|
|
281
|
+
|
|
282
|
+
A reborrow can only lock the collateral the repay just released. If the market moved against the collateral, the full debt needs more than the deal holds, so the runtime clamps the borrow to the released collateral rather than emit an op that fails the collateral check:
|
|
283
|
+
|
|
284
|
+
- `buildCreditOfferAcceptOperation` takes an optional raw `availableCollateralAmount` budget and shrinks the borrow to the maximum that budget can back at the offer price (`capBorrowToCollateral`). It lives in the shared builder, so original, fallback, and deferred reborrows all get it.
|
|
285
|
+
- A clamped borrow below `min_deal_amount` is deferred and retried (up to `TIMING.CREDIT_REBORROW_MAX_ATTEMPTS`, default `6`) so a price recovery can revive it; after the limit it is dropped. The repay still proceeds, so the position deleverages.
|
|
286
|
+
- The collateral-switch flow passes the new asset's balance as the budget.
|
|
287
|
+
- Each accept records `requestedBorrowAmount` vs `borrowAmount` and `clampedByCollateral` in `lastBorrowRequest`.
|
|
288
|
+
|
|
269
289
|
### Collateral Switching on Renewal
|
|
270
290
|
|
|
271
291
|
You can switch a credit deal's collateral to a different asset on its next renewal by changing `lendingItem.collateralAsset` to the new asset in `bots.json`. The runtime detects existing deals whose collateral no longer matches the policy and migrates them during proactive expiry repay+reborrow. Requirements:
|
|
@@ -322,7 +342,7 @@ The file tracks discovered chain state and pending work, including:
|
|
|
322
342
|
- `positions` — per-position state map keyed as `debtAssetId:collateralAssetId`
|
|
323
343
|
- Active MPA call-order state and credit deal IDs per position
|
|
324
344
|
- `assignedCollateralBudget` per position
|
|
325
|
-
- Pending reborrow requests (including deferred split pieces when an oversized-deal cycle hits `CREDIT_DEAL_SPLIT_MAX_PIECES`)
|
|
345
|
+
- Pending reborrow requests (including deferred split pieces when an oversized-deal cycle hits `CREDIT_DEAL_SPLIT_MAX_PIECES`, and the `reborrowAttempts` counter that bounds retries)
|
|
326
346
|
- Last repay timestamp and grid reset request
|
|
327
347
|
- Debt snapshot across all assets
|
|
328
348
|
|
|
@@ -343,8 +363,7 @@ Treat this file as runtime state, not primary configuration. The source of truth
|
|
|
343
363
|
|
|
344
364
|
- `modules/credit_runtime.ts`: debt workflow executor (Phase 0 oversized-deal splitter lives here)
|
|
345
365
|
- `modules/credit_pricing.ts`: canonical credit-pricing math (offer orientation, conversion rates, CR, fees) shared by runtime and analyzer
|
|
346
|
-
- `modules/cr_planner.ts`: MPA debt-first planner
|
|
347
|
-
- `modules/cr_planner.ts`: `DebtFirstCrPlanOptions` — planner options carrying `maxBorrowAmountPerOperation`; lending-item shapes are validated inline in `bot_settings.ts`
|
|
366
|
+
- `modules/cr_planner.ts`: MPA debt-first planner (`DebtFirstCrPlanOptions`, clamps `debtDelta` by `maxBorrowAmountPerOperation`); lending-item shapes are validated in `modules/bot_settings.ts`
|
|
348
367
|
- `modules/dexbot_class.ts`: runtime startup and watchdog lifecycle
|
|
349
368
|
- `modules/bot_settings.ts`: `debtPolicy` validation
|
|
350
369
|
- `market_adapter/README.md`: AMA pricing, grid triggers, and dynamic-weight runtime
|
package/docs/README.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
This directory contains the comprehensive technical documentation for the DEXBot2 trading bot. It is designed to guide developers from high-level architecture down to the nuances of fund accounting and state management.
|
|
4
4
|
|
|
5
|
-
**Version context:** v1.6.
|
|
5
|
+
**Version context:** v1.6.12 (released).
|
|
6
6
|
|
|
7
7
|
---
|
|
8
8
|
|
|
@@ -36,7 +36,7 @@ This directory contains the comprehensive technical documentation for the DEXBot
|
|
|
36
36
|
- **AMA Fitting**: Parameter fitting, comparison charts, and LP data workflows
|
|
37
37
|
- **Bot Fitting**: Grid parameter sweep backtests for AMA winners
|
|
38
38
|
- **TradingView Exports**: Chart export utilities for visual analysis
|
|
39
|
-
- **Trade Profitability**: FIFO-based PnL analysis from Kibana fill data (`trade_profitability.ts`)
|
|
39
|
+
- **Trade Profitability**: FIFO-based PnL analysis from Kibana fill data (`trade_profitability.ts`), plus the self-contained HTML report behind `dexbot pnl` (`pnl_report.ts`) with a per-account month-shard fill cache (`fills_cache.ts`)
|
|
40
40
|
- **Bot Usage Discovery**: On-chain bot account finder and Kibana query helpers (`bot_usage/`)
|
|
41
41
|
|
|
42
42
|
### 🦀 [Claw](../claw/README.md)
|
|
@@ -62,10 +62,16 @@ This directory contains the comprehensive technical documentation for the DEXBot
|
|
|
62
62
|
- **Configuration**: Per-source thresholds, whitelist requirements, and defaults
|
|
63
63
|
- **Trigger Execution**: How `profiles/recalculate.<botKey>.trigger` is consumed under the fill-processing lock
|
|
64
64
|
|
|
65
|
+
### 📉 [AMA-Slope Window](AMA_SLOPE_WINDOW.md)
|
|
66
|
+
*Why the Huber slope window is 16h and gated by a 3-bar persistence check.*
|
|
67
|
+
- **Decision**: `DYNAMIC_WEIGHT_AMA_LOOKBACK_BARS` 20 → 16, `AMA_SLOPE_PERSIST_ENABLED` false → true (`AMA_SLOPE_PERSIST_BARS = 3`)
|
|
68
|
+
- **Rationale**: shorter, more responsive window plus the persistence gate cuts slope-reset churn (~35%) and whipsaw without changing the estimator
|
|
69
|
+
- **Evidence**: measured reset/lag/whipsaw table from a live 1h pool via `backtest_ama_slope_huber.ts`
|
|
70
|
+
|
|
65
71
|
### 🔁 [Grid Reconciliation](GRID_RECONCILE.md)
|
|
66
72
|
*How the bot re-aligns its intended grid with on-chain reality at startup.*
|
|
67
73
|
- **3-Phase Plan-then-Execute**: Phase 1 pure in-memory planning under `_gridLock`, Phase 2 blockchain execution outside the lock, Phase 3 fresh re-read and stale surplus cleanup
|
|
68
|
-
- **Safety Guardrails**: Fresh-grid `matchedOnGrid > 0` guard, exact slot-price duplicate cancel, freshly-assigned deferral, and truncated-read ambiguity handling
|
|
74
|
+
- **Safety Guardrails**: Fresh-grid `matchedOnGrid > 0` guard, exact slot-price duplicate cancel, freshly-assigned deferral, the `SURPLUS_CANCEL_GRACE_MS` fresh-placement grace, and truncated-read ambiguity handling
|
|
69
75
|
- **Partial Failure State**: No rollback on partial Phase 2 success; remaining mismatches caught by the next maintenance or startup cycle
|
|
70
76
|
- **Lock Hierarchy**: Canonical `_syncLock`/`_gridLock` level reference and the 1.4.6 ABBA deadlock correction
|
|
71
77
|
|
|
@@ -161,7 +167,7 @@ This directory contains the comprehensive technical documentation for the DEXBot
|
|
|
161
167
|
- **Signal Concepts**: Dynamic weights, regime detection, and market adapter integration
|
|
162
168
|
- **Debt Policy**: Native MPA and credit offer configuration and runtime rules
|
|
163
169
|
- **Practical How-Tos**: Adding features step by step, common pitfalls to avoid, and useful debugging commands.
|
|
164
|
-
- **Glossary**: Definitions of project-specific terminology (e.g., "
|
|
170
|
+
- **Glossary**: Definitions of project-specific terminology (e.g., "VIRTUAL order state", "Rotation", "Pipeline Safety", "WorkingGrid", "Atomic Commit", "Dynamic Weight", "Regime Detection").
|
|
165
171
|
|
|
166
172
|
### 🔄 [Workflow](WORKFLOW.md)
|
|
167
173
|
*How we build and release.*
|
|
@@ -189,6 +195,11 @@ This directory contains the comprehensive technical documentation for the DEXBot
|
|
|
189
195
|
*Release notes and documentation history.*
|
|
190
196
|
- **Scope**: Versioned notes per release
|
|
191
197
|
|
|
198
|
+
### 📐 [DEXBot2 vs the Power-Law Liquidity Curve](DEXBOT2_VS_POWER_LAW_CURVE.md)
|
|
199
|
+
*Design proposal comparing DEXBot2's weight + range allocation with AMM liquidity curves.*
|
|
200
|
+
- **Scope**: Constant-product, weighted-geometric-mean, and Reciprocal-CES curves vs the bot's order-book allocation
|
|
201
|
+
- **Audience**: Protocol designers evaluating an AMM that reproduces DEXBot2's allocation
|
|
202
|
+
|
|
192
203
|
### 🧮 [DEXBot vs DEXBot2 Comparison](DEXBOT_COMPARISON.md)
|
|
193
204
|
*Architectural, functional, and operational comparison with the original Python DEXBot.*
|
|
194
205
|
- **Scope**: Full side-by-side of technology stack, architecture, trading strategies, order management, configuration, blockchain integration, fund accounting, and concurrency safety
|
package/docs/WORKFLOW.md
CHANGED
|
@@ -254,6 +254,7 @@ the canonical name is preferred in scripts and docs.
|
|
|
254
254
|
| `dexbot credit` | — | Live summed MPA + borrowed-credit positions per asset per bot (`[<bot>]`) |
|
|
255
255
|
| `dexbot tv <target>` | — | TradingView 1h chart for `<bot|pool-id|AssetA/AssetB>` over `--month N` (default 3) |
|
|
256
256
|
| `dexbot dw <target>` | — | Dynamic-weight research chart: same targets/flags as `tv` |
|
|
257
|
+
| `dexbot pnl <account>` | — | HTML PnL report for a bot/account over `--month N`, optional `--pair BASE/QUOTE` filter |
|
|
257
258
|
| `dexbot status` | `stat`, `stats` | Unified runtime health — daemon, adapter, bots |
|
|
258
259
|
| `dexbot start` | `unlock` | Run credential daemon + bot (equivalent to running the `unlock` runtime, `dist/unlock.js`) |
|
|
259
260
|
| `dexbot stop` | `stp`, `stopall` | Stop the monolithic runtime (unlock mode) |
|
package/docs/architecture.md
CHANGED
|
@@ -146,6 +146,7 @@ graph TB
|
|
|
146
146
|
|
|
147
147
|
WORKGRID[WorkingGrid<br/>working_grid.ts]
|
|
148
148
|
GRID_RECONCILE[GridReconcile<br/>grid_reconcile.ts]
|
|
149
|
+
COW_RUNTIME[COWRuntime<br/>dexbot_cow_runtime.ts]
|
|
149
150
|
UTILS[Utils<br/>utils/]
|
|
150
151
|
LOGGER[Logger<br/>logger.ts]
|
|
151
152
|
FILL_STORE[ProcessedFillStore<br/>processed_fill_store.ts]
|
|
@@ -190,7 +191,7 @@ graph TB
|
|
|
190
191
|
MANAGER --> GRID_RECONCILE
|
|
191
192
|
MANAGER --> UTILS
|
|
192
193
|
MANAGER --> LOGGER
|
|
193
|
-
MANAGER -->
|
|
194
|
+
MANAGER --> COW_RUNTIME
|
|
194
195
|
MANAGER --> FILL_STORE
|
|
195
196
|
|
|
196
197
|
ACCOUNTANT --> FUND_REGISTRY
|
|
@@ -198,7 +199,7 @@ graph TB
|
|
|
198
199
|
SYNC --> UTILS
|
|
199
200
|
GRID --> UTILS
|
|
200
201
|
|
|
201
|
-
|
|
202
|
+
COW_RUNTIME --> CHAIN_ORDERS
|
|
202
203
|
SYNC --> ACCOUNT_ORDERS
|
|
203
204
|
MANAGER --> ACCOUNT_BOTS
|
|
204
205
|
|
|
@@ -1110,13 +1111,15 @@ The system continuously monitors three mathematical invariants:
|
|
|
1110
1111
|
### Metrics Tracking
|
|
1111
1112
|
|
|
1112
1113
|
```javascript
|
|
1113
|
-
|
|
1114
|
-
// Returns:
|
|
1115
|
-
// -
|
|
1116
|
-
// -
|
|
1117
|
-
// - lockAcquisitions
|
|
1118
|
-
// -
|
|
1119
|
-
// -
|
|
1114
|
+
bot.getMetrics()
|
|
1115
|
+
// Returns (OrderManager._metrics plus live pipeline state):
|
|
1116
|
+
// - fillsProcessed, batchesExecuted, fillProcessingTimeMs, maxQueueDepth
|
|
1117
|
+
// - fundRecalcCount, lastSyncDurationMs, metricsStartTime
|
|
1118
|
+
// - lockAcquisitions, lockContentionEvents, lockContentionSkips, gridLockContention
|
|
1119
|
+
// - spreadRoleConversionBlocked
|
|
1120
|
+
// - queueDepth, fillProcessingLockActive, divergenceLockActive, shadowLocksActive
|
|
1121
|
+
// - recoveryExhaustedAt, recentFillsTracked
|
|
1122
|
+
// - unmatchedChainOrders, heldChainOrders, blockingChainOrders
|
|
1120
1123
|
```
|
|
1121
1124
|
|
|
1122
1125
|
---
|
package/docs/developer_guide.md
CHANGED
|
@@ -44,8 +44,8 @@ Follow this path through the codebase:
|
|
|
44
44
|
- `modules/constants.ts::MARKET_ADAPTER` - AMA, dynamic weight, and regime detection defaults
|
|
45
45
|
- `modules/constants.ts::REGIME_TABLE` - Hurst/PE regime signal-strength table
|
|
46
46
|
- `modules/dexbot_class.ts::_handleBatchHardAbort()` - Hard-abort recovery handler
|
|
47
|
-
- `modules/
|
|
48
|
-
- `
|
|
47
|
+
- `bot._staleCleanedOrderIds` (`modules/dexbot_fill_runtime.ts`, typed in `modules/types.ts`) - Orphan-fill deduplication tracking
|
|
48
|
+
- `bot._cancelDustOrders()` (`modules/dexbot_maintenance_runtime.ts` / `modules/dexbot_fill_runtime.ts`) - Auto-cancel dust partials on-chain immediately (no timer)
|
|
49
49
|
- `modules/credit_runtime.ts` - Debt workflow executor (MPA and credit offer)
|
|
50
50
|
- `market_adapter/core/market_adapter_service.ts` - Signal pipeline (AMA, dynamic weights, collateral advisory)
|
|
51
51
|
|
|
@@ -909,7 +909,7 @@ convention marker — AsyncLock does not enforce it at runtime.
|
|
|
909
909
|
|
|
910
910
|
**`adjustTotalBalance` Locking Contract** (v1.4.7):
|
|
911
911
|
|
|
912
|
-
The public `adjustTotalBalance()` (Level 4) is now async and **acquires `_fundLock` internally**. Callers that already hold `_fundLock` (e.g. `
|
|
912
|
+
The public `adjustTotalBalance()` (Level 4) is now async and **acquires `_fundLock` internally**. Callers that already hold `_fundLock` (e.g. the fee-settlement paths inside `modules/order/accounting.ts`) must use the private `_adjustTotalBalanceLocked()` sync helper instead to avoid redundant nested re-entrancy. Callers outside any `_fundLock` region (e.g. `_applyBalanceAdjustments`, rollback, and the maintenance/sync/cow-runtime call sites) should continue using `adjustTotalBalance()` with `await`.
|
|
913
913
|
|
|
914
914
|
**Example: Safe Pattern**
|
|
915
915
|
|
|
@@ -976,9 +976,9 @@ async start() {
|
|
|
976
976
|
|
|
977
977
|
All new orders pass through two validation gates:
|
|
978
978
|
|
|
979
|
-
1. **Strategy/Grid Logic** (`strategy.ts`, `grid.ts`):
|
|
979
|
+
1. **Strategy/Grid Logic** (`strategy.ts`, `grid.ts`, `utils/validate.ts`):
|
|
980
980
|
- Check: `size >= getMinOrderSize(type, assets, factor)`
|
|
981
|
-
- Double-dust threshold: `size >=
|
|
981
|
+
- Double-dust threshold: `size >= getDoubleDustThreshold(idealSize, dustThresholdPercent)` (`utils/validate.ts` `isCreateHealthy`)
|
|
982
982
|
- Prevents undersized placement attempts
|
|
983
983
|
|
|
984
984
|
2. **Broadcast Validation** (`dexbot_class.ts`):
|
|
@@ -1490,7 +1490,7 @@ manager.logger.logFundsStatus(manager, 'CONTEXT');
|
|
|
1490
1490
|
|
|
1491
1491
|
### View Metrics
|
|
1492
1492
|
```javascript
|
|
1493
|
-
console.log(
|
|
1493
|
+
console.log(dexbot.getMetrics()); // OrderManager._metrics plus live pipeline state
|
|
1494
1494
|
```
|
|
1495
1495
|
|
|
1496
1496
|
### Check Order Map Integrity
|
package/market_adapter/README.md
CHANGED
|
@@ -12,9 +12,11 @@ The live signal layer for AMA-priced bots. It reads candles, computes the AMA ce
|
|
|
12
12
|
- [Symmetric Weight Shift](#symmetric-weight-shift)
|
|
13
13
|
- [Trigger Threshold](#trigger-threshold)
|
|
14
14
|
- [Settings and Overrides](#settings-and-overrides)
|
|
15
|
+
- [Off-Hour Idle Behavior](#off-hour-idle-behavior)
|
|
15
16
|
- [Live Writes and Dry-Run](#live-writes-and-dry-run)
|
|
16
17
|
- [Useful Commands](#useful-commands)
|
|
17
18
|
- [Troubleshooting](#troubleshooting)
|
|
19
|
+
- [Related Tools](#related-tools)
|
|
18
20
|
- [Technical Reference](#technical-reference)
|
|
19
21
|
|
|
20
22
|
## Which section do I need?
|
|
@@ -95,12 +97,6 @@ the pair's `defaultAma` from
|
|
|
95
97
|
`gridPrice: "ama4"` force a specific preset. If no pair profile matches, the
|
|
96
98
|
bot's `ama` block is used as the fallback.
|
|
97
99
|
|
|
98
|
-
Bots can optionally add `ama.erSmoothPeriod` to smooth Kaufman's raw Efficiency
|
|
99
|
-
Ratio before it enters the AMA smoothing-constant formula. The default is `0`,
|
|
100
|
-
which disables this DEXBot2 extension and preserves raw Kaufman behavior. Useful
|
|
101
|
-
values start around `3` to `5` when a faster AMA is desired but raw ER spikes
|
|
102
|
-
cause abrupt grid-center changes.
|
|
103
|
-
|
|
104
100
|
### Empirical Divergence Risk Management
|
|
105
101
|
|
|
106
102
|
The adapter uses tiered clamping thresholds to manage inventory risk during extreme price divergence from the AMA trend center. These thresholds are derived from historical pool volatility and replace static 'fit cap' multipliers. The specific clamping limits and exit parameters are calculated per pair and preset using the AMA fitting toolchain:
|
|
@@ -414,6 +410,7 @@ node dist/analysis/ama_fitting/calibrate_convergence_er.js --data market_adapter
|
|
|
414
410
|
|
|
415
411
|
More tools:
|
|
416
412
|
|
|
413
|
+
- [`dexbot tv`](../analysis/tradingview/README.md) — one-step candle fetch + chart, with the grid range and AMA recentering overlaid (handy for tuning `minPrice` / `maxPrice`)
|
|
417
414
|
- [Analysis](../analysis/README.md)
|
|
418
415
|
- [Scripts](../scripts/README.md)
|
|
419
416
|
|
|
@@ -623,6 +620,7 @@ market_adapter/
|
|
|
623
620
|
| |-- adapter_client.ts inter-process credential daemon client
|
|
624
621
|
| |-- native_history.ts native BitShares market history fetch
|
|
625
622
|
| |-- file_lock.ts single-instance file lock
|
|
623
|
+
| |-- file_json_cache.ts write-through JSON read cache
|
|
626
624
|
| |-- data_discovery.ts data directory auto-discovery
|
|
627
625
|
| |-- atomic_write.ts atomic file write utility
|
|
628
626
|
| |-- dynamic_grid_snapshot.ts dynamic grid snapshot helpers
|
|
@@ -806,7 +804,9 @@ Main override knobs live in `profiles/market_adapter_settings.json`:
|
|
|
806
804
|
| `dw` | Kalman displacement weighting |
|
|
807
805
|
| `gain` | Output amplitude |
|
|
808
806
|
| `amaSlopePercentMode` | Slope override units: `perBar` for percent per bar, or `window`/unset for legacy cumulative percent over the lookback |
|
|
809
|
-
| `amaSlope.lookbackBars` | AMA slope lookback; slope is averaged per bar over this window |
|
|
807
|
+
| `amaSlope.lookbackBars` | AMA slope lookback; slope is averaged per bar over this window (default 16) |
|
|
808
|
+
| `amaSlope.persistBars` | Slope-delta persistence gate: consecutive confirming bars required before the slope reset fires (default `MARKET_ADAPTER.AMA_SLOPE_PERSIST_BARS`, 3). `1` = legacy fire-on-first-crossing; `0` = disable. Negative/absent values fall through to the global flag |
|
|
809
|
+
| `amaSlope.persistEnabled` | Per-bot tri-state override of the master switch: `false` disables the gate for this bot/market even when `AMA_SLOPE_PERSIST_ENABLED` is on, `true` forces it on, unset follows the global flag |
|
|
810
810
|
| `amaSlope.neutralZonePct` | Dead band around flat average AMA slope |
|
|
811
811
|
| `amaSlope.maxSlopePct` | Average AMA slope saturation |
|
|
812
812
|
| `amaSlopeDeltaThresholdPercent` | Average AMA slope delta threshold for slope-based resets |
|
|
@@ -876,28 +876,12 @@ bias_remaining(K) ≈ bias_initial × ∏ (1 − SC_i) for i = 1..K
|
|
|
876
876
|
Kaufman's smoothing constant is the ER-scaled value, squared:
|
|
877
877
|
|
|
878
878
|
```
|
|
879
|
-
SC_i = [
|
|
879
|
+
SC_i = [ER_i × (fastSC − slowSC) + slowSC]²
|
|
880
880
|
|
|
881
881
|
where fastSC = 2 / (fastPeriod + 1)
|
|
882
882
|
slowSC = 2 / (slowPeriod + 1)
|
|
883
883
|
```
|
|
884
884
|
|
|
885
|
-
By default, `ER_effective_i` is Kaufman's raw `ER_i`. If `ama.erSmoothPeriod`
|
|
886
|
-
or `MARKET_ADAPTER.AMA_ER_SMOOTH_FAST_PERIOD` is set to `1` or higher, DEXBot2
|
|
887
|
-
first applies EMA smoothing to the ER stream:
|
|
888
|
-
|
|
889
|
-
```
|
|
890
|
-
ER_effective_i = ER_effective_(i-1) + erSmoothAlpha × (ER_i − ER_effective_(i-1))
|
|
891
|
-
|
|
892
|
-
where erSmoothAlpha = 2 / (erSmoothPeriod + 1)
|
|
893
|
-
```
|
|
894
|
-
|
|
895
|
-
This ER smoothing is not part of canonical Kaufman AMA/KAMA. It is an optional
|
|
896
|
-
DEXBot2 stabilizer for fast AMAs: it can reduce false or jerky re-centering
|
|
897
|
-
caused by one-window ER spikes, at the cost of slower recognition when the
|
|
898
|
-
market genuinely changes regime. `erSmoothPeriod = 0` disables it; `1` is
|
|
899
|
-
effectively no extra smoothing; `3` to `5` are typical light/moderate values.
|
|
900
|
-
|
|
901
885
|
Because `ER_i` varies bar-by-bar, a **typical-market ER** (`ER_avg`) is used to
|
|
902
886
|
estimate an average decay rate:
|
|
903
887
|
|
|
@@ -915,14 +899,13 @@ The adapter keeps the **full warmup window** in candle history so the AMA seed
|
|
|
915
899
|
and convergence bias are retained for downstream calculations:
|
|
916
900
|
|
|
917
901
|
```
|
|
918
|
-
amaWarmupBars = erPeriod + convergenceBars +
|
|
902
|
+
amaWarmupBars = erPeriod + convergenceBars + lookbackBars
|
|
919
903
|
```
|
|
920
904
|
|
|
921
905
|
| Component | Role |
|
|
922
906
|
|-----------|------|
|
|
923
907
|
| `erPeriod` | Bars for the first Efficiency Ratio value to become available |
|
|
924
908
|
| `convergenceBars` | Bars to decay 99 % of the cold-start initialisation bias |
|
|
925
|
-
| `erSmoothConvergenceBars` | Extra ER EMA convergence bars when `erSmoothPeriod >= 1`; `0` when ER smoothing is disabled |
|
|
926
909
|
| `lookbackBars` | Extra lookback for slope/trend analysis (AMA slope, ATR) |
|
|
927
910
|
|
|
928
911
|
For **AMA slope readiness and percentile clipping**, the earlier gate is:
|
package/modules/README.md
CHANGED
|
@@ -113,6 +113,7 @@ modules/
|
|
|
113
113
|
│ └── withPoolRef.ts startPrice mode + poolRef resolution
|
|
114
114
|
│
|
|
115
115
|
├── launcher/ process lifecycle (PM2, unlock, isolated)
|
|
116
|
+
│ ├── adapter_requirement.ts canonical market-adapter requirement (single source of truth)
|
|
116
117
|
│ ├── bot_supervisor.ts per-bot process supervision
|
|
117
118
|
│ ├── child_env.ts child process environment
|
|
118
119
|
│ ├── credential_bootstrap.ts daemon startup
|
|
@@ -141,12 +142,14 @@ modules/
|
|
|
141
142
|
│ └── crypto/ cryptographic primitives
|
|
142
143
|
│
|
|
143
144
|
└── utils/
|
|
145
|
+
├── asset_symbols.ts asset symbol/object-id canonicalization helpers
|
|
144
146
|
├── base58check.ts Base58Check encoding
|
|
145
147
|
├── build_dir.ts BUILD_DIR constant helper
|
|
146
148
|
├── chain_logs.ts shared chain log helpers
|
|
147
149
|
├── errors.ts getErrorMessage helper
|
|
148
150
|
├── sanitize_key.ts shared sanitizeKey helper
|
|
149
|
-
|
|
151
|
+
├── text_width.ts display-width-aware text measurement (CJK/emoji tables)
|
|
152
|
+
└── time_range.ts month→hour lookback conversion (analysis range flags)
|
|
150
153
|
```
|
|
151
154
|
|
|
152
155
|
## Key Relationships
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "dexbot",
|
|
3
|
-
"version": "1.6.
|
|
3
|
+
"version": "1.6.12",
|
|
4
4
|
"description": "The first open source trading bot with zero runtime dependencies and a fully adaptive market making strategy.",
|
|
5
5
|
"main": "dist/modules/dexbot_class.js",
|
|
6
6
|
"exports": {
|
|
@@ -116,6 +116,9 @@
|
|
|
116
116
|
"build:clean": "npm run clean && npm run build",
|
|
117
117
|
"build:tests": "tsc -p tsconfig.tests.json && cp tests/package.json dist/tests/package.json && cp tests/helpers/esm_mock_hooks.mjs tests/helpers/esm_mock_loader.mjs dist/tests/helpers/ && mkdir -p dist/analysis/legacy/tests && cp analysis/legacy/tests/package.json dist/analysis/legacy/tests/package.json",
|
|
118
118
|
"typecheck": "tsc --noEmit",
|
|
119
|
+
"check:any": "npm run build && node dist/scripts/check_any.js",
|
|
120
|
+
"check:any:update": "npm run build && node dist/scripts/check_any.js --update",
|
|
121
|
+
"check:any:list": "npm run build && node dist/scripts/check_any.js --list",
|
|
119
122
|
"typecheck:tests": "tsc -p tsconfig.tests.json --noEmit",
|
|
120
123
|
"build:watch": "tsc --watch",
|
|
121
124
|
"version": "npm run version:sync && npm run build:clean",
|
package/scripts/README.md
CHANGED
|
@@ -417,6 +417,20 @@ dexbot dw BTS/HONEST.USD --feed --month 1
|
|
|
417
417
|
```
|
|
418
418
|
Research knobs (`--alpha`, `--gain`, `--dw`, `--lb`, `--clip`) stay on the analyzer itself — call `node dist/analysis/analyze_dynamic_weight.js` directly for parameter sweeps (see `analysis/README.md`).
|
|
419
419
|
|
|
420
|
+
### PnL Report (`dexbot pnl`)
|
|
421
|
+
**File:** `pnl.ts` (thin entry; analyzer + HTML renderer: `analysis/trade_profitability.ts` + `analysis/pnl_report.ts`)
|
|
422
|
+
**Purpose:** Resolve a bot profile (local-first), account name, or `1.2.x` id, fetch the account's fills for the requested window, and write a self-contained HTML PnL report (summary cards, performance metrics, realized-lot table). Terminal tables stay available by running the analyzer directly.
|
|
423
|
+
**Output:** `analysis/charts/pnl_<bot|account>[_<pair>]_<range>.html`
|
|
424
|
+
**Cache:** per-account fill shards under `analysis/cache/fills/` (settled months are reused; the unsettled tail is re-queried). `--refresh-account` bypasses it.
|
|
425
|
+
```bash
|
|
426
|
+
# HTML PnL report for a local bot, last 3 months
|
|
427
|
+
dexbot pnl <bot> --month 3
|
|
428
|
+
# Filter a multi-pair account to one pair
|
|
429
|
+
dexbot pnl 1.2.123456 --month 6 --pair TOKENA/BTS
|
|
430
|
+
# Custom output path
|
|
431
|
+
dexbot pnl <bot> --month 1 --report analysis/charts/custom-pnl.html
|
|
432
|
+
```
|
|
433
|
+
|
|
420
434
|
### LP Chart
|
|
421
435
|
**File:** `generate_lp_chart.ts`
|
|
422
436
|
**Purpose:** Generate the standard uPlot LP chart output.
|