-
Notifications
You must be signed in to change notification settings - Fork 0
Docs
Welcome to the official documentation for ARMSys — an innovative Uniswap v4 hook designed for maximum protection of liquidity providers (LPs) and the maximization of their yields.
This page explains in simple terms how we combat liquidity leakage, how our mathematics work, and why ARMSys is the future of decentralized finance.
LVR is a hidden "tax" on liquidity providers in classic AMM pools.
Because smart contracts update prices slower than centralized exchanges (e.g., Binance), a price discrepancy frequently occurs. Arbitrageurs instantly notice this: they buy assets in the pool cheaper than the real market and immediately sell them higher on another exchange. This difference (the arbitrageur's profit) is extracted directly from the pockets of regular liquidity providers.
MEV (Maximal Extractable Value) bots are automated predatory algorithms. They continuously scan the mempool (the queue of pending transactions).
Seeing your large trade, a bot can insert its transaction right before yours, shifting the price against you, and then immediately sell the asset back (a sandwich attack). Such "toxic flow" manipulates prices within a single block and systematically drains liquidity from pools.
ARMSys turns toxic arbitrage from a vulnerability into a revenue stream. Instead of allowing bots to extract value with impunity (LVR), our hook detects aggressive price manipulation and penalizes MEV bots. These massive penalties remain inside the pool, significantly increasing the real yield for liquidity providers (LPs).
The crypto market does not follow a normal "bell-shaped" distribution. Unlike traditional markets, it is dominated by "fat tails" — sudden and extreme price shocks.
Our algorithm discards primitive metrics and utilizes Parkinson Volatility. The core of ARMSys analyzes absolute highs and lows of the price within each individual block. This allows the hook to instantly detect hidden intra-block bot manipulation. We have deeply optimized this complex math for the EVM, making the calculations extremely gas-efficient.
Every time a transaction hits the pool, ARMSys intercepts it before the swap occurs:
- Whitelist Check: The hook checks who is sending the transaction.
- Time Analysis: The algorithm checks the timers. If the market is calm, the pool's alert level smoothly and gracefully "cools down."
- MEV Capture: If the transaction is identified as aggressive arbitrage, the hook instantly extracts the penalty delta directly from the bot's swap amount before it ever touches the liquidity.
- Phase 1: Validation and Alpha Launch (Completed). Successful completion of the rigorous selection for the Uniswap Hook Incubator 9 (UHI9). Official deployment of the alpha version (v0.3.0) on the Base Mainnet.
- Phase 2: Expansion. Integration with aggregators and deployment of pools across all key L2 networks.
Why should I add my liquidity specifically to the ARMSys pool? Your capital stops being "food" for arbitrageurs. Thanks to MEV capture, the penalties collected from toxic flow remain in the pool, generating additional Real Yield for you—something unavailable in vanilla v3/v4 pools.
What does the DEFENSE status mean for a regular trader? If you try to make a swap and the transaction reverts with a "Defense Active" error, it means there is an anomalous price jump happening in the market right now (at this exact second). The hook rejected your trade to save you from executing an order at the most unfavorable rate. Just wait a few minutes for the Waterfall Decay to trigger, and try your transaction again.