2026-09-13 — CPMM: giao thức giữ lại một phần phí tạo pool

​

TL;DR cho các nhà tích hợp

• Cả hai hướng dẫn thu thập phí tạo pool đã thay đổi danh sách tài khoản của chúng. Đây là một thay đổi phá vỡ. CollectCreatorFee thêm creator_fee_share ở vị trí 5. CollectCreatorFeePermissionless thêm amm_config ở vị trí 5 và creator_fee_share ở vị trí 6. Cả hai chèn nằm trước các vault, vì vậy mọi thứ sau đó sẽ dịch chuyển. Xây dựng lại các giao dịch này; không cố gắng vá chúng.
• creator_fee_share phải được truyền ngay cả khi nó không tồn tại. Nó được khai báo với ràng buộc seed nhưng được đọc như một tài khoản không được kiểm tra, vì vậy địa chỉ phải là PDA chính tắc tại ["creator_fee_share", creator, amm_config] trong khi tài khoản chính nó là tùy chọn. Khi nó trống, chương trình quay lại AmmConfig.creator_fee_share_rate.
• AmmConfig có creator_fee_share_rate, được cắt từ padding. Tài khoản vẫn là 236 byte và mọi cấu hình hiện có vẫn tiếp tục deserialize — nhưng u64 đầu tiên của padding: [u64; 15] cũ hiện là một trường hoạt động. Các bộ giải mã mô hình phần đuôi dưới dạng mảng 15 phần tử sẽ đọc tỷ lệ chia sẻ dưới dạng padding[0].
• PoolState không thay đổi. 637 byte, cùng offset, cùng trường. Phần chia sẻ của giao thức được ghi vào các bộ đếm protocol_fees_token_{0,1} hiện có — không có bộ đếm mới và không có hướng dẫn thu thập mới cho nó.
• protocol_fees_token* hiện tăng bên ngoài swap. Bất kỳ monitor nào đối chiếu tích lũy giao thức với khối lượng giao dịch sẽ thấy các bước nhảy ở mỗi lần thu thập phí tạo pool.
• Một công cụ ước tính thanh toán tạo pool đọc creator_fees_token* hiện nêu quá cao. Nhân với (1 − share_rate / 1_000_000), được giải quyết cho cặp (creator, amm_config) đó.
• Hai hướng dẫn quản trị được thêm: CreateCreatorFeeShare và CloseCreatorFeeShare. Một tham số UpdateAmmConfig mới: 8 → creator_fee_share_rate.
• Không có mã lỗi mới. Các đường dẫn mới sử dụng lại InvalidOwner (6001), InvalidInput (6003) và MathOverflow (6011). 6000–6015 không thay đổi.
• Cần làm mới IDL — hai hướng dẫn mới, một loại tài khoản mới, hai danh sách tài khoản đã thay đổi, một trường cấu hình mới.

​

Cách chia tách hoạt động

1. CreatorFeeShare PDA tại ["creator_fee_share", creator, amm_config] — khi tài khoản tồn tại và được sở hữu bởi CPMM, share_rate của nó sẽ thắng.
2. AmmConfig.creator_fee_share_rate — mặc định của mức phí, được sử dụng nếu không.

// states/creator_fee_share.rs
shared_amount  = floor(creator_fee * share_rate / 1_000_000);
creator_amount = creator_fee - shared_amount;

// states/pool.rs — PoolState::settle_creator_fee
self.protocol_fees_token_i = self.protocol_fees_token_i.checked_add(shared_amount_i)?;
self.creator_fees_token_i  = 0;
// creator_amount_i is returned and transferred out to the creator

• Làm tròn ưu tiên tạo pool. Phần chia sẻ làm tròn xuống, vì vậy bụi vẫn ở với tạo pool — cùng hướng với Fees::protocol_fee và Fees::fund_fee, cũng cắt một phần từ một phí đã tích lũy. 20% của một phí 1 đơn vị là 0, không phải 1.
• Giá trị được bảo toàn. creator_amount + shared_amount == creator_fee cho mọi tỷ lệ và mọi phí lên đến u64::MAX.
• share_rate = 0 chính xác là hành vi cũ. Cả giá trị cấu hình mặc định và một PDA bị thiếu đều cho tạo pool toàn bộ phí, vì vậy không có gì thay đổi cho bất kỳ pool hiện có nào cho đến khi quản trị viên đặt tỷ lệ.

​

Thay đổi danh sách tài khoản

​

CreateCreatorFeeShare và CloseCreatorFeeShare

pub struct CreatorFeeShare {
    pub bump: u8,
    pub creator: Pubkey,
    pub amm_config: Pubkey,
    pub share_rate: u64,
    pub padding: [u64; 8],
}
// CreatorFeeShare::LEN == 145

• Người tạo pool không phải là một bên trong cả hai hướng dẫn và không ký. Tài khoản creator không được kiểm tra — PDA có thể được tạo cho một khóa chưa sở hữu bất kỳ pool nào.
• Một tài khoản bao gồm một cặp (creator, amm_config), vì vậy nó quản lý mọi pool mà tạo pool đó sở hữu trên mức phí đó. Một tạo pool có các pool trên hai mức cần hai tài khoản để được bao gồm trên cả hai.
• Không có đường dẫn cập nhật. init không thành công khi tạo lần thứ hai cho cùng một cặp; để thay đổi tỷ lệ, hãy đóng và tạo lại.

​

Tham số UpdateAmmConfig 8

Some(8) => update_creator_fee_share_rate(amm_config, value),   // asserts value <= 1_000_000

​

Đi cùng

​

Những gì không thay đổi

• PoolState — 637 byte, cùng trường, cùng offset. Phần chia sẻ của giao thức sử dụng lại bộ giao thức hiện có thay vì thêm bộ đếm của riêng nó.
• AmmConfig::LEN — vẫn là 236 byte.
• Toán học swap, báo giá và kiểm tra k. Phí tạo pool được tính chính xác như trước.
• CollectProtocolFee / CollectFundFee — cùng tài khoản, cùng người ký. CollectProtocolFee chỉ có nhiều hơn để thu thập.
• Mã lỗi. 6000–6015 không thay đổi; không có gì được thêm vào.
• Mọi hướng dẫn khác và ID chương trình.

​

Trang được cập nhật

• products/cpmm/fees — phần “Chia sẻ giao thức của phí tạo pool” mới bao gồm giải quyết tỷ lệ, số học chia tách, làm tròn và hậu quả của nhà tích hợp; creator_fee_share_rate được thêm vào danh sách tỷ lệ/đơn vị và bảng tham số mặc định; bảng luồng thu thập được sắp xếp lại.
• products/cpmm/instructions — cảnh báo thay đổi phá vỡ ở đầu; bảng tài khoản đầy đủ cho cả hai đường dẫn phí tạo pool; các phần CreateCreatorFeeShare và CloseCreatorFeeShare mới; tham số UpdateAmmConfig 8; ghi chú thứ tự CollectExcessLamports; hàng tóm tắt và ma trận thay đổi trạng thái.
• products/cpmm/accounts — phần tài khoản CreatorFeeShare mới; bố cục AmmConfig và cảnh báo cắt padding; ghi chú bộ đếm phí PoolState; hàng vòng đời tài khoản.
• products/cpmm/overview — chú thích phí tạo pool và dấu đầu dòng “Phí có thể dự đoán”.
• products/cpmm/math — một ghi chú rằng sự chia tách được cố ý loại trừ khỏi toán học swap.
• products/cpmm/code-demos — cảnh báo rằng các trình xây dựng SDK trước nâng cấp phát ra danh sách tài khoản cũ; đoạn phí tích lũy được chú thích.
• reference/program-addresses — phần “Cơ quan chia sẻ phí tạo pool CPMM” mới; creator_fee_share được thêm vào khối hạt giống PDA.
• reference/fee-comparison — creator_fee_share_rate được gọi ra như một tỷ lệ CPMM thứ tư với cơ sở khác.