Коды ошибок

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("Цена вышла за пределы вашей толерантности к slippage. Увеличьте slippage или повторите попытку.");
    return;
  }
  throw err;
}

​

Ошибки CPMM (Standard AMM)

ID программы: см. /ru/reference/program-addresses. Источник: raydium-cp-swap/programs/cp-swap/src/error.rs.

Код	Вариант	Строка #[msg]	Типичная причина	Рекомендуемое сообщение UX
6000	NotApproved	Not approved	Вызывающий не является настроенным органом для инструкции администратора.	”Только администратор пула может выполнить это действие.”
6001	InvalidOwner	Input account owner is not the program address	Переданный счёт принадлежит неправильной программе (часто неправильная программа токенов или PDA неправильной программы).	”Внутренняя ошибка: несоответствие владельца счёта — обновите и повторите попытку.”
6002	EmptySupply	Input token account empty	Баланс LP или счёта токена равен нулю на этапе, требующем положительной суммы.	”Нечего выводить.”
6003	InvalidInput	InvalidInput	Неправильный аргумент (сумма вне диапазона, неправильный флаг).	”Неправильный ввод — проверьте суммы и повторите попытку.”
6004	IncorrectLpMint	Address of the provided lp token mint is incorrect	Переданный счёт LP mint не совпадает с pool_state.lp_mint.	”Внутренняя ошибка: неправильный LP mint — обновите данные пула.”
6005	ExceededSlippage	Exceeds desired slippage limit	Выполненная цена хуже, чем minAmountOut / maxAmountIn пользователя.	”Цена вышла за пределы вашей толерантности к slippage. Увеличьте slippage или повторите попытку.”
6006	ZeroTradingTokens	Given pool token amount results in zero trading tokens	Математика депозита / вывода округлила одну сторону до нуля (позиция слишком мала).	”Сумма ниже минимума для этого пула.”
6007	NotSupportMint	Not support token_2022 mint extension	Пул встретил расширение Token-2022, которое не может безопасно обработать (например TransferHook, DefaultAccountState=Frozen).	”Этот токен имеет расширение, которое Raydium не поддерживает в CPMM.”
6008	InvalidVault	invaild vault	Переданный счёт vault не совпадает с записанным в pool_state.	”Внутренняя ошибка: неправильный vault — обновите и повторите попытку.”
6009	InitLpAmountTooLess	Init lp amount is too less(Because 100 amount lp will be locked)	При инициализации пула вычисленное предложение LP ниже суммы постоянной блокировки.	”Начальная ликвидность слишком мала. Увеличьте депозит.”
6010	TransferFeeCalculateNotMatch	TransferFee calculate not match	Наблюдаемая сумма после передачи для Token-2022 mint с комиссией не совпадает с предварительно вычисленным ожиданием.	”Комиссия за передачу токена изменилась во время транзакции. Повторите попытку.”
6011	MathOverflow	Math overflow	Промежуточный расчёт swap / депозита / комиссии переполнился.	”Сумма слишком велика для этого пула.”
6012	InsufficientVault	Insufficient vault	Баланс vault пула слишком низок для покрытия запрошенного выхода.	”Недостаточно ликвидности в пуле для такого размера.”
6013	InvalidFeeModel	Invalid fee model	Администратор установил комбинацию параметров AmmConfig, которая отклоняется в блокчейне.	N/A — путь только для администратора.
6014	NoFeeCollect	Fee is zero	Инструкция сбора комиссии протокола, фонда или создателя не нашла собираемых комиссий. Для CollectCreatorFeePermissionless оба счётчика создателя были нулевыми.	”Нечего собирать.” Рассматривайте как доброкачественное состояние гонки и остановитесь.
6015	LamportsCalculateError	Lamports calculate error	CollectExcessLamports очистил счёт wrapped-SOL и round-trip SyncNative → UnwrapLamports не оставил баланс wrapped токена ровно там, где он был. Добавлено обновлением 2026-09; коды 6000–6014 не изменены.	N/A — путь только для администратора.

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

​

Ошибки CLMM

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

