Trang này được dịch tự động bằng AI. Phiên bản tiếng Anh là bản chính thức.Xem bản tiếng Anh →
Đây là nhật ký thay đổi của tài liệu — bản ghi các cập nhật cho các trang này kể từ khi dự án ra mắt. Mỗi bản phát hành dưới đây liên kết đến mục nhập riêng của nó; mở một mục để xem tóm tắt đầy đủ, các chương bị ảnh hưởng và ngày xác minh. Để xem dòng thời gian lịch sử của chính giao thức, hãy xem
introduction/history-and-milestones.Phát hành
CLMM: CreateCustomizablePoolV2 mở khả năng tạo multi-pool cho tất cả mọi người
CreatePermissionedPool được đổi tên thành CreateCustomizablePoolV2 và mất cổng Permission PDA, vì vậy bất kỳ người trả phí nào cũng có thể tạo các pool bổ sung cho cùng một cặp và mức phí tại địa chỉ được lấy từ seed_index. Các đối số và cách lấy địa chỉ pool không thay đổi, nhưng discriminator thay đổi và tài khoản permission rời khỏi slot 3, vì vậy các client được xây dựng dựa trên instruction cũ phải được xây dựng lại. pool_creator không được xác thực, vì vậy owner của pool V2 không phải là bằng chứng về người tạo nó. Tài khoản Permission, CreatePermissionPda, ClosePermissionPda và khóa permission_pda_admin bị xóa; các Permission PDA được tạo trước đó vẫn tồn tại trên chuỗi dưới dạng dữ liệu không hoạt động. Không có bố cục tài khoản hoặc mã lỗi nào thay đổi. IDL giảm xuống 37 instruction.Đọc toàn bộ mục →CLMM: Anchor 1.0, phục hồi lamports dư thừa và chủ sở hữu phí cố định
CLMM chuyển sang Anchor
1.0.2 trên Agave 3.1.10, cùng một bước chuyển mà CPMM và LaunchLab thực hiện vào 2026-09-09. Cả hai crate CPI công khai hiện đều ghim =1.0.2, vì vậy một chương trình duy nhất có thể CPI vào CPMM và CLMM. Một admin mới CollectExcessLamports trả lại tiền thuê được giải phóng bởi SIMD-0437. Nó quét một pool cho mỗi lần gọi: PDA PoolState ký cho các vault của nó và vault phần thưởng, các vault wSOL đi qua vòng SyncNative / UnwrapLamports, và bất kỳ tài khoản nào do CLMM sở hữu trong remaining_accounts đều bị ghi nợ xuống mức tối thiểu tiền thuê của nó. CreateAmmConfig hiện ghi các khóa protocol_fee_owner và fund_fee_owner được mã hóa cứng thay vì người ký. Trên mainnet, đây là những khóa đã được lưu trữ trên tất cả 21 config, và các config hiện có không được viết lại. 6052 được thêm vào. Không có instruction hoặc bố cục tài khoản nào hướng tới người dùng thay đổi.Đọc toàn bộ mục →CPMM: giao thức lấy một phần của phí tạo
CPMM hiện có thể giữ lại một phần của phí tạo. Sự chia tách được áp dụng khi phí được thu thập, không phải khi nó được tính: một swap vẫn tích lũy toàn bộ phí tạo vào
creator_fees_token*, và CollectCreatorFee / CollectCreatorFeePermissionless sau đó chuyển một phần vào các bộ đếm protocol_fees_token* hiện có của pool và trả phần còn lại cho người tạo — làm tròn xuống, vì vậy bụi vẫn ở với người tạo. Tỷ lệ này đến từ AmmConfig.creator_fee_share_rate mới (được cắt từ padding; tài khoản vẫn là 236 byte, nhưng padding[0] cũ hiện là một trường hoạt động) hoặc từ PDA CreatorFeeShare cho mỗi người tạo ghi đè nó, được quản lý bởi admin mới CreateCreatorFeeShare / CloseCreatorFeeShare. Phá vỡ đối với các client phí tạo: cả hai instruction thu thập đều lấy các tài khoản mới được thêm vào cuối danh sách của chúng — các tài khoản hiện có giữ vị trí của chúng, nhưng các tài khoản mới là bắt buộc, vì vậy giao dịch trước nâng cấp bị từ chối vì thiếu tài khoản. UpdateAmmConfig lấy param = 8. PoolState, toán học swap và kiểm tra k không bị ảnh hưởng, và không có mã lỗi nào được thêm vào. Đi kèm theo: sửa chữa sắp xếp hai lần trong CollectExcessLamports.Đọc toàn bộ mục →LaunchLab: Anchor 1.0, phục hồi lamports dư thừa và kết thúc các cổng chuyển tiếp
LaunchLab chuyển sang Anchor
1.0.2 trên Agave 3.1.10 và loại bỏ các giàn giáo chuyển tiếp của nó. Initialize không được dùng nữa hiện không thành công vô điều kiện với NotApproved. MigrateToCpswap phá vỡ hoàn toàn đối với ví di chuyển: cả ba đối số và chín tài khoản OpenBook đều biến mất, theo sau khi loại bỏ OpenBook của chính AMM v4, và chương trình không còn khởi tạo thị trường bằng CPI. Cổng đồng hồ get_upgrade_timestamp bị xóa, vì vậy ba remaining_accounts giao dịch là bắt buộc vô điều kiện (với slot system_program hiện được xác thực), MigrateToCpswap luôn lấy đường dẫn CPMM được phép, và InitializeWithToken2022 bỏ hạn chế amm_fee_on của nó. Admin mới CollectExcessLamports trả lại tiền thuê được giải phóng bởi SIMD-0437 — lưu ý rằng các tài khoản nguồn phải được nhóm theo PDA cơ sở vault nào sở hữu chúng. Ba ràng buộc địa chỉ MigrateToCpswap chuyển vào phần thân instruction, thay đổi 2012 thành 2502. 6031 được thêm vào. Không có bố cục tài khoản, instruction giao dịch hoặc hành vi phí nào thay đổi.Đọc toàn bộ mục →CPMM: Anchor 1.0, phục hồi lamports dư thừa và chủ sở hữu phí cố định
CPMM chuyển sang Anchor
1.0.2 trên Agave 3.1.10 và thêm admin CollectExcessLamports trả lại tiền thuê được giải phóng bởi SIMD-0437 từ các vault, LP mint và PDA — bao gồm các vault SOL được bao bọc, thông qua vòng SyncNative / UnwrapLamports để lại số dư được bao bọc không bị ảnh hưởng. Ba thay đổi hành vi đi kèm theo: CreateAmmConfig hiện ghi các khóa protocol_fee_owner và fund_fee_owner được mã hóa cứng thay vì người ký (các config hiện có không được di chuyển — đọc các trường), MINT_WHITELIST Token-2022 bốn địa chỉ được mã hóa cứng bị xóa vì vậy PDA đăng ký SupportMintAssociated là lối thoát duy nhất còn lại, và ClosePermissionPda hiện chấp nhận cơ quan cấp quyền chuyên dụng. 6015 được thêm vào. Không có instruction hoặc bố cục tài khoản nào hướng tới người dùng thay đổi.Đọc toàn bộ mục →AMM v4: phụ thuộc Solana 3.0 và phục hồi lamports dư thừa
AMM v4 xây dựng lại dựa trên
solana-program 3.0.0, spl-token 9.0.0, spl-associated-token-account 8.0.0 và crate solana-system-interface mới, và thêm WithdrawExcessLamports chỉ dành cho admin (tag 18) trả lại tiền thuê được giải phóng bởi SIMD-0437. Mỗi instruction hướng tới trader và LP giữ các tài khoản, đối số và toán học của nó, và không có gì trong bản phát hành là phá vỡ: CreateConfigAccount ngừng đọc sysvar tiền thuê ở cuối nhưng vẫn chấp nhận danh sách năm tài khoản cũ. AmmError lấy mã 60 (nó được đánh số từ 0, không phải 6000).Đọc toàn bộ mục →LaunchLab: quy tắc đường cong nền tảng thay thế danh sách trắng tham số đường cong
Các hạn chế tham số khởi chạy chuyển ra khỏi
PlatformConfig vào các tài khoản PlatformCurveRule cho mỗi config. Một quy tắc giữ tối đa 10 nhóm kiểm tra gồm tối đa 25 ràng buộc (field, op, value) trên 19 tham số khởi chạy, với Eq / Gte / Lte / Neq — vì vậy một nền tảng cuối cùng có thể biểu thị một dải giá trị, các cấp độ thay thế, một giới hạn định giá tốt nghiệp, một sàn di chuyển, gating loại token hoặc một nhóm chuyển đổi theo ngày, không có gì danh sách trắng chỉ bằng nhau có thể. PlatformConfig giữ kích thước 944 byte của nó: restrict_curve_param, curve_rule_manager và tiền tố độ dài vec được xóa đều đi ra khỏi padding. Các bộ giải mã phải bỏ Vec<PlatformCurveParam> ở cuối, và các nhà xây dựng khởi chạy phải thêm PDA quy tắc vào remaining_accounts trong khi cờ bật. Hai instruction bị xóa, bốn được thêm vào, hai biến thể UpdatePlatformConfig được thêm vào, 6024–6030 được thêm vào. Cần làm mới IDL. SDK cung cấp hai kiểm tra thuần off-chain để người tạo không bao giờ phải tìm hiểu quy tắc từ giao dịch bị hoàn nguyên, và mục nhập ghi lại một bài tập devnet trước khi bật cờ trên mainnet.Đọc toàn bộ mục →LaunchLab: nền tảng giữ cơ sở quyền rút tiền từ việc tạo mint
InitializeWithToken2022 hiện ghi PlatformConfig.transfer_fee_extension_auth vào withdraw_withheld_authority của mint cơ sở mới thay vì PDA khởi chạy authority, vì vậy một nền tảng có thể quét các khoản phí chuyển bị giữ lại trong giai đoạn đường cong liên kết thay vì chờ tốt nghiệp — chương trình tự nó không có instruction rút tiền bị giữ lại. MigrateToCpswap chỉ gán lại cơ sở quyền đó khi PDA vẫn giữ nó, điều này giữ tốt nghiệp hoạt động cho các mint của cả hai thế hệ. transfer_fee_config_authority vẫn chuyển chỉ khi tốt nghiệp, vì vậy xoay transfer_fee_extension_auth giữa khởi chạy im lặng để lại hai cơ sở quyền trên các khóa khác nhau. Không có bố cục tài khoản, instruction, đối số hoặc mã lỗi nào thay đổi.Đọc toàn bộ mục →LaunchLab: giới hạn tỷ lệ phí nền tảng tăng lên 500 bps
Trần
fee_rate nền tảng chuyển sang 50000 (500 bps) trên cả hai đường dẫn xác thực nó. CreatePlatformConfig bị giới hạn ở 10000 (100 bps) kể từ bản phát hành đầu tiên của chương trình; UpdatePlatformConfig bị giới hạn ở 25000 (250 bps) kể từ 2026-01-27. Hai kiểm tra hiện đồng ý, vì vậy một nền tảng được tạo ở bất kỳ tỷ lệ được phép nào cũng có thể được cập nhật ở nó — bao gồm thông qua biến thể AllInfo hàng loạt, nó xác thực lại fee_rate trong khi viết lại mọi trường khác. Hai đường dẫn vẫn tăng các lỗi khác nhau (InvalidInput khi tạo, InvalidPlatformInfo khi cập nhật). Không có bố cục tài khoản, instruction hoặc mã lỗi nào thay đổi, và không có nền tảng hoặc khởi chạy hiện có nào được định giá lại. GlobalConfig.max_share_fee_rate vẫn ở mức 100 bps và chỉ giới hạn share_fee_rate giới thiệu cho mỗi giao dịch.Đọc toàn bộ mục →LaunchLab: mint trích dẫn Token-2022
Một khởi chạy hiện có thể được trích dẫn trong một mint Token-2022.
CreateConfig, InitializeV2, InitializeWithToken2022, bốn instruction swap và mọi yêu cầu phí chấp nhận chương trình token trong slot chương trình trích dẫn của chúng; Initialize không được dùng nữa vẫn chỉ dành cho kế thừa. Các giới hạn slippage swap hiện được so sánh với những gì người trả phí thực sự trả hoặc nhận, ròng của phí chuyển mint trích dẫn. Bit1 PoolState.token_program_flag trở nên có ý nghĩa, vì vậy các bộ giải mã kiểm tra toàn bộ byte so với 0 sai đọc mint cơ sở kế thừa dưới dạng Token-2022. MigrateToCpswap đổi tên hai tài khoản chương trình token của nó thành token_program / token_program_2022, và 6023 được sử dụng lại cho CalculateOverflow.Đọc toàn bộ mục →LaunchLab: khởi chạy chỉ CPMM và kiểm soát cấu hình nền tảng
Khởi tạo khởi chạy mới hiện yêu cầu CPMM trong khi trạng thái liên kết AMM v4 kế thừa vẫn có thể di chuyển được. Trước bản phát hành này,
creator_scale tạo ra Khóa Phí do người tạo sở hữu; các di chuyển CPMM được thực hiện sau khi nâng cấp thay vào đó hợp nhất platform_scale + creator_scale thành một chia sẻ Khóa Phí do nền tảng sở hữu. Các nền tảng cũng có thể hạn chế các khởi chạy bằng các PDA PlatformAllowConfig của riêng chúng, và các nhà xây dựng di chuyển phải thêm cả hai PDA hỗ trợ mint CPMM.Đọc toàn bộ mục →CLMM: đóng băng NFT vị trí nhà phát hành bị hạn chế
Các mint NFT vị trí CLMM mới sử dụng pool của chúng làm cơ sở quyền đóng băng, nhưng các tài khoản token của chúng vẫn không bị đóng băng theo mặc định. Đóng băng chỉ xảy ra trên
OpenPositionV2 hoặc OpenPositionWithToken22Nft khi cơ sở quyền đóng băng mint vault cơ bản của một trong hai khớp với danh sách nhà phát hành bị hạn chế. Một vị trí phù hợp không thể chuyển hoặc thay đổi chủ sở hữu nhưng vẫn có thể quản lý thanh khoản. Lệnh gọi ClosePosition của nó phải thêm pool để CLMM có thể rã đông, đốt và đóng một cách nguyên tử. Các vị trí hiện có vẫn không thay đổi.Đọc toàn bộ mục →CPMM: thu thập phí tạo không cần phép
Instruction
CollectCreatorFeePermissionless bổ sung cho phép bất kỳ người trả phí nào quét tất cả các khoản phí tạo được tích lũy, trong khi ràng buộc người thụ hưởng và cả hai điểm đến token vào PoolState.pool_creator và ATA chính tắc của người tạo. Đường dẫn được ký bởi người tạo gốc vẫn không thay đổi. CreatePermissionPda cũng chấp nhận một cơ sở quyền cấp chuyên dụng, trong khi ClosePermissionPda vẫn chỉ dành cho admin.Đọc toàn bộ mục →CLMM: multi-pool được phép và bảo vệ tài khoản đóng băng lệnh giới hạn
Hai cập nhật chương trình CLMM bổ sung, tương thích ngược.
CreatePermissionedPool gấp seed_index không phải là không của client được cung cấp vào các hạt giống PDA pool, cho phép một toán tử được liệt trắng (một người giữ PDA Permission) tạo nhiều pool cho mỗi (config, mint0, mint1) — vì vậy ID pool không còn là chính tắc cho một cặp. Các instruction admin mới CreatePermissionPda / ClosePermissionPda quản lý các khoản cấp đó, và PoolState lấy trường seed_index (được cắt từ padding, không thay đổi kích thước). Riêng biệt, OpenLimitOrder hiện lấy các tài khoản phía đầu ra và từ chối các đơn hàng có tài khoản token đầu vào hoặc đầu ra bị đóng băng (NotApproved).Đọc toàn bộ mục →AMM v4: xóa phụ thuộc OpenBook / Serum
AMM v4 xóa phụ thuộc OpenBook/Serum lâu dài của nó, tất cả các CPI sổ lệnh và các instruction tạo thị trường chết.
SwapBaseIn / SwapBaseOut, Deposit và Withdraw giữ bố cục của chúng (các tài khoản thị trường bị xóa hiện bị bỏ qua, không được xác thực); một WithdrawPnl phá vỡ hoàn toàn (17 → 10, không tương thích) và SetParams (tài khoản giảm + param được đánh số lại); và Initialize, PreInitialize, MonitorStep, MigrateToOpenBook, WithdrawSrm, SimulateInfo, AdminCancelOrders không còn có thể gọi được. Bố cục tài khoản trên chuỗi và mã lỗi vẫn ổn định; di chuyển swap sang các điểm vào V2.Đọc toàn bộ mục →Stable AMM: xóa mã OpenBook (thị trường) chết
Stable AMM xóa các tài khoản và mã tạo thị trường OpenBook lâu dài của nó. Bố cục
SwapBaseIn / SwapBaseOut nhỏ hơn (18 → 9), Deposit (14 → 12) và Withdraw (21/22 → 12) (các bố cục cũ vẫn tương thích); một thay đổi WithdrawPnl phá vỡ hoàn toàn (16 → 10, không tương thích); phí giới thiệu bị loại bỏ; và một công thức tài sản pool chỉ vault đơn giản hóa. Hầu hết các instruction Stable khác không còn có thể gọi được.Đọc toàn bộ mục →CLMM: lệnh giới hạn, phí một phía, phí động
Ba khả năng CLMM tùy chọn, tương thích ngược: lệnh giới hạn hạng nhất (với người giữ định cư
limit_order_admin), thu thập phí một phía (CollectFeeOn) và phí động theo dõi biến động. Thêm CreateCustomizablePool, một reshape PoolState (thay đổi phá vỡ indexer), các trường TickState mới, mười một mã lỗi mới (với sự thay đổi số), và các bổ sung SDK / API phù hợp.Đọc toàn bộ mục →Xuất bản lần đầu
Bản phát hành công khai đầu tiên của bộ tài liệu Raydium, được xác minh dựa trên các triển khai mainnet-beta trực tiếp và
@raydium-io/raydium-sdk-v2@0.2.42-alpha.Đọc toàn bộ mục →Quy ước tài liệu
- Phiên bản: tài liệu này sử dụng phiên bản dựa trên lịch (YYYY-MM-DD). Mỗi lần cập nhật thêm một trang mục nhập mới và một hàng mới ở đầu dòng thời gian ở trên.
- Một trang cho mỗi bản phát hành: mỗi bản tóm tắt phát hành nằm trên trang riêng của nó trong
reference/changelog/, do đó chỉ mục này luôn ngắn gọn và mỗi mục nhập có thể được liên kết độc lập. - Ngày xác minh: mỗi mục nhập ghi lại khi nội dung được kiểm tra chéo lần cuối cùng với trạng thái on-chain / API và nguồn chương trình. Nếu không được nêu rõ, hãy giả định ngày chính của mục nhập.
- Thay đổi phá vỡ: được gọi ra trong hộp cảnh báo trên các trang bị ảnh hưởng và được gắn thẻ trong mục nhập.
- Phạm vi: nhật ký thay đổi này bao gồm chính tập tài liệu. Dòng thời gian lịch sử của chính giao thức nằm trong
introduction/history-and-milestonesvà là nguồn sự thật cho “khi nào X xảy ra trên Raydium”.
Sửa chữa
Nếu bạn tìm thấy lỗi trong tài liệu này, vui lòng mở một issue hoặc pull request trên kho lưu trữ tài liệu. Các sửa chữa được ghi lại dưới dạng các mục nhập nhật ký thay đổi.Con trỏ
introduction/history-and-milestones— dòng thời gian của chính giao thức.security/audits— lịch sử kiểm toán.ray/protocol-fees— phân chia phí giao thức.reference/program-addresses— nguồn sự thật của ID chương trình.

