Saltar al contenido principal

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

Stable AMM es una variante del AMM de Raydium que reemplaza la fórmula de la curva por una tabla de búsqueda pre-poblada. En lugar de usar x·y=k, el pool almacena un arreglo disperso de puntos (x, y, precio) y utiliza búsqueda binaria + interpolación lineal para cotizar precios. Este diseño sobresale en pares de stablecoins y otros activos con relaciones de precio conocidas: los swaps entre tokens con paridad 1:1 tienen un deslizamiento cercano a cero. Como AMM v4, se vincula a un mercado de OpenBook y publica órdenes limitadas allí. La liquidez es actualmente reducida; la mayoría de los integradores acceden a los pools de Stable a través del programa de enrutamiento de AMM.

​
¿Por qué una tabla de búsqueda en lugar de xy=k?

Los AMMs de producto constante incurren en un alto deslizamiento en pares con bandas de precio estrechas. Un swap USDC-USDT debería costar casi nada; en un pool de producto constante, k=x·y fuerza un movimiento de precio incluso para volúmenes pequeños. Una tabla de búsqueda permite al administrador del pool expresar la relación de precio real:
  • Para stablecoins: densificar la tabla alrededor de 1:1 para que los micro-swaps cuesten ~0 de deslizamiento.
  • Para pares colateralizados: codificar la relación objetivo y dejar que la grilla forme la superficie de tarifa/incentivo.
La tabla es estática entre llamadas a UpdateModelData (que el administrador publica cuando la relación cambia), por lo que el costo en cadena es solo búsqueda de interpolación, mucho más económico que recomputar una fórmula.

​
Cómo funciona: la cuenta de datos del modelo

El pool mantiene una cuenta ModelDataInfo — un arreglo de 50,000 elementos de estructuras DataElement. Cada elemento contiene: 
DataElement {
  x: u64,           // coordenada X de la tabla
  y: u64,           // coordenada Y de la tabla
  price: u64,       // precio en (x, y)
}
Solo se rellenan los primeros valid_data_count elementos; el resto están en cero. Al hacer un swap, el programa:
  1. Calcula una relación a partir de las reservas actuales del pool y utiliza búsqueda binaria para encontrar qué dos elementos de la tabla enmarcan esa relación.
  2. Interpola linealmente entre los dos puntos que enmarcan para obtener el precio de la cotización.
  3. Aplica tarifas (igual que 0.25% en AMM v4) y devuelve el resultado al usuario.
El campo multiplier en la tabla se cuenta para la posibilidad de que x e y se almacenen en una escala reducida (p. ej., con 6 decimales en lugar de 18). El descubrimiento de precio se reescala en consecuencia.

​
Comparación: Stable AMM vs. AMM v4 vs. CPMM

DimensiónStable AMMAMM v4CPMM
CurvaTabla de búsqueda + interpolaciónProducto constante (xy=k)Producto constante
Caso de uso principalStablecoins, pares con paridadPares generales, liquidez profunda heredadaPares generales, nuevos despliegues
Dependencia de OpenBookSíSíNo
Token-2022NoNoSí
Perfil de deslizamientoMínimo en 1:1Alto en ratios estrechosModerado en el rango
Curva ajustable por administradorSí (UpdateModelData)No (solo SetParams)No
Tamaño de tabla~50k elementos × 24 bytesN/AN/A
Compute por swap~5k–15k CU (búsqueda binaria + interpolación)~150k–200k CU~60k–100k CU
Cantidad de cuentas por swap~17 (AMM + OpenBook)~18 (AMM + OpenBook)~11

​
Modelo mental

Un pool de Stable AMM es un AMM con tabla de búsqueda interpolada cuyos depósitos también custodian órdenes limitadas de OpenBook, tal como AMM v4. La diferencia clave es que la curva de descubrimiento de precio no está codificada: es un arreglo disperso que el administrador puede rellenar y actualizar. Las operaciones son similares a AMM v4: swap directo (usuario ↔ pool), depósito / retiro (operaciones de LP), crank (MonitorStep), y mantenimiento del administrador (UpdateModelData, SetParams).

​
Cuándo Stable AMM es la opción correcta

  • Operas un stablecoin u otro par de activos correlacionados y deseas una fijación de precios ajustada y predecible.
  • Tienes conocimiento profundo de la relación de precio de tu par y deseas codificarlo directamente como una curva.
  • Ya tienes integraciones para AMM v4 y simplemente necesitas una variante de curva diferente.
Para un pool nuevo y de propósito general sin requisito de correlación estricta, CPMM es el predeterminado más simple y con mayor liquidez.

​
A dónde ir después

  • Cuentas — referencia de campos AmmInfo, ModelDataInfo, DataElement.
  • Matemática — búsqueda binaria, interpolación y aplicación de tarifas.
  • Instrucciones — InitModelData, UpdateModelData, instrucciones de swap y LP.
  • Tarifas — la división de 0.25% (idéntica a AMM v4).
  • Demostraciones de código — enrutamiento e integración directa.
Fuentes: