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 →
Resumen en un párrafo
CPMM — Constant Product Market Maker, oficialmente el “Standard AMM” en la interfaz de Raydium — es una implementación nativa de Solana del clásico AMMx · y = k. Sin libro de órdenes de OpenBook, sin herencia de Serum, sin dependencias externas más allá de SPL Token y Token-2022. Cada pool es una tríada de (dos bóvedas de token, un mint de LP) gobernada por un PDA de autoridad propiedad del programa, tasado por el producto de los saldos de las bóvedas. Es el AMM que Raydium recomienda para todos los pools de producto constante nuevos, y es lo que el endpoint /pools/create y el flujo “Create pool” de la interfaz web tienen como destino por defecto.
Qué te proporciona CPMM
- Token-2022 con una lista de extensiones permitidas verificada. CPMM no acepta mints de Token-2022 arbitrarios. El programa aplica una lista blanca de extensiones seguras en la creación del pool:
TransferFeeConfig,MetadataPointer,TokenMetadata,InterestBearingConfigeScaledUiAmount. Cualquier otra extensión en el mint hace queInitializerechace conNotSupportMint— a menos que el mint mismo esté en una pequeña lista de mints codificada mantenida en el programa (usada para incorporar mints específicos caso por caso). Las comisiones de transferencia en particular afectan la matemática del swap y se aplican en el lado correcto del trade — veralgorithms/token-2022-transfer-fees. - Comisiones predecibles. Cada pool hace referencia a un
AmmConfigseleccionado en la creación. La configuración lleva una tasa de comisión de trade (dividida entre LPs, protocolo y fondo) y una tasa de comisión de creador separada e independiente. La comisión del creador es su propio depósito — nunca una porción de la comisión de trade. Los pools optan por cobrarla en la creación. Los valores por defecto y la matemática de división completa están enproducts/cpmm/fees. - TWAP en cadena a través de un búfer de anillo de observación. Cada swap actualiza una cuenta
observation. Los contratos externos pueden leer una observación de precio acumulativo para calcular un TWAP sin un oráculo personalizado. - Diseño de cuenta plano. Un pool se describe completamente por seis PDAs (autoridad, estado del pool, mint de LP, dos bóvedas, observación). Sin cuenta de OpenBook por mercado, sin cola de eventos, sin cola de solicitudes. Las transacciones son más baratas tanto en cómputo como en cantidad de cuentas que AMM v4.
- Compatible con burn-and-earn. Los tokens de LP pueden bloquearse bajo el programa LP Lock para que el creador del pool pueda seguir reclamando comisiones sin retener el derecho de retirar liquidez. Se usa para lanzamientos de liquidez “permanente”.
Qué CPMM no es
- No concentrado. La liquidez se distribuye uniformemente en todo el rango de precios, como Uniswap v2. Si necesitas market making capital-eficiente — es decir, concentrar liquidez cerca del precio actual — usa CLMM.
- No híbrido. A diferencia de AMM v4, los pools de CPMM no colocan órdenes en reposo en un mercado de OpenBook. El enrutamiento entre pools de CPMM ocurre a través del programa AMM Routing, no a través de un CLOB.
- No lanzable para curvas arbitrarias. La curva está codificada en duro como producto constante. Si quieres una curva de vinculación para un lanzamiento de token, usa LaunchLab, que se gradúa a un pool de CPMM cuando se llena.
Cómo CPMM difiere de AMM v4
| Dimensión | AMM v4 | CPMM |
|---|---|---|
| Curva | Producto constante | Producto constante |
| Dependencia de OpenBook | Inerte (originalmente colocaba órdenes en un mercado de OpenBook; integración desactivada) | No |
| Soporte de Token-2022 | No (solo SPL Token) | Sí (incluyendo comisiones de transferencia) |
| Cantidad de cuentas por swap V2 | ~9 | ~11 |
| Unidades de cómputo por swap | ~80k–120k (ruta V2) | ~60k–100k |
| Oráculo TWAP | Sin cuenta de oráculo nativa | Búfer de anillo observation |
| Creación de nuevo pool hoy | No es el predeterminado (el programa aún lo acepta) | Predeterminado |
| Estado | Completamente operacional | Activo, recomendado |
protocol-overview/versions-and-migration.
Modelo mental
Un pool de CPMM es un objeto propiedad del programa que mantiene tres saldos:vault0 (token0), vault1 (token1) y la oferta del mint de LP. La oferta del mint de LP rastrea la reclamación de los depositantes en el pool; las bóvedas de token mantienen los activos reales. Todo lo demás — el PDA de autoridad, la cuenta de observación, el puntero de configuración de tarifa — es contabilidad para hacer esa relación de tres variables comercializable, recolectora de comisiones y observable.
Cada operación orientada al usuario se reduce a una transición de estado bien definida:
- Depósito: transfiere token0 y token1, acuña LP al usuario, sin cambio de precio.
- Retiro: quema LP del usuario, transfiere token0 y token1 en la relación actual del pool, sin cambio de precio.
- Swap: transfiere un token, transfiere el otro; la relación se mueve a lo largo de la curva
x · y = k(menos comisiones); la cuenta de observación muestrea el nuevo precio.
CollectProtocolFee, CollectFundFee) es una transacción separada firmada por la autoridad respectiva; no ocurre en cada swap. La matemática se detalla en products/cpmm/math y el conjunto de instrucciones en products/cpmm/instructions.
Cuándo elegir CPMM
Elige CPMM cuando:- Estás lanzando un nuevo token o un nuevo par y no tienes opiniones firmes sobre qué rango verá trading.
- Uno o ambos tokens usan extensiones de Token-2022.
- Quieres un modelo simple de comisión por trade sobre uno dinámico basado en ticks.
- Estás integrando y quieres enrutar a través de Raydium sin asumir la complejidad de las posiciones de CLMM.
- El par es estable o altamente correlacionado (stablecoin-stablecoin, LST-SOL) y quieres concentrar liquidez alrededor de paridad.
- Eres un equipo de market-making dispuesto a gestionar activamente rangos para un mayor APR de comisión por dólar de TVL.
- Estás migrando herramientas existentes de AMM v4 y no estás creando un nuevo pool.
Hacia dónde ir a continuación
- Accounts — los seis PDAs de un pool de CPMM y cómo derivarlos.
- Math —
SwapBaseInputvsSwapBaseOutput, manejo de comisiones de transferencia de Token-2022, actualizaciones de observación. - Instructions — la superficie de instrucción completa con listas de cuentas.
- Fees — la división de comisión de cuatro vías y cómo cobrar.
- Code demos — fragmentos de TypeScript ejecutables para crear / swap / depósito / retiro.
- Código fuente de Raydium CP-Swap —
raydium-io/raydium-cp-swap reference/program-addressespara IDs de programa canónicos