Codes d'erreur - Raydium Docs

Cette page est traduite automatiquement par IA. La version anglaise fait foi.Voir la version anglaise →

Source de vérité. Les tableaux ci-dessous sont régénérés à partir du fichier error.rs de chaque programme dans les dépôts publics Raydium. Lorsqu’un programme est mis à niveau et qu’une nouvelle variante est ajoutée, réexécutez l’extraction (lien en bas de chaque tableau) et ajoutez au tableau plutôt que de le réorganiser — les codes d’erreur Anchor sont assignés par ordre source, pas par nom, donc réorganiser casse la gestion des erreurs des intégrateurs.

Fonctionnement des codes d’erreur Anchor

Anchor assigne à chaque variante de l’énumération ErrorCode d’un programme un code numérique commençant à 6000. Une transaction échouée affiche :

Code d’erreur numérique (par ex. 0x1771 = 6001) dans les logs de la transaction.
Nom de l’erreur (par ex. InvalidOwner) depuis l’IDL.
Chaîne #[msg(...)] qu’Anchor a émise dans log_messages.

Les intégrateurs doivent faire correspondre le code numérique, pas la chaîne de message (la chaîne peut être reformulée sans augmenter une version).

// Exemple : détecter l'erreur de slippage CPMM et afficher un message UX propre.
const CPMM_EXCEEDED_SLIPPAGE = 6005;

try {
  await sdk.cpmm.swap({ ... });
} catch (err: any) {
  const code = err?.error?.errorCode?.number ?? err?.code;
  if (code === CPMM_EXCEEDED_SLIPPAGE) {
    showToast("Price moved past your slippage tolerance. Increase slippage or retry.");
    return;
  }
  throw err;
}

Erreurs CPMM (AMM standard)

ID du programme : voir reference/program-addresses. Source : raydium-cp-swap/programs/cp-swap/src/error.rs.

Code	Variante	Chaîne `#[msg]`	Cause typique	UX recommandée
6000	`NotApproved`	Not approved	L’appelant n’est pas l’autorité configurée pour une instruction d’administration.	« Seul l’administrateur du pool peut effectuer cette action. »
6001	`InvalidOwner`	Input account owner is not the program address	Un compte passé en paramètre est détenu par le mauvais programme (souvent un mauvais programme de token ou un PDA du mauvais programme).	« Interne : propriétaire du compte incompatible — actualisez et réessayez. »
6002	`EmptySupply`	Input token account empty	Le solde du compte LP ou token est zéro à une étape qui nécessite un montant positif.	« Rien à retirer. »
6003	`InvalidInput`	InvalidInput	Argument générique invalide (montant hors limites, mauvais drapeau).	« Entrée invalide — vérifiez les montants et réessayez. »
6004	`IncorrectLpMint`	Address of the provided lp token mint is incorrect	Le compte LP mint passé ne correspond pas à `pool_state.lp_mint`.	« Interne : mauvais LP mint — actualisez les données du pool. »
6005	`ExceededSlippage`	Exceeds desired slippage limit	Le prix exécuté est pire que le `minAmountOut` / `maxAmountIn` de l’utilisateur.	« Le prix a dépassé votre tolérance de slippage. Augmentez le slippage ou réessayez. »
6006	`ZeroTradingTokens`	Given pool token amount results in zero trading tokens	Les mathématiques de dépôt / retrait ont arrondi un côté à zéro (position trop petite).	« Le montant est inférieur au minimum pour ce pool. »
6007	`NotSupportMint`	Not support token_2022 mint extension	Le pool a rencontré une extension Token-2022 qu’il ne peut pas gérer en toute sécurité (par ex. `TransferHook`, `DefaultAccountState=Frozen`).	« Ce token a une extension que Raydium ne supporte pas dans CPMM. »
6008	`InvalidVault`	invaild vault	Le compte vault passé ne correspond pas à celui enregistré dans `pool_state`.	« Interne : mauvais vault — actualisez et réessayez. »
6009	`InitLpAmountTooLess`	Init lp amount is too less(Because 100 amount lp will be locked)	À l’initialisation du pool, l’offre LP calculée est inférieure au montant verrouillé de manière permanente.	« Liquidité initiale trop petite. Augmentez le dépôt. »
6010	`TransferFeeCalculateNotMatch`	TransferFee calculate not match	Le montant post-transfert observé pour un mint Token-2022 avec frais ne correspond pas à l’attente pré-calculée.	« Les frais de transfert du token ont changé en cours de transaction. Réessayez. »
6011	`MathOverflow`	Math overflow	Un calcul intermédiaire de swap / dépôt / frais a débordé.	« Le montant est trop grand pour ce pool. »
6012	`InsufficientVault`	Insufficient vault	Le solde du vault du pool est trop bas pour couvrir la sortie demandée.	« Pas assez de liquidité dans le pool pour cette taille. »
6013	`InvalidFeeModel`	Invalid fee model	L’administrateur a défini une combinaison de paramètres `AmmConfig` qui est rejetée on-chain.	N/A — chemin réservé à l’administrateur.
6014	`NoFeeCollect`	Fee is zero	Une instruction de collecte de frais de protocole, de fonds ou de créateur n’a trouvé aucun frais à collecter. Pour `CollectCreatorFeePermissionless`, les deux compteurs de créateur étaient zéro.	« Rien à collecter. » Traitez-le comme une course bénigne et arrêtez.

