Swapper sur CPMM - Powfi Docs

1. Charger le SDK et récupérer le pool

import { Powfi, CpmmModule, PoolNotFoundError } from '@alephium/powfi-sdk'
import { ALPH_TOKEN_ID } from '@alephium/web3'

const powfi = Powfi.load({ networkId: 'mainnet', signer })
const tokenIn = ALPH_TOKEN_ID
const tokenOut = '<token id>'

let pool
try {
  pool = await powfi.cpmm.getPoolState(tokenIn, tokenOut)
} catch (e) {
  if (e instanceof PoolNotFoundError) throw new Error('No CPMM pool for this pair')
  throw e
}

2. Coter (hors ligne)

Entrée exacte
Sortie exacte

const quote = CpmmModule.computeSwapAmount({
  state: pool,
  tokenInId: tokenIn,
  tokenOutId: tokenOut,
  amountIn: 5n * 10n ** 18n, // sell exactly 5 ALPH
  slippageBps: 50n
})

quote.tokenOutAmount        // expected output
quote.minimalTokenOutAmount // guaranteed minimum
quote.priceImpact           // percent

const quote = CpmmModule.computeSwapAmount({
  state: pool,
  tokenInId: tokenIn,
  tokenOutId: tokenOut,
  amountOut: 100n * 10n ** 6n, // buy exactly 100 units of a 6-decimal token
  slippageBps: 50n
})

quote.tokenInAmount        // expected input
quote.maximalTokenInAmount // worst-case input

Affichez le prix d’exécution à partir des montants bruts et des décimales :

import Decimal from 'decimal.js'
import { NumericUtils } from '@alephium/powfi-sdk'

const inHuman = NumericUtils.scaleDecimal(quote.tokenInAmount, quote.tokenInInfo.decimals)
const outHuman = NumericUtils.scaleDecimal(quote.tokenOutAmount, quote.tokenOutInfo.decimals)
const price = outHuman.div(inHuman) // tokenOut per tokenIn

3. Exécuter

const { address } = await signer.getSelectedAccount()

// Optional: pre-check balances to fail fast with a readable error
const bal = await powfi.nodeProvider.addresses.getAddressesAddressBalance(address)
const balances = new Map<string, bigint>([[ALPH_TOKEN_ID, BigInt(bal.balance)]])
for (const t of bal.tokenBalances ?? []) balances.set(t.id, BigInt(t.amount))

const result = await powfi.cpmm.swap(
  {
    tokenInId: tokenIn,
    tokenOutId: tokenOut,
    amountIn: 5n * 10n ** 18n,
    slippageBps: 50n,
    sender: address,
    ttlMinutes: 10
  },
  balances
)
console.log(result.txId)

swap recharge l’état du pool et recalcule la cotation avant de signer : le minimum imposé repose donc sur l’état au moment de l’envoi, et non sur celui que vous avez affiché.

Le contrôle du solde ALPH ne porte que sur l’entrée du swap. La transaction a aussi besoin de quelques DUST_AMOUNT d’ALPH pour les sorties, plus le gas. Gardez de la marge lorsque le jeton d’entrée est l’ALPH.

4. Gérer les erreurs

Erreur	Message à afficher
`PriceImpactTooHighError`	« Impact de prix supérieur à 5 %. Réduisez le montant. »
`InsufficientBalanceError`	Le message contient déjà les montants requis et disponibles.
`InsufficientLiquidityError`	Le montant en sortie exacte dépasse la réserve du pool.
Erreur du nœud mentionnant le routeur	Slippage ou échéance atteint. Recotez.

Amener le prix à une cible

Pour l’arbitrage ou le rééquilibrage, swapTo calcule le trade qui amène le pool à un prix cible (token1 par token0 dans l’ordre trié, en unités lisibles) :

await powfi.cpmm.swapTo({ tokenA: tokenIn, tokenB: tokenOut, targetPrice: 0.052, sender: address, slippageBps: 30n })

swapTo ignore la protection d’impact de prix de 5 %.