Swap a partir da CLI

Script Node pronto para usar que faz cotação e executa um swap CPMM. Configure quatro variáveis de ambiente e execute.

Esta página foi traduzida automaticamente por IA. A versão em inglês é a fonte oficial.

Ver versão em inglês →

O que faz. Carrega um pool CPMM a partir do RPC, faz cotação de um swap com slippage de 0,5%, constrói a transação, assina com sua keypair e a submete. Tudo em ~30 linhas.

​

Configuração

Certifique-se de ter lido os pré-requisitos do Início Rápido e tenha RPC_URL, KEYPAIR e as dependências instaladas.

​

O script

Salve como swap.mjs:

// swap.mjs
import { Connection, Keypair, PublicKey } from "@solana/web3.js";
import { Raydium, TxVersion, CurveCalculator } from "@raydium-io/raydium-sdk-v2";
import BN from "bn.js";
import fs from "node:fs";

// ── Config from env ──────────────────────────────────────────────
const RPC_URL    = process.env.RPC_URL    ?? "https://api.mainnet-beta.solana.com";
const KEYPAIR    = process.env.KEYPAIR    ?? `${process.env.HOME}/.config/solana/id.json`;
const POOL_ID    = process.env.POOL_ID;     // required, base58
const INPUT_MINT = process.env.INPUT_MINT;  // required, base58
const AMOUNT_RAW = process.env.AMOUNT_RAW;  // required, integer in raw units (e.g. 1_000_000_000 for 1 SOL)

if (!POOL_ID || !INPUT_MINT || !AMOUNT_RAW) {
  console.error("Set POOL_ID, INPUT_MINT, AMOUNT_RAW env vars.");
  process.exit(1);
}

// ── Setup ────────────────────────────────────────────────────────
const connection = new Connection(RPC_URL, "confirmed");
const owner = Keypair.fromSecretKey(
  new Uint8Array(JSON.parse(fs.readFileSync(KEYPAIR, "utf8"))),
);
const raydium = await Raydium.load({
  owner,
  connection,
  cluster: "mainnet",
  disableFeatureCheck: true,
  blockhashCommitment: "finalized",
});

// ── Load pool ────────────────────────────────────────────────────
const { poolInfo, poolKeys, rpcData } =
  await raydium.cpmm.getPoolInfoFromRpc(new PublicKey(POOL_ID));

const baseIn = poolInfo.mintA.address === INPUT_MINT;

// ── Quote ────────────────────────────────────────────────────────
const inputAmount = new BN(AMOUNT_RAW);
const swapResult  = CurveCalculator.swap(
  inputAmount,
  baseIn ? rpcData.baseReserve : rpcData.quoteReserve,
  baseIn ? rpcData.quoteReserve : rpcData.baseReserve,
  rpcData.configInfo.tradeFeeRate,
);

console.log(`Quote: ${inputAmount.toString()} -> ${swapResult.destinationAmountSwapped.toString()}`);
console.log(`Fee:   ${swapResult.tradeFee.toString()}`);

// ── Build and execute ────────────────────────────────────────────
const { execute } = await raydium.cpmm.swap({
  poolInfo,
  poolKeys,
  inputAmount,
  swapResult,
  slippage: 0.005, // 0.5%
  baseIn,
  txVersion: TxVersion.V0,
  computeBudgetConfig: {
    units: 250_000,
    microLamports: 50_000,
  },
});

const { txId } = await execute({ sendAndConfirm: true });
console.log(`Swap landed: https://solscan.io/tx/${txId}`);

​

Execute

Escolha qualquer pool CPMM que você tenha liquidez. Exemplo com o pool canônico SOL/USDC CPMM:

export POOL_ID="<cole um ID de pool CPMM — encontre um na aba Pools da interface Raydium>"
export INPUT_MINT="So11111111111111111111111111111111111111112"
export AMOUNT_RAW="10000000"   # 0.01 SOL

node swap.mjs

Saída esperada:

Quote: 10000000 -> 1640000
Fee:   25000
Swap landed: https://solscan.io/tx/4Z9...

​

O que acabou de acontecer

1. Raydium.load inicializa o SDK — busca a configuração global e configura o contexto da sua carteira.
2. getPoolInfoFromRpc puxa o estado live do pool diretamente do RPC (não do cache da API). Para swaps de alto valor, você sempre quer estado fresco.
3. CurveCalculator.swap calcula a saída do produto constante descontando a taxa do pool. É a mesma matemática que o programa executa on-chain, então você pode comparar cotações off- e on-chain.
4. raydium.cpmm.swap constrói a transação no formato V0 (tabelas de lookup de endereço habilitadas) e adiciona uma configuração explícita de orçamento de computação. A dica de orçamento de computação ajuda a transação a pousar em janelas ocupadas.
5. execute({ sendAndConfirm: true }) assina, envia e aguarda confirmação.

​

Erros comuns

• Pool not found — POOL_ID incorreto, ou você está apontando para o cluster errado (ID de pool mainnet contra RPC devnet, etc.).
• Insufficient funds for transaction — Sua carteira não tem SOL suficiente para a entrada do swap + taxas + aluguel ATA.
• Slippage tolerance exceeded — O preço do pool mudou entre cotação e execução. Execute novamente; ou aumente o parâmetro slippage; ou use o computeAmountOut do SDK que sempre re-busca as reserves.
• Token account not initialized — O ATA do token de saída não existia e a instrução de criação implícita pousou mas falhou por algum motivo; verifique seu saldo de SOL na carteira e tente novamente.

​

Próximos passos

• sdk-api/typescript-sdk — referência completa do SDK.
• products/cpmm/instructions — como é a instrução de swap on-chain.
• integration-guides/priority-fee-tuning — dimensionando computeBudgetConfig para produção.