错误代码 - Raydium Docs

本页内容由 AI 自动翻译，所有内容以英文版本为准。查看英文版 →

权威来源。 下表从公开 Raydium 仓库中每个程序的 error.rs 重新生成。当程序升级并添加新变体时，重新运行提取（每个表底部有链接）并追加到表中，而不是重新排列——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("Price moved past your slippage tolerance. Increase slippage or retry.");
    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 铸币账户与 `pool_state.lp_mint` 不匹配。	“内部：错误的 LP 铸币——刷新池数据。“
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	中间交换/存入/费用计算溢出。	“金额对此池来说太大。“
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`）输入/输出代币账户被冻结或池禁用了交换/限价单；或（`ClosePosition`、冻结路径）提供的剩余账户不是 `personal_position.pool_id`。	“只有池管理员可以执行此操作。” / “此代币账户被冻结——在下单前解冻。” / “内部：错误的头寸池账户。“
6001	`InvalidUpdateConfigFlag`	invalid update amm config flag	管理员向 `update_amm_config` 传递了无法识别的 `param` 值。	N/A——仅限管理员路径。
6002	`AccountLack`	Account lack	缺少必需的剩余账户（通常是 tick 数组或预言机扩展）；或 `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	为 tick 数组槽传递了错误的 PDA。	“内部：错误的 tick 数组——刷新池数据。“
6010	`InvalidTickArrayBoundary`	Invalid tick array boundary	tick 数组索引中的差一错误。	“内部：tick 数组边界错误。“
6011	`SqrtPriceLimitOverflow`	Square root price limit overflow	调用者提供的 `sqrt_price_limit` 超出有效范围。	“价格限制超出范围。“
6012	`SqrtPriceX64`	sqrt_price_x64 out of range	池的当前平方根价格在交换中途漂出范围。	“重试交换。“
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`。	“输入大于零的金额。“
6021	`InvalidInputPoolVault`	Input pool vault is invalid	交换的输入金库账户与池的记录金库不匹配。	“内部：错误的输入金库——刷新池数据。“
6022	`TooSmallInputOrOutputAmount`	Swap input or output amount is too small	交换数学四舍五入为零，通常是非常小的灰尘。	“金额太小，无法在此池中交换。“
6023	`NotEnoughTickArrayAccount`	Not enough tick array account	为交换范围提供的 tick 数组剩余账户不足。	“内部：tick 数组不足——刷新池数据。“
6024	`InvalidFirstTickArrayAccount`	Invalid first tick array account	传入的第一个 tick 数组账户不覆盖当前 tick。	“内部：错误的第一个 tick 数组——刷新池数据。“
6025	`InvalidRewardIndex`	Invalid reward index	`reward_index` 在 `[0, 2]` 范围外。	N/A——管理员路径。
6026	`FullRewardInfo`	The init reward token reach to the max	池已配置最大（3 个）奖励铸币。	N/A——管理员路径。
6027	`RewardTokenAlreadyInUse`	The init reward token already in use	奖励铸币与现有的重复。	N/A——管理员路径。
6028	`ExceptRewardMint`	The reward tokens must contain one of pool vault mint except the last reward	在前置槽 2，奖励铸币必须等于池金库铸币之一。	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	交换跨越了基础位图未覆盖的 tick 范围；需要扩展位图账户。	“内部：缺少 tick 数组扩展——刷新池数据。“
6036	`InsufficientLiquidityForDirection`	Insufficient liquidity for this direction	交换方向上没有足够的流动性。	“此交换规模的流动性不足。“
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	tick 上队列的 `order_phase` 计数器已饱和；在现有队列结算并翻转之前，无法在该 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_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 感知路径，但未提供验证扩展和转账费所需的输入/输出铸币账户。	“内部：缺少铸币账户——刷新池数据。“
6050	`MissingTokenProgram2022`	Token-2022 program is required but not provided	与上述相同，用于 SPL-Token-2022 程序账户。	“内部：缺少 Token-2022 程序——刷新并重试。”

关于重新编号的说明。 CLMM ErrorCode 枚举在此版本中被重新编号：五个遗留变体（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）变体被移除。不要使用之前的 IDL 解码 6022。

将 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 错误映射到程序错误

重新生成这些表