2026-09-13 — CPMM: protokol mengambil bagian dari biaya kreator

​

TL;DR untuk integrator

• Kedua instruksi pengumpulan biaya kreator mengubah daftar akun mereka. Ini adalah breaking change. CollectCreatorFee menambahkan creator_fee_share pada posisi 5. CollectCreatorFeePermissionless menambahkan amm_config pada 5 dan creator_fee_share pada 6. Kedua penyisipan berada sebelum vault, jadi semuanya sesudahnya bergeser. Bangun ulang transaksi ini; jangan patch.
• creator_fee_share harus dilewatkan bahkan ketika tidak ada. Dideklarasikan dengan batasan seed tetapi dibaca sebagai akun yang tidak diperiksa, jadi alamat harus PDA kanonik di ["creator_fee_share", creator, amm_config] sementara akun itu sendiri opsional. Ketika kosong, program kembali ke AmmConfig.creator_fee_share_rate.
• AmmConfig mendapatkan creator_fee_share_rate, diambil dari padding. Akun masih 236 byte dan setiap konfigurasi yang ada terus deserialize — tetapi u64 pertama dari padding: [u64; 15] lama sekarang adalah bidang aktif. Decoder yang memodelkan ekor sebagai array 15 elemen membaca tingkat bagian sebagai padding[0].
• PoolState tidak berubah. 637 byte, offset sama, bidang sama. Bagian protokol dicatat ke dalam penghitung protocol_fees_token_{0,1} yang ada — tidak ada penghitung baru dan tidak ada instruksi pengumpulan baru untuk itu.
• protocol_fees_token* sekarang tumbuh di luar swap. Monitor apa pun yang merekonsiliasi akrual protokol terhadap volume perdagangan akan melihat lompatan pada setiap pengumpulan biaya kreator.
• Estimator pembayaran kreator yang membaca creator_fees_token* sekarang menyatakan berlebihan. Kalikan dengan (1 − share_rate / 1_000_000), diselesaikan untuk pasangan (creator, amm_config) itu.
• Dua instruksi admin ditambahkan: CreateCreatorFeeShare dan CloseCreatorFeeShare. Satu param UpdateAmmConfig baru: 8 → creator_fee_share_rate.
• Tidak ada kode kesalahan baru. Jalur baru menggunakan kembali InvalidOwner (6001), InvalidInput (6003) dan MathOverflow (6011). 6000–6015 tidak berubah.
• Penyegaran IDL diperlukan — dua instruksi baru, satu tipe akun baru, dua daftar akun yang berubah, satu bidang konfigurasi baru.

​

Cara pemisahan bekerja

1. PDA CreatorFeeShare di ["creator_fee_share", creator, amm_config] — ketika akun ada dan dimiliki oleh CPMM, share_rate miliknya menang.
2. AmmConfig.creator_fee_share_rate — default tingkat biaya, digunakan sebaliknya.

// 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

• Pembulatan menguntungkan kreator. Bagian lantai, jadi debu tetap bersama kreator — arah yang sama dengan Fees::protocol_fee dan Fees::fund_fee, yang juga mengukir bagian dari biaya yang sudah terakumulasi. 20% dari biaya 1 unit adalah 0, bukan 1.
• Nilai dikonservasi. creator_amount + shared_amount == creator_fee untuk setiap tingkat dan setiap biaya hingga u64::MAX.
• share_rate = 0 adalah perilaku lama yang tepat. Baik nilai konfigurasi default maupun PDA yang hilang memberikan kreator seluruh biaya, jadi tidak ada yang berubah untuk pool yang ada sampai admin menetapkan tingkat.

​

Perubahan daftar akun

​

CreateCreatorFeeShare dan 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

• Kreator pool bukan pihak dalam instruksi apa pun dan tidak menandatangani. Akun creator tidak diperiksa — PDA dapat dibuat untuk kunci yang belum memiliki pool.
• Satu akun mencakup pasangan (creator, amm_config), jadi mengatur setiap pool yang dimiliki kreator itu pada tingkat biaya itu. Kreator dengan pool pada dua tingkat membutuhkan dua akun untuk dicakup di keduanya.
• Tidak ada jalur pembaruan. init gagal pada pembuatan kedua untuk pasangan yang sama; untuk mengubah tingkat, tutup dan buat ulang.

​

Param UpdateAmmConfig 8

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

​

Naik bersama

​

Apa yang tidak berubah

• PoolState — 637 byte, bidang sama, offset sama. Bagian protokol menggunakan kembali bucket protokol yang ada daripada menambahkan penghitung sendiri.
• AmmConfig::LEN — masih 236 byte.
• Matematika swap, kutipan, dan pemeriksaan k. Biaya kreator dikenakan persis seperti sebelumnya.
• CollectProtocolFee / CollectFundFee — akun sama, penandatangan sama. CollectProtocolFee hanya memiliki lebih banyak untuk dikumpulkan.
• Kode kesalahan. 6000–6015 tidak berubah; tidak ada yang ditambahkan.
• Setiap instruksi lainnya, dan ID program.

​

Halaman yang diperbarui

• products/cpmm/fees — bagian “Bagian protokol dari biaya kreator” baru mencakup resolusi tingkat, aritmatika pemisahan, pembulatan, dan konsekuensi integrator; creator_fee_share_rate ditambahkan ke daftar tingkat/unit dan tabel parameter default; tabel alur pengumpulan dikerjakan ulang.
• products/cpmm/instructions — peringatan breaking-change di atas; tabel akun lengkap untuk kedua jalur biaya kreator; bagian CreateCreatorFeeShare dan CloseCreatorFeeShare baru; param UpdateAmmConfig 8; catatan pengurutan CollectExcessLamports; ringkasan dan baris matriks perubahan status.
• products/cpmm/accounts — bagian akun CreatorFeeShare baru; tata letak AmmConfig dan peringatan padding-carve; catatan penghitung biaya PoolState; baris siklus hidup akun.
• products/cpmm/overview — callout biaya kreator dan bullet “Biaya yang dapat diprediksi”.
• products/cpmm/math — catatan bahwa pemisahan sengaja tidak ada dalam matematika swap.
• products/cpmm/code-demos — peringatan bahwa pembangun SDK pra-upgrade memancarkan daftar akun lama; cuplikan biaya terakumulasi dengan anotasi.
• reference/program-addresses — bagian “Otoritas pembagian biaya kreator CPMM” baru; creator_fee_share ditambahkan ke blok benih PDA.
• reference/fee-comparison — creator_fee_share_rate dipanggil sebagai tingkat CPMM keempat dengan basis berbeda.