Skip to main content
このページは AI による自動翻訳です。すべての内容は英語版を正とします。英語版を表示 →
このドキュメント全体は、動作する Solana 開発ツールチェーンがあることを前提としています。このページでは、ツール、2026 年 9 月時点で Raydium と連携することが確認されているバージョン、および特定のセットアップの注意点をリストアップしています。後の章のコード例を実行する前に、ここから始めてください。 2 つのバージョンセットが重要であり、それらは同じではありません。 Raydium プログラムを構築またはフォークするには、プログラムがピンしている正確なツールチェーン(Rust 1.91.0、Agave 3.1.10、Anchor 1.0.2(2026-09-09 アップグレード時点))が必要です。TypeScript または Python からデプロイされたプログラムに対して統合するには、それらと通信するのに十分な最新のクライアント ライブラリのみが必要であり、ピンは参考情報です。以下の各セクションでは、どのケースをカバーしているかを示しています。

コアツール

Solana CLI

Solana クラスタと対話するための標準的なコマンドラインインターフェース — ウォレット管理、RPC 呼び出し、プログラムのデプロイ。 インストール:
確認:
インストールホストが移動しました。 release.solana.com は Solana Labs に属していましたが、クライアントは現在 Anza によって Agave として保守されており、リリースは release.anza.xyz から提供されています。自己更新バイナリは agave-install です(solana-install はレガシー エイリアスとして保持されています)。したがって、agave-install update と agave-install init <version> が現在のスペルです。Solana 自体のドキュメントでは、CLI、Rust、Anchor をまとめてプルする 1 コマンド インストーラーも提供しています:
そのインストーラーは独自の現在の概念を追跡し、Raydium のプログラムがピンしているものとは異なる Anchor を提供する可能性があります — その後、anchor --version を確認してください。
メインネット用に設定:
Raydium テスト用には、ほぼ常に資金提供されたデブネット ウォレットが必要です:

SPL Token CLI

SPL Token / Token-2022 操作用の公式 CLI — ミント作成、トークンミント、転送。 インストール(Solana CLI に含まれています):
一般的な操作:

Anchor CLI

Raydium IDL の取得、クライアントの構築、プログラムの検証に必要です。 インストール:
Anchor がリポジトリとメジャーバージョンを移動しました。 標準的なリポジトリは現在 github.com/solana-foundation/anchor です(以前は coral-xyz/anchor)。Anchor 1.0 は Raydium プログラムが使用する最初のリリース ラインです — CPMM と LaunchLab は両方とも 2026-09-09 アップグレード時点で anchor-lang/anchor-spl =1.0.2 をピンしており、0.32.1 からアップグレードされています。avm は複数のバージョンを保持できます。avm use 1.0.2 は anchor build が Raydium のアーティファクトを再現するようにします。Anchor 1.1 と 1.2 が存在し、独自のプログラムに対して正常にビルドされますが、ターゲット プログラムがピンしているものとは異なる anchor-lang マイナーに対してコンパイルされた CPI クレートはリンクされません — sdk-api/rust-cpi を参照してください。
一般的な操作:

TypeScript セットアップ

Raydium の主要な統合パス。

パッケージ

2026 年 9 月時点で一緒に動作することが確認されているバージョン:
@coral-xyz/anchor は凍結されています。パッケージは現在 @anchor-lang/core です。 @coral-xyz/anchor は Anchor が Coral から移動したときに 0.32.1 で停止しました。Anchor 1.x は @anchor-lang/core として公開され、Raydium 独自のプログラム リポジトリは 2026-09-09 アップグレードでテスト スイートをそれに切り替えました。実際に使用するインポートは変わりません — import { Program, BN, AnchorProvider } from "@anchor-lang/core" — したがって、移行はパッケージ名の変更とロックファイルの更新です。0.3x から移動する場合の 2 つの動作上の注記:.accounts({...}) は現在、Anchor が自身で解決できないアカウントのみを受け入れるため、完全なセットを渡すビルダーは代わりに .accountsPartial({...}) を呼び出す必要があります。また、@anchor-lang/core/dist/cjs/utils/token は ASSOCIATED_PROGRAM_ID などのヘルパーが移動した場所です。

最小限のスクリプト

完全な SDK リファレンスについては、sdk-api/typescript-sdk を参照してください。

Rust セットアップ

CPI 統合とオンチェーン プログラム用。

ツールチェーン

cargo build-sbf でプログラムをビルドします(古い cargo build-bpf スペルは廃止されました)。

Raydium CPI 統合用のプログラム Cargo.toml

anchor-lang と anchor-spl を = でターゲット プログラムがピンしているバージョンにピンします。2026-09 時点で CPMM は =1.0.2 をピンし、CLMM はまだ =0.32.1 をピンしているため、単一のクレートは両方に CPI できません — sdk-api/rust-cpi を参照してください。 "cpi" フィーチャーは CPI ヘルパーを含む cpi モジュールをインポートします(raydium_cp_swap::cpi::swap_base_input(...) を使用できます)。sdk-api/rust-cpi を参照してください。

Python セットアップ

二次的な統合パス — ボット開発者に一般的です。

パッケージ

バージョン:
2 つの命名トラップがあります。RPC クライアントは solana としてインポートされますが、プロジェクトは solana-py と呼ばれています — pip install solana-py は何も有用なものをインストールしません。また、PyPI に raydium-py パッケージはありません:コミュニティ Raydium ヘルパーはクローンするリポジトリ AL-THE-BOT-FATHER/raydium_py であり、公開されたディストリビューションではありません。このページの以前のリビジョンでは、決して機能しなかった pip install raydium-py 行をリストアップしていました。

最小限のスクリプト

sdk-api/python-integration を参照してください。

RPC エンドポイント

パブリック メインネット RPC(api.mainnet-beta.solana.com)は大幅にレート制限されており、負荷がかかると調整されます。重要な使用法については、プライベート エンドポイントを取得してください: 設定:
一部の RPC 操作には拡張機能が必要です:
  • getProgramAccounts — 無制限スキャンは高コスト。一部のプロバイダーはゲートまたはスキャンごとに課金します。
  • getPriorityFeeEstimate — Helius 固有のエンドポイント。他のプロバイダーには同等のものがあります。
  • geyser / WebSocket ストリーミング — 低レイテンシ ボットに必要。すべてのプロバイダーが公開しているわけではありません。

Devnet と Localnet

Devnet

Solana のパブリック テスト クラスタ。Raydium には部分的な devnet デプロイメントがあります:
  • テスト用に一部の CPMM プールが存在します。
  • AMM v4 には履歴 devnet プールがあります。
  • CLMM にはいくつかのデモ プールがあります。
  • Farm v6 がデプロイされています。
SDK は cluster: "devnet" を介して devnet をサポートします:
注意:devnet プールは流動性が薄く、状態が古い可能性があります。価格発見に devnet を使用しないでください。命令フロー構築とテストのみに使用してください。

フォークされたメインネット状態を使用した Localnet

現実的なテストのために、メインネット状態をローカル バリデーターにフォークします:
これにより、特定のプログラム/アカウント状態をローカルホストにクローンし、自由にトランザクションできます。理想的な用途:
  • 実際の Raydium プログラムに対して CPI 統合をユニット テストする。
  • 修正されたパラメーターでトランザクションを再生してデバッグする。
  • 大規模な合成ボリュームでストレス テストする。
Raydium チームは、メインネット デプロイ前の回帰テストのために、フォークされた localnet を広範に使用しています。

プロジェクト テンプレート

TypeScript 統合スターター

最小限の package.json:

Anchor CPI プログラム スターター

Anchor 1.0 を使用:

便利な CLI ユーティリティ

solana-keygen

任意のアカウントを読む

デコーダーなしでプール状態を確認するのに便利です。

プログラム ログ

トランザクション検査

または explorer 経由 — シグネチャを貼り付けて「Program Logs」タブを確認します。

環境衛生

目的ごとに別々のウォレット

  • 開発ウォレット:テストネット SOL を保持、構築に使用。
  • 本番ウォレット:実際の SOL を保持、デプロイ/マルチシグ送信のみに使用。
  • ボット用ホット ウォレット:小額残高、限定的なアクセス許可。
キーはハードコードされるべきではありません。環境変数またはシークレット マネージャーを使用してください。

.env パターン

バージョン ピンニング

すべての Solana エコシステム依存関係をロックします。エコシステムは急速に動きます。@solana/web3.js のマイナー バージョン バンプは以前に破壊的な変更を導入しています。package-lock.json / Cargo.lock を宗教的に使用してください。

ポインター

ソース: