2026-09-13 — CPMM: o protocolo retém uma parte da taxa do criador

​

TL;DR para integradores

• Ambas as instruções de coleta de taxa de criador mudaram suas listas de contas. Isto é uma quebra. CollectCreatorFee ganha creator_fee_share na posição 5. CollectCreatorFeePermissionless ganha amm_config em 5 e creator_fee_share em 6. Ambas as inserções ficam antes dos cofres, então tudo depois se desloca. Reconstrua essas transações; não as corrija.
• creator_fee_share deve ser passado mesmo quando não existe. É declarado com uma restrição de seed mas lido como uma conta não verificada, então o endereço deve ser o PDA canônico em ["creator_fee_share", creator, amm_config] enquanto a conta em si é opcional. Quando está vazia, o programa volta para AmmConfig.creator_fee_share_rate.
• AmmConfig ganha creator_fee_share_rate, esculpido do padding. A conta ainda tem 236 bytes e cada config existente continua desserializando — mas o primeiro u64 do antigo padding: [u64; 15] agora é um campo ativo. Decodificadores que modelam a cauda como um array de 15 elementos leem a taxa de compartilhamento como padding[0].
• PoolState não foi alterado. 637 bytes, mesmos offsets, mesmos campos. A parte do protocolo é registrada nos contadores existentes protocol_fees_token_{0,1} — não há novo contador e nenhuma nova instrução de coleta para isso.
• protocol_fees_token* agora cresce fora dos swaps. Qualquer monitor que reconcilie acúmulo de protocolo contra volume de negociação verá saltos em cada coleta de taxa de criador.
• Um estimador de pagamento de criador que lê creator_fees_token* agora superestima. Multiplique por (1 − share_rate / 1_000_000), resolvido para esse par (creator, amm_config).
• Duas instruções de admin são adicionadas: CreateCreatorFeeShare e CloseCreatorFeeShare. Um novo parâmetro UpdateAmmConfig: 8 → creator_fee_share_rate.
• Sem novos códigos de erro. Os novos caminhos reutilizam InvalidOwner (6001), InvalidInput (6003) e MathOverflow (6011). 6000–6015 não foram alterados.
• Uma atualização de IDL é necessária — duas novas instruções, um novo tipo de conta, duas listas de contas alteradas, um novo campo de config.

​

Como a divisão funciona

1. PDA CreatorFeeShare em ["creator_fee_share", creator, amm_config] — quando a conta existe e é de propriedade do CPMM, seu share_rate vence.
2. AmmConfig.creator_fee_share_rate — o padrão do nível de taxa, usado caso contrário.

// 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 é retornado e transferido para o criador

• O arredondamento favorece o criador. A parte é arredondada para baixo, então o pó fica com o criador — a mesma direção que Fees::protocol_fee e Fees::fund_fee, que também esculpem uma parte de uma taxa já acumulada. 20% de uma taxa de 1 unidade é 0, não 1.
• O valor é conservado. creator_amount + shared_amount == creator_fee para cada taxa e cada taxa até u64::MAX.
• share_rate = 0 é exatamente o comportamento antigo. Tanto o valor de config padrão quanto um PDA ausente dão ao criador a taxa inteira, então nada muda para nenhum pool existente até que um admin defina uma taxa.

​

Mudanças na lista de contas

​

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

• O criador do pool não é parte de nenhuma instrução e não assina. A conta creator não é verificada — o PDA pode ser criado para uma chave que ainda não possui nenhum pool.
• Uma conta cobre um par (creator, amm_config), então governa cada pool que esse criador possui nesse nível de taxa. Um criador com pools em dois níveis precisa de duas contas para ser coberto em ambos.
• Não há caminho de atualização. init falha em uma segunda criação para o mesmo par; para alterar uma taxa, feche e recrie.

​

Parâmetro 8 de UpdateAmmConfig

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

​

Viajando junto

​

O que não mudou

• PoolState — 637 bytes, mesmos campos, mesmos offsets. A parte do protocolo reutiliza o bucket de protocolo existente em vez de adicionar contadores próprios.
• AmmConfig::LEN — ainda 236 bytes.
• Matemática de swap, cotação e a verificação k. A taxa de criador é cobrada exatamente como antes.
• CollectProtocolFee / CollectFundFee — mesmas contas, mesmos signatários. CollectProtocolFee simplesmente tem mais para coletar.
• Códigos de erro. 6000–6015 sem alteração; nada acrescentado.
• Cada outra instrução e o ID do programa.

​

Páginas atualizadas

• products/cpmm/fees — nova seção “Compartilhamento de protocolo da taxa do criador” cobrindo resolução de taxa, aritmética de divisão, arredondamento e consequências do integrador; creator_fee_share_rate adicionado à lista de taxas/unidades e tabela de parâmetros padrão; tabela de fluxo de coleta reformulada.
• products/cpmm/instructions — aviso de mudança quebrada no topo; tabelas de contas completas para ambos os caminhos de taxa de criador; novas seções CreateCreatorFeeShare e CloseCreatorFeeShare; parâmetro 8 de UpdateAmmConfig; nota de ordenação de CollectExcessLamports; linhas de resumo e matriz de mudança de estado.
• products/cpmm/accounts — nova seção de conta CreatorFeeShare; layout de AmmConfig e aviso de carve de padding; notas de contador de taxa de PoolState; linhas de ciclo de vida de conta.
• products/cpmm/overview — chamada de taxa de criador e o marcador “Taxas previsíveis”.
• products/cpmm/math — uma nota de que a divisão é deliberadamente ausente da matemática de swap.
• products/cpmm/code-demos — aviso de que construtores de SDK pré-atualização emitem as listas de contas antigas; snippet de taxa acumulada anotado.
• reference/program-addresses — nova seção “Autoridade de compartilhamento de taxa de criador do CPMM”; creator_fee_share adicionado ao bloco de seed de PDA.
• reference/fee-comparison — creator_fee_share_rate chamado como uma quarta taxa de CPMM com uma base diferente.