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

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.

​

Trạng thái tổng quát

Kết luận quan trọng nhất từ bảng này là: 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ủ ý. 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 là một ràng buộc.

​

AMM v4 — trạng thái và hướng phát triển

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ách lệnh OpenBook (trước đây là Serum) phản ánh 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 liên kết. 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 nữa và tất cả các swap được thực hiện thuần túy dựa vào đường cong thông qua các điểm cuối swap V2. AMM v4 ngày nay, trên 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 giữ lại dưới dạng trạng thái không hoạt động.

​

Những gì được cố định

• Không thêm tầng phí mới. Cấu trúc phí AMM v4 là cho mỗi pool và được đặt tại lúc triển khai. Các pool mới chấp nhận cùng một phí giao dịch cứng ~0,25%, ~12% cho giao thức.
• Không có công việc tính năng mới. Nhóm không thêm các 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 liên kết 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 đó nữa. 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ó quá trình 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à nơi hoạt động tích cực cho nhiều cặp khối lượng cao trong năm 2026.
• LP có thể gửi, rút và thu hoạch phần thưởng trang trại như bình thường. Di chuyển đến CPMM là tùy chọn.
• Các aggregator vẫn định tuyến thông qua nó. Jupiter và Raydium Trade API đều lập chỉ mục các pool v4 như những đị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 mặc định mới cho pool sản phẩm không đổi. Nó có cấu trúc đơ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ách 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 các LP (với phí giao thức có thể chuyển đổi cho mỗi tầng). AMM v4 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. Phí chuyển mint, chuyển hook mint (với cảnh báo), chuyển bí mật — tất cả đều đượ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 thân thiện với Anchor-CPI đã xuất bản (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 cho mỗi swap. ~10 tài khoản so với ~17 cho v4 (tài khoản này mang theo các tài khoản thị trường OpenBook ngay cả khi không sử dụng chúng).

​

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

Đối với một pool được giao dịch tích cực, sự gia tăng phí LP một mình thường biện minh cho việc di chuyển trong vòng một vài tháng. Số học: một pool kiếm được 0,25% × $X khối lượng giao dịch hàng ngày cho 0,03% cho giao thức trên v4 (những người không có 12%). Trên CPMM, nó trở lại cho các LP. Theo 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à nhiều hơn về chứng minh trong tương lai — những 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. Bước từng bước đầy đủ nằm 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 cặp, trên cùng tầng phí mà bạn muốn bảo tồn.
2. Phối hợp với các LP: thông báo một cửa sổ trong đó pool cũ được thoát và pool mới được hạt giống.
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 trang trại phía CPMM để thu hút các LP được khuyến khích đến pool mới.
5. Xem 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.

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

​

CLMM — một chương trình duy nhất, ổ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 là, 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 trong 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 tới SwapV2.
• Phần mở rộng luồng phần thưởng — số lượng khe RewardInfo đã tăng (3 ban đầu → vẫn 3 hiện tại, nhưng mẫu đặc trữ đã được siết chặt). Không cần di chuyển dữ liệu.
• Nén mảng đánh dấu — tối ưu hóa nội bộ để giảm CU trên swap-crossing-many-ticks. Bên ngoài không nhìn thấy.

IDL được lưu trữ trong kho tương trợ raydium-idl (xem sdk-api/anchor-idl). Nếu bạn chạy một SDK cũ hơn dựa trên chương trình hiện tại, trường hợp tồi tệ 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à đó là con đường 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 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ụ: các trang trại có tính năng 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: u64 của v5 tỷ lệ phát thải số nguyên 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 thải thấp. Tỷ lệ Q64.64 phân số của v6 khắc phục điều này. v6 cũng nâng bản cập nhật dựa trên khe lên thành đồng hồ, và thêm hỗ trợ Token-2022.

​

Điều gì vẫn giữ nguyên trong các thế hệ

• Mẫu kế toán “gửi LP, tích lũy bộ đếm chia sẻ, yêu cầu rút” là giống 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ố luồng được hỗ trợ.
• UserStake (v3/v5) và UserLedger (v6) về mặt khái niệm giống nhau, với các bố cục khác nhau. SDK chuẩn hóa cả hai.

​

Con đường di chuyển

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

1. Chờ các phát thải của trang trại 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 tạm ứng trên trang trại cũ.
3. Nhà điều hành trang trại tạo một trang trại v6 mới dựa trên cùng một mint staking.
4. Những người staker re-stake vào trang trại mới.

Thực tế trên chuỗi là hai tài khoản trang trại 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ần dừng hoạt động” 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 trang trại hiện có vẫn có thể phân phối phần thưởng tạm ứng và chấp nhận rút tiền.
• Giao diện Raydium vẫn hiển thị các trang trại v3 và v5 với phần thưởng tích cực; khi end_time của trang trại v3/v5 vượt quá, giao diện sẽ ẩn nó khỏi “tích cực” nhưng giữ nó có thể yêu cầu.
• Nhóm sẽ không tạo các trang trại v3/v5 mới. Trợ giúp SDK cho “tạo trang trại” định tuyến chỉ đến v6.
• v3 và v5 đang nhận các nâng cấp bảo mật nhưng không có công việc tính năng. Nếu tìm thấy một lỗi quan trọng, nó được sửa chữa; nếu một tính năng có thể hữu ích, nó được thêm vào v6 thay thế.

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

​

LaunchLab — một chương trình duy nhất, cấu hình đang 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:

• Khe phí nhà tạo. Được thêm để các vụ 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ứng bậc hai; giờ đây LaunchConfig chọn từ một bộ nhỏ các hình dạng đường cong.

Các vụ 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 vụ phát hành được khởi tạo, các tham số của nó được đóng băng cho đến khi tốt nghiệp.

​

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

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

• SwapV2 của CLMM không giống với hướng dẫn Swap. Nếu máy khách của bạn chỉ nói Swap, nó sẽ âm thầm xử lý sai phí chuyển Token-2022 — toán học sai đi 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 mà staking token LP là. 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 của nó — xem products/clmm/fees.
• Các pool CPMM được hỗ trợ bởi các mint Token-2022 chỉ hoạt động trên các trang trại 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à tại sao mỗi phiên bản đã hạ cánh khi nó làm được.
• user-flows/migrate-amm-v4-to-cpmm — sổ tay điều hành cho động 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 đồ so sánh cạnh nhau 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:

• Trang chương trình cho 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 — ID chính tắc cho mỗi phiên bản.