Swapper sur CLMM

1. Choisir le pool

Une paire peut avoir un pool par palier de frais. Utilisez le plus profond :

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

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

const configIndex = await powfi.clmm.findBestRoute(tokenIn, tokenOut)
const poolId = powfi.clmm.getPoolId(tokenIn, tokenOut, configIndex)
const state = await powfi.clmm.getPoolState(poolId)

2. Déterminer la direction

La direction se définit sur la paire triée : vendre token0 correspond à zeroForOne = true.

const [token0, token1] = sortTokens(tokenIn, tokenOut)
const zeroForOne = tokenIn === token0

3. Simuler et coter

Entrée exacte
Sortie exacte

const amountIn = 10n * 10n ** 18n

const sim = await powfi.clmm.simulateSwap({ configIndex, token0, token1, zeroForOne, amount: amountIn })
const amountOut = -PoolUtils.offlineSwap(sim, amountIn, sim.sqrtPriceX96)

const wantOut = 500n * 10n ** 6n
const amount = -wantOut // negative = exact-out

const sim = await powfi.clmm.simulateSwap({ configIndex, token0, token1, zeroForOne, amount })
const raw = PoolUtils.offlineSwap(sim, amount, sim.sqrtPriceX96)
const estimatedIn = raw < 0n ? -raw : raw

simulateSwap fait un seul appel au nœud et renvoie la courbe de liquidité tick par tick. offlineSwap la rejoue localement : vous pouvez donc recoter des montants proches sans nouvel aller-retour, tant que le montant ne dépasse pas la dernière ligne simulée. Prix avant et après :

const d0 = state.token0Info.decimals, d1 = state.token1Info.decimals
const priceBefore = TickUtils.sqrtPriceX96ToPrice(state.sqrtPriceX96, d0, d1) // token1 per token0

4. Exécuter

Dans ClmmSwapRequest, token0 / token1 signifient entrée / sortie, et non l’ordre trié.

Entrée exacte
Sortie exacte

const result = await powfi.clmm.swap({
  token0: tokenIn,
  token1: tokenOut,
  amount: amountIn,   // positive
  amountIn,           // attach exactly this much
  slippage: 50n,      // 0.5% price movement allowed
  routePlan: [configIndex]
})

const slippage = 50n
const result = await powfi.clmm.swap({
  token0: tokenIn,
  token1: tokenOut,
  amount: -wantOut,                                     // negative
  amountIn: estimatedIn + (estimatedIn * slippage) / 10_000n, // max input to attach
  slippage,
  routePlan: [configIndex]
})

Le slippage devient un sqrtPriceLimitX96 : le swap échoue si l’exécution du montant complet devait faire bouger le prix au-delà de la tolérance. Voir CLMM : slippage sur le prix.

clmm.swap() exige une exécution complète. Si la limite de prix est atteinte avant que tout le amount soit échangé, la transaction échoue avec l’erreur de contrat 501 et aucun token ne bouge. Réessayez avec un slippage plus élevé ou un montant plus petit. (swapTo() est différent : il s’arrête au prix cible et peut être exécuté partiellement, par conception.)

Cotations multi-sauts

Pour coter A → B → C sur deux pools du même palier de frais, enchaînez les simulations. La sortie du premier saut devient le montant en entrée exacte du second :

const q1 = await powfi.clmm.simulateSwap({ configIndex, token0: A, token1: B, zeroForOne: A < B, amount })
const out1 = -PoolUtils.offlineSwap(q1, amount, q1.sqrtPriceX96)

const q2 = await powfi.clmm.simulateSwap({ configIndex, token0: B, token1: C, zeroForOne: B < C, amount: out1 })
const out2 = -PoolUtils.offlineSwap(q2, out1, q2.sqrtPriceX96)

Pour simuler tout le chemin en un seul appel, passez data: powfi.clmm.buildSwapPath(C, configIndex) et l’adresse du second pool dans interestedContracts. clmm.swap() n’exécute que des swaps sur un seul pool. Pour exécuter un swap multi-sauts, appelez le script SwapWithoutAccount de ClmmScripts avec le même data.

Swapper jusqu’à un prix cible

const target = TickUtils.priceToSqrtPriceX96(0.051, d0, d1)
await powfi.clmm.swapTo({ tokenIn, tokenOut, configIndex, targetSqrtPriceX96: target, amountInMax })

La cible doit être du bon côté : vendre du token0 fait baisser le prix, vendre du token1 le fait monter.

SDK et API

Concepts clés

Modules

Utilitaires

Guides

Référence

1. Choisir le pool

2. Déterminer la direction

3. Simuler et coter

4. Exécuter

Cotations multi-sauts

Swapper jusqu’à un prix cible

​1. Choisir le pool

​2. Déterminer la direction

​3. Simuler et coter

​4. Exécuter

​Cotations multi-sauts

​Swapper jusqu’à un prix cible

1. Choisir le pool

2. Déterminer la direction

3. Simuler et coter

4. Exécuter

Cotations multi-sauts

Swapper jusqu’à un prix cible