Códigos de erro

Esta página foi traduzida automaticamente por IA. A versão em inglês é a fonte oficial.Ver versão em inglês →

Fonte de verdade. As tabelas abaixo são regeneradas a partir do arquivo error.rs de cada programa nos repositórios públicos do Raydium. Quando um programa é atualizado e uma nova variante é adicionada, execute novamente a extração (link no final de cada tabela) e acrescente à tabela em vez de reorganizar — os códigos de erro Anchor são atribuídos por ordem de origem, não por nome, então reorganizar quebra o tratamento de erros dos integradores.

Como funcionam os códigos de erro Anchor

Anchor atribui a cada variante do enum ErrorCode de um programa um código numérico começando em 6000. Uma transação que falha expõe:

Código de erro numérico (ex: 0x1771 = 6001) nos logs da transação.
Nome do erro (ex: InvalidOwner) a partir do IDL.
String #[msg(...)] que Anchor emitiu em log_messages.

Os integradores devem fazer correspondência no código numérico, não na string de mensagem (a string pode ser reformulada sem aumentar uma versão).

// Exemplo: detectar o erro de slippage do CPMM e exibir uma mensagem UX limpa.
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;
}

Erros CPMM (AMM padrão)

ID do programa: veja reference/program-addresses. Fonte: raydium-cp-swap/programs/cp-swap/src/error.rs.

Código	Variante	String `#[msg]`	Causa típica	UX recomendada
6000	`NotApproved`	Not approved	O chamador não é a autoridade configurada para uma instrução de admin.	”Only the pool admin can perform this action.”
6001	`InvalidOwner`	Input account owner is not the program address	Uma conta passada é de propriedade do programa errado (frequentemente um programa de token errado ou uma PDA de programa errado).	”Internal: account owner mismatch — refresh and retry.”
6002	`EmptySupply`	Input token account empty	O saldo da conta de token ou LP é zero em uma etapa que requer um valor positivo.	”Nothing to withdraw.”
6003	`InvalidInput`	InvalidInput	Argumento genérico inválido (valor fora do intervalo, flag errada).	”Invalid input — check amounts and try again.”
6004	`IncorrectLpMint`	Address of the provided lp token mint is incorrect	A conta de mint de LP passada não corresponde a `pool_state.lp_mint`.	”Internal: wrong LP mint — refresh pool data.”
6005	`ExceededSlippage`	Exceeds desired slippage limit	O preço executado é pior que o `minAmountOut` / `maxAmountIn` do usuário.	”Price moved past your slippage tolerance. Increase slippage or retry.”
6006	`ZeroTradingTokens`	Given pool token amount results in zero trading tokens	A matemática de depósito/saque arredondou um lado para zero (posição muito pequena).	”Amount is below the minimum for this pool.”
6007	`NotSupportMint`	Not support token_2022 mint extension	O pool encontrou uma extensão Token-2022 que não pode lidar com segurança (ex: `TransferHook`, `DefaultAccountState=Frozen`).	”This token has an extension Raydium does not support in CPMM.”
6008	`InvalidVault`	invaild vault	A conta de vault passada não corresponde à registrada em `pool_state`.	”Internal: wrong vault — refresh and retry.”
6009	`InitLpAmountTooLess`	Init lp amount is too less(Because 100 amount lp will be locked)	Na inicialização do pool, o fornecimento de LP calculado está abaixo do valor de bloqueio permanente.	”Initial liquidity too small. Increase deposit.”
6010	`TransferFeeCalculateNotMatch`	TransferFee calculate not match	O valor pós-transferência observado para um mint de taxa Token-2022 não corresponde à expectativa pré-calculada.	”Token transfer fee changed mid-transaction. Retry.”
6011	`MathOverflow`	Math overflow	Um cálculo intermediário de swap/depósito/taxa sofreu overflow.	”Amount is too large for this pool.”
6012	`InsufficientVault`	Insufficient vault	O saldo do vault do pool é muito baixo para cobrir a saída solicitada.	”Not enough liquidity in the pool for this size.”
6013	`InvalidFeeModel`	Invalid fee model	O admin definiu uma combinação de parâmetros `AmmConfig` que é rejeitada on-chain.	N/A — caminho apenas para admin.
6014	`NoFeeCollect`	Fee is zero	Uma instrução de coleta de taxa de protocolo, fundo ou criador não encontrou taxas coletáveis. Para `CollectCreatorFeePermissionless`, ambos os contadores de criador eram zero.	”Nothing to collect.” Trate como uma corrida benigna e pare.

