Technical Documentation

RAVENHOOD
WHITEPAPER

"Ravenhood does not sit still — it spreads. Born on Robinhood as a single liquidity pool, RAVENHOOD expands pair by pair across the chain's entire trading layer. The goal is singular: by the time the expansion phase is complete, every significant trading route on the Robinhood chain passes through Ravenhood. And once it does — every swap becomes fuel for the burn."

RVH Symbol
100,000,000 Total Supply
Robinhood Blockchain
ERC-20 Standard
Uniswap V3 DEX
Section 01

Overview

Ravenhood is a deflationary token deployed on Robinhood Chain — Robinhood’s Ethereum Layer-2, built on Arbitrum technology —, built around two fully permissionless on-chain mechanics that anyone can trigger at any time. There is no team multisig controlling the burn engine, no admin function to pause it, and no upgradeable proxy.

The core thesis is simple: the act of burning RVH increases scarcity, and scarcity increases value for remaining holders. Every intoTheVoid call permanently removes liquidity from the pool and destroys tokens. Every feedTheRaven call creates buy pressure against the pool. Both are open to the public.

Ravenhood is built on Robinhood Chain for its low fees and fast finality, which make frequent permissionless calls economically viable, while every state transition settles to Ethereum for security. Liquidity is provided via Uniswap V3 and permanently locked — it cannot be withdrawn by any party.

The protocol operates in three distinct phases tied to how much supply has been burned. During the Early and Mid Game phases, WETH proceeds from each burn are deployed into additional liquidity pools across multiple RVH trading pairs on the Robinhood ecosystem. Fee revenue generated by price discrepancies between these pools compounds over time, broadening the protocol's economic base. Once 50% of supply is burned — the Late Game — the expansion phase ends and all proceeds shift entirely into RVH buybacks and burns, accelerating deflationary pressure until the system reaches its terminal state at 90% burned.

Section 02

Token Summary

PropertyValue
NameRavenhood
SymbolRVH
Decimals18
Total Supply100,000,000 RVH
BlockchainRobinhood Chain — Ethereum L2, chainId 4663
Gas tokenETH
ExplorerBlockscout (robinhoodchain.blockscout.com)
Token StandardERC-20 (Solmate)
DEXUniswap V3
Pool Fee Tier1%
LiquidityPermanently locked
Section 03

Architecture

Ravenhood is composed of three smart contracts that work together as an immutable system.

┌─────────────────────────────────────────────────────┐ │ RavenhoodForge │ │ (Central Orchestrator) │ │ │ │ intoTheVoid() feedTheRaven() │ │ │ │ │ │ ▼ ▼ │ │ VAULT.claimBurn() VAULT.claimFees() │ │ │ │ │ └────────┼─────────────────────────────┼──────────────┘ │ │ └──────────────┬──────────────┘ │ │ ┌───────────────────────┴─────────────────────────────┐ │ RavenhoodVault │ │ (LP NFT Permanent Custodian) │ │ │ │ lockNFT() claimFees() claimBurn() │ └───────────────────────┬─────────────────────────────┘ │ │ Uniswap V3 LP NFT (RVH/WETH pool, 1% fee)
RavenhoodToken (RVH)
Standard ERC-20 token. 100M supply minted to the deployer at construction. Ownership is immediately renounced — no mint function, no blacklist, no admin controls of any kind. The token is inert: it cannot be paused, upgraded, or modified after deployment.
RavenhoodVault
An immutable custodian contract. Once the LP NFT is deposited via lockNFT(), it can never be withdrawn. Exposes claimFees() to collect accumulated swap revenue, and claimBurn() to remove a fixed 0.5% slice of remaining liquidity. Both send all proceeds to RavenhoodForge.
RavenhoodForge
The orchestrator. Owns RavenhoodVault and is the only contract that can call claimBurn(). Exposes two permissionless public functions — intoTheVoid() and feedTheRaven() — which drive all token mechanics. Also accepts native WETH via receive(), automatically wrapping it to WETH.
Section 04

Core Mechanics

4.1 intoTheVoid — The Deflationary Engine

intoTheVoid() is the primary deflationary function. It is permissionless — any wallet on any chain can call it once the cooldown has elapsed.

