Códigos de error - Raydium Docs

Esta página fue traducida automáticamente por IA. La versión en inglés es la fuente autorizada.Ver versión en inglés →

Fuente de verdad. Las tablas siguientes se regeneran a partir de error.rs en cada programa de los repositorios públicos de Raydium. Cuando se actualiza un programa y se añade una nueva variante, vuelve a ejecutar la extracción (enlace al final de cada tabla) y añade a la tabla en lugar de reorganizar — los códigos de error de Anchor se asignan por orden de fuente, no por nombre, así que reorganizar rompe el manejo de errores de los integradores.

Cómo funcionan los códigos de error de Anchor

Anchor asigna a cada variante de la enumeración ErrorCode de un programa un código numérico comenzando en 6000. Una transacción fallida expone:

Código de error numérico (p. ej. 0x1771 = 6001) en los registros de transacción.
Nombre del error (p. ej. InvalidOwner) del IDL.
Cadena #[msg(...)] que Anchor emitió en log_messages.

Los integradores deben coincidir con el código numérico, no con la cadena de mensaje (la cadena puede reescribirse sin aumentar una versión).

// Ejemplo: detectar el error de slippage de CPMM y mostrar un mensaje UX limpio.
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("El precio se movió más allá de tu tolerancia de slippage. Aumenta el slippage o reinténtalo.");
    return;
  }
  throw err;
}

Errores de CPMM (AMM estándar)

ID del programa: consulta reference/program-addresses. Fuente: raydium-cp-swap/programs/cp-swap/src/error.rs.

Código	Variante	Cadena `#[msg]`	Causa típica	UX recomendado
6000	`NotApproved`	Not approved	El llamador no es la autoridad configurada para una instrucción de administrador.	”Solo el administrador del pool puede realizar esta acción.”
6001	`InvalidOwner`	Input account owner is not the program address	Una cuenta pasada es propiedad del programa incorrecto (a menudo un programa de token incorrecto o un PDA de programa incorrecto).	”Error interno: desajuste de propietario de cuenta — actualiza e intenta de nuevo.”
6002	`EmptySupply`	Input token account empty	El saldo de la cuenta de token o LP es cero en un paso que requiere una cantidad positiva.	”Nada que retirar.”
6003	`InvalidInput`	InvalidInput	Argumento incorrecto genérico (cantidad fuera de rango, bandera incorrecta).	”Entrada inválida — verifica los montos e intenta de nuevo.”
6004	`IncorrectLpMint`	Address of the provided lp token mint is incorrect	La cuenta de mint de LP pasada no coincide con `pool_state.lp_mint`.	”Error interno: mint de LP incorrecto — actualiza los datos del pool.”
6005	`ExceededSlippage`	Exceeds desired slippage limit	El precio ejecutado es peor que el `minAmountOut` / `maxAmountIn` del usuario.	”El precio se movió más allá de tu tolerancia de slippage. Aumenta el slippage o reinténtalo.”
6006	`ZeroTradingTokens`	Given pool token amount results in zero trading tokens	Las matemáticas de depósito/retiro redondearon un lado a cero (posición demasiado pequeña).	”El monto está por debajo del mínimo para este pool.”
6007	`NotSupportMint`	Not support token_2022 mint extension	El pool encontró una extensión de Token-2022 que no puede manejar de forma segura (p. ej. `TransferHook`, `DefaultAccountState=Frozen`).	”Este token tiene una extensión que Raydium no soporta en CPMM.”
6008	`InvalidVault`	invaild vault	La cuenta de bóveda pasada no coincide con la registrada en `pool_state`.	”Error interno: bóveda incorrecta — actualiza e intenta de nuevo.”
6009	`InitLpAmountTooLess`	Init lp amount is too less(Because 100 amount lp will be locked)	En la inicialización del pool, el suministro de LP calculado está por debajo de la cantidad de bloqueo permanente.	”Liquidez inicial demasiado pequeña. Aumenta el depósito.”
6010	`TransferFeeCalculateNotMatch`	TransferFee calculate not match	El monto post-transferencia observado para un mint de tarifa de Token-2022 no coincidió con la expectativa precomputada.	”La tarifa de transferencia de token cambió durante la transacción. Reinténtalo.”
6011	`MathOverflow`	Math overflow	Un cálculo intermedio de swap/depósito/tarifa se desbordó.	”El monto es demasiado grande para este pool.”
6012	`InsufficientVault`	Insufficient vault	El saldo de la bóveda del pool es demasiado bajo para cubrir la salida solicitada.	”No hay suficiente liquidez en el pool para este tamaño.”
6013	`InvalidFeeModel`	Invalid fee model	El administrador estableció una combinación de parámetros de `AmmConfig` que se rechaza en cadena.	N/A — ruta solo de administrador.
6014	`NoFeeCollect`	Fee is zero	Una instrucción de recopilación de tarifa de protocolo, fondo o creador no encontró tarifas cobrables. Para `CollectCreatorFeePermissionless`, ambos contadores de creador eran cero.	”Nada que recopilar.” Trata como una carrera benigna y detente.