Source de régénération : github.com/raydium-io/raydium-cp-swap — error.rs.

Erreurs CLMM

ID du programme : voir reference/program-addresses. Source : raydium-clmm/programs/amm/src/error.rs.

Code	Variante	Chaîne `#[msg]`	Cause typique	UX recommandée
6000	`NotApproved`	Not approved	L’appelant n’est pas l’administrateur configuré pour cette instruction ; ou (instructions de permission) le signataire n’est ni `admin` ni `permission_pda_admin` ; ou (`OpenLimitOrder`) le compte token d’entrée/sortie est gelé ou le pool a le swap / les ordres limites désactivés ; ou (`ClosePosition`, chemin gelé) le compte restant fourni n’est pas `personal_position.pool_id`.	« Seul l’administrateur du pool peut effectuer cette action. » / « Ce compte token est gelé — dégel-le avant de placer l’ordre. » / « Interne : mauvais compte de position du pool. »
6001	`InvalidUpdateConfigFlag`	invalid update amm config flag	L’administrateur a passé une valeur `param` non reconnue à `update_amm_config`.	N/A — chemin réservé à l’administrateur.
6002	`AccountLack`	Account lack	Compte restant requis manquant de la tx (généralement tick-array ou extension oracle) ; ou `ClosePosition` ferme un NFT gelé sans le pool comme premier compte restant.	« Interne : compte manquant — actualisez les données du pool ou mettez à jour le générateur de fermeture de position. »
6003	`ClosePositionErr`	Remove liquidity, collect fees owed and reward then you can close position account	Tentative de fermeture d’une position qui a encore de la liquidité, des frais non collectés ou des récompenses non collectées.	« Retirez toute la liquidité et réclamez les frais/récompenses avant de fermer la position. »
6004	`InvalidTickIndex`	Tick out of range	`tick_lower` ou `tick_upper` est en dehors de `[-443636, 443636]`.	« Plage de prix hors limites pour ce pool. »
6005	`TickInvalidOrder`	The lower tick must be below the upper tick	`tick_lower >= tick_upper`.	« Le prix inférieur doit être inférieur au prix supérieur. »
6006	`TickLowerOverflow`	The tick must be greater, or equal to the minimum tick(-443636)	Débordement du tick inférieur.	« Prix inférieur trop bas. »
6007	`TickUpperOverflow`	The tick must be lesser than, or equal to the maximum tick(443636)	Débordement du tick supérieur.	« Prix supérieur trop haut. »
6008	`TickAndSpacingNotMatch`	tick % tick_spacing must be zero	Le tick soumis n’est pas un multiple du `tick_spacing` du pool.	« Alignez le prix au plus proche incrément valide. »
6009	`InvalidTickArray`	Invalid tick array account	Mauvais PDA passé pour un slot tick-array.	« Interne : mauvais tick array — actualisez les données du pool. »
6010	`InvalidTickArrayBoundary`	Invalid tick array boundary	Erreur de décalage d’une unité dans l’indexation du tick-array.	« Interne : erreur de limite du tick-array. »
6011	`SqrtPriceLimitOverflow`	Square root price limit overflow	`sqrt_price_limit` fourni par l’appelant en dehors de la plage valide.	« Limite de prix hors limites. »
6012	`SqrtPriceX64`	sqrt_price_x64 out of range	Le prix sqrt actuel du pool a dérivé hors limites en cours de swap.	« Réessayez le swap. »
6013	`LiquiditySubValueErr`	Liquidity sub delta L must be smaller than before	Violation d’invariant interne lors de la diminution de liquidité.	« Interne : erreur de comptabilité de liquidité. »
6014	`LiquidityAddValueErr`	Liquidity add delta L must be greater, or equal to before	Violation d’invariant interne lors de l’augmentation de liquidité.	« Interne : erreur de comptabilité de liquidité. »
6015	`ForbidBothZeroForSupplyLiquidity`	Both token amount must not be zero while supply liquidity	Appel d’augmentation de liquidité avec `amount_0_max` et `amount_1_max` tous deux zéro.	« Fournissez au moins un token. »
6016	`LiquidityInsufficient`	Liquidity insufficient	La position n’a pas assez de liquidité pour satisfaire le retrait.	« Le montant du retrait dépasse la liquidité de la position. »
6017	`PriceSlippageCheck`	Price slippage check	Le prix d’exécution a échoué à la protection de slippage de l’appelant.	« Le prix a dépassé votre tolérance de slippage. Augmentez le slippage ou réessayez. »
6018	`TooLittleOutputReceived`	Too little output received	`SwapBaseInput` : montant de sortie inférieur à `other_amount_threshold`.	« Slippage dépassé — sortie minimale non atteinte. »
6019	`TooMuchInputPaid`	Too much input paid	`SwapBaseOutput` : montant d’entrée supérieur à `other_amount_threshold`.	« Slippage dépassé — entrée maximale dépassée. »
6020	`ZeroAmountSpecified`	Swap special amount can not be zero	Montant zéro sur une instruction de swap.	« Entrez un montant supérieur à zéro. »
6021	`InvalidInputPoolVault`	Input pool vault is invalid	Le compte input-vault du swap ne correspond pas au vault enregistré du pool.	« Interne : mauvais vault d’entrée — actualisez les données du pool. »
6022	`TooSmallInputOrOutputAmount`	Swap input or output amount is too small	Les mathématiques du swap ont arrondi à zéro, généralement très petite poussière.	« Montant trop petit pour swapper dans ce pool. »
6023	`NotEnoughTickArrayAccount`	Not enough tick array account	Pas assez de comptes tick-array restants fournis pour la plage de swap.	« Interne : tick-arrays insuffisants — actualisez les données du pool. »
6024	`InvalidFirstTickArrayAccount`	Invalid first tick array account	Le premier compte tick-array passé ne couvre pas le tick actuel.	« Interne : mauvais premier tick array — actualisez les données du pool. »
6025	`InvalidRewardIndex`	Invalid reward index	`reward_index` en dehors de `[0, 2]`.	N/A — chemin administrateur.
6026	`FullRewardInfo`	The init reward token reach to the max	Le pool a déjà le maximum (3) de mints de récompense configurés.	N/A — chemin administrateur.
6027	`RewardTokenAlreadyInUse`	The init reward token already in use	Le mint de récompense duplique un existant.	N/A — chemin administrateur.
6028	`ExceptRewardMint`	The reward tokens must contain one of pool vault mint except the last reward	Avant le slot 2, le mint de récompense doit égaler l’un des mints vault du pool.	N/A — chemin administrateur.
6029	`InvalidRewardInitParam`	Invalid reward init param	Mauvais temps de démarrage/fin d’émission ou taux par seconde.	N/A — chemin administrateur.
6030	`InvalidRewardInputAccountNumber`	Invalid collect reward input account number	Mauvais nombre de comptes restants passés à `CollectReward`.	« Interne : mauvais nombre de comptes — actualisez et réessayez. »
6031	`InvalidRewardPeriod`	Invalid reward period	Période d’émission de récompense invalide (`end <= start`, durée zéro).	N/A — chemin administrateur.
6032	`NotApproveUpdateRewardEmissions`	Modification of emissions is allowed within 72 hours from the end of the previous cycle	L’administrateur a tenté de modifier les émissions en dehors de la fenêtre de 72 heures autour des limites de cycle.	N/A — chemin administrateur.
6033	`UnInitializedRewardInfo`	uninitialized reward info	Slot de récompense non initialisé mais référencé.	N/A — chemin administrateur.
6034	`NotSupportMint`	Not support token_2022 mint extension	CLMM a rencontré une extension Token-2022 qu’il ne peut pas gérer.	« Ce token a une extension que Raydium CLMM ne supporte pas. »
6035	`MissingTickArrayBitmapExtensionAccount`	Missing tickarray bitmap extension account	Le swap a traversé une plage de tick non couverte par le bitmap de base ; compte bitmap d’extension requis.	« Interne : extension tick-array manquante — actualisez les données du pool. »
6036	`InsufficientLiquidityForDirection`	Insufficient liquidity for this direction	Pas assez de liquidité existe dans la direction du swap.	« Liquidité insuffisante pour cette taille de swap. »
6037	`MaxTokenOverflow`	Max token overflow	Le montant d’entrée/sortie a dépassé u64.	« Montant trop grand pour ce pool. »
6038	`CalculateOverflow`	Calculate overflow	Débordement arithmétique des frais / liquidité.	« Montant trop grand pour ce pool. »
6039	`TransferFeeCalculateNotMatch`	TransferFee calculate not match	Le montant observé des frais de transfert Token-2022 ne correspond pas à l’attente.	« Les frais de transfert du token ont changé en cours de transaction. Réessayez. »
6040	`OrderAlreadyFilled`	Order already fully filled, cannot modify	`IncreaseLimitOrder` / `DecreaseLimitOrder` appelé sur un ordre dont la portion non remplie est zéro.	« Cet ordre limite est déjà rempli — réglez pour recevoir la sortie. »
6041	`InvalidOrderPhase`	Invalid order phase	Mutation d’un ordre dont la phase de cohorte FIFO ne correspond plus à la cohorte actuelle du tick.	« Impossible d’effectuer cette action dans l’état actuel de l’ordre. »
6042	`InvalidLimitOrderAmount`	Invalid limit order amount	Entrée d’ordre inférieure au minimum du pool (ou zéro) au moment de l’ouverture / augmentation / diminution.	« La taille de l’ordre est inférieure au minimum du pool. »
6043	`OrderPhaseSaturated`	Tick order phase saturated	Le compteur `order_phase` de la cohorte sur le tick a saturé ; d’autres ordres ne peuvent pas être ouverts à ce tick jusqu’à ce que les cohortes existantes se règlent et se renouvellent.	« Trop d’ordres actifs à ce prix ; essayez un tick à proximité ou attendez que les ordres se règlent. »
6044	`InvalidDynamicFeeConfigParams`	Invalid dynamic fee config params	`CreateDynamicFeeConfig` / `UpdateDynamicFeeConfig` rejeté ; ou `CreateCustomizablePool` a activé les frais dynamiques sans une configuration valide.	N/A sur le chemin administrateur ; « Configuration des frais dynamiques invalide » sur le chemin utilisateur.
6045	`InvalidFeeOn`	Invalid fee on which token (must be 0, 1, or 2)	`CreateCustomizablePool` a passé une valeur `collect_fee_on` en dehors de `{0, 1, 2}`.	« Interne : mode de frais invalide. »
6046	`ZeroSqrtPrice`	sqrt_price_x64 must be greater than 0	`CreateCustomizablePool` (ou un autre chemin qui accepte un prix sqrt initial personnalisable) a été appelé avec `sqrt_price_x64 == 0`.	« Le prix initial doit être supérieur à zéro. »
6047	`ZeroLiquidity`	liquidity must be greater than 0	Un chemin de fourniture de liquidité a été appelé avec `liquidity == 0` et aucun montant compensatoire.	« Le montant de liquidité doit être supérieur à zéro. »
6048	`MissingBaseFlag`	base_flag is required when liquidity is zero	Un chemin d’ouverture de position par montant a calculé `liquidity == 0` et l’appelant n’a pas fourni de `base_flag` pour désambiguïser quel côté est la base.	« Fournissez soit une liquidité non nulle, soit spécifiez quel token est la base. »
6049	`MissingMintAccount`	Mint account is required but not provided	Un chemin conscient de Token-2022 a été appelé sans le compte mint d’entrée/sortie nécessaire pour valider les extensions et les frais de transfert.	« Interne : compte mint manquant — actualisez les données du pool. »
6050	`MissingTokenProgram2022`	Token-2022 program is required but not provided	Idem ci-dessus pour le compte du programme SPL-Token-2022.	« Interne : programme Token-2022 manquant — actualisez et réessayez. »

Remarque sur la renumérotation. L’énumération ErrorCode de CLMM a été renumérotée dans cette version : cinq variantes héritées (LOK, ZeroMintAmount, InvalidLiquidity, TransactionTooOld, InvalidRewardDesiredAmount) et plusieurs fautes de frappe (Liquitity, enought, emissiones) ont été supprimées/corrigées, et onze nouvelles variantes ont été ajoutées. Parce qu’Anchor numérote les erreurs par ordre source, chaque code à partir de 6000 a changé par rapport aux versions pré-version. Les clients qui ont codé en dur les codes numériques par rapport à une version antérieure doivent remapper.

Source de régénération : github.com/raydium-io/raydium-clmm — error.rs.

Erreurs AMM v4, Farm v3 / v5 / v6, LaunchLab

Ces programmes sont documentés dans leurs chapitres respectifs (voir products/amm-v4/instructions, products/farm-staking/instructions, products/launchlab/instructions). Parce que ces programmes utilisent un mélange de surfaces d’erreur Anchor et Solana brutes, leurs tableaux d’erreurs se trouvent à côté de la référence d’instruction plutôt qu’ici. Les codes ci-dessous sont réservés par ces chapitres :

Programme	Plage de codes (Anchor uniquement)	Référence
AMM v4	Codes u32 personnalisés, pas de style Anchor	`products/amm-v4/instructions`
Farm v3 / v5	Codes u32 personnalisés	`products/farm-staking/instructions`
Farm v6	6000+ (Anchor)	`products/farm-staking/instructions`
LaunchLab	6000+ (Anchor)	`products/launchlab/instructions`

La version LaunchLab conserve les codes 6000–6021 inchangés. Elle supprime les anciennes erreurs d’accès global à la plateforme et assigne 6022 à la nouvelle erreur de validation du compte d’autorisation :

Code	Nom	Signification
6018	`NotEnoughRemainingAccounts`	Un compte restant requis est manquant. Cela inclut un `PlatformAllowConfig` requis et l’ensemble de comptes de migration CPMM étendu.
6022	`InvalidPlatformAllowConfig`	Le compte d’autorisation fourni n’encode pas la paire de plateforme et de configuration globale attendue.

Les anciennes variantes PlatformGlobalAccessDenied (6022) et InvalidPlatformGlobalAccess (6023) sont supprimées. Ne décodez pas 6022 en utilisant l’IDL précédent.

Mappage des erreurs SDK aux erreurs du programme

Le SDK TypeScript officiel enveloppe les erreurs on-chain dans SendTransactionError et, pour les programmes Anchor, AnchorError :

import { AnchorError } from "@coral-xyz/anchor";

try {
  await sdk.cpmm.swap({ ... });
} catch (err) {
  if (err instanceof AnchorError) {
    console.log(err.error.errorCode.number, err.error.errorCode.code, err.error.errorMessage);
    // 6005 ExceededSlippage "Exceeds desired slippage limit"
  } else {
    // Raw SendTransactionError — inspectez err.logs pour la ligne "custom program error: 0x...".
  }
}

