# ARMSys — Live LP What-If Dashboard

> Live dashboard streaming real Mainnet Uniswap v3 USDC/WETH 0.01% swaps through ARMSys' computeSwapFee math.

armsys.xyz is a live dashboard that runs the same `computeSwapFee` math used by the
ARMSys Uniswap v4 hook on Base, but applies it to *real* swaps from the Mainnet
Uniswap v3 USDC/WETH 0.01% pool. It shows in real time how much liquidity providers
*could* be earning with ARMSys' volatility-aware dynamic fees, compared to the
static 0.01% baseline.

## What it shows
- Live swap-by-swap comparison: static LP revenue vs ARMSys LP revenue
- 24h cumulative LP revenue delta on the exact observed flow
- Toxic-flow capture metric (how much arbitrageur PnL flips back to the LP)
- Current ARMSys "mode" badge (round-25 6-mode ladder: RESTING → EXTREME)
- Live feed of the last 50 swaps with per-swap delta

## How it works
1. A poller tails real swaps from the Mainnet v3 USDC/WETH 0.01% pool.
2. Each swap is run through ARMSys' `computeSwapFee` (same code as the v4 hook on Base).
3. Static and dynamic fee revenues are computed for the LP and shown live.
4. SQLite stores the swap history so the 24h windows are real measurements,
   not simulations.

## Pages
- [Home / Dashboard](https://armsys.xyz/): the live what-if dashboard.

## Pools referenced
- Mainnet v3 USDC/WETH 0.01% (data source): 0xE0554a476A092703abdB3Ef35c80e0D76d32939F
- ARMSys v4 ETH/USDC on Base (production hook): 0x088b6b69cbcaf84dae02a28dc7b62912ec105b6970d1ab7b985e4e50b6088ccd

## LVR & Impermanent Loss context
Loss-Versus-Rebalancing (LVR) is the dominant invisible cost for Uniswap LPs
on volatile pairs. ARMSys' dynamic fees raise the swap fee specifically when
volatility regime shifts (detected via EMA + Z-score on price moves), so
arbitrageurs pay more during the exact windows where they would otherwise
extract LVR. The dashboard makes this concrete: every swap from the live
Mainnet pool is replayed through the ARMSys math so you can see the LP-revenue
delta in dollars, not theory.

## Tech
- Express + tsx server on a GCE VM (europe-west4-a)
- Reverse proxy via nginx, HTTPS via Let's Encrypt
- SQLite via better-sqlite3 for swap history
- viem for on-chain RPC reads (Mainnet + Base)

## Links
- Twitter / X: https://x.com/armsysxyz
- Telegram: https://t.me/armsystem
- Docs: https://github.com/ARMSys26/docs/wiki/Docs