インストール

このセクションでは、Solana開発のためのローカル環境をセットアップする手順を説明します。

クイックインストール

MacとLinuxでは、以下の単一コマンドを実行して、すべての依存関係をインストールします。

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

Windowsユーザー:まずWSLをインストールする必要があります(依存関係のインストールを参照)。その後、Ubuntu(Linux)ターミナルで前述のコマンドを実行してください。

インストール後、次のような出力が表示されるはずです:

Installed Versions:
Rust: rustc 1.86.0 (05f9846f8 2025-03-31)
Solana CLI: solana-cli 2.2.12 (src:0315eb6a; feat:1522022101, client:Agave)
Anchor CLI: anchor-cli 0.31.1
Node.js: v23.11.0
Yarn: 1.22.1

クイックインストールコマンドが機能しない場合は、以下の依存関係のインストールセクションを参照して、各依存関係を個別にインストールする手順を確認してください。

クイックインストールコマンドが正常に実行された場合は、以下のSolana CLIの基本Anchor CLIの基本セクションにスキップしてください。

依存関係のインストール

以下の手順では、各依存関係を個別にインストールする方法を説明します。

  • Windowsユーザーは、まずWSL(Windows Subsystem for Linux)をインストールし、その後、以下のLinuxセクションで指定されている依存関係をインストールする必要があります。
  • Linuxユーザーは、まず以下のLinuxセクションで指定されている依存関係をインストールする必要があります。
  • Macユーザーは、以下のRustインストール手順から始めてください。

Rustをインストールする

開発者はRustプログラミング言語を使用してSolanaプログラムを構築します。

rustupを使用してRustをインストールします。

Rustをインストールするには、次のコマンドを実行します:

Terminal
$
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y

インストールが完了すると、次のメッセージが表示されるはずです:

CargoのbinディレクトリをPATH環境変数に含めるために、次のコマンドを実行してPATHを再読み込みします:

Terminal
$
. "$HOME/.cargo/env"

インストールが成功したことを確認するために、Rustのバージョンを確認してください:

Terminal
$
rustc --version

以下のような出力が表示されるはずです:

rustc 1.86.0 (05f9846f8 2025-03-31)

Solana CLIのインストール

Solana CLIは、Solanaプログラムを構築およびデプロイするために必要なすべてのツールを提供します。

公式のインストールコマンドを使用してSolana CLIツールスイートをインストールします:

Terminal
$
sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)"

stableを、希望するリリースのソフトウェアバージョンに一致するリリースタグ(例:v2.0.3)に置き換えるか、3つのシンボリックチャネル名のいずれかを使用できます:stablebeta、またはedge

Solana CLIを初めてインストールする場合、PATH環境変数を追加するよう促す次のようなメッセージが表示されることがあります:

Close and reopen your terminal to apply the PATH changes or run the following in your existing shell:
export PATH="/Users/test/.local/share/solana/install/active_release/bin:$PATH"

LinuxまたはWSLを使用している場合は、Solana CLIバイナリをPATHに追加して、ターミナルでコマンドが使用できるようにする必要があります。

まず、次のコマンドを実行して、使用しているシェルを確認します:

Terminal
$
echo $SHELL
  • 出力に/bashが含まれている場合は、.bashrcを使用します。
  • 出力に/zshが含まれている場合は、.zshrcを使用します。

シェルに応じて、適切なコマンドを実行してください。

Bash(bashrc)の場合:

Terminal
$
echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.bashrc
$
source ~/.bashrc

Zsh(zshrc)の場合:

Terminal
$
echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.zshrc
$
source ~/.zshrc

その後、以下のコマンドを実行してターミナルセッションを更新するか、ターミナルを再起動してください。

Terminal
$
source ~/.bashrc # If using Bash
$
source ~/.zshrc # If using Zsh

インストールが成功したことを確認するには、Solana CLIのバージョンを確認します:

Terminal
$
solana --version

次のような出力が表示されるはずです:

solana-cli 2.2.12 (src:0315eb6a; feat:1522022101, client:Agave)

利用可能なすべてのバージョンはAgave Githubリポジトリで確認できます。

