dexbot 1.6.14 → 1.6.15
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 +34 -4
- package/analysis/README.md +6 -6
- package/analysis/tradingview/README.md +2 -1
- package/claw/README.md +7 -7
- 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/tradingview/tradingview_uplot_chart_generator.js +80 -6
- package/dist/analysis/trend_detection/dynamic_weight_chart_generator.js +36 -2
- package/dist/dexbot.js +23 -3
- package/dist/market_adapter/core/strategies/dynamic_weight_series.js +26 -11
- package/dist/modules/account_bots.d.ts +3 -0
- package/dist/modules/account_bots.js +3 -0
- package/dist/modules/bitshares-native/subscriptions.js +1 -1
- package/dist/modules/bot_defaults.d.ts +13 -2
- package/dist/modules/bot_defaults.js +31 -2
- package/dist/modules/bot_settings.js +3 -0
- package/dist/modules/constants.d.ts +6 -0
- package/dist/modules/constants.js +24 -0
- package/dist/modules/credit_runtime.d.ts +35 -5
- package/dist/modules/credit_runtime.js +219 -38
- package/dist/modules/dexbot_class.d.ts +19 -1
- package/dist/modules/dexbot_class.js +58 -20
- package/dist/modules/dexbot_cow_runtime.js +19 -18
- package/dist/modules/dexbot_fill_runtime.d.ts +1 -1
- package/dist/modules/dexbot_fill_runtime.js +4 -7
- package/dist/modules/dexbot_maintenance_runtime.d.ts +7 -2
- package/dist/modules/dexbot_maintenance_runtime.js +52 -7
- package/dist/modules/dexbot_startup_runtime.js +3 -2
- package/dist/modules/dexbot_state_recovery.js +1 -1
- package/dist/modules/order/export.js +2 -2
- package/dist/modules/order/grid.d.ts +118 -1
- package/dist/modules/order/grid.js +292 -50
- package/dist/modules/order/grid_reconcile.js +4 -3
- package/dist/modules/order/grid_reconcile_internal.js +13 -18
- package/dist/modules/order/index.d.ts +3 -1
- package/dist/modules/order/manager.d.ts +1 -0
- package/dist/modules/order/manager.js +5 -14
- package/dist/modules/order/sync_engine.js +18 -9
- package/dist/modules/order/utils/math.d.ts +98 -26
- package/dist/modules/order/utils/math.js +177 -57
- package/dist/modules/order/utils/order.js +16 -4
- package/dist/modules/order/utils/system.js +2 -2
- package/dist/modules/order/utils/validate.d.ts +1 -1
- package/dist/modules/order/utils/validate.js +48 -58
- package/dist/modules/types.d.ts +7 -0
- package/dist/scripts/analyze-credit.js +44 -27
- package/dist/scripts/diagnose-pool-history.js +35 -30
- package/dist/scripts/pnl.js +1 -1
- package/dist/scripts/rich_list.d.ts +18 -0
- package/dist/scripts/rich_list.js +461 -0
- package/dist/scripts/run-tests.js +80 -4
- package/dist/unlock.d.ts +2 -1
- package/dist/unlock.js +4 -3
- package/docs/COW_INVARIANTS.md +6 -0
- package/docs/DEXBOT_COMPARISON.md +6 -6
- package/docs/EVOLUTION.md +10 -9
- package/docs/FUND_MOVEMENT_AND_ACCOUNTING.md +1 -1
- package/docs/LOGGING.md +16 -1
- package/docs/MPA_CREDIT_USAGE.md +10 -5
- package/docs/ORDER_ENGINE_POST_1.0_RETROSPECTIVE.md +159 -9
- package/docs/README.md +1 -1
- package/docs/WORKFLOW.md +1 -0
- package/docs/architecture.md +56 -2
- package/docs/developer_guide.md +5 -1
- package/market_adapter/README.md +4 -4
- package/modules/README.md +1 -1
- package/package.json +2 -1
- package/scripts/README.md +59 -32
- package/tests/README.md +11 -2
package/scripts/README.md
CHANGED
|
@@ -111,27 +111,9 @@ bash scripts/reset-settings.sh
|
|
|
111
111
|
|
|
112
112
|
## 📊 DIAGNOSTICS & VALIDATION
|
|
113
113
|
|
|
114
|
-
###
|
|
115
|
-
**File:** `
|
|
116
|
-
**Purpose:**
|
|
117
|
-
```bash
|
|
118
|
-
# Validate the live bot configuration
|
|
119
|
-
node dist/scripts/validate_bots.js
|
|
120
|
-
```
|
|
121
|
-
|
|
122
|
-
### Grid Divergence Audit
|
|
123
|
-
**File:** `divergence-calc.ts`
|
|
124
|
-
**Purpose:** Measure the "drift" between in-memory grid and disk state using RMS divergence metric.
|
|
125
|
-
```bash
|
|
126
|
-
# Calculates RMS Error (hardcoded threshold: 1 promille ≈ 3.2% avg error)
|
|
127
|
-
# RMS quadratically penalizes large errors - see docs/GRID_RECALCULATION.md
|
|
128
|
-
node dist/scripts/divergence-calc.js
|
|
129
|
-
```
|
|
130
|
-
**Reference:** RMS threshold interpretation in [Grid Recalculation docs](../docs/GRID_RECALCULATION.md)
|
|
131
|
-
|
|
132
|
-
### Grid Trading Analysis
|
|
133
|
-
**File:** `analyze-orders.ts`
|
|
134
|
-
**Purpose:** Analyze grid trading metrics and order distribution patterns.
|
|
114
|
+
### Grid Order Analysis
|
|
115
|
+
**File:** `analyze-orders.ts` (CLI: `dexbot order`)
|
|
116
|
+
**Purpose:** Analyze grid order metrics and order distribution patterns.
|
|
135
117
|
```bash
|
|
136
118
|
# Analyzes spread accuracy, geometric consistency, and fund distribution
|
|
137
119
|
node dist/scripts/analyze-orders.js
|
|
@@ -155,24 +137,49 @@ node dist/scripts/analyze-credit.js <bot>
|
|
|
155
137
|
```
|
|
156
138
|
Credit deals report per-pair and average CR, but only for pairs whitelisted in `bots.json` (`debtPolicy.lending`) and listed on the current credit offer; everything else is shown as ignored/unpriced and excluded from the average. A borrow-now preview per configured pair shows today's rate.
|
|
157
139
|
|
|
158
|
-
###
|
|
159
|
-
**File:** `
|
|
160
|
-
**Purpose:**
|
|
140
|
+
### Asset Rich List / Top Holder
|
|
141
|
+
**File:** `rich_list.ts` (CLI: `dexbot rich`, npm: `npm run richlist`)
|
|
142
|
+
**Purpose:** Report the top holder(s) per asset using the chain's `asset_api`
|
|
143
|
+
(`get_asset_holders`). Holders come back balance-descending, so this is a live
|
|
144
|
+
rich list. Nodes must expose `asset_api` to anonymous logins; the script tries
|
|
145
|
+
`dex.iobanker.com` / `api.dex.trading` first and falls back through
|
|
146
|
+
`DEFAULT_NODES`.
|
|
161
147
|
```bash
|
|
162
|
-
#
|
|
163
|
-
|
|
148
|
+
# Rich list for one asset (default: node holder limit, usually 100)
|
|
149
|
+
dexbot rich <asset>
|
|
164
150
|
|
|
165
|
-
#
|
|
166
|
-
|
|
151
|
+
# Top 10 for several assets
|
|
152
|
+
dexbot rich <asset-a> <asset-b> <asset-c> --top 10
|
|
153
|
+
|
|
154
|
+
# Machine-readable
|
|
155
|
+
dexbot rich <asset-a> <asset-b> --json > rich.json
|
|
167
156
|
```
|
|
157
|
+
Balances reflect only liquid account balances, so they do not sum to total supply.
|
|
158
|
+
`--top` is clamped to the node's reported `api_limit_get_asset_holders` (shown
|
|
159
|
+
as a note when clamped). Legacy `bit*` MPA names were renamed on-chain without
|
|
160
|
+
the `bit` prefix; the script retries an unresolved `bit*` name stripped and notes
|
|
161
|
+
the rename. Note:
|
|
162
|
+
`get_asset_holders_count` is reported by the node as `distance(range) - 1`, so
|
|
163
|
+
the `holders=` figure can be off by one.
|
|
168
164
|
|
|
169
|
-
###
|
|
170
|
-
**File:** `
|
|
171
|
-
**Purpose:**
|
|
165
|
+
### Configuration Audit
|
|
166
|
+
**File:** `validate_bots.ts`
|
|
167
|
+
**Purpose:** Check `bots.json` for schema errors or missing required fields.
|
|
172
168
|
```bash
|
|
173
|
-
|
|
169
|
+
# Validate the live bot configuration
|
|
170
|
+
node dist/scripts/validate_bots.js
|
|
174
171
|
```
|
|
175
172
|
|
|
173
|
+
### Grid Divergence Audit
|
|
174
|
+
**File:** `divergence-calc.ts`
|
|
175
|
+
**Purpose:** Measure the "drift" between in-memory grid and disk state using RMS divergence metric.
|
|
176
|
+
```bash
|
|
177
|
+
# Calculates RMS Error (hardcoded threshold: 1 promille ≈ 3.2% avg error)
|
|
178
|
+
# RMS quadratically penalizes large errors - see docs/GRID_RECALCULATION.md
|
|
179
|
+
node dist/scripts/divergence-calc.js
|
|
180
|
+
```
|
|
181
|
+
**Reference:** RMS threshold interpretation in [Grid Recalculation docs](../docs/GRID_RECALCULATION.md)
|
|
182
|
+
|
|
176
183
|
### Grid Calculation Runner
|
|
177
184
|
**File:** `runner.ts`
|
|
178
185
|
**Purpose:** Standalone order grid calculation debugger — loads a bot config, initializes the grid, and simulates sync cycles.
|
|
@@ -186,6 +193,25 @@ LIVE_BOT_NAME=my-bot CALC_CYCLES=10 CALC_DELAY_MS=1000 node dist/scripts/runner.
|
|
|
186
193
|
Useful for verifying config produces the expected grid, testing price derivation, and debugging fund allocation.
|
|
187
194
|
Requires a live BitShares connection (asset metadata lookups and price derivation are on-chain).
|
|
188
195
|
|
|
196
|
+
### Print Grid Sample
|
|
197
|
+
**File:** `print_grid.ts`
|
|
198
|
+
**Purpose:** Demonstrate the grid structure — shows consecutive price levels with percentage differences between adjacent slots.
|
|
199
|
+
```bash
|
|
200
|
+
node dist/scripts/print_grid.js
|
|
201
|
+
```
|
|
202
|
+
|
|
203
|
+
### Pool History Diagnostics
|
|
204
|
+
**File:** `diagnose-pool-history.ts`
|
|
205
|
+
**Purpose:** Inspect raw BitShares pool history API responses.
|
|
206
|
+
```bash
|
|
207
|
+
# Inspect pool history (default pool 1.19.133)
|
|
208
|
+
node dist/scripts/diagnose-pool-history.js
|
|
209
|
+
|
|
210
|
+
# Custom pool, limit, and time range
|
|
211
|
+
node dist/scripts/diagnose-pool-history.js --pool 1.19.133 --limit 100 --hours 48 --maxPages 5
|
|
212
|
+
```
|
|
213
|
+
`--pool` must be a concrete numeric liquidity-pool object ID (`1.19.N`). Placeholders such as `1.19.x` are rejected up front, because the node parses the instance part as a `uint64` and otherwise fails with `Parse Error: Couldn't parse uint64_t`.
|
|
214
|
+
|
|
189
215
|
### Native Release Gates
|
|
190
216
|
**File:** `native_release_gates.ts` (+ `generate_mainnet_corpus_report.ts`)
|
|
191
217
|
**Purpose:** Prove the native serialization layer matches the chain byte-for-byte before release.
|
|
@@ -374,6 +400,7 @@ The following scripts allow you to call `dexbot` commands directly from the `scr
|
|
|
374
400
|
| `npm run analysis:trade-pnl` | Trade PnL analysis from fill data |
|
|
375
401
|
| `npm run analysis:grid-check` | Last-fill-guard check (`grid_correction_check.ts`) |
|
|
376
402
|
| `npm run analysis:resolve-accounts` | Batch-resolve on-chain bot accounts (`resolve_bot_accounts.ts`) |
|
|
403
|
+
| `npm run richlist` | Per-asset rich list / top holder (`rich_list.ts`) |
|
|
377
404
|
| `npm run ama:chart:lp-local` | Generate local LP comparison chart |
|
|
378
405
|
| `npm run lp:chart` | Generate uPlot LP chart |
|
|
379
406
|
| `npm run test:credit-renewal` | Test credit offer renewal for a specific bot |
|
package/tests/README.md
CHANGED
|
@@ -46,7 +46,7 @@ claw/tests/ # Claw integration tests (same conventions, run by npm test)
|
|
|
46
46
|
`scripts/run-tests.ts` runs each compiled `test_*.js` file as its own `node` process (no shared state between tests). Knobs:
|
|
47
47
|
|
|
48
48
|
- `RUN_LIVE_BITSHARES_TESTS=1` — also run the live-chain tests; without it they are skipped and counted as `skippedLive`. The live set is the `liveTestFiles` allow-list in `scripts/run-tests.ts`.
|
|
49
|
-
- `DEXBOT_TEST_CONCURRENCY=N` — run N files in parallel (default `
|
|
49
|
+
- `DEXBOT_TEST_CONCURRENCY=N` — run N files in parallel (default `min(cores, 4)`; files are isolated with per-PID `tests/tmp` scratch space, so bounded parallelism is safe). Set `DEXBOT_TEST_CONCURRENCY=1` to force the old sequential order, which is useful when debugging an interleaved log.
|
|
50
50
|
- `DEXBOT_TEST_TIMEOUT_MS=N` — per-file watchdog (default `240000`); on expiry the child is `SIGTERM`/`SIGKILL`ed and marked `TIMEOUT`.
|
|
51
51
|
- `DEXBOT_SUPPRESS_WARNINGS=1` — add `--no-warnings` to children (hides the warnings the diagnostics summary is meant to surface).
|
|
52
52
|
|
|
@@ -110,7 +110,7 @@ Interactive tools and performance benchmarks (not part of CI).
|
|
|
110
110
|
|
|
111
111
|
### Edge Cases & Regression
|
|
112
112
|
Tests targeting specific bugs, race conditions, and failure modes.
|
|
113
|
-
*Examples:* `test_critical_bug_fixes.ts`, `test_race_condition_fixes_batch1.ts`, `test_patch17_invariants.ts`, `test_shutdown_reentrancy.ts`, `test_multifill_opposite_partial.ts`, `test_correction_queue_staleness.ts`, `test_spread_pure_fund_driven.ts`, `test_sync_lock_id_verification.ts`
|
|
113
|
+
*Examples:* `test_critical_bug_fixes.ts`, `test_race_condition_fixes_batch1.ts`, `test_patch17_invariants.ts`, `test_shutdown_reentrancy.ts`, `test_multifill_opposite_partial.ts`, `test_correction_queue_staleness.ts`, `test_spread_pure_fund_driven.ts`, `test_spread_correction_resilience.ts`, `test_sync_lock_id_verification.ts`
|
|
114
114
|
|
|
115
115
|
### Utilities & Helpers
|
|
116
116
|
Shared utility functions, precision handling, chain helpers.
|
|
@@ -129,6 +129,15 @@ Shared utility functions, precision handling, chain helpers.
|
|
|
129
129
|
|
|
130
130
|
**Reference:** [docs/COPY_ON_WRITE_MASTER_PLAN.md](../docs/COPY_ON_WRITE_MASTER_PLAN.md)
|
|
131
131
|
|
|
132
|
+
### Spread-Correction Resilience
|
|
133
|
+
- Refusal-cause classification and the transient/non-transient split are centralized (`SPREAD_CORRECTION_REFUSAL`)
|
|
134
|
+
- Plan-time CREATE dedupe withholds a plan whose destination was taken after planning
|
|
135
|
+
- The bounded fresh-master re-plan lands a transiently-refused correction on the retry
|
|
136
|
+
- The broadcast region is held across the plan/retry loop and released exactly once (including on throw)
|
|
137
|
+
- The out-of-spread watchdog tolerates transient refusals only up to its grace budget
|
|
138
|
+
|
|
139
|
+
**Reference:** [docs/architecture.md](../docs/architecture.md) (Spread Correction → Resilience)
|
|
140
|
+
|
|
132
141
|
### RMS Divergence Checking
|
|
133
142
|
- Quadratic penalty for large errors
|
|
134
143
|
- Concentrated errors raise RMS threshold
|