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 a continuación se regeneran desde el archivo error.rs de cada programa en los repositorios públicos de Raydium. Cuando un programa se actualiza y se añade una nueva variante, vuelve a ejecutar la extracción (enlace al final de cada tabla) y añade filas al final en lugar de reorganizar — los códigos de error de Anchor se asignan por orden en el código fuente, no por nombre, por lo que reorganizarlos 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 a partir de 6000. Una transacción fallida expone:

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

Los integradores deben comparar contra el código numérico, no contra la cadena del mensaje (el texto puede reformularse sin cambiar la versión).

// Example: detect the CPMM slippage error and surface a clean UX message.
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;
}

Errores de CPMM (AMM estándar)

Program ID: 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 invocador 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 (generalmente un programa de token erróneo o un PDA de programa equivocado).	”Error interno: propietario de cuenta no coincide — recarga e inténtalo de nuevo.”
6002	`EmptySupply`	Input token account empty	El saldo de la cuenta LP o de token es cero en un paso que requiere un monto positivo.	”No hay nada que retirar.”
6003	`InvalidInput`	InvalidInput	Argumento incorrecto genérico (monto fuera de rango, flag incorrecto).	”Entrada no válida — revisa los montos e inténtalo de nuevo.”
6004	`IncorrectLpMint`	Address of the provided lp token mint is incorrect	La cuenta LP mint pasada no coincide con `pool_state.lp_mint`.	”Error interno: LP mint incorrecto — recarga los datos del pool.”
6005	`ExceededSlippage`	Exceeds desired slippage limit	El precio ejecutado es peor que el `minAmountOut` / `maxAmountIn` del usuario.	”El precio superó tu tolerancia de slippage. Aumenta el slippage o inténtalo de nuevo.”
6006	`ZeroTradingTokens`	Given pool token amount results in zero trading tokens	La matemática de depósito/retiro redondeó 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 (gramática en el fuente)	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 admite en CPMM.”
6008	`InvalidVault`	invaild vault (typo en el fuente)	La cuenta vault pasada no coincide con la registrada en `pool_state`.	”Error interno: vault incorrecto — recarga e inténtalo de nuevo.”
6009	`InitLpAmountTooLess`	Init lp amount is too less(Because 100 amount lp will be locked) (gramática en el fuente)	En la inicialización del pool, el suministro LP calculado está por debajo del monto 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 con comisión de Token-2022 no coincidió con la expectativa precalculada.	”La comisión de transferencia del token cambió a mitad de la transacción. Inténtalo de nuevo.”
6011	`MathOverflow`	Math overflow	Un cálculo intermedio de swap/depósito/comisión sufrió desbordamiento.	”El monto es demasiado grande para este pool.”
6012	`InsufficientVault`	Insufficient vault	El saldo del vault 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 configuró una combinación de parámetros `AmmConfig` que es rechazada on-chain.	N/A — ruta solo para administradores.
6014	`NoFeeCollect`	Fee is zero	Se llamó a `collect_protocol_fee` / `collect_fund_fee` con comisiones colectables en cero.	N/A — ruta de administrador; las herramientas deben ignorarlo.

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

Errores de CLMM

Program ID: 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 invocador no es el administrador configurado para esta instrucción.	”Solo el administrador del pool puede realizar esta acción.”
6001	`InvalidUpdateConfigFlag`	invalid update amm config flag	El administrador pasó un valor `param` no reconocido a `update_amm_config`.	N/A — ruta solo para administradores.
6002	`AccountLack`	Account lack	Falta una cuenta restante requerida en la tx (generalmente un tick-array o extensión de oráculo).	”Error interno: cuenta faltante — recarga los datos del pool.”
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, comisiones no cobradas o recompensas no cobradas.	”Retira toda la liquidez y reclama comisiones/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 ser menor que el precio superior.”
6006	`TickLowerOverflow`	The tick must be greater, or equal to the minimum tick(-443636)	Desbordamiento inferior del tick.	”El precio inferior es demasiado bajo.”
6007	`TickUpperOverflow`	The tick must be lesser than, or equal to the maximum tick(443636)	Desbordamiento superior del tick.	”El precio superior es demasiado alto.”
6008	`TickAndSpacingNotMatch`	tick % tick_spacing must be zero	El tick enviado no es múltiplo del `tick_spacing` del pool.	”Ajusta el precio al incremento válido más cercano.”
6009	`InvalidTickArray`	Invalid tick array account	Se pasó un PDA incorrecto para un slot de tick-array.	”Error interno: tick array incorrecto — recarga los datos del pool.”
6010	`InvalidTickArrayBoundary`	Invalid tick array boundary	Error de uno en la indexación del tick-array.	”Error interno: error en el límite del tick-array.”
6011	`SqrtPriceLimitOverflow`	Square root price limit overflow	El `sqrt_price_limit` proporcionado por el invocador está fuera del rango válido.	”El límite de precio está fuera de rango.”
6012	`SqrtPriceX64`	sqrt_price_x64 out of range	El sqrt price actual del pool se desplazó fuera de rango a mitad del swap.	”Vuelve a intentar el swap.”
6013	`LiquiditySubValueErr`	Liquidity sub delta L must be smaller than before	Violación de invariante interna al reducir liquidez.	”Error interno: error en la contabilidad de liquidez.”
6014	`LiquidityAddValueErr`	Liquidity add delta L must be greater, or equal to before	Violación de invariante interna al aumentar liquidez.	”Error interno: error en la contabilidad de liquidez.”
6015	`ForbidBothZeroForSupplyLiquidity`	Both token amount must not be zero while supply liquidity	Llamada a increase-liquidity con `amount_0_max` y `amount_1_max` ambos en cero.	”Proporciona al menos un token.”
6016	`LiquidityInsufficient`	Liquidity insufficient	La posición no tiene suficiente liquidez para satisfacer el retiro.	”El monto a retirar supera la liquidez de la posición.”
6017	`PriceSlippageCheck`	Price slippage check	El precio de ejecución no pasó la protección de slippage del invocador.	”El precio superó tu tolerancia de slippage. Aumenta el slippage o inténtalo de nuevo.”
6018	`TooLittleOutputReceived`	Too little output received	`SwapBaseInput`: monto de salida por debajo de `other_amount_threshold`.	”Slippage superado — mínimo de salida no alcanzado.”
6019	`TooMuchInputPaid`	Too much input paid	`SwapBaseOutput`: monto de entrada por encima de `other_amount_threshold`.	”Slippage superado — máximo de entrada excedido.”
6020	`ZeroAmountSpecified`	Swap special amount can not be zero	`amount` en cero en una instrucción de swap.	”Introduce un monto mayor que cero.”
6021	`InvalidInputPoolVault`	Input pool vault is invalid	La cuenta del vault de entrada del swap no coincide con el vault registrado del pool.	”Error interno: vault de entrada incorrecto — recarga los datos del pool.”
6022	`TooSmallInputOrOutputAmount`	Swap input or output amount is too small	La matemática del swap redondeó a cero, típicamente con montos muy pequeños de polvo.	”Monto demasiado pequeño para hacer swap en este pool.”
6023	`NotEnoughTickArrayAccount`	Not enough tick array account	No se proporcionaron suficientes cuentas restantes de tick-array para el rango del swap.	”Error interno: tick-arrays insuficientes — recarga 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 — recarga 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	En slots previos al 2, el mint de recompensa debe coincidir con uno de los mints vault del pool.	N/A — ruta de administrador.
6029	`InvalidRewardInitParam`	Invalid reward init param	Tiempo de inicio/fin de emisión o tasa por segundo incorrectos.	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 cuentas incorrecto — recarga e inténtalo de nuevo.”
6031	`InvalidRewardPeriod`	Invalid reward period	Período de emisión de recompensas no vá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 las 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	Se referenció un slot de recompensa no inicializado.	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 admite.”
6035	`MissingTickArrayBitmapExtensionAccount`	Missing tickarray bitmap extension account	El swap cruzó un rango de ticks no cubierto por el bitmap base; se requiere la cuenta de bitmap de extensión.	”Error interno: extensión de tick-array faltante — recarga los datos del pool.”
6036	`InsufficientLiquidityForDirection`	Insufficient liquidity for this direction	No existe suficiente liquidez en la dirección del swap.	”Liquidez insuficiente para el tamaño de este swap.”
6037	`MaxTokenOverflow`	Max token overflow	El monto de entrada/salida superó u64.	”El monto es demasiado grande para este pool.”
6038	`CalculateOverflow`	Calculate overflow	Desbordamiento aritmético en comisiones/liquidez.	”El monto es demasiado grande para este pool.”
6039	`TransferFeeCalculateNotMatch`	TransferFee calculate not match	El monto observado de la comisión de transferencia Token-2022 no coincidió con el esperado.	”La comisión de transferencia del token cambió a mitad de la transacción. Inténtalo de nuevo.”
6040	`OrderAlreadyFilled`	Order already fully filled, cannot modify	Se llamó a `IncreaseLimitOrder` / `DecreaseLimitOrder` en una orden cuya porción no ejecutada es cero.	”Esta orden limitada ya está completada — liquídala para recibir la salida.”
6041	`InvalidOrderPhase`	Invalid order phase	Se modificó 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	El monto de entrada de la orden está por debajo del mínimo del pool (o es cero) al abrir/aumentar/disminuir.	”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 está saturado; no se pueden abrir más órdenes en ese tick hasta que las cohortes existentes liquiden y roten.	”Demasiadas órdenes activas en este precio; prueba un tick cercano o espera a que las órdenes se liquiden.”
6044	`InvalidDynamicFeeConfigParams`	Invalid dynamic fee config params	`CreateDynamicFeeConfig` / `UpdateDynamicFeeConfig` rechazado; o `CreateCustomizablePool` habilitó la comisión dinámica sin una configuración válida.	N/A en ruta de administrador; “Configuración de comisión dinámica no vá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 comisión no válido.”
6046	`ZeroSqrtPrice`	sqrt_price_x64 must be greater than 0	Se llamó a `CreateCustomizablePool` (u otra ruta que acepta un sqrt price inicial personalizable) con `sqrt_price_x64 == 0`.	”El precio inicial debe ser mayor que cero.”
6047	`ZeroLiquidity`	liquidity must be greater than 0	Se llamó a una ruta de provisión de liquidez 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 invocador no proporcionó un `base_flag` para indicar 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	Se llamó a una ruta con soporte Token-2022 sin la cuenta de mint de entrada/salida necesaria para validar extensiones y comisiones de transferencia.	”Error interno: cuenta de mint faltante — recarga los datos del pool.”
6050	`MissingTokenProgram2022`	Token-2022 program is required but not provided	Igual que el anterior, pero para la cuenta del programa SPL-Token-2022.	”Error interno: programa Token-2022 faltante — recarga e inténtalo de nuevo.”

Nota sobre la renumeración. El enum ErrorCode de CLMM fue renumerado en esta versión: se eliminaron/corrigieron cinco variantes heredadas (LOK, ZeroMintAmount, InvalidLiquidity, TransactionTooOld, InvalidRewardDesiredAmount) y varios errores tipográficos (Liquitity, enought, emissiones), y se añadieron once nuevas variantes al final. Dado que Anchor numera los errores por orden en el código fuente, todos los códigos a partir de 6000 se han desplazado respecto a las versiones previas al lanzamiento. Los clientes que tenían códigos numéricos codificados de forma fija para una versión anterior deben actualizar su mapeo.

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

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

Estos programas están documentados en sus capítulos respectivos (ver products/amm-v4/instructions, products/farm-staking/instructions, products/launchlab/instructions). Como esos programas utilizan una combinación de Anchor y superficies de error de Solana nativo, sus tablas de errores están junto a la referencia de instrucciones y no aquí. Los códigos a continuación están reservados por esos capítulos:

Programa	Rango de códigos (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`

Mapeo de errores del SDK a errores del programa

El SDK oficial de TypeScript envuelve los errores on-chain en SendTransactionError y, para programas Anchor, en 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 — inspect err.logs for the "custom program error: 0x..." line.
  }
}

Si no usas el cliente Anchor, analiza los logs 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 es seguro usarlo para comparaciones.

Regeneración de estas tablas

Cuando un programa se actualiza y añade un nuevo error, vuelve a extraerlo del código fuente:

# Clone and grep the error enum in order.
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
# Replace 6000+++ with monotonically-increasing 6000,6001,... Append new rows to the table above.

Actualiza siempre reference/changelog cuando se añada una nueva variante, para que los integradores que actualicen el SDK sepan que deben refrescar sus manejadores de errores. Fuentes:

Referencia

Recursos

Documentation Index

​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 y 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 y LaunchLab

Mapeo de errores del SDK a errores del programa

Regeneración de estas tablas