Cómo configurar las comisiones de CPMM

Esta guía explica cómo funcionan las configuraciones de comisiones de CPMM y cómo obtener las configuraciones existentes desde on-chain.

A cada pool CPMM se le asigna una configuración de comisiones al crearse. Las configuraciones de comisiones se almacenan on-chain como AmmConfig cuentas — cada una define un nivel de comisión que cualquier pool puede usar.

Configuraciones de comisiones

Cada pool hace referencia a una sola AmmConfig que determina cómo se cobran y distribuyen las comisiones en cada swap. Para ver todas las configuraciones disponibles, usa el script de abajo para consultar las cuentas on-chain. También puedes ver los IDs de configuración públicos en este endpoint (https://api-v3.raydium.io/main/cpmm-config) – ten en cuenta que este endpoint excluye ciertos IDs de configuración personalizados.

Para solicitar una configuración de comisiones personalizada, contacta al equipo de Raydium.

Ejemplo de salida

--- Índice de configuración: 0 ---
  Dirección:           D4FPEruKEHrG5TenZ2mpDGEfu1iUvTiqBxvpU8HLBvC2
  Tasa de comisión de trading:    2500 (0.25%)
  Tasa de comisión del protocolo: 120000 (12% de la comisión de trading)
  Tasa de comisión del fondo:     40000 (4% de la comisión de trading)
  Tasa de comisión del creador:  500 (0.05%)
  Comisión de creación de pool:   150000000 lamports (0.15 SOL)

Cómo se distribuyen las comisiones

Tomando Config 0 como ejemplo, así es cómo fluyen las comisiones en un 1,000,000 token swap.

1. Las comisiones se deducen de la entrada

La trade_fee_rate y creator_fee_rate se aplican cada una al importe de entrada del swap:

trade_fee   = 1,000,000 × 0.25%  = 2,500 tokens
creator_fee = 1,000,000 × 0.05%  =   500 tokens
                                    ─────
total deducido                    = 3,000 tokens

Los 997,000 tokens restantes entran al swap de producto constante para determinar la salida.

2. La comisión de trading se divide entre el protocolo, el tesoro y los LPs

protocol_fee_rate y fund_fee_rate son porcentajes de la comisión de trading, no del importe del swap:

protocol_fee = 2,500 × 12% = 300 tokens
fund_fee     = 2,500 ×  4% = 100 tokens
lp_fee       = 2,500 - 300 - 100 = 2,100 tokens

La comisión LP permanece en las bóvedas del pool, aumentando el valor de las posiciones LP.

3. Resumen

Destinatario	Importe	Cálculo
LPs	2,100 tokens	trade_fee - protocol - fund
Protocolo de Raydium	300 tokens	12% de la comisión de trading
Tesorería de Raydium	100 tokens	4% de la comisión de trading
Creador del pool	500 tokens	0.05% de la entrada del swap
Comisiones totales	3,000 tokens	0.30% de la entrada del swap

Las comisiones del protocolo y del tesoro se acumulan en las bóvedas del pool y se cobran por separado por las direcciones protocol_owner y fund_owner .

Campos de AmmConfig

Campo	Descripción
trade_fee_rate	Comisión tomada de la entrada del swap, en unidades de 1e-6. 2500 = 0.25%.
protocol_fee_rate	Parte de la comisión de trading enviada al protocolo de Raydium, en unidades de 1e-6. 120000 = 12%.
fund_fee_rate	Parte de la comisión de trading enviada a la tesorería de Raydium, en unidades de 1e-6. 40000 = 4%.
creator_fee_rate	Comisión adicional tomada de la entrada del swap, enviada al creador del pool. 500 = 0.05%.
create_pool_fee	Comisión única en lamports para crear un pool con esta configuración. 150000000 = 0.15 SOL.
disable_create_pool	Cuando true, la creación de nuevos pools está deshabilitada para esta configuración. Los pools existentes no se ven afectados.
protocol_owner	Dirección que cobra las comisiones acumuladas del protocolo.
fund_owner	Dirección que cobra las comisiones acumuladas del tesoro.

Todos los campos de tasa usan un denominador de 1,000,000. Por ejemplo, un valor de 2500 significa 2500/1000000 = 0.25%.

Obtener todas las configuraciones

El siguiente script consulta todas las cuentas AmmConfig de mainnet:

import { Connection, PublicKey } from "@solana/web3.js";
import { createHash } from "crypto";

const RPC_URL = "<YOUR_RPC_URL>";
const PROGRAM_ID = new PublicKey("CPMMoo8L3F4NbTegBCKVNunggL7H1ZpdTHKxQB5qKP1C");

// Discriminador de Anchor: primeros 8 bytes de sha256("account:AmmConfig")
const discriminator = createHash("sha256")
  .update("account:AmmConfig")
  .digest()
  .subarray(0, 8);

interface AmmConfig {
  bump: number;
  disableCreatePool: boolean;
  index: number;
  tradeFeeRate: bigint;
  protocolFeeRate: bigint;
  fundFeeRate: bigint;
  createPoolFee: bigint;
  protocolOwner: PublicKey;
  fundOwner: PublicKey;
  creatorFeeRate: bigint;
}

function parseAmmConfig(data: Buffer): AmmConfig {
  let offset = 8; // omitir discriminador de Anchor

  const bump = data.readUInt8(offset);             offset += 1;
  const disableCreatePool = data.readUInt8(offset) !== 0; offset += 1;
  const index = data.readUInt16LE(offset);         offset += 2;
  const tradeFeeRate = data.readBigUInt64LE(offset);    offset += 8;
  const protocolFeeRate = data.readBigUInt64LE(offset); offset += 8;
  const fundFeeRate = data.readBigUInt64LE(offset);     offset += 8;
  const createPoolFee = data.readBigUInt64LE(offset);   offset += 8;
  const protocolOwner = new PublicKey(data.subarray(offset, offset + 32)); offset += 32;
  const fundOwner = new PublicKey(data.subarray(offset, offset + 32));     offset += 32;
  const creatorFeeRate = data.readBigUInt64LE(offset);

  return {
    bump, disableCreatePool, index, tradeFeeRate,
    protocolFeeRate, fundFeeRate, createPoolFee,
    protocolOwner, fundOwner, creatorFeeRate,
  };
}

async function main() {
  const connection = new Connection(RPC_URL, "confirmed");
  console.log("Obteniendo todas las cuentas AmmConfig...\n");

  const accounts = await connection.getProgramAccounts(PROGRAM_ID, {
    filters: [{
      memcmp: {
        offset: 0,
        bytes: discriminator.toString("base64"),
        encoding: "base64",
      },
    }],
  });

  console.log(`Se encontraron ${accounts.length} cuenta(s) AmmConfig\n`);

  for (const { pubkey, account } of accounts) {
    const config = parseAmmConfig(account.data as Buffer);
    console.log(`--- Índice de configuración: ${config.index} ---`);
    console.log(`  Dirección:           ${pubkey.toBase58()}`);
    console.log(`  Tasa de comisión de trading:    ${config.tradeFeeRate} (${Number(config.tradeFeeRate) / 10000}%)`);
    console.log(`  Tasa de comisión del protocolo: ${config.protocolFeeRate} (${Number(config.protocolFeeRate) / 10000}% de la comisión de trading)`);
    console.log(`  Tasa de comisión del fondo:     ${config.fundFeeRate} (${Number(config.fundFeeRate) / 10000}% de la comisión de trading)`);
    console.log(`  Tasa de comisión del creador:  ${config.creatorFeeRate} (${Number(config.creatorFeeRate) / 10000}%)`);
    console.log(`  Comisión de creación de pool:   ${config.createPoolFee} lamports (${Number(config.createPoolFee) / 1e9} SOL)`);
    console.log(`  Deshabilitar pool:      ${config.disableCreatePool}`);
    console.log(`  Propietario del protocolo:    ${config.protocolOwner.toBase58()}`);
    console.log(`  Propietario del fondo:        ${config.fundOwner.toBase58()}`);
    console.log();
  }
}

main().catch(console.error);