What happens when intoTheVoid() is called

  1. 01
    Phase check — Reads how many RVH tokens have been sent to address(0). Calculates voidRate = burnedSupply / 1,000,000 RVH. If voidRate ≥ 90, the function permanently reverts with "burns complete".
  2. 02
    Cooldown check — Requires block.timestamp ≥ nextBurnTime. Reverts with "burn not ready" if called too early.
  3. 03
    Cooldown update — Sets nextBurnTime forward based on the current burn phase.
  4. 04
    LP removal — Calls VAULT.claimBurn(), which instructs Uniswap to remove exactly 0.5% of remaining liquidity (liquidity / 200). Simultaneously sweeps all accumulated swap fees in the same transaction.
  5. 05
    WETH routing — The WETH received is routed based on the current voidRate phase (see Section 5).
  6. 06
    RVH burn — Any RVH held by RavenhoodForge at the end of the call is transferred to address(0) and permanently destroyed.

Each call is strictly rate-limited. The 0.5% removal compounds over time — early calls remove large absolute amounts, later calls remove smaller absolute amounts, but the percentage stays constant.

4.2 feedTheRaven — The Volatility Mechanism

feedTheRaven() is a secondary permissionless function with a 1-hour cooldown.

What happens when feedTheRaven() is called

  1. 01
    Cooldown check — Requires block.timestamp ≥ nextChaosTime. Reverts with "chaos not ready" if called too early.
  2. 02
    Fee claim — Calls VAULT.claimFees(), pulling any accumulated swap fee revenue from the LP position into RavenhoodForge.
  3. 03
    Balance check — Requires the contract holds at least 1 WETH. If not, reverts with "insufficient WETH". Fee revenue from the pool is the primary source.
  4. 04
    RVH pre-burn — Any RVH currently held by RavenhoodForge is immediately burned to address(0).
  5. 05
    3-round swap loop — Executes 3 consecutive rounds: buy RVH with the full WETH balance, sell all RVH back for WETH, repeat. Each round uses the contract's full balance, compounding the effect. The 1% pool fee is extracted from the balance each time.
Important interaction: claimBurn() inside intoTheVoid uses collect(type(uint128).max), sweeping both removed liquidity tokens AND all accumulated swap fees. If feedTheRaven is called shortly after intoTheVoid, its claimFees() call will return zero — both functions compete for the same fee pool. Call order matters.
Section 05

Burn Phase Routing

The WETH received from LP removal in each intoTheVoid call is routed differently depending on how much of the total supply has been burned.

PhasevoidRateWETH RoutingEffect
Early Game0% – 24%100% → owner walletOwner deploys WETH into new RVH trading pair pools — fee revenue from cross-pool arbitrage compounds the liquidity base
Mid Game25% – 49%50% → owner, 50% → buyback → burnLP expansion continues at half rate; the deflationary buyback engine activates in parallel
Late Game50% – 89%100% → buyback RVH → burnExpansion complete — all proceeds create sustained buy pressure and accelerate supply destruction
Complete≥ 90%Reverts — "burns complete"Burns permanently disabled
At ≥90% burned, intoTheVoid is permanently disabled. The remaining ≤10M RVH stay in the LP position indefinitely. feedTheRaven continues to function.

The Expansion-to-Burn Lifecycle

The Early and Mid Game WETH routing is not passive team revenue — it funds an active multi-pool liquidity expansion strategy. Each new trading pair (RVH paired against other Robinhood ecosystem tokens) increases the total volume routed through RVH, generating more swap fee revenue across the board. Price discrepancies between pools attract arbitrage flows, which in turn deepen each pool's fee accrual. By the time the Late Game begins, the protocol has a mature, multi-pair liquidity presence that amplifies the impact of every buyback-and-burn call: orders flow through a liquid market, slippage is minimized, and each RVH purchased is immediately destroyed — maximizing deflationary pressure per WETH spent.

Section 06

Cooldown Schedule

intoTheVoid has a dynamic cooldown that increases as more supply is burned, slowing the rate of burns as the token becomes rarer. The base cooldown is 4 hours. For every 5% of supply burned, an additional 2 hours is added.

