2026-09-13 — CPMM: Das Protokoll behält einen Anteil der Creator-Gebühr

​

TL;DR für Integratoren

• Beide Anweisungen zur Erhebung der Creator-Gebühr haben ihre Kontolisten geändert. Dies ist ein Breaking Change. CollectCreatorFee erhält creator_fee_share an Position 5. CollectCreatorFeePermissionless erhält amm_config an 5 und creator_fee_share an 6. Beide Einfügungen sitzen vor den Vaults, daher verschiebt sich alles danach. Erstellen Sie diese Transaktionen neu; patchen Sie sie nicht.
• creator_fee_share muss auch dann übergeben werden, wenn es nicht existiert. Es wird mit einer Seed-Constraint deklariert, aber als unkontrolliertes Konto gelesen, daher muss die Adresse das kanonische PDA bei ["creator_fee_share", creator, amm_config] sein, während das Konto selbst optional ist. Wenn es leer ist, fällt das Programm auf AmmConfig.creator_fee_share_rate zurück.
• AmmConfig erhält creator_fee_share_rate, geschnitten aus dem Padding. Das Konto ist immer noch 236 Bytes und jede bestehende Config deserialisiert weiterhin — aber das erste u64 des alten padding: [u64; 15] ist jetzt ein aktives Feld. Decoder, die den Tail als 15-Element-Array modellieren, lesen die Share-Rate als padding[0].
• PoolState ist unverändert. 637 Bytes, gleiche Offsets, gleiche Felder. Der Anteil des Protokolls wird in die bestehenden protocol_fees_token_{0,1}-Zähler gebucht — es gibt keinen neuen Zähler und keine neue Erhebungsanweisung dafür.
• protocol_fees_token* wächst nun außerhalb von Swaps. Jeder Monitor, der die Protokoll-Abgrenzung gegen das Handelsvolumen abgleicht, sieht Sprünge bei jeder Creator-Gebührenerhebung.
• Ein Creator-Auszahlungs-Estimator, der creator_fees_token* liest, überschätzt nun. Multiplizieren Sie mit (1 − share_rate / 1_000_000), aufgelöst für das (creator, amm_config)-Paar.
• Zwei Admin-Anweisungen werden hinzugefügt: CreateCreatorFeeShare und CloseCreatorFeeShare. Ein neuer UpdateAmmConfig-Parameter: 8 → creator_fee_share_rate.
• Keine neuen Fehlercodes. Die neuen Pfade verwenden InvalidOwner (6001), InvalidInput (6003) und MathOverflow (6011) erneut. 6000–6015 sind unverändert.
• Eine IDL-Aktualisierung ist erforderlich — zwei neue Anweisungen, ein neuer Kontotyp, zwei geänderte Kontolisten, ein neues Config-Feld.

​

Wie die Aufteilung funktioniert

1. CreatorFeeShare-PDA bei ["creator_fee_share", creator, amm_config] — wenn das Konto existiert und von CPMM besessen wird, gewinnt sein share_rate.
2. AmmConfig.creator_fee_share_rate — der Standard des Gebührentiers, sonst verwendet.

// 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 wird zurückgegeben und an den Creator übertragen

• Rundung bevorzugt den Creator. Der Anteil wird abgerundet, daher bleibt der Staub beim Creator — die gleiche Richtung wie Fees::protocol_fee und Fees::fund_fee, die auch einen Anteil aus einer bereits angesammelten Gebühr schneiden. 20% einer 1-Unit-Gebühr sind 0, nicht 1.
• Der Wert bleibt erhalten. creator_amount + shared_amount == creator_fee für jeden Satz und jede Gebühr bis u64::MAX.
• share_rate = 0 ist genau das alte Verhalten. Sowohl der Standard-Config-Wert als auch ein fehlendes PDA geben dem Creator die gesamte Gebühr, daher ändert sich nichts für einen bestehenden Pool, bis ein Admin einen Satz festlegt.

​

Kontolisten-Änderungen

​

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

• Der Pool-Creator ist keine Partei für eine der beiden Anweisungen und unterzeichnet nicht. Das creator-Konto ist unkontrolliert — das PDA kann für einen Schlüssel erstellt werden, der noch keinen Pool besitzt.
• Ein Konto deckt ein (creator, amm_config)-Paar ab, daher regelt es jeden Pool, den dieser Creator auf diesem Gebührentier besitzt. Ein Creator mit Pools auf zwei Tiers benötigt zwei Konten, um auf beiden abgedeckt zu sein.
• Es gibt keinen Update-Pfad. init schlägt bei einer zweiten Erstellung für das gleiche Paar fehl; um einen Satz zu ändern, schließen und neu erstellen.

​

UpdateAmmConfig-Parameter 8

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

​

Mitfahrer

​

Was sich nicht geändert hat

• PoolState — 637 Bytes, gleiche Felder, gleiche Offsets. Der Anteil des Protokolls verwendet den bestehenden Protokoll-Bucket, statt Zähler hinzuzufügen.
• AmmConfig::LEN — immer noch 236 Bytes.
• Swap-Mathematik, Quoting und die k-Prüfung. Die Creator-Gebühr wird genau wie zuvor berechnet.
• CollectProtocolFee / CollectFundFee — gleiche Konten, gleiche Unterzeichner. CollectProtocolFee hat einfach mehr zu erheben.
• Fehlercodes. 6000–6015 unverändert; nichts angehängt.
• Jede andere Anweisung und die Programm-ID.

​

Aktualisierte Seiten

• products/cpmm/fees — neuer Abschnitt „Protokoll-Anteil der Creator-Gebühr” mit Satzauflösung, Aufteilungsarithmetik, Rundung und Integrator-Konsequenzen; creator_fee_share_rate zur Sätze/Einheiten-Liste und zur Standardparameter-Tabelle hinzugefügt; Erhebungsfluss-Tabelle überarbeitet.
• products/cpmm/instructions — Breaking-Change-Warnung oben; vollständige Kontotabellen für beide Creator-Fee-Pfade; neue CreateCreatorFeeShare- und CloseCreatorFeeShare-Abschnitte; UpdateAmmConfig-Parameter 8; CollectExcessLamports-Reihenfolge-Notiz; Zusammenfassungs- und Zustandsänderungs-Matrix-Zeilen.
• products/cpmm/accounts — neuer CreatorFeeShare-Kontoabschnitt; AmmConfig-Layout und Padding-Schnitt-Warnung; PoolState-Gebühren-Zähler-Notizen; Konto-Lebenszyklus-Zeilen.
• products/cpmm/overview — Creator-Fee-Callout und die Bullet „Vorhersehbare Gebühren”.
• products/cpmm/math — eine Notiz, dass die Aufteilung absichtlich aus der Swap-Mathematik fehlt.
• products/cpmm/code-demos — Warnung, dass Pre-Upgrade-SDK-Builder die alten Kontolisten ausgeben; Snippet für angesammelte Gebühren kommentiert.
• reference/program-addresses — neuer Abschnitt „CPMM-Creator-Fee-Share-Autorität”; creator_fee_share zum PDA-Seed-Block hinzugefügt.
• reference/fee-comparison — creator_fee_share_rate als vierter CPMM-Satz mit einer anderen Basis hervorgehoben.