Коды ошибок

Anchor error enums для каждой программы Raydium на цепи, с причинами и рекомендуемыми сообщениями UX.

Эта страница переведена с помощью ИИ. За эталон принимается английская версия.

Открыть английскую версию →

Источник истины. Таблицы ниже регенерируются из файла error.rs каждой программы в публичных репозиториях Raydium. Когда программа обновляется и добавляется новый вариант, повторно запустите извлечение (ссылка внизу каждой таблицы) и добавьте строку в таблицу вместо перестановки — коды ошибок Anchor назначаются по порядку в исходном коде, а не по имени, поэтому переупорядочивание нарушает обработку ошибок интеграторов.

​

Как работают коды ошибок Anchor

Anchor назначает каждому варианту enum ErrorCode программы числовой код, начиная с 6000. Неудачная транзакция выводит:

• Числовой код ошибки (например 0x1771 = 6001) в логах транзакции.
• Имя ошибки (например InvalidOwner) из IDL.
• Строку #[msg(...)], которую Anchor выдал в log_messages.

Интеграторы должны сопоставлять по числовому коду, а не по строке сообщения (строка может быть переформулирована без изменения версии).

// Пример: обнаружить ошибку slippage CPMM и вывести чистое сообщение UX.
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;
}

​

Ошибки CPMM (Standard AMM)

Program ID: см. reference/program-addresses. Источник: raydium-cp-swap/programs/cp-swap/src/error.rs.

Код	Вариант	Строка #[msg]	Типичная причина	Рекомендуемое сообщение UX
6000	NotApproved	Not approved	Вызывающий не является настроенным органом для инструкции администратора.	”Only the pool admin can perform this action.”
6001	InvalidOwner	Input account owner is not the program address	Переданный аккаунт принадлежит неправильной программе (часто неправильная программа токенов или PDA неправильной программы).	”Internal: account owner mismatch — refresh and retry.”
6002	EmptySupply	Input token account empty	Баланс LP или токен-аккаунта равен нулю на этапе, требующем положительной суммы.	”Nothing to withdraw.”
6003	InvalidInput	InvalidInput	Общий неправильный аргумент (сумма вне диапазона, неправильный флаг).	”Invalid input — check amounts and try again.”
6004	IncorrectLpMint	Address of the provided lp token mint is incorrect	Переданный аккаунт LP mint не совпадает с pool_state.lp_mint.	”Internal: wrong LP mint — refresh pool data.”
6005	ExceededSlippage	Exceeds desired slippage limit	Выполненная цена хуже, чем minAmountOut / maxAmountIn пользователя.	”Price moved past your slippage tolerance. Increase slippage or retry.”
6006	ZeroTradingTokens	Given pool token amount results in zero trading tokens	Математика депозита / вывода округлила одну сторону до нуля (позиция слишком мала).	”Amount is below the minimum for this pool.”
6007	NotSupportMint	Not support token_2022 mint extension	Пул встретил расширение Token-2022, которое не может безопасно обработать (например TransferHook, DefaultAccountState=Frozen).	”This token has an extension Raydium does not support in CPMM.”
6008	InvalidVault	invaild vault	Переданный аккаунт vault не совпадает с записанным в pool_state.	”Internal: wrong vault — refresh and retry.”
6009	InitLpAmountTooLess	Init lp amount is too less(Because 100 amount lp will be locked)	При инициализации пула вычисленное предложение LP ниже постоянно заблокированной суммы.	”Initial liquidity too small. Increase deposit.”
6010	TransferFeeCalculateNotMatch	TransferFee calculate not match	Наблюдаемая сумма после передачи для Token-2022 fee mint не совпадает с предварительно вычисленным ожиданием.	”Token transfer fee changed mid-transaction. Retry.”
6011	MathOverflow	Math overflow	Промежуточный расчет swap / депозита / комиссии переполнился.	”Amount is too large for this pool.”
6012	InsufficientVault	Insufficient vault	Баланс vault пула слишком низок для покрытия запрошенного выхода.	”Not enough liquidity in the pool for this size.”
6013	InvalidFeeModel	Invalid fee model	Администратор установил комбинацию параметров AmmConfig, которая отклоняется на цепи.	N/A — путь только для администратора.
6014	NoFeeCollect	Fee is zero	Инструкция сбора комиссии протокола, фонда или создателя не нашла собираемых комиссий. Для CollectCreatorFeePermissionless оба счетчика создателя были нулевыми.	”Nothing to collect.” Рассматривайте как доброкачественное состояние гонки и остановитесь.