Burn % ReachedAdded CooldownTotal Cooldown
0%4 hours
5%+2h6 hours
10%+2h8 hours
15%+2h10 hours
20%+2h12 hours
25%+2h14 hours
30%+2h16 hours
35%+2h18 hours
40%+2h20 hours
45%+2h22 hours
50%+2h24 hours
55%+2h26 hours
60%+2h28 hours
65%+2h30 hours
70%+2h32 hours
75%+2h34 hours
80%+2h36 hours
85%+2h38 hours (max)

feedTheRaven has a flat 1-hour cooldown regardless of burn phase.

Section 07

Liquidity Design

Permanent Lock

The LP NFT is transferred into RavenhoodVault via lockNFT() during deployment. Once locked, there is no function — on any contract — that can withdraw it. The vault has no unlockNFT function. Liquidity is locked permanently by design.

Single-Sided Position

At launch, all 95M RVH is deposited into a single-sided Uniswap V3 position. No WETH is required at launch — the position covers from the launch tick outward to MAX_TICK. As buyers purchase RVH, WETH accumulates in the LP position and swap fees begin accruing.

The 0.5% Removal Rate

Each intoTheVoid call removes liquidity / 200 from the position — exactly 0.5% of remaining liquidity, not total original liquidity.

CallRemovedRemaining Liquidity
Call 10.5% of 100%99.500%
Call 20.5% of 99.5%99.003%
Call N0.995^N × original — asymptotically approaches zero

Liquidity asymptotically approaches zero but never reaches it. The removal rate slows naturally as liquidity decreases, and the cooldown increases simultaneously — both mechanisms cooperate to slow the pace of burns as the token matures.

Swap Fees

The 1% fee tier means every swap in the RVH/WETH pool generates fee revenue. This revenue accumulates inside the LP position and is claimed by claimFees() (inside feedTheRaven) or swept alongside the liquidity removal in claimBurn() (inside intoTheVoid). All fee revenue flows into RavenhoodForge as WETH.

Multi-Pool Expansion Strategy

During the Early and Mid Game phases, WETH received by the owner is deployed into additional liquidity pools pairing RVH against other Robinhood ecosystem tokens. This creates a network of pools where price discrepancies naturally attract arbitrage activity — each arbitrage trade generates swap fees across every pool in the route, compounding total fee revenue beyond what a single pair can produce.

As trading volume grows across these pairs, the primary RVH/WETH pool becomes a deeper reference market. When the Late Game begins and WETH is redirected to buybacks rather than new pools, the existing multi-pair presence ensures that buyback orders flow through a mature, liquid market — minimizing slippage and maximizing the deflationary impact of each intoTheVoid call.

Section 08

Token Distribution

95M
Locked in LP (95%)
5M
Deployer Wallet (5%)
0%
Team/VC Reserve
AllocationAmount% SupplyNotes
Liquidity Pool (locked)95,000,000 RVH95%Single-sided Uniswap V3, permanently locked in RavenhoodVault
Deployer wallet5,000,000 RVH5%Split: 2% for expansion pool liquidity; 1.5% for infra maintenance; 1.5% for marketing/community incentives

The 5% deployer allocation is strictly designated: 2% is reserved to seed new liquidity pools during the expansion phase (once these are exhausted, additional expansion tokens will be purchased from the open market), 1.5% funds ongoing infrastructure maintenance, and 1.5% is allocated for marketing and community incentives.

Section 09

Launch Parameters

ParameterValue
Target market cap at launch~$15,000 USD (fully diluted)
Quote assetWETH — Robinhood Chain’s wrapped ETH
RVH launch price$0.00015 (≈ 0.000000088 WETH at ETH ≈ $1,700)
Launch tick≈ −162,400 — computed from the live ETH price at deploy, rounded to the nearest multiple of 200
PoolRVH/WETH, 1% fee tier, tick spacing 200
sqrtPriceX96Exact TickMath.getSqrtRatioAtTick value at the launch tick
LP rangeLaunch tick → MAX_TICK (single-sided — the mint requires zero WETH)
Section 10

Contract Addresses & Deployment

Ravenhood Contracts

ContractAddress
RavenhoodForgeAnnounced at launch
RavenhoodToken (RVH)Announced at launch
RavenhoodVaultAnnounced at launch

