Basket holder
Hold assets as one productive, auto-rebalanced share.
A basket is an F-pool with base assets against one quote. You deposit and receive fungible shares under the pool's shared terms. Fees accrue in the pool, and swaps rebalance its holdings. Liquidity can reach the shared floor or a generation cap, and the pool's policy determines what its operator can change.
The role this was designed for is inventory that must stay productive and remain swappable leg by leg — a relayer or market maker parking a portfolio rather than an LP picking a range.
What you get
One share, not positions. Shares are ERC-6909 and interchangeable. There is no fee accounting: the floor is the accumulator, so a fee credits every share at once and your shares simply appreciate.
Constant value weights for an active uncapped basket. Since , each leg holds a constant value — so the basket auto-rebalances to fixed value weights without anyone rebalancing it. A base-to-base swap changes what the basket holds without changing what it is worth.
Any leg pullable without quote. Base-to-base executes at , which holds the index fixed — so it crosses no ticks, never touches the floor, and works even in a pool that has never held quote. Pulling one constituent out of the basket does not disturb the others.
Prices do not couple. reads only asset 's own reserve, so a trade in one asset does not move any other asset's price. Contrast a shared-reserve pool, where every trade in any asset repositions every other price.
Clean lending collateral. is affine in the index, so a liquidation threshold is a tick on the index — closed form, no search, no auxiliary oracle geometry. (The lending layer itself is deferred; the property is what makes it addable.)
What you are exposed to
The floor is a hyperplane, not a box. There is one free constant, hence one floor for the whole pool — so one member's crash spends the common buffer.
Prices are independent. Solvency is not.
That is a risk statement rather than a mathematical one, and it is why baskets suit correlated assets in practice.
Liquidity is shared and cross-pair liquidity is a series combination: . Composition stays fixed within a live generation. A private pool can change composition between generations under its policy; review those permissions before depositing.
What it is worth: the diversification ratio
Income per unit of capital scales with
exactly the return-on-capital multiple of a basket over a single-asset pool. For equal-weight, equal-volatility, uncorrelated assets it is .
The counter-intuitive consequence is that admission is about covariance, not volatility: admit an asset when its own volatility is high and its covariance with the index is low. Dropping the most volatile member of a basket can make the pool strictly worse. See Many bases, one quote.
The surface
// enter and exit
mint(poolId, to, dL, maxQuoteIn) // proportional
burn(poolId, owner, shares, minQuoteOut) // in kind, pro rata
router.zapIn(poolId, dL, maxQuoteIn, minShares, to, deadline) // single-asset entry
router.zapOut(poolId, shares, tokenOut, minOut, to, deadline) // single-asset exit
// trade
router.swapExactIn(poolId, kind, j, k, amountIn, minOut, to, deadline);
// read — everything is derived, nothing is stored; through the lens
lens.pool(poolId) // logFloor, compositeX, unharvested, the pool (Σ included), every legunharvested and the that the pool carries mean you can read the fee earned and the
model-free edge on-chain, from a pool that has no fee accounting at all.
Fees
A fixed per pool, set at creation, charged on the quote leg. Base-for-base charges because both legs were repriced — which makes fees route-invariant: base → quote → base costs the same as the direct hop, so there is no routing game.
Who can move the floor
The pool's policy says. A basket is public or private; a POL and a pad hold one base.
- A public basket is the protocol's: the fee collector is its authority and there is no desk. Its operator may harvest the bid to empty and relaunch the pool, but the generation step is refused on it: no holder is ever carried past the others.
- A private basket has a desk: the gates, the lists of who may mint and trade, and an
appointed operator. Its operator may also harvest to empty, reshape the composition between
generations, and run the generation step (
regenerate), which carries the authority into the next generation and freezes every other holder out pro rata, at the marks.
Either way, a harvest is price-neutral and pro rata, so what it can take from you is a policy — a
thinner book — never your share. A holder frozen out by a boundary or a generation step keeps its
claim on the old generation's bundle: redeem it in kind, or roll it into the live generation with
the router's rollIn. See Generations.