錯誤代碼

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	呼叫者不是管理員指令的已設定授權。	“只有資金池管理員可以執行此操作。“
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 不變。2026-08-17 版本移除了前平台全域存取錯誤，並將 6022 指派給允許帳戶驗證錯誤；2026-08-24 版本附加 6023；2026-08-31 版本附加 6024–6030：

代碼	名稱	含義
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	約束在曲線衍生的設定上讀取 total_base_sell——固定價格和線性價格曲線。在寫入規則時引發，而不是在啟動執行時。

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

6020 被刻意保留。Anchor 按位置編號變體，所以刪除它會移動其後的每個代碼，並破壞每個解碼 6021–6030 的用戶端。

​

將 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 的整合者知道重新整理其錯誤處理程式。

來源：

• raydium-cp-swap error.rs（主網 CPMM）
• raydium-clmm error.rs（主網 CLMM）