Источник регенерации: github.com/raydium-io/raydium-cp-swap — error.rs.

​

Ошибки CLMM

Program ID: см. reference/program-addresses. Источник: raydium-clmm/programs/amm/src/error.rs.

Код	Вариант	Строка #[msg]	Типичная причина	Рекомендуемое сообщение UX
6000	NotApproved	Not approved	Вызывающий не является настроенным администратором для этой инструкции; или (инструкции разрешений) подписант не является ни admin, ни permission_pda_admin; или (OpenLimitOrder) аккаунт входного/выходного токена заморожен или пул имеет отключенный swap / limit-order; или (ClosePosition, замороженный путь) предоставленный оставшийся аккаунт не является 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	Администратор передал неизвестное значение param в update_amm_config.	N/A — путь только для администратора.
6002	AccountLack	Account lack	Требуемый оставшийся аккаунт отсутствует в tx (обычно tick-array или расширение oracle); или ClosePosition закрывает замороженный NFT без пула в качестве первого оставшегося аккаунта.	”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	Попытка закрыть позицию, которая все еще имеет ликвидность, невыплаченные комиссии или невыплаченные награды.	”Withdraw all liquidity and claim fees/rewards before closing the position.”
6004	InvalidTickIndex	Tick out of range	tick_lower или tick_upper находится вне [-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)	Нижний tick переполнился.	”Lower price too low.”
6007	TickUpperOverflow	The tick must be lesser than, or equal to the maximum tick(443636)	Верхний tick переполнился.	”Upper price too high.”
6008	TickAndSpacingNotMatch	tick % tick_spacing must be zero	Отправленный tick не является кратным tick_spacing пула.	”Snap price to the nearest valid increment.”
6009	InvalidTickArray	Invalid tick array account	Неправильный PDA передан для слота tick-array.	”Internal: wrong tick array — refresh pool data.”
6010	InvalidTickArrayBoundary	Invalid tick array boundary	Ошибка на единицу в индексировании tick-array.	”Internal: tick-array boundary error.”
6011	SqrtPriceLimitOverflow	Square root price limit overflow	Предоставленный вызывающим sqrt_price_limit вне допустимого диапазона.	”Price limit out of range.”
6012	SqrtPriceX64	sqrt_price_x64 out of range	Текущая sqrt цена пула вышла из диапазона во время swap.	”Retry swap.”
6013	LiquiditySubValueErr	Liquidity sub delta L must be smaller than before	Нарушение внутреннего инварианта при уменьшении ликвидности.	”Internal: liquidity accounting error.”
6014	LiquidityAddValueErr	Liquidity add delta L must be greater, or equal to before	Нарушение внутреннего инварианта при увеличении ликвидности.	”Internal: liquidity accounting error.”
6015	ForbidBothZeroForSupplyLiquidity	Both token amount must not be zero while supply liquidity	Вызов increase-liquidity с обоими amount_0_max и amount_1_max равными нулю.	”Provide at least one token.”
6016	LiquidityInsufficient	Liquidity insufficient	Позиция не имеет достаточной ликвидности для удовлетворения вывода.	”Withdraw amount exceeds position liquidity.”
6017	PriceSlippageCheck	Price slippage check	Цена выполнения не прошла проверку slippage вызывающего.	”Price moved past your slippage tolerance. Increase slippage or retry.”
6018	TooLittleOutputReceived	Too little output received	SwapBaseInput: выходная сумма ниже other_amount_threshold.	”Slippage exceeded — minimum output not met.”
6019	TooMuchInputPaid	Too much input paid	SwapBaseOutput: входная сумма выше other_amount_threshold.	”Slippage exceeded — maximum input exceeded.”
6020	ZeroAmountSpecified	Swap special amount can not be zero	Нулевая amount в инструкции swap.	”Enter an amount greater than zero.”
6021	InvalidInputPoolVault	Input pool vault is invalid	Аккаунт input-vault swap не совпадает с записанным в пуле.	”Internal: wrong input vault — refresh pool data.”
6022	TooSmallInputOrOutputAmount	Swap input or output amount is too small	Математика swap округлила до нуля, обычно очень маленькая пыль.	”Amount too small to swap in this pool.”
6023	NotEnoughTickArrayAccount	Not enough tick array account	Недостаточно оставшихся аккаунтов tick-array для диапазона swap.	”Internal: insufficient tick-arrays — refresh pool data.”
6024	InvalidFirstTickArrayAccount	Invalid first tick array account	Первый переданный аккаунт tick-array не охватывает текущий tick.	”Internal: wrong first tick array — refresh pool data.”
6025	InvalidRewardIndex	Invalid reward index	reward_index вне [0, 2].	N/A — путь администратора.
6026	FullRewardInfo	The init reward token reach to the max	Пул уже имеет максимум (3) настроенных reward mints.	N/A — путь администратора.
6027	RewardTokenAlreadyInUse	The init reward token already in use	Reward mint дублирует существующий.	N/A — путь администратора.
6028	ExceptRewardMint	The reward tokens must contain one of pool vault mint except the last reward	До слота 2, reward mint должен равняться одному из vault mints пула.	N/A — путь администратора.
6029	InvalidRewardInitParam	Invalid reward init param	Неправильное время начала/конца эмиссии или скорость в секунду.	N/A — путь администратора.
6030	InvalidRewardInputAccountNumber	Invalid collect reward input account number	Неправильное количество оставшихся аккаунтов, переданных в CollectReward.	”Internal: wrong account count — refresh and retry.”
6031	InvalidRewardPeriod	Invalid reward period	Период эмиссии награды недействителен (end <= start, нулевая длительность).	N/A — путь администратора.
6032	NotApproveUpdateRewardEmissions	Modification of emissions is allowed within 72 hours from the end of the previous cycle	Администратор попытался изменить эмиссии вне 72-часового окна вокруг границ цикла.	N/A — путь администратора.
6033	UnInitializedRewardInfo	uninitialized reward info	Слот награды не инициализирован, но на него ссылаются.	N/A — путь администратора.
6034	NotSupportMint	Not support token_2022 mint extension	CLMM встретил расширение Token-2022, которое не может обработать.	”This token has an extension Raydium CLMM does not support.”
6035	MissingTickArrayBitmapExtensionAccount	Missing tickarray bitmap extension account	Swap пересек диапазон tick, не охватываемый базовой bitmap; требуется аккаунт расширения bitmap.	”Internal: missing tick-array extension — refresh pool data.”
6036	InsufficientLiquidityForDirection	Insufficient liquidity for this direction	Недостаточно ликвидности в направлении swap.	”Insufficient liquidity for this swap size.”
6037	MaxTokenOverflow	Max token overflow	Входная/выходная сумма превысила u64.	”Amount too large for this pool.”
6038	CalculateOverflow	Calculate overflow	Переполнение арифметики комиссии / ликвидности.	”Amount too large for this pool.”
6039	TransferFeeCalculateNotMatch	TransferFee calculate not match	Наблюдаемая сумма комиссии передачи Token-2022 не совпадает с ожидаемой.	”Token transfer fee changed mid-transaction. Retry.”
6040	OrderAlreadyFilled	Order already fully filled, cannot modify	IncreaseLimitOrder / DecreaseLimitOrder вызван для заказа, чья невыполненная часть равна нулю.	”This limit order is already filled — settle to receive output.”
6041	InvalidOrderPhase	Invalid order phase	Изменение заказа, чья фаза FIFO cohort больше не совпадает с текущей фазой cohort tick.	”Cannot perform this action in the order’s current state.”
6042	InvalidLimitOrderAmount	Invalid limit order amount	Входная сумма заказа ниже минимума пула (или нулевая) при открытии / увеличении / уменьшении.	”Order size is below the pool’s minimum.”
6043	OrderPhaseSaturated	Tick order phase saturated	Счетчик order_phase cohort на tick насыщен; дальнейшие заказы не могут быть открыты на этом tick, пока существующие cohorts не урегулируют и не перейдут.	”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 отклонен; или CreateCustomizablePool включил динамическую комиссию без действительной конфигурации.	N/A на пути администратора; “Dynamic fee config invalid” на пути пользователя.
6045	InvalidFeeOn	Invalid fee on which token (must be 0, 1, or 2)	CreateCustomizablePool передал значение collect_fee_on вне {0, 1, 2}.	”Internal: invalid fee mode.”
6046	ZeroSqrtPrice	sqrt_price_x64 must be greater than 0	CreateCustomizablePool (или другой путь, принимающий настраиваемую начальную sqrt цену) был вызван с sqrt_price_x64 == 0.	”Initial price must be greater than zero.”
6047	ZeroLiquidity	liquidity must be greater than 0	Путь предоставления ликвидности был вызван с liquidity == 0 и без компенсирующей суммы.	”Liquidity amount must be greater than zero.”
6048	MissingBaseFlag	base_flag is required when liquidity is zero	Путь открытия позиции по сумме вычислил liquidity == 0 и вызывающий не предоставил base_flag для уточнения, какая сторона является базой.	”Provide either a non-zero liquidity or specify which token is the base.”
6049	MissingMintAccount	Mint account is required but not provided	Путь, осведомленный о Token-2022, был вызван без требуемого аккаунта входного/выходного mint для проверки расширений и комиссий передачи.	”Internal: missing mint account — refresh pool data.”
6050	MissingTokenProgram2022	Token-2022 program is required but not provided	То же самое для аккаунта программы SPL-Token-2022.	”Internal: missing Token-2022 program — refresh and retry.”

