TypeScript SDK

このページは AI による自動翻訳です。すべての内容は英語版を正とします。英語版を表示 →

バージョン情報。 このページは @raydium-io/raydium-sdk-v2@0.2.42-alpha を対象としています。このバージョンは本サイトのすべてのコード例で検証済みです（2026-04）。SDK は 1.0 未満であり、型サーフェスはリリース間で進化しています — バージョンをピンで固定してください。

インストール

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

SDK は TypeScript で書かれており、JS アーティファクトと一緒に .d.ts を提供しています。最小ツールチェーン：Node 18+、TypeScript 5.0+、moduleResolution: "bundler" または "node16"。

初期化

エントリーポイントは Raydium.load です：

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.load は非同期です。スタートアップ時に api-v3.raydium.io から小さな /config ペイロードを取得します（現在の AmmConfig アカウント、フィーティアなどをリスト）。オフライン環境では disableFeatureCheck: true を設定してください。これらの値をいくつかのビルダーに手動で供給する必要があります。

4 つのモジュールファサード

ロード後、raydium オブジェクトは 4 つのモジュールファサードを公開します（製品サーフェスごとに 1 つ）：

raydium.cpmm       // CPMM プール：createPool、addLiquidity、withdrawLiquidity、swap、...
raydium.clmm       // CLMM プール：createPool、openPositionFromBase、increasePositionFromBase、
                   //             decreaseLiquidity、harvestAllRewards、swap、...
raydium.liquidity  // AMM v4 プール：computeAmountOut、swap、addLiquidity、removeLiquidity、...
raydium.farm       // ファーム v3/v5/v6：deposit、withdraw、harvestAllRewards、create、setRewards
raydium.launchpad  // LaunchLab：createLaunchpad、buyExactIn、sellExactIn、graduate、...
raydium.trade      // マルチプール ルーティング：quotes、route-execution（0.2.41 ではベータ版）
raydium.token      // ヘルパー：トークンリスト取得、メタデータ、ATA 作成

（実は 5 つのファサードが合計で存在します — 「4 つ」は Raydium が公開でグループ化する方法で、trade と token は補助ユーティリティとしています。）

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

変更する関数はすべてビルダーを返し、即座には実行しません：

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

返されたフィールド：

execute — 署名と送信を行う便利関数。builder.execute と同等です。
builder — 累積されたすべての命令と署名者を持つ TxBuilder インスタンス。.build() を呼び出して VersionedTransaction[] を取得します。独自の命令を挿入したり、外部署名者で署名する必要がある場合に便利です。
transaction / innerTransactions — 生の命令配列。複合マルチプログラムトランザクションを構築するときに使用します。
extInfo — 製品固有のエクストラ。たとえば、createPool は extInfo.poolId を返します。createLaunchpad は新しいローンチ状態 PDA を返します。

txVersion はレガシー vs V0 トランザクションフォーマットを制御します。V0（アドレス参照テーブル）がデフォルトの推奨です — より大きなスワップを 1 つのトランザクションに収めることができます。

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

ほぼすべてのビルダーは内部的にオンチェーン状態を取得します：プール情報（見積もり用）、トークンプログラム所有権（Token-2022 vs SPL ルーティング）、アカウントソル払い例外（ATA 作成用）など。SDK は積極的にキャッシュしていますが、新しいプール用の最初の呼び出しは RPC ラウンドトリップを伴います。再取得を避けるために、長寿命の raydium インスタンスを保持してください。

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

CLMM ファサードは、新しい動的フィー、単一方向フィー、リミットオーダー機能のサーフェスを獲得しました：

raydium.clmm.createCustomizablePool — collectFeeOn、enableDynamicFee、dynamicFeeConfigId を受け入れる createPool のスーパーセット。新しいノブが必要な新しいプールにこれを使用してください。クラシック createPool は引き続きデフォルトフィーのプールで機能します。
raydium.clmm.openLimitOrder — リミットオーダーをサポートするプール上に単一ティックリミットオーダーを開きます。poolInfo、poolKeys、limitOrderConfig（/main/clmm-limit-order-config から）、inputMint、inputAmount、およびターゲット tick をとります。
raydium.clmm.increaseLimitOrder / decreaseLimitOrder — 既存オーダーの未約定部分を調整します。完全に約定したオーダーで減少すると InvalidOrderPhase でリバートします。
raydium.clmm.settleLimitOrder / settleAllLimitOrder — 約定済み出力をオーナーの ATA に確定します。オーダーのオーナーまたはプールの limit_order_admin キーパーが呼び出すことができます。
raydium.clmm.closeLimitOrder / closeAllLimitOrder — 完全に決済されたオーダーを閉じてレントを回復します。
raydium.api.getClmmDynamicConfigs() / getClmmLimitOrderConfigs() — 新しい /main/clmm-dynamic-config と /main/clmm-limit-order-config エンドポイントをヒットする REST ヘルパー。

