Skip to content
HybridthegamerPublic

About

LVR-recapture Uniswap v4 launch hook — a Programmable Custom Hook Hookathon submission

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Undertow

ci license: MIT

An LVR-recapture launch hook for Uniswap v4 — a submission to the Programmable Custom Hook Hookathon.

Built through the mandatory Programmable v4 Builder skill (gh skill install 0xprogrammable/programmable programmable-v4-hook-builder) — see submissions/undertow/SKILL_FLOW.md. Every test claim below is reproducible via CI (the badge above) and committed, hashed evidence artifacts.

Undertow's canonical pool recaptures loss-versus-rebalancing (LVR) for its own liquidity providers — oracle-free and keeper-free — while enforcing the mandatory Programmable 10 bps volume fee non-bypassably on the same pool.

The longer a pool sits untraded, the further the fair price drifts, and the larger the next arbitrage that realigns it (Milionis, Moallemi, Roughgarden & Zhang, arXiv:2208.06046 — the arbitrageur's profit is the LPs' LVR). Undertow prices that staleness into a dynamic LP fee that spikes on the realigning swap and is routed to in-range LPs by the v4 core's own fee-growth accounting. Staleness (elapsed blocks) is a manipulation-resistant, purely on-chain LVR proxy — no external price, no keeper.

Build & test

./script/bootstrap.sh          # restore pinned dependencies (exact SHAs)
forge test                     # 19 tests
MAINNET_RPC_URL=<rpc> forge test   # includes the mainnet-fork rehearsal

Foundry (forge 1.7.1), Solidity 0.8.26, EVM Cancun, optimizer 1000 runs, via_ir = false, no CBOR metadata — the Programmable-tested baseline.

Status

Builder proposal + prototype for maintainer review. Not accepted, audited, routed, deployed, or available.

License

MIT.

About

LVR-recapture Uniswap v4 launch hook — a Programmable Custom Hook Hookathon submission

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages