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 deferredFLIP 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
gross-reference fee = ceil(grossUsdRaw × 300 / 10,000)
netUsdRaw = grossUsdRaw - fee
net-target gross-up fee = ceil(netUsdRaw × 300 / 9,700)
grossUsdRaw = netUsdRaw + fee| Order | User-fixed value | USDG fee treatment | Router protection |
|---|---|---|---|
| Buy FLIP, exact input | Gross USDG spend | Fee is carved from gross USDG; the pool receives the remainder | Exact amountIn, minimum FLIP out |
| Buy FLIP, exact output | FLIP received | Required USDG input includes the Hook fee calculated from the swap delta | Exact FLIP out, maximum USDG in |
| Sell FLIP, exact input | FLIP spend | Fee is carved from gross USDG output | Exact FLIP in, minimum net USDG out |
| Sell FLIP, exact output | Net USDG received | Pool 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
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- 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.
- 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.
- 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%.
- 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.
- 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.
- 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 state | Solvency share | Holder budget |
|---|---|---|
| Below Ropen | 100% of recognized Hook revenue | 0% |
| At or above Ropen | 65% | 35% |
| Falls below Ropen again | 100% for subsequent Hook revenue | 0% |
holderRaw = floor(receivedHookRevenueRaw × 3,500 / 10,000)
reserveRaw = receivedHookRevenueRaw - holderRaw
# Therefore:
reserveRaw + holderRaw == receivedHookRevenueRaw
all integer remainder / rounding dust goes to reserveRawThe 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.
