Levee is a trading and liquidity app on Robinhood Chain. From one wallet you can swap, trade perps, put liquidity to work in a pool, a range or a vault, and launch a token. This page covers what you can do, the rules the contracts keep, and where each topic is explained.
What you can do
| You want to | Use | Read |
|---|---|---|
| Swap one token for another | Swap, or Buy and Sell on Trade | Swaps and routing |
| Sell at a price, earning fees while you wait | Limit on Trade, or a DLMM pool | Limit orders |
| Trade perps with leverage | Trade | Perpetuals |
| Earn on a deposit without managing a range | Earn | Vaults, Hedged vaults, Structured notes |
| Provide liquidity yourself | Pools, or the Liquidity mode on Trade | Levee pools, One-token deposits |
| Keep a position harvested and centred | Portfolio | Position automation |
| Launch a token, or trade one before it lists | Launch | Launch a token, Graduation and pre-market perps |
Swaps route across Levee's own pools (DAMM, DLMM and stock pools), public Uniswap v4 pools and Pons tokens. Perps run on Lighter; a token that no venue lists can trade on Levee's own pre-market perp. Using the app walks through every page.
Rules that hold everywhere
One chain. Every contract is deployed on Robinhood Chain (4663), and the app sends transactions there only; development builds also accept a local test chain.
Your funds stay yours. Contracts cannot be upgraded, and no owner function can withdraw, transfer or freeze a position, a vault share or a deposit. The venue's owner can pause swaps and new liquidity, never withdrawals, and tune fees and limits, most of them inside caps written into the contracts. The DLMM and stock vaults can be re-laid by their keeper or the owner, inside the same on-chain guards.
One key acts for you. Perp orders on Lighter are signed by an order key that Levee's signer service generates and stores encrypted for your account. It can place and cancel orders and has no code path that signs a withdrawal. Other bot keys keep vaults running within contract limits; Security model lists each key and its bounds.
No deposit caps. The ETH and USDG vaults, both hedged vaults, the Protected SPY note and every graduated vault accept deposits of any size. A vault's cap is set when it is created and never changes. Anyone can create a vault through the factory, with any cap; the app lists only the vaults in its deployment manifest and those that graduated from Launch.
Fees on earnings, not principal. A zap or a Uniswap-path spot trade costs 25 bps, a managed position pays 10 % of the fees it earns, and Levee pools send 20 % of their swap fee to the protocol. Every fee and the 20 % referral share are in Fees and referrals.
$LEVEE. Protocol fees become ETH, the ETH buys $LEVEE, and the $LEVEE is burned, each step by a call anyone can make. The token launch is a separate step the owner approves. See Buyback and burn.
How these docs are arranged
| Group | Chapters | Read it when |
|---|---|---|
| Get started | Introduction, Using the app | you are new, or looking for a page |
| Trade | Swaps and routing, Limit orders, Perpetuals | you want to know how an order fills |
| Earn | Vaults, Hedged vaults, Structured notes | you are choosing where to deposit |
| Pools | Levee pools, One-token deposits, Position automation | you manage liquidity yourself |
| Launch | Launch a token, Graduation and pre-market perps | you are launching or backing a new token |
| Protocol | Buyback and burn, Fees and referrals, Security model | you want to know where money goes and who can do what |
| Reference | Architecture, Indexer, API and bots, Glossary | you are building on Levee or reviewing it |
Diagrams are drawn from data in the repository, so a label in a diagram matches a function, a field or a constant in the code.
contracts/src/every contract, none upgradeablecontracts/script/LeveeWiring.solthe deploy sequence and its valuescontracts/script/venue/VenueWiring.solthe venue deploy and its owner hand-overdocs/superpowers/specs/2026-10-06-levee-design.mdthe fixed design decisions