錯誤代碼 - 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`，兩個創作者計數器都為零。	“沒有可收集的內容。” 將其視為良性競爭並停止。
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]` 字串	典型原因	建議的使用者介面
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 程式遺失——重新整理並重試。“
6051	`InvalidTickArrayBitmapExtensionAccount`	TickArrayBitmapExtension account does not belong to this pool	提供的位圖擴展帳戶不是為此資金池衍生的帳戶。在交換路徑停止按交換呼叫 `find_program_address` 並開始按 `pool_id` 綁定擴展時新增。	“內部：tick 陣列擴展錯誤——重新整理資金池資料。”

關於重新編號的注意事項。 CLMM ErrorCode 列舉在此版本中被重新編號：五個舊版變體（LOK、ZeroMintAmount、InvalidLiquidity、TransactionTooOld、InvalidRewardDesiredAmount）和幾個拼寫錯誤（Liquitity、enought、emissiones）被移除/修復，而限價訂單版本附加了十一個新變體（6040–6050）；6051（InvalidTickArrayBitmapExtensionAccount）來自另一個較晚的變更。這樣總共有 52 個變體，6000–6051 — 與已部署程式的鏈上 IDL 所報告的數量相同。因為 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 {
    // 原始 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 錯誤

​AMM v4：AmmError 不是 Anchor 編號的

​將 SDK 錯誤對應到程式錯誤

​重新生成這些表格

Anchor 錯誤代碼如何運作

CPMM（標準 AMM）錯誤

CLMM 錯誤

AMM v4、Farm v3 / v5 / v6、LaunchLab 錯誤

AMM v4：`AmmError` 不是 Anchor 編號的

將 SDK 錯誤對應到程式錯誤

重新生成這些表格