Robinhood Infrastructure

ContractAddress
WETH (wrapped native)0x0Bd7D308f8E1639FAb988df18A8011f41EAcAD73
Uniswap V3 NonfungiblePositionManager0x73991a25C818Bf1f1128dEAaB1492D45638DE0D3
Uniswap V3 Factory0x1f7d7550B1b028f7571E69A784071F0205FD2EfA
Uniswap SwapRouter020xCaf681a66D020601342297493863E78C959E5cb2
Uniswap QuoterV20x33e885eD0Ec9bF04EcfB19341582aADCb4c8A9E7

Source Code

RepositoryLink
RAVENHOOD ProtocolRepository published at launch; contracts verified on Blockscout

Deployment Sequence

  1. 01
    Deploy RavenhoodForge — internally deploys RavenhoodToken and RavenhoodVault, mints 100M RVH to deployer, renounces RVH ownership
  2. 02
    Create the RVH/WETH pool via Uniswap V3 Position Manager at the launch price
  3. 03
    Approve 95M RVH to the Position Manager
  4. 04
    Mint the single-sided LP position (95M RVH, 0 WETH)
  5. 05
    Approve the LP NFT to RavenhoodVault, call lockNFT() — liquidity is permanently locked
Section 11

Security Model

What is Immutable

Fixed Supply Locked Liquidity No Admin Overrides Hardcoded Logic
  • Total supply is fixed at 100M RVH — no mint function exists after ownership is renounced
  • LP liquidity can never be withdrawn — RavenhoodVault has no unlock function
  • intoTheVoid and feedTheRaven routing logic cannot be changed — no admin overrides
  • Pool fee, tick range, and swap callback logic are hardcoded constants

What the Owner Controls

The owner address receives WETH payouts during Early and Mid game phases of intoTheVoid. These proceeds are deployed into additional RVH liquidity pools across Robinhood ecosystem trading pairs — growing fee revenue that compounds the protocol's economic base before the Late Game burn engine takes over. Ownership can be transferred via transferOwnership() with no timelock or delay. A compromised owner key only affects payout destination — it cannot access locked liquidity, pause burns, or modify any mechanic.

Section 12

Tokenomics Summary

MetricValue
Max supply100,000,000 RVH (fixed, no mint)
Circulating at launch5,000,000 RVH (deployer)
Locked in LP95,000,000 RVH
Burn mechanismPermissionless, on-chain, rate-limited
Burn rate per call0.5% of remaining LP liquidity
Min burn cooldown4 hours (0% burned)
Max burn cooldown38 hours (85%+ burned)
Burns disabled at90% of supply burned
Stability cooldown1 hour (flat)
LP lockPermanent — no withdrawal possible
Owner privilegesWETH payout destination (early/mid game only)
Section 13

Roadmap

Token deployment on Robinhood mainnet
LP creation and permanent lock via RavenhoodVault
Public intoTheVoid and feedTheRaven activation
Forge dashboard — burn tracker, cooldown timer, burn phase indicator
Website launch
DEX listing announcements
Mindshare Mining launch — earn RVH rewards for promoting RAVENHOOD
RAVENHOOD Mindshare Network launch
Early Game milestone communication — 25% of supply burned
On-chain game release — play-to-burn mechanics powered by RVH
Mid Game milestone communication — 50% of supply burned
NFT collection release — staking boost utility
Staking rewards funded by DAO revenue
Late Game milestone communication — 90% of supply burned
This document describes the Ravenhood smart contract system as deployed. All mechanics described here are enforced entirely on-chain and cannot be modified after deployment.

Disclaimer

This whitepaper is for informational purposes only and does not constitute financial, investment, or legal advice. RAVENHOOD is a purely experimental, deflationary protocol deployed on the Robinhood blockchain. Participation in decentralized finance (DeFi) and the acquisition of cryptographic tokens involve significant risk, including the potential loss of all invested capital. The Ravenhood smart contract system operates autonomously and is immutable; it is not managed, controlled, or influenced by any person or entity. Users assume full responsibility for their interactions with the protocol and should conduct their own thorough due diligence before participating. By interacting with the Ravenhood smart contracts, you acknowledge and accept these inherent risks.