Ouvrir et gérer une position CLMM

Charger le pool et le palier de frais

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

Choisir une plage

Convertissez les prix lisibles (token1 par token0) en ticks alignés sur l’espacement du palier :

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

Pour une position sur toute la plage, utilisez TickUtils.getMinPriceFromTick et getMaxPriceFromTick, qui renvoient les ticks extrêmes alignés sur l’espacement.

Dimensionner le dépôt

À partir du montant d’un jeton, calculez le montant correspondant de l’autre au prix actuel :

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
)

Si le prix actuel est en dehors de la plage, la position est à un seul côté : seul du token0 est nécessaire (prix égal ou inférieur à tickLower), ou seul du token1 (prix au-dessus de la plage).

Ajouter de la liquidité

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
})

Conservez le positionId renvoyé : les étapes suivantes l’utilisent pour lire la position, collecter et retirer. Pour compléter la même plage plus tard, passez existingPosition: true : le SDK joint alors le jeton de position.

Suivre les frais et la valeur

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 contient les frais déjà crédités à la position (token0, token1, récompense). La vue positionInfo du pool (powfi.clmm.positionInfo) renvoie aussi les montants de jetons et les frais actuels. Voir la référence CLMM.Pour valoriser la position, passez -liquidity, le sqrtPriceX96 actuel et les bornes de la plage à ClmmLiquidityUtils.getAmountsForLiquidity.

Collecter les frais

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

Retirer

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 collecte aussi dans la même transaction : les jetons retirés ainsi que les frais et récompenses accumulés sont envoyés à votre adresse, sans appel séparé à collectTokens.

Créer un nouveau pool

N’importe qui peut créer un pool CLMM : il n’existe on-chain aucune liste blanche de créateurs ni de jetons. Avant d’en créer un, notez que :

Seuls les paliers de frais existants sont utilisables. Un pool est créé dans un palier de frais (configIndex) déjà mis en place par l’équipe Powfi. Vous ne pouvez pas choisir vos propres frais ni votre espacement de ticks. Listez les paliers disponibles avec getAllPoolConfigs().
Un seul pool par paire de jetons et par palier. L’adresse du pool est dérivée de la paire et du palier : la création échoue si ce pool existe déjà.
Le créateur fixe le prix initial. Le tick que vous passez devient le prix de départ du pool, et votre première position est mintée à ce prix. S’il est loin du prix du marché, des arbitragistes échangeront immédiatement contre votre position.
Les deux jetons doivent figurer dans la liste de jetons. Le contrat accepte n’importe quel jeton, mais getPoolState et les méthodes associées du SDK lèvent une erreur pour les jetons absents de la liste de jetons.

Si poolExists(token0, token1, configIndex) renvoie false, créez le pool et la première position en un seul appel :

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

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

Pour calculer vous-même un ID de position (par exemple pour vérifier qu’un portefeuille détient déjà une plage avant d’ajouter), ne passez pas une adresse sans groupe telle quelle : l’ID obtenu serait faux. Normalisez-la d’abord avec normalizeAddress(address, powfi.clmm.getClmmConfig().groupIndex), ou utilisez PoolUtils.getPositionId(poolAddress, owner, ...), qui normalise pour vous.

SDK et API

Concepts clés

Modules

Utilitaires

Guides

Référence

Ouvrir et gérer une position CLMM

Créer un nouveau pool

​Créer un nouveau pool

Créer un nouveau pool