Fuente de regeneración: github.com/raydium-io/raydium-cp-swap — error.rs.

Errores de CLMM

ID del programa: consulta reference/program-addresses. Fuente: raydium-clmm/programs/amm/src/error.rs.

Código	Variante	Cadena `#[msg]`	Causa típica	UX recomendado
6000	`NotApproved`	Not approved	El llamador no es el administrador configurado para esta instrucción; o (instrucciones de permiso) el firmante no es ni `admin` ni `permission_pda_admin`; o (`OpenLimitOrder`) la cuenta de token de entrada/salida está congelada o el pool tiene swap/orden limitada deshabilitada; o (`ClosePosition`, ruta congelada) la cuenta restante suministrada no es `personal_position.pool_id`.	”Solo el administrador del pool puede realizar esta acción.” / “Esta cuenta de token está congelada — descongélala antes de colocar la orden.” / “Error interno: cuenta de pool de posición incorrecta.”
6001	`InvalidUpdateConfigFlag`	invalid update amm config flag	El administrador pasó un valor de `param` no reconocido a `update_amm_config`.	N/A — ruta solo de administrador.
6002	`AccountLack`	Account lack	Cuenta restante requerida faltante de la tx (típicamente tick-array u extensión de oráculo); o `ClosePosition` está cerrando un NFT congelado sin el pool como su primera cuenta restante.	”Error interno: cuenta faltante — actualiza los datos del pool o actualiza el constructor de cierre de posición.”
6003	`ClosePositionErr`	Remove liquidity, collect fees owed and reward then you can close position account	Se intentó cerrar una posición que aún tiene liquidez, tarifas no recopiladas o recompensas no recopiladas.	”Retira toda la liquidez y reclama tarifas/recompensas antes de cerrar la posición.”
6004	`InvalidTickIndex`	Tick out of range	`tick_lower` o `tick_upper` está fuera de `[-443636, 443636]`.	”Rango de precio fuera de los límites para este pool.”
6005	`TickInvalidOrder`	The lower tick must be below the upper tick	`tick_lower >= tick_upper`.	”El precio inferior debe estar por debajo del precio superior.”
6006	`TickLowerOverflow`	The tick must be greater, or equal to the minimum tick(-443636)	Desbordamiento inferior del tick.	”Precio inferior demasiado bajo.”
6007	`TickUpperOverflow`	The tick must be lesser than, or equal to the maximum tick(443636)	Desbordamiento superior del tick.	”Precio superior demasiado alto.”
6008	`TickAndSpacingNotMatch`	tick % tick_spacing must be zero	El tick enviado no es un múltiplo del `tick_spacing` del pool.	”Ajusta el precio al incremento válido más cercano.”
6009	`InvalidTickArray`	Invalid tick array account	PDA incorrecto pasado para una ranura de tick-array.	”Error interno: tick array incorrecto — actualiza los datos del pool.”
6010	`InvalidTickArrayBoundary`	Invalid tick array boundary	Error de uno en la indexación de tick-array.	”Error interno: error de límite de tick-array.”
6011	`SqrtPriceLimitOverflow`	Square root price limit overflow	`sqrt_price_limit` suministrado por el llamador fuera del rango válido.	”Límite de precio fuera de rango.”
6012	`SqrtPriceX64`	sqrt_price_x64 out of range	El precio sqrt actual del pool se desvió fuera de rango durante el swap.	”Reintentar swap.”
6013	`LiquiditySubValueErr`	Liquidity sub delta L must be smaller than before	Violación de invariante interno en disminución de liquidez.	”Error interno: error de contabilidad de liquidez.”
6014	`LiquidityAddValueErr`	Liquidity add delta L must be greater, or equal to before	Violación de invariante interno en aumento de liquidez.	”Error interno: error de contabilidad de liquidez.”
6015	`ForbidBothZeroForSupplyLiquidity`	Both token amount must not be zero while supply liquidity	Llamada de aumento de liquidez con ambos `amount_0_max` y `amount_1_max` cero.	”Proporciona al menos un token.”
6016	`LiquidityInsufficient`	Liquidity insufficient	La posición no tiene suficiente liquidez para satisfacer el retiro.	”El monto de retiro excede la liquidez de la posición.”
6017	`PriceSlippageCheck`	Price slippage check	El precio de ejecución falló en la protección de slippage del llamador.	”El precio se movió más allá de tu tolerancia de slippage. Aumenta el slippage o reinténtalo.”
6018	`TooLittleOutputReceived`	Too little output received	`SwapBaseInput`: monto de salida por debajo de `other_amount_threshold`.	”Slippage excedido — salida mínima no alcanzada.”
6019	`TooMuchInputPaid`	Too much input paid	`SwapBaseOutput`: monto de entrada por encima de `other_amount_threshold`.	”Slippage excedido — entrada máxima excedida.”
6020	`ZeroAmountSpecified`	Swap special amount can not be zero	Monto cero en una instrucción de swap.	”Ingresa un monto mayor que cero.”
6021	`InvalidInputPoolVault`	Input pool vault is invalid	La cuenta de bóveda de entrada del swap no coincide con la bóveda registrada del pool.	”Error interno: bóveda de entrada incorrecta — actualiza los datos del pool.”
6022	`TooSmallInputOrOutputAmount`	Swap input or output amount is too small	Las matemáticas de swap redondearon a cero, típicamente polvo muy pequeño.	”Monto demasiado pequeño para hacer swap en este pool.”
6023	`NotEnoughTickArrayAccount`	Not enough tick array account	No hay suficientes cuentas de tick-array restantes suministradas para el rango de swap.	”Error interno: tick-arrays insuficientes — actualiza los datos del pool.”
6024	`InvalidFirstTickArrayAccount`	Invalid first tick array account	La primera cuenta de tick-array pasada no cubre el tick actual.	”Error interno: primer tick array incorrecto — actualiza los datos del pool.”
6025	`InvalidRewardIndex`	Invalid reward index	`reward_index` fuera de `[0, 2]`.	N/A — ruta de administrador.
6026	`FullRewardInfo`	The init reward token reach to the max	El pool ya tiene el máximo (3) de mints de recompensa configurados.	N/A — ruta de administrador.
6027	`RewardTokenAlreadyInUse`	The init reward token already in use	El mint de recompensa duplica uno existente.	N/A — ruta de administrador.
6028	`ExceptRewardMint`	The reward tokens must contain one of pool vault mint except the last reward	Pre-slot 2, el mint de recompensa debe ser igual a uno de los mints de bóveda del pool.	N/A — ruta de administrador.
6029	`InvalidRewardInitParam`	Invalid reward init param	Hora de inicio/fin de emisión o tasa por segundo incorrecta.	N/A — ruta de administrador.
6030	`InvalidRewardInputAccountNumber`	Invalid collect reward input account number	Número incorrecto de cuentas restantes pasadas a `CollectReward`.	”Error interno: número de cuenta incorrecto — actualiza e intenta de nuevo.”
6031	`InvalidRewardPeriod`	Invalid reward period	Período de emisión de recompensa inválido (`end <= start`, duración cero).	N/A — ruta de administrador.
6032	`NotApproveUpdateRewardEmissions`	Modification of emissions is allowed within 72 hours from the end of the previous cycle	El administrador intentó modificar emisiones fuera de la ventana de 72 horas alrededor de los límites del ciclo.	N/A — ruta de administrador.
6033	`UnInitializedRewardInfo`	uninitialized reward info	Ranura de recompensa no inicializada pero referenciada.	N/A — ruta de administrador.
6034	`NotSupportMint`	Not support token_2022 mint extension	CLMM encontró una extensión de Token-2022 que no puede manejar.	”Este token tiene una extensión que Raydium CLMM no soporta.”
6035	`MissingTickArrayBitmapExtensionAccount`	Missing tickarray bitmap extension account	El swap cruzó un rango de tick no cubierto por el bitmap base; se requiere cuenta de bitmap de extensión.	”Error interno: extensión de tick-array faltante — actualiza los datos del pool.”
6036	`InsufficientLiquidityForDirection`	Insufficient liquidity for this direction	No hay suficiente liquidez en la dirección del swap.	”Liquidez insuficiente para este tamaño de swap.”
6037	`MaxTokenOverflow`	Max token overflow	El monto de entrada/salida excedió u64.	”Monto demasiado grande para este pool.”
6038	`CalculateOverflow`	Calculate overflow	Desbordamiento aritmético de tarifa/liquidez.	”Monto demasiado grande para este pool.”
6039	`TransferFeeCalculateNotMatch`	TransferFee calculate not match	El monto observado de tarifa de transferencia de Token-2022 no coincidió con lo esperado.	”La tarifa de transferencia de token cambió durante la transacción. Reinténtalo.”
6040	`OrderAlreadyFilled`	Order already fully filled, cannot modify	`IncreaseLimitOrder` / `DecreaseLimitOrder` llamado en una orden cuya porción sin llenar es cero.	”Esta orden limitada ya está llena — liquida para recibir salida.”
6041	`InvalidOrderPhase`	Invalid order phase	Mutación de una orden cuya fase de cohorte FIFO ya no coincide con la cohorte actual del tick.	”No puedes realizar esta acción en el estado actual de la orden.”
6042	`InvalidLimitOrderAmount`	Invalid limit order amount	Entrada de orden por debajo del mínimo del pool (o cero) en tiempo de apertura/aumento/disminución.	”El tamaño de la orden está por debajo del mínimo del pool.”
6043	`OrderPhaseSaturated`	Tick order phase saturated	El contador `order_phase` de la cohorte en el tick se ha saturado; no se pueden abrir más órdenes en ese tick hasta que las cohortes existentes se liquiden y cambien.	”Demasiadas órdenes activas a este precio; intenta un tick cercano o espera a que se liquiden las órdenes.”
6044	`InvalidDynamicFeeConfigParams`	Invalid dynamic fee config params	`CreateDynamicFeeConfig` / `UpdateDynamicFeeConfig` rechazado; o `CreateCustomizablePool` habilitó tarifa dinámica sin una configuración válida.	N/A en ruta de administrador; “Configuración de tarifa dinámica inválida” en ruta de usuario.
6045	`InvalidFeeOn`	Invalid fee on which token (must be 0, 1, or 2)	`CreateCustomizablePool` pasó un valor de `collect_fee_on` fuera de `{0, 1, 2}`.	”Error interno: modo de tarifa inválido.”
6046	`ZeroSqrtPrice`	sqrt_price_x64 must be greater than 0	`CreateCustomizablePool` (u otra ruta que acepte un precio sqrt inicial personalizable) fue llamado con `sqrt_price_x64 == 0`.	”El precio inicial debe ser mayor que cero.”
6047	`ZeroLiquidity`	liquidity must be greater than 0	Una ruta de provisión de liquidez fue llamada con `liquidity == 0` y sin monto compensatorio.	”El monto de liquidez debe ser mayor que cero.”
6048	`MissingBaseFlag`	base_flag is required when liquidity is zero	Una ruta de apertura de posición por monto calculó `liquidity == 0` y el llamador no suministró un `base_flag` para desambiguar cuál lado es la base.	”Proporciona una liquidez distinta de cero o especifica cuál token es la base.”
6049	`MissingMintAccount`	Mint account is required but not provided	Una ruta consciente de Token-2022 fue llamada sin la cuenta de mint de entrada/salida necesaria para validar extensiones y tarifas de transferencia.	”Error interno: cuenta de mint faltante — actualiza los datos del pool.”
6050	`MissingTokenProgram2022`	Token-2022 program is required but not provided	Lo mismo que arriba para la cuenta del programa SPL-Token-2022.	”Error interno: programa Token-2022 faltante — actualiza e intenta de nuevo.”

Nota sobre renumeración. La enumeración ErrorCode de CLMM fue renumerada en esta versión: cinco variantes heredadas (LOK, ZeroMintAmount, InvalidLiquidity, TransactionTooOld, InvalidRewardDesiredAmount) y varios errores tipográficos (Liquitity, enought, emissiones) fueron removidos/corregidos, y once nuevas variantes fueron añadidas. Debido a que Anchor numera errores por orden de fuente, cada código en o después de 6000 ha cambiado en relación con compilaciones previas al lanzamiento. Los clientes que codificaron códigos numéricos contra una versión anterior necesitan remapear.

Fuente de regeneración: github.com/raydium-io/raydium-clmm — error.rs.

Errores de AMM v4, Farm v3 / v5 / v6, LaunchLab

Estos programas se documentan en sus respectivos capítulos (consulta products/amm-v4/instructions, products/farm-staking/instructions, products/launchlab/instructions). Debido a que esos programas utilizan una mezcla de superficies de error de Anchor y Solana plano, sus tablas de error viven junto a la referencia de instrucción en lugar de aquí. Los códigos siguientes están reservados por esos capítulos:

Programa	Rango de código (solo Anchor)	Referencia
AMM v4	Códigos u32 personalizados, no estilo Anchor	`products/amm-v4/instructions`
Farm v3 / v5	Códigos u32 personalizados	`products/farm-staking/instructions`
Farm v6	6000+ (Anchor)	`products/farm-staking/instructions`
LaunchLab	6000+ (Anchor)	`products/launchlab/instructions`

