MEV Shield v1.0.0

First tagged release of MEV Shield, the pre-trade MEV planner built during ETHGlobal HackMoney 2026.

Highlights

• Integer sandwich simulation on live Uniswap V2 reserves, including whether the attack clears its gas
• Route search that prices a public swap, a Flashbots private relay and every mix of private share and public chunks, then returns the cheapest plan
• Private relay cost model derived from the arbitrage a trade leaves behind in a constant product pool
• ENS text records for per user limits, read by the agent and editable from the dashboard
• Runs on Cloudflare Workers, with a Worker entry for the API and a static assets Worker for the dashboard

This release also

• fixes the agent typecheck and the dashboard install so both build from a clean clone
• makes the route search honor the maxChunks limit from ENS
• adds CI, an MIT license, a changelog and example env files
• moves the WalletConnect project ID and API URL into environment variables
• rewrites the README to match the code, with a reproducible sample request and known limitations

MEV Shield is a planner, not an executor. Nothing is signed or sent. See the README for limitations and the changelog for the full list.