AgaveはAnzaのvalidatorクライアントで、以前はSolana Labs validatorクライアントとして知られていました。

後日、Solana CLIを最新バージョンに更新するには、次のコマンドを使用できます:

Terminal
$
agave-install update

Anchor CLIのインストール

AnchorはSolanaプログラムを開発するためのフレームワークです。Anchorフレームワークは、Rustマクロを活用してSolanaプログラムの作成プロセスを簡素化します。

Anchor CLIとツールは2つの方法でインストールできます:

  1. Anchor Version Manager (AVM) - 推奨されるインストール方法
  2. AVMなし - GitHubから直接インストール

Anchorバージョンマネージャー(AVM)を使用すると、システム上で異なるAnchorバージョンをインストールして管理し、将来的に簡単にAnchorバージョンを更新することができます。

以下のコマンドでAVMをインストールします:

Terminal
$
cargo install --git https://github.com/coral-xyz/anchor avm --force

AVMが正常にインストールされたことを確認します:

Terminal
$
avm --version

AVMを使用して最新バージョンのAnchor CLIをインストールします:

Terminal
$
avm install latest
$
avm use latest

バージョン番号を指定することで、特定のバージョンのAnchor CLIをインストールできます:

Terminal
$
avm install 0.30.1
$
avm use 0.30.1

システム上で実行するAnchor CLIのバージョンを宣言するために、*shellavm use*コマンドを実行することを忘れないでください。

  • latestバージョンをインストールした場合は、*shellavm use latest*を実行します。
  • バージョン0.30.1をインストールした場合は、*shellavm use 0.30.1*を実行します。

インストールが成功したことを確認するには、Anchor CLIのバージョンを確認します:

Terminal
$
anchor --version

次のような出力が表示されるはずです:

anchor-cli 0.31.1

LinuxまたはWSLにAnchor CLIをインストールする際に、次のエラーが発生する場合があります:

error: could not exec the linker cc = note: Permission denied (os error 13)

このエラーメッセージが表示された場合:

  1. このページの上部にあるLinuxセクションに記載されている依存関係をインストールします。
  2. Anchor CLIのインストールを再試行します。

Node.jsとYarn

*shellanchor initコマンドで作成されたデフォルトのAnchorプロジェクトテストファイル(TypeScript)は、Node.jsとYarnが必要です。(Rustテストテンプレートはshellanchor init --test-template rust*を使用して利用可能です)

anchor buildを実行する際に、次のエラーが発生した場合:

前述の解決策を適用した後、再度 anchor build を実行してみてください。

LinuxまたはWSLで新しいAnchorプロジェクトを作成した後に anchor test を実行すると、Node.jsまたはYarnがインストールされていない場合、次のエラーが発生することがあります:

Permission denied (os error 13)
No such file or directory (os error 2)

Solana開発のためのAIツールのセットアップ

このセクションでは、Solana開発を加速するために使用できるオプションのAIツールのセットアップについて詳しく説明します。

ツール説明リンク
MCPcursorと接続してSolanaのAI支援開発を向上させることができるMCPサーバー。https://mcp.solana.com/
LLMs.txtSolanaドキュメントに関するLLMのトレーニングに使用できるLLM最適化ドキュメント。https://solana.com/llms.txt

Solana CLIの基本

このセクションでは、Solana CLIの一般的なコマンドを紹介し、使い始めるための手順を説明します。

Solana Config

現在の設定を確認するには:

Terminal
$
solana config get

次のような出力が表示されるはずです:

Config File: /Users/test/.config/solana/cli/config.yml
RPC URL: https://api.mainnet-beta.solana.com
WebSocket URL: wss://api.mainnet-beta.solana.com/ (computed)
Keypair Path: /Users/test/.config/solana/id.json
Commitment: confirmed

RPC URLとWebsocket URLは、CLIがリクエストを送信するSolanaクラスターを指定します。

以下のコマンドを使用してSolana CLIクラスターを更新できます:

Terminal
$
solana config set --url mainnet-beta
$
solana config set --url devnet
$
solana config set --url localhost
$
solana config set --url testnet

以下の短縮オプションも使用できます:

Terminal
$
solana config set -um # For mainnet-beta
$
solana config set -ud # For devnet
$
solana config set -ul # For localhost
$
solana config set -ut # For testnet

Keypair Pathは、Solana CLIがトランザクション手数料の支払いやプログラムのデプロイに使用するデフォルトのSolanaウォレット(keypair)を指しています。デフォルトでは、このファイルは~/.config/solana/id.jsonに保存されます。

ウォレットの作成

Solana CLIを使用してトランザクションを送信するには、SOLが入ったSolanaウォレットが必要です。

デフォルトのKeypair Pathにkeypairを生成するには、次のコマンドを実行します:

Terminal
$
solana-keygen new

次のような出力が表示されるはずです:

Generating a new keypair
For added security, enter a BIP39 passphrase
NOTE! This passphrase improves security of the recovery seed phrase NOT the
keypair file itself, which is stored as insecure plain text
BIP39 Passphrase (empty for none):
Wrote new keypair to /Users/test/.config/solana/id.json
===========================================================================
pubkey: 8dBTPrjnkXyuQK3KDt9wrZBfizEZijmmUQXVHpFbVwGT
===========================================================================
Save this seed phrase and your BIP39 passphrase to recover your new keypair:
cream bleak tortoise ocean nasty game gift forget fancy salon mimic amazing
===========================================================================

すでにデフォルトの場所にファイルシステムウォレットが保存されている場合、--forceフラグを使用して明示的に強制上書きしない限り、このコマンドは上書きしません。

ウォレットのアドレス(公開鍵)を表示するには、次のコマンドを実行します:

Terminal
$
solana address

SOLのエアドロップ

トランザクションやプログラムのデプロイメントの支払いに使用するため、ウォレットにSOLのエアドロップをリクエストします。

クラスターをdevnetに設定します:

Terminal
$
solana config set -ud

次に、devnet SOLのエアドロップをリクエストします:

Terminal
$
solana airdrop 2

Devnetのエアドロップは1回のリクエストにつき5 SOLに制限されています。レート制限に達したり、エラーが発生した場合は、代わりにWebフォーセットの使用を検討してください。

ウォレットのSOL残高を確認するには、次のコマンドを実行します:

Terminal
$
solana balance

ローカルvalidatorの実行

Solana CLIには、ローカル開発用の組み込みのテストvalidatorが含まれています。

別のターミナルで、次のコマンドを実行してローカルvalidatorを起動します:

Terminal
$
solana-test-validator

Solana CLIコマンドを実行する前に、CLIをlocalhostを使用するように更新することを忘れないでください:

Terminal
$
solana config set -ul

Anchor CLIの基本

このセクションでは、開始するためのいくつかの一般的なAnchor CLIコマンドを説明します。Anchor CLIの詳細については、Anchorドキュメントを参照してください。

プロジェクトの初期化

新しいAnchorプロジェクトを作成するには、次のコマンドを実行します:

Terminal
$
anchor init <project-name>

例えば、my-projectというプロジェクトを作成するには、次のように実行します:

Terminal
$
anchor init my-project

このコマンドはプロジェクト名の新しいディレクトリを作成し、基本的なRustプログラムとTypeScriptテストテンプレートを含む新しいAnchorプロジェクトを初期化します。

プロジェクトディレクトリに移動します:

Terminal
$
cd <project-name>

Anchorプロジェクトのファイル構造を確認してください。

プログラムのビルド

プロジェクトをビルドするには、次のコマンドを実行します:

Terminal
$
anchor build

コンパイルされたプログラムは/target/deployディレクトリにあります。

プログラムのデプロイ

プロジェクトをデプロイするには、次のコマンドを実行します:

Terminal
$
anchor deploy

このコマンドは、Anchor.tomlファイルで指定されたclusterにプログラムをデプロイします。

プログラムのテスト

プロジェクトをテストするには、次のコマンドを実行します:

Terminal
$
anchor test

このコマンドはプロジェクトのビルド、デプロイ、テストを実行します。

localnetAnchor.tomlclusterとして使用すると、Anchorは自動的にローカルvalidatorを起動し、プログラムをデプロイし、テストを実行した後、validatorを停止します。

Is this page helpful?