Код	Вариант	Строка #[msg]	Типичная причина	Рекомендуемый UX
6000	NotApproved	Not approved	Вызывающая сторона не является настроенным администратором для этой инструкции; или (OpenLimitOrder) входной/выходной счёт токена заморожен или пул имеет отключённый swap / limit-order; или (ClosePosition, frozen path) предоставленный оставшийся счёт не является personal_position.pool_id.	”Только администратор пула может выполнить это действие.” / “Этот счёт токена заморожен — разморозьте его перед размещением ордера.” / “Внутренняя ошибка: неправильный счёт позиции.”
6001	InvalidUpdateConfigFlag	invalid update amm config flag	Администратор передал неизвестное значение param в update_amm_config.	N/A — путь только для администратора.
6002	AccountLack	Account lack	Требуемый оставшийся счёт отсутствует в транзакции (обычно tick-array или расширение oracle); или ClosePosition закрывает замороженный NFT без пула в качестве первого оставшегося счёта.	”Внутренняя ошибка: отсутствует счёт — обновите данные пула или обновите построитель закрытия позиции.”
6003	ClosePositionErr	Remove liquidity, collect fees owed and reward then you can close position account	Попытка закрыть позицию, которая всё ещё имеет ликвидность, невыплаченные комиссии или невыплаченные награды.	”Выведите всю ликвидность и получите комиссии/награды перед закрытием позиции.”
6004	InvalidTickIndex	Tick out of range	tick_lower или tick_upper находится вне диапазона [-443636, 443636].	”Диапазон цен выходит за границы этого пула.”
6005	TickInvalidOrder	The lower tick must be below the upper tick	tick_lower >= tick_upper.	”Нижняя цена должна быть ниже верхней цены.”
6006	TickLowerOverflow	The tick must be greater, or equal to the minimum tick(-443636)	Переполнение нижнего tick.	”Нижняя цена слишком низкая.”
6007	TickUpperOverflow	The tick must be lesser than, or equal to the maximum tick(443636)	Переполнение верхнего tick.	”Верхняя цена слишком высокая.”
6008	TickAndSpacingNotMatch	tick % tick_spacing must be zero	Переданный tick не является кратным tick_spacing пула.	”Привяжите цену к ближайшему допустимому приращению.”
6009	InvalidTickArray	Invalid tick array account	Неправильный PDA передан для слота tick-array.	”Внутренняя ошибка: неправильный tick array — обновите данные пула.”
6010	InvalidTickArrayBoundary	Invalid tick array boundary	Ошибка на единицу в индексировании tick-array.	”Внутренняя ошибка: граница tick-array.”
6011	SqrtPriceLimitOverflow	Square root price limit overflow	Переданный вызывающей стороной sqrt_price_limit находится вне допустимого диапазона.	”Лимит цены выходит за границы диапазона.”
6012	SqrtPriceX64	sqrt_price_x64 out of range	Текущая цена sqrt пула вышла за границы диапазона во время swap.	”Повторите попытку swap.”
6013	LiquiditySubValueErr	Liquidity sub delta L must be smaller than before	Нарушение внутреннего инварианта при уменьшении ликвидности.	”Внутренняя ошибка: ошибка учёта ликвидности.”
6014	LiquidityAddValueErr	Liquidity add delta L must be greater, or equal to before	Нарушение внутреннего инварианта при увеличении ликвидности.	”Внутренняя ошибка: ошибка учёта ликвидности.”
6015	ForbidBothZeroForSupplyLiquidity	Both token amount must not be zero while supply liquidity	Вызов increase-liquidity с обоими amount_0_max и amount_1_max равными нулю.	”Предоставьте хотя бы один токен.”
6016	LiquidityInsufficient	Liquidity insufficient	Позиция не имеет достаточной ликвидности для удовлетворения вывода.	”Сумма вывода превышает ликвидность позиции.”
6017	PriceSlippageCheck	Price slippage check	Цена исполнения не прошла проверку slippage вызывающей стороны.	”Цена изменилась за пределы вашей допустимой slippage. Увеличьте slippage или повторите попытку.”
6018	TooLittleOutputReceived	Too little output received	SwapBaseInput: выходная сумма ниже other_amount_threshold.	”Slippage превышена — минимальный выход не достигнут.”
6019	TooMuchInputPaid	Too much input paid	SwapBaseOutput: входная сумма выше other_amount_threshold.	”Slippage превышена — максимальный вход превышен.”
6020	ZeroAmountSpecified	Swap special amount can not be zero	Нулевая amount в инструкции swap.	”Введите сумму больше нуля.”
6021	InvalidInputPoolVault	Input pool vault is invalid	Входной vault счёт swap не совпадает с записанным vault пула.	”Внутренняя ошибка: неправильный входной vault — обновите данные пула.”
6022	TooSmallInputOrOutputAmount	Swap input or output amount is too small	Математика swap округлилась до нуля, обычно очень маленькая пыль.	”Сумма слишком мала для swap в этом пуле.”
6023	NotEnoughTickArrayAccount	Not enough tick array account	Недостаточно оставшихся счётов tick-array для диапазона swap.	”Внутренняя ошибка: недостаточно tick-arrays — обновите данные пула.”
6024	InvalidFirstTickArrayAccount	Invalid first tick array account	Первый переданный счёт tick-array не охватывает текущий tick.	”Внутренняя ошибка: неправильный первый tick array — обновите данные пула.”
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.	”Внутренняя ошибка: неправильное количество счётов — обновите и повторите попытку.”
6031	InvalidRewardPeriod	Invalid reward period	Период выпуска reward недействителен (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	Слот reward не инициализирован, но на него ссылаются.	N/A — путь администратора.
6034	NotSupportMint	Not support token_2022 mint extension	CLMM встретил расширение Token-2022, которое не может обработать.	”Этот токен имеет расширение, которое Raydium CLMM не поддерживает.”
6035	MissingTickArrayBitmapExtensionAccount	Missing tickarray bitmap extension account	Swap пересёк диапазон tick, не охватываемый базовой bitmap; требуется счёт расширения bitmap.	”Внутренняя ошибка: отсутствует расширение tick-array — обновите данные пула.”
6036	InsufficientLiquidityForDirection	Insufficient liquidity for this direction	Недостаточно ликвидности в направлении swap.	”Недостаточно ликвидности для этого размера swap.”
6037	MaxTokenOverflow	Max token overflow	Входная/выходная сумма превышает u64.	”Сумма слишком велика для этого пула.”
6038	CalculateOverflow	Calculate overflow	Переполнение арифметики комиссии / ликвидности.	”Сумма слишком велика для этого пула.”
6039	TransferFeeCalculateNotMatch	TransferFee calculate not match	Наблюдаемая сумма комиссии передачи Token-2022 не совпадает с ожидаемой.	”Комиссия передачи токена изменилась во время транзакции. Повторите попытку.”
6040	OrderAlreadyFilled	Order already fully filled, cannot modify	IncreaseLimitOrder / DecreaseLimitOrder вызван для ордера, чья невыполненная часть равна нулю.	”Этот лимитный ордер уже выполнен — выполните расчёт для получения выхода.”
6041	InvalidOrderPhase	Invalid order phase	Изменение ордера, чья фаза когорты FIFO больше не совпадает с текущей когортой tick.	”Невозможно выполнить это действие в текущем состоянии ордера.”
6042	InvalidLimitOrderAmount	Invalid limit order amount	Входная сумма ордера ниже минимума пула (или нулевая) при открытии / увеличении / уменьшении.	”Размер ордера ниже минимума пула.”
6043	OrderPhaseSaturated	Tick order phase saturated	Счётчик order_phase когорты на tick насыщен; дальнейшие ордера не могут быть открыты на этом tick, пока существующие когорты не выполнят расчёт и не перейдут.	”Слишком много активных ордеров по этой цене; попробуйте соседний tick или дождитесь выполнения ордеров.”
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}.	”Внутренняя ошибка: недействительный режим комиссии.”
6046	ZeroSqrtPrice	sqrt_price_x64 must be greater than 0	CreateCustomizablePool (или другой путь, принимающий настраиваемую начальную цену sqrt) был вызван с sqrt_price_x64 == 0.	”Начальная цена должна быть больше нуля.”
6047	ZeroLiquidity	liquidity must be greater than 0	Путь предоставления ликвидности был вызван с liquidity == 0 и без компенсирующей суммы.	”Сумма ликвидности должна быть больше нуля.”
6048	MissingBaseFlag	base_flag is required when liquidity is zero	Путь открытия позиции по сумме вычислил liquidity == 0, и вызывающая сторона не предоставила base_flag для уточнения, какая сторона является базовой.	”Предоставьте либо ненулевую ликвидность, либо укажите, какой токен является базовым.”
6049	MissingMintAccount	Mint account is required but not provided	Путь, поддерживающий Token-2022, был вызван без требуемого счёта mint входного/выходного токена для проверки расширений и комиссий передачи.	”Внутренняя ошибка: отсутствует счёт mint — обновите данные пула.”
6050	MissingTokenProgram2022	Token-2022 program is required but not provided	То же самое, что выше, для счёта программы SPL-Token-2022.	”Внутренняя ошибка: отсутствует программа Token-2022 — обновите и повторите попытку.”
6051	InvalidTickArrayBitmapExtensionAccount	TickArrayBitmapExtension account does not belong to this pool	Предоставленный счёт расширения bitmap не является тем, который получен для этого пула. Добавлено, когда путь swap перестал вызывать find_program_address для каждого swap и начал привязывать расширение по pool_id.	”Внутренняя ошибка: неправильное расширение tick-array — обновите данные пула.”
6052	LamportsCalculateError	Lamports calculate error	CollectExcessLamports очистил wrapped-SOL vault, и round-trip SyncNative → UnwrapLamports не оставил баланс wrapped токена там, где он был. Добавлено обновлением 2026-09-30; коды 6000–6051 остаются без изменений.	N/A — путь только для администратора.

Примечание о переномеровании. Enum ErrorCode CLMM был переномерован в этом выпуске: пять устаревших вариантов (LOK, ZeroMintAmount, InvalidLiquidity, TransactionTooOld, InvalidRewardDesiredAmount) и несколько опечаток (Liquitity, enought, emissiones) были удалены/исправлены, и одиннадцать новых вариантов были добавлены (6040–6050) выпуском лимитных ордеров; 6051 (InvalidTickArrayBitmapExtensionAccount) пришёл из отдельного, более позднего изменения. Это дало 52 варианта, 6000–6051, что является количеством, которое сообщает IDL развёрнутой программы. Обновление 2026-09-30 добавляет 6052 без сдвига чего-либо, всего 53. Поскольку 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 с 0, не в стиле 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; релиз от 2026-09-09 добавляет 6031:

Код	Имя	Значение
6018	NotEnoughRemainingAccounts	Отсутствует требуемый оставшийся аккаунт. Это включает требуемый PlatformAllowConfig, требуемый PlatformCurveRule и расширенный набор аккаунтов миграции CPMM.
6020	CurveParamIsNotExist	Устарело. Сохранено как заполнитель, чтобы коды после него не сдвигались; релиз от 2026-08-31 удалил его последний вызов.
6022	InvalidPlatformAllowConfig	Предоставленный allow-аккаунт не кодирует ожидаемую пару конфигурации платформы и глобальной конфигурации.
6023	CalculateOverflow	Расчёт комиссии за передачу Token-2022 или обратной комиссии за передачу не может быть представлен. Достижимо на путях точного выхода при невозможности инвертировать комиссию mint котировки (например, mint со 100%-комиссией).
6024	InvalidPlatformCurveRule	Предоставленный аккаунт правила не является PDA пары платформы и конфигурации, под которой запускается.
6025	CurveParamNotMatchPlatformRule	Параметры запуска не удовлетворяют ни одной группе проверок правила платформы. Единственная ошибка, которую может получить создатель — представьте её как «эта форма запуска не разрешена на этой платформе».
6026	CurveRuleGroupNotExist	RemovePlatformCurveRule был вызван с group_id, который правило не содержит.
6027	CurveRuleGroupsExceeded	Правило не может содержать более 10 групп проверок.
6028	InvalidCurveRuleConstraint	Ограничение имеет неизвестное поле или оператор, группа имеет более 25 ограничений, или одна и та же пара (field, op) появляется дважды в одной группе.
6029	InvalidCurveRuleAuthority	Подписант — ни PlatformConfig.curve_rule_manager, ни администратор платформы.
6030	CurveRuleFieldNotSupportedByCurve	Ограничение читает одно из четырёх полей, специфичных для постоянного произведения — TotalSellA (4), SellRateA (13), MigrateAmountA (15), MigrateRateA (16) — на конфигурации, чья кривая выводит total_base_sell вместо того, чтобы брать его у создателя (кривые фиксированной цены и линейной цены). Возникает при записи правила, а не при запуске запуска.
6031	LamportsCalculateError	CollectExcessLamports очистил хранилище wrapped-SOL и цикл SyncNative → UnwrapLamports не оставил баланс wrapped-токена ровно там, где он был. Путь только для администратора.

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

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

​

AMM v4: AmmError не нумеруется в стиле Anchor

AMM v4 предшествует Anchor. AmmError — это обычный enum thiserror с FromPrimitive, преобразуемый через ProgramError::Custom(e as u32), поэтому его коды начинаются с 0, а не 6000 — и, как в Anchor, назначаются по порядку источника. Обновление 2026-09 добавляет один вариант:

Код	Вариант	Строка #[error]	Причина
60	LamportsCalculateError	Lamports calculate error.	WithdrawExcessLamports очистил wrapped-SOL аккаунт и цикл SyncNative → UnwrapLamports не оставил баланс wrapped-токена ровно там, где он был. Путь только для администратора.

Коды 0–59 не изменены, поэтому ничего не сдвигается. В логах транзакций это отображается как custom program error: 0x3c. Источник регенерации: github.com/raydium-io/raydium-amm — error.rs.

​

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

Официальный TypeScript SDK оборачивает ошибки on-chain в SendTransactionError и, для программ Anchor, AnchorError:

import { AnchorError } from "@anchor-lang/core";

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.
  }
}

Если вы не используете 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 и безопасен для сопоставления.

​

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

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

# 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.

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

Источники:

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