Коды ошибок - Raydium Docs

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

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

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

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

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

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

// Пример: обнаружить ошибку проскальзывания CPMM и показать понятное сообщение.
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("Цена изменилась за пределы допустимого проскальзывания. Увеличьте проскальзывание или повторите попытку.");
    return;
  }
  throw err;
}

Ошибки CPMM (стандартный AMM)

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

Код	Вариант	Строка `#[msg]`	Типичная причина	Рекомендуемое сообщение
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` пользователя.	”Цена изменилась за пределы допустимого проскальзывания. Увеличьте проскальзывание или повторите попытку.”
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	Переданный счёт хранилища не совпадает с записанным в `pool_state`.	”Внутренняя ошибка: неправильное хранилище — обновите и повторите попытку.”
6009	`InitLpAmountTooLess`	Init lp amount is too less(Because 100 amount lp will be locked)	При инициализации пула вычисленное предложение LP ниже постоянно заблокированной суммы.	”Начальная ликвидность слишком мала. Увеличьте депозит.”
6010	`TransferFeeCalculateNotMatch`	TransferFee calculate not match	Наблюдаемая сумма после передачи для Token-2022 с комиссией не совпадает с предварительно вычисленным ожиданием.	”Комиссия за передачу токена изменилась во время транзакции. Повторите попытку.”
6011	`MathOverflow`	Math overflow	Промежуточный расчёт swap / депозита / комиссии переполнился.	”Сумма слишком велика для этого пула.”
6012	`InsufficientVault`	Insufficient vault	Баланс хранилища пула слишком низок для покрытия запрошенного выхода.	”Недостаточно ликвидности в пуле для такого размера.”
6013	`InvalidFeeModel`	Invalid fee model	Администратор установил комбинацию параметров `AmmConfig`, которая отклоняется в блокчейне.	N/A — путь только для администратора.
6014	`NoFeeCollect`	Fee is zero	Инструкция сбора комиссии протокола, фонда или создателя не нашла собираемых комиссий. Для `CollectCreatorFeePermissionless` оба счётчика создателя были нулевыми.	”Нечего собирать.” Рассматривайте как доброкачественное состояние гонки и остановитесь.

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

Ошибки CLMM

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

Код	Вариант	Строка `#[msg]`	Типичная причина	Рекомендуемое сообщение
6000	`NotApproved`	Not approved	Вызывающий не является настроенным администратором для этой инструкции; или (инструкции разрешений) подписант не является ни `admin`, ни `permission_pda_admin`; или (`OpenLimitOrder`) счёт входного/выходного токена заморожен или пул имеет отключённый swap / лимитный ордер; или (`ClosePosition`, замороженный путь) предоставленный оставшийся счёт не является `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	Вызов увеличения ликвидности с обоими `amount_0_max` и `amount_1_max` равными нулю.	”Предоставьте хотя бы один токен.”
6016	`LiquidityInsufficient`	Liquidity insufficient	Позиция не имеет достаточной ликвидности для удовлетворения вывода.	”Сумма вывода превышает ликвидность позиции.”
6017	`PriceSlippageCheck`	Price slippage check	Цена выполнения не прошла проверку проскальзывания вызывающего.	”Цена изменилась за пределы допустимого проскальзывания. Увеличьте проскальзывание или повторите попытку.”
6018	`TooLittleOutputReceived`	Too little output received	`SwapBaseInput`: выходная сумма ниже `other_amount_threshold`.	”Проскальзывание превышено — минимальный выход не достигнут.”
6019	`TooMuchInputPaid`	Too much input paid	`SwapBaseOutput`: входная сумма выше `other_amount_threshold`.	”Проскальзывание превышено — максимальный вход превышен.”
6020	`ZeroAmountSpecified`	Swap special amount can not be zero	Нулевая `amount` в инструкции swap.	”Введите сумму больше нуля.”
6021	`InvalidInputPoolVault`	Input pool vault is invalid	Счёт входного хранилища swap не совпадает с записанным в пуле.	”Внутренняя ошибка: неправильное входное хранилище — обновите данные пула.”
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) настроенных mint вознаграждений.	N/A — путь администратора.
6027	`RewardTokenAlreadyInUse`	The init reward token already in use	Mint вознаграждения дублирует существующий.	N/A — путь администратора.
6028	`ExceptRewardMint`	The reward tokens must contain one of pool vault mint except the last reward	До слота 2 mint вознаграждения должен равняться одному из mint хранилищ пула.	N/A — путь администратора.
6029	`InvalidRewardInitParam`	Invalid reward init param	Неправильное время начала/конца выпуска или скорость в секунду.	N/A — путь администратора.
6030	`InvalidRewardInputAccountNumber`	Invalid collect reward input account number	Неправильное количество оставшихся счётов, переданных в `CollectReward`.	”Внутренняя ошибка: неправильное количество счётов — обновите и повторите попытку.”
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, которое не может обработать.	”Этот токен имеет расширение, которое Raydium CLMM не поддерживает.”
6035	`MissingTickArrayBitmapExtensionAccount`	Missing tickarray bitmap extension account	Swap пересёк диапазон tick, не охватываемый базовой битовой картой; требуется счёт расширения битовой карты.	”Внутренняя ошибка: отсутствует расширение 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 на пути администратора; “Конфигурация динамической комиссии неправильна” на пути пользователя.
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 — обновите и повторите попытку.”

Примечание о переумерации. Перечисление 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 без изменений. Он удаляет бывшие ошибки глобального доступа платформы и присваивает 6022 новой ошибке проверки разрешённого счёта:

Код	Имя	Значение
6018	`NotEnoughRemainingAccounts`	Отсутствует требуемый оставшийся счёт. Это включает требуемый `PlatformAllowConfig` и расширенный набор счётов миграции CPMM.
6022	`InvalidPlatformAllowConfig`	Предоставленный счёт разрешения не кодирует ожидаемую пару платформы и глобальной конфигурации.

Старые варианты PlatformGlobalAccessDenied (6022) и InvalidPlatformGlobalAccess (6023) удалены. Не декодируйте 6022 с использованием предыдущего IDL.

Сопоставление ошибок 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 {
    // Необработанная SendTransactionError — проверьте 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 перечисление ошибок по порядку.
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, знали о необходимости обновить обработчики ошибок. Источники:

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

​Ошибки CPMM (стандартный AMM)

​Ошибки CLMM

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

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

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

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

Ошибки CPMM (стандартный AMM)

Ошибки CLMM

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

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

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