harb/onchain/analysis/README.md

# KRAIKEN Liquidity Analysis

Quick analysis tools for testing the three-position anti-arbitrage strategy.

## Usage

1. **Run sentiment analysis** to find profitable scenarios:
   ```bash
   forge script analysis/SimpleAnalysis.s.sol:SimpleAnalysis -s "runSentimentFuzzingAnalysis()" --ffi --via-ir
   ```

2. **Start visualization server**:
   ```bash
   ./view-scenarios.sh
   ```

3. **View results** at `http://localhost:8001/scenario-visualizer.html`

## Files

- `SimpleAnalysis.s.sol` - Main analysis script with sentiment fuzzing
- `scenario-visualizer.html` - Web-based position visualization
- `view-scenarios.sh` - HTTP server launcher
- `profitable_scenario.csv` - Generated results (if profitable scenarios found)

## Analysis Output

The sentiment analysis tests bull/neutral/bear market conditions and generates CSV data for any profitable trading scenarios found. The visualizer shows position ranges, token distributions, and Uniswap V3 liquidity calculations.