Decreasing liquidity

​

In the app

​

Remove funds

1. Open Pools, then select the pool. Under Your Positions, select Manage in the position’s row, then Decrease. The panel on the right switches to Decrease with Position loaded showing the position’s ID and range.
2. Check Withdrawal Address. The funds will go there, which is not always the connected wallet.
3. Select 25%, 50%, 75%, or 100%, or enter a percentage.
4. Select the button, which names the amount, such as Decrease 25%.
5. In Review decrease, check the two Receive amounts and the Remaining position range. A line under the amounts notes any position funds already waiting that will be collected at the same time.

6. Select Confirm.
7. In the Transaction request in Shield Wallet, check that the request is from swap.shield.fi and that the estimated amounts match, then select Confirm.

​

Troubleshooting

​

Next steps

• Collecting and burning to collect position funds and understand what closes a position.
• Increasing liquidity to add funds back at the same range.

​

Decrease and read what is owed

import { formatUnits } from "@provablehq/shield-swap-sdk"

const positions = await client.getOwnedPositions()
const position = positions.find((p) => p.positionTokenId === POSITION_TOKEN_ID)
if (!position?.state) throw new Error("position not ready or not owned by this account")

const [token0, token1] = await Promise.all([
  client.tokenData(position.token0Id),
  client.tokenData(position.token1Id),
])

const onchain = await client.getPosition({ positionTokenId: position.positionTokenId })
if (!onchain || onchain.liquidity === 0n) throw new Error("position holds no liquidity")

const result = await client.decreaseLiquidity({
  poolKey: position.poolKey,
  positionTokenId: position.positionTokenId,
  liquidityToRemove: onchain.liquidity / 2n,
})

console.log(`submitted ${result.transactionId}`)
const updated = await waitForPosition(
  result.transactionId, position.positionTokenId, position.record.tag,
)
if (updated.state.liquidity >= onchain.liquidity) throw new Error("decrease not reflected in state")
console.log(`owed ${formatUnits(updated.state.tokensOwed0, token0.decimals)} ${token0.symbol}`)
console.log(`     ${formatUnits(updated.state.tokensOwed1, token1.decimals)} ${token1.symbol}`)

position = dex.get_owned_position(POSITION_TOKEN_ID)
if position is None or position.state is None or position.state.liquidity == 0:
    raise ValueError("position not ready or has no liquidity")

result = dex.decrease_liquidity(
    pool_key=position.pool_key,
    position_record=position.record,
    liquidity_to_remove=position.state.liquidity // 2,
).delegate(wait=True)

print(result.transaction_id)

updated = wait_for_position(position.position_token_id, position.record)
state = read_position_state(updated.position_token_id)
print(state["tokens_owed0"], state["tokens_owed1"])

shield-swap positions --network mainnet

shield-swap liquidity --position POSITION_TOKEN_ID --decrease --percent 50 --network mainnet
shield-swap liquidity --position POSITION_TOKEN_ID --decrease --percent 50 --network mainnet --execute

​

How it works on chain

​

What changes

​

How fees and principal settle

1. The contract calculates the principal for the liquidity you remove, using the current square-root price and your fixed range.
2. It settles pending fees using your full liquidity before the reduction, including the portion you keep. Those fees and the withdrawn principal are added to the existing owed balances.
3. It records the reduced liquidity and advances the fee checkpoints. Later fee growth applies to the remaining liquidity.

​

After a full decrease

​

Next steps

• Collecting and burning to pay out the owed balance and close the position.
• Increasing liquidity to add funds back at the same range.