エラーコード - Raydium Docs

このページは AI による自動翻訳です。すべての内容は英語版を正とします。英語版を表示 →

信頼できる情報源。 以下の表は、公開されている Raydium リポジトリの各プログラムの error.rs から再生成されます。プログラムがアップグレードされて新しいバリアントが追加された場合、抽出を再実行し（各表の下部のリンク）、表を再構成するのではなく新しい行を追加してください。Anchor エラーコードはソースの順序で割り当てられ、名前ではないため、並べ替えるとインテグレーターのエラーハンドリングが破損します。

Anchor エラーコードの仕組み

Anchor は、プログラムの ErrorCode 列挙型の各バリアントに 6000 から始まる数値コードを割り当てます。失敗したトランザクションは以下を表示します：

数値エラーコード（例：0x1771 = 6001）がトランザクションログに表示されます。
エラー名（例：InvalidOwner）が IDL から取得されます。
#[msg(...)] 文字列が Anchor によって log_messages に出力されます。

インテグレーターは、メッセージ文字列ではなく数値コードで照合する必要があります（文字列はバージョンをバンプせずに言い換えることができます）。

// 例：CPMM スリッページ エラーを検出し、クリーンな UX メッセージを表示します。
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]` 文字列	一般的な原因	推奨される UX
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]` 文字列	一般的な原因	推奨される UX
6000	`NotApproved`	Not approved	呼び出し元がこの命令の設定済み管理者ではありません。または（権限命令）署名者が `admin` でも `permission_pda_admin` でもありません。または（`OpenLimitOrder`）入出力トークンアカウントが凍結されているか、プールがスワップ / リミットオーダーを無効にしています。または（`ClosePosition`、凍結パス）提供された残りのアカウントが `personal_position.pool_id` ではありません。	“このアクションを実行できるのはプール管理者のみです。” / “このトークンアカウントは凍結されています — オーダーを配置する前に解凍してください。” / “内部エラー：ポジションプールアカウントが間違っています。“
6001	`InvalidUpdateConfigFlag`	invalid update amm config flag	管理者が認識されない `param` 値を `update_amm_config` に渡しました。	N/A — 管理者のみのパス。
6002	`AccountLack`	Account lack	必要な残りのアカウントが tx から欠落しています（通常、ティック配列またはオラクル拡張機能）。または `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)	下限ティックアンダーフロー。	“下限価格が低すぎます。“
6007	`TickUpperOverflow`	The tick must be lesser than, or equal to the maximum tick(443636)	上限ティックオーバーフロー。	“上限価格が高すぎます。“
6008	`TickAndSpacingNotMatch`	tick % tick_spacing must be zero	送信されたティックがプールの `tick_spacing` の倍数ではありません。	“価格を最も近い有効な増分にスナップしてください。“
6009	`InvalidTickArray`	Invalid tick array account	ティック配列スロットに対して間違った PDA が渡されました。	“内部エラー：ティック配列が間違っています — プールデータを更新してください。“
6010	`InvalidTickArrayBoundary`	Invalid tick array boundary	ティック配列インデックスの 1 つずれ。	“内部エラー：ティック配列の境界エラー。“
6011	`SqrtPriceLimitOverflow`	Square root price limit overflow	呼び出し元が指定した `sqrt_price_limit` が有効な範囲外です。	“価格制限が範囲外です。“
6012	`SqrtPriceX64`	sqrt_price_x64 out of range	プールの現在の sqrt 価格がスワップ中に範囲外にドリフトしました。	“スワップを再試行してください。“
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` の両方がゼロの流動性供給呼び出し。	“少なくとも 1 つのトークンを提供してください。“
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	スワップ範囲に対して十分なティック配列の残りのアカウントが提供されていません。	“内部エラー：ティック配列が不足しています — プールデータを更新してください。“
6024	`InvalidFirstTickArrayAccount`	Invalid first tick array account	渡された最初のティック配列アカウントが現在のティックをカバーしていません。	“内部エラー：最初のティック配列が間違っています — プールデータを更新してください。“
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 より前、報酬ミントはプールのボールトミントの 1 つと等しい必要があります。	N/A — 管理者パス。
6029	`InvalidRewardInitParam`	Invalid reward init param	不正な発行開始/終了時刻または 1 秒あたりのレート。	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	スワップがベースビットマップでカバーされていないティック範囲を横切りました。拡張ビットマップアカウントが必要です。	“内部エラー：ティック配列拡張が欠落しています — プールデータを更新してください。“
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 コホートフェーズがティックの現在のコホートと一致しなくなったオーダーを変更しています。	“オーダーの現在の状態ではこのアクションを実行できません。“
6042	`InvalidLimitOrderAmount`	Invalid limit order amount	オーダー入力がオープン / 増加 / 削減時にプールの最小値を下回っています（またはゼロ）。	“オーダーサイズがプールの最小値を下回っています。“
6043	`OrderPhaseSaturated`	Tick order phase saturated	コホートの `order_phase` カウンターがティックで飽和しています。既存のコホートが決済してロールオーバーするまで、そのティックで新しいオーダーを開くことはできません。	“この価格でのアクティブなオーダーが多すぎます。近くのティックを試すか、オーダーが決済されるまで待ってください。“
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 価格を受け入れる別のパス）が `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 列挙型はこのリリースで番号付けが変更されました：5 つのレガシーバリアント（LOK、ZeroMintAmount、InvalidLiquidity、TransactionTooOld、InvalidRewardDesiredAmount）といくつかのタイプミス（Liquitity、enought、emissiones）が削除/修正され、11 の新しいバリアントが追加されました。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 {
    // 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 をアップグレードするインテグレーターがエラーハンドラーを更新する必要があることを知ることができます。ソース：

​Anchor エラーコードの仕組み

​CPMM（標準 AMM）エラー

​CLMM エラー

​AMM v4、Farm v3 / v5 / v6、LaunchLab エラー

​SDK エラーをプログラム エラーにマッピングする

​これらのテーブルを再生成する

Anchor エラーコードの仕組み

CPMM（標準 AMM）エラー

CLMM エラー

AMM v4、Farm v3 / v5 / v6、LaunchLab エラー

SDK エラーをプログラムエラーにマッピングする

これらのテーブルを再生成する