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
AMM v4 es el programa con el que Raydium se lanzó. Mantiene un invariante de producto constante (x · y = k). Originalmente fue diseñado como un AMM híbrido: cada pool se ubicaba encima de un mercado de libro de órdenes limitadas de OpenBook (anteriormente Serum) y reflejaba porciones de su curva como órdenes limitadas en ese libro, de modo que los usuarios y agregadores podían realizar swaps directamente contra el pool (ruta AMM) o contra las órdenes limitadas que el pool poseía en OpenBook (ruta CLOB). El lado de OpenBook ha sido desactivado desde entonces — los pools ya no publican ni mantienen órdenes en OpenBook, y todo el tráfico de swaps actual fluye a través de los puntos de entrada de swap V2 solo para AMM. Token-2022 no es compatible. AMM v4 sigue siendo completamente operacional como un AMM de producto constante — cada pool continúa operando, las tarifas se acumulan, los proveedores de liquidez siguen ganando — pero la UI y el SDK utilizan CPMM de forma predeterminada para crear nuevos pools porque CPMM es más económico y admite más tipos de mints.
Historial híbrido (contexto)
En el lanzamiento, establecer un pool junto al libro de órdenes de Serum arriesgaba fragmentar la liquidez. El diseño híbrido publicaba la curva del AMM en el libro como órdenes limitadas, de modo que los enrutadores de libros de órdenes veían la profundidad del pool de forma gratuita. Después de que OpenBook se bifurcara de Serum a finales de 2022, el programa continuó funcionando contra OpenBook con cambios mínimos. A medida que CPMM y los agregadores en cadena maduraron, el beneficio del lado del libro de órdenes se desvaneció, y la integración de OpenBook de AMM v4 finalmente se desactivó — la curva es ahora la única superficie de ejecución del pool.Lo que te ofrece AMM v4 (que CPMM no)
- Liquidez profunda para pares heredados. Los pares principales (SOL-USDC, mSOL-USDC, etc.) con gran TVL en AMM v4 siguen siendo el lugar más profundo para esas transacciones.
Lo que AMM v4 no te ofrece
- Token-2022. No es compatible. AMM v4 fue escrito antes de que Token-2022 existiera; sus esquemas de cuentas presumen Token SPL clásico.
- Bajo recuento de cuentas. Un swap toca el pool, la autoridad, los vaults, más toda la cola de eventos/solicitudes de OpenBook y los lados de órdenes de compra/venta. Incluso un swap AMM directo (omitiendo CLOB) arrastra todas las cuentas de OpenBook porque la instrucción las valida.
- Bajo uso de compute. La validación de cuentas por sí sola cuesta más que un swap CPMM completo.
- Flujo predeterminado de nuevo pool. El programa sigue siendo funcional y sigue aceptando
Initialize, pero la UI de Raydium, el SDK yapi-v3.raydium.ioya no muestran un botón “crear pool AMM v4” — la ruta predeterminada para nuevos pools es CPMM.
Cómo difiere AMM v4 de CPMM
| Dimensión | AMM v4 | CPMM |
|---|---|---|
| Curva | Producto constante | Producto constante |
| Dependencia de OpenBook | Inerte (originalmente sí; ahora desactivada) | No |
| Token-2022 | No | Sí |
| Recuento de cuentas por swap V2 | ~9 | ~11 |
| Unidades de compute por swap | ~80k–120k (ruta V2) | ~60k–100k |
| Tarifa de LP | 0.22% del volumen | Varía según AmmConfig |
| Tarifa de protocolo | 0.03% del volumen (fija) | Varía según AmmConfig |
| Tarifa de fondo | Ninguna | Sí |
| Oráculo TWAP | Sin cuenta de observación nativa | Buffer de anillo observation |
| Predeterminado para nuevos pools | No (aún se acepta) | Sí |
products/amm-v4/fees y reference/fee-comparison.
Modelo mental
Un pool AMM v4 hoy es un AMM de producto constantex · y = k. Ambos vaults están completamente disponibles para la curva — ninguna fracción está comprometida con órdenes de OpenBook, porque la integración de OpenBook ya no está activa. Las operaciones son swap (usuario ↔ pool, a través de SwapBaseInV2 / SwapBaseOutV2), depósito / retiro (operaciones de LP) y un crank ahora vestigial (MonitorStep, retenido en cadena pero ya no necesario y no publicado por el keeper de Raydium).
Modelo mental histórico (pre-desactivación): una fracción de cada vault estaba en depósito en garantía como órdenes abiertas en el libro; la liquidación de órdenes ejecutadas ocurría durante operaciones de swap y LP; los swaps enrutados podían ejecutarse contra las propias órdenes de OpenBook del AMM. Nada de esto está en operación hoy.
Por qué CPMM es la opción predeterminada recomendada
CPMM elimina la dependencia de OpenBook. Los compromisos:- Las transacciones CPMM son 2×–3× más económicas en compute.
- CPMM admite mints Token-2022.
- Los agregadores ahora integran CPMM directamente a través del SDK de Raydium, por lo que el beneficio de visibilidad del libro de órdenes es en gran medida discutible.
- Riesgo operativo: las interrupciones o pausas de OpenBook degradan los pools AMM v4 (
CrankError, órdenes obsoletas). CPMM no tiene tal acoplamiento.
protocol-overview/versions-and-migration para la guía de migración.
Cuándo AMM v4 es la opción correcta
- Estás enrutando un swap y uno de los pools candidatos es un pool AMM v4 con el mejor precio.
- Estás proporcionando o gestionando liquidez en un pool AMM v4 existente — la migración es una opción, no es obligatoria; el pool continúa funcionando como un AMM puro.
- Mantienes una integración construida contra AMM v4 y no tienes razón para migrar.
Por dónde continuar
- Cuentas — las cuentas del AMM más las cuentas de OpenBook que sirve.
- Matemáticas — matemáticas de swap de producto constante con la convención de tarifas de AMM v4.
- Instrucciones — la superficie de instrucciones:
Initialize,Swap,Deposit,Withdraw, ayudantes de crank. - Tarifas — la división del 0.25% y cómo se cobra.
- Demos de código — ejemplos de TypeScript para flujos de swap y LP.
reference/program-addressespara el ID del programa canónico- Repositorio del programa OpenBook para las cuentas de contraparte que esta página referencia