오류 코드

Raydium 온체인 프로그램의 Anchor 오류 열거형으로, 각 오류의 원인과 권장 UX 메시지를 포함합니다.

이 페이지는 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)을 만났습니다.	”이 토큰은 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의 경우 두 크리에이터 카운터 모두 0이었습니다.	”수집할 것이 없습니다.” 이를 양성 경쟁으로 취급하고 중지하세요.
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	필수 나머지 계정이 트랜잭션에서 누락됨 (일반적으로 틱 배열 또는 오라클 확장); 또는 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	틱 배열 인덱싱에서 오프바이원 오류.	”내부: 틱 배열 경계 오류.”
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	IncreaseLimitOrder / DecreaseLimitOrder이 미충전 부분이 0인 오더에서 호출됨.	”이 리미트 오더는 이미 체결되었습니다 — 출력을 받으려면 정산하세요.”
6041	InvalidOrderPhase	Invalid order phase	FIFO 코호트 단계가 더 이상 틱의 현재 코호트와 일치하지 않는 오더를 변경함.	”오더의 현재 상태에서는 이 작업을 수행할 수 없습니다.”
6042	InvalidLimitOrderAmount	Invalid limit order amount	오더 입력이 열기/증가/감소 시간에 풀의 최소값 미만(또는 0).	”오더 크기가 풀의 최소값 미만입니다.”
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 프로그램 누락 — 새로고침하고 다시 시도하세요.”
6051	InvalidTickArrayBitmapExtensionAccount	TickArrayBitmapExtension account does not belong to this pool	제공된 비트맵 확장 계정이 이 풀에 대해 파생된 계정이 아님. 스왑 경로가 스왑당 find_program_address 호출을 중단하고 대신 pool_id로 확장을 바인딩하기 시작했을 때 추가됨.	”내부: 잘못된 틱 배열 확장 — 풀 데이터를 새로고침하세요.”
6052	LamportsCalculateError	Lamports calculate error	CollectExcessLamports가 래핑된 SOL 금고를 정리했고, SyncNative → UnwrapLamports 왕복이 래핑된 토큰 잔액을 시작 위치에 두지 않음. 2026-09-30 업그레이드에 의해 추가됨; 코드 6000–6051은 변경되지 않음.	N/A — 관리자 전용 경로.

재번호 매기기에 대한 참고. CLMM ErrorCode 열거형이 이 릴리스에서 재번호 매겨졌습니다: 5개의 레거시 변수(LOK, ZeroMintAmount, InvalidLiquidity, TransactionTooOld, InvalidRewardDesiredAmount)와 여러 오타(Liquitity, enought, emissiones)가 제거/수정되었고, 11개의 새로운 변수(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	필수 remaining account가 누락되었습니다. 여기에는 필수 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)를 통해 변환되므로 코드는 6000이 아닌 **0**에서 시작합니다. 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)