Liquidswap pool choices determine swap execution, fee accrual and liquidity exits on Aptos
Updated on
Liquidswap choices affect both execution and exit. A V0.5 curve pool issues LP coins for a proportional claim, while V1 splits liquidity across price bins and issues LB tokens for those bins. Before signing, compare the pool family, quoted output and position token you must later redeem. A completed swap cannot be canceled; exiting a liquidity position requires another Aptos transaction.
A favorable quote is only one part of the choice. The chosen contract, price model and withdrawal conditions must also leave a clear route back to wallet balances.
The short version: Compare the pool family and position token before a deposit, then check minimum outputs before a withdrawal; swapping back after a completed trade requires a new transaction.
Curve pools and liquidity book pools create different commitments
V0.5 and V1 expose different pricing structures and position records. Both support swaps and supplied liquidity, but they do not package a provider’s claim in the same way. The distinction follows the position from deposit through fee accrual to withdrawal.
A V0.5 pool uses a curve selected for the relationship between its assets. Uncorrelated assets use the standard curve model, while correlated assets can use a stable-swap curve. A provider deposits both sides and receives LP coins representing a proportional share of the pool. Redeeming those coins returns the corresponding share of the reserves at withdrawal time.
V1 uses a liquidity book. Liquidity sits in bins representing discrete price levels, with an active bin marking the price used at that moment. A provider chooses where to place liquidity instead of owning one undivided share across the full curve. That placement determines when swaps can use the position and therefore when it can earn fees.
This difference changes the exit question. V0.5 asks how much of a proportional pool claim to redeem. V1 asks which LB tokens to burn, which bins they represent and whether the resulting amounts satisfy the transaction’s minimum outputs. A familiar asset pair does not make those position types interchangeable.
What changes when you choose a V1 bin step?
The bin step sets the spacing between adjacent price bins, so it changes how finely V1 divides the price range. The same pair can have distinct pools with different bin steps. Choosing between them means comparing their spacing, liquidity distribution and active-bin state rather than comparing asset symbols alone.
In V1, the bin step is measured in basis points and sets the price increment between adjacent bins. A smaller step creates more closely spaced price levels. A larger step leaves wider gaps between those levels. Neither choice guarantees better execution because available liquidity and the number of bins a swap crosses also matter.
For a provider, the bin step becomes part of the position identity. It affects the bins selected for deposit and the LB tokens received afterward. For a trader, it helps distinguish pools which otherwise appear to contain the same two assets. The quoted output remains the practical comparison because it reflects the selected pool’s state for that proposed transaction.
Quotes set the boundary for a swap
A quote describes an available exchange under the pool state read before submission. It is not a reservation. Another transaction may move the active price or consume liquidity before the signed payload executes, changing the available output.
An exact-input swap fixes what leaves the wallet and supplies a minimum acceptable output. The transaction aborts if execution would return less. An exact-output route instead targets a specified output and can return input left over after satisfying it. These routes answer different questions, so their limits should not be compared as though they were the same field.
The wallet confirmation should match the intended assets, direction, contract family and limit. A favorable screen estimate does not replace the encoded minimum. Once a swap succeeds, the original exchange is final. Swapping back is a separate trade under the later pool state, with another quote, fee and Aptos transaction.
Position tokens determine what can be withdrawn
The asset proving ownership of a liquidity position is also the key to its exit. V0.5 LP coins represent a share of a curve pool and are needed to redeem that share. V1 LB tokens describe liquidity at particular bins within a particular pool.
Each V1 pool has its own position-token collection. An LB token records a bin ID and an amount representing the holder’s share of liquidity in that bin. The tokens are fungible within their defined position, so a holder can transfer all or part of the represented share. Transferring a token moves the claim; it does not withdraw the underlying assets.
Names and symbols are weak evidence because unrelated assets can display similar labels. The pool identity, asset types, bin step, collection and bin ID provide the stronger match. If a wallet interface does not display a position, the current on-chain token balance and transaction history show whether the position still exists.
Withdrawal minimums make the exit conditional
Removing V1 liquidity burns the selected LB tokens and returns the redeemed amounts of both pool assets. The removal call can specify minimum amounts for each side. If either result falls below its minimum, the transaction reverts instead of completing with smaller proceeds.
The returned mix may differ from the original deposit. Trading can move the active bin and change which asset occupies the bins represented by the position. Accumulated fees are collected with the redeemed liquidity, but a bin earns those fees only when swaps actually use its liquidity.
V0.5 follows a different accounting path. Burning LP coins releases the holder’s proportional share of the pool’s current reserves. Changes in the reserve ratio can therefore change the two amounts returned. In either version, an exit is a new state transition, not an undo button for the original deposit.
An exit-first checklist preserves the option to stop
A reader comparing supported pools for the same asset pair can start with the evidence required at withdrawal. This keeps the choice tied to a recoverable position rather than to a temporary display estimate.
Use this short decision checklist before authorizing a liquidity deposit:
- Confirm the wallet is on Aptos and match the complete asset identifiers.
- Record whether the position belongs to a V0.5 curve pool or a V1 liquidity-book pool.
- For V1, match the pool, bin step, selected bins and active-bin tolerance.
- Check the minimum accepted amounts encoded for the deposit, then set separate minimum outputs when you later remove liquidity.
- Keep enough APT outside the position to submit a withdrawal transaction.
If the deposit succeeds, the wallet receives the expected LP coins or LB tokens. The transaction status and resulting token balance independently confirm the new position. A later removal burns the chosen position tokens and returns assets only when its output conditions pass.
If the active bin or expected amounts move beyond an encoded limit before execution, the transaction aborts rather than creating the position on different terms. A fresh quote can be reviewed, but widening a limit is a new decision. Until a transaction succeeds, you can stop without holding a liquidity position.
How can a failed exit be diagnosed?
First check whether the wallet submitted the payload, then inspect its Aptos transaction status. If the wallet never submitted the payload, no on-chain exit occurred. If the transaction aborted, its recorded failure can identify a minimum-output check, incorrect pool input or another contract condition.
Next, match the position token to the intended contract family. A V0.5 withdrawal needs the applicable LP coins, while V1 removal needs LB tokens from the relevant pool and bins. Confirm the wallet still controls them and has enough APT for network gas. Retrying with unchanged parameters will fail again if the current output remains below the minimums.
A successful transaction with an outdated interface display needs a different check. Review the returned asset balances, the position-token balance and the transaction events. If LB tokens were burned only in part, the remaining amount still represents the unredeemed share. That state is evidence of a partial exit rather than a failed full withdrawal.
On-chain records outlast the wallet prompt
A wallet prompt shows a proposed action, while the Aptos record shows what executed. For a swap, useful evidence includes the transaction status, input balance change and received output. For a liquidity deposit, the position token and mint event establish the resulting claim. Removal produces its own burn event and asset transfers.
Finding a transaction by its hash confirms it was recorded, but not whether its result matches your intention. Compare its contract call and asset changes with the signed limits. This check matters when an interface caches an old position, groups several bins together or delays updating the displayed balance.
Check the current position record before taking another action that depends on it. A later transfer of LB tokens changes which account controls the claim. A later burn reduces or closes it. Those changes are visible independently of the interface used to initiate them.
Compare each path at the contract boundary
Choose between supported paths by matching the intended price model to the exit evidence you can retain. V0.5 provides a proportional curve-pool claim, while V1 assigns liquidity to bins and permits finer control over which position shares move or burn. Before signing, identify the encoded limits and the token needed for withdrawal. After execution, confirm the resulting state through the Aptos record and either the V0.5 LP coin or V1 LB tokens.
Liquidswap: reader questions
Why can adding V1 liquidity leave coins in the wallet?
A V1 deposit can return leftovers when the specified coin amounts cannot all be placed across the selected bins under the execution conditions. The contract mints LB tokens for the liquidity it accepts and returns unused coins. Check both the resulting LB tokens and wallet balances instead of assuming every submitted coin entered the position.
Does every bin in a V1 position earn each swap fee?
No. A bin earns fees when a swap uses liquidity from that bin. Liquidity placed away from the traded price can remain unused and earn nothing from a transaction crossing other bins. The position’s displayed size therefore does not prove all of it participated. Collected fees become available with the liquidity redeemed from the used bins.
How does a pool identifier help distinguish LB tokens?
A pool identifier ties an LB token collection to a specific V1 pool, while the token’s bin ID identifies the price bin represented by that token. This matters because symbols alone can be duplicated or resemble one another. Match the collection, pool, asset types, bin step and bin ID before treating a token as withdrawal authority.
Is a reverse swap the same as canceling the original trade?
No. A successful Aptos swap cannot be canceled by submitting the opposite direction. A reverse swap is a new transaction evaluated against the pool’s later liquidity, active price and fee state. Its output can differ from the original input. You can abandon the first proposal before submission. After submission, its outcome depends on Aptos execution.
What network balance is required to remove a position?
The wallet needs enough APT to pay the Aptos network fee for the removal transaction. The liquidity position itself does not substitute for that gas balance before execution. Keeping some APT outside the pool preserves the ability to submit the burn or withdrawal call even when the position contains other assets.
Can V1 liquidity be removed after expected outputs change?
Yes, provided the removal’s current output satisfies the minimum amounts encoded for both assets. If either amount would fall below its minimum, the call reverts. The holder can review the updated position and choose new limits in a separate proposal, but that change should reflect the output now acceptable rather than an automatic retry.
Are V0.5 LP coins and V1 LB tokens interchangeable withdrawal proofs?
No. V0.5 LP coins represent a proportional claim on a curve pool, while V1 LB tokens represent shares of liquidity in specified bins of a liquidity-book pool. Each contract family expects its own position assets during withdrawal. Holding one type does not authorize redemption from the other version or from a different pool.