Phiên bản và di chuyển

​

Tình trạng tổng quan

Điểm quan trọng nhất từ bảng này: AMM v4 không bị loại bỏ, và CPMM là mặc định mới — nhưng chúng tồn tại cùng nhau một cách có chủ đích. Các pool AMM v4 có nhiều năm lịch sử giao dịch và không bị buộc di chuyển. Lựa chọn chương trình nào để khởi chạy một pool mới là một khuyến nghị, không phải một ràng buộc.

​

AMM v4 — trạng thái và quỹ đạo

AMM v4 là thiết kế pool Raydium ban đầu: định giá sản phẩm không đổi (x · y = k). Nó được khởi chạy như một AMM lai với tích hợp sổ lệnh OpenBook (trước đây là Serum) phản chiếu các phần của đường cong dưới dạng lệnh giới hạn trên một thị trường ràng buộc. Tích hợp OpenBook đã bị vô hiệu hóa — các pool không còn chia sẻ thanh khoản với OpenBook và tất cả các swap thực hiện thuần túy chống lại đường cong thông qua các điểm cuối swap V2. AMM v4 ngày nay, trong thực tế, là một AMM sản phẩm không đổi thuần túy với các tài khoản OpenBook được bảo tồn dưới dạng trạng thái không hoạt động.

​

Những gì bị đóng lại

• Không có thêm tầng phí mới. Cấu trúc phí AMM v4 là mỗi pool và được đặt tại triển khai. Các pool mới chấp nhận cùng một khoản phí giao dịch được mã hóa cứng ~0,25%, ~12% cho giao thức.
• Không có công việc tính năng mới. Nhóm chưa thêm hướng dẫn mới vào AMM v4 kể từ khi CPMM trở thành mặc định mới. Chương trình ở chế độ quản lý — chỉ sửa lỗi, không mở rộng phạm vi.
• Không hỗ trợ Token-2022. AMM v4 được viết trước khi Token-2022 tồn tại và tích hợp không bao giờ được cải tạo. Các mint Token-2022 phải sử dụng CPMM (hoặc CLMM, nếu thích hợp).
• Tích hợp OpenBook bị vô hiệu hóa. Mỗi pool AMM v4 vẫn được ràng buộc với một tài khoản thị trường OpenBook tương ứng trên chuỗi, nhưng pool không còn đăng hoặc duy trì các lệnh trên thị trường đó. Một sự cố OpenBook không còn ảnh hưởng đến các swap AMM v4.

​

Những gì vẫn hoạt động

• Các pool hiện có giao dịch bình thường. Không có di chuyển trạng thái bắt buộc; các pool v4 được tạo vào năm 2021 vẫn là địa điểm hoạt động cho nhiều cặp khối lượng cao vào năm 2026.
• LP có thể gửi, rút và thu hoạch phần thưởng farm như bình thường. Di chuyển sang CPMM là tùy chọn.
• Các aggregator vẫn định tuyến qua nó. Jupiter và Raydium Trade API đều lập chỉ mục các pool v4 như các địa điểm hạng nhất.

​

Khi nào vẫn sử dụng AMM v4

Thành thật mà nói: hiếm khi. Các trường hợp mà v4 là câu trả lời tốt hơn rất hẹp:

• Cặp đã có một pool v4 sâu, được giao dịch tốt và bạn muốn thêm thanh khoản vào độ sâu hiện có thay vì chia tách thị trường.

(Định tuyến tích hợp OpenBook không còn là lý do để chọn AMM v4 — tích hợp đó đã tắt.) Trong mọi trường hợp khác, khởi chạy các pool mới trên CPMM. Xem user-flows/choosing-a-pool-type để xem cây quyết định đầy đủ.

​

CPMM — đường cong áp dụng và di chuyển v4 → CPMM

CPMM (constant-product market maker, tên nội bộ raydium-cp-swap) được triển khai vào năm 2024 như một viết lại phòng sạch nhằm trở thành pool sản phẩm không đổi mặc định mới. Nó về mặt cấu trúc là đơn giản nhất trong các chương trình của Raydium: thuần túy x · y = k, không có sổ lệnh, hỗ trợ Token-2022 gốc, dấu chân giao dịch nhỏ hơn.

​

Những gì CPMM mang lại cho bạn so với AMM v4

• Kinh tế LP tốt hơn theo mặc định. AmmConfig mặc định của CPMM định tuyến 100% phí giao dịch cho LP (với phí giao thức có thể bật tắt theo tầng). AMM v4 mã hóa cứng ~12% cho giao thức.
• Chi phí tạo pool thấp hơn. Không cần thị trường OpenBook. Tạo là một giao dịch, ~0,15 SOL tiền thuê so với ~0,6 SOL cho v4.
• Token-2022. Các mint phí chuyển, mint hook chuyển (với cảnh báo), chuyển bảo mật — tất cả được hỗ trợ trên CPMM, không có trên v4.
• Bề mặt tích hợp sạch hơn. CPMM có một crate được xuất bản thân thiện với Anchor-CPI (raydium-cp-swap), danh sách tài khoản đơn giản hơn và IDL ổn định. AMM v4 gửi một IDL nhưng không bao giờ có một crate CPI Rust được duy trì.
• Danh sách tài khoản nhỏ hơn mỗi swap. ~10 tài khoản so với ~17 cho v4 (mang theo các tài khoản thị trường OpenBook ngay cả khi không sử dụng chúng).

​

Khi nào di chuyển là đáng giá

Đối với một pool được giao dịch tích cực, sự nâng cao phí LP một mình thường biện minh cho việc di chuyển trong vòng vài tháng. Số học: một pool kiếm được 0,25% × $X khối lượng hàng ngày cho 0,03% cho giao thức trên v4 (12% còn thiếu). Trên CPMM điều đó quay trở lại LP. Trong một năm, điều đó tích lũy một cách có ý nghĩa. Đối với một pool khối lượng thấp, di chuyển là về việc chứng minh tương lai — các mặc định tốt hơn, hỗ trợ Token-2022 nếu bạn bao giờ cần nó, tích hợp dễ dàng hơn.

​

Cách di chuyển hoạt động

Không có nâng cấp tại chỗ. Di chuyển là một chuỗi tạo pool mới, thoát pool cũ, điền lại pool mới. Toàn bộ từng bước được trong user-flows/migrate-amm-v4-to-cpmm; hình dạng cấp cao:

1. Tạo một pool CPMM mới cho cùng một cặp, trên cùng tầng phí bạn muốn bảo tồn.
2. Phối hợp LP: công bố một cửa sổ trong đó pool cũ được thoát và pool mới được gieo hạt.
3. Mỗi LP rút khỏi pool v4 và gửi vào pool CPMM mới.
4. (Tùy chọn) Thiết lập một farm phía CPMM để thu hút các LP được khuyến khích vào pool mới.
5. Theo dõi khối lượng di chuyển khi các aggregator cân bằng lại hướng tới pool sâu hơn.

Chính chuỗi không thực thi bất kỳ điều nào trong số này — API và giao diện Raydium đơn giản ưu tiên pool nào sâu hơn, và các aggregator định tuyến qua pool nào rẻ nhất cho người dùng.

​

CLMM — một chương trình, ổn định trên các phiên bản

CLMM ở phiên bản chương trình đầu tiên của nó. Không có v2 — các cải tiến đã được gửi dưới dạng nâng cấp tại chỗ cho cùng một ID chương trình (phía sau khóa thời gian 24h multisig), không phải như một thế hệ mới. Điều đó có nghĩa là có không có câu chuyện di chuyển CLMM: các vị trí hiện có ở lại nơi chúng, và hành vi của chương trình có thể thay đổi một cách tinh tế khi một nâng cấp được gửi, nhưng các bố cục tài khoản và PDA là ổn định. Những gì đã thay đổi trên các nâng cấp CLMM:

• Hướng dẫn SwapV2 được thêm để hỗ trợ toán học phí chuyển Token-2022 một cách chính xác. Swap cũ vẫn có thể gọi được; các tích hợp mới nên nhắm mục tiêu SwapV2.
• Mở rộng luồng phần thưởng — số lượng slot RewardInfo được tăng (3 ban đầu → vẫn 3 hiện tại, nhưng mô hình dự trữ được siết chặt). Không cần di chuyển dữ liệu.
• Nén mảng tick — tối ưu hóa nội bộ để giảm CU trên swap-crossing-many-ticks. Không nhìn thấy từ bên ngoài.
• Xây dựng lại Anchor 1.0 (2026-09-30): chuyển từ Anchor 0.32.1 sang 1.0.2 và thêm admin CollectExcessLamports. Không có hướng dẫn hoặc bố cục tài khoản hướng tới người dùng thay đổi. Xem mục nhập changelog.

IDL sống trong kho lưu trữ chuyên dụng raydium-idl (xem sdk-api/anchor-idl). Nếu bạn chạy một SDK cũ hơn chống lại chương trình hiện tại, trường hợp xấu nhất là thiếu các hướng dẫn mới.

​

Farm v3 → v5 → v6

Trong tất cả các chương trình Raydium, Farm có lịch sử phiên bản rõ ràng nhất và đường dẫn di chuyển bắt buộc duy nhất. Ba thế hệ là các chương trình riêng biệt với các ID chương trình riêng biệt và bố cục trạng thái riêng biệt.

​

Các thế hệ

​

Tại sao ba thế hệ tồn tại

• v3 → v5: cần nhiều luồng phần thưởng đồng thời (ví dụ: farm khuyến khích kép). Thiết kế luồng đơn của v3 không thể hỗ trợ nó mà không cần thiết kế lại.
• v5 → v6: tỷ lệ phát hành số nguyên u64 của v5 giới hạn tỷ lệ tối thiểu có thể biểu thị ở “1 đơn vị token mỗi giây.” Đối với một mint 9 thập phân, đó là 1 lamport/giây — quá thô cho các chương trình phát hành thấp. Tỷ lệ phân số Q64.64 của v6 khắc phục điều này. v6 cũng nâng cấp cập nhật dựa trên slot lên đồng hồ treo tường, và thêm hỗ trợ Token-2022.

​

Những gì vẫn giữ nguyên trên các thế hệ

• Mô hình kế toán “gửi LP, tích lũy bộ đếm mỗi cổ phần, yêu cầu rút” giống hệt nhau trên v3/v5/v6. Toán học không thay đổi; chỉ có độ chính xác của bộ đếm tỷ lệ và số lượng luồng được hỗ trợ.
• UserStake (v3/v5) và UserLedger (v6) về mặt khái niệm là cùng một bản ghi, với các bố cục khác nhau. SDK chuẩn hóa cả hai.

​

Đường dẫn di chuyển

Không có di chuyển tại chỗ giữa các phiên bản farm. Để chuyển từ v3/v5 sang v6:

1. Chờ phát hành của farm hiện có kết thúc (hoặc chạy xuống).
2. Những người staker rút và yêu cầu phần thưởng đang chờ xử lý trên farm cũ.
3. Nhà điều hành farm tạo một farm v6 mới chống lại cùng một mint staking.
4. Những người staker tái staking vào farm mới.

Thực tế trên chuỗi là hai tài khoản farm không liên quan. Một người dùng có stake trong cả hai có hai bản ghi UserLedger (v6) / UserStake (v5).

​

”Dừng dần” có nghĩa gì đối với v3 và v5

