Comisiones CPMM

​

Dos comisiones independientes, cuatro destinos

1. Comisión de intercambio — cobrada a AmmConfig.trade_fee_rate y dividida entre tres destinos:
   • Parte de LP — permanece en la bóveda y aumenta k. Se reclama implícitamente quemando tokens LP.
   • Parte del protocolo — acumulada en PoolState.protocol_fees_token*; retirada por el protocol_owner mediante CollectProtocolFee.
   • Parte del fondo — acumulada en PoolState.fund_fees_token*; retirada por el fund_owner mediante CollectFundFee.
2. Comisión del creador (opcional, por pool) — cobrada a AmmConfig.creator_fee_rate independientemente de la comisión de intercambio y acumulada en PoolState.creator_fees_token*. El creador puede retirarla mediante CollectCreatorFee, o cualquier pagador puede activar la ruta restringida por destino CollectCreatorFeePermissionless. Activa solo cuando el pool se creó con enable_creator_fee = true. Desde la actualización del 2026-09-19, la comisión del creador acumulada se divide una vez más en el momento de la recopilación: una parte configurable se mueve al depósito del protocolo del pool y solo el resto llega al creador — ver Parte del protocolo de la comisión del creador.

​

Tasas y unidades

• trade_fee_rate es una fracción del volumen de intercambio. 2500 ⇒ 0.25% del lado relevante (entrada o salida, dependiendo de creator_fee_on — ver “De qué lado del intercambio se cobran las comisiones” abajo).
• creator_fee_rate es una fracción del volumen de intercambio, cobrada separadamente de la comisión de intercambio. 1000 ⇒ 0.10% del lado relevante.
• protocol_fee_rate y fund_fee_rate son fracciones de la comisión de intercambio, no del volumen. 120_000 ⇒ 12% de la comisión de intercambio.
• creator_fee_share_rate es una fracción de la comisión del creador acumulada, no del volumen ni de la comisión de intercambio. 200_000 ⇒ 20% de lo que esté en creator_fees_token* en el momento en que se recopila. 0 (el predeterminado) deja toda la comisión del creador con el creador.

​

La división, en código

// Parafraseado de raydium-cp-swap/programs/cp-swap/src/curve/{calculator,fees}.rs.
// El código real se ramifica en `is_creator_fee_on_input`; ambas ramas preservan el
// invariante de que creator_fee es su propia tasa, nunca una porción de trade_fee.

const FEE_RATE_DENOMINATOR_VALUE: u64 = 1_000_000;

pub struct FeeBreakdown {
    pub amount_in_after_fees: u64,    // entrada menos todas las comisiones cobradas en el lado de entrada
    pub amount_out_after_fees: u64,   // salida menos cualquier comisión del creador cobrada en el lado de salida
    pub trade_fee:    u64,            // → dividida en depósitos de LP / protocolo / fondo abajo
    pub protocol_fee: u64,            // parte de trade_fee
    pub fund_fee:     u64,            // parte de trade_fee
    pub creator_fee:  u64,            // depósito independiente (lado de entrada o salida)
}

fn take_fees_on_input(
    amount_in: u64,
    trade_rate: u64,
    creator_rate: u64,
    protocol_rate: u64,
    fund_rate: u64,
) -> (u64 /* trade_fee */, u64 /* creator_fee */, u64 /* amount_in_after_fees */) {
    // Las dos tasas se suman para que redondeemos una vez en la comisión combinada, luego dividimos
    // proporcionalmente — esto es puramente un truco de redondeo/eficiencia. La división
    // honra las tasas exactamente: creator_fee/trade_fee == creator_rate/trade_rate.
    let total_fee = ((amount_in as u128) * ((trade_rate + creator_rate) as u128))
        .div_ceil(FEE_RATE_DENOMINATOR_VALUE as u128) as u64;

    let creator_fee = ((total_fee as u128) * (creator_rate as u128)
                       / ((trade_rate + creator_rate) as u128)) as u64;
    let trade_fee   = total_fee - creator_fee;

    (trade_fee, creator_fee, amount_in - total_fee)
}

fn take_creator_fee_on_output(amount_out_swapped: u64, creator_rate: u64) -> (u64, u64) {
    // Cuando creator_fee_on enruta la comisión del creador al lado de salida,
    // trade_fee se toma en la entrada como una tasa única, y creator_fee
    // se calcula contra la salida de la curva.
    let creator_fee = ((amount_out_swapped as u128) * (creator_rate as u128))
        .div_ceil(FEE_RATE_DENOMINATOR_VALUE as u128) as u64;
    (amount_out_swapped - creator_fee, creator_fee)
}

fn split_trade_fee(
    trade_fee: u64,
    protocol_rate: u64,
    fund_rate: u64,
) -> (u64 /* protocol_fee */, u64 /* fund_fee */) {
    let protocol_fee = (trade_fee as u128 * protocol_rate as u128
                        / FEE_RATE_DENOMINATOR_VALUE as u128) as u64;
    let fund_fee     = (trade_fee as u128 * fund_rate as u128
                        / FEE_RATE_DENOMINATOR_VALUE as u128) as u64;
    (protocol_fee, fund_fee)
}

• La comisión total en la entrada redondea hacia arriba para que el pool nunca subcobre.
• Las subdivisiones de trade_fee (protocolo, fondo) redondean hacia abajo para que su suma nunca exceda trade_fee; el resto es la parte de LP.
• lp_share = trade_fee − protocol_fee − fund_fee (creator_fee no se resta aquí porque es su propio depósito).
• La comisión del creador se toma de la entrada o salida dependiendo de PoolState.creator_fee_on (ver siguiente sección). La tasa es la misma de cualquier manera.

​

De qué lado del intercambio se cobran las comisiones

​

Cómo las comisiones “acumuladas” interactúan con la curva

raw_vault_0_balance = getTokenAccountBalance(vault_0).amount
                    = lp_entitled + protocol_fees_token0
                      + fund_fees_token0 + creator_fees_token0

curve_x = raw_vault_0_balance − (protocol_fees_token0
                                  + fund_fees_token0
                                  + creator_fees_token0)

• Cotizar fuera de saldos brutos es incorrecto. Si construyes un cotizador fuera de getTokenAccountBalance, consistentemente sobrestimarás el precio que el pool honrará. Siempre resta las comisiones acumuladas, o simula mediante SwapBaseInput / la API.
• CollectProtocolFee no mueve el precio. Mueve tokens fuera de la bóveda y pone a cero los contadores protocol_fees_token*, por lo que curve_x y curve_y no cambian.
• Las comisiones de LP no se acumulan en un contador. Son implícitas en el saldo de la bóveda. El derecho del LP a las comisiones de LP acumuladas se ejerce quemando tokens LP (es decir, mediante Withdraw) — no hay CollectLpFee.

​

Interacción con comisiones de transferencia de Token-2022

1. La comisión de transferencia del mint de entrada en amount_in (a la autoridad de comisión del mint).
2. La trade_fee del pool en el resto (dividida como se indicó anteriormente).
3. La comisión de transferencia del mint de salida en amount_out (a la autoridad de comisión del mint).

​

Comisión del creador