El lanzamiento de LaunchLab mantiene los códigos 6000–6021 sin cambios. Elimina los antiguos errores de acceso global de plataforma y asigna 6022 al nuevo error de validación de cuenta permitida:

Código	Nombre	Significado
6018	`NotEnoughRemainingAccounts`	Falta una cuenta restante requerida. Esto incluye un `PlatformAllowConfig` requerido y el conjunto de cuentas de migración CPMM expandido.
6022	`InvalidPlatformAllowConfig`	La cuenta permitida suministrada no codifica el par de plataforma y configuración global esperado.

Las antiguas variantes PlatformGlobalAccessDenied (6022) e InvalidPlatformGlobalAccess (6023) se eliminan. No decodifiques 6022 usando el IDL anterior.

Mapeo de errores del SDK a errores del programa

El SDK oficial de TypeScript envuelve errores en cadena en SendTransactionError y, para programas de 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 {
    // SendTransactionError sin procesar — inspecciona err.logs para la línea "custom program error: 0x...".
  }
}

Si no estás usando Anchor en el lado del cliente, analiza los registros de transacción:

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

El patrón Error Number: (\d+) es estable en versiones de Anchor y seguro para coincidir.

Regeneración de estas tablas

Cuando se actualiza un programa y añade un nuevo error, vuelve a extraer de la fuente:

# Clona y grep la enumeración de error en orden.
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
# Reemplaza 6000+++ con 6000,6001,... incrementando monótonamente. Añade nuevas filas a la tabla anterior.

Siempre actualiza reference/changelog cuando se añade una nueva variante, para que los integradores que actualicen el SDK sepan que deben actualizar sus manejadores de error. Fuentes:

​Cómo funcionan los códigos de error de Anchor

​Errores de CPMM (AMM estándar)

​Errores de CLMM

​Errores de AMM v4, Farm v3 / v5 / v6, LaunchLab

​Mapeo de errores del SDK a errores del programa

​Regeneración de estas tablas

Cómo funcionan los códigos de error de Anchor

Errores de CPMM (AMM estándar)

Errores de CLMM

Errores de AMM v4, Farm v3 / v5 / v6, LaunchLab

Mapeo de errores del SDK a errores del programa

Regeneración de estas tablas