Ambient
Ambient repositions out-of-range liquidity through a combined burn, swap and mint
Ambient moves an out-of-range concentrated position into a replacement range through a combined burn, swap and mint transaction. Burning removes the old liquidity, the swap adjusts its token mix and minting funds the new range. The replacement contributes active liquidity when the pool price lies inside its bounds. Execution depends on valid ticks, available collateral and the pool's removal rules. Moving the range uses the position's present collateral; it does not restore the original deposit value.
The short version: Atomic execution prevents removal of the old liquidity from persisting when the combined repositioning transaction reverts.
Removing Liquidity and Funding a Replacement Range
Repositioning changes the price interval where capital participates in trading, with removal, conversion and redeployment serving different purposes inside the combined operation. A burn releases the collateral associated with the old range. A swap supplies the other token when the replacement needs a different mixture. Minting records liquidity at the selected new boundaries. These operations describe changes in pool state; they do not require the entire balance to pass through a wallet between each change.
Separate removal and deposit operations remain available at the protocol level. Separate transactions leave a period when the withdrawn collateral supplies no liquidity. The combined action ties its included operations together. Its settlement accounts for their net token flows, so burn proceeds alone do not determine an additional debit charged to a wallet.
Pool Price, Range Bounds and Token Exposure
An out-of-range position retains its liquidity record, while its principal stops contributing trading depth at the current pool price. The lower and upper boundaries describe where that contribution can become active. They do not indicate when the position expires. Pool price means the exchange rate on the pool's curve, which can differ from a price displayed elsewhere.
Concentrated principal outside its interval consists of one side of the pair. Within the interval, it generally consists of both tokens. Accrued rewards require separate accounting, so the total withdrawal can include more than the principal's single token. Which principal token remains depends on the side of the range the price crossed and the direction used to display the pair.
Changing the range therefore changes future token exposure. The replacement starts with collateral valued under its execution conditions, including any conversion.
Why Does Repositioning Need a Swap?
Repositioning needs a swap when the available collateral lacks the token mixture required to fund the replacement range. An out-of-range position's principal can be entirely one token, while a range surrounding the pool price requires both sides. The conversion trades part of the available balance for the missing side. The target boundaries and execution price determine the amounts needed; a fixed split is not a universal rule.
Price impact changes the conversion's execution rate as the trade moves through available liquidity. That movement can also affect the collateral ratio needed for the new range. A quote must account for these related effects. Already-held collateral can reduce the missing amount, so the required swap is specific to the chosen adjustment.
Range Width and Valid Price Ticks
A replacement range must satisfy the selected pool's tick rules before it can accept liquidity, regardless of whether its displayed prices look suitable. Ticks encode price boundaries on a discrete scale. Pool tick spacing determines the ordinary grid of permitted endpoints. Choosing a narrower interval concentrates capital over fewer prices; widening it spreads the same capital across a broader interval.
Some long-form operations support off-grid price improvement when the configured collateral and proximity requirements permit it. Simple flat mint calls enforce the ordinary grid. Off-grid eligibility can change with the applicable configuration and position size.
Tick rounding changes the actual boundaries. The executable interval, rather than the prices initially typed, determines where the replacement participates.
Slippage Bounds and Atomic Execution
Execution protection depends on the limits encoded in the submitted order, because a displayed quote does not reserve the pool price until settlement. A swap price limit restricts how far that swap trades. It can stop execution before the requested swap quantity fills. Net settlement limits constrain the complete order's token flows, including the liquidity operations.
A long-form order reverts entirely when its net token flow breaches the applicable settlement quantity limit. A complete revert leaves the included burn and mint without persistent changes. Gas spent executing a failed transaction remains a separate network cost. Flat liquidity calls also support acceptable pool-price bounds, but those fields should not be assumed to describe every combined execution path.
The position's chosen range and the transaction's execution limits have different purposes. One defines ongoing participation; the other bounds acceptable execution.
A Settlement-Limit Failure and a Bounded Retry
For this hypothetical example, assume the pool price lies above the old concentrated position's upper boundary. The selected pool permits its removal, and the proposed replacement uses valid ticks around the quoted price. The owner wants the entire old range removed and a specified positive amount of replacement liquidity created. A maximum additional token debit caps how much of that token the order takes from the wallet. Assume the wallet can cover that permitted debit and any required spending authorization is in place.
On the normal path, execution stays within that debit limit and leaves the pool price inside the replacement range. The included transaction succeeds. The old range's liquidity becomes zero and the liquidity recorded at the new bounds increases by the specified amount. Those state changes establish completion. Future trading fees are a separate outcome, which the transaction receipt cannot establish.
In the edge case, the pool moves before execution. The requested replacement now needs an additional token debit above the encoded limit. The settlement check rejects the complete order. Its receipt reports a revert. The old range remains intact and the replacement mint leaves no persistent position change.
Before retrying, the owner needs a fresh calculation using the changed pool state. A smaller replacement amount may fit the original debit limit. Raising the cap would instead authorize more wallet spending, so it changes the permitted transaction outcome. The new order must still use valid boundaries and satisfy the current removal rules.
If the pool's current configuration blocks removal, a refreshed quote cannot make the burn executable. The relevant restriction must clear before another attempt can move that liquidity. The retry stops once a successful receipt and the updated position records establish the requested removal and replacement; staying in range afterward depends on subsequent pool movement.
Accrued Fees During a Range Change
Accrued concentrated rewards remain economically separate from the range's principal, even when the principal moves out of range. The protocol reinvests these rewards as ambient liquidity, which can continue compounding. A burn accounts for the rewards associated with the liquidity removed. Harvesting only the fees leaves the original range in place. Consequently, removing an inactive range can return both tokens even when its principal consists of only one.
Pool Restrictions on Removing Liquidity
Removing concentrated liquidity can require the position to satisfy a pool-configured minimum resting period, even when its price range is inactive. The burn checks the stored position timestamp against that requirement. Adding liquidity updates the timestamp used by this check. An existing position's history therefore matters when determining whether its collateral is presently available for a range change.
The configured interval is a pool parameter, not a universal waiting time for every deployment. Going out of range does not override it. The replacement mint also records a new timestamp, which affects a later removal if the pool enforces this restriction.
Permissioned pools introduce another condition: their external permission oracle can govern burns, swaps and mints. Each included action must meet its applicable permission requirements. A quote describing collateral amounts does not override those checks. A rejected burn cannot fund the proposed redeployment.
Settlement Balances and Residual Tokens
Collateral settlement determines whether net token flows use wallet balances or surplus collateral held inside the exchange, which affects where any remaining balance appears. Surplus collateral can receive burn proceeds and fund later swaps or mints. A combined order can net the included operations before collecting or paying their remaining token flows. That avoids treating every internal movement as a separate wallet transfer.
A residual balance may reflect collateral the replacement does not use, token precision or an order's dust handling. Long-form settlement can skip a token credit at or below its chosen dust threshold. Debits still require settlement. That skipped credit does not increase a wallet balance or a surplus collateral balance, and it does not automatically add liquidity to the replacement range.
Wallet receipt alone does not measure the replacement's size. Much of the available collateral may remain committed inside the pool.
When Is Full-Range Liquidity an Alternative?
Full-range ambient liquidity is an alternative when maintaining participation across all pool prices matters more than concentrating capital within selected boundaries. It removes the specific need to follow a finite range, while token exposure still changes with trading. Moving capital into ambient liquidity requires funding that liquidity type; widening a concentrated range does not convert its accounting automatically. Knockout liquidity serves directional limit orders and has different post-fill handling.
Execution Costs and Ongoing Range Management
Repositioning incurs the network cost of its transaction and the trading cost of its included swap, so evaluating the adjustment requires both components. Swap fees apply to the converted amount, not automatically to the whole position's value. The selected pool's dynamic fees can change the applicable conversion charge. Price impact affects the tokens obtained through trading and remains distinct from the fee itself.
A wider replacement interval reduces concentration while covering more prices. A narrow interval can become inactive again after a smaller move away from its execution price. Neither choice establishes future trading volume, fee income or a profitable adjustment. Repeated conversions also change the holdings used to compare the position with leaving the original assets untouched.
If the pool price returns to the old interval, its concentrated principal can participate again without a range change. Moving to a different interval requires the available collateral to fund it and the pool's current rules to permit removal.
Everyday questions about Ambient
Can I Reposition Only Part of a Concentrated Position?
Ordinary concentrated positions permit partial removal, so a range adjustment can leave some liquidity at the old boundaries. Off-grid positions marked atomic prohibit partial burns and require complete removal. The combined adjustment must respect that position flag and the pool's removal conditions. Support for building a partial adjustment also depends on the interface used.
Will Minting Into an Existing Range Overwrite Its Liquidity?
Minting into an ordinary existing range adds to its liquidity when the owner, pool and tick boundaries match. The protocol combines the added amount with the position's existing liquidity and adjusts its reward accounting. Moving into boundaries already held by the same owner can therefore enlarge that record rather than create a separate position.
Does Adding Collateral to the Old Range Make It Active Again?
Adding collateral at unchanged boundaries does not reactivate the principal while the pool price remains outside that interval. The additional liquidity shares the same participation limits. It also updates the position timestamp used by the minimum resting-period check, which can affect the availability of a subsequent burn.
How Can I Return to an Earlier Range After Repositioning?
Returning to a previous range requires another liquidity adjustment under the pool conditions prevailing at that time. The earlier swap has changed token holdings, and another conversion may incur further fees and price impact. Returning to the previous boundaries does not refund the first transaction's costs or reconstruct the original deposit amounts.
Can I Reposition a Fully Filled Knockout Position Like an Ordinary Range?
A fully filled knockout position requires claim or recovery handling before its proceeds can fund new liquidity. It has already left the active curve. Claiming retrieves the converted collateral and accumulated rewards. Recovery retrieves the converted collateral and forfeits the accumulated fees. Creating a new concentrated range does not reactivate the filled order.
Why Do Raw Contract Prices Differ From the Prices Used to Select a Range?
Contract prices encode the square root of the raw-token exchange rate in Q64.64 format. They do not normalize for token decimals. Pair ordering also follows token addresses, which may differ from the displayed orientation. Range calculations must convert the intended displayed prices into the contract's price and tick conventions.
Is Another Token Approval Required for Every Range Change?
A new approval is unnecessary when an existing allowance covers the ERC-20 wallet debit or settlement uses sufficient surplus collateral. Receiving burn proceeds does not require approval. Any additional wallet-funded ERC-20 debit needs the appropriate spending authorization; the amount removed from the old position alone does not determine that requirement.
Does an Out-of-Range Position Automatically Follow the Pool Price?
Pool price movement does not automatically move a standard concentrated position's boundaries. It changes whether the existing liquidity participates and can change its token composition. Repositioning requires an executed liquidity-management transaction. An out-of-range indicator describes the position's current relationship to the pool price, rather than an instruction already executed.
Updated ·