SDK TypeScript

​

Instalar

npm install @raydium-io/raydium-sdk-v2 @solana/web3.js @solana/spl-token
# ou
pnpm add @raydium-io/raydium-sdk-v2 @solana/web3.js @solana/spl-token

​

Inicializar

import { Raydium } from "@raydium-io/raydium-sdk-v2";
import { Connection, Keypair, clusterApiUrl } from "@solana/web3.js";

const connection = new Connection(process.env.RPC_URL ?? clusterApiUrl("mainnet-beta"));
const owner      = Keypair.fromSecretKey(/* ... */);

const raydium = await Raydium.load({
  owner,
  connection,
  cluster: "mainnet",           // "mainnet" | "devnet"
  disableFeatureCheck: true,    // pula a chamada de API de detecção de recursos do SDK na inicialização
  blockhashCommitment: "confirmed",
});

​

As quatro fachadas de módulos

raydium.cpmm       // Pools CPMM: createPool, addLiquidity, withdrawLiquidity, swap, ...
raydium.clmm       // Pools CLMM: createPool, openPositionFromBase, increasePositionFromBase,
                   //             decreaseLiquidity, harvestAllRewards, swap, ...
raydium.liquidity  // Pools AMM v4: computeAmountOut, swap, addLiquidity, removeLiquidity, ...
raydium.farm       // Farm v3/v5/v6: deposit, withdraw, harvestAllRewards, create, setRewards
raydium.launchpad  // LaunchLab: createLaunchpad, buyExactIn, sellExactIn, graduate, ...
raydium.trade      // Roteamento multi-pool: quotes, route-execution (beta em 0.2.41)
raydium.token      // Helpers: obter lista de tokens, metadados, criação de ATA

​

Construtores de transações

const { execute, builder, transaction, innerTransactions, extInfo } =
  await raydium.cpmm.addLiquidity({
    poolInfo,
    amountInA,
    amountInB,
    slippage: 0.005,
    txVersion: TxVersion.V0,
  });

• execute — uma função de conveniência que assina + envia. Equivalente a builder.execute.
• builder — a instância TxBuilder com todas as instruções e signatários acumulados. Chame .build() para obter um VersionedTransaction[]; útil quando você precisa injetar suas próprias instruções ou assinar com signatários externos.
• transaction / innerTransactions — os arrays de instruções brutos. Use ao construir transações multi-programa compostas.
• extInfo — extras específicos do produto. Por exemplo, createPool retorna extInfo.poolId; createLaunchpad retorna o novo PDA de estado de lançamento.

​

Por que builders assíncronos?

​

Adições do módulo CLMM (release mais recente)

• raydium.clmm.createCustomizablePool — superconjunto de createPool que aceita collectFeeOn, enableDynamicFee e dynamicFeeConfigId. Use isso para qualquer novo pool que precise dos novos controles; createPool clássico continua funcionando para pools com taxa padrão.
• raydium.clmm.openLimitOrder — abra uma ordem limitada de um único tick em um pool que as suporte. Leva poolInfo, poolKeys, limitOrderConfig (de /main/clmm-limit-order-config), inputMint, inputAmount e o tick alvo.
• raydium.clmm.increaseLimitOrder / decreaseLimitOrder — ajuste a porção não preenchida de uma ordem existente. Diminuir reverte em uma ordem totalmente preenchida com InvalidOrderPhase.
• raydium.clmm.settleLimitOrder / settleAllLimitOrder — varre a saída preenchida para o ATA do proprietário. Tanto o proprietário da ordem quanto o keeper limit_order_admin do pool podem chamá-los.
• raydium.clmm.closeLimitOrder / closeAllLimitOrder — feche ordens totalmente liquidadas para recuperar aluguel.
• raydium.api.getClmmDynamicConfigs() / getClmmLimitOrderConfigs() — helpers REST que acessam os novos endpoints /main/clmm-dynamic-config e /main/clmm-limit-order-config.

​

Armadilhas comuns

​

1. Incompatibilidade de cluster

​

2. Esquecer de pré-criar ATAs

​

3. poolInfo obsoleto

​

4. Taxas de prioridade

const { execute } = await raydium.cpmm.swap({
  poolInfo,
  inputAmount: new BN(...),
  swapResult: ...,
  slippage: 0.005,
  txVersion: TxVersion.V0,
  computeBudgetConfig: {
    units: 250_000,          // Limite de CU
    microLamports: 50_000,   // Taxa de prioridade por CU
  },
});

​

5. A tolerância de slippage deve corresponder ao tipo de pool

​

6. BN vs number

​

Política de versionamento

• @raydium-io/raydium-sdk-v2 é o único SDK que Raydium mantém. Todos os docs, demos e orientação de integração o direcionam.
• Um pacote v1 mais antigo (@raydium-io/raydium-sdk) existe no npm por razões históricas. A manutenção terminou após CPMM e LaunchLab serem lançados (v1 nunca ganhou suporte para nenhum dos dois), e não houve releases v1 desde 2024. Trate v1 como fim de vida: não o use para novo código e migre qualquer integração v1 restante para v2.
• SDK v2 está em pré-1.0. Mudanças quebradas entre releases menores 0.x são possíveis; fixe a versão que você verificou e verifique as notas de release do GitHub ao atualizar.

​

Atualizando

1. Re-verifique o tipo de retorno de toda chamada mutante — mudanças de forma (ex. extInfo) chegam frequentemente.
2. Regenere assinaturas de busca de poolInfo — um campo pode ter sido renomeado.
3. Re-verifique seu tratamento de slippage; o SDK mudou entre comportamentos de auto-bound e opt-in bound entre releases.
4. Se você usar raydium.trade (roteamento), re-verifique a forma da rota — é a parte mais instável da superfície.

​

Obtendo ajuda

• GitHub issues — arquivo em github.com/raydium-io/raydium-sdk-V2/issues para bugs e solicitações de recursos. O time Raydium monitora ativamente.
• Discord — canal #dev-support em discord.gg/raydium para ajuda síncrona.
• Telegram — chat de desenvolvedor vinculado de raydium.io (evite grupos Telegram não verificados).

​

Referências

• sdk-api/rest-api — o complemento HTTP do SDK.
• sdk-api/trade-api — transações de swap construídas pelo servidor.
• sdk-api/anchor-idl — regenerando clientes diretamente de IDLs de programa.
• sdk-api/python-integration — equivalente em Python via solana-py.
• integration-guides/priority-fee-tuning — dimensionando computeBudgetConfig.

• Fonte do Raydium SDK v2
• Notas de release do Raydium SDK.