One-sided liquidity and zaps
Distinguish an out-of-range deposit from converting one asset into an active liquidity position.
Starting with one asset can lead to two different operations. You can fund a position whose range lies entirely on one side of the current price, or use a supported zap to convert part of your asset and fund a range that needs both tokens.
A one-sided range starts outside the market
When price is outside a position's range, its principal is concentrated in one asset. This can make a one-token deposit possible, depending on which side of the current price the range occupies.
The position initially supplies no active trading liquidity and earns no new swap fees. If trading moves into its range, its composition starts changing and it can participate in fee accrual. If price later moves back, that composition can reverse.
This is not an irreversible limit-order fill. The position does not automatically withdraw after converting to the other asset. Native limit orders and automated position management are separate product proposals, not features of this position type.
A zap obtains the required second asset
For an active or full-range position, a zap in combines a swap and a liquidity deposit. You supply a single-asset budget, a chosen conversion amount, and limits. The operation uses its actual swap output plus the remaining budget to fund liquidity at the resulting price.
The correct conversion is not always half your budget. It depends on price, range, fees, and the swap's own price impact. The current protocol does not include an optimal-split planner; a compatible integration must prepare and simulate the complete composition.
| Review item | Why it matters |
|---|---|
| Total input budget | Caps the single asset committed across the operation |
| Swap output and price limits | Bound the conversion leg |
| Minimum liquidity | Prevents accepting too little liquidity after conversion |
| Both sets of hook requirements | The swap and deposit each retain their applicable rules |
| Unused assets | Rounding and ratio differences can leave balances in the wallet |
Exiting into one asset
A zap out removes principal and converts the other withdrawn asset toward your desired token. It does not collect outstanding LP fees or spend unrelated wallet balances. If there is insufficient liquidity to complete conversion, the whole operation fails.
Removing the pool's last usable liquidity may leave nothing against which to swap. A one-asset exit therefore cannot be assumed for every position or every full withdrawal.
The protocol supports zap instructions, but the direct SDK has no dedicated zap convenience methods yet. Availability in an application depends on its integration. For detailed semantics, read Zaps; for ordinary withdrawal, use Remove liquidity.