# Levee

> Levee is a liquidity venue and an LP, hedging and perps toolkit on Robinhood Chain (chain id 4663): Uniswap v3 and v4 liquidity management, Levee's own pools, ERC-4626 vaults and a swap router. Levee is non-custodial and never asks for a private key, a seed phrase or a session key.

Every Levee contract is non-upgradeable, with no admin function over user positions, so the addresses and ABIs below do not change under you. An agent uses Levee the way the app does: it builds a transaction, simulates it, and signs it with its own wallet. Start with "Agents and integrations".

## Agents

- [Agents and integrations](https://levee.trade/docs/agents): what an agent can do, the contract calls, approvals and minimums, and the rules to keep
- [Connect your agent](https://levee.trade/agents): the setup page: an instruction for a chat agent, a script to start from, and a way to watch the agent wallet
- [Full docs as text](https://levee.trade/llms-full.txt): every chapter in one plain-text file
- [Deployment manifest](https://levee.trade/deployments/robinhood.json): chain id, deploy block and every Levee contract address
- [Chain constants](https://levee.trade/deployments/robinhood-external.json): Uniswap, Permit2, WETH, USDG, stock tokens, Chainlink feeds, Multicall3
- [ABIs](https://levee.trade/abi/index.json): one JSON ABI per Levee contract at /abi/<Name>.json, and which address uses which

## Rules

1. Use your own wallet. Never ask for, accept or send a private key, a seed phrase or a session key: Levee never needs one.
2. Before signing, check the transaction's `to` and every approval's spender against /deployments/robinhood.json or /deployments/robinhood-external.json.
3. Approve the exact amount of the next call, to the contract that pulls it. Never approve an unlimited amount.
4. Wherever a function takes a minimum (minAmountOut, minLiquidity, minShares, amount0Min, amount1Min), pass one that is not zero, with a deadline a few minutes out. An ERC-4626 vault deposit or redeem takes none: read previewDeposit or previewRedeem just before signing and send straight away.
5. Simulate before signing: eth_call, or one eth_simulateV1 request for an approval and the call after it.
6. LP, hedged and structured vault shares have 3 more decimals than their asset: read the vault's own decimals().
7. Do not trade perps through Levee: Lighter orders are signed by Levee's signer for people using the app. Trade on Lighter directly, with your own key.

## Contracts on Robinhood Chain (4663)

Explorer: https://robinhoodchain.blockscout.com. The sources are verified there.

Core:

- FeeRouter: 0x808C6a4451645B34895f1690D9F617E29CcefD71 · https://levee.trade/abi/FeeRouter.json
- ReferralRegistry: 0x7395da0F38B3729380505d374975d39327c2831B · https://levee.trade/abi/ReferralRegistry.json
- LeveeZapV3: 0x80999E61D250B413D9A1544cfb8C0CA99C8D9159 · https://levee.trade/abi/LeveeZapV3.json
- LeveeZapV4: 0xdeF6A64413F25c01bD50803dee93ee1579769402 · https://levee.trade/abi/LeveeZapV4.json
- RangeOrders: 0x1D68c0455C1668242F0E3121ccDfC19161Fa44D1 · https://levee.trade/abi/RangeOrders.json
- PositionKeeper: 0x28B43Db87B6F6Fb10EcF1Fe38F042300A7219547 · https://levee.trade/abi/PositionKeeper.json
- VaultFactory: 0x8823EBA2DEc5707FFdAC48F44E2090E36a05389a · https://levee.trade/abi/VaultFactory.json
- LaunchPipeline: 0x6fB95366daBB8Bc3b9F6d5574b994DF7d83A2727 · https://levee.trade/abi/LaunchPipeline.json
- PreMarketPerp: 0x458a99F4A55336aD87ae0C08C4d800b23aAFa767 · https://levee.trade/abi/PreMarketPerp.json

Vaults:

- ETH Vault: 0x98A496a35A235A01B02a8Eae15E8a90A929f4C21 · https://levee.trade/abi/LPVault.json
- Income NVDA: 0x23f30D31CC3022B164AbaD2b9f0DA58250D3335a · https://levee.trade/abi/StructuredVault.json
- NVDA Hedged: 0xC27081350872e9a330b6f0a68cAA9EDF644fd696 · https://levee.trade/abi/HedgedLPVault.json
- Protected SPY: 0x3dd2a1a9e6514D7E0143bcb3D607680ee05c9143 · https://levee.trade/abi/StructuredVault.json
- SPY Hedged: 0xCc57824cFBF35B23F299AffBCD3fDf4505a9A2C7 · https://levee.trade/abi/HedgedLPVault.json
- USDG Vault: 0x472652CF38626321De89D0ef9e4a6736910919Ba · https://levee.trade/abi/LPVault.json

Levee pools and router:

- ProtocolConfig: 0xf3784EfF7AE924A15B6b9219D806b52e377D9A8C · https://levee.trade/abi/ProtocolConfig.json
- AssetRegistry: 0x409A0a75478C4abc4a01f10dde613811bBFD6281 · https://levee.trade/abi/AssetRegistry.json
- DammHook: 0x6FAB5Ceb23bC1d7bf2ffA547807C8CE48d5228cc · https://levee.trade/abi/DammHook.json
- StockHook: 0xCd93565739D217CCBaddf786D7e4CDCb700628cc · https://levee.trade/abi/StockHook.json
- DlmmFactory: 0x088BbcE10be0792EF5d8334dB1edE2934d2Cf04a · https://levee.trade/abi/DlmmFactory.json
- DlmmPositionNFT: 0x7A0BF9ffaDB58C4cAb5662749c0cb57aa0AfFdE5 · https://levee.trade/abi/DlmmPositionNFT.json
- Router: 0x936316bbA997110e3A8e9B170c60A6CAF5b0cF09 · https://levee.trade/abi/Router.json
- FeeCollector: 0x2886389c20F0b94Fc4D363cEDE6367A0BB3ff55A · https://levee.trade/abi/FeeCollector.json
- BuybackV2: 0x77B70D723D1c13e71fAcd4C811D88218Bb66cbA6 · https://levee.trade/abi/BuybackV2.json
- DlmmLimitOrders: 0x55e7A04CbA97c5a180fA79d66A3F914910200A93 · https://levee.trade/abi/DlmmLimitOrders.json
- DlmmVaultFactory: 0x488eA417DfaA92db4f3f8660822b1d7F767bE061 · https://levee.trade/abi/DlmmVaultFactory.json
- DlmmVaultZap: 0x7CA6107c9de34F06ea74644aE0fC55b7F0D9b598 · https://levee.trade/abi/DlmmVaultZap.json
- LaunchPools: 0x168a1213f30c6e79232406e795a09a3952Dcd76a · https://levee.trade/abi/LaunchPools.json
- LaunchVault: 0xDC3A2e812a5D268ECe618461679a210947b90a51 · https://levee.trade/abi/LaunchVault.json
- StockVaultFactory: 0x70063A8f8F2dDec2c0a66a43e2AEB627cb3727e1 · https://levee.trade/abi/StockVaultFactory.json

Vault implementations (every vault clone delegates to one):

- HedgedLPVault implementation: 0x7658D0190d9f0B2A0cdCEF7296D3efbd21BaA400 · https://levee.trade/abi/HedgedLPVault.json
- LPVault implementation: 0x0f8DC4E67D06e1181dEaC49f5482453Bf60cF1DD · https://levee.trade/abi/LPVault.json
- StructuredVault implementation: 0x203d6aDF5f255f584F540e764aE68A5A1d63EfC4 · https://levee.trade/abi/StructuredVault.json

## Docs

- [Introduction](https://levee.trade/docs/overview): What Levee does on Robinhood Chain, the rules it will not bend, and where to read next.
- [Using the app](https://levee.trade/docs/app-guide): Each page of the app in a paragraph: what it is for, what it reads, and what it can sign.
- [Swaps and routing](https://levee.trade/docs/swaps): How one swap is split into hops across Levee pools, public v4 pools and Pons, and how a route is chosen.
- [Limit orders](https://levee.trade/docs/range-orders): A one-sided position that sells as the price crosses it and earns swap fees while it waits.
- [Perpetuals](https://levee.trade/docs/perps): Perps on Lighter through a per-user order key that can place orders and has no way to withdraw.
- [Vaults](https://levee.trade/docs/vaults): One-token Uniswap vaults and the DLMM and stock vaults: pricing, the price check, caps, harvest and rebalance.
- [Hedged vaults](https://levee.trade/docs/hedged-vaults): An LP vault with a Lighter short: the reporting and funding keys, when it pauses, and what is not live yet.
- [Structured notes](https://levee.trade/docs/structured): Income and Protected: two dated payoffs built from an LP sleeve, a perp sleeve or T-bills.
- [Levee pools](https://levee.trade/docs/pools): DAMM, DLMM and stock pools: how each prices a swap, what it charges, and how bin orders rest.
- [One-token deposits](https://levee.trade/docs/zap): Enter a range with a single token: the swap it makes for you, the checks on it, and the refund.
- [Position automation](https://levee.trade/docs/keeper): Let anyone harvest or re-centre your position under limits only you set, for a bounty you choose.
- [Launch a token](https://levee.trade/docs/launch): A token and its locked pool in one transaction, pooled buying before launch, and Pons tokens.
- [Graduation and pre-market perps](https://levee.trade/docs/graduation): How a token earns a managed vault after three days and real depth, and perps on a virtual AMM for tokens no venue lists.
- [Buyback and burn](https://levee.trade/docs/protocol): Fees become ETH, ETH buys $LEVEE, $LEVEE is burned: each step, its guard and who can call it.
- [Fees and referrals](https://levee.trade/docs/fees): What each action costs, where the money goes, the referral share, bounties and points.
- [Security model](https://levee.trade/docs/security): Every key and what it can do, the price checks in front of your funds, how it is tested and what is still open.
- [Architecture](https://levee.trade/docs/architecture): The contracts and services, which one calls which, and how a write travels from the app to the chain.
- [Indexer, API and bots](https://levee.trade/docs/offchain): Events into tables, the routes the app reads, and the seven bots that keep positions, hedges and pools current.
- [Agents and integrations](https://levee.trade/docs/agents): How an AI agent or a script uses Levee with its own wallet: the calls, the approvals, the minimums, and where the addresses and ABIs live.
- [Glossary](https://levee.trade/docs/glossary): The terms these docs use, each in a sentence or two, with a link to where it is explained.

## Coming next

- MCP server (coming soon, not live): a hosted tool server for every agent, over MCP and plain JSON. Its read tools answer market, vault, pool and portfolio questions; its build tools return unsigned, simulated transactions for your agent to sign with its own wallet. Its address will be listed here when it ships.
- Perps for agents (coming soon, not live): perps for every agent and the people who run them. Until then, the perp routes below stay app-only.

## Not for agents

- The app's perp write routes (`POST /perp/*`): Lighter orders are signed by Levee's signer service for a person using the app. An agent should trade on Lighter directly, with its own key.
- Token launches, keeper enrolment and range orders are app flows for now; see the docs before calling those contracts.