에러 코드 - 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`).	”이 토큰은 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	호출자가 이 명령어의 구성된 관리자가 아닙니다. 또는 (권한 명령어) 서명자가 `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	틱 배열 인덱싱에서 오프바이원.	”내부: 틱 배열 경계 에러.”
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` 모두 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 가격을 허용하는 다른 경로)이 `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`	필수 남은 계정이 누락되었습니다. 여기에는 필수 `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`	제약 조건이 4개의 상수 곱 전용 필드 중 하나를 읽습니다 — `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 버전 전체에서 안정적이며 매칭하기에 안전합니다.

이 표 재생성

프로그램이 업그레이드되고 새로운 에러를 추가할 때 소스에서 다시 추출하세요:

# 저장소를 복제하고 에러 열거형을 순서대로 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 에러를 프로그램 에러에 매핑

이 표 재생성