# DEX Full-Cycle Import Manifest

Date: 2026-05-03

Source environment:

```text
../DEX_full_cycle/
```

Local optimized tuner:

```text
dex_platform/backtest/cl_fee_replay_fast_npz_v3.py
dex_platform/backtest/cl_replay_fast_core.c
```

The same optimized tuner was also installed into:

```text
../DEX_full_cycle/dex_platform/backtest/cl_fee_replay_fast_npz_v3.py
../DEX_full_cycle/dex_platform/backtest/cl_replay_fast_core.c
../DEX_full_cycle/docs/OPTIMIZED_FAST_NPZ_TUNER_V3.md
```

## Imported Fast NPZ Data

```text
DEX_DATA/fast_npz/base_CHECK_USDC_2PCT_2026_02_05_fee_replay_v2.npz
DEX_DATA/fast_npz/base_CHECK_USDC_2PCT_2026_02_05_scaled_may26.npz
DEX_DATA/fast_npz/bio_usdc_apr2026.npz
DEX_DATA/fast_npz/bio_usdc_apr15_may2_partial.npz
DEX_DATA/fast_npz/bio_usdc_apr17_full.npz
DEX_DATA/fast_npz/bio_usdc_apr17_may2_full.npz
DEX_DATA/fast_npz/weth_usdc_030_2026_02_05_v1.npz
```

Each file's matching `.meta.json` was imported with it.

## Imported Full-Cycle Source Data

```text
DEX_DATA/full_cycle_import/aerodrome_slipstream/base_BIO_USDC_apr15_may2/events.raw.jsonl
DEX_DATA/full_cycle_import/aerodrome_slipstream/base_BIO_USDC_apr15_may2/pool_metadata.json
DEX_DATA/full_cycle_import/aerodrome_slipstream/base_BIO_USDC_apr17_may3/events.raw.jsonl
DEX_DATA/full_cycle_import/aerodrome_slipstream/base_BIO_USDC_apr17_may3/pool_metadata.json
DEX_DATA/full_cycle_import/l2_ohlcv/base_BIO_USDC_AERODROME_03_2026-02-01T00-00-00_2026-05-01T00-00-00.csv
DEX_DATA/full_cycle_import/l2_ohlcv/base_BIO_WETH_AERODROME_005_2026-02-01T00-00-00_2026-05-01T00-00-00.csv
```

The BIO raw event files are not fast NPZ-ready by themselves because they do not contain decoded timestamps. Rebuild them through the imported collector path before using them for tick-level live recommendations.

## Imported Collector/Builder Scripts

```text
dex_platform/data_collectors/full_cycle_import/build_cl_fee_replay_npz_v2.py
dex_platform/data_collectors/full_cycle_import/fetch_aerodrome_slipstream_events_v2.py
dex_platform/scripts/full_cycle_import_collectors/build_check_2pct_fee_npz_v2.sh
```

## Imported Configs, Scripts, And Reports

```text
dex_platform/configs/full_cycle_import/
dex_platform/scripts/full_cycle_import/
docs/full_cycle_import/
DEX_REPORTS/full_cycle_import/reports/
```

Large raw report artifacts were intentionally not copied; only compact CSV/JSON/Markdown reports were imported.

## Starting Commands

CHECK scaled May26 capacity sanity:

```bash
python3 dex_platform/backtest/cl_fee_replay_fast_npz_v3.py \
  --jobs 8 \
  --fast-core \
  --npz DEX_DATA/fast_npz/base_CHECK_USDC_2PCT_2026_02_05_scaled_may26.npz \
  --out-dir DEX_REPORTS/check_scaled_may26_capacity_optimized_local \
  --fee-rates metadata_0_2515:0.002515 \
  --walkforward \
  --capital-mode grid \
  --capital-grid 10,15,20,25,35,50,75,100 \
  --grid-lower 40,50,60,65,70,75,80,85,90 \
  --grid-upper 0.001,0.01,0.1,0.2,0.5,1,2,5 \
  --rebalance-grid periodic:168,periodic:312,periodic:336,periodic:504,periodic:672 \
  --target-mdd-pct 25 \
  --max-avg-liquidity-share-pct 3 \
  --max-p95-liquidity-share-pct 5 \
  --max-p99-liquidity-share-pct 10 \
  --max-liquidity-share-pct 25
```

Download monthly event data for table pools that only had one-day/smoke tests:

```bash
BASE_RPC_URL=https://mainnet.base.org \
bash dex_platform/scripts/download_monthly_table_pools_v1.sh
```

Useful variants:

```bash
# Show commands without downloading.
DRY_RUN=1 bash dex_platform/scripts/download_monthly_table_pools_v1.sh

# Download only BIO/USDC first.
POOL_FILTER=bio_usdc_03 bash dex_platform/scripts/download_monthly_table_pools_v1.sh

# Include already broader-tested table pools too.
MODE=all bash dex_platform/scripts/download_monthly_table_pools_v1.sh
```

Tune newly imported full-cycle NPZ downloads:

```bash
DRY_RUN=1 bash dex_platform/scripts/tune_new_downloaded_npz_v1.sh
```

```bash
POOL_FILTER=bio_usdc_may_full,check_usdc_025_new_apr \
bash dex_platform/scripts/tune_new_downloaded_npz_v1.sh
```

New-download connection status:

```text
DEX_REPORTS/full_cycle_import/new_downloads/CONNECTED_NEW_DOWNLOADS.md
DEX_REPORTS/full_cycle_import/new_downloads/fast_npz_index.csv
```

BIO/USDC validation:

```bash
python3 dex_platform/backtest/cl_fee_replay_fast_npz_v3.py \
  --jobs 8 \
  --fast-core \
  --npz DEX_DATA/fast_npz/bio_usdc_apr17_full.npz \
  --out-dir DEX_REPORTS/bio_usdc_apr17_optimized_local \
  --fee-rates aerodrome_0_3pct:0.003 \
  --time-from 2026-04-17T00:00:00Z \
  --time-to 2026-04-18T00:00:00Z \
  --capital-mode grid \
  --capital-grid 100,200,300,600,1000,1500,2000 \
  --grid-lower 20,30,40,50,60,70,80 \
  --grid-upper 0.5,1,2,5,10,20,30,40,50 \
  --rebalance-grid none:0,periodic:168,periodic:336,periodic:504 \
  --target-mdd-pct 20 \
  --max-avg-liquidity-share-pct 3 \
  --max-p95-liquidity-share-pct 5 \
  --max-p99-liquidity-share-pct 10 \
  --max-liquidity-share-pct 25
```