TypeScript SDK

​

インストール

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

​

初期化

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,    // SDK のスタートアップ機能検出 API 呼び出しをスキップ
  blockhashCommitment: "confirmed",
});

​

モジュールファサード

raydium.cpmm       // CPMM pools: createPool, addLiquidity, withdrawLiquidity, swap, ...
raydium.clmm       // CLMM pools: createPool, openPositionFromBase, increasePositionFromBase,
                   //             decreaseLiquidity, harvestAllRewards, swap, limit orders, ...
raydium.liquidity  // AMM v4 pools: computeAmountOut, swap, addLiquidity, removeLiquidity, ...
raydium.farm       // Farm v3/v5/v6: deposit, withdraw, harvestAllRewards, create,
                   //                restartReward(s), addNewRewardToken(s)
raydium.launchpad  // LaunchLab: createLaunchpad, buyToken, buyTokenExactOut, sellToken,
                   //            claimCreatorFee, curve-rule and platform-config builders, ...
raydium.tradeV2    // Multi-pool routing: route discovery, compute, route-execution
raydium.marketV2   // OpenBook market creation (legacy)
raydium.utils1216  // One-off historical-claim helpers
raydium.token      // Token list + metadata: load(), getTokenInfo()
raydium.account    // Wallet token accounts, ATA lookup and creation
raydium.api        // The REST client (fetchPoolById, getCpmmConfigs, fetchLaunchConfigs, ...)

​

トランザクションビルダー

import { Percent } from "@raydium-io/raydium-sdk-v2";

const { execute, builder, transaction, instructionTypes, signers, extInfo } =
  await raydium.cpmm.addLiquidity({
    poolInfo,
    inputAmount,              // BN — one side, not a pair
    baseIn: true,
    slippage: new Percent(1, 100),   // a Percent, not a number
    txVersion: TxVersion.V0,
  });

• execute — 署名 + 送信する便利関数。builder.execute と同等です。
• builder — すべての命令と署名者が蓄積された TxBuilder インスタンス。builder.build() は transaction が単一のレガシー Transaction である TxBuildData を返します。builder.buildV0() は単一の VersionedTransaction を持つ TxV0BuildData を返します。配列を生成するのは buildMultiTx / buildMultiTxV0 のみです。
• transaction — 構築された Transaction / VersionedTransaction。
• instructionTypes / signers — 蓄積された命令ラベルと署名者セット。
• extInfo — 製品固有の追加情報。例えば、cpmm.createPool は extInfo.address.{poolId, lpMint, vaultA, vaultB} を返し、launchpad.createLaunchpad は extInfo.address（LaunchpadPoolInfo に加えて poolId）を返します。

​

なぜ非同期ビルダーなのか？

​

CLMM モジュール追加（最新リリース）

• raydium.clmm.createCustomizablePool — collectFeeOn と dynamicFeeConfig（コンフィグアカウントの PublicKey）を受け入れる createPool のスーパーセット。動的手数料を有効にするのは dynamicFeeConfig を渡すことです。別途の enableDynamicFee フラグも dynamicFeeConfigId もありません。クラシック createPool はデフォルト手数料のプールで機能し続けます。
• raydium.clmm.openLimitOrder — 単一ティックのリミットオーダーを開きます。poolInfo、baseIn（方向）、orderTick、amount を取り、オプションで tickArrayBitmap、noneIndex、ownerInfo を取ります。ティックの量子化にはエクスポートされた getOrderTick({ baseIn, mintADecimal, mintBDecimal, tickSpacing, price }) ヘルパーを使用してください。
• raydium.clmm.increaseLimitOrder / decreaseLimitOrder — 既存オーダーの未充足部分を調整します。どちらも { poolInfo, limitOrder, amount } を取り、decreaseLimitOrder はオプションの slippage を追加します。完全に充足されたオーダーで減少すると InvalidOrderPhase で戻ります。
• raydium.clmm.settleLimitOrder / settleAllLimitOrder — 充足された出力をオーナーの ATA に掃引します。settleLimitOrder は { limitOrder } のみを取ります — poolInfo はありません。オーダーのオーナーまたはプログラムの limit_order_admin キーパーが呼び出すことができます。
• raydium.clmm.closeLimitOrder / closeAllLimitOrder — 完全に決済されたオーダーを閉じてレントを回収します。
• raydium.api.getClmmDynamicConfigs() — 新しい /main/clmm-dynamic-config エンドポイントにヒットする REST ヘルパー。（リミットオーダー設定のヘルパーやエンドポイントは存在しません：リミットオーダーはプールごとの設定アカウントではなく、ティックによってキー付けされます。）

​

一般的な落とし穴

​

1. クラスター不一致

​

2. ATA の事前作成を忘れる

​

3. 古い poolInfo

​

4. プライオリティフィー

const { execute } = await raydium.cpmm.swap({
  poolInfo,
  baseIn,                    // required: which side inputAmount is denominated in
  inputAmount: new BN(...),
  swapResult: ...,           // required: from CurveCalculator.swapBaseInput/Output
  slippage: 0.005,
  txVersion: TxVersion.V0,
  computeBudgetConfig: {
    units: 250_000,          // CU リミット
    microLamports: 50_000,   // CU あたりのプライオリティフィー
  },
});

​

5. スリッページ許容度はプールタイプと一致する必要があります

​

6. BN 対 number

​

バージョニングポリシー

• @raydium-io/raydium-sdk-v2 は Raydium が保守する唯一の SDK です。すべてのドキュメント、デモ、および統合ガイダンスはこれをターゲットとしています。
• 古い v1 パッケージ（@raydium-io/raydium-sdk）は歴史的な理由で npm に存在します。メンテナンスは CPMM と LaunchLab がシップされた後に終了しました（v1 は両方ともサポートを獲得しませんでした）。2024 年以降、v1 リリースはありません。v1 をライフエンドとして扱ってください：新しいコードに使用しないでください。残っている v1 統合を v2 に移行してください。
• SDK v2 は 1.0 未満です。0.x マイナーリリース間の破壊的変更は可能です。検証したバージョンをピン留めし、アップグレード時に GitHub リリースノートを確認してください。

​

アップグレード

1. すべてのミューテーション呼び出しの戻り値の型を再確認してください — 形状変更（例：extInfo）は頻繁に発生します。
2. poolInfo フェッチシグネチャを再生成してください — フィールドが名前変更されている可能性があります。
3. スリッページ処理を再検証してください。SDK はリリース間で自動バウンドとオプトインバウンド動作の間でシフトしています。
4. raydium.tradeV2（ルーティング）を使用する場合、ルート形状を再検証してください — これはサーフェスの最も不安定な部分です。ファサードは trade から tradeV2 に名前変更されており、古い名前はもう存在しません。

​

ヘルプを得る

• GitHub issues — バグと機能リクエストについては github.com/raydium-io/raydium-sdk-V2/issues にファイルしてください。Raydium チームは積極的に監視しています。
• Discord — 同期ヘルプについては discord.gg/raydium の #dev-support チャネル。
• Telegram — raydium.io からリンクされた開発者チャット（未検証の Telegram グループは避けてください）。

​

ポインタ

• sdk-api/rest-api — SDK の HTTP 補完。
• sdk-api/trade-api — サーバー構築スワップトランザクション。
• sdk-api/anchor-idl — プログラム IDL から直接クライアントを再生成。
• sdk-api/python-integration — solana-py 経由の Python 同等物。
• integration-guides/priority-fee-tuning — computeBudgetConfig のサイジング。

• Raydium SDK v2 ソース
• Raydium SDK リリースノート。