Erreurs

Toutes les erreurs typées héritent de PowfiSDKError, qui hérite de Error. Importez-les depuis la racine du package et distinguez-les avec instanceof :

import {
  PowfiSDKError,
  PoolNotFoundError,
  PriceImpactTooHighError,
  InsufficientBalanceError,
  InsufficientLiquidityError
} from '@alephium/powfi-sdk'

try {
  await powfi.cpmm.swap(req, balances)
} catch (e) {
  if (e instanceof PriceImpactTooHighError) showWarning(e.message)
  else if (e instanceof InsufficientBalanceError) showTopUp(e.message)
  else if (e instanceof PoolNotFoundError) showCreatePool()
  else throw e
}

Erreurs typées

Erreur	Levée par	Message
`PoolNotFoundError`	`cpmm.getPoolState`, `clmm.getPoolState`, `clmm.getPoolTokenBalances`, `clmm.findBestRoute`	`Pool does not exist for <poolId>`
`PriceImpactTooHighError`	`cpmm.swap` quand `priceImpact >= 5`	`Price impact too high: 6.12% > 5%`
`InsufficientBalanceError`	`cpmm.swap`, `cpmm.addLiquidity` quand vous passez une map `balances`	`Not enough <SYMBOL> balance. Required: …, Available: …`
`InsufficientLiquidityError`	`CpmmModule.getAmountIn` (sortie ≥ réserve), `getInitLiquidityDetails` (liquidité initiale ≤ `MINIMUM_LIQUIDITY`)	`Insufficient liquidity` / personnalisé
`TokenListFetchError`	`token.fetchTokens` (encapsulée, voir ci-dessous)	`Failed to fetch token list from <url> (status 404)`

TokenListFetchError expose status?: number et l’erreur d’origine dans cause.

Certaines méthodes des modules interceptent les erreurs et les relèvent sous forme de Error simple avec un message combiné (via logAndThrowError), par exemple Failed to fetch pool state on <id>, <message d'origine>. C’est le cas de TokenModule.getTokens() et fetchTokens() : le texte de TokenListFetchError apparaît dans le message, mais l’objet levé est une Error. Comparez le message si vous devez les distinguer.

Erreurs de validation (`Error` simple)

Message	Cause
`Signer not set`	Une méthode d’écriture a été appelée sur une instance chargée sans `signer`.
`Network <id> not found`	`networkId` inconnu.
`Either amountIn or amountOut must be specified`	Cotation CPMM sans aucun des deux montants.
`Slippage must satisfy 0 <= slippage < 10000, received …`	`slippageBps` invalide pour le CPMM.
`slippageBps must be in [0, 10000)`	Slippage invalide pour le CLMM.
`Unknown tokenInId … for pool …`	Le jeton ne fait pas partie de l’état de pool passé.
`Unknown token, id not found in token list: …`	Jeton absent de la liste de jetons (la lecture de l’état d’un pool exige que tous ses jetons soient listés).
`fee and feeRecipient must be provided together` (et autres messages sur les frais)	Frais d’intégrateur invalides.
`<Stake/Unstake/Claim> amount must be greater than zero`	Montant de staking non positif.
`TickOutOfBounds: <tick>` / `SqrtPriceX96OutOfBounds`	Tick hors de `[MIN_TICK, MAX_TICK]` ou prix hors de la plage représentable.

Erreurs on-chain

Si une transaction passe la validation du SDK mais échoue dans le contrat (slippage dépassé, échéance passée, limite de prix violée), le nœud la rejette à la signature et @alephium/web3 lève une erreur contenant le code d’erreur de la VM, par exemple Error Code: 501 quand un swap CLMM atteint sa limite de prix avant d’être entièrement exécuté (106 si la limite est du mauvais côté du prix). Causes les plus fréquentes :

Slippage ou échéance : le pool a bougé entre la cotation et la soumission. Recotez et réessayez.
ALPH insuffisant pour le dust ou les dépôts : voir Dépôts ALPH et dust.
Mauvaise direction ou limite de prix sur swapTo CLMM : le prix cible est déjà de l’autre côté du prix actuel.

SDK et API

Concepts clés

Modules

Utilitaires

Guides

Référence

Erreurs typées

Erreurs de validation (`Error` simple)

Erreurs on-chain

​Erreurs typées

​Erreurs de validation (Error simple)

​Erreurs on-chain

Erreurs typées

Erreurs de validation (`Error` simple)

Erreurs on-chain