Fonte de regeneração: github.com/raydium-io/raydium-cp-swap — error.rs.

Erros CLMM

ID do programa: veja reference/program-addresses. Fonte: raydium-clmm/programs/amm/src/error.rs.

Código	Variante	String `#[msg]`	Causa típica	UX recomendada
6000	`NotApproved`	Not approved	O chamador não é o admin configurado para esta instrução; ou (instruções de permissão) o signatário não é `admin` nem `permission_pda_admin`; ou (`OpenLimitOrder`) a conta de token de entrada/saída está congelada ou o pool tem swap/ordem limitada desabilitada; ou (`ClosePosition`, caminho congelado) a conta restante fornecida não é `personal_position.pool_id`.	”Only the pool admin can perform this action.” / “This token account is frozen — thaw it before placing the order.” / “Internal: wrong position pool account.”
6001	`InvalidUpdateConfigFlag`	invalid update amm config flag	O admin passou um valor `param` não reconhecido para `update_amm_config`.	N/A — caminho apenas para admin.
6002	`AccountLack`	Account lack	Conta restante obrigatória ausente da tx (tipicamente tick-array ou extensão oracle); ou `ClosePosition` está fechando um NFT congelado sem o pool como sua primeira conta restante.	”Internal: missing account — refresh pool data or update the position-close builder.”
6003	`ClosePositionErr`	Remove liquidity, collect fees owed and reward then you can close position account	Tentou fechar uma posição que ainda tem liquidez, taxas não coletadas ou recompensas não coletadas.	”Withdraw all liquidity and claim fees/rewards before closing the position.”
6004	`InvalidTickIndex`	Tick out of range	`tick_lower` ou `tick_upper` está fora de `[-443636, 443636]`.	”Price range out of bounds for this pool.”
6005	`TickInvalidOrder`	The lower tick must be below the upper tick	`tick_lower >= tick_upper`.	”Lower price must be below upper price.”
6006	`TickLowerOverflow`	The tick must be greater, or equal to the minimum tick(-443636)	Underflow do tick inferior.	”Lower price too low.”
6007	`TickUpperOverflow`	The tick must be lesser than, or equal to the maximum tick(443636)	Overflow do tick superior.	”Upper price too high.”
6008	`TickAndSpacingNotMatch`	tick % tick_spacing must be zero	O tick submetido não é um múltiplo do `tick_spacing` do pool.	”Snap price to the nearest valid increment.”
6009	`InvalidTickArray`	Invalid tick array account	PDA errada passada para um slot de tick-array.	”Internal: wrong tick array — refresh pool data.”
6010	`InvalidTickArrayBoundary`	Invalid tick array boundary	Off-by-one na indexação de tick-array.	”Internal: tick-array boundary error.”
6011	`SqrtPriceLimitOverflow`	Square root price limit overflow	`sqrt_price_limit` fornecido pelo chamador fora do intervalo válido.	”Price limit out of range.”
6012	`SqrtPriceX64`	sqrt_price_x64 out of range	O preço sqrt atual do pool saiu do intervalo durante o swap.	”Retry swap.”
6013	`LiquiditySubValueErr`	Liquidity sub delta L must be smaller than before	Violação de invariante interna na diminuição de liquidez.	”Internal: liquidity accounting error.”
6014	`LiquidityAddValueErr`	Liquidity add delta L must be greater, or equal to before	Violação de invariante interna no aumento de liquidez.	”Internal: liquidity accounting error.”
6015	`ForbidBothZeroForSupplyLiquidity`	Both token amount must not be zero while supply liquidity	Chamada de aumento de liquidez com `amount_0_max` e `amount_1_max` zero.	”Provide at least one token.”
6016	`LiquidityInsufficient`	Liquidity insufficient	A posição não tem liquidez suficiente para satisfazer o saque.	”Withdraw amount exceeds position liquidity.”
6017	`PriceSlippageCheck`	Price slippage check	O preço de execução falhou na proteção de slippage do chamador.	”Price moved past your slippage tolerance. Increase slippage or retry.”
6018	`TooLittleOutputReceived`	Too little output received	`SwapBaseInput`: valor de saída abaixo de `other_amount_threshold`.	”Slippage exceeded — minimum output not met.”
6019	`TooMuchInputPaid`	Too much input paid	`SwapBaseOutput`: valor de entrada acima de `other_amount_threshold`.	”Slippage exceeded — maximum input exceeded.”
6020	`ZeroAmountSpecified`	Swap special amount can not be zero	Zero `amount` em uma instrução de swap.	”Enter an amount greater than zero.”
6021	`InvalidInputPoolVault`	Input pool vault is invalid	A conta de vault de entrada do swap não corresponde ao vault registrado do pool.	”Internal: wrong input vault — refresh pool data.”
6022	`TooSmallInputOrOutputAmount`	Swap input or output amount is too small	A matemática de swap arredondou para zero, tipicamente poeira muito pequena.	”Amount too small to swap in this pool.”
6023	`NotEnoughTickArrayAccount`	Not enough tick array account	Contas de tick-array restantes insuficientes fornecidas para o intervalo de swap.	”Internal: insufficient tick-arrays — refresh pool data.”
6024	`InvalidFirstTickArrayAccount`	Invalid first tick array account	A primeira conta de tick-array passada não cobre o tick atual.	”Internal: wrong first tick array — refresh pool data.”
6025	`InvalidRewardIndex`	Invalid reward index	`reward_index` fora de `[0, 2]`.	N/A — caminho de admin.
6026	`FullRewardInfo`	The init reward token reach to the max	O pool já tem o máximo (3) de mints de recompensa configurados.	N/A — caminho de admin.
6027	`RewardTokenAlreadyInUse`	The init reward token already in use	O mint de recompensa duplica um existente.	N/A — caminho de admin.
6028	`ExceptRewardMint`	The reward tokens must contain one of pool vault mint except the last reward	Pré-slot 2, o mint de recompensa deve ser igual a um dos mints de vault do pool.	N/A — caminho de admin.
6029	`InvalidRewardInitParam`	Invalid reward init param	Tempo de início/fim de emissão inválido ou taxa por segundo.	N/A — caminho de admin.
6030	`InvalidRewardInputAccountNumber`	Invalid collect reward input account number	Número incorreto de contas restantes passadas para `CollectReward`.	”Internal: wrong account count — refresh and retry.”
6031	`InvalidRewardPeriod`	Invalid reward period	Período de emissão de recompensa inválido (`end <= start`, duração zero).	N/A — caminho de admin.
6032	`NotApproveUpdateRewardEmissions`	Modification of emissions is allowed within 72 hours from the end of the previous cycle	O admin tentou modificar emissões fora da janela de 72 horas ao redor dos limites de ciclo.	N/A — caminho de admin.
6033	`UnInitializedRewardInfo`	uninitialized reward info	Slot de recompensa não inicializado mas referenciado.	N/A — caminho de admin.
6034	`NotSupportMint`	Not support token_2022 mint extension	CLMM encontrou uma extensão Token-2022 que não pode lidar.	”This token has an extension Raydium CLMM does not support.”
6035	`MissingTickArrayBitmapExtensionAccount`	Missing tickarray bitmap extension account	O swap cruzou um intervalo de tick não coberto pelo bitmap base; conta de bitmap de extensão obrigatória.	”Internal: missing tick-array extension — refresh pool data.”
6036	`InsufficientLiquidityForDirection`	Insufficient liquidity for this direction	Não há liquidez suficiente na direção do swap.	”Insufficient liquidity for this swap size.”
6037	`MaxTokenOverflow`	Max token overflow	Valor de entrada/saída excedeu u64.	”Amount too large for this pool.”
6038	`CalculateOverflow`	Calculate overflow	Overflow aritmético de taxa/liquidez.	”Amount too large for this pool.”
6039	`TransferFeeCalculateNotMatch`	TransferFee calculate not match	O valor observado da taxa de transferência Token-2022 não corresponde ao esperado.	”Token transfer fee changed mid-transaction. Retry.”
6040	`OrderAlreadyFilled`	Order already fully filled, cannot modify	`IncreaseLimitOrder` / `DecreaseLimitOrder` chamado em uma ordem cuja porção não preenchida é zero.	”This limit order is already filled — settle to receive output.”
6041	`InvalidOrderPhase`	Invalid order phase	Mutando uma ordem cuja fase de coorte FIFO não corresponde mais à coorte atual do tick.	”Cannot perform this action in the order’s current state.”
6042	`InvalidLimitOrderAmount`	Invalid limit order amount	Entrada de ordem abaixo do mínimo do pool (ou zero) no tempo de abertura/aumento/diminuição.	”Order size is below the pool’s minimum.”
6043	`OrderPhaseSaturated`	Tick order phase saturated	O contador `order_phase` da coorte no tick saturou; novas ordens não podem ser abertas naquele tick até que as coortes existentes se resolvam e rolem.	”Too many active orders at this price; try a nearby tick or wait for orders to settle.”
6044	`InvalidDynamicFeeConfigParams`	Invalid dynamic fee config params	`CreateDynamicFeeConfig` / `UpdateDynamicFeeConfig` rejeitado; ou `CreateCustomizablePool` habilitou taxa dinâmica sem uma configuração válida.	N/A no caminho de admin; “Dynamic fee config invalid” no caminho do usuário.
6045	`InvalidFeeOn`	Invalid fee on which token (must be 0, 1, or 2)	`CreateCustomizablePool` passou um valor `collect_fee_on` fora de `{0, 1, 2}`.	”Internal: invalid fee mode.”
6046	`ZeroSqrtPrice`	sqrt_price_x64 must be greater than 0	`CreateCustomizablePool` (ou outro caminho que aceita um preço sqrt inicial customizável) foi chamado com `sqrt_price_x64 == 0`.	”Initial price must be greater than zero.”
6047	`ZeroLiquidity`	liquidity must be greater than 0	Um caminho de fornecimento de liquidez foi chamado com `liquidity == 0` e nenhum valor compensador.	”Liquidity amount must be greater than zero.”
6048	`MissingBaseFlag`	base_flag is required when liquidity is zero	Um caminho de abertura de posição por valor calculou `liquidity == 0` e o chamador não forneceu um `base_flag` para desambiguar qual lado é a base.	”Provide either a non-zero liquidity or specify which token is the base.”
6049	`MissingMintAccount`	Mint account is required but not provided	Um caminho ciente de Token-2022 foi chamado sem a conta de mint de entrada/saída necessária para validar extensões e taxas de transferência.	”Internal: missing mint account — refresh pool data.”
6050	`MissingTokenProgram2022`	Token-2022 program is required but not provided	O mesmo que acima para a conta do programa SPL-Token-2022.	”Internal: missing Token-2022 program — refresh and retry.”