Si vous n’utilisez pas le client Anchor, analysez les logs de la transaction :

Program <ProgramID> invoke [1]
Program log: AnchorError caused by account: pool_state. Error Code: ExceededSlippage. Error Number: 6005. Error Message: Exceeds desired slippage limit.

Le motif Error Number: (\d+) est stable entre les versions d’Anchor et sûr à faire correspondre.

Régénération de ces tableaux

Lorsqu’un programme est mis à niveau et ajoute une nouvelle erreur, réextrayez de la source :

# Clonez et grep l'énumération d'erreur dans l'ordre.
git clone --depth=1 https://github.com/raydium-io/raydium-cp-swap
awk '/#\[msg\(/{ gsub(/^[ \t]*#\[msg\("|"\)\][ \t]*/,""); m=$0; getline; gsub(/,/,""); gsub(/^[ \t]+/,""); print "6000+++\t" $0 "\t" m }' \
  raydium-cp-swap/programs/cp-swap/src/error.rs
# Remplacez 6000+++ par 6000,6001,... en augmentant de manière monotone. Ajoutez les nouvelles lignes au tableau ci-dessus.

Mettez toujours à jour reference/changelog lorsqu’une nouvelle variante est ajoutée, afin que les intégrateurs mettant à niveau le SDK sachent actualiser leurs gestionnaires d’erreurs. Sources :

​Fonctionnement des codes d’erreur Anchor

​Erreurs CPMM (AMM standard)

​Erreurs CLMM

​Erreurs AMM v4, Farm v3 / v5 / v6, LaunchLab

​Mappage des erreurs SDK aux erreurs du programme

​Régénération de ces tableaux

Fonctionnement des codes d’erreur Anchor

Erreurs CPMM (AMM standard)

Erreurs CLMM

Erreurs AMM v4, Farm v3 / v5 / v6, LaunchLab

Mappage des erreurs SDK aux erreurs du programme

Régénération de ces tableaux