Documentation Index
Fetch the complete documentation index at: https://docs.raydium.io/llms.txt
Use this file to discover all available pages before exploring further.
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 →
Los ID del programa y las semillas 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 de CPMM
Cada pool de CPMM se describe completamente mediante seis direcciones derivadas del programa (PDA) bajo el programa CPMM, más una cuentaAmmConfig compartida a la que hace referencia. Una vez que tengas los dos mints, puedes derivar todo de forma determinística 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 acuñación/quema de LP. Compartido entre todos los pools de 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 del keypair aleatorio existe para evitar un ataque de adelantamiento donde un adversario observa el mempool y se apresura a 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 acuñación = el PDA de autoridad de CPMM. |
vault0 | "pool_vault", poolState, token0Mint | SPL Token / Token-2022 | Contiene el saldo del token0 del pool. Propiedad del PDA de autoridad. |
vault1 | "pool_vault", poolState, token1Mint | SPL Token / Token-2022 | Contiene el saldo del token1 del pool. 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. |
| Cuenta | Semilla(s) | Propietario | Propósito |
|---|---|---|---|
ammConfig | "amm_config", index: u16 | CPMM | Contiene las tasas de comisiones comerciales/protocolo/fondo/creador y las claves de administrador. Una por “nivel de tarifa”. El estado del pool se vincula a uno en la creación y no puede cambiar después. |
Derivar un pool a partir de solo dos mints
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 fresco que firma. Esta es la defensa contra adelantamiento: cualquier tercero que intente tomar el PDA canónico puede ser eludido por el creador legítimo usando un keypair aleatorio en su lugar. Los PDA posteriores (lpMint, vault0, vault1, observation) aún se derivan de poolState.key(), por lo que permanecen únicos para cualquier dirección que se haya utilizado. Cuando indexas pools, siempre descubre el ID del pool desde el estado en cadena (por ejemplo, cuentas PoolState bajo el programa CPMM), no derivando el PDA canónico — este último perderá los pools con keypair aleatorio.Diseños de cuentas
Las definiciones completas en Rust viven en la fuente deraydium-cp-swap. Los campos a continuación son los que leerás desde una integración.
PoolState
lp_supply— el espejo interno del pool del suministro total del mint de LP. Úsalo para las matemáticas de participación de LP; el valor debe coincidir con el suministro en cadena del mint, pero leerlo desdePoolStateevita una búsqueda de cuenta adicional.protocol_fees_token{0,1},fund_fees_token{0,1}— comisiones acumuladas aún no barridas. Estas no afectan el precio del swap; se mantienen en las bóvedas hasta que se llame aCollectProtocolFee/CollectFundFee.status— una máscara de bits que controla si se permitenSwap,Deposit,Withdraw. Actualizado por el administrador medianteUpdatePoolStatus. El SDK verifica esto antes de construir una transacción; si estás haciendo CPI directamente, verifica por ti 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 deopen_timepara que el pool pueda ser sembrado.creator_fee_on/enable_creator_fee— juntos controlan si la comisión del creador opcional está activa para este pool y de qué lado del swap se cobra.enable_creator_fee == falseanula completamente la ruta de comisión del creador. Cuando está habilitado,creator_fee_onselecciona:0= cobrar comisión del token que sea la entrada del swap (BothToken);1= cobrar comisión solo detoken_0(omitir en swapstoken_1 → token_0);2= cobrar comisión solo detoken_1. Se establece en la creación del pool medianteInitializeWithPermission; no puede cambiar después.creator_fees_token_{0,1}— comisiones del creador acumuladas, barridas porCollectCreatorFee.
AmmConfig
trade_fee_rateycreator_fee_rateson fracciones del volumen, ambas denominadas en unidades de1/1_000_000.2500significa 0,25% del volumen comercial.protocol_fee_rateyfund_fee_rateson fracciones de la comisión comercial (no del volumen), con el mismo denominador1/1_000_000. La comisión del creador no es una fracción de la comisión comercial — es su propia tasa independiente. La aritmética completa está enproducts/cpmm/fees.indexes unu16, por lo que la semilla hash usa 2 bytes big-endian. Un error de uno en el orden de bytes es un error de integración común.AmmConfiges inmutable a nivel de pool. Un pool apunta a unAmmConfigen 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 tarifa.
creator_fee_rate) vive en AmmConfig y se comparte entre el nivel de tarifa. 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 comercial — es su propia tasa, acumulada en sus propios contadores (creator_fees_token_{0,1}), y nunca reduce las participaciones de LP / protocolo / fondo de la comisión comercial. El barrido se realiza mediante CollectCreatorFee. Consulta 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 permisos para que otros programas (por ejemplo, LaunchLab cuando gradúa un token a CPMM) puedan demostrar que tienen derecho a crear un pool contra un AmmConfig dado.
CreatePermissionPda y se revoca mediante ClosePermissionPda. Los usuarios finales no interactúan directamente con esta cuenta — es tubería para flujos entre programas.
Bóvedas y Token-2022
vault0 y vault1 son propiedad del PDA de autoridad de CPMM, y su propietario del 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 del programa de token correcto para cada lado en las cuentas de instrucción Swap / Deposit / Withdraw.
CPMM impone una lista de extensiones permitidas estricta en la creación del pool (is_supported_mint en utils/token.rs). Un mint de Token-2022 solo puede usarse en un pool de CPMM si cada extensión que lleva está en esta lista:
TransferFeeConfig. Aplicado por el mint en cada transferencia. El pool está del lado receptor para depósitosSwapBaseInputy del lado de envío para retiros. El programa calcula la cantidad neta que llega a la bóveda y establece la curva en consecuencia. Consultaalgorithms/token-2022-transfer-fees.MetadataPointeryTokenMetadata. Metadatos estándar en mint. Sin efecto en las matemáticas del swap.InterestBearingConfig. El monto UI del mint acumula interés. La bóveda almacena montos brutos; la curva opera solo en montos brutos. Las IU que muestran APR deben llamar a los helpers de Token-2022 para renderizar el monto UI.ScaledUiAmount. Extensión de escalado de pantalla UI. El mismo tratamiento queInterestBearingConfig— la curva usa montos brutos.
PermanentDelegate, TransferHook, DefaultAccountState, NonTransferable, ConfidentialTransfer, Group/GroupMember, MintCloseAuthority, etc. — causa que Initialize rechace con NotSupportMint. La excepción es una pequeña lista blanca de mints codificada en el programa (un puñado de pubkeys específicas) que omite la verificación de extensión; se utiliza para incorporar mints específicas caso por caso.
La lista de extensiones verificadas y la lista blanca de mints viven en la fuente de CP-Swap bajo programs/cp-swap/src/utils/token.rs y pueden cambiar con futuras actualizaciones del programa.
Observation
La cuenta de observación es un búfer de anillo de entradasObservationState, 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 TWAP se calculan leyendo dos observaciones y dividiendo Δcumulative / Δtime.
ObservationState completo tiene alrededor de 4,100 bytes después de los campos circundantes y el discriminador.
Dos reglas para consumidores:
- No uses una observación única como precio. Es un acumulativo, no un precio spot. Usa dos para calcular un TWAP.
- Elige observaciones al menos un bloque separadas. Los swaps dentro del mismo bloque pueden no producir una nueva observación; leer de forma consecutiva puede devolver el mismo registro.
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 | — | — |
UpdatePoolStatus | — | — |
poolState permanece. Esto es deliberado: resembrar el mismo pool más tarde preserva su búfer de observaciones histórico y su derivación PDA permanece estable.
Qué leer dónde
- Listas de cuentas de instrucción (cuáles de las anteriores son escribibles/firmante para cada instrucción):
products/cpmm/instructions. - Semántica de acumulación de comisiones:
products/cpmm/fees. - Matemáticas de swap / regla de actualización de observación:
products/cpmm/math. - Semillas canónicas / IDs de programa:
reference/program-addresses.


