LVR Shielded LP

LVR Shielded LP is a Uniswap v4 Hook + Vault that reacts to market conditions and protects LPs against loss-versus-rebalancing (LVR). The Hook maintains a simple, explainable mode machine:

NORMAL – concentrate around the current price

WIDENED – spread liquidity when volatility rises

RISK_OFF – pull to a wide, defensive placement during shocks

Guards enforce freshness, hysteresis (lower exit than entry), a dwell window with confirmations, and a min flip interval to avoid thrash. Placement snaps to tick spacing and records “home” placements for quick recentering.

The demo is fully judge-reproducible on Unichain Sepolia with Windows-friendly scripts and a local subgraph that indexes on-chain telemetry (ModeApplied, Signal). You can trigger mode flips, then verify both on-chain logs and GraphQL results in minutes.

Live demo refs (Unichain Sepolia):

Vault: 0x84a4871295867f587B15EAFF82e80eA2EbA79a6C

Hook: 0x20c519Cca0360468C0eCd7A74bEc12b9895C44c0

PoolId (USDC/WETH demo): 0x…457f

Quickstart: repo README

Solidity 0.8.26 with Foundry (forge/cast).

Uniswap v4 BaseHook pattern with address-encoded permission bits; explicit overrides for v4 hook points; tick math via official libs; immutable caching for gas.

Mode machine + guards: freshness/stale, hysteresis, dwell+confirmations, minFlipInterval; placement engine computes centerTick/halfWidthTicks and snaps to tickSpacing.

Events for end-to-end observability: Signal, ModeChanged (optional), HomeRecorded, and Vault-level ModeApplied.

E2E scripts (Git Bash safe) use cast with ≤500-block chunking (Alchemy limit), pending nonce + small gas bump to avoid “already known/nonce too low”.

Local subgraph (Docker Compose): indexes Hook & Vault events; one-click build/deploy; GraphQL queries included in the README.

Built to be extensible: parameters (widenBps, riskOffBps, exitThresholdBps, dwellSec, confirmations, minFlipInterval, etc.) are admin-tunable with tests for revert-on-non-admin.