> ## Documentation Index
> Fetch the complete documentation index at: https://docs.raydium.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 버전 및 마이그레이션

> 모든 Raydium 프로그램의 출시 버전 이력, 각 세대의 지원 중단 상태, 그리고 이전 버전에서 새 버전으로 이동하는 실질적인 마이그레이션 경로.

<Info>
  **이 페이지는 AI 자동 번역입니다. 모든 내용은 영문판을 기준으로 합니다.**

  [영문판 보기 →](/protocol-overview/versions-and-migration)
</Info>

## 현황 요약

| 프로그램          | 현재 버전      | 지원 중단  | 신규 배포        | 기존 인스턴스                   |
| ------------- | ---------- | ------ | ------------ | ------------------------- |
| **AMM v4**    | v4 (1개 세대) | 아니오    | 권장하지 않지만 허용됨 | 완전히 작동 중                  |
| **CPMM**      | v1         | —      | **권장 기본값**   | 완전히 작동 중                  |
| **CLMM**      | v1         | —      | 범위 지정 LP에 권장 | 완전히 작동 중                  |
| **Farm**      | v6         | v3, v5 | v6만          | v3 + v5 단계적 중단(대부분 읽기 전용) |
| **LaunchLab** | v1         | —      | 신규 론칭에 권장    | 완전히 작동 중                  |

이 표에서 가장 중요한 한 가지: **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`](/ko/user-flows/choosing-a-pool-type)를 참조하세요.

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

CPMM(상수곱 시장 조성자, 내부 이름 `raydium-cp-swap`)은 2024년에 새로운 기본값으로 의도된 깨끗한 방식의 재작성으로 배포되었습니다. Raydium의 프로그램 중 구조적으로 가장 간단합니다: 순수 `x · y = k`, 오더북 없음, 기본 Token-2022 지원, 더 작은 거래 부하.

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

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

### 마이그레이션이 가치 있는 경우

활발하게 거래되는 풀의 경우 LP 수수료 상승만으로도 일반적으로 몇 달 내에 마이그레이션을 정당화합니다. 산술: 일일 거래량 \$X의 0.25%를 버는 풀은 v4에서 프로토콜에 0.03%를 제공합니다(누락된 12%). CPMM에서 그것은 LP로 돌아갑니다. 1년에 걸쳐 그것은 의미 있게 복합됩니다.

거래량이 낮은 풀의 경우 마이그레이션은 더 많이 미래 대비입니다 — 더 나은 기본값, 필요할 경우 Token-2022 지원, 더 쉬운 통합.

### 마이그레이션 작동 방식

제자리 업그레이드는 없습니다. 마이그레이션은 *새로운 풀 생성, 이전 풀 배출, 새로운 풀 재채우기* 시퀀스입니다. 전체 단계별은 [`user-flows/migrate-amm-v4-to-cpmm`](/ko/user-flows/migrate-amm-v4-to-cpmm)에 있습니다; 상위 수준 형태:

1. 같은 쌍에 대한 새 CPMM 풀을 생성하고, 유지하고 싶은 같은 수수료 계층에서.
2. LP 조정: 이전 풀이 배출되고 새 풀이 시드되는 윈도우를 공지합니다.
3. 각 LP는 v4 풀에서 인출하고 새 CPMM 풀에 입금합니다.
4. (선택 사항) CPMM 측 팜을 설정하여 인센티브가 있는 LP를 새 풀로 끌어옵니다.
5. 어그리게이터가 더 깊은 풀 방향으로 재가중화할 때 거래량 마이그레이션을 관찰합니다.

체인 자체는 이 어느 것도 강제하지 않습니다 — Raydium의 API와 프론트엔드는 단순히 더 깊은 풀을 선호하고, 어그리게이터는 사용자에게 가장 저렴한 풀을 통해 라우팅합니다.

## CLMM — 단일 프로그램, 버전 전체에서 안정적

CLMM은 첫 프로그램 버전입니다. v2는 없었습니다 — 개선사항은 새로운 세대로서가 아니라 같은 프로그램 ID에 대한 제자리 업그레이드로 제공되었습니다(24시간 타임락된 멀티시그 뒤에서).

그것은 **CLMM 마이그레이션 스토리가 없다**는 것을 의미합니다: 기존 포지션은 그대로 유지되며, 업그레이드가 제공될 때 프로그램의 동작이 미묘하게 변할 수 있지만, 계정 레이아웃과 PDA는 안정적입니다.

CLMM 업그레이드 전체에서 변경된 것:

* **`SwapV2` 지시문** 추가되어 Token-2022 이전 수수료 수학을 올바르게 지원합니다. 이전 `Swap`은 여전히 호출 가능합니다; 새로운 통합은 `SwapV2`를 대상으로 해야 합니다.
* **보상 스트림 확장** — `RewardInfo` 슬롯 수가 범프됨(원본 3 → 현재 여전히 3, 하지만 예약 패턴이 강화됨). 데이터 마이그레이션이 필요하지 않습니다.
* **틱 배열 압축** — 스왑-많은-틱 횡단의 CU를 줄이기 위한 내부 최적화. 외부적으로 보이지 않음.

IDL은 전용 [`raydium-idl`](https://github.com/raydium-io/raydium-idl/blob/master/raydium_clmm/raydium_clmm.json) 저장소에 있습니다(참조 [`sdk-api/anchor-idl`](/ko/sdk-api/anchor-idl)). 더 오래된 SDK를 현재 프로그램에 대해 실행하는 경우, 최악의 경우는 새로운 지시문을 놓치는 것입니다.

## Farm v3 → v5 → v6

모든 Raydium 프로그램 중 Farm은 가장 명확한 버전 이력과 유일한 강제 마이그레이션 경로를 가지고 있습니다. 세 세대는 서로 다른 프로그램과 서로 다른 프로그램 ID 및 서로 다른 상태 레이아웃을 가지고 있습니다.

### 세대

| 버전     | 출시        | 상태                                | 핵심 기능                                                                     |
| ------ | --------- | --------------------------------- | ------------------------------------------------------------------------- |
| **v3** | 2021      | **단계적 중단.** 기존 팜 운영 중; 새로운 팜 미허용. | 단일 보상 스트림. 슬롯 기반 배출.                                                      |
| **v5** | 2022년 10월 | **단계적 중단.** 기존 팜 운영 중; 새로운 팜 미허용. | 최대 2개 보상 스트림. 슬롯 기반 배출. 정수 `per_second`.                                  |
| **v6** | 2024      | **현재.** 모든 새로운 팜.                 | 최대 5개 보상 스트림. 벽시계 배출. Q64.64 고정소수점 `per_second`. Token-2022 스테이킹 + 보상 지원. |

### 세 세대가 존재하는 이유

* **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`](/ko/products/farm-staking/accounts) 및 [`products/farm-staking/instructions`](/ko/products/farm-staking/instructions)에 있습니다.

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

LaunchLab은 첫 프로그램 버전입니다. CLMM처럼, 개선사항은 24시간 타임락 뒤에 제자리 업그레이드로 제공됩니다 — 새로운 세대로서가 아닙니다.

업그레이드를 통해 진화한 것:

* **크리에이터 수수료 슬롯.** 론칭이 졸업 후 CPMM 거래 수수료의 일부를 원래 크리에이터로 라우팅하도록 추가되었습니다. 참조 [`products/launchlab/creator-fees`](/ko/products/launchlab/creator-fees).
* **곡선 공식 구성 가능성.** 원래 하드코딩된 이차; 이제 `LaunchConfig`는 작은 곡선 형태 세트 중에서 선택합니다.

기존 LaunchLab 론칭은 업그레이드의 영향을 받지 않습니다 — 론칭이 초기화되면 졸업할 때까지 매개변수가 고정됩니다.

## 프로그램 간 버전 호환성

통합자가 일상적으로 맞닥뜨리는 몇 가지 크로스 제품 호환성 참고사항:

* **CLMM `SwapV2`는 `Swap` 지시문과 같지 않습니다.** 클라이언트가 `Swap`만 지원하면 Token-2022 이전 수수료를 자동으로 잘못 처리합니다 — 수학이 수수료 금액만큼 틀렸습니다. `SwapV2`로 업데이트하세요.
* **CLMM 포지션이 있는 Farm v6 스테이킹**은 LP 토큰 스테이킹 방식으로 지원되지 않습니다. CLMM 포지션은 곡물이 아닌 NFT입니다. CLMM은 대신 자체 기본 보상 메커니즘을 가지고 있습니다 — 참조 [`products/clmm/fees`](/ko/products/clmm/fees).
* **Token-2022 민트로 뒷받침되는 CPMM 풀은 Farm v6에서만 팜에서 작동합니다.** v3 및 v5는 Token-2022 스테이킹 민트를 거부합니다.
* **AMM v4 풀은 Token-2022 LP 민트를 가진 적이 없습니다.** 만약 하나를 보면 가짜입니다 — AMM v4는 그 조합을 지원하지 않습니다.

## 더 읽을 곳

* [`introduction/history-and-milestones`](/ko/introduction/history-and-milestones) — 시간 순 출시 타임라인 및 각 버전이 언제 출시되었는지 이유.
* [`user-flows/migrate-amm-v4-to-cpmm`](/ko/user-flows/migrate-amm-v4-to-cpmm) — v4 → CPMM 이동을 위한 운영자 실행서.
* [`user-flows/choosing-a-pool-type`](/ko/user-flows/choosing-a-pool-type) — 새로운 풀 배포를 위한 결정 트리.
* [`products/farm-staking/accounts`](/ko/products/farm-staking/accounts) — v3 / v5 / v6에 대한 나란히 스키마.
* [`reference/changelog`](/ko/reference/changelog) — 프로그램 버전이 진화할 때 이 문서에서 변경된 것.

출처:

* 위에 인라인으로 인용된 제품별 장 페이지.
* [Raydium SDK v2](https://github.com/raydium-io/raydium-sdk-V2) — 버전 인식 디스패치 로직은 주어진 풀이 어느 프로그램에 속하는지 확인합니다.
* [`reference/program-addresses`](/ko/reference/program-addresses) — 버전별 정규 ID.