# GEMINI Project Context & Setup

**Last Updated:** 2025-12-19
**Project:** Uniswap V3 Automated Concentrated Liquidity Pool (CLP) Hedger

## 1. Project Overview
This project automates the management and hedging of Uniswap V3 Concentrated Liquidity Positions (CLP). It consists of two main components:
*   **`uniswap_manager.py`**: Monitors the market, mints/burns Uniswap V3 positions based on range and profitability, and handles rebalancing.
*   **`clp_hedger.py`**: A delta-neutral hedging bot that executes trades on Hyperliquid to offset the delta exposure of the Uniswap position.

## 2. Current Configuration (Weekend / Low Volatility)
**Date Set:** 2025-12-19

### A. Uniswap Manager Settings
*   **Capital Target:** `$2,000` (USDC equivalent)
*   **Range Width:** `+/- 1%` (0.01) relative to entry price.
*   **Slippage Tolerance:** `2%` (0.02)

### B. Hedger Settings (Hyperliquid)
*   **Minimum Trade Threshold:** `0.008 ETH` (~$24 USD)
    *   *Reasoning:* Tighter threshold for precise hedging in a narrow 1% range.
*   **Dynamic Threshold Multiplier:** `1.2x`
    *   *Reasoning:* Reduced volatility buffer for stable weekend conditions.
*   **Price Buffer:** `0.15%`

### C. Safety Mechanisms
1.  **Dynamic Edge Proximity:**
    *   **Logic:** Calculates a dynamic safety buffer based on position size to prevent slippage on large hedges near range edges.
    *   **Formula:** `Base 4% + (0.000004 * Position Value USD)`
    *   **Limits:** Min 4%, Max 15%.
    *   **Current Effect:** For a $2,000 position, the edge buffer is approx **4.8%**.
2.  **Large Hedge Override:**
    *   **Logic:** Bypasses trade cooldowns if the required hedge size exceeds `2.8x` the rebalance threshold.
3.  **Cooldowns:**
    *   `MIN_TIME_BETWEEN_TRADES`: 25 seconds (bypassed for critical/urgent hedges).

## 3. Recent Changes & Status
*   **Refactoring:** Removed `clp_scalper_hedger.py` after merging its advanced features into `clp_hedger.py`.
*   **Logging:** Fixed duplicate terminal output by disabling logger propagation.
*   **Feature:** Implemented "Comprehensive Edge Protection" in `clp_hedger.py` (Dynamic Proximity + Large Hedge Override).

## 4. Key Files
*   `uniswap_manager.py`: Core logic for Uniswap V3 interaction.
*   `clp_hedger.py`: Core logic for Hyperliquid hedging.
*   `doc/CHANGELOG.md`: Detailed history of changes.