• Các chương trình v3 và v5 vẫn được triển khai và có thể gọi được. Các farm hiện có vẫn có thể phân phối phần thưởng đang chờ xử lý và chấp nhận rút.
• Giao diện người dùng Raydium vẫn hiển thị các farm v3 và v5 với phần thưởng hoạt động; khi end_time của farm v3/v5 trôi qua, giao diện ẩn nó khỏi “hoạt động” nhưng giữ nó có thể yêu cầu.
• Nhóm sẽ không tạo các farm v3/v5 mới. Trợ giúp SDK cho “tạo farm” định tuyến đến v6 chỉ.
• v3 và v5 nhận các nâng cấp bảo mật nhưng không phải công việc tính năng. Nếu tìm thấy lỗi quan trọng, nó sẽ được sửa; nếu một tính năng có thể hữu ích, nó sẽ được thêm vào v6 thay thế.

Chi tiết đầy đủ cho mỗi phiên bản trong products/farm-staking/accounts và products/farm-staking/instructions.

​

LaunchLab — một chương trình, cấu hình phát triển

LaunchLab ở phiên bản chương trình đầu tiên của nó. Giống như CLMM, các cải tiến được gửi dưới dạng nâng cấp tại chỗ phía sau khóa thời gian 24h — không phải như các thế hệ mới. Những gì đã phát triển thông qua các nâng cấp:

• Slot phí người tạo. Được thêm để các lần phát hành có thể định tuyến một phần của phí giao dịch CPMM sau khi tốt nghiệp cho người tạo ban đầu. Xem products/launchlab/creator-fees.
• Khả năng cấu hình công thức đường cong. Ban đầu được mã hóa cứng bậc hai; bây giờ LaunchConfig chọn từ một tập hợp nhỏ các hình dạng đường cong.

Các lần phát hành LaunchLab hiện có không bị ảnh hưởng bởi các nâng cấp — khi một lần phát hành được khởi tạo, các tham số của nó bị đóng lại cho đến khi tốt nghiệp.

​

Tương thích phiên bản chương trình chéo

Một vài ghi chú tương thích chéo sản phẩm mà các tích hợp thường gặp:

• CLMM SwapV2 không phải là hướng dẫn giống như Swap. Nếu máy khách của bạn chỉ nói Swap, nó sẽ im lặng xử lý sai phí chuyển Token-2022 — toán học sai bằng số tiền phí. Cập nhật lên SwapV2.
• Staking Farm v6 với các vị trí CLMM không được hỗ trợ theo cách staking token LP. Các vị trí CLMM là NFT, không phải token LP có thể hoán đổi. CLMM có cơ chế phần thưởng gốc riêng thay thế — xem products/clmm/fees.
• Các pool CPMM được hỗ trợ bởi các mint Token-2022 chỉ hoạt động trong farm trên Farm v6. v3 và v5 từ chối các mint staking Token-2022.
• Các pool AMM v4 không bao giờ có các mint LP Token-2022. Nếu bạn thấy một cái, nó là giả — AMM v4 không hỗ trợ sự kết hợp đó.

​

Nơi để đọc thêm

• introduction/history-and-milestones — dòng thời gian phát hành theo thứ tự thời gian và lý do tại sao mỗi phiên bản hạ cánh khi nó làm.
• user-flows/migrate-amm-v4-to-cpmm — sổ tay điều hành cho việc chuyển v4 → CPMM.
• user-flows/choosing-a-pool-type — cây quyết định cho các triển khai pool mới.
• products/farm-staking/accounts — lược đồ song song cho v3 / v5 / v6.
• reference/changelog — những gì đã thay đổi trong tài liệu này khi các phiên bản chương trình đã phát triển.

Nguồn:

• Các trang chương trình mỗi sản phẩm được trích dẫn nội tuyến ở trên.
• Raydium SDK v2 — logic phân phối nhận thức phiên bản xác nhận chương trình nào mà một pool nhất định thuộc về.
• reference/program-addresses — các ID chính thức cho mỗi phiên bản.