ツールチェーン

このページは 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 呼び出し、プログラムのデプロイ。インストール：

# Raydium プログラムが構築およびテストされるバージョン
sh -c "$(curl -sSfL https://release.anza.xyz/v3.1.10/install)"

# またはタグの代わりにチャネルを追跡する
sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)"

確認：

solana --version   # → solana-cli 3.1.10 (... client:Agave)

インストールホストが移動しました。 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 コマンドインストーラーも提供しています：

curl --proto '=https' --tlsv1.2 -sSfL https://solana-install.solana.workers.dev | bash

そのインストーラーは独自の現在の概念を追跡し、Raydium のプログラムがピンしているものとは異なる Anchor を渡す可能性があります — その後 anchor --version を確認してください。

メインネット用に設定：

solana config set --url https://api.mainnet-beta.solana.com
solana config set --keypair ~/.config/solana/id.json
solana-keygen new                           # ウォレットがない場合は作成
solana address                              # あなたの公開鍵

Raydium テスト用には、ほぼ常に資金が供給された devnet ウォレットが必要です：

solana config set --url https://api.devnet.solana.com
solana airdrop 2                            # テスト用に 2 SOL

SPL Token CLI

SPL Token / Token-2022 操作の公式 CLI — ミント作成、トークンミント、転送。インストール（Solana CLI に含まれる）：

spl-token --version

一般的な操作：

spl-token create-token                                  # SPL Token ミントを作成
spl-token create-token --program-id TOKEN_2022 ...      # Token-2022 ミントを作成
spl-token create-account <MINT>                         # ATA を作成
spl-token mint <MINT> 1000                              # ATA に 1000 トークンをミント
spl-token transfer <MINT> 100 <RECIPIENT>               # 100 を転送
spl-token display <ACCOUNT_OR_MINT>                     # 検査

Anchor CLI

Raydium IDL の取得、クライアントの構築、プログラムの検証に必要です。インストール：

cargo install --git https://github.com/solana-foundation/anchor avm --locked --force
avm install 1.0.2
avm use 1.0.2
anchor --version   # → anchor-cli 1.0.2

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 をピンしており、CLMM は 2026-09-30 アップグレードで続き、すべて 0.32.1 からアップグレードされています。avm は複数のバージョンを保持できます。avm use 1.0.2 は anchor build が Raydium のアーティファクトを再現するようにします。Anchor 1.1 と 1.2 が存在し、独自のプログラムに対して正常にビルドされますが、ターゲットプログラムがピンしているものとは異なる anchor-lang マイナーに対してコンパイルされた CPI クレートはリンクされません — sdk-api/rust-cpi を参照してください。

一般的な操作：

anchor idl fetch <PROGRAM_ID> -o program.idl.json       # オンチェーン IDL を取得
anchor idl init -f idl.json <PROGRAM_ID>                # IDL をアップロード
anchor build                                             # ソースからプログラムをビルド

TypeScript セットアップ

Raydium の主要な統合パス。

パッケージ

npm install \
  @solana/web3.js \
  @solana/spl-token \
  @anchor-lang/core \
  @raydium-io/raydium-sdk-v2 \
  bn.js \
  decimal.js

2026 年 9 月時点で一緒に動作することが確認されているバージョン：

パッケージ	バージョン	注記
`@solana/web3.js`	`^1.95`	1.x API。`2.x` / `3.x` は異なる互換性のない API サーフェス。Raydium SDK は 1.x をターゲットにしています。
`@solana/spl-token`	`^0.4.15`	0.4.15 は `createUnwrapLamportsInstruction` を公開しているバージョン — 回収可能なレントを参照してください。
`@anchor-lang/core`	`^1.0`（現在 `1.2.0` に解決）	Anchor 1.x TypeScript クライアント。Raydium 自体のリポジトリは正確に `1.0.2` をピンしています。クライアント側の使用には任意の 1.x が機能しますが、テストスイートと一致させたい場合は `1.0.2` をピンしてください。
`@raydium-io/raydium-sdk-v2`	`0.2.64-alpha`	このドキュメント内のすべてのコードデモが使用するピン。

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

最小限のスクリプト

import { Connection, Keypair } from "@solana/web3.js";
import { Raydium } from "@raydium-io/raydium-sdk-v2";

