Códigos de error

Enumeraciones de error de Anchor para cada programa en cadena de Raydium, con causa y mensaje UX recomendado.

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 del archivo error.rs de cada programa en 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 del enum 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 la 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 cambiar de 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: ver 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 observado después de la transferencia para un mint de tarifa de Token-2022 no coincidió con la expectativa precomputada.	”La tarifa de transferencia del 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 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.” Trátalo 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: ver 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 param no reconocido a update_amm_config.	N/A — ruta solo de administrador.
6002	AccountLack	Account lack	Falta una cuenta restante requerida 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 más bajo debe estar por debajo del precio más alto.”
6006	TickLowerOverflow	The tick must be greater, or equal to the minimum tick(-443636)	Desbordamiento inferior del tick inferior.	”Precio más bajo demasiado bajo.”
6007	TickUpperOverflow	The tick must be lesser than, or equal to the maximum tick(443636)	Desbordamiento del tick superior.	”Precio más alto 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 se suministraron suficientes cuentas de tick-array restantes 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 inválida o tasa por segundo.	N/A — ruta de administrador.
6030	InvalidRewardInputAccountNumber	Invalid collect reward input account number	Número incorrecto de cuentas restantes pasadas a CollectReward.	”Error interno: recuento 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 existe 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 el esperado.	”La tarifa de transferencia del 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 no completada es cero.	”Esta orden limitada ya está completada — liquida para recibir la 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 se puede 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 en 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 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. El enum ErrorCode de CLMM fue renumerado 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. Porque Anchor numera errores por orden de fuente, cada código en o después de 6000 ha cambiado en relación con compilaciones previas a la versión. Los clientes que codificaron números de códigos 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 (ver products/amm-v4/instructions, products/farm-staking/instructions, products/launchlab/instructions). Porque esos programas usan 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

Los lanzamientos recientes de LaunchLab mantienen los códigos 6000–6021 sin cambios. El lanzamiento del 2026-08-17 removió los antiguos errores de acceso global de plataforma y asignó 6022 al error de validación de cuenta permitida; el lanzamiento del 2026-08-24 añade 6023; el lanzamiento del 2026-08-31 añade 6024–6030:

Código	Nombre	Significado
6018	NotEnoughRemainingAccounts	Falta una cuenta restante requerida. Esto incluye un PlatformAllowConfig requerido, un PlatformCurveRule requerido, y el conjunto de cuentas de migración CPMM expandido.
6020	CurveParamIsNotExist	Retirado. Mantenido como marcador de posición para que los códigos después no cambien; el lanzamiento del 2026-08-31 removió su último llamador.
6022	InvalidPlatformAllowConfig	La cuenta permitida suministrada no codifica el par de configuración global y plataforma esperado.
6023	CalculateOverflow	Un cálculo de tarifa de transferencia de Token-2022 o tarifa de transferencia inversa no pudo ser representado. Alcanzable en las rutas de comercio de salida exacta cuando la tarifa del mint de cotización no puede ser invertida (por ejemplo un mint con tarifa del 100%).
6024	InvalidPlatformCurveRule	La cuenta de regla suministrada no es el PDA del par de plataforma y configuración bajo el cual se está lanzando.
6025	CurveParamNotMatchPlatformRule	Los parámetros de lanzamiento no satisfacen ningún grupo de verificación de la regla de la plataforma. El único error que un creador puede realmente golpear — muéstralo como “esta forma de lanzamiento no está permitida en esta plataforma”.
6026	CurveRuleGroupNotExist	RemovePlatformCurveRule fue llamado con un group_id que la regla no contiene.
6027	CurveRuleGroupsExceeded	Una regla no puede contener más de 10 grupos de verificación.
6028	InvalidCurveRuleConstraint	Una restricción tiene un campo u operador desconocido, un grupo tiene más de 25 restricciones, o el mismo par (field, op) aparece dos veces en un grupo.
6029	InvalidCurveRuleAuthority	El firmante no es ni PlatformConfig.curve_rule_manager ni el administrador de la plataforma.
6030	CurveRuleFieldNotSupportedByCurve	Una restricción lee total_base_sell en una configuración cuya curva la deriva — las curvas de precio fijo y precio lineal. Levantado cuando se escribe la regla, no cuando se ejecuta un lanzamiento.

Las antiguas variantes PlatformGlobalAccessDenied (6022) e InvalidPlatformGlobalAccess (6023) se han removido. No decodifiques 6022 usando el IDL anterior, y nota que 6023 — vacado por el lanzamiento del 2026-08-17 — es reutilizado por el lanzamiento del 2026-08-24 para un error no relacionado, así que no debe ser decodificado con un IDL de ninguna versión anterior.

6020 se retiene deliberadamente. Anchor numera variantes por posición, así que eliminarlo cambiaría cada código después y rompería cada cliente que decodifica 6021–6030.

​

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 la 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 entre 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 el enum 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,... monótonamente crecientes. 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:

• raydium-cp-swap error.rs (CPMM mainnet)
• raydium-clmm error.rs (CLMM mainnet)