メインコンテンツへスキップ

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.

このページは AI による自動翻訳です。すべての内容は英語版を正とします。英語版を表示 →
このスクリプトの動作。 RPC から CPMM プールを読み込み、スリッページ 0.5% でスワップを見積もり、トランザクションを構築し、キーペアで署名して送信します。全体で約 30 行です。

セットアップ

クイックスタート前提条件を読み、RPC_URLKEYPAIR、依存関係がインストールされていることを確認してください。

スクリプト

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}`);

実行

流動性がある CPMM プールを任意に選びます。標準的な SOL/USDC CPMM プールを使った例:
export POOL_ID="<CPMM プール ID を貼り付け — Raydium UI の Pools タブで見つけてください>"
export INPUT_MINT="So11111111111111111111111111111111111111112"
export AMOUNT_RAW="10000000"   # 0.01 SOL

node swap.mjs
期待される出力:
Quote: 10000000 -> 1640000
Fee:   25000
Swap landed: https://solscan.io/tx/4Z9...

動作内容

  1. Raydium.load — SDK を初期化し、グローバル設定を取得してウォレットコンテキストをセットアップします。
  2. getPoolInfoFromRpc — RPC からライブプール状態を直接取得します(API キャッシュからではなく)。高額なスワップの場合は常に最新の状態が必要です。
  3. CurveCalculator.swap — プールのフィーを差し引いた定積型出力を計算します。これはプログラムがオンチェーンで実行する数学と同じなので、オフチェーンとオンチェーンの見積もりを比較できます。
  4. raydium.cpmm.swap — V0 形式(アドレスルックアップテーブル有効)でトランザクションを構築し、明示的なコンピュート予算設定を追加します。コンピュート予算チップは、ネットワークが混雑している期間にトランザクションを送信するのに役立ちます。
  5. execute({ sendAndConfirm: true }) — トランザクションに署名し、送信し、確認を待ちます。

よくあるエラー

  • Pool not foundPOOL_ID が間違っているか、間違ったクラスタを指している(例:mainnet プール ID を devnet RPC で使用)。
  • Insufficient funds for transaction — ウォレットにスワップ入力 + フィー + ATA レント用の SOL が不足している。
  • Slippage tolerance exceeded — 見積もりと実行の間にプールの価格が変動しました。再実行するか、slippage パラメータを引き上げるか、SDK の computeAmountOut を使用して常にリザーブを再取得してください。
  • Token account not initialized — 出力トークンの ATA が存在せず、暗黙的な作成命令は送信されたがなんらかの理由で失敗しました。ウォレットの SOL 残高を確認して再度実行してください。

次へ