• Habilitada en la creación del pool. Initialize establece enable_creator_fee = false por defecto; los pools creados mediante InitializeWithPermission (utilizado por graduaciones de LaunchLab y otras rutas controladas) pueden pasar enable_creator_fee = true y elegir creator_fee_on.
• La tasa se comparte con el nivel de comisión. La tasa en sí es AmmConfig.creator_fee_rate, el mismo valor en todos los pools vinculados a esa configuración. Cada pool luego decide si cobrarla (enable_creator_fee) y de qué lado del intercambio cobrarla (creator_fee_on). Cuando enable_creator_fee = false, la tasa de comisión del creador efectiva del pool es cero independientemente del valor de configuración (ver PoolState::adjust_creator_fee_rate en el código fuente).
• Independiente de la comisión de intercambio. La comisión del creador nunca reduce las partes de LP / protocolo / fondo — es su propia tasa, aplicada separadamente, acumulada en sus propios contadores.
• Retirada mediante CollectCreatorFee o CollectCreatorFeePermissionless. La ruta original requiere que PoolState.pool_creator firme. La ruta sin permisos permite que cualquier pagador active la recopilación pero fija ambos destinos a los ATAs canónicos del creador. Ambas rutas liquidan la parte del protocolo primero — ver la siguiente sección.
• No se puede volver a habilitar o redirigir después de la creación. Un pool inicializado con enable_creator_fee = false nunca cobrará una comisión del creador; uno inicializado con un creator_fee_on particular no puede cambiar de lado.

​

Parte del protocolo de la comisión del creador

​

De dónde viene la tasa

1. PDA CreatorFeeShare — semillas ["creator_fee_share", creator, amm_config]. Cuando esta cuenta existe y es propiedad de CPMM, su share_rate gana. Permite que el protocolo negocie una tasa por creador en un nivel de comisión dado sin tocar el nivel en sí.
2. AmmConfig.creator_fee_share_rate — el predeterminado para cada creador en ese nivel de comisión. Se usa siempre que el PDA no exista.

​

Qué hace la división

// programs/cp-swap/src/states/creator_fee_share.rs
shared_amount  = floor(creator_fee * share_rate / 1_000_000);   // al protocolo
creator_amount = creator_fee - shared_amount;                   // al creador

• creator_amount_{0,1} se transfiere fuera de las bóvedas a las cuentas de token del creador.
• shared_amount_{0,1} se agrega a protocol_fees_token_{0,1} y permanece en la bóveda hasta que el propietario del protocolo la barre con CollectProtocolFee. No hay instrucción separada ni contador separado para esto.
• creator_fees_token_{0,1} se ponen a cero, exactamente como antes.

• El redondeo favorece al creador. La parte del protocolo se redondea hacia abajo, por lo que el polvo permanece con el creador — la misma dirección que protocol_fee y fund_fee, que también extraen una parte de una comisión ya acumulada.
• El valor se conserva. creator_amount + shared_amount == creator_fee para cada tasa y cada comisión, incluyendo u64::MAX.
• share_rate = 0 es una no-operación. Tanto el valor de configuración predeterminado como la ausencia de un PDA CreatorFeeShare dejan toda la comisión del creador con el creador, que es el comportamiento anterior a la actualización.

​

Qué significa para los integradores

• Los LPs y la cotización no se ven afectados. La cantidad compartida se mueve entre dos contadores que ambos ya están excluidos de la vista de la curva de la bóveda (vault_amount_without_fee), por lo que curve_x y curve_y no se mueven en una recopilación. k no se toca.
• Un estimador de comisión del creador que lee creator_fees_token* ahora sobrestima el pago. Multiplica por (1 − share_rate / 1_000_000) usando la tasa que realmente se aplica a ese par (creator, amm_config), no el predeterminado de configuración.
• protocol_fees_token* crece fuera de los intercambios. Un monitor que reconcilia la acumulación del protocolo contra el volumen de intercambio verá saltos en cada recopilación de comisión del creador. La acumulación del protocolo ya no es solo trade_fee × protocol_fee_rate.
• La tasa puede cambiar entre acumulación y recopilación. Se lee en el momento de la recopilación, por lo que las comisiones que se acumularon bajo una tasa se liquidan a cualquier tasa que esté en vigor cuando alguien llama a Collect*.

​

Flujo operativo de recopilación

​

Cambiar un nivel de comisión

• Mover un pool de un AmmConfig a otro.
• Repreciar retroactivamente las comisiones ya acumuladas.
• Recopilar comisiones sin el firmante protocol_owner / fund_owner.

​

Lectura de comisiones de un pool en ejecución

// Fuera de cadena: comisiones acumuladas actuales en cada depósito.
// El SDK exporta el diseño, no una clase `PoolState`, y los campos de comisión se
// nombran ...MintA / ...MintB — no hay campos ...Token0 / ...Token1.
import { CpmmPoolInfoLayout } from "@raydium-io/raydium-sdk-v2";

const pool = await connection.getAccountInfo(poolStatePda);
const decoded = CpmmPoolInfoLayout.decode(pool!.data);   // sin .slice(8) — el
                                                          // diseño incluye el discriminador
console.log(
  "Protocolo acumulado:",
  decoded.protocolFeesMintA.toString(),
  decoded.protocolFeesMintB.toString(),
);
console.log(
  "Fondo acumulado:",
  decoded.fundFeesMintA.toString(),
  decoded.fundFeesMintB.toString(),
);
console.log(
  "Creador acumulado:",
  decoded.creatorFeesMintA.toString(),
  decoded.creatorFeesMintB.toString(),
);
// Lo que el creador realmente recibe es esto menos la parte del protocolo, resuelto en
// el momento de la recopilación desde el PDA `CreatorFeeShare` de `(creator, ammConfig)` si existe y
// desde `AmmConfig.creator_fee_share_rate` de lo contrario. Ver "Parte del protocolo de la comisión del creador"
// arriba.

// Fuera de cadena: tasas efectivas hoy.
// trade_fee_rate, creator_fee_rate son fracciones del volumen (denominador 1e6).
// protocol_fee_rate, fund_fee_rate son fracciones de la *comisión de intercambio* (mismo denominador).
const config = await fetch("https://api-v3.raydium.io/main/cpmm-config")
  .then((r) => r.json());
// `configId` en el pool decodificado es la PublicKey de la cuenta de configuración, no un índice.
const tier = config.data.find((t) => t.id === decoded.configId.toBase58());

const tradeFeeOfVolume   = tier.tradeFeeRate / 1_000_000;
const protocolOfTradeFee = tier.protocolFeeRate / 1_000_000;
const fundOfTradeFee     = tier.fundFeeRate / 1_000_000;
const lpOfTradeFee       = 1 - protocolOfTradeFee - fundOfTradeFee;

console.log("Comisión de LP efectiva:",       (tradeFeeOfVolume * lpOfTradeFee * 100).toFixed(4), "%");
console.log("Comisión de protocolo efectiva:", (tradeFeeOfVolume * protocolOfTradeFee * 100).toFixed(4), "%");
console.log("Comisión de fondo efectiva:",     (tradeFeeOfVolume * fundOfTradeFee * 100).toFixed(4), "%");
console.log(
  "Comisión de creador efectiva:",
  decoded.enableCreatorFee
    ? ((tier.creatorFeeRate / 1_000_000) * 100).toFixed(4) + " %"
    : "0 % (deshabilitada en este pool)",
);

​

Comparación con CLMM y AMM v4

• AMM v4 usa una comisión de intercambio fija del 0.25% con una división LP/protocolo diferente y sin comisión de fondo.
• CLMM las comisiones son por nivel de espaciado de tick, acumuladas por posición (no por pool), y se reclaman mediante DecreaseLiquidity o CollectFees.

​

A dónde ir a continuación

• products/cpmm/math — donde la deducción de comisión de intercambio se conecta a la curva.
• products/cpmm/instructions — las listas de cuentas de instrucción Collect*, incluyendo la cuenta creator_fee_share que ambas rutas del creador ahora requieren.
• algorithms/token-2022-transfer-fees — cómo combinar correctamente una comisión de intercambio de pool con una comisión de transferencia de mint.

• raydium-io/raydium-cp-swap — states/config.rs, states/pool.rs, states/curve.rs
• API de Raydium — GET /main/cpmm-config