Примечание о перенумерации. Enum ErrorCode CLMM был перенумерован в этом выпуске: пять устаревших вариантов (LOK, ZeroMintAmount, InvalidLiquidity, TransactionTooOld, InvalidRewardDesiredAmount) и несколько опечаток (Liquitity, enought, emissiones) были удалены/исправлены, и одиннадцать новых вариантов были добавлены. Поскольку Anchor нумерует ошибки по порядку в исходном коде, каждый код на 6000 или после него сместился относительно сборок до выпуска. Клиенты, которые жестко кодировали числовые коды для более ранней версии, должны переотобразить.

Источник регенерации: github.com/raydium-io/raydium-clmm — error.rs.

​

Ошибки AMM v4, Farm v3 / v5 / v6, LaunchLab

Эти программы документированы в их соответствующих главах (см. products/amm-v4/instructions, products/farm-staking/instructions, products/launchlab/instructions). Поскольку эти программы используют смесь поверхностей ошибок Anchor и простого Solana, их таблицы ошибок находятся рядом со справочником инструкций, а не здесь. Коды ниже зарезервированы этими главами:

Программа	Диапазон кодов (только Anchor)	Справка
AMM v4	Пользовательские коды u32, не в стиле Anchor	products/amm-v4/instructions
Farm v3 / v5	Пользовательские коды u32	products/farm-staking/instructions
Farm v6	6000+ (Anchor)	products/farm-staking/instructions
LaunchLab	6000+ (Anchor)	products/launchlab/instructions

