Hook-managed price
The Hook calculates buy and sell outcomes using token-specific
poolId state.Official Router
Users and integrations execute swaps through the Swap Router, not arbitrary third-party pools.
Floor-aware sells
The effective sell price cannot move below the current protocol floor.
Indexable state
Price, reserve, floor, ATH, volume, and activity can be read from protocol state and events.
Buy flow
When a user buys an official V5 token:1
BNB enters the Swap Router
The user sends BNB to
buy(key, minTokensOut) with the token-specific PoolKey.2
Router enters the Uniswap V4 flow
The Router uses the Pool Manager unlock/callback flow.
3
Pool Manager calls the Hook
The Hook receives the pool context and applies LFG.RICH protocol logic.
4
Hook reads poolId state
The Hook reads the token’s
poolId state for price, floor, reserve, fee, and referral rules.5
Fee is deducted and curve output is calculated
The V5 trading fee is deducted, then the curve calculates token output from net BNB.
6
Tokens are minted and state updates
Tokens are minted to the buyer, and price, reserve, floor, ATH, volume, and trade history can be indexed from events and state.
Sell flow
When a user sells an official V5 token:1
Approve the Swap Router
The seller approves the official Swap Router to spend the token amount.
2
Call sell with the PoolKey
The user calls
sell(key, tokenAmount, minEthOut).3
Router routes through Uniswap V4
The Router enters the same Pool Manager and Hook flow.
4
Hook calculates BNB output
The Hook calculates gross BNB return from the bonding curve and applies the V5 fee.
5
Tokens burn and BNB is paid out
Tokens are burned and the seller receives BNB after fees.
6
Floor protection applies
The sell cannot be priced below the protocol floor.
V5 estimate functions
V5 estimate functions include the wallet address. This matters because referral state can change the fee recipient split.Price and floor interaction
The effective sell price is never allowed to move below the token’s floor price. The current effective price is exposed by:Native BNB naming
Some contract fields and events useETH in their names, such as realETH, virtualETH, or borrowedETH. On BNB Smart Chain these values represent native BNB. The naming follows Solidity contract conventions but the economic asset is BNB.
