DOCS
On this page6 sections

Token & Market

FLIP token, canonical market, and revenue

Fixed supply, 3%/3% Hook economics, permanent LP, and protected revenue routing.

Canonical V4 Functional runtime recorded · Formal certification deferred

FLIP is a normal fixed-supply ERC-20

  • The full supply is minted once to the configured genesis receiver.
  • No public mint, rebase, blacklist, transfer switch, or wallet-to-wallet transfer tax belongs to the V3 token.
  • Mainnet total supply, allocation, vesting, launch price, and initial liquidity remain explicit launch decisions; Testnet values cannot decide them by accident.

Canonical FLIP/USDG V4 pool

Protocol Hook fee
3% on the USDG side of every canonical buy and every canonical sell.
LP fee
0.30% in the current V4 implementation; distinct from the 3% protocol fee.
Orders
Buy/sell exact-input and exact-output are covered.
Transfer
Wallet transfers pay 0%; the Hook is the fee boundary.

Other compatible routers cannot waive the Hook fee because it is enforced by the canonical pool. Side pools and OTC transfers are not counted as canonical protocol revenue.

Exact-in and exact-out 3% math

USDG-side integer formulas
gross-reference fee = ceil(grossUsdRaw × 300 / 10,000)
netUsdRaw = grossUsdRaw - fee

net-target gross-up fee = ceil(netUsdRaw × 300 / 9,700)
grossUsdRaw = netUsdRaw + fee
OrderUser-fixed valueUSDG fee treatmentRouter protection
Buy FLIP, exact inputGross USDG spendFee is carved from gross USDG; the pool receives the remainderExact amountIn, minimum FLIP out
Buy FLIP, exact outputFLIP receivedRequired USDG input includes the Hook fee calculated from the swap deltaExact FLIP out, maximum USDG in
Sell FLIP, exact inputFLIP spendFee is carved from gross USDG outputExact FLIP in, minimum net USDG out
Sell FLIP, exact outputNet USDG receivedPool output is grossed up by ceil(net × 300 / 9,700)Exact net USDG out, maximum FLIP in

All operations use raw integer units and round the protocol fee up. CanonicalSwapFeeRouted.usdReferenceRaw and feeRaw expose the applied branch. The separate 0.30% LP fee and price impact remain inside V4 swap pricing.

Fair Launch and permanent principal

The current V4 launch path consumes already-issued FLIP, initializes the one canonical pool, creates a full-range position, and terminally locks LP principal. Anyone can trigger fee collection, but the fee recipient is fixed and the caller cannot withdraw principal, transfer the NFT, or redirect assets.

Position Token ID
1
Locker
0x5366aea2fb1742648784f70ad6772d466c9d010b
Recorded owner
0x5366aea2fb1742648784f70ad6772d466c9d010b
Locker runtime code hash
0xe908ec2237454a10b0f49ef1d153ae158e7a5bab59ff14bd32b81d9101af37c2
Early principal retrieval entry
None in the reviewed Functional locker runtime

From FLIP launch to the game flywheel

One release-bound loop
Issue fixed-supply FLIP
→ initialize the canonical FLIP/USDG V4 pool and permanently lock LP principal
→ canonical buys and sells each route a 3% USDG-side Hook fee
→ below Ropen: 100% of recognized Hook revenue replenishes Solvency
→ open Manual games only after the complete release and atomic risk gate passes
→ at or above Ropen: new Hook revenue routes 65% Solvency / 35% Holder
→ game outcomes replenish Reserve or create a fully funded winner liability
→ JIT/cash settlement and Holder epochs make the reward loop observable
  1. 01

    Issue FLIP before games open

    Mint the fixed supply once to the configured genesis receiver. Token issuance alone does not authorize a game or create an accepted public release.

  2. 02

    Create and lock the canonical market

    Initialize the single accepted FLIP/USDG V4 PoolKey, supply its launch liquidity, and permanently lock the LP principal. Only this pool is the canonical 3%/3% revenue source.

  3. 03

    Accumulate the opening Reserve

    Every canonical buy and every canonical sell separately charges a 3% USDG-side Hook fee. While available General Reserve is below Ropen, 100% of recognized Hook revenue replenishes Solvency and Holder receives 0%.

  4. 04

    Open Manual games only through the full gate

    Reaching Ropen completes the one-way bootstrap latch, but admission still requires the accepted release identity, live readiness, Reserve and Bond coverage, JIT route capacity, safety floor, exposure limits, and the transaction's final atomic checks. Time, trading volume, or a UI toggle cannot open the game by themselves.

  5. 05

    Route new revenue after Ropen

    At or above Ropen, each new recognized Hook receipt routes 65% to Solvency and 35% to the isolated Holder purchase budget under the reviewed Functional policy. If available General Reserve later falls below Ropen, subsequent Hook revenue returns to 100% Solvency and 0% Holder until recovery.

  6. 06

    Settle games and distribute purchased rewards

    A losing principal becomes General Reserve funding. A win creates a fully funded USDG liability that ends only in JIT reward delivery or complete USDG cash fallback. The Holder worker uses only its funded budget to purchase an approved asset, then an independently approved Epoch distributes the actual inventory to eligible FLIP holders.

100/0 → 65%/35% → 100/0

Reserve stateSolvency shareHolder budget
Below Ropen100% of recognized Hook revenue0%
At or above Ropen65%35%
Falls below Ropen again100% for subsequent Hook revenue0%
Raw-unit routing after bootstrap
holderRaw = floor(receivedHookRevenueRaw × 3,500 / 10,000)
reserveRaw = receivedHookRevenueRaw - holderRaw

# Therefore:
reserveRaw + holderRaw == receivedHookRevenueRaw
all integer remainder / rounding dust goes to reserveRaw

The Holder share is floored first and Solvency receives the exact remainder, so a raw unit is never stranded in the Router. During bootstrap, holderRaw = 0 and reserveRaw = receivedHookRevenueRaw. The resulting Solvency share is then routed separately: it first protects General Reserve, and only surplus above Rtarget and other protected requirements can enter a capped Mystery epoch. Losing game principal and Game Fee Treasury are not Holder or Mystery Hook revenue.

Authority sources

These repository paths were used to derive this page. They link only when an explicitly configured public repository and immutable Source A commit are both available; otherwise they remain plain paths. Release addresses and live status still require an accepted manifest and finalized evidence.

  • src/v3/tokenomics/FlipToken.sol
  • v4/src/FlipUsdCanonicalHook.sol
  • v4/src/FlipFairLaunchV4.sol
  • src/v3/tokenomics/HookRevenueRouter.sol
  • src/v3/tokenomics/MysteryHookFundingRouterV3.sol