2026-09-13 — CPMM: el protocolo retiene una parte de la comisión del creador

​

TL;DR para integradores

• Ambas instrucciones de recopilación de comisión del creador cambiaron sus listas de cuentas. Esto es una ruptura. CollectCreatorFee gana creator_fee_share en la posición 5. CollectCreatorFeePermissionless gana amm_config en 5 y creator_fee_share en 6. Ambas inserciones se sientan antes de las bóvedas, por lo que todo lo demás se desplaza. Reconstruye estas transacciones; no las parches.
• creator_fee_share debe pasarse incluso cuando no existe. Se declara con una restricción de semilla pero se lee como una cuenta sin verificar, por lo que la dirección debe ser el PDA canónico en ["creator_fee_share", creator, amm_config] mientras que la cuenta en sí es opcional. Cuando está vacía, el programa recurre a AmmConfig.creator_fee_share_rate.
• AmmConfig gana creator_fee_share_rate, tallado del relleno. La cuenta sigue siendo 236 bytes y cada configuración existente sigue deserializándose — pero el primer u64 del antiguo padding: [u64; 15] es ahora un campo activo. Los decodificadores que modelan la cola como una matriz de 15 elementos leen la tasa de participación como padding[0].
• PoolState no ha cambiado. 637 bytes, mismos desplazamientos, mismos campos. La parte del protocolo se registra en los contadores existentes protocol_fees_token_{0,1} — no hay nuevo contador ni nueva instrucción de recopilación para él.
• protocol_fees_token* ahora crece fuera de los swaps. Cualquier monitor que reconcilie la acumulación de protocolo contra el volumen de operaciones verá saltos en cada recopilación de comisión del creador.
• Un estimador de pago del creador que lee creator_fees_token* ahora sobrestima. Multiplica por (1 − share_rate / 1_000_000), resuelto para ese par (creator, amm_config).
• Se agregan dos instrucciones de administrador: CreateCreatorFeeShare y CloseCreatorFeeShare. Un nuevo parámetro UpdateAmmConfig: 8 → creator_fee_share_rate.
• Sin nuevos códigos de error. Las nuevas rutas reutilizan InvalidOwner (6001), InvalidInput (6003) e MathOverflow (6011). 6000–6015 no cambian.
• Se requiere una actualización de IDL — dos nuevas instrucciones, un nuevo tipo de cuenta, dos listas de cuentas modificadas, un nuevo campo de configuración.

​

Cómo funciona la división

1. PDA CreatorFeeShare en ["creator_fee_share", creator, amm_config] — cuando la cuenta existe y es propiedad de CPMM, su share_rate gana.
2. AmmConfig.creator_fee_share_rate — el valor predeterminado del nivel de comisión, utilizado de otra manera.

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

• El redondeo favorece al creador. La participación se redondea hacia abajo, por lo que el polvo se queda con el creador — la misma dirección que Fees::protocol_fee y Fees::fund_fee, que también tallan una participación de una comisión ya acumulada. El 20% de una comisión de 1 unidad es 0, no 1.
• El valor se conserva. creator_amount + shared_amount == creator_fee para cada tasa y cada comisión hasta u64::MAX.
• share_rate = 0 es exactamente el comportamiento antiguo. Tanto el valor de configuración predeterminado como un PDA faltante dan al creador la comisión completa, por lo que nada cambia para ningún pool existente hasta que un administrador establezca una tasa.

​

Cambios en la lista de cuentas

​

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

• El creador del pool no es parte de ninguna instrucción y no firma. La cuenta creator no se verifica — el PDA puede crearse para una clave que aún no posee ningún pool.
• Una cuenta cubre un par (creator, amm_config), por lo que rige cada pool que ese creador posee en ese nivel de comisión. Un creador con pools en dos niveles necesita dos cuentas para estar cubierto en ambos.
• No hay ruta de actualización. init falla en un segundo create para el mismo par; para cambiar una tasa, cierra y recrea.

​

Parámetro 8 de UpdateAmmConfig

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

​

Viajando junto

​

Lo que no cambió

• PoolState — 637 bytes, mismos campos, mismos desplazamientos. La parte del protocolo reutiliza el depósito de protocolo existente en lugar de agregar contadores propios.
• AmmConfig::LEN — aún 236 bytes.
• Matemática de swap, cotización, y la verificación de k. La comisión del creador se cobra exactamente como antes.
• CollectProtocolFee / CollectFundFee — mismas cuentas, mismos firmantes. CollectProtocolFee simplemente tiene más para recopilar.
• Códigos de error. 6000–6015 sin cambios; nada agregado.
• Cada otra instrucción, y el ID del programa.

​

Páginas actualizadas

• products/cpmm/fees — nueva sección “Participación del protocolo en la comisión del creador” que cubre resolución de tasa, aritmética de división, redondeo, y consecuencias del integrador; creator_fee_share_rate agregado a la lista de tasas/unidades y la tabla de parámetros predeterminados; tabla de flujo de recopilación reformulada.
• products/cpmm/instructions — advertencia de cambio de ruptura en la parte superior; tablas de cuentas completas para ambas rutas de comisión del creador; nuevas secciones CreateCreatorFeeShare y CloseCreatorFeeShare; parámetro 8 de UpdateAmmConfig; nota de ordenamiento de CollectExcessLamports; filas de resumen y matriz de cambio de estado.
• products/cpmm/accounts — nueva sección de cuenta CreatorFeeShare; diseño de AmmConfig y advertencia de tallado de relleno; notas de contador de comisión de PoolState; filas de ciclo de vida de cuenta.
• products/cpmm/overview — llamada de comisión del creador y viñeta “Comisiones predecibles”.
• products/cpmm/math — una nota de que la división está deliberadamente ausente de la matemática de swap.
• products/cpmm/code-demos — advertencia de que los constructores de SDK previos a la actualización emiten las listas de cuentas antiguas; fragmento de comisión acumulada anotado.
• reference/program-addresses — nueva sección “Autoridad de participación de comisión del creador de CPMM”; creator_fee_share agregado al bloque de semillas de PDA.
• reference/fee-comparison — creator_fee_share_rate llamado como una cuarta tasa de CPMM con una base diferente.