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 →
Banner de versão.
- SDK:
@raydium-io/raydium-sdk-v2@0.2.42-alpha - Cluster: Solana
mainnet-beta - ID do programa Stable AMM:
5quBtoiQqxF9Jv6KYKctB59NT3gtJD2Y65kdnB1Uev3h(vejareference/program-addresses) - Última verificação: 2026-04
liquidity do SDK funciona nativamente com pools Stable AMM. Pools estáveis aparecem como version: 5 (ou pooltype: "StablePool") em ApiV3PoolInfoStandardItem; os mesmos helpers addLiquidity / removeLiquidity / swap funcionam para eles como para pools de produto constante AMM v4 (version: 4) — o SDK detecta a variante e emite as instruções corretas automaticamente. A matemática off-chain da curva estável está em src/raydium/liquidity/stable.ts.Configuração
Identificando um pool estável
Dois sinais equivalentes emApiV3PoolInfoStandardItem:
version: 4, produto constante) quanto o Stable AMM (version: 5) fluem através da mesma API LiquidityModule no SDK. Internamente, o módulo despacha para:
InstructionType.AmmV4AddLiquidity/AmmV4RemoveLiquiditypara pools v4InstructionType.AmmV5AddLiquidity/AmmV5RemoveLiquiditypara pools v5 (Stable)
programId do pool (retornado junto com as chaves do pool) diz ao SDK qual programa fazer CPI; você não precisa codificá-lo manualmente.
Encontrar um pool por par de mints
Fazer swap através de um pool estável
O fluxoLiquidityModule.swap tem a mesma forma que para pools v4 — basta passar um objeto pool v5:
programId do pool a partir das chaves do pool e despacha para o programa Stable AMM. Nenhum argumento especial de programId é necessário.
Adicionar e remover liquidez
addLiquidity e removeLiquidity funcionam de forma idêntica em pools v4 e v5:
InstructionType.AmmV5AddLiquidity porque pooltype.includes("StablePool") é verdadeiro. O fluxo removeLiquidity correspondente é simétrico — insira lpAmount e as quantidades mínimas que você aceitará em cada lado.
Helpers de quote off-chain (stable.ts)
Para quoting no lado do servidor ou backtesting, o SDK expõe a matemática underlying da curva estável:ModelDataInfo on-chain é buscado uma única vez por initLayout() e armazenado em cache em raydium.liquidity.stableLayout. Passe as reservas atuais (x, y) e os helpers calculam através de busca binária na tabela de lookup e interpolação linear entre as duas linhas DataElement adjacentes. Veja products/stable/math para o algoritmo underlying.
Roteamento através do AMM Routing (multi-hop / melhor preço)
Se você não quer escolher um local por si mesmo, o programa AMM Routing considerará cada AMM Raydium (v4 / CPMM / CLMM / Stable) e roteará através de qualquer combinação que for melhor:Recomendações
- Para swaps de usuários finais, prefira o fluxo de roteamento
tradeV2. Ele funciona com cada tipo de pool Raydium, incluindo Stable. - Para operações específicas de pool (adicionar / remover LP em um pool Stable conhecido), use o
LiquidityModulediretamente — ele detecta automaticamente pools v5. - Para quoting off-chain / análises, chame
getStablePrice/getDyByDxBaseIn/getDxByDyBaseInapósinitLayout(). Sem tráfego RPC por quote após os dados do modelo serem armazenados em cache. - Não codifique manualmente instruções
SwapBaseInpuras. O programa Stable AMM (derivado de AMM v4) espera 17–19 contas OpenBook para os pontos de entrada de swap V1, com amodel_data_accountinserida entre elas. Os helpers pré-construídos do SDK lidam com cada conta e ordenação corretamente; fazer você mesmo é propenso a erros.
Próximos passos
- Math — como funciona a interpolação da tabela de lookup.
- Instructions — referência completa de instruções.
- AMM Routing — roteamento multi-pool em AMM v4, CPMM, CLMM, Stable.
raydium-sdk-V2/src/raydium/liquidity/liquidity.ts— ponto de entrada do módulo; despacho v4 / v5.raydium-sdk-V2/src/raydium/liquidity/stable.ts—StableLayout,getStablePrice,getDxByDyBaseIn,getDyByDxBaseIn.


