Open & manage a CLMM position

Load the pool and fee tier

import { Powfi, TickUtils, ClmmLiquidityUtils, sortTokens, UNLIMITED_AMOUNT } from '@alephium/powfi-sdk'

const powfi = Powfi.load({ networkId: 'mainnet', signer })
const { address } = await signer.getSelectedAccount()

const [token0, token1] = sortTokens(tokenA, tokenB)
const configIndex = 0n
const config = (await powfi.clmm.getPoolConfig(configIndex))!
const poolId = powfi.clmm.getPoolId(token0, token1, configIndex)
const state = await powfi.clmm.getPoolState(poolId)
const d0 = state.token0Info.decimals, d1 = state.token1Info.decimals

Choose a range

Convert human prices (token1 per token0) to ticks aligned to the tier’s spacing:

const tickLower = TickUtils.getAlignedTick(0.04, d0, d1, config.tickSpacing)
const tickUpper = TickUtils.getAlignedTick(0.06, d0, d1, config.tickSpacing)

For a full-range position, use TickUtils.getMinPriceFromTick and getMaxPriceFromTick, which return spacing-aligned extreme ticks.

Size the deposit

Given the amount of one token, compute the matching amount of the other at the current price:

const [amount0, amount1, liquidity] = ClmmLiquidityUtils.getAmountsAndLiquidityAtSqrtPrice(
  state.sqrtPriceX96,
  TickUtils.getSqrtRatioAtTick(tickLower),
  TickUtils.getSqrtRatioAtTick(tickUpper),
  1_000n * 10n ** BigInt(d0), // user typed 1000 token0
  UNLIMITED_AMOUNT            // token1 side follows
)

If the current price is outside the range, the position is single-sided: only token0 (price at or below tickLower) or only token1 (price above the range) is needed.

Add liquidity

const { positionId, result } = await powfi.clmm.addLiquidity({
  token0, token1, configIndex,
  tickLower, tickUpper,
  amount0, amount1,
  slippage: 100n,             // 1% price tolerance
  existingPosition: false     // true when topping up a position you already hold
})

Keep the returned positionId: the next steps use it to read, collect from, and withdraw the position. To top up the same range later, pass existingPosition: true, which attaches the position token.

Monitor fees and value

import { ClmmContracts } from '@alephium/powfi-sdk'
import { addressFromContractId } from '@alephium/web3'

const pos = await ClmmContracts.Position.at(addressFromContractId(positionId)).fetchState()
const { liquidity, tokensOwed } = pos.fields

tokensOwed holds fees that are already credited to the position (token0, token1, reward). The pool’s positionInfo view (powfi.clmm.positionInfo) also returns current token amounts and fees. See the CLMM reference.To value the position, pass -liquidity to ClmmLiquidityUtils.getAmountsForLiquidity with the current sqrtPriceX96 and the range bounds.

Collect fees

await powfi.clmm.collectTokens({
  token0, token1, configIndex,
  owner: address, recipient: address,
  tickLower, tickUpper,
  amount0Max: UNLIMITED_AMOUNT,
  amount1Max: UNLIMITED_AMOUNT
})

Withdraw

const remove = (liquidity * 50n) / 100n // 50%

await powfi.clmm.removeLiquidity({
  token0, token1, configIndex,
  owner: address,
  tickLower, tickUpper,
  liquidity: remove,
  base: 'token0',
  baseAmount: 0n,       // min token0
  otherAmountMax: 0n    // min token1 (acts as a minimum)
})

removeLiquidity also collects in the same transaction: the withdrawn tokens and any accrued fees and rewards go to your address, so no separate collectTokens call is needed.

Creating a new pool

Anyone can create a CLMM pool. There is no allowlist of creators or tokens on-chain. Before you create one, note:

Only existing fee tiers can be used. Pools are created under a fee tier (configIndex) that the Powfi team has already set up. You can’t choose your own fee or tick spacing. List the available tiers with getAllPoolConfigs().
One pool per token pair and fee tier. The pool address is derived from the pair and the tier, so creation fails if that pool already exists.
The creator sets the initial price. The tick you pass becomes the pool’s starting price, and your first position is minted at that price. If it’s far from the market price, arbitrageurs will trade against your position right away.
Both tokens should be in the token list. The contract accepts any token, but the SDK’s getPoolState and related methods throw for tokens that aren’t in the token list.

If poolExists(token0, token1, configIndex) is false, create the pool and seed the first position in one call:

const initialTick = TickUtils.getAlignedTick(0.05, d0, d1, config.tickSpacing)

const { poolId } = await powfi.clmm.createPool(
  configIndex, token0, token1,
  initialTick,
  amount0, amount1,
  tickLower, tickUpper
)

To compute a position ID yourself (for example, to check whether a wallet already holds a range before adding), don’t pass a groupless address as-is: it gives the wrong ID. Normalize it first with normalizeAddress(address, powfi.clmm.getClmmConfig().groupIndex), or use PoolUtils.getPositionId(poolAddress, owner, ...), which normalizes for you.

SDK & API

Core concepts

Modules

Utilities

Guides

Reference

Open & manage a CLMM position

Creating a new pool

​Creating a new pool

Creating a new pool