Skip to main content
이 페이지는 AI 자동 번역입니다. 모든 내용은 영문판을 기준으로 합니다.영문판 보기 →
Raydium은 5년간 운영되어 왔습니다. 여러 프로그램이 3세대 또는 4세대에 이르렀습니다. 이 페이지는 운영자 관점에서 “어떤 프로그램 버전을 사용해야 하는가, 이전 버전들의 상태는 어떠한가, 현재 이전 버전을 사용 중이라면 어떻게 새 버전으로 이동하는가”를 다룹니다.

​
한눈에 보는 상태

이 표에서 가장 중요한 결론은 다음과 같습니다: AMM v4는 지원 중단되지 않았으며, CPMM이 새로운 기본값입니다 — 하지만 둘은 의도적으로 공존합니다. AMM v4 풀은 수년간의 거래 이력을 가지고 있으며 강제로 마이그레이션되지 않습니다. 새 풀을 어느 프로그램에 배포할지 선택하는 것은 권장사항이지 제약이 아닙니다.

​
AMM v4 — 상태 및 방향

AMM v4는 원래의 Raydium 풀 설계입니다: 상수곱 가격 책정 (x · y = k). 이는 OpenBook (이전의 Serum) 오더북 통합을 포함한 하이브리드 AMM으로 출시되었으며, 곡선의 일부를 바인딩된 마켓의 지정가 주문으로 미러링했습니다. OpenBook 통합은 이후 비활성화되었습니다 — 풀은 더 이상 OpenBook과 유동성을 공유하지 않으며 모든 스왑은 V2 스왑 엔드포인트를 통해 순수하게 곡선에 대해 실행됩니다. 현재 AMM v4는 실질적으로 OpenBook 계정이 비활성 상태로 보존된 순수 상수곱 AMM입니다.

​
동결된 것

  • 더 이상 새로운 수수료 계층 없음. AMM v4 수수료 구조는 풀별이며 배포 시 설정됩니다. 새 풀은 동일한 하드코딩된 ~0.25% 거래 수수료, ~12% 프로토콜 수수료를 받습니다.
  • 새로운 기능 작업 없음. CPMM이 새로운 기본값이 된 이후 팀은 AMM v4에 새로운 명령어를 추가하지 않았습니다. 프로그램은 관리 모드에 있습니다 — 버그 수정만, 범위 확장 없음.
  • Token-2022 지원 없음. AMM v4는 Token-2022가 존재하기 전에 작성되었으며 통합이 역으로 적용되지 않았습니다. Token-2022 민트는 CPMM (또는 적절한 경우 CLMM)을 사용해야 합니다.
  • OpenBook 통합 비활성화. 모든 AMM v4 풀은 여전히 온체인의 해당 OpenBook 마켓 계정에 바인딩되어 있지만, 풀은 더 이상 해당 마켓에 주문을 게시하거나 유지하지 않습니다. OpenBook 중단은 더 이상 AMM v4 스왑에 영향을 주지 않습니다.

​
여전히 작동하는 것

  • 기존 풀은 정상적으로 거래됩니다. 상태 마이그레이션이 강제되지 않았습니다; 2021년에 생성된 v4 풀은 2026년에도 많은 고거래량 쌍의 활성 거래소입니다.
  • LP는 평소처럼 입금, 출금, 팜 보상 수확을 할 수 있습니다. CPMM으로의 마이그레이션은 선택사항입니다.
  • 애그리게이터는 여전히 이를 통해 라우팅합니다. Jupiter와 Raydium Trade API 모두 v4 풀을 1급 거래소로 인덱싱합니다.

​
AMM v4를 여전히 사용해야 할 때

솔직히 말해서: 거의 없습니다. v4가 더 나은 선택인 경우는 좁습니다:
  • 쌍이 이미 깊고 잘 거래되는 v4 풀을 가지고 있으며 시장을 분산시키기보다는 기존 깊이에 유동성을 추가하고 싶은 경우.
