LEV7 documentation
Smart Contracts
A technical reference to the immutable smart contracts that make up the LEV7 protocol.
| Contract | Job |
|---|---|
Lev7 | The token. Fixed supply, burnable, permit. |
Lev7FeeHook | Charges 3% on buys, records price history, meters burn credit. |
OrderRouter | Buy router that carries a referral code. |
Referrals | One-time, signature-authorized referral code registration. |
Validator | Pay the 3% after the fact, at an hour-long average price. |
LPLock | Holds the permanent liquidity and performs burns. |
BurnCredit | The shared daily burn budget. |
Treasury | Receives fees, deposits into the vault, forwards shares. |
Vault | Asynchronous vault with NAV reporting and capped redemptions. |
Distributor | Pays vault shares out in replay-protected batches. |
Staking | Positions, multipliers, delegation, vote commitments. |
Hurdle | Settles the weekly strategy result on-chain. |
Deployed addresses
All contracts are immutable and deployed on Robinhood Chain (4663).
This is the canonical Uniswap V4 Pool for LEV7. Only purchases through this pool are eligible for the verified rewards program.
| Field | Value |
|---|---|
| PoolManager | 0x8366a39CC670B4001A1121B8F6A443A643e40951 |
| Pool ID | 0xa680edd0574d80e0808ec972c7ce7f426886e7a94eb1a200243bc8b6333a110c |
| Pair | LEV7 / USDG |
Token
Lev7 mints exactly 1,000,000,000 LEV7 once, at deployment, and can never
mint again. It's an ordinary ERC-20 with burn and permit extensions. It has no
owner.
The entire supply went into LPLock at launch. See
The Burn-In LP Lock.
The fee hook
Lev7FeeHook is a Uniswap v4 hook on the LEV7/USDG pool.
On a buy it takes 300 basis points of the input and sends it directly to the treasury. Exact-input orders have the fee reserved up front and refunded for whatever the pool declines, so a partial fill is never overcharged.
Two things happen on the same path:
- Price history. A tick observation is recorded before the swap can move
the price.
Validatorreads that history for its average. - Burn credit. The fee is recorded in token terms and becomes burn budget.
The hook never converts the fee or deposits it. It moves USDG to the treasury and stops.
OrderRouter is a convenience, not a requirement. Swapping the pool directly
pays the same fee, earns the same credit, and produces the same verification.
Validation
Validator.validate(amount, maxFee) charges 3% of the token's value at a
60-minute time-weighted average taken from the hook's own observations. It
refuses to quote from a window shorter than an hour, or from an observation
more than five minutes old.
The fee goes to the same treasury and accrues burn credit on the same terms as a purchase.
Treasury, vault, distributor
This is the contract-level view of the
LEV7 Community Vault, whose share token is ALLO.
The treasury exposes two operations, both callable by anyone:
requestDeposit()requests a deposit of the treasury's entire asset balance into the vault.forwardShares()claims settled shares and transfers the full share balance to the distributor.
Changing the vault or the distributor is a two-step owner action behind a 24-hour delay and a 7-day execution window.
Vault is an asynchronous ERC-7540 vault. Deposits and redemptions are
requested, then settled by a manager rather than filled instantly.
| Control | Behavior |
|---|---|
| Deposit access | Only the treasury can deposit into the vault |
| Capital deployment | The manager moves assets to the strategy account |
| NAV reporting | Reported by a reporter, rate-limited between 1 and 24 hours |
| NAV bounds | Constrained by a deviation limit and a rolling drift budget |
| Forced NAV replacement | Manager only, and only after 25 hours |
| Redemption cap | Derived from the highest recent NAV, spread over a 7-day wind-down |
| User protections | Stale-request and emergency exit paths |
Capped asynchronous redemptions means that your redemption is not guaranteed to settle on any particular day.
Distributor is run by a keeper that submits a batch of recipients and amounts; the contract derives a
content-addressed batch ID and refuses to process the same batch twice.
Staking
Staking accepts positions of at least 7,777 LEV7, up to seven live
positions per address.
| Property | Behavior |
|---|---|
| Instant path | A signed certificate activates the stake immediately |
| Queued path | Stays pending until a keeper acts; owner-reclaimable after 7 days |
| Extra lock | None, or 7 to 70 days |
| Voting multiplier | 1× to 10×, linear in lock length, while the lock runs |
| Exit | 7-day cooldown, then withdraw |
| States | Pending, Active, Cooling, Withdrawn, Rejected |
Active stakers can delegate voting power. The contract records one signed commitment per voter per proposal.
Hurdle
Hurdle settles one weekly comparison between the strategy account and its
benchmark. A keeper opens the week with both opening NAVs inside a one-day
grace window, and reports both closing NAVs once the week has elapsed.
The contract computes each side's return and the bar:
max(|benchmark return| ÷ 100, minEdgeBps), where minEdgeBps defaults to 10
and is snapshotted at open so a later change can't flip a running week.
The verdict is produced by the contract.
Security
V12 audited all LEV7 smart contracts on August 19, 2026. The audit found no critical vulnerabilities. The full report can be found here: V12 Audit Report.
Nobody can withdraw the locked liquidity, mint tokens, move another user's balance, or reverse a burn.