Comisiones CPMM

​

Dos comisiones independientes, cuatro destinos

1. Comisión de operación — 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 al quemar tokens LP.
   • Parte del protocolo — acumulada en PoolState.protocol_fees_token*; retirada por protocol_owner mediante CollectProtocolFee.
   • Parte del fondo — acumulada en PoolState.fund_fees_token*; retirada por fund_owner mediante CollectFundFee.
2. Comisión de creador (opcional, por grupo) — cobrada a AmmConfig.creator_fee_rate independientemente de la comisión de operación 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 grupo fue creado con enable_creator_fee = true.

​

Tasas y unidades

• trade_fee_rate es una fracción del volumen de operación. 2500 ⇒ 0,25% del lado relevante (entrada o salida, dependiendo de creator_fee_on — consulta “De qué lado de la operación se cobran las comisiones” a continuación).
• creator_fee_rate es una fracción del volumen de operación, cobrada separadamente de la comisión de operación. 1000 ⇒ 0,10% del lado relevante.
• protocol_fee_rate y fund_fee_rate son fracciones de la comisión de operación, no del volumen. 120_000 ⇒ 12% de la comisión de operación.

​

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 la
// invariante de que creator_fee es su propia tasa, nunca una parte 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 de creador cobrada en el lado de salida
    pub trade_fee:    u64,            // → dividida en depósitos de LP / protocolo / fondo a continuación
    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
    // respeta 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 de creador al lado de salida,
    // trade_fee se cobra en 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 entrada redondea hacia arriba para que el grupo 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 de creador se toma de entrada o salida dependiendo de PoolState.creator_fee_on (consulta la siguiente sección). La tasa es la misma de cualquier forma.

​

De qué lado de la operación 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 grupo honrará. Siempre resta 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 permanecen sin cambios.
• 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 de la acuñación de entrada en amount_in (a la autoridad de comisión de la acuñación).
2. La trade_fee del grupo en el resto (dividida como se indicó anteriormente).
3. La comisión de transferencia de la acuñación de salida en amount_out (a la autoridad de comisión de la acuñación).

​

Comisión de creador

• Habilitada en la creación del grupo. Initialize establece enable_creator_fee = false por defecto; los grupos 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 grupos vinculados a esa configuración. Cada grupo entonces decide si cobrarla (enable_creator_fee) y de qué lado de la operación cobrarla (creator_fee_on). Cuando enable_creator_fee = false, la tasa de comisión de creador efectiva del grupo es cero independientemente del valor de configuración (consulta PoolState::adjust_creator_fee_rate en el código fuente).
• Independiente de la comisión de operación. La comisión de 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 las ATA canónicas del creador.
• No se puede reactivar o redirigir después de la creación. Un grupo inicializado con enable_creator_fee = false nunca cobrará una comisión de creador; uno inicializado con un creator_fee_on particular no puede cambiar de lado.

​

Flujo operativo de recopilación

​

Cambiar un nivel de comisión

• Mover un grupo 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 grupo en ejecución

// Fuera de cadena: comisiones acumuladas actuales en cada depósito
const pool = await connection.getAccountInfo(poolStatePda);
const decoded = PoolState.decode(pool.data);
console.log(
  "Protocol accrued:",
  decoded.protocolFeesToken0.toString(),
  decoded.protocolFeesToken1.toString(),
);
console.log(
  "Fund accrued:",
  decoded.fundFeesToken0.toString(),
  decoded.fundFeesToken1.toString(),
);
console.log(
  "Creator accrued:",
  decoded.creatorFeesToken0.toString(),
  decoded.creatorFeesToken1.toString(),
);

// 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 operación* (mismo denominador).
const config = await fetch("https://api-v3.raydium.io/main/cpmm-config")
  .then((r) => r.json());
const tier = config.data.find((t) => t.index === decoded.ammConfigIndex);

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("LP fee effective:",       (tradeFeeOfVolume * lpOfTradeFee * 100).toFixed(4), "%");
console.log("Protocol fee effective:", (tradeFeeOfVolume * protocolOfTradeFee * 100).toFixed(4), "%");
console.log("Fund fee effective:",     (tradeFeeOfVolume * fundOfTradeFee * 100).toFixed(4), "%");
console.log(
  "Creator fee effective:",
  decoded.enableCreatorFee
    ? ((tier.creatorFeeRate / 1_000_000) * 100).toFixed(4) + " %"
    : "0 % (disabled on this pool)",
);

​

Comparación con CLMM y AMM v4

• AMM v4 utiliza una comisión de operación 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 grupo), y se reclaman mediante DecreaseLiquidity o CollectFees.

​

Dónde ir a continuación

• products/cpmm/math — donde la deducción de comisión de operación se conecta a la curva.
• products/cpmm/instructions — las listas de cuentas de instrucción Collect*.
• algorithms/token-2022-transfer-fees — cómo combinar correctamente una comisión de operación de grupo con una comisión de transferencia de acuñación.

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