SV3 logo

Curve & Floor Math

This page defines the fixed-point math behind SV3 curve pricing, floor raises, and area preservation used in the $10 launch simulation.

This page defines the math behind the behavior shown in the $10 launch simulation. Prices use 18-decimal fixed point. Token quantities use 18 decimals, while reserve balances settle in 6-decimal USDC atoms.

Curve shape

An SV3 curve has three connected regions:

  1. a flat floor;
  2. a steeper ramp; and
  3. the main rising line.

Let xx be curve supply, FF the floor, x1x_1 the end of the flat region, x2x_2 the end of the ramp, m1m_1 the ramp slope, and m2m_2 the main slope.

For the flat region through x1x_1:

P(x)=FP(x)=F

For the steeper ramp from x1x_1 through x2x_2:

P(x)=F+m1(xx1)P(x)=F+m_1(x-x_1)

For the main line above x2x_2:

P(x)=F+m1(x2x1)+m2(xx2)P(x)=F+m_1(x_2-x_1)+m_2(x-x_2)

The v1 preset fixes the ramp at 2.5 times the main slope:

m1=2.5m2m_1=2.5m_2

At launch, x1=x2=0x_1=x_2=0. The curve therefore begins as one rising line from the initial floor.

V1 linear curve fieldHuman value
Initial floor F0F_00.0001 USDC/token
Main slope m2m_20.00000001 USDC per additional whole token
Ramp slope m1m_10.000000025 USDC per additional whole token
Ramp end and width at launch0
Initial SV3 price curve rising from a 0.0001 USDC floor
The initial market is a single linear ray. Floor raises create the flat and steeper ramp regions without breaking curve continuity.

Reserve is the area under the curve

Define curve area through supply xx:

A(x)=0xP(s)dsA(x)=\int_0^x P(s)\,ds

A buy that moves supply from C0C_0 to C1C_1 deposits:

Rb=A(C1)A(C0)R_b=A(C_1)-A(C_0)

A sell moving from C0C_0 down to C1C_1 receives this gross curve output before fees:

Rs=A(C0)A(C1)R_s=A(C_0)-A(C_1)

At launch:

P(x)=F0+m2xP(x)=F_0+m_2x A(x)=F0x+0.5m2x2A(x)=F_0x+0.5m_2x^2

This gives the buy-only relationship used in the simulation:

P2=F02+2m2RP^2=F_0^2+2m_2R

The market can mint only after receiving the corresponding area. A curve sell burns the returned tokens and releases the area that is no longer required.

How a floor raise restructures the selloff

An area-preserving raise changes the lower shape of the curve while holding both live spot and required curve area fixed at current supply CC:

A1(C)=A0(C)A_1(C)=A_0(C) P1(C)=P0(C)P_1(C)=P_0(C)
Before and after selloff paths showing the same starting spot, a steeper post-raise ramp, and a higher floor
Maximum area-preserving raise after the 10 USDC launch buy. Both paths start at the same live spot and use the same reserve area. After the raise, sells move price through a steeper ramp and reach a higher flat floor much sooner.

Area preservation concentrates the below-spot price movement into a shorter, steeper ramp. Sellers can therefore move spot faster after the raise. The benefit appears at the end of that ramp: canonical spot reaches a higher floor and stays flat there.

The total curve area is unchanged for this part of the raise. Floor-directed fees or donations can add backing for a further increase.

The deterministic controller applies floor capacity in this order:

  1. Use all legal area-preserving headroom.
  2. Measure recognized backing surplus.
  3. Retain the configured surplus buffer—10% under the default v1 policy.
  4. Commit the spendable surplus to the highest additional floor that preserves spot and solvency.

The floor cannot rise above live spot. Under repeated maximum area-preserving raises, the fixed 2.5× ramp approaches a floor/spot ratio near 43.6% as the initial floor becomes small relative to spot. This is curve geometry, not an ATH peg or a guaranteed ratio for every market state.

Actual supply and curve supply

Most buys and sells move token supply and the curve coordinate together. Some floor-priced actions move only actual supply. SV3 tracks both quantities so every token stays floor-liable without forcing those actions to move spot.

Let:

  • TT be actual ERC-20 supply;
  • OO be the signed supply offset; and
  • CC be virtual curve supply.
C=TOC=T-O
ActionActual supply TTCurve supply CCOffset OOSpot
Curve buyIncreasesIncreases equallyUnchangedRises
Curve sellDecreasesDecreases equallyUnchangedFalls
Floor redemptionDecreasesUnchangedDecreasesUnchanged
Collateral surrenderDecreasesUnchangedDecreasesUnchanged
Future current-floor option exerciseIncreasesUnchangedIncreasesUnchanged

Backing equations

Let LfL_f be floor liability, EcE_c excess curve area above the floor, RrR_r required backing, LL liquid accounted reserve, DD outstanding debt, and BgB_g gross backing.

Before contract rounding:

Lf=FTL_f=FT Ec=A(C)FCE_c=A(C)-FC Rr=Lf+EcR_r=L_f+E_c Bg=L+DB_g=L+D

Every accepted financial action must preserve:

BgRrLfB_g\ge R_r\ge L_f

Outstanding debt remains in gross backing because it records reserve paid early against floor-valued collateral held by the market. The debt is paired with tokens that cannot also be sold or withdrawn.

Gross floor and wallet proceeds

The on-chain floor FF is a gross USDC value per token. Direct floor redemption charges the 1.25% sell fee:

Fn=F(10.0125)F_n=F(1-0.0125)

Gas and conservative rounding can reduce final wallet proceeds further. Interfaces should display gross floor, estimated net floor, and executable quote as separate values.

Conservative rounding

The contracts settle curve prices and areas at 18-decimal precision, then cross into 6-decimal USDC with an explicit direction.

CalculationContract direction
Exact-USDC buy token outputDown
Exact-token buy required USDCUp
Sell gross and net outputDown
Required backing and floor liabilityUp
Advance capacityDown
Collateral required for debt or surrenderUp
Fee split dustFloor backing

Solvency uses inequalities rather than approximate equality. The generated manifest records the inputs and full-precision outputs used by the public charts.