小規模な再構成により、utils/ を libraries/ に移動しました。@raydium-io/raydium-sdk-v2/utils/... からインポートしたコードは @raydium-io/raydium-sdk-v2/libraries/... に切り替える必要があります。トップレベルパッケージバレルは変更されていないため、ほとんどのユーザーは名前変更を認識しません。エンドツーエンド TypeScript ウォークスルーは products/clmm/code-demos にあります。

よくある落とし穴

1. クラスター不一致

SDK のスタートアップ設定はクラスター固有です。cluster: "mainnet" を devnet Connection と混ぜると、サイレントミスルーティングが発生します：SDK は mainnet AmmConfig に対して見積もりを取得しますが devnet に送信します。両方を常に渡してください。

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

ミントとの初回インタラクション時に、ユーザーの関連トークンアカウントが存在しない場合があります。SDK は、欠落 ATA を検出すると自動的に AssociatedTokenAccount::create 命令を先頭に追加します。これにより少量のレント費用が発生します。ウォレットが SOL 不足の場合、これはサイレント失敗します。再試行する前にチェックして資金を提供してください。

3. 古い `poolInfo`

poolInfo はキャッシュされたスナップショットです。取得後、プール状態が変わった場合（大きなトレードが価格を動かしたなど）、スワップの minAmountOut は古い状態に対して計算され、オンチェーンの amoount-out を下回り、リバートする可能性があります。高額トランザクション構築前に直ちに poolInfo を再取得するか、SDK の computeAmountOut を使用してください。これにより準備金が再クエリされます。

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

SDK はデフォルトでは計算ユニット価格を追加しません。高容量ウィンドウ（新規プール発表、ミームコインイベント）では、トランザクションは多くのものと競争し、着地しない可能性があります。明示的な computeBudgetConfig を提供してください：

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

サイジングガイダンスについては integration-guides/priority-fee-tuning を参照してください。

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

CPMM と AMM v4 は CPMM 数学です（通常のトレードの影響が低い）。CLMM は区分別です（ティッククロッシングで影響がジャンプ）。CPMM の例から 0.5% スリッページ許容度をコピーして、複数のティックをクロスする CLMM スワップに入れると、トランザクションはリバートする可能性が高いです。SDK の computeAmountOut は priceImpact を返します。許容度をそれより大きくサイズしてください。

6. `BN` vs `number`

SDK 内のすべての金額フィールドは bn.js BN インスタンスです — JavaScript number ではありません。.toNumber() 経由で金額値を変換すると 2^53 でサイレント切り詰めが発生します。約 9 クアドリリオン以上の値（9 進プール上では一般的）の場合、これは間違った結果を生成します。最終 UI レンダーまですべてを BN で保持してください。

バージョニングポリシー

@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 リリースノートを確認してください。

アップグレード

SDK マイナーバージョン間でアップグレードする場合：

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

ヘルプを得る

SDK と API に関する質問の場合：

GitHub issues — github.com/raydium-io/raydium-sdk-V2/issues でバグとフィーチャーリクエストをファイルしてください。Raydium チームは積極的に監視しています。
Discord — discord.gg/raydium の #dev-support チャネルで同期サポートを受けてください。
Telegram — raydium.io からリンクされているデベロッパーチャット（未検証 Telegram グループは避けてください）。

セキュリティ問題の場合は、公開チャネルに投稿しないでください — security/disclosure を参照してください。

ポインタ

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 source
Raydium SDK リリースノート。

Solana の基礎

クイックスタート

SDK と API

統合ガイド

インストール

初期化

4 つのモジュールファサード

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

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

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

よくある落とし穴

1. クラスター不一致

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

3. 古い `poolInfo`

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

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

6. `BN` vs `number`

バージョニングポリシー

アップグレード

ヘルプを得る

ポインタ

Solana の基礎

クイックスタート

SDK と API

統合ガイド

Documentation Index

​インストール

​初期化

​4 つのモジュールファサード

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

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

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

​よくある落とし穴

​1. クラスター不一致

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

​3. 古い poolInfo

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

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

​6. BN vs number

​バージョニング ポリシー

​アップグレード

​ヘルプを得る

​ポインタ

インストール

初期化

4 つのモジュールファサード

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

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

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

よくある落とし穴

1. クラスター不一致

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

3. 古い `poolInfo`

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

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

6. `BN` vs `number`

バージョニングポリシー

アップグレード

ヘルプを得る

ポインタ