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.
이 페이지는 AI 자동 번역입니다. 모든 내용은 영문판을 기준으로 합니다.영문판 보기 →
현황 요약
| 프로그램 | 현재 버전 | 지원 중단 | 신규 배포 | 기존 인스턴스 |
|---|---|---|---|---|
| AMM v4 | v4 (1개 세대) | 아니오 | 권장하지 않지만 허용됨 | 완전히 작동 중 |
| CPMM | v1 | — | 권장 기본값 | 완전히 작동 중 |
| CLMM | v1 | — | 범위 지정 LP에 권장 | 완전히 작동 중 |
| Farm | v6 | v3, v5 | v6만 | v3 + v5 단계적 중단(대부분 읽기 전용) |
| LaunchLab | v1 | — | 신규 론칭에 권장 | 완전히 작동 중 |
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 풀을 가지고 있으며, 시장을 분산시키기보다 기존 깊이에 유동성을 추가하고 싶습니다.
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에 있습니다; 상위 수준 형태:
- 같은 쌍에 대한 새 CPMM 풀을 생성하고, 유지하고 싶은 같은 수수료 계층에서.
- LP 조정: 이전 풀이 배출되고 새 풀이 시드되는 윈도우를 공지합니다.
- 각 LP는 v4 풀에서 인출하고 새 CPMM 풀에 입금합니다.
- (선택 사항) CPMM 측 팜을 설정하여 인센티브가 있는 LP를 새 풀로 끌어옵니다.
- 어그리게이터가 더 깊은 풀 방향으로 재가중화할 때 거래량 마이그레이션을 관찰합니다.
CLMM — 단일 프로그램, 버전 전체에서 안정적
CLMM은 첫 프로그램 버전입니다. v2는 없었습니다 — 개선사항은 새로운 세대로서가 아니라 같은 프로그램 ID에 대한 제자리 업그레이드로 제공되었습니다(24시간 타임락된 멀티시그 뒤에서). 그것은 CLMM 마이그레이션 스토리가 없다는 것을 의미합니다: 기존 포지션은 그대로 유지되며, 업그레이드가 제공될 때 프로그램의 동작이 미묘하게 변할 수 있지만, 계정 레이아웃과 PDA는 안정적입니다. CLMM 업그레이드 전체에서 변경된 것:SwapV2지시문 추가되어 Token-2022 이전 수수료 수학을 올바르게 지원합니다. 이전Swap은 여전히 호출 가능합니다; 새로운 통합은SwapV2를 대상으로 해야 합니다.- 보상 스트림 확장 —
RewardInfo슬롯 수가 범프됨(원본 3 → 현재 여전히 3, 하지만 예약 패턴이 강화됨). 데이터 마이그레이션이 필요하지 않습니다. - 틱 배열 압축 — 스왑-많은-틱 횡단의 CU를 줄이기 위한 내부 최적화. 외부적으로 보이지 않음.
raydium-idl 저장소에 있습니다(참조 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으로 이동하려면:- 기존 팜의 배출이 끝날 때까지 기다립니다(또는 실행을 완료합니다).
- 스테이커는 이전 팜에서 출금하고 보류 중인 보상을 청구합니다.
- 팜 운영자는 같은 스테이킹 민트에 대해 새 v6 팜을 생성합니다.
- 스테이커는 새 팜에 재스테이킹합니다.
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는 작은 곡선 형태 세트 중에서 선택합니다.
프로그램 간 버전 호환성
통합자가 일상적으로 맞닥뜨리는 몇 가지 크로스 제품 호환성 참고사항:- CLMM
SwapV2는Swap지시문과 같지 않습니다. 클라이언트가Swap만 지원하면 Token-2022 이전 수수료를 자동으로 잘못 처리합니다 — 수학이 수수료 금액만큼 틀렸습니다.SwapV2로 업데이트하세요. - CLMM 포지션이 있는 Farm v6 스테이킹은 LP 토큰 스테이킹 방식으로 지원되지 않습니다. CLMM 포지션은 곡물이 아닌 NFT입니다. CLMM은 대신 자체 기본 보상 메커니즘을 가지고 있습니다 — 참조
products/clmm/fees. - Token-2022 민트로 뒷받침되는 CPMM 풀은 Farm v6에서만 팜에서 작동합니다. v3 및 v5는 Token-2022 스테이킹 민트를 거부합니다.
- AMM v4 풀은 Token-2022 LP 민트를 가진 적이 없습니다. 만약 하나를 보면 가짜입니다 — AMM v4는 그 조합을 지원하지 않습니다.
더 읽을 곳
introduction/history-and-milestones— 시간 순 출시 타임라인 및 각 버전이 언제 출시되었는지 이유.user-flows/migrate-amm-v4-to-cpmm— v4 → CPMM 이동을 위한 운영자 실행서.user-flows/choosing-a-pool-type— 새로운 풀 배포를 위한 결정 트리.products/farm-staking/accounts— v3 / v5 / v6에 대한 나란히 스키마.reference/changelog— 프로그램 버전이 진화할 때 이 문서에서 변경된 것.
- 위에 인라인으로 인용된 제품별 장 페이지.
- Raydium SDK v2 — 버전 인식 디스패치 로직은 주어진 풀이 어느 프로그램에 속하는지 확인합니다.
reference/program-addresses— 버전별 정규 ID.