Docs/Technical/Fee Model

Fee Model

Three-layer fee taxonomy: protocol-level, sovereign-level, and engine-level.

Protocol-Level Fees

Set by the protocol authority via update_protocol_fees. These are global defaults applied to all sovereigns.

FeeFieldDefault
Creation fee floormin_fee_lamports50 GOR
Governance unwind proposalgovernance_unwind_fee_lamports50 GOR
Unwind feeunwind_fee_bps500 bps (5%)
Default swap fee (post-recovery)default_swap_fee_bps30 bps (0.30%)
NFT mint feenft_mint_fee_bps500 bps (5%)

Sovereign-Level Controls

Per-sovereign fee settings managed by the sovereign creator.

Sell Fee

sell_fee_bps — creator-chosen sell fee with a cooldown period between adjustments and an irreversible renounce path that permanently sets it to zero.

Engine Fee Updates

update_engine_fees — adjusts the engine-level fee split parameters (creator share, bin share) via CPI to the engine program.

Engine Split Model

Swap fees collected by the engine are split into three streams. The split behavior changes depending on whether recovery is complete.

Recovery Phase
LP Share100% of remainder
Creator Share0%
Bin Sharebin_fee_share_bps

LPs are prioritized until their principal is recovered.

Active Phase
LP Shareremainder − creator_fee
Creator Sharecreator_share_bps
Bin Sharebin_fee_share_bps

Revenue shared between LPs and creator post-recovery.