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 pela ordem de origem, não pelo nome, então reorganizar quebra o tratamento de erros dos integradores.

Como funcionam os códigos de erro Anchor

O 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 o Anchor emitiu em log_messages.

Os integradores devem fazer correspondência com o código numérico, não com a 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("Preço moveu além da sua tolerância de slippage. Aumente o slippage ou tente novamente.");
    return;
  }
  throw err;
}

Erros do 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.	”Apenas o admin do pool pode realizar esta ação.”
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).	”Interno: incompatibilidade de proprietário de conta — atualize e tente novamente.”
6002	`EmptySupply`	Input token account empty	O saldo da conta de token ou LP é zero em uma etapa que requer um valor positivo.	”Nada para sacar.”
6003	`InvalidInput`	InvalidInput	Argumento genérico inválido (valor fora do intervalo, flag errada).	”Entrada inválida — verifique os valores e tente novamente.”
6004	`IncorrectLpMint`	Address of the provided lp token mint is incorrect	A conta de mint LP passada não corresponde a `pool_state.lp_mint`.	”Interno: mint LP errado — atualize os dados do pool.”
6005	`ExceededSlippage`	Exceeds desired slippage limit	O preço executado é pior que o `minAmountOut` / `maxAmountIn` do usuário.	”Preço moveu além da sua tolerância de slippage. Aumente o slippage ou tente novamente.”
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).	”O valor está abaixo do mínimo para este 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`).	”Este token tem uma extensão que o Raydium não suporta no CPMM.”
6008	`InvalidVault`	invaild vault	A conta de vault passada não corresponde à registrada em `pool_state`.	”Interno: vault errado — atualize e tente novamente.”
6009	`InitLpAmountTooLess`	Init lp amount is too less(Because 100 amount lp will be locked)	Na inicialização do pool, a oferta de LP calculada está abaixo do valor de bloqueio permanente.	”Liquidez inicial muito pequena. Aumente o depósito.”
6010	`TransferFeeCalculateNotMatch`	TransferFee calculate not match	O valor pós-transferência observado para um mint de taxa Token-2022 não correspondeu à expectativa pré-calculada.	”Taxa de transferência de token mudou durante a transação. Tente novamente.”
6011	`MathOverflow`	Math overflow	Um cálculo intermediário de swap/depósito/taxa teve overflow.	”O valor é muito grande para este pool.”
6012	`InsufficientVault`	Insufficient vault	O saldo do vault do pool é muito baixo para cobrir a saída solicitada.	”Liquidez insuficiente no pool para este tamanho.”
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.	”Nada para coletar.” Trate como uma corrida benigna e pare.

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

Erros do 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`.	”Apenas o admin do pool pode realizar esta ação.” / “Esta conta de token está congelada — descongele antes de colocar a ordem.” / “Interno: conta de pool de posição errada.”
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.	”Interno: conta ausente — atualize os dados do pool ou atualize o construtor de fechamento de posição.”
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.	”Retire toda a liquidez e reivindique taxas/recompensas antes de fechar a posição.”
6004	`InvalidTickIndex`	Tick out of range	`tick_lower` ou `tick_upper` está fora de `[-443636, 443636]`.	”Intervalo de preço fora dos limites para este pool.”
6005	`TickInvalidOrder`	The lower tick must be below the upper tick	`tick_lower >= tick_upper`.	”Preço inferior deve estar abaixo do preço superior.”
6006	`TickLowerOverflow`	The tick must be greater, or equal to the minimum tick(-443636)	Underflow do tick inferior.	”Preço inferior muito baixo.”
6007	`TickUpperOverflow`	The tick must be lesser than, or equal to the maximum tick(443636)	Overflow do tick superior.	”Preço superior muito alto.”
6008	`TickAndSpacingNotMatch`	tick % tick_spacing must be zero	O tick enviado não é um múltiplo do `tick_spacing` do pool.	”Ajuste o preço para o incremento válido mais próximo.”
6009	`InvalidTickArray`	Invalid tick array account	PDA errada passada para um slot de tick-array.	”Interno: tick array errado — atualize os dados do pool.”
6010	`InvalidTickArrayBoundary`	Invalid tick array boundary	Off-by-one na indexação de tick-array.	”Interno: erro de limite de tick-array.”
6011	`SqrtPriceLimitOverflow`	Square root price limit overflow	`sqrt_price_limit` fornecido pelo chamador fora do intervalo válido.	”Limite de preço fora do intervalo.”
6012	`SqrtPriceX64`	sqrt_price_x64 out of range	O preço sqrt atual do pool saiu do intervalo durante o swap.	”Tente novamente o swap.”
6013	`LiquiditySubValueErr`	Liquidity sub delta L must be smaller than before	Violação de invariante interno na diminuição de liquidez.	”Interno: erro de contabilidade de liquidez.”
6014	`LiquidityAddValueErr`	Liquidity add delta L must be greater, or equal to before	Violação de invariante interno no aumento de liquidez.	”Interno: erro de contabilidade de liquidez.”
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.	”Forneça pelo menos um token.”
6016	`LiquidityInsufficient`	Liquidity insufficient	A posição não tem liquidez suficiente para satisfazer o saque.	”O valor de saque excede a liquidez da posição.”
6017	`PriceSlippageCheck`	Price slippage check	O preço de execução falhou na proteção de slippage do chamador.	”Preço moveu além da sua tolerância de slippage. Aumente o slippage ou tente novamente.”
6018	`TooLittleOutputReceived`	Too little output received	`SwapBaseInput`: valor de saída abaixo de `other_amount_threshold`.	”Slippage excedido — saída mínima não atingida.”
6019	`TooMuchInputPaid`	Too much input paid	`SwapBaseOutput`: valor de entrada acima de `other_amount_threshold`.	”Slippage excedido — entrada máxima excedida.”
6020	`ZeroAmountSpecified`	Swap special amount can not be zero	`amount` zero em uma instrução de swap.	”Digite um valor maior que zero.”
6021	`InvalidInputPoolVault`	Input pool vault is invalid	A conta de vault de entrada do swap não corresponde ao vault registrado do pool.	”Interno: vault de entrada errado — atualize os dados do pool.”
6022	`TooSmallInputOrOutputAmount`	Swap input or output amount is too small	A matemática de swap arredondou para zero, tipicamente poeira muito pequena.	”Valor muito pequeno para fazer swap neste pool.”
6023	`NotEnoughTickArrayAccount`	Not enough tick array account	Contas de tick-array restantes insuficientes fornecidas para o intervalo de swap.	”Interno: tick-arrays insuficientes — atualize os dados do pool.”
6024	`InvalidFirstTickArrayAccount`	Invalid first tick array account	A primeira conta de tick-array passada não cobre o tick atual.	”Interno: primeiro tick array errado — atualize os dados do pool.”
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 errado de contas restantes passadas para `CollectReward`.	”Interno: contagem de conta errada — atualize e tente novamente.”
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.	”Este token tem uma extensão que o Raydium CLMM não suporta.”
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.	”Interno: extensão de tick-array ausente — atualize os dados do pool.”
6036	`InsufficientLiquidityForDirection`	Insufficient liquidity for this direction	Não há liquidez suficiente na direção do swap.	”Liquidez insuficiente para este tamanho de swap.”
6037	`MaxTokenOverflow`	Max token overflow	Valor de entrada/saída excedeu u64.	”Valor muito grande para este pool.”
6038	`CalculateOverflow`	Calculate overflow	Overflow de aritmética de taxa/liquidez.	”Valor muito grande para este pool.”
6039	`TransferFeeCalculateNotMatch`	TransferFee calculate not match	O valor observado de taxa de transferência Token-2022 não correspondeu ao esperado.	”Taxa de transferência de token mudou durante a transação. Tente novamente.”
6040	`OrderAlreadyFilled`	Order already fully filled, cannot modify	`IncreaseLimitOrder` / `DecreaseLimitOrder` chamado em uma ordem cuja porção não preenchida é zero.	”Esta ordem limitada já foi preenchida — liquide para receber a saída.”
6041	`InvalidOrderPhase`	Invalid order phase	Mutando uma ordem cuja fase de coorte FIFO não corresponde mais à coorte atual do tick.	”Não é possível realizar esta ação no estado atual da ordem.”
6042	`InvalidLimitOrderAmount`	Invalid limit order amount	Entrada de ordem abaixo do mínimo do pool (ou zero) no tempo de abertura/aumento/diminuição.	”O tamanho da ordem está abaixo do mínimo do pool.”
6043	`OrderPhaseSaturated`	Tick order phase saturated	O contador `order_phase` da coorte no tick saturou; mais ordens não podem ser abertas naquele tick até que as coortes existentes se liquidem e rolem.	”Muitas ordens ativas neste preço; tente um tick próximo ou aguarde as ordens se liquidarem.”
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; “Configuração de taxa dinâmica inválida” 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}`.	”Interno: modo de taxa inválido.”
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`.	”Preço inicial deve ser maior que zero.”
6047	`ZeroLiquidity`	liquidity must be greater than 0	Um caminho de fornecimento de liquidez foi chamado com `liquidity == 0` e nenhum valor compensador.	”Valor de liquidez deve ser maior que 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.	”Forneça uma liquidez diferente de zero ou especifique qual token é a 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.	”Interno: conta de mint ausente — atualize os dados do pool.”
6050	`MissingTokenProgram2022`	Token-2022 program is required but not provided	O mesmo que acima para a conta do programa SPL-Token-2022.	”Interno: programa Token-2022 ausente — atualize e tente novamente.”

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 o Anchor numera erros pela 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 do 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`

O lançamento do LaunchLab mantém os códigos 6000–6021 inalterados. Remove os antigos erros de acesso global da plataforma e atribui 6022 ao novo erro de validação de conta de permissão:

Código	Nome	Significado
6018	`NotEnoughRemainingAccounts`	Uma conta restante obrigatória está ausente. Isso inclui um `PlatformAllowConfig` obrigatório e o conjunto de contas de migração CPMM expandido.
6022	`InvalidPlatformAllowConfig`	A conta de permissão fornecida não codifica o par de plataforma e configuração global esperado.

As antigas variantes PlatformGlobalAccessDenied (6022) e InvalidPlatformGlobalAccess (6023) são removidas. Não decodifique 6022 usando o IDL anterior.

Mapeando erros do SDK para erros do 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 {
    // SendTransactionError bruto — inspecione err.logs para a linha "custom program error: 0x...".
  }
}

Se você não estiver usando o cliente Anchor, 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 do CPMM (AMM padrão)

Erros do CLMM

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

Mapeando erros do SDK para erros do programa

Regenerando essas tabelas

​Como funcionam os códigos de erro Anchor

​Erros do CPMM (AMM padrão)

​Erros do CLMM

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

​Mapeando erros do SDK para erros do programa

​Regenerando essas tabelas

Como funcionam os códigos de erro Anchor

Erros do CPMM (AMM padrão)

Erros do CLMM

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

Mapeando erros do SDK para erros do programa

Regenerando essas tabelas