2026-09-13 — CPMM : le protocole prélève une part des frais de créateur

​

TL;DR pour les intégrateurs

• Les deux instructions de collecte des frais de créateur ont changé leurs listes de comptes. C’est une rupture. CollectCreatorFee gagne creator_fee_share à la position 5. CollectCreatorFeePermissionless gagne amm_config à la position 5 et creator_fee_share à la position 6. Les deux insertions se situent avant les coffres, donc tout ce qui suit se décale. Reconstruisez ces transactions ; ne les patchez pas.
• creator_fee_share doit être passé même s’il n’existe pas. Il est déclaré avec une contrainte de seed mais lu comme un compte non vérifié, donc l’adresse doit être le PDA canonique à ["creator_fee_share", creator, amm_config] tandis que le compte lui-même est optionnel. Quand il est vide, le programme revient à AmmConfig.creator_fee_share_rate.
• AmmConfig gagne creator_fee_share_rate, prélevé sur le padding. Le compte fait toujours 236 octets et chaque config existante continue de se désérialiser — mais le premier u64 de l’ancien padding: [u64; 15] est maintenant un champ actif. Les décodeurs qui modélisent la queue comme un tableau de 15 éléments lisent le taux de partage comme padding[0].
• PoolState est inchangé. 637 octets, mêmes décalages, mêmes champs. La part du protocole est enregistrée dans les compteurs existants protocol_fees_token_{0,1} — il n’y a pas de nouveau compteur et pas de nouvelle instruction de collecte pour cela.
• protocol_fees_token* croît maintenant en dehors des swaps. Tout moniteur qui rapproche l’accumulation de protocole au volume d’échanges verra des sauts à chaque collecte de frais de créateur.
• Un estimateur de paiement de créateur qui lit creator_fees_token* surestime maintenant. Multipliez par (1 − share_rate / 1_000_000), résolu pour cette paire (creator, amm_config).
• Deux instructions d’administration sont ajoutées : CreateCreatorFeeShare et CloseCreatorFeeShare. Un nouveau paramètre UpdateAmmConfig : 8 → creator_fee_share_rate.
• Aucun nouveau code d’erreur. Les nouveaux chemins réutilisent InvalidOwner (6001), InvalidInput (6003) et MathOverflow (6011). 6000–6015 sont inchangés.
• Un rafraîchissement IDL est requis — deux nouvelles instructions, un nouveau type de compte, deux listes de comptes modifiées, un nouveau champ de config.

​

Comment fonctionne le partage

1. PDA CreatorFeeShare à ["creator_fee_share", creator, amm_config] — quand le compte existe et est possédé par CPMM, son share_rate gagne.
2. AmmConfig.creator_fee_share_rate — la valeur par défaut du palier de frais, utilisée sinon.

// 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 est retourné et transféré au créateur

• L’arrondi favorise le créateur. Le partage arrondit vers le bas, donc la poussière reste avec le créateur — la même direction que Fees::protocol_fee et Fees::fund_fee, qui carvent aussi une part d’une commission déjà accumulée. 20 % d’une commission d’1 unité est 0, pas 1.
• La valeur est conservée. creator_amount + shared_amount == creator_fee pour chaque taux et chaque commission jusqu’à u64::MAX.
• share_rate = 0 est exactement l’ancien comportement. La valeur par défaut de la config et un PDA manquant donnent tous deux au créateur la totalité de la commission, donc rien ne change pour aucun pool existant jusqu’à ce qu’un administrateur définisse un taux.

​

Changements de listes de comptes

​

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

• Le créateur du pool n’est pas une partie à l’une ou l’autre instruction et ne signe pas. Le compte creator n’est pas vérifié — le PDA peut être créé pour une clé qui ne possède pas encore de pool.
• Un compte couvre une paire (creator, amm_config), donc il gouverne chaque pool que ce créateur possède sur ce palier de frais. Un créateur avec des pools sur deux paliers a besoin de deux comptes pour être couvert sur les deux.
• Il n’y a pas de chemin de mise à jour. init échoue sur une deuxième création pour la même paire ; pour changer un taux, fermez et recréez.

​

Paramètre 8 de UpdateAmmConfig

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

​

Accompagnements

​

Ce qui n’a pas changé

• PoolState — 637 octets, mêmes champs, mêmes décalages. La part du protocole réutilise le bucket de protocole existant plutôt que d’ajouter ses propres compteurs.
• AmmConfig::LEN — toujours 236 octets.
• Mathématique du swap, devis, et la vérification k. Les frais de créateur sont facturés exactement comme avant.
• CollectProtocolFee / CollectFundFee — mêmes comptes, mêmes signataires. CollectProtocolFee a simplement plus à collecter.
• Codes d’erreur. 6000–6015 inchangés ; rien d’ajouté.
• Chaque autre instruction, et l’ID du programme.

​

Pages mises à jour

• products/cpmm/fees — nouvelle section « Part de protocole des frais de créateur » couvrant la résolution des taux, l’arithmétique du partage, l’arrondi, et les conséquences pour l’intégrateur ; creator_fee_share_rate ajouté à la liste des taux/unités et au tableau des paramètres par défaut ; tableau du flux de collecte refondu.
• products/cpmm/instructions — avertissement de rupture en haut ; tableaux de comptes complets pour les deux chemins de frais de créateur ; nouvelles sections CreateCreatorFeeShare et CloseCreatorFeeShare ; paramètre 8 de UpdateAmmConfig ; note d’ordre de CollectExcessLamports ; lignes de résumé et de matrice de changement d’état.
• products/cpmm/accounts — nouvelle section de compte CreatorFeeShare ; disposition de AmmConfig et avertissement de carve de padding ; notes de compteur de frais de PoolState ; lignes de cycle de vie de compte.
• products/cpmm/overview — appel de frais de créateur et la puce « Frais prévisibles ».
• products/cpmm/math — une note que le partage est délibérément absent de la mathématique du swap.
• products/cpmm/code-demos — avertissement que les constructeurs SDK pré-mise à niveau émettent les anciennes listes de comptes ; extrait de frais accumulés annoté.
• reference/program-addresses — nouvelle section « Autorité de partage des frais de créateur CPMM » ; creator_fee_share ajouté au bloc de seeds PDA.
• reference/fee-comparison — creator_fee_share_rate appelé comme un quatrième taux CPMM avec une base différente.