錯誤代碼

Raydium 鏈上程式的 Anchor 錯誤列舉，包含原因和建議的使用者介面訊息。

本頁內容由 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	呼叫者不是管理員指令的已設定授權。	“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 鑄幣帳戶與 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 (原始碼中的拼寫錯誤)	傳入的保管庫帳戶與 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 費用鑄幣的觀察到的轉帳後金額與預先計算的預期不符。	“Token transfer fee changed mid-transaction. Retry.”
6011	MathOverflow	Math overflow	中間交換/存入/費用計算溢位。	“Amount is too large for this pool.”
6012	InsufficientVault	Insufficient 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.” 將其視為良性競爭並停止。
6015	LamportsCalculateError	Lamports calculate error	CollectExcessLamports 掃過包裝的 SOL 帳戶，SyncNative → UnwrapLamports 往返沒有將包裝的代幣餘額留在完全相同的位置。由 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) 輸入/輸出代幣帳戶被凍結或資金池已停用交換/限價單；或 (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) 個獎勵 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	交換跨越基礎位圖未涵蓋的 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 傳遞了超出 {0, 1, 2} 的 collect_fee_on 值。	「內部：無效的費用模式。」
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 感知路徑，但未提供驗證擴充和轉帳費用所需的輸入/輸出 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	提供的位圖擴充帳戶不是為此資金池衍生的帳戶。在交換路徑停止按交換呼叫 find_program_address 並開始改為按 pool_id 繫結擴充時新增。	「內部：tick 陣列擴充錯誤 — 重新整理資金池資料。」
6052	LamportsCalculateError	Lamports calculate error	CollectExcessLamports 掃過包裝的 SOL 金庫，SyncNative → UnwrapLamports 往返未將包裝代幣餘額留在其開始位置。由 2026-09-30 升級附加；代碼 6000–6051 保持不變。	N/A — 僅限管理員路徑。

關於重新編號的注意事項。 CLMM ErrorCode 列舉在此版本中重新編號：五個舊版變數（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	自 0 開始的自訂 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 指派給允許帳戶驗證錯誤；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	提供的允許帳戶未編碼預期的平台和全域設定對。
6023	CalculateOverflow	Token-2022 轉帳費用或反向轉帳費用計算無法表示。在精確輸出交易路徑上可達到，當報價幣種的費用無法反轉時（例如 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 掃過包裝的 SOL 保管庫，SyncNative → UnwrapLamports 往返未使包裝代幣餘額完全回到起始位置。僅限管理員路徑。

舊的 PlatformGlobalAccessDenied (6022) 和 InvalidPlatformGlobalAccess (6023) 變體已移除。不要使用舊版 IDL 解碼 6022，並注意 6023 — 由 2026-08-17 版本空出 — 由 2026-08-24 版本重新用於不相關的錯誤，因此不能使用早於任一版本的 IDL 解碼。

6020 被刻意保留。Anchor 按位置對變體進行編號，因此刪除它會移位之後的每個代碼，並破壞每個解碼 6021–6031 的用戶端。

​

AMM v4：AmmError 不是 Anchor 編號

AMM v4 早於 Anchor。AmmError 是一個帶有 FromPrimitive 的純 thiserror 列舉，通過 ProgramError::Custom(e as u32) 轉換，因此其代碼從 0 開始，而不是 6000 — 並且像 Anchor 一樣，按來源順序指派。2026-09 升級新增一個變體：

代碼	變體	#[error] 字串	原因
60	LamportsCalculateError	Lamports calculate error.	WithdrawExcessLamports 掃過包裝的 SOL 帳戶，SyncNative → UnwrapLamports 往返未使包裝代幣餘額完全回到起始位置。僅限管理員路徑。

代碼 0–59 保持不變，因此沒有任何移位。在交易日誌中，這顯示為 custom program error: 0x3c。重新生成來源：github.com/raydium-io/raydium-amm — error.rs。

​

將 SDK 錯誤對應到程式錯誤

官方 TypeScript SDK 將鏈上錯誤包裝到 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)