Saltar para o conteúdo 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 foi traduzida automaticamente por IA. A versão em inglês é a fonte oficial.Ver versão em inglês →

​
O modelo de taxas

O Stable AMM usa a mesma estrutura de taxas do AMM v4. Existe apenas um nível de taxa por pool (definido na inicialização); os pools não podem ser reconfigurados para níveis mais altos.
CampoPadrãoSignificado
swap_fee_numerator / swap_fee_denominator25 / 10_000Taxa bruta de negociação: 0,25% do volume de entrada.
trade_fee_numerator / trade_fee_denominator25 / 10_000Mesmos 0,25%, usado pela integração OpenBook para precificação de ordens.
pnl_numerator / pnl_denominator12 / 100Participação do protocolo na taxa: 12% — ou seja, 0,25% × 12% = 0,03% do volume.
min_separate_numerator / min_separate_denominator4 / 10_000Limite de arredondamento interno.
Não há taxa de fundo e nem taxa de criador — esses são inventos posteriores ao AMM v4 (CPMM/CLMM). O Stable AMM é anterior a essa convenção.

​
Como a divisão é calculada

Em cada swap: 
gross_fee = ceil(amount_in * (swap_fee_numerator / swap_fee_denominator))    // ex.: 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 fica no vault, inflaciona k e beneficia LPs no resgate.
  • pnl_portion incrementa AmmInfo.out_put.need_take_pnl_coin ou need_take_pnl_pc (dependendo do token de entrada) e é coletada por WithdrawPnl.
O mesmo truque de preservação de invariante do CPMM: o valor do PnL fica fisicamente no vault, mas é subtraído das “reservas efetivas” usadas na matemática da curva, então removê-lo não altera o preço.

​
PnL do OpenBook (igual ao AMM v4)

Quando as ordens limitadas do pool no OpenBook são preenchidas, pode ser no lado tomador e ganhar ou perder o spread entre formador e tomador de mercado. Esses preenchimentos são liquidados durante MonitorStep e creditam / debitam as reservas do pool. O programa os rastreia nos contadores out_put.total_pnl_{coin,pc} para análise. Este PnL do OpenBook é distinto da taxa de protocolo de 0,03%. Ele inflaciona as reservas do pool e beneficia LPs e protocolo proporcionalmente. O acoplamento operacional ao OpenBook é uma razão pela qual CPMM (independente de livro de ordens) agora é o padrão para novos pools.

​
Coleta

O multisig do Raydium (ou quem quer que controle amm_admin) chama WithdrawPnl para coletar:
  1. Primeiro, liquida quaisquer preenchimentos pendentes do OpenBook (via lógica de crank interna).
  2. Transfere need_take_pnl_coin e need_take_pnl_pc dos vaults para contas designadas pelo admin.
  3. Zera os contadores.
A operação não move a curva. LPs não veem mudança de preço.

​
Resgate de taxas de LP

Nenhuma instrução dedicada de “coleta de taxas”. As taxas de LP se acumulam nos vaults, inflacionando as reservas. LPs as realizam queimando LP via Withdraw. O valor de um token LP cresce conforme as reservas crescem.

​
Visualização: para onde vai $1.000 de volume

Em um Swap pesado em USDC de $1.000 contra um pool Stable com parâmetros padrão: 
Taxa bruta de negociação (0,25%):  $2,50
  Participação LP (0,22%):         $2,20  → fica no pool, eleva k
  Participação PnL (0,03%):        $0,30  → need_take_pnl_pc, coletado por WithdrawPnl
Usuário recebe (menos curva):      $997,50
Compare com AMM v4 (idêntico) e CPMM (nível 0,25%, sem taxa de criador): CPMM dá LPs $2,10, protocolo $0,30, fundo $0,10.

​
Tabela de comparação

Stable AMMAMM v4CPMM index=0
Taxa de negociação0,25%0,25%0,25%
LP0,22%0,22%0,21%
Protocolo0,03%0,03%0,03%
FundoNenhumNenhum0,01%
CriadorNenhumNenhum0 por padrão
Matriz completa: reference/fee-comparison.

​
Notas para integradores

  • Cotação: Sempre leia AmmInfo da chain; não codifique as taxas. Em princípio SetParams pode alterá-las, embora o multisig não tenha alterado os padrões.
  • Curva vs. taxas: A taxa de 0,25% é independente de a curva ser uma fórmula (x·y=k no AMM v4) ou uma tabela de consulta (Stable). Ambas aplicam os mesmos 0,25% ao valor de entrada.
  • Sem recompensas: Pools Stable não suportam emissões de recompensas on-pool. Fazendas do ecossistema (Farm v3/v5/v6) lidam com staking em outro lugar.

​
Próximos passos

Fontes:
  • raydium-stable/program/src/state.rs (struct Fees)
  • Campos AmmInfo.fees on-chain em pools mainnet ativos