에러 코드 - 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 또는 토큰 계정 잔액이 양수 금액이 필요한 단계에서 0입니다.	”인출할 것이 없습니다.”
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	예치/인출 계산이 한쪽을 0으로 반올림했습니다(위치가 너무 작음).	”금액이 이 풀의 최소값 이하입니다.”
6007	`NotSupportMint`	Not support token_2022 mint extension	풀이 안전하게 처리할 수 없는 Token-2022 확장을 만났습니다(예: `TransferHook`, `DefaultAccountState=Frozen`).	”이 토큰은 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	수집 가능한 수수료가 0인 상태에서 `collect_protocol_fee` / `collect_fund_fee`가 호출되었습니다.	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	호출자가 이 명령어의 구성된 관리자가 아닙니다. 또는 (권한 명령어) 서명자가 `admin` 또는 `permission_pda_admin` 중 하나가 아닙니다. 또는 (`OpenLimitOrder`) 입출력 토큰 계정이 동결되었거나 풀이 스왑/리미트 오더를 비활성화했습니다.	”풀 관리자만 이 작업을 수행할 수 있습니다.” / “이 토큰 계정이 동결되었습니다 — 오더를 배치하기 전에 해제하세요.”
6001	`InvalidUpdateConfigFlag`	invalid update amm config flag	관리자가 인식할 수 없는 `param` 값을 `update_amm_config`에 전달했습니다.	N/A — 관리자 전용 경로.
6002	`AccountLack`	Account lack	필수 남은 계정이 트랜잭션에서 누락되었습니다(일반적으로 틱 배열 또는 오라클 확장).	”내부: 누락된 계정 — 풀 데이터를 새로고침하세요.”
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	틱 배열 인덱싱에서 오프바이원 오류.	”내부: 틱 배열 경계 오류.”
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` 모두 0인 유동성 증가 호출.	”최소한 하나의 토큰을 제공하세요.”
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	스왑 명령어에서 0 `amount`.	”0보다 큰 금액을 입력하세요.”
6021	`InvalidInputPoolVault`	Input pool vault is invalid	스왑의 입력 금고 계정이 풀의 기록된 금고와 일치하지 않습니다.	”내부: 잘못된 입력 금고 — 풀 데이터를 새로고침하세요.”
6022	`TooSmallInputOrOutputAmount`	Swap input or output amount is too small	스왑 계산이 0으로 반올림되었습니다(일반적으로 매우 작은 먼지).	”이 풀에서 스왑하기에는 금액이 너무 작습니다.”
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에서 보상 민트는 풀의 금고 민트 중 하나와 같아야 합니다.	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`, 0 기간).	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	미충전 부분이 0인 오더에서 `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_price_x64 == 0`으로 호출되었습니다.	”초기 가격은 0보다 커야 합니다.”
6047	`ZeroLiquidity`	liquidity must be greater than 0	유동성 제공 경로가 `liquidity == 0`으로 호출되었고 보상 금액이 없습니다.	”유동성 금액은 0보다 커야 합니다.”
6048	`MissingBaseFlag`	base_flag is required when liquidity is zero	금액별 오픈 포지션 경로가 `liquidity == 0`을 계산했고 호출자가 어느 쪽이 기본인지 명확히 하기 위해 `base_flag`를 제공하지 않았습니다.	”0이 아닌 유동성을 제공하거나 어느 토큰이 기본인지 지정하세요.”
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`

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 — "custom program error: 0x..." 줄에 대해 err.logs를 검사하세요.
  }
}

클라이언트 측에서 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 에러를 프로그램 에러로 매핑

이 표 재생성