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 →
Resumo em um parágrafo
AMM v4 é o programa com o qual Raydium foi lançado. Mantém um invariante de produto constante (x · y = k). Foi originalmente projetado como um AMM híbrido: cada pool ficava sobre um mercado de livro de ordens limitadas OpenBook (antigo Serum) e espelhava porções de sua curva como ordens limitadas nesse livro, para que usuários e agregadores pudessem fazer swaps diretamente contra o pool (caminho AMM) ou contra as ordens limitadas que o pool possuía no OpenBook (caminho CLOB). O lado OpenBook foi posteriormente desativado — os pools não postam mais nem mantêm ordens no OpenBook, e todo o tráfego de swap atual flui através dos pontos de entrada de swap V2 apenas para AMM. Token-2022 não é suportado. AMM v4 ainda está totalmente operacional como um AMM de produto constante — cada pool continua negociando, as taxas continuam acumulando, LPs continuam ganhando — mas a UI e o SDK padrão de criação de novo pool para CPMM porque CPMM é mais barato e suporta mais tipos de mint.
Histórico híbrido (contexto)
No lançamento, ter um pool ao lado do livro de ordens Serum corria o risco de fragmentar a liquidez. O design híbrido publicava a curva do AMM no livro como ordens limitadas, para que roteadores de livros de ordens vissem a profundidade do pool de graça. Depois que OpenBook fez fork do Serum no final de 2022, o programa continuou funcionando contra OpenBook com mudanças mínimas. Conforme CPMM e agregadores on-chain amadureceram, o benefício do lado do orderbook desapareceu, e a integração OpenBook do AMM v4 foi eventualmente desativada — a curva agora é a única superfície de execução do pool.O que AMM v4 oferece (que CPMM não oferece)
- Liquidez profunda para pares legados. Pares principais (SOL-USDC, mSOL-USDC, etc.) com grande TVL em AMM v4 permanecem como o melhor lugar para essas negociações.
O que AMM v4 não oferece
- Token-2022. Não suportado. AMM v4 foi escrito antes do Token-2022 existir; seus layouts de contas pressupõem SPL Token clássico.
- Contagem baixa de contas. Um swap toca o pool, autoridade, vaults, mais toda a fila de eventos/requisições OpenBook e lados de bids/asks. Mesmo um swap AMM direto (ignorando CLOB) arrasta todas as contas OpenBook porque a instrução as valida.
- Uso baixo de compute. Apenas a validação de contas custa mais do que um swap CPMM completo.
- Fluxo padrão de novo pool. O programa ainda é funcional e ainda aceita
Initialize, mas a UI Raydium, SDK eapi-v3.raydium.ionão exibem mais um botão “criar pool AMM v4” — o caminho padrão para novos pools é CPMM.
Como AMM v4 difere de CPMM
| Dimensão | AMM v4 | CPMM |
|---|---|---|
| Curva | Produto constante | Produto constante |
| Dependência OpenBook | Inerte (originalmente sim; agora desativada) | Não |
| Token-2022 | Não | Sim |
| Contagem de contas por swap V2 | ~9 | ~11 |
| Unidades de compute por swap | ~80k–120k (caminho V2) | ~60k–100k |
| Taxa LP | 0.22% do volume | Varia por AmmConfig |
| Taxa de protocolo | 0.03% do volume (fixa) | Varia por AmmConfig |
| Taxa de fundo | Nenhuma | Sim |
| Oráculo TWAP | Nenhuma conta de observação nativa | Buffer de anel observation |
| Padrão para novos pools | Não (ainda aceito) | Sim |
products/amm-v4/fees e reference/fee-comparison.
Modelo mental
Um pool AMM v4 hoje é um AMM de produto constantex · y = k. Ambos os vaults estão inteiramente disponíveis para a curva — nenhuma fração é comprometida com ordens OpenBook, porque a integração OpenBook não está mais ativa. As operações são swap (usuário ↔ pool, via SwapBaseInV2 / SwapBaseOutV2), deposit / withdraw (operações LP) e um crank agora vestigial (MonitorStep, retido on-chain, mas não mais necessário e não postado pelo keeper do Raydium).
Modelo mental histórico (pré-desativação): uma fração de cada vault era mantida em custódia como ordens no livro aberto; a liquidação de ordens preenchidas acontecia durante swaps e operações LP; swaps roteados poderiam ser preenchidos contra as próprias ordens OpenBook do pool. Nada disso está em operação hoje.
Por que CPMM é o padrão recomendado
CPMM elimina a dependência OpenBook. Os tradeoffs:- Transações CPMM são 2×–3× mais baratas em compute.
- CPMM suporta mints Token-2022.
- Agregadores agora integram CPMM diretamente via Raydium SDK, então o benefício de visibilidade do livro de ordens é em grande parte discutível.
- Risco operacional: interrupções ou pausas OpenBook degradam pools AMM v4 (
CrankError, ordens obsoletas). CPMM não tem esse acoplamento.
protocol-overview/versions-and-migration para orientação de migração.
Quando AMM v4 é a escolha certa
- Você está roteando um swap e um dos pools candidatos é um pool AMM v4 com o melhor preço.
- Você está fornecendo ou gerenciando liquidez em um pool AMM v4 existente — migração é uma escolha, não obrigatória; o pool continua funcionando como um AMM puro.
- Você mantém uma integração construída contra AMM v4 e não tem motivo para migrar.
Próximos passos
- Accounts — as contas do AMM mais as contas OpenBook que ele serve.
- Math — matemática de swap de produto constante com a convenção de taxa do AMM v4.
- Instructions — a superfície de instrução:
Initialize,Swap,Deposit,Withdraw, crank helpers. - Fees — a divisão de 0.25% e como é coletada.
- Code demos — exemplos TypeScript para fluxos de swap e LP.
reference/program-addressespara o ID do programa canônico- Repositório de programa OpenBook para as contas contrapartes que esta página referencia