diff --git a/doc/GEMINI.md b/doc/GEMINI.md new file mode 100644 index 0000000..e06bcc0 --- /dev/null +++ b/doc/GEMINI.md @@ -0,0 +1,45 @@ +# 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.