# SV3

> How SV3 floor-backed token markets price, trade, raise their floor, and support non-recourse advances.

## Docs

- [Introduction](https://docs.sv3lab.fyi/introduction.md): SV3 lets creators launch tokens on a price curve with USDC-backed floors, spot pricing, and permissionless raises that protect holder redemption value.
- [How SV3 Works](https://docs.sv3lab.fyi/how-it-works.md): SV3 rebalances one canonical market per token, raising the floor by reshaping the curve while buyers and sellers move along it and reserves stay backed.
- [$10 Launch, 400 Traders](https://docs.sv3lab.fyi/simulations/ten-dollar-launch.md): This simulation traces a $10 launch through 400 buyers and a mixed exit wave, showing how spot and floor prices diverge after selling begins.
- [Borrowing & Loops](https://docs.sv3lab.fyi/protocol/borrowing-and-loops.md): Learn how SV3 advances let holders pledge tokens for USDC without selling, plus how repayment, surrender, and looping mechanics affect collateral and debt.
- [Curve & Floor Math](https://docs.sv3lab.fyi/protocol/curve-and-floor.md): This page defines the fixed-point math behind SV3 curve pricing, floor raises, and area preservation used in the $10 launch simulation.
- [Fees](https://docs.sv3lab.fyi/protocol/fees.md): SV3 splits each action fee into protocol revenue, creator revenue, and non-withdrawable floor backing, with rates and defaults detailed per action type.
- [Architecture](https://docs.sv3lab.fyi/protocol/architecture.md): This page explains SV3's on-chain architecture, covering contract roles, the permissionless keeper's function, and how solvency checks secure every
- [Floor keeper](https://docs.sv3lab.fyi/protocol/keeper.md): The unprivileged service that submits eligible floor raises. It cannot choose a floor, take backing, or pause a market.
- [Deployments](https://docs.sv3lab.fyi/protocol/deployments.md): How an SV3 deployment is laid out on a chain, and how the SDK is pointed at it.
- [Why Launchpads Need a Floor](https://docs.sv3lab.fyi/why-launchpads-fail.md): Learn why AMM launchpads lack a price floor and how SV3's reserve-backed structure protects holder exit value during selloffs.
- [Perpetual Markets](https://docs.sv3lab.fyi/future/perpetual-markets.md): Explore SV3's future perpetual futures and current-floor calls, two derivative concepts built on-chain spot and floor pricing mechanics.
- [Risks & Controls](https://docs.sv3lab.fyi/trust/risks-and-controls.md): The contract, reserve, market, administration, and position risks behind an SV3 floor.

## SDK

- [Getting started](https://docs.sv3lab.fyi/developers/sdk.md): Install the SV3 TypeScript SDK, create a client, pin a market snapshot, and quote a buy.
- [createSv3Client](https://docs.sv3lab.fyi/developers/create-sv3-client.md): Create the SV3 TypeScript client from a viem Public Client and a deployment manifest.
- [parseUsdc](https://docs.sv3lab.fyi/developers/parse-usdc.md): Parse a decimal string into 6-decimal USDC (UsdcRaw) for quotes and prepare calls.
- [getQuoteState](https://docs.sv3lab.fyi/developers/get-quote-state.md): Load a block-pinned, frozen market snapshot for local quotes.
- [getTradeContext](https://docs.sv3lab.fyi/developers/get-trade-context.md): Load a market snapshot together with the account balances needed to quote and send.
- [getAccountContext](https://docs.sv3lab.fyi/developers/get-account-context.md): Load a trade context plus the account's SV3 position, free collateral, and borrow capacity.
- [prepareBuyForReserveBudget](https://docs.sv3lab.fyi/developers/prepare-buy-for-reserve-budget.md): Prepare a buy that spends at most a USDC budget by submitting the cheaper exact-output selector.
- [prepareBuyExactReserveIn](https://docs.sv3lab.fyi/developers/prepare-buy-exact-reserve-in.md): Prepare a buy that spends an exact USDC amount and requires a minimum AVM out.
- [getRequirements](https://docs.sv3lab.fyi/developers/get-requirements.md): Read what the wallet must do before executePrepared — never a hidden approve.
- [executePrepared](https://docs.sv3lab.fyi/developers/execute-prepared.md): Re-check market state, simulate as the wallet, send the prepared call, and wait for a typed receipt.
- [wait](https://docs.sv3lab.fyi/developers/wait.md): Wait for a protocol transaction receipt and decode SV3 events.
- [Errors](https://docs.sv3lab.fyi/developers/errors.md): Decode SV3 custom errors from simulation failures and reverted receipts.
- [quoteNextRaise](https://docs.sv3lab.fyi/developers/quote-next-raise.md): Read on-chain floor eligibility, the deterministic maximum-safe plan, and a typed ADR-004 witness.
- [raiseIfEligible](https://docs.sv3lab.fyi/developers/raise-if-eligible.md): Prepare, simulate, and send the permissionless floor-raise call. The controller recomputes the plan on-chain.
- [Math](https://docs.sv3lab.fyi/developers/math/overview.md): Pure bigint quotes and curve helpers. No RPC. Pass a MarketSnapshot.
- [quoteBuyExactReserveIn](https://docs.sv3lab.fyi/developers/math/quote-buy-exact-reserve-in.md): Quote AVM minted for an exact USDC input from a market snapshot.
- [quoteBuyExactAvmOut](https://docs.sv3lab.fyi/developers/math/quote-buy-exact-avm-out.md): Quote the USDC that must be paid to mint an exact AVM amount.
- [quoteSellExactAvmIn](https://docs.sv3lab.fyi/developers/math/quote-sell-exact-avm-in.md): Quote net USDC out for selling an exact AVM amount on the curve.
- [quoteSellExactReserveOut](https://docs.sv3lab.fyi/developers/math/quote-sell-exact-reserve-out.md): Quote the AVM that must be burned to take home an exact net USDC amount.
- [quoteRedeemAtFloor](https://docs.sv3lab.fyi/developers/math/quote-redeem-at-floor.md): Quote net USDC out for redeeming AVM at the current floor price.
- [quoteBorrow](https://docs.sv3lab.fyi/developers/math/quote-borrow.md): Quote a non-recourse USDC advance against pledged AVM collateral.
- [quoteExpandExactReserveIn](https://docs.sv3lab.fyi/developers/math/quote-expand-exact-reserve-in.md): Quote a buy of AVM with exact USDC, pledged as collateral, plus a borrow.
- [quoteExpandExactAvmOut](https://docs.sv3lab.fyi/developers/math/quote-expand-exact-avm-out.md): Quote a buy of an exact AVM amount, pledged as collateral, plus a borrow.
- [quoteShrinkExactAvmIn](https://docs.sv3lab.fyi/developers/math/quote-shrink-exact-avm-in.md): Quote selling an exact AVM amount of collateral and optionally repaying debt.
- [quoteShrinkExactReserveOut](https://docs.sv3lab.fyi/developers/math/quote-shrink-exact-reserve-out.md): Quote shrinking a position so the wallet receives an exact net USDC amount.
- [quoteSurrender](https://docs.sv3lab.fyi/developers/math/quote-surrender.md): Quote burning collateral to cancel a chosen amount of debt.
- [getMaxActions](https://docs.sv3lab.fyi/developers/math/get-max-actions.md): Largest borrow, withdraw, repay, shrink, and surrender with the limiting reason.
- [freeCollateral](https://docs.sv3lab.fyi/developers/math/free-collateral.md): AVM in a position that is not locking outstanding debt.
- [lockedCollateral](https://docs.sv3lab.fyi/developers/math/locked-collateral.md): AVM that must stay pledged to cover a position's debt at the current floor.
- [borrowCapacity](https://docs.sv3lab.fyi/developers/math/borrow-capacity.md): Additional USDC that can be drawn against a position at the current floor.
- [priceAtSupply](https://docs.sv3lab.fyi/developers/math/price-at-supply.md): Spot price on the linear curve at a given curve supply.
- [areaAtSupply](https://docs.sv3lab.fyi/developers/math/area-at-supply.md): Integral of the linear curve from 0 to a supply, in WAD.
- [supplyForPrice](https://docs.sv3lab.fyi/developers/math/supply-for-price.md): Curve supply at which the linear curve reaches a target spot price.
- [sampleCurve](https://docs.sv3lab.fyi/developers/math/sample-curve.md): Price and certified area at many curve supplies from one snapshot.
- [launchPreset](https://docs.sv3lab.fyi/developers/math/launch-preset.md): v1 linear-curve coefficients used when a market is created.
- [validateState](https://docs.sv3lab.fyi/developers/math/validate-state.md): Check that linear-curve coefficients form a legal v1 engine.
- [assertMathRevision](https://docs.sv3lab.fyi/developers/math/assert-math-revision.md): Throw if a snapshot's curve revision is not implemented by this SDK.
- [requiredBacking](https://docs.sv3lab.fyi/developers/math/required-backing.md): Minimum gross USDC the market must hold to stay solvent at this snapshot.
- [floorLiability](https://docs.sv3lab.fyi/developers/math/floor-liability.md): Floor value of actual token supply, rounded up.
- [floorValueDown](https://docs.sv3lab.fyi/developers/math/floor-value-down.md): USDC value of an AVM amount at the floor, rounded down.
- [collateralForDebtUp](https://docs.sv3lab.fyi/developers/math/collateral-for-debt-up.md): AVM that must be pledged to cover a USDC debt at the floor, rounded up.
- [splitFee](https://docs.sv3lab.fyi/developers/math/split-fee.md): Split a gross USDC amount into protocol, creator, and floor legs at a fee rate.
- [minGrossForNet](https://docs.sv3lab.fyi/developers/math/min-gross-for-net.md): Smallest gross USDC such that net after a fee rate is at least the target.
- [rawToWad](https://docs.sv3lab.fyi/developers/math/raw-to-wad.md): Convert 6-decimal USDC raw units to 18-decimal WAD.
- [wadToRaw](https://docs.sv3lab.fyi/developers/math/wad-to-raw.md): Convert 18-decimal WAD to 6-decimal USDC raw units.
- [mulDiv](https://docs.sv3lab.fyi/developers/math/mul-div.md): Unsigned multiply-divide with optional ceil.
- [simulateSequence](https://docs.sv3lab.fyi/developers/math/simulate-sequence.md): Apply a list of local actions to a snapshot and collect quotes.
- [maxTradeForPriceImpact](https://docs.sv3lab.fyi/developers/math/max-trade-for-price-impact.md): Largest exact-in buy or sell whose Uniswap-style impact is at most a cap.
- [tradePriceImpact](https://docs.sv3lab.fyi/developers/math/trade-price-impact.md): Uniswap-style curve and total price impact for a trade quote.
- [API index](https://docs.sv3lab.fyi/developers/sdk-reference.md): Map of sv3Client namespaces to the pages that document them.