Versiones y migración

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.

​

Estado de un vistazo

​

AMM v4 — estado y trayectoria

​

Qué está congelado

• Sin nuevas tasas de comisión. La estructura de comisiones de AMM v4 es por pool y se estableció al desplegar. Los nuevos pools aceptan la misma comisión de operación codificada de ~0.25%, ~12% para el protocolo.
• Sin nuevo trabajo de características. El equipo no ha añadido nuevas instrucciones a AMM v4 desde que CPMM se convirtió en el nuevo estándar. El programa está en modo de administración — solo correcciones de errores, sin expansión de alcance.
• Sin soporte Token-2022. AMM v4 fue escrito antes de que existiera Token-2022 y la integración nunca se adaptó retroactivamente. Los mints Token-2022 deben usar CPMM (o CLMM, donde sea apropiado).
• Integración OpenBook desactivada. Cada pool AMM v4 todavía está vinculado a una cuenta de mercado OpenBook correspondiente en la cadena, pero el pool ya no publica ni mantiene órdenes en ese mercado. Una interrupción de OpenBook ya no afecta los swaps de AMM v4.

​

Qué sigue funcionando

• Los pools existentes operan normalmente. No se forzó migración de estado; los pools v4 creados en 2021 siguen siendo el lugar activo para muchos pares de alto volumen en 2026.
• Los LPs pueden depositar, retirar y cosechar recompensas de granja como es habitual. La migración a CPMM es opcional.
• Los agregadores siguen ruteando a través de él. Jupiter y la API de operaciones Raydium indexan los pools v4 como sitios de primera clase.

​

Cuándo aún usar AMM v4

• El par ya tiene un pool v4 profundo y bien operado y quieres añadir liquidez a la profundidad existente en lugar de dividir un mercado.

​

CPMM — curva de adopción y la migración v4 → CPMM

​

Qué CPMM te ofrece sobre AMM v4

• Mejores economías de LP por defecto. El AmmConfig predeterminado de CPMM enruta el 100% de las comisiones de operación a LPs (con la comisión de protocolo activable por nivel). AMM v4 codifica ~12% para el protocolo.
• Costo de creación de pool más bajo. Sin mercado OpenBook necesario. La creación es una transacción, ~0.15 SOL de alquiler vs ~0.6 SOL para v4.
• Token-2022. Mints con comisión de transferencia, mints con gancho de transferencia (con caveats), transferencias confidenciales — todo soportado en CPMM, nada en v4.
• Superficie de integrador más limpia. CPMM tiene un crate publicado compatible con Anchor-CPI (raydium-cp-swap), una lista de cuentas más simple e IDL estable. AMM v4 envía un IDL pero nunca tuvo un crate CPI Rust mantenido.
• Lista de cuentas más pequeña por swap. ~10 cuentas vs ~17 para v4 (que lleva las cuentas del mercado OpenBook incluso cuando no las utiliza).

​

Cuándo la migración vale la pena

​

Cómo funciona la migración

1. Crea un nuevo pool CPMM para el mismo par, en el mismo nivel de comisión que deseas preservar.
2. Coordina con LPs: anuncia una ventana durante la cual el pool antiguo se drena y el nuevo pool se siembra.
3. Cada LP se retira del pool v4 y deposita en el nuevo pool CPMM.
4. (Opcional) Configura una granja del lado CPMM para atraer LPs incentivados al nuevo pool.
5. Observa cómo el volumen migra mientras los agregadores se reponderan hacia el pool más profundo.

​

CLMM — programa único, estable entre versiones

• Instrucción SwapV2 añadida para soportar correctamente las matemáticas de comisión de transferencia Token-2022. El antiguo Swap sigue siendo invocable; las nuevas integraciones deben apuntar a SwapV2.
• Extensiones de flujo de recompensas — el conteo de ranuras RewardInfo fue aumentado (las originales 3 → aún 3 actualmente, pero el patrón de reserva fue apretado). Sin migración de datos necesaria.
• Compactación de array de tick — optimización interna para reducir CU en swaps que cruzan muchos ticks. Externamente invisible.

​

Farm v3 → v5 → v6

​

Generaciones

​

Por qué existen tres generaciones

• v3 → v5: se necesitaban múltiples flujos de recompensa concurrentes (p.ej., granjas de incentivo dual). El diseño de flujo único de v3 no podía soportarlo sin una redesignación.
• v5 → v6: la tasa de emisión u64 entera de v5 limita la tasa expresable mínima a “1 unidad de token por segundo.” Para un mint de 9 decimales, eso es 1 lamport/seg — demasiado grueso para programas de baja emisión. La tasa fraccionaria Q64.64 de v6 arregla esto. v6 también elevó la actualización basada en ranuras a reloj de pared, y añadió soporte Token-2022.

​

Qué permanece igual entre generaciones

• El patrón contable “deposita LP, acumula contador por acción, reclama al retirar” es idéntico en v3/v5/v6. Las matemáticas no cambian; solo la precisión del contador de tasa y el número de flujos soportados.
• UserStake (v3/v5) y UserLedger (v6) son conceptualmente el mismo registro, con diseños diferentes. El SDK normaliza ambos.

​

Ruta de migración

1. Espera a que terminen las emisiones de la granja existente (o redúcelas).
2. Los stakers se retiran y reclaman recompensas pendientes en la granja antigua.
3. El operador de la granja crea una nueva granja v6 contra el mismo mint de staking.
4. Los stakers vuelven a hacer stake en la nueva granja.

​

Qué significa “fin de vida” para v3 y v5

• Los programas v3 y v5 todavía están desplegados y son invocables. Las granjas existentes aún pueden distribuir recompensas pendientes y aceptar retiros.
• La interfaz de Raydium aún muestra granjas v3 y v5 con recompensas activas; una vez que pasa el end_time de una granja v3/v5, la interfaz la oculta de “activas” pero la mantiene reclamable.
• El equipo no creará nuevas granjas v3/v5. Los helpers del SDK para “crear granja” enrutan solo a v6.
• v3 y v5 están recibiendo actualizaciones de seguridad pero no trabajo de características. Si se encuentra un error crítico, se corrige; si una característica podría ser útil, se añade a v6 en su lugar.

​

LaunchLab — programa único, configuración evolucionante

• Ranura de comisión del creador. Se añadió para que los lanzamientos puedan enrutar una porción de las comisiones de operación CPMM posteriores a la graduación al creador original. Consulta products/launchlab/creator-fees.
• Configurabilidad de fórmula de curva. Originalmente codificada cuadráticamente; ahora el LaunchConfig selecciona de un conjunto pequeño de formas de curva.

​

Compatibilidad de versión entre programas

• CLMM SwapV2 no es la misma instrucción que Swap. Si tu cliente solo habla Swap, manejará silenciosamente mal las comisiones de transferencia Token-2022 — las matemáticas son incorrectas por el monto de la comisión. Actualiza a SwapV2.
• El staking de Farm v6 con posiciones CLMM no es soportado de la manera que el staking de token LP es. Las posiciones CLMM son NFTs, no tokens LP fungibles. CLMM tiene su propio mecanismo de recompensa nativo en su lugar — consulta products/clmm/fees.
• Los pools CPMM respaldados por mints Token-2022 funcionan en granjas solo en Farm v6. v3 y v5 rechazan mints de staking Token-2022.
• Los pools AMM v4 nunca tienen mints LP Token-2022. Si ves uno, es falso — AMM v4 no soporta esa combinación.

​

Dónde leer más

• introduction/history-and-milestones — la línea de tiempo de lanzamiento cronológica y por qué cada versión se lanzó cuándo se lanzó.
• user-flows/migrate-amm-v4-to-cpmm — el manual del operador para el movimiento v4 → CPMM.
• user-flows/choosing-a-pool-type — árbol de decisión para nuevos despliegues de pool.
• products/farm-staking/accounts — esquema lado a lado para v3 / v5 / v6.
• reference/changelog — qué ha cambiado en esta documentación a medida que las versiones de programa han evolucionado.

• Páginas de capítulo por producto citadas en línea arriba.
• Raydium SDK v2 — lógica de despacho consciente de versiones confirma a qué programa pertenece un pool dado.
• reference/program-addresses — IDs canónicas por versión.