Недавние выпуски LaunchLab сохраняют коды 6000–6021 без изменений. Выпуск 2026-08-17 удалил бывшие ошибки глобального доступа платформы и назначил 6022 ошибке валидации allow-account; выпуск 2026-08-24 добавляет 6023; выпуск 2026-08-31 добавляет 6024–6030:

Код	Имя	Значение
6018	NotEnoughRemainingAccounts	Требуемый оставшийся аккаунт отсутствует. Это включает требуемый PlatformAllowConfig, требуемый PlatformCurveRule и расширенный набор аккаунтов миграции CPMM.
6020	CurveParamIsNotExist	Снято с производства. Сохранено как заполнитель, чтобы коды после него не сместились; выпуск 2026-08-31 удалил его последнего вызывающего.
6022	InvalidPlatformAllowConfig	Предоставленный allow аккаунт не кодирует ожидаемую пару платформы и глобальной конфигурации.
6023	CalculateOverflow	Расчет комиссии передачи Token-2022 или обратной комиссии передачи не может быть представлен. Достижимо на путях точного выхода, когда комиссия quote mint не может быть инвертирована (например mint со 100%-комиссией).
6024	InvalidPlatformCurveRule	Предоставленный аккаунт правила не является PDA пары платформы и конфигурации, под которой запускается.
6025	CurveParamNotMatchPlatformRule	Параметры запуска не удовлетворяют ни одной группе проверки правила платформы. Единственная ошибка, которую может получить создатель — выведите ее как “this launch shape is not allowed on this platform”.
6026	CurveRuleGroupNotExist	RemovePlatformCurveRule был вызван с group_id, который правило не содержит.
6027	CurveRuleGroupsExceeded	Правило не может содержать более 10 групп проверки.
6028	InvalidCurveRuleConstraint	Ограничение имеет неизвестное поле или оператор, группа имеет более 25 ограничений, или одна и та же пара (field, op) появляется дважды в одной группе.
6029	InvalidCurveRuleAuthority	Подписант не является ни PlatformConfig.curve_rule_manager, ни администратором платформы.
6030	CurveRuleFieldNotSupportedByCurve	Ограничение читает total_base_sell на конфигурации, чья кривая его выводит — кривые с фиксированной ценой и линейной ценой. Возникает при написании правила, а не при запуске запуска.