const connection = new Connection("https://api.mainnet-beta.solana.com", "confirmed");
const owner      = Keypair.fromSecretKey(/* your key */);

const raydium = await Raydium.load({
  connection,
  owner,
  cluster:      "mainnet",
  disableFeatureCheck: true,
});

// `ids` はカンマ区切りリストであり、呼び出しは配列を返します
const [poolInfo] = await raydium.api.fetchPoolById({ ids: "..." });
console.log(poolInfo);

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

Rust セットアップ

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

rustup install 1.91.0           # Raydium プログラムがピンしているもの
rustup default 1.91.0
rustup component add rustfmt clippy
agave-install init 3.1.10       # SBF ツールチェーンが含まれています

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

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

# CPMM および/または CLMM 統合（Anchor 1.0）— 1 つのクレートが両方を取得できます
[dependencies]
anchor-lang     = "=1.0.2"
anchor-spl      = "=1.0.2"
raydium-cp-swap = { git = "https://github.com/raydium-io/raydium-cp-swap", branch = "chore/upgrade-anchor", features = ["cpi"] }
raydium-clmm    = { git = "https://github.com/raydium-io/raydium-clmm",    branch = "chore/upgrade-anchor", features = ["cpi"] }

anchor-lang と anchor-spl を = でターゲットプログラムがピンしているバージョンにピンします。それらの chore/upgrade-anchor ブランチでは、CPMM と CLMM は両方とも =1.0.2 をピンしているため、単一のクレートが両方に CPI できます。両方のリポジトリの master はまだ 0.32.1 をピンしており、master 依存関係をアップグレードブランチ依存関係と混在させるクレートはビルドされません。sdk-api/rust-cpi を参照してください。 "cpi" フィーチャーは CPI ヘルパーを含む cpi モジュールをインポートします（raydium_cp_swap::cpi::swap_base_input(...) を使用できます）。sdk-api/rust-cpi を参照してください。

Python セットアップ

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

パッケージ

pip install solders solana anchorpy

バージョン：

パッケージ	PyPI 名	バージョン
`solders`	`solders`	≥0.29
solana-py	`solana`	≥0.40
`anchorpy`	`anchorpy`	≥0.21

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

最小限のスクリプト

from solana.rpc.async_api import AsyncClient
from solders.keypair import Keypair
from anchorpy import Provider, Wallet, Program

async def main():
    conn = AsyncClient("https://api.mainnet-beta.solana.com")
    owner = Keypair()
    wallet = Wallet(owner)
    provider = Provider(conn, wallet)

    # IDL とプログラムをロード
    with open("cpmm.idl.json") as f:
        idl = json.load(f)
    program = Program(idl, CPMM_PROGRAM_ID, provider)

    pool = await program.account["PoolState"].fetch(pool_id)
    print(pool)

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

RPC エンドポイント

パブリック mainnet RPC（api.mainnet-beta.solana.com）は大幅にレート制限されており、負荷がかかるとスロットルされます。重要な使用法については、プライベートエンドポイントを取得してください：

プロバイダー	注記
Helius	最も人気。寛大な無料ティア。
Triton	エンタープライズ。プレミアム価格、安定。
QuickNode	堅実。サブ秒のレイテンシー。
独自の RPC ノード	ハードウェアで月額約 $500。完全な制御。

設定：

const connection = new Connection("https://mainnet.helius-rpc.com/?api-key=...");

一部の RPC 操作には拡張機能が必要です：

getProgramAccounts — 無制限スキャンは高コスト。一部のプロバイダーはゲートまたはスキャンごとに課金します。
getPriorityFeeEstimate — Helius 固有のエンドポイント。他のプロバイダーには同等のものがあります。
geyser / WebSocket ストリーミング — 低レイテンシーボットに必要。すべてのプロバイダーが公開しているわけではありません。

Devnet と localnet

Devnet

Solana のパブリックテストクラスター。Raydium には部分的な devnet デプロイメントがあります：

テスト用に一部の CPMM プールが存在します。
AMM v4 には履歴 devnet プールがあります。
CLMM にはいくつかのデモプールがあります。
Farm v6 がデプロイされています。

solana config set --url https://api.devnet.solana.com
solana airdrop 2

SDK は cluster: "devnet" を介して devnet をサポートします：

const raydium = await Raydium.load({ connection, owner, cluster: "devnet" });

注意：devnet プールは流動性が薄く、状態が古い可能性があります。価格発見に devnet を頼らないでください。命令フロー構築とテストのみに使用してください。

フォークされた mainnet 状態を使用した localnet

現実的なテストのために、mainnet 状態をローカルバリデーターにフォークします：

solana-test-validator \
  --url https://api.mainnet-beta.solana.com \
  --clone CPMMoo8L3F4NbTegBCKVNunggL7H1ZpdTHKxQB5qKP1C \
  --clone CAMMCzo5YL8w4VFF8KVHrK22GGUsp5VTaW7grrKgrWqK \
  --clone <SOME_POOL_ID> \
  --clone <SOME_MINT_ID>

これは特定のプログラム/アカウント状態をローカルホストにクローンし、自由にトランザクションできます。理想的な用途：

実際の Raydium プログラムに対して CPI 統合をユニットテストする。
修正されたパラメーターでトランザクションを再生してデバッグする。
大規模な合成ボリュームでストレステストする。

Raydium チームは mainnet デプロイ前の回帰テストのために、フォークされた localnet を広範に使用しています。

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

TypeScript 統合スターター

my-raydium-app/
├── package.json
├── tsconfig.json
├── src/
│   ├── swap.ts           # スワップ例
│   ├── add-liquidity.ts
│   └── read-pool.ts
└── .env                  # RPC URL、ウォレットパス

最小限の package.json：

{
  "name": "my-raydium-app",
  "type": "module",
  "scripts": { "swap": "tsx src/swap.ts" },
  "dependencies": {
    "@raydium-io/raydium-sdk-v2": "0.2.64-alpha",
    "@solana/web3.js": "^1.95",
    "@solana/spl-token": "^0.4.15"
  },
  "devDependencies": {
    "@types/node": "^20",
    "tsx": "^4",
    "typescript": "^5"
  }
}

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

my-raydium-cpi/
├── Anchor.toml
├── Cargo.toml
├── programs/
│   └── my-cpi/
│       ├── Cargo.toml
│       └── src/lib.rs
└── tests/
    └── my-cpi.ts

Anchor 1.0 を使用：

anchor init my-raydium-cpi
cd my-raydium-cpi
# Cargo.toml に raydium-cp-swap を features = ["cpi"] で追加
anchor build
anchor test

便利な CLI ユーティリティ

`solana-keygen`

solana-keygen new --outfile ./wallet.json          # キーを生成
solana-keygen pubkey ./wallet.json                 # 公開鍵を表示

任意のアカウントを読む

solana account <ADDRESS> --output json-compact

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

プログラムログ

solana logs | grep CPMMoo                         # CPMM 関連の tx ログをテール

トランザクション検査

solana confirm <TX_SIGNATURE> -v                   # ログをきれいに出力

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

環境衛生

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

開発ウォレット：testnet SOL を保持、構築に使用。
本番ウォレット：実際の SOL を保持、デプロイ/マルチシグ送信のみに使用。
ボット用ホットウォレット：小額残高、限定的な権限。

キーはハードコードされるべきではありません。環境変数またはシークレットマネージャーを使用してください。

`.env` パターン

# .env（コミットされない）
SOLANA_RPC_URL=https://mainnet.helius-rpc.com/?api-key=...
WALLET_PATH=/Users/you/.config/solana/id.json

import { config } from "dotenv";
config();

const connection = new Connection(process.env.SOLANA_RPC_URL!);

バージョンピン

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

ポインター

sdk-api/typescript-sdk — TypeScript SDK リファレンス。
sdk-api/rust-cpi — Rust CPI 使用法。
sdk-api/python-integration — Python セットアップ。
solana-fundamentals/programs-and-anchor — Anchor 背景。

ソース：

Solana インストールドキュメントおよび Agave CLI インストール。
Anchor インストール。
Raydium SDK v2 リポジトリ。

Solana の基礎

クイックスタート

SDK と API

統合ガイド

ツールチェーン

コアツール

Solana CLI

SPL Token CLI

Anchor CLI

TypeScript セットアップ

パッケージ

最小限のスクリプト

Rust セットアップ