Ripstr
Docs / Controls & safety / Parameters

Parameters

Every number the protocol uses is a named parameter with a default and an allowed range. Changes are per-pool, emit a typed event so the full configuration history can be replayed from chain logs, and most of them require an idle queue — no configuration can shift underneath a request that is already in flight.

Pricing and acquisition

ParameterDefaultRangeWhat it controls
Acquisition surcharge10%any ≥ 0Markup over expected value; split between depositor fees and the purchaser's $RIP allowance
Positive slippage cap10%0–100%Protocol-capped upward fee drift, snapshotted per request
Negative slippage default10%0–100%, per purchaserDownward drift a purchaser tolerates before refunding
Selection timeout400 slotsbounded by the reveal windowInclusive randomness deadline (~2.7 minutes)
Oracle fee~0.003 SOLadmin-setRandomness cost plus keeper margin; nonrefundable
Max acquisitions per transaction5> 0Batch cap
Max activations per acquisition61–16Staged listings reserved per request
Max staged listingsunlimitedany; 0 = unlimitedStaging queue cap

Positions

ParameterDefaultRangeWhat it controls
Minimum backing0.01 SOLany ≥ 0; 0 disablesFloor per position
Crown tithe5%0–100%Slice of each fee routed to the crown pot
Crown threshold10%0–100%Margin required to seize an occupied crown

Settlement

ParameterDefaultRangeWhat it controls
Depositor bid rate85%50–100%, at least the protocol settlement cutPurchaser's share when accepting the standing bid
Settlement window24 h0 up to the finalize windowPurchaser-exclusive period
Finalize window7 dat least the settlement windowAfter this, anyone may finalize
Retained to protocolonon / offSettlement discount goes to the protocol, or to depositors
Settle as $RIPonon / offAvailability of the fourth settlement option

Protocol revenue

ParameterDefaultRangeWhat it controls
Protocol acquisition cut1%0–100%Protocol slice of each acquisition fee
Protocol settlement cut1%0–5%, at most the bid rateProtocol slice when a purchaser keeps the NFT
Creator commission share40%admin-setCreator's share of a permissionless pool's protocol take
Pool creation fee20 SOLadmin-setCharged to non-admin callers creating a pool, plus the $RIP equivalent
Protocol fee to $RIP0%0–100%Protocol cuts recycled into buybacks

$RIP

ParameterDefaultRangeWhat it controls
Hot gap / cold gap60 s / 3600 shot below coldBands for the dynamic surcharge-to-$RIP split
Forced edge splitdynamic−1 (dynamic) or 0–100%Pins the surcharge-to-$RIP fraction
Buyback routing40 / 40 / 20must sum to 100%Depositors / purchasers / burn
Buyback price floor~10% toleranceadmin-setHard bound on permissionless buybacks
External $RIP buysoffon / offMarket buy gate; sells are always open

Collections and lifecycle

ParameterDefaultRangeWhat it controls
Whitelist enforcementonon / offGate on new listings and relists
Burn-path amount0 (disabled)anyNFTs to burn for permissionless whitelisting
Acquisitions enabledoffon / offLoading phase; must be turned on to go live
Withdraw-onlyoffon / offWind-down state