錯誤代碼 - 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 陣列或 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	為 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 錯誤對應到程式錯誤

重新生成這些表格