Cuentas CPMM

Esta página fue traducida automáticamente por IA. La versión en inglés es la fuente autorizada.Ver versión en inglés →

El ID del programa y las semillas de PDA para CPMM se enumeran canónicamente en reference/program-addresses. Esta página se enfoca en para qué sirve cada cuenta y los invariantes que mantiene, no en las direcciones codificadas.

Las seis cuentas de un pool CPMM

Cada pool CPMM se describe completamente mediante seis direcciones derivadas del programa (PDAs) bajo el programa CPMM, más una cuenta AmmConfig compartida a la que hace referencia. Una vez que tienes los dos mints, puedes derivar todo de forma determinista sin tocar la red.

Cuenta	Semilla(s)	Propietario	Propósito
`authority`	`"vault_and_lp_mint_auth_seed"`	CPMM	El firmante para cada movimiento de bóveda y cada mint/quema de LP. Compartido entre todos los pools CPMM.
`poolState`	`"pool"`, `ammConfig`, `token0Mint`, `token1Mint` o cualquier keypair aleatorio proporcionado por el firmante	CPMM	La estructura de estado del pool — par de mints, saldos de bóveda, suministro de LP, acumulación de comisiones, puntero de observación. La instrucción `Initialize` de CPMM acepta tanto el PDA canónico derivado de las cuatro semillas como un keypair arbitrario firmado por el creador. La ruta de keypair aleatorio existe para derrotar un ataque de front-running donde un adversario observa el mempool y corre para ocupar el PDA canónico antes que el creador legítimo.
`lpMint`	`"pool_lp_mint"`, `poolState`	SPL Token	El token LP del pool. Suministro = total de LP pendiente. Autoridad de mint = el PDA de autoridad de CPMM.
`vault0`	`"pool_vault"`, `poolState`, `token0Mint`	SPL Token / Token-2022	Contiene el saldo del pool de token0. Propiedad del PDA de autoridad.
`vault1`	`"pool_vault"`, `poolState`, `token1Mint`	SPL Token / Token-2022	Contiene el saldo del pool de token1. Propiedad del PDA de autoridad.
`observation`	`"observation"`, `poolState`	CPMM	Búfer de anillo de muestras de precios utilizadas para el TWAP. Se escribe en cada swap.

Y la configuración compartida:

Cuenta	Semilla(s)	Propietario	Propósito
`ammConfig`	`"amm_config"`, `index: u16`	CPMM	Contiene las tasas de comisión de comercio/protocolo/fondo/creador, la tasa de participación de comisión de creador predeterminada y claves de administrador. Una por “nivel de comisión”. Poolstate se vincula a una en la creación y no puede cambiar después.

Y una cuenta opcional por creador:

Cuenta	Semilla(s)	Propietario	Propósito
`creatorFeeShare`	`"creator_fee_share"`, `creator`, `ammConfig`	CPMM	Anula `AmmConfig.creator_fee_share_rate` para un creador de pool en un nivel de comisión. Opcional — cuando no existe, se aplica el valor predeterminado de la configuración. Agregado por la actualización de participación de comisión de creador del 2026-09-19.

Derivar un pool de nada más que dos mints

import { PublicKey } from "@solana/web3.js";
import BN from "bn.js";

const CPMM_PROGRAM_ID = new PublicKey(
  "CPMMoo8L3F4NbTegBCKVNunggL7H1ZpdTHKxQB5qKP1C"
); // mainnet — see reference/program-addresses

function u16ToBytes(n: number): Buffer {
  const b = Buffer.alloc(2);
  b.writeUInt16BE(n);
  return b;
}

// token0 < token1 by byte order. Getting this wrong yields a valid PDA
// that points at a nonexistent pool.
function sortMints(a: PublicKey, b: PublicKey): [PublicKey, PublicKey] {
  return Buffer.compare(a.toBuffer(), b.toBuffer()) < 0 ? [a, b] : [b, a];
}

export function deriveCpmmAccounts(
  mintA: PublicKey,
  mintB: PublicKey,
  ammConfigIndex = 0,
) {
  const [token0Mint, token1Mint] = sortMints(mintA, mintB);

  const [ammConfig] = PublicKey.findProgramAddressSync(
    [Buffer.from("amm_config"), u16ToBytes(ammConfigIndex)],
    CPMM_PROGRAM_ID,
  );
  const [authority] = PublicKey.findProgramAddressSync(
    [Buffer.from("vault_and_lp_mint_auth_seed")],
    CPMM_PROGRAM_ID,
  );
  const [poolState] = PublicKey.findProgramAddressSync(
    [
      Buffer.from("pool"),
      ammConfig.toBuffer(),
      token0Mint.toBuffer(),
      token1Mint.toBuffer(),
    ],
    CPMM_PROGRAM_ID,
  );
  const [lpMint] = PublicKey.findProgramAddressSync(
    [Buffer.from("pool_lp_mint"), poolState.toBuffer()],
    CPMM_PROGRAM_ID,
  );
  const [vault0] = PublicKey.findProgramAddressSync(
    [Buffer.from("pool_vault"), poolState.toBuffer(), token0Mint.toBuffer()],
    CPMM_PROGRAM_ID,
  );
  const [vault1] = PublicKey.findProgramAddressSync(
    [Buffer.from("pool_vault"), poolState.toBuffer(), token1Mint.toBuffer()],
    CPMM_PROGRAM_ID,
  );
  const [observation] = PublicKey.findProgramAddressSync(
    [Buffer.from("observation"), poolState.toBuffer()],
    CPMM_PROGRAM_ID,
  );

  return {
    ammConfig,
    authority,
    poolState,
    lpMint,
    token0Mint,
    token1Mint,
    vault0,
    vault1,
    observation,
  };
}

Siempre ordena los mints antes de derivar el PDA del pool. La semilla hace hash de los dos mints en orden de bytes, no en orden de usuario. Dos pools con (A, B) y (B, A) colisionarían en la cadena — la ordenación es cómo el programa hace que el mapeo sea canónico.

El ID del pool no siempre es el PDA canónico. Initialize acepta un keypair firmante arbitrario como pool_state además del PDA anterior. Si la cuenta pasada no coincide con el PDA canónico, el programa requiere que sea un firmante — es decir, el creador pasa un keypair nuevo que firma. Esta es la defensa contra front-running: cualquier tercero que corra para agarrar el PDA canónico puede ser evitado por el creador legítimo usando un keypair aleatorio en su lugar. Los PDAs posteriores (lpMint, vault0, vault1, observation) aún se derivan de poolState.key(), por lo que permanecen únicos a cualquier dirección que se haya usado. Cuando indexas pools, siempre descubre el ID del pool desde el estado en la cadena (por ejemplo, cuentas PoolState bajo el programa CPMM), no derivando el PDA canónico — este último perderá pools con keypair aleatorio.

Diseños de cuenta

Las definiciones completas de Rust viven en la fuente raydium-cp-swap. Los campos a continuación son los que leerás de una integración.

`PoolState`

// programs/cp-swap/src/states/pool.rs
pub struct PoolState {
    pub amm_config: Pubkey,               // binds this pool to an AmmConfig
    pub pool_creator: Pubkey,             // who ran initialize
    pub token_0_vault: Pubkey,            // == vault0 PDA
    pub token_1_vault: Pubkey,            // == vault1 PDA

    pub lp_mint: Pubkey,
    pub token_0_mint: Pubkey,
    pub token_1_mint: Pubkey,

    pub token_0_program: Pubkey,          // SPL Token or Token-2022 program
    pub token_1_program: Pubkey,

    pub observation_key: Pubkey,          // == observation PDA
    pub auth_bump: u8,
    pub status: u8,                       // bitmask: deposit | withdraw | swap
    pub lp_mint_decimals: u8,
    pub mint_0_decimals: u8,
    pub mint_1_decimals: u8,

    pub lp_supply: u64,                   // mirrors lp_mint supply
    pub protocol_fees_token_0: u64,
    pub protocol_fees_token_1: u64,
    pub fund_fees_token_0: u64,
    pub fund_fees_token_1: u64,

    pub open_time: u64,                   // unix; swaps rejected before this
    pub recent_epoch: u64,

    // Creator-fee state (added after the original layout):
    pub creator_fee_on: u8,               // 0=BothToken, 1=OnlyToken0, 2=OnlyToken1
    pub enable_creator_fee: bool,
    pub padding1: [u8; 6],
    pub creator_fees_token_0: u64,
    pub creator_fees_token_1: u64,

    pub padding: [u64; 28],
}

Qué leer realmente:

lp_supply — el total de LP interno del pool. No es igual al suministro del mint de LP: es exactamente 100 unidades base más alto, porque las 100 unidades bloqueadas se cuentan aquí pero nunca se acuñan. Toda la matemática de participación de LP (depósito, retiro) divide por lp_supply, así que usa este campo y no sustituyas el suministro en la cadena del mint.
protocol_fees_token{0,1}, fund_fees_token{0,1} — comisiones acumuladas aún no barridas. Estas no afectan el precio del swap; se sientan en las bóvedas hasta que se llama CollectProtocolFee / CollectFundFee. protocol_fees_token{0,1} también recibe la participación del protocolo de la comisión del creador cuando se recopila una comisión del creador, por lo que crece fuera de los swaps — ver products/cpmm/fees.
status — una máscara de bits que controla si Swap, Deposit, Withdraw están permitidos. Actualizado por el administrador a través de UpdatePoolStatus. El SDK verifica esto antes de construir una transacción; si estás haciendo CPI directamente, verifica tú mismo.
token0_program / token1_program — el programa de token en el que hacer CPI para cada bóveda. Uno puede ser SPL Token clásico y el otro Token-2022; son independientes.
open_time — una marca de tiempo Unix. Los swaps antes de esta hora fallan. Los depósitos se permiten antes de open_time para que el pool pueda ser sembrado.
creator_fee_on / enable_creator_fee — juntos controlan si la comisión de creador opcional está activa para este pool y de qué lado del swap se recopila. enable_creator_fee == false anula completamente la ruta de comisión del creador. Cuando está habilitado, creator_fee_on selecciona: 0 = tomar comisión de cualquier token que sea la entrada del swap (BothToken); 1 = tomar comisión de token_0 solo (omitir en swaps token_1 → token_0); 2 = tomar comisión de token_1 solo. Se establece en la creación del pool a través de InitializeWithPermission; no puede cambiar después.
creator_fees_token_{0,1} — comisiones de creador acumuladas, barridas por CollectCreatorFee o CollectCreatorFeePermissionless. Ambas rutas cero los contadores completos, pero desde la actualización de participación de comisión de creador del 2026-09-19 solo parte del saldo sale del pool: la participación del protocolo se agrega a protocol_fees_token_{0,1} y el resto se transfiere al creador. La ruta sin permiso fija los destinatarios a los ATAs canónicos de pool_creator. PoolState en sí no cambió — no hay un contador separado para la cantidad compartida.

`AmmConfig`

pub struct AmmConfig {
    pub bump: u8,
    pub disable_create_pool: bool,
    pub index: u16,                       // matches the seed
    pub trade_fee_rate: u64,              // e.g., 2500 = 0.25%
    pub protocol_fee_rate: u64,           // fraction of trade fee to protocol
    pub fund_fee_rate: u64,               // fraction of trade fee to fund
    pub create_pool_fee: u64,             // paid once at init (in SOL or token)
    pub protocol_owner: Pubkey,           // can call CollectProtocolFee
    pub fund_owner: Pubkey,               // can call CollectFundFee
    pub creator_fee_rate: u64,            // optional pool-creator fee rate (1/1_000_000 of volume)
    pub creator_fee_share_rate: u64,      // protocol's default share OF the creator fee
    pub padding: [u64; 14],
}
// AmmConfig::LEN == 236 bytes — unchanged.

Tres cosas a tener cuidado:

trade_fee_rate y creator_fee_rate son fracciones del volumen, ambas denominadas en unidades de 1/1_000_000. 2500 significa 0.25% del volumen de comercio. protocol_fee_rate y fund_fee_rate son fracciones de la comisión de comercio (no del volumen), en el mismo denominador 1/1_000_000. La comisión del creador no es una fracción de la comisión de comercio — es su propia tasa independiente. La aritmética completa está en products/cpmm/fees.
index es un u16, así que el hash de semilla usa 2 bytes big-endian. Un error de uno en el orden de bytes es un error de integración común.
AmmConfig es inmutable a nivel de pool. Un pool apunta a un AmmConfig en la creación y nunca cambia. Los cambios de comisión se propagan porque el pool lee la configuración en cada swap — pero el pool no puede moverse entre niveles de comisión.

Una nota sobre comisiones de creador: la tasa en sí (creator_fee_rate) vive en AmmConfig y se comparte entre el nivel de comisión. Si un pool en particular realmente la cobra (enable_creator_fee) y de qué lado del swap cae (creator_fee_on) viven en PoolState. La comisión del creador es independiente de la comisión de comercio — es su propia tasa, acumulada a sus propios contadores (creator_fees_token_{0,1}), y nunca reduce las participaciones de LP / protocolo / fondo de la comisión de comercio. El barrido es a través de CollectCreatorFee o el CollectCreatorFeePermissionless restringido por destino, y ambas rutas entregan una participación del saldo acumulado al protocolo en el camino — a creator_fee_share_rate, o a la tasa en un PDA CreatorFeeShare cuando existe uno para ese par (creator, amm_config). Ver products/cpmm/fees para la mecánica completa.

`Permission`

Una pequeña cuenta de control de acceso utilizada por InitializeWithPermission. El programa CPMM admite una ruta de creación de pool con permiso para que otros programas (por ejemplo, LaunchLab cuando gradúa un token a CPMM) puedan probar que tienen derecho a crear un pool contra un AmmConfig dado.

pub struct Permission {
    pub authority: Pubkey,    // who is allowed to call InitializeWithPermission
    pub padding: [u64; 30],
}
// Permission::LEN == 8 + 32 + 8 * 30 == 280 bytes

El PDA de Permission se crea a través de CreatePermissionPda por el administrador de CPMM o una autoridad de creador de PDA de permiso dedicada. Desde la actualización de 2026-09, ClosePermissionPda acepta los mismos dos firmantes; antes era solo administrador. Los usuarios finales no interactúan directamente con esta cuenta — es plomería para flujos entre programas. Ver security/admin-and-multisig para el límite de rol y reference/program-addresses para direcciones canónicas.

`CreatorFeeShare`

Una cuenta opcional que anula la participación del protocolo en la comisión del creador para un par (creador de pool, AmmConfig). Agregado por la actualización de participación de comisión de creador del 2026-09-19.

// programs/cp-swap/src/states/creator_fee_share.rs
pub const CREATOR_FEE_SHARE_SEED: &str = "creator_fee_share";

pub struct CreatorFeeShare {
    pub bump: u8,
    pub creator: Pubkey,       // the pool creator this rate applies to
    pub amm_config: Pubkey,    // the fee tier this rate applies to
    pub share_rate: u64,       // protocol's share OF the creator fee, 1/1_000_000
    pub padding: [u64; 8],
}
// CreatorFeeShare::LEN == 8 + 1 + 32 * 2 + 8 + 8 * 8 == 145 bytes

const [creatorFeeShare] = PublicKey.findProgramAddressSync(
  [Buffer.from("creator_fee_share"), creator.toBuffer(), ammConfig.toBuffer()],
  CPMM_PROGRAM_ID, // see reference/program-addresses
);

Cómo se comporta:

Es opcional, pero la cuenta nunca es opcional en la instrucción. CollectCreatorFee y CollectCreatorFeePermissionless ambas declaran creator_fee_share con la restricción de semilla anterior y la toman en cada llamada. El programa luego verifica si la cuenta está vacía o es propiedad extranjera; si es así, vuelve a AmmConfig.creator_fee_share_rate. Así que un cliente siempre debe derivar y pasar la dirección, exista o no la cuenta.
share_rate está limitado a FEE_RATE_DENOMINATOR_VALUE (1_000_000) en la creación, y nuevamente cuando se ejecuta la división. 1_000_000 enruta toda la comisión del creador al protocolo; 0 no enruta nada.
Creado y cerrado por el administrador o una autoridad dedicada a través de CreateCreatorFeeShare / CloseCreatorFeeShare. Cerrarlo devuelve la renta al firmante y hace que el par vuelva al valor predeterminado de la configuración; el creador del pool no es un firmante en ninguna ruta.
Se basa en el creador, no en el pool. Una cuenta rige cada pool que ese creador tiene en ese AmmConfig. Un creador con pools en dos niveles de comisión necesita dos cuentas para estar cubierto en ambos.

La aritmética de división que impulsa está en products/cpmm/fees.

Bóvedas y Token-2022

vault0 y vault1 son propiedad del PDA de autoridad de CPMM, y su propietario de programa de token (token_program) es SPL Token o Token-2022, determinado en la creación del pool por el programa del mint. El pool maneja los dos casos de forma transparente — pasas el ID de programa de token correcto para cada lado en las cuentas de instrucción Swap / Deposit / Withdraw. CPMM aplica una lista de permitidos de extensión estricta en la creación del pool (is_supported_mint en utils/token.rs). Un mint de Token-2022 puede usarse en un pool CPMM solo si cada extensión que lleva está en esta lista:

TransferFeeConfig. Aplicado por el mint en cada transferencia. El pool está en el lado receptor para depósitos de SwapBaseInput y en el lado de envío para retiros. El programa calcula la cantidad neta que llega a la bóveda y establece la curva en consecuencia. Ver algorithms/token-2022-transfer-fees.
MetadataPointer y TokenMetadata. Metadatos estándar en mint. Sin efecto en la matemática del swap.
InterestBearingConfig. La cantidad de UI del mint acumula interés. La bóveda almacena cantidades brutas; la curva opera solo en cantidades brutas. Las UIs que muestran APR deben llamar a los ayudantes de Token-2022 para renderizar la cantidad de UI.
ScaledUiAmount. Extensión de escalado de visualización de UI. El mismo tratamiento que InterestBearingConfig — la curva usa cantidades brutas.

Cualquier otra extensión — PermanentDelegate, TransferHook, DefaultAccountState, NonTransferable, ConfidentialTransfer, Group/GroupMember, MintCloseAuthority, etc. — causa que Initialize rechace con NotSupportMint. La única excepción es un registro por mint: si existe un PDA SupportMintAssociated en la semilla [b"support_mint", mint], el mint se admite independientemente de su conjunto de extensiones. Ese PDA es creado y removido por el administrador (o una autoridad de soporte de mint dedicada) a través de CreateSupportMintAssociated / CloseSupportMintAssociated, por lo que incorporar un mint específico ya no necesita una actualización del programa.

Cambió en 2026-09. CPMM anteriormente también llevaba una MINT_WHITELIST de cuatro direcciones codificadas que cortocircuitaba la verificación de extensión. Ese array fue removido; el PDA del registro es ahora el único bypass. Cualquier mint que estuviera confiando en la lista codificada necesita un PDA SupportMintAssociated antes de que se pueda crear un nuevo pool para él — los pools existentes no se ven afectados, porque la verificación se ejecuta solo en la creación del pool.

La lista de extensiones verificadas vive en la fuente de CP-Swap bajo programs/cp-swap/src/utils/token.rs y puede cambiar con futuras actualizaciones del programa. Ver reference/token-2022-support para la matriz entre programas.

Observation

La cuenta de observación es un búfer de anillo de entradas ObservationState, cada una almacenando un block_timestamp y un precio acumulativo. En cada swap el programa añade una nueva observación si ha pasado suficiente tiempo desde la última. Los TWAPs se calculan leyendo dos observaciones y dividiendo Δcumulative / Δtime.

// OBSERVATION_NUM is hardcoded in the program to 100.
pub const OBSERVATION_NUM: usize = 100;

pub struct Observation {
    pub block_timestamp:              u64,
    pub cumulative_token_0_price_x32: u128,   // Q32.32, top 64 bits left for overflow
    pub cumulative_token_1_price_x32: u128,
}

pub struct ObservationState {
    pub initialized:           bool,
    pub observation_index:     u16,                            // circular index
    pub pool_id:               Pubkey,
    pub observations:          [Observation; OBSERVATION_NUM], // 100 entries
    pub last_update_timestamp: u64,                            // timestamp of the most recent append
    pub padding:               [u64; 3],
}

El búfer de anillo tiene tamaño para 100 observaciones. Cada observación es 40 bytes (8 + 16 + 16), así que el array solo es 4,000 bytes; ObservationState::LEN es exactamente 4,075 bytes (8 + 1 + 2 + 32 + 4,000 + 8 × 4). Dos reglas de consumidor:

No uses una sola observación como precio. Es un acumulativo, no un precio spot. Usa dos de ellas para calcular un TWAP.
Elige observaciones al menos un bloque aparte. Los swaps dentro del mismo bloque pueden no producir una nueva observación; leer de forma consecutiva puede devolver el mismo registro.

Más matemática en products/clmm/accounts.

Ciclo de vida de la cuenta

Evento	Cuentas creadas	Cuentas destruidas
`Initialize`	`poolState`, `lpMint`, `vault0`, `vault1`, `observation`	—
`Deposit`	— (puede crear ATA de LP de usuario)	—
`Withdraw`	—	—
`Swap`	— (puede crear ATA de destino de usuario)	—
`CollectProtocolFee`	—	—
`CollectFundFee`	—	—
`CollectCreatorFee` / `CollectCreatorFeePermissionless`	— (la ruta sin permiso puede crear los ATAs del creador)	—
`CreateCreatorFeeShare`	`creatorFeeShare`	—
`CloseCreatorFeeShare`	—	`creatorFeeShare`
`UpdatePoolStatus`	—	—

Los pools CPMM y sus PDAs nunca se cierran. Permission, SupportMintAssociated y CreatorFeeShare son las excepciones — son registros independientes administrados por el administrador, no estado del pool, y cada uno tiene una instrucción de cierre explícita. Incluso con liquidez cero el poolState permanece. Esto es deliberado: resembrar el mismo pool más tarde preserva su búfer de observación histórico y su derivación de PDA permanece estable.

Qué leer dónde

Listas de cuentas de instrucción (cuál de las anteriores es escribible/firmante para cada instrucción): products/cpmm/instructions.
Semántica de acumulación de comisiones: products/cpmm/fees.
Matemática de swap / regla de actualización de observación: products/cpmm/math.
Semillas canónicas / IDs de programa: reference/program-addresses.

Fuentes:

raydium-io/raydium-cp-swap — PoolState, AmmConfig, ObservationState

Productos

Algoritmos

Las seis cuentas de un pool CPMM

Derivar un pool de nada más que dos mints

Diseños de cuenta

`PoolState`

`AmmConfig`

`Permission`

`CreatorFeeShare`

Bóvedas y Token-2022

Observation

Ciclo de vida de la cuenta

Qué leer dónde

​Las seis cuentas de un pool CPMM

​Derivar un pool de nada más que dos mints

​Diseños de cuenta

​PoolState

​AmmConfig

​Permission

​CreatorFeeShare

​Bóvedas y Token-2022

​Observation

​Ciclo de vida de la cuenta

​Qué leer dónde

Las seis cuentas de un pool CPMM

Derivar un pool de nada más que dos mints

Diseños de cuenta

`PoolState`

`AmmConfig`

`Permission`

`CreatorFeeShare`

Bóvedas y Token-2022

Observation

Ciclo de vida de la cuenta

Qué leer dónde