Старые варианты PlatformGlobalAccessDenied (6022) и InvalidPlatformGlobalAccess (6023) удалены. Не декодируйте 6022 с использованием предыдущего IDL, и обратите внимание, что 6023 — освобожденный выпуском 2026-08-17 — переиспользуется выпуском 2026-08-24 для несвязанной ошибки, поэтому его не следует декодировать с IDL из любой более ранней версии.

6020 сохранен намеренно. Anchor нумерует варианты по позиции, поэтому удаление его сместит каждый код после него и нарушит каждого клиента, который декодирует 6021–6030.

​

Сопоставление ошибок SDK с ошибками программы

Официальный TypeScript SDK оборачивает ошибки на цепи в SendTransactionError и, для программ 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 для строки "custom program error: 0x...".
  }
}

Если вы не используете Anchor на стороне клиента, разберите логи транзакции:

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

Паттерн Error Number: (\d+) стабилен во всех версиях Anchor и безопасен для сопоставления.

​

Регенерация этих таблиц

Когда программа обновляется и добавляется новая ошибка, повторно извлеките из исходного кода:

# Клонируйте и grep enum ошибок по порядку.
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
# Замените 6000+++ на монотонно возрастающие 6000,6001,... Добавьте новые строки в таблицу выше.

Всегда обновляйте reference/changelog при добавлении нового варианта, чтобы интеграторы, обновляющие SDK, знали, что нужно обновить обработчики ошибок.

Источники:

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