Nota sobre renumeração. O enum ErrorCode do CLMM foi renumerado nesta versão: cinco variantes legadas (LOK, ZeroMintAmount, InvalidLiquidity, TransactionTooOld, InvalidRewardDesiredAmount) e vários erros de digitação (Liquitity, enought, emissiones) foram removidos/corrigidos, e onze novas variantes foram acrescentadas. Como Anchor numera erros por ordem de origem, cada código em ou após 6000 mudou em relação a compilações pré-lançamento. Clientes que codificaram códigos numéricos contra uma versão anterior precisam remapear.

Fonte de regeneração: github.com/raydium-io/raydium-clmm — error.rs.

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

Esses programas são documentados em seus respectivos capítulos (veja products/amm-v4/instructions, products/farm-staking/instructions, products/launchlab/instructions). Como esses programas usam uma mistura de superfícies de erro Anchor e Solana simples, suas tabelas de erro vivem ao lado da referência de instrução em vez de aqui. Os códigos abaixo são reservados por esses capítulos:

Programa	Intervalo de código (apenas Anchor)	Referência
AMM v4	Códigos u32 customizados, não estilo Anchor	`products/amm-v4/instructions`
Farm v3 / v5	Códigos u32 customizados	`products/farm-staking/instructions`
Farm v6	6000+ (Anchor)	`products/farm-staking/instructions`
LaunchLab	6000+ (Anchor)	`products/launchlab/instructions`

Os lançamentos recentes do LaunchLab mantêm os códigos 6000–6021 inalterados. O lançamento de 2026-08-17 removeu os antigos erros de acesso global da plataforma e atribuiu 6022 ao erro de validação de conta permitida; o lançamento de 2026-08-24 acrescenta 6023; o lançamento de 2026-08-31 acrescenta 6024–6030:

Código	Nome	Significado
6018	`NotEnoughRemainingAccounts`	Uma conta restante obrigatória está ausente. Isso inclui um `PlatformAllowConfig` obrigatório, um `PlatformCurveRule` obrigatório e o conjunto de contas de migração CPMM expandido.
6020	`CurveParamIsNotExist`	Aposentado. Mantido como placeholder para que os códigos após ele não mudem; o lançamento de 2026-08-31 removeu seu último chamador.
6022	`InvalidPlatformAllowConfig`	A conta permitida fornecida não codifica o par de plataforma e configuração global esperado.
6023	`CalculateOverflow`	Um cálculo de taxa de transferência Token-2022 ou taxa de transferência inversa não pôde ser representado. Alcançável nos caminhos de negociação de saída exata quando a taxa do mint de cotação não pode ser invertida (por exemplo, um mint com taxa de 100%).
6024	`InvalidPlatformCurveRule`	A conta de regra fornecida não é a PDA do par de plataforma e configuração sendo lançado.
6025	`CurveParamNotMatchPlatformRule`	Os parâmetros de lançamento não satisfazem nenhum grupo de verificação da regra da plataforma. O único erro que um criador pode realmente atingir — exiba como “this launch shape is not allowed on this platform”.
6026	`CurveRuleGroupNotExist`	`RemovePlatformCurveRule` foi chamado com um `group_id` que a regra não possui.
6027	`CurveRuleGroupsExceeded`	Uma regra não pode conter mais de 10 grupos de verificação.
6028	`InvalidCurveRuleConstraint`	Uma restrição tem um campo ou operador desconhecido, um grupo tem mais de 25 restrições, ou o mesmo par `(field, op)` aparece duas vezes em um grupo.
6029	`InvalidCurveRuleAuthority`	O signatário não é `PlatformConfig.curve_rule_manager` nem o admin da plataforma.
6030	`CurveRuleFieldNotSupportedByCurve`	Uma restrição lê `total_base_sell` em uma configuração cuja curva a deriva — as curvas de preço fixo e preço linear. Levantado quando a regra é escrita, não quando um lançamento é executado.

As antigas variantes PlatformGlobalAccessDenied (6022) e InvalidPlatformGlobalAccess (6023) são removidas. Não decodifique 6022 usando o IDL anterior, e note que 6023 — desocupado pelo lançamento de 2026-08-17 — é reutilizado pelo lançamento de 2026-08-24 para um erro não relacionado, então não deve ser decodificado com um IDL de nenhuma versão anterior. 6020 é retido deliberadamente. Anchor numera variantes por posição, então deletá-lo mudaria cada código após ele e quebraria cada cliente que decodifica 6021–6030.

Mapeando erros SDK para erros de programa

O SDK TypeScript oficial envolve erros on-chain em SendTransactionError e, para programas 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 — inspect err.logs for the "custom program error: 0x..." line.
  }
}

Se você não estiver usando Anchor no lado do cliente, analise os logs da transação:

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

O padrão Error Number: (\d+) é estável entre versões do Anchor e seguro para corresponder.

Regenerando essas tabelas

Quando um programa é atualizado e adiciona um novo erro, re-extraia da fonte:

# Clone e grep o enum de erro em ordem.
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
# Substitua 6000+++ por 6000,6001,... monotonicamente crescentes. Acrescente novas linhas à tabela acima.

Sempre atualize reference/changelog quando uma nova variante é adicionada, para que os integradores que atualizam o SDK saibam atualizar seus manipuladores de erro. Fontes:

Reference

Resources

Como funcionam os códigos de erro Anchor

Erros CPMM (AMM padrão)

Erros CLMM

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

Mapeando erros SDK para erros de programa

Regenerando essas tabelas

​Como funcionam os códigos de erro Anchor

​Erros CPMM (AMM padrão)

​Erros CLMM

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

​Mapeando erros SDK para erros de programa

​Regenerando essas tabelas

Como funcionam os códigos de erro Anchor

Erros CPMM (AMM padrão)

Erros CLMM

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

Mapeando erros SDK para erros de programa

Regenerando essas tabelas