(OpenBook 통합 라우팅은 더 이상 AMM v4를 선택하는 이유가 아닙니다 — 해당 통합은 꺼져 있습니다.) 다른 모든 경우에는 CPMM에서 새 풀을 시작하세요. 전체 의사결정 트리는 user-flows/choosing-a-pool-type를 참조하세요.

​
CPMM — 채택 곡선 및 v4 → CPMM 마이그레이션

CPMM (상수곱 마켓 메이커, 내부 이름 raydium-cp-swap)은 2024년에 새로운 기본값이 되도록 의도된 클린룸 재작성으로 배포되었습니다. 이는 Raydium의 프로그램 중 구조적으로 가장 단순합니다: 순수 x · y = k, 오더북 없음, 네이티브 Token-2022 지원, 더 작은 트랜잭션 풋프린트.

​
CPMM이 AMM v4보다 제공하는 것

  • 기본적으로 더 나은 LP 경제학. CPMM의 기본 AmmConfig는 거래 수수료의 100%를 LP에 라우팅합니다 (프로토콜 수수료는 계층별로 토글 가능). AMM v4는 ~12%를 프로토콜에 하드코딩합니다.
  • 더 낮은 풀 생성 비용. OpenBook 마켓이 필요 없습니다. 생성은 한 번의 트랜잭션, ~0.15 SOL의 렌트 vs v4의 ~0.6 SOL.
  • Token-2022. 전송 수수료 민트, 전송 훅 민트 (주의 사항 있음), 기밀 전송 — 모두 CPMM에서 지원되며 v4에서는 지원되지 않습니다.
  • 더 깔끔한 통합자 인터페이스. CPMM은 Anchor-CPI 친화적인 공개 크레이트 (raydium-cp-swap), 더 간단한 계정 목록, 안정적인 IDL을 가지고 있습니다. AMM v4는 IDL을 제공하지만 유지 관리되는 Rust CPI 크레이트를 가진 적이 없습니다.
  • 스왑당 더 작은 계정 목록. ~10개 계정 vs v4의 ~17개 (이는 사용하지 않을 때에도 OpenBook 마켓 계정을 포함합니다).

​
마이그레이션이 가치 있을 때

활발히 거래되는 풀의 경우, LP 수수료 상승만으로도 일반적으로 몇 개월 내에 마이그레이션을 정당화합니다. 산술: 일일 거래량 $X에서 0.25%를 버는 풀은 v4에서 프로토콜에 0.03%를 제공합니다 (누락된 12%). CPMM에서는 이것이 LP에게 반환됩니다. 1년에 걸쳐 이는 의미 있게 복합됩니다. 거래량이 적은 풀의 경우, 마이그레이션은 더 미래 대비 — 더 나은 기본값, 필요할 경우 Token-2022 지원, 더 쉬운 통합.

​
마이그레이션 작동 방식

제자리 업그레이드는 없습니다. 마이그레이션은 새 풀 생성, 이전 풀 드레인, 새 풀 재충전 시퀀스입니다. 전체 단계별 지침은 user-flows/migrate-amm-v4-to-cpmm에 있습니다; 높은 수준의 형태:
  1. 동일한 쌍에 대해 새 CPMM 풀을 생성하고, 보존하려는 동일한 수수료 계층에서.
  2. LP 조정: 이전 풀이 드레인되고 새 풀이 시드되는 기간을 공지합니다.
  3. 각 LP는 v4 풀에서 출금하고 새 CPMM 풀에 입금합니다.
  4. (선택사항) CPMM 측 팜을 설정하여 인센티브 LP를 새 풀로 유도합니다.
  5. 애그리게이터가 더 깊은 풀로 가중치를 조정함에 따라 거래량 마이그레이션을 관찰합니다.
체인 자체는 이 중 어느 것도 강제하지 않습니다 — Raydium의 API와 프론트엔드는 단순히 더 깊은 풀을 선호하고, 애그리게이터는 사용자에게 가장 저렴한 것을 통해 라우팅합니다.

​
CLMM — 단일 프로그램, 버전 간 안정성

CLMM은 첫 번째 프로그램 버전에 있습니다. v2가 없었습니다 — 개선사항은 새로운 세대가 아닌 24시간 타임락 멀티시그 뒤의 동일한 프로그램 ID에 대한 제자리 업그레이드로 제공되었습니다. 이는 CLMM 마이그레이션 스토리가 없다는 의미입니다: 기존 포지션은 그대로 유지되고, 업그레이드가 제공될 때 프로그램의 동작이 미묘하게 변할 수 있지만, 계정 레이아웃과 PDA는 안정적입니다. CLMM 업그레이드 전반에 걸쳐 변경된 것:
  • SwapV2 명령어 추가되어 Token-2022 전송 수수료 수학을 올바르게 지원합니다. 이전 Swap은 여전히 호출 가능합니다; 새로운 통합은 SwapV2를 대상으로 해야 합니다.
  • 보상 스트림 확장 — RewardInfo 슬롯 수가 범프되었습니다 (원래 3 → 현재 여전히 3이지만, 예약 패턴이 강화됨). 데이터 마이그레이션이 필요하지 않습니다.
  • 틱 배열 압축 — 많은 틱을 교차하는 스왑의 CU를 줄이기 위한 내부 최적화. 외부적으로 보이지 않습니다.
  • Anchor 1.0 재구축 (2026-09-30): Anchor 0.32.1에서 1.0.2로 이동하고 관리자 CollectExcessLamports를 추가합니다. 사용자 대면 명령어 또는 계정 레이아웃이 변경되지 않았습니다. 변경 로그 항목을 참조하세요.
IDL은 전용 raydium-idl 저장소에 있습니다 (sdk-api/anchor-idl 참조). 현재 프로그램에 대해 이전 SDK를 실행 중인 경우, 최악의 경우는 새 명령어가 누락되는 것입니다.

​
Farm v3 → v5 → v6

모든 Raydium 프로그램 중에서 Farm은 가장 명시적인 버전 이력과 유일한 강제 마이그레이션 경로를 가지고 있습니다. 세 세대는 별도의 프로그램 ID와 별도의 상태 레이아웃을 가진 별도의 프로그램입니다.

​
세대

​
세 세대가 존재하는 이유

  • v3 → v5: 동시 다중 보상 스트림이 필요했습니다 (예: 이중 인센티브 팜). v3의 단일 스트림 설계는 재설계 없이 이를 지원할 수 없었습니다.
  • v5 → v6: v5의 u64 정수 배출 속도는 표현 가능한 최소 속도를 “초당 1 토큰 단위”로 제한합니다. 9소수 민트의 경우, 이는 초당 1 라모트 — 저배출 프로그램에는 너무 거칠습니다. v6의 Q64.64 분수 속도가 이를 수정합니다. v6은 또한 슬롯 기반 업데이트를 벽시계로 올렸고, Token-2022 지원을 추가했습니다.

​
세대 간 동일하게 유지되는 것

  • “LP 입금, 주당 카운터 적립, 출금 시 청구” 회계 패턴은 v3/v5/v6 전반에 걸쳐 동일합니다. 수학은 변하지 않습니다; 속도 카운터의 정밀도와 지원되는 스트림의 수만 변합니다.
  • UserStake (v3/v5) 및 UserLedger (v6)는 개념적으로 동일한 레코드이며, 레이아웃이 다릅니다. SDK는 둘 다 정규화합니다.

​
마이그레이션 경로

팜 버전 간에 제자리 마이그레이션은 없습니다. v3/v5에서 v6으로 이동하려면:
  1. 기존 팜의 배출이 끝날 때까지 기다립니다 (또는 실행을 줄입니다).
  2. 스테이커는 이전 팜에서 출금하고 보류 중인 보상을 청구합니다.
  3. 팜 운영자는 동일한 스테이킹 민트에 대해 새 v6 팜을 생성합니다.
  4. 스테이커는 새 팜에 다시 스테이킹합니다.
온체인 현실은 두 개의 관련 없는 팜 계정입니다. 두 팜 모두에 스테이크를 가진 사용자는 두 개의 UserLedger (v6) / UserStake (v5) 레코드를 가집니다.

​
v3 및 v5에 대한 “단계적 폐지”의 의미

  • v3 및 v5 프로그램은 여전히 배포되고 호출 가능합니다. 기존 팜은 여전히 보류 중인 보상을 배포하고 출금을 수락할 수 있습니다.
  • Raydium UI는 여전히 활성 보상이 있는 v3 및 v5 팜을 표시합니다; v3/v5 팜의 end_time이 지나면, UI는 “활성”에서 숨기지만 청구 가능하게 유지합니다.
  • 팀은 새로운 v3/v5 팜을 생성하지 않습니다. “팜 생성”을 위한 SDK 헬퍼는 v6으로만 라우팅합니다.
  • v3 및 v5는 기능 작업이 아닌 보안 업그레이드를 받습니다. 중대한 버그가 발견되면 수정됩니다; 기능이 유용할 수 있으면 대신 v6에 추가됩니다.
버전별 전체 세부사항은 products/farm-staking/accounts 및 products/farm-staking/instructions에 있습니다.

​
LaunchLab — 단일 프로그램, 진화하는 구성

LaunchLab은 첫 번째 프로그램 버전에 있습니다. CLMM과 마찬가지로, 개선사항은 새로운 세대가 아닌 24시간 타임락 뒤의 제자리 업그레이드로 제공됩니다. 업그레이드를 통해 진화한 것:
  • 크리에이터 수수료 슬롯. 런칭이 졸업 후 CPMM 거래 수수료의 일부를 원래 크리에이터에게 라우팅할 수 있도록 추가되었습니다. products/launchlab/creator-fees를 참조하세요.
  • 곡선 공식 구성 가능성. 원래 하드코딩된 이차; 이제 LaunchConfig는 작은 곡선 형태 집합에서 선택합니다.
기존 LaunchLab 런칭은 업그레이드의 영향을 받지 않습니다 — 런칭이 초기화되면, 그 매개변수는 졸업까지 동결됩니다.

​
교차 프로그램 버전 호환성

통합자가 정기적으로 마주치는 몇 가지 교차 제품 호환성 참고사항:
  • CLMM SwapV2는 Swap 명령어와 동일하지 않습니다. 클라이언트가 Swap만 사용하면, Token-2022 전송 수수료를 자동으로 잘못 처리합니다 — 수학이 수수료 금액만큼 잘못됩니다. SwapV2로 업데이트하세요.
  • CLMM 포지션을 사용한 Farm v6 스테이킹은 LP 토큰 스테이킹 방식으로 지원되지 않습니다. CLMM 포지션은 NFT이지, 대체 가능한 LP 토큰이 아닙니다. CLMM은 대신 자체 네이티브 보상 메커니즘을 가지고 있습니다 — products/clmm/fees를 참조하세요.
  • Token-2022 민트로 지원되는 CPMM 풀은 Farm v6에서만 팜에서 작동합니다. v3 및 v5는 Token-2022 스테이킹 민트를 거부합니다.
  • AMM v4 풀은 절대 Token-2022 LP 민트를 가지지 않습니다. 하나를 보면, 그것은 가짜입니다 — AMM v4는 그 조합을 지원하지 않습니다.

​
더 읽을 곳

출처:
  • 위에서 인라인으로 인용된 제품별 장 페이지.
  • Raydium SDK v2 — 버전 인식 디스패치 로직은 주어진 풀이 어느 프로그램에 속하는지 확인합니다.
  • reference/program-addresses — 버전별 정규 ID.