2026-09-13 — CPMM: протокол получает долю комиссии создателя

​

TL;DR для интеграторов

• Обе инструкции сбора комиссии создателя изменили списки аккаунтов. Это нарушает совместимость. CollectCreatorFee получает creator_fee_share в позицию 5. CollectCreatorFeePermissionless получает amm_config в позицию 5 и creator_fee_share в позицию 6. Обе вставки находятся перед хранилищами, поэтому всё остальное смещается. Пересоберите эти транзакции; не патчьте их.
• creator_fee_share должен быть передан даже если он не существует. Он объявлен с ограничением seed, но читается как непроверенный аккаунт, поэтому адрес должен быть каноническим PDA в ["creator_fee_share", creator, amm_config], в то время как сам аккаунт опционален. Когда он пуст, программа возвращается к AmmConfig.creator_fee_share_rate.
• AmmConfig получает creator_fee_share_rate, вырезанный из padding. Аккаунт по-прежнему 236 байт и каждая существующая конфигурация продолжает десериализоваться — но первый u64 старого padding: [u64; 15] теперь является активным полем. Декодеры, которые моделируют хвост как массив из 15 элементов, читают коэффициент доли как padding[0].
• PoolState не изменяется. 637 байт, те же смещения, те же поля. Доля протокола учитывается в существующих счётчиках protocol_fees_token_{0,1} — нет нового счётчика и нет новой инструкции сбора для него.
• protocol_fees_token* теперь растёт вне свопов. Любой монитор, который согласует накопление протокола с объёмом торговли, увидит скачки при каждом сборе комиссии создателя.
• Оценка выплат создателю, которая читает creator_fees_token*, теперь завышает. Умножьте на (1 − share_rate / 1_000_000), разрешённое для этой пары (creator, amm_config).
• Добавлены две инструкции администратора: CreateCreatorFeeShare и CloseCreatorFeeShare. Один новый параметр UpdateAmmConfig: 8 → creator_fee_share_rate.
• Нет новых кодов ошибок. Новые пути переиспользуют InvalidOwner (6001), InvalidInput (6003) и MathOverflow (6011). 6000–6015 не изменены.
• Требуется обновление IDL — две новые инструкции, один новый тип аккаунта, два изменённых списка аккаунтов, одно новое поле конфигурации.

​

Как работает разделение

1. PDA CreatorFeeShare в ["creator_fee_share", creator, amm_config] — когда аккаунт существует и принадлежит CPMM, его share_rate побеждает.
2. AmmConfig.creator_fee_share_rate — значение по умолчанию для уровня комиссии, используется в противном случае.

// 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 возвращается и переводится создателю

• Округление благоприятствует создателю. Доля округляется вниз, поэтому пыль остаётся с создателем — то же направление, что и Fees::protocol_fee и Fees::fund_fee, которые также вырезают долю из уже накопленной комиссии. 20% комиссии в 1 единицу — это 0, а не 1.
• Стоимость сохраняется. creator_amount + shared_amount == creator_fee для каждого коэффициента и каждой комиссии вплоть до u64::MAX.
• share_rate = 0 — это ровно старое поведение. И значение конфигурации по умолчанию, и отсутствующий PDA дают создателю всю комиссию, поэтому ничего не меняется для любого существующего пула, пока администратор не установит коэффициент.

​

Изменения списков аккаунтов

​

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

• Создатель пула не является стороной ни одной инструкции и не подписывает. Аккаунт creator не проверяется — PDA может быть создан для ключа, который ещё не владеет пулом.
• Один аккаунт охватывает пару (creator, amm_config), поэтому он управляет каждым пулом, которым владеет этот создатель на этом уровне комиссии. Создатель с пулами на двух уровнях нуждается в двух аккаунтах, чтобы быть охваченным на обоих.
• Нет пути обновления. init не проходит при втором создании для той же пары; чтобы изменить коэффициент, закройте и пересоздайте.

​

Параметр 8 UpdateAmmConfig

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

​

Попутные изменения

​

Что не изменилось

• PoolState — 637 байт, те же поля, те же смещения. Доля протокола переиспользует существующий протокольный счёт вместо добавления собственных счётчиков.
• AmmConfig::LEN — по-прежнему 236 байт.
• Математика свопов, котировки и проверка k. Комиссия создателя начисляется ровно как раньше.
• CollectProtocolFee / CollectFundFee — те же аккаунты, те же подписывающие. CollectProtocolFee просто имеет больше для сбора.
• Коды ошибок. 6000–6015 не изменены; ничего не добавлено.
• Каждая другая инструкция и ID программы.

​

Обновлённые страницы

• products/cpmm/fees — новый раздел «Доля протокола в комиссии создателя», охватывающий разрешение коэффициента, арифметику разделения, округление и последствия для интеграторов; creator_fee_share_rate добавлен в список коэффициентов/единиц и таблицу параметров по умолчанию; таблица потока сбора переработана.
• products/cpmm/instructions — предупреждение о нарушении совместимости в начале; полные таблицы аккаунтов для обоих путей сбора комиссии создателя; новые разделы CreateCreatorFeeShare и CloseCreatorFeeShare; параметр 8 UpdateAmmConfig; примечание о порядке CollectExcessLamports; строки сводки и матрицы изменения состояния.
• products/cpmm/accounts — новый раздел аккаунта CreatorFeeShare; макет AmmConfig и предупреждение о вырезании padding; примечания счётчика комиссии PoolState; строки жизненного цикла аккаунта.
• products/cpmm/overview — выноска комиссии создателя и пункт «Предсказуемые комиссии».
• products/cpmm/math — примечание о том, что разделение намеренно отсутствует в математике свопов.
• products/cpmm/code-demos — предупреждение о том, что построители SDK перед обновлением выдают старые списки аккаунтов; фрагмент накопленной комиссии аннотирован.
• reference/program-addresses — новый раздел «Полномочия доли комиссии создателя CPMM»; creator_fee_share добавлен в блок seed PDA.
• reference/fee-comparison — creator_fee_share_rate выделен как четвёртый коэффициент CPMM с другой базой.