Liquidity provider
A C-pool LP chooses a liquidity size and a floor, plus an upper cap for a capped position. The formulas below describe uncapped positions while active, unless stated otherwise.
Liquidity size: base exposure in quote
Because , the position's base-leg value in quote is identically , invariant under price. So the question is:
How much base exposure, in quote, do I want?
That one number sets the LVR bill () and the fee accrual rate () together. It is the whole risk-and-reward unit.
The floor: quote buffer and activation boundary
The floor tunes how much quote buffer wraps that exposure. Three equivalent framings:
| framing | you pick | relation |
|---|---|---|
| log-drawdown (default) | a log distance | |
| % drawdown | a percentage | |
| absolute floor | a price | directly |
Log-drawdown is the native one and coincides with % drawdown to first order for small values. Everything else derives from : implied deposits, leverage , and break-even .
The floor is an output, not an input, if you prefer to think in wallet terms:
"I want $1,000 of ETH exposure" is . "I'm bringing $Q of USDC alongside it" sets the floor. Both numbers are things already in your wallet.
The mint
Implied deposits, shown for confirmation:
- active mint (, floor below spot): base and quote;
- dormant mint (, floor at or above spot): base only, no quote — a native limit sell.
router.mintBlended(key, targetFloor, cap, L, maxBaseIn, maxQuoteIn, recipient, deadline);
router.zapIn(key, fundWithBase, amountIn, targetFloor, cap, L, maxIn, recipient, deadline);targetFloor is arbitrary. The router splits across the two adjacent ladder rungs, and
the blend is one position at the floor
you asked for. previewBlend returns the split. zapIn enters from a single asset — it solves for
the swap that leaves no residual, monotone in the displacement, converging in about three Newton
iterations.
Degenerate cases worth knowing:
- , floor at spot — maximum leverage, no buffer;
- , floor above spot — dormant, a resting sell;
- small, large — a deep buy ladder.
The position panel
Per holder, per class:
| field | example |
|---|---|
| pair | USDC / ETH |
| base exposure | $4,750 |
| floor | $1,800 |
| current price | $3,200 |
| drawdown | 0.575 (−43.8%) |
| current value | $7,481 |
| composition | 63% ETH / 37% USDC |
| status | active |
| fees accrued | $142.17 |
| leverage | 0.63 |
Lifecycle
| event | what you see |
|---|---|
| mint active | position appears, fees start accruing |
| mint dormant | position appears as a pending limit sell; no fees until activation |
| price falls toward the floor | shrinks; warn below 0.1 |
| price crosses the floor downward | status flips to dormant; 100% base; fees pause |
| price rises back across it | status flips to active; fees resume |
| claim | fees paid out in quote; position otherwise untouched |
| compound | fees fold in; floor drops to ; no swap |
| raise floor | quote returned; floor rises to |
| burn | claim the position plus accrued fees; shares burned |
Crossing the floor does not liquidate the position. It holds base until price recovers or you withdraw. The base can continue to lose market value below the floor.
The four ongoing operations
Each moves the position along a single axis. All are , and all are wrappers over one primitive.
Claim. Withdraw accrued fees in quote. Does not touch , the floor, or the holdings.
Compound — lower the floor. A pure-quote injection at fixed is identically a floor move, . No swap, no rebalance, nothing to rebalance into.
Raise the floor. The symmetric dual: withdraw of quote, , bounded by — drainable to the current price, not beyond.
Add base. Top up exposure without adding quote. and the same buffer now covers a larger exposure, so the floor rises and shrinks.
| op | ||||
|---|---|---|---|---|
| mint / burn | ± | ± | ± | fixed |
| claim | fixed | fixed | fixed | fixed (fee exits the position) |
| compound | fixed | fixed | + | ↓ |
| raise floor | fixed | fixed | − | ↑ |
| add base | + | + | fixed | ↑ |
| reprice dormant | ∝ | fixed | 0 | ↕ (strictly above ) |
All of them are update(key, fromId, shares, toFloor, toCap, newL, …) with one or two degrees of
freedom pinned. Accrued fees are swept into the same netting, so an edit needs no separate collect.
newL = 0 is a full exit and settles identically to burn.
Why this is not the Uniswap v3 workflow
| task | Uniswap v3 | log(swap) |
|---|---|---|
| collect fees, keep position | decreaseLiquidity(0) then collect | claim |
| collect across ranges | calls over NFTs | one call, one transfer |
| change range | decreaseLiquidity → collect → mint; new tokenId | update — moves shares to the destination class |
| resize in place | increase/decreaseLiquidity, fees collected separately | update with a new |
| resize and reposition | not expressible as one op | update — one call |
| compound fees | collect → swap to the range's ratio → increaseLiquidity | update to a lower floor — swap-free |
| position identity | non-fungible per (owner, range) | fungible ERC-6909 per class |
The last two rows are the structural ones. Compounding is swap-free because fees are quote-only and a pure-quote injection at fixed is identically a floor move. And fungibility survives because active positions aggregate affinely, so a class needs no per-holder range state — v3 ranges do not compose, which is what forces the NFT.
The honest caveats: v3's three calls are usually bundled in a multicall, so the saving is gas and integration stability rather than atomicity; and the floor ladder is discrete where v3 ticks are fine-grained, which is why blending across adjacent rungs is a router responsibility.
Reading your P&L
Two accumulated numbers and a subtraction:
is the cumulative fee return on active liquidity over the window. For an active uncapped position, expresses it on starting capital using the starting drawdown. Annualize by the window duration to report an APR. No volatility model, no benchmark portfolio, no oracle — both numbers are statistics of the same price path, and the pool tracks both.
Capping the position
Adding a cap gives up the upside above and buys 1.3–1.7× capital efficiency — same fees, same LVR, less capital deployed. Unlike v3 concentration the fee-to-LVR ratio per unit is untouched, so it is pure capital efficiency rather than a change in the risk trade. See The cap.
Note that with a cap, , so stops being the base-leg value — the interface shows exposure and separately.
What the interface deliberately does not expose
Ticks, fee accumulators, and the invariant equation (available in a details drawer). There is no upper bound to pick unless you want one — positions are automatically full-range above.
For an active uncapped position, equals the base exposure in quote. For a capped position, show and base exposure separately, using .