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 →

​
El modelo de comisiones

Stable AMM usa la misma estructura de comisiones que AMM v4. Solo hay una capa de comisión por pool (establecida en la inicialización); los pools no pueden reconfigurarse a capas más altas.
CampoValor por defectoSignificado
swap_fee_numerator / swap_fee_denominator25 / 10_000Comisión comercial bruta: 0.25% del volumen de entrada.
trade_fee_numerator / trade_fee_denominator25 / 10_000Igual 0.25%, utilizado por la integración de OpenBook para la fijación de precios de órdenes.
pnl_numerator / pnl_denominator12 / 100Participación del protocolo en la comisión: 12% — es decir, 0.25% × 12% = 0.03% del volumen.
min_separate_numerator / min_separate_denominator4 / 10_000Límite de redondeo interno.
No hay comisión de fondo ni comisión del creador — estos son inventos posteriores a AMM v4 (CPMM/CLMM). Stable AMM es anterior a esa convención.

​
Cómo se calcula la división

En cada swap: 
gross_fee = ceil(amount_in * (swap_fee_numerator / swap_fee_denominator))    // p. ej., 0.25% de amount_in
pnl_portion = gross_fee * (pnl_numerator / pnl_denominator)                  // 12% de gross_fee
lp_portion = gross_fee − pnl_portion                                          // 88% de gross_fee
  • lp_portion permanece en la bóveda, infla k y beneficia a los LP en el canje.
  • pnl_portion incrementa AmmInfo.out_put.need_take_pnl_coin o need_take_pnl_pc (dependiendo del token de entrada) y es barrido por WithdrawPnl.
El mismo truco de preservación de invariante que CPMM: la cantidad de PnL se encuentra físicamente en la bóveda pero se resta de las “reservas efectivas” utilizadas en la matemática de la curva, por lo que su eliminación no cambia el precio.

​
PnL desde OpenBook (igual que AMM v4)

Cuando las órdenes limitadas del pool en OpenBook se ejecutan, puede ser en el lado tomador y ganar o perder el diferencial entre creador de mercado y tomador. Estos rellenos se liquidan durante MonitorStep y acreditan / debitan las reservas del pool. El programa los rastrea en los contadores out_put.total_pnl_{coin,pc} para análisis. Este PnL de OpenBook es distinto de la comisión del protocolo del 0.03%. Infla las reservas del pool y beneficia a los LP y al protocolo proporcionalmente. El acoplamiento operacional a OpenBook es una razón por la que CPMM (independiente del libro de órdenes) es ahora el predeterminado para nuevos pools.

​
Recaudación

La multifirma de Raydium (o quien controle amm_admin) llama a WithdrawPnl para barrer:
  1. Liquida primero cualquier relleno pendiente de OpenBook (mediante lógica de crank interna).
  2. Transfiere need_take_pnl_coin y need_take_pnl_pc de las bóvedas a cuentas designadas por el administrador.
  3. Pone a cero los contadores.
La operación no mueve la curva. Los LP no ven cambio de precio.

​
Redención de comisiones de LP

Sin instrucción dedicada “cobrar comisiones”. Las comisiones de LP se acumulan en bóvedas, inflando las reservas. Los LP las realizan quemando LP a través de Withdraw. El valor de un token LP crece a medida que crecen las reservas.

​
Visualización: dónde va $1,000 de volumen

En un Swap pesado en USDC de $1,000 contra un pool Stable con parámetros predeterminados: 
Comisión comercial bruta (0.25%):     $2.50
  Participación de LP   (0.22%):      $2.20  → permanece en el pool, aumenta k
  Participación de PnL  (0.03%):      $0.30  → need_take_pnl_pc, barrido por WithdrawPnl
El usuario recibe (menos curva):      $997.50
Compárese con AMM v4 (idéntico) y CPMM (capa de 0.25%, sin comisión del creador): CPMM da a los LP $2.10, protocolo $0.30, fondo $0.10.

​
Tabla de comparación

Stable AMMAMM v4CPMM index=0
Comisión comercial0.25%0.25%0.25%
LP0.22%0.22%0.21%
Protocolo0.03%0.03%0.03%
FondoNingunoNinguno0.01%
CreadorNingunoNinguno0 por defecto
Matriz completa: reference/fee-comparison.

​
Notas para integradores

  • Cotizaciones: Siempre lee AmmInfo de la cadena; no codifiques las comisiones. En principio SetParams puede cambiarlas, aunque la multifirma no ha modificado los valores predeterminados.
  • Curva vs. comisiones: La comisión de 0.25% es independiente de si la curva es una fórmula (x·y=k en AMM v4) o una tabla de búsqueda (Stable). Ambas aplican el mismo 0.25% a la cantidad de entrada.
  • Sin recompensas: Los pools Stable no admiten emisiones de recompensas en el pool. Los farms del ecosistema (Farm v3/v5/v6) manejan el staking en otro lugar.

​
Próximos pasos

Fuentes:
  • raydium-stable/program/src/state.rs (estructura Fees)
  • Campos AmmInfo.fees en cadena en pools de mainnet activos