インストール
このセクションでは、Solana開発のためのローカル環境をセットアップする手順を説明します。
クイックインストール
MacとLinuxでは、以下の単一コマンドを実行して、すべての依存関係をインストールします。
$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.1Node.js: v23.11.0Yarn: 1.22.1
クイックインストールコマンドが機能しない場合は、以下の依存関係のインストールセクションを参照して、各依存関係を個別にインストールする手順を確認してください。
クイックインストールコマンドが正常に実行された場合は、以下のSolana CLIの基本とAnchor CLIの基本セクションにスキップしてください。
依存関係のインストール
以下の手順では、各依存関係を個別にインストールする方法を説明します。
- Windowsユーザーは、まずWSL(Windows Subsystem for Linux)をインストールし、その後、以下のLinuxセクションで指定されている依存関係をインストールする必要があります。
- Linuxユーザーは、まず以下のLinuxセクションで指定されている依存関係をインストールする必要があります。
- Macユーザーは、以下のRustインストール手順から始めてください。
Rustをインストールする
開発者はRustプログラミング言語を使用してSolanaプログラムを構築します。
rustupを使用してRustをインストールします。
Rustをインストールするには、次のコマンドを実行します:
$curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
インストールが完了すると、次のメッセージが表示されるはずです:
CargoのbinディレクトリをPATH環境変数に含めるために、次のコマンドを実行してPATHを再読み込みします:
$. "$HOME/.cargo/env"
インストールが成功したことを確認するために、Rustのバージョンを確認してください:
$rustc --version
以下のような出力が表示されるはずです:
rustc 1.86.0 (05f9846f8 2025-03-31)
Solana CLIのインストール
Solana CLIは、Solanaプログラムを構築およびデプロイするために必要なすべてのツールを提供します。
公式のインストールコマンドを使用してSolana CLIツールスイートをインストールします:
$sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)"
stable
を、希望するリリースのソフトウェアバージョンに一致するリリースタグ(例:v2.0.3
)に置き換えるか、3つのシンボリックチャネル名のいずれかを使用できます:stable
、beta
、または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
に追加して、ターミナルでコマンドが使用できるようにする必要があります。
まず、次のコマンドを実行して、使用しているシェルを確認します:
$echo $SHELL
- 出力に
/bash
が含まれている場合は、.bashrc
を使用します。 - 出力に
/zsh
が含まれている場合は、.zshrc
を使用します。
シェルに応じて、適切なコマンドを実行してください。
Bash(bashrc
)の場合:
$echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.bashrc$source ~/.bashrc
Zsh(zshrc
)の場合:
$echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.zshrc$source ~/.zshrc
その後、以下のコマンドを実行してターミナルセッションを更新するか、ターミナルを再起動してください。
$source ~/.bashrc # If using Bash$source ~/.zshrc # If using Zsh
インストールが成功したことを確認するには、Solana CLIのバージョンを確認します:
$solana --version
次のような出力が表示されるはずです:
solana-cli 2.2.12 (src:0315eb6a; feat:1522022101, client:Agave)
利用可能なすべてのバージョンはAgave Githubリポジトリで確認できます。
AgaveはAnzaのvalidatorクライアントで、以前はSolana Labs validatorクライアントとして知られていました。
後日、Solana CLIを最新バージョンに更新するには、次のコマンドを使用できます:
$agave-install update
Anchor CLIのインストール
AnchorはSolanaプログラムを開発するためのフレームワークです。Anchorフレームワークは、Rustマクロを活用してSolanaプログラムの作成プロセスを簡素化します。
Anchor CLIとツールは2つの方法でインストールできます:
- Anchor Version Manager (AVM) - 推奨されるインストール方法
- AVMなし - GitHubから直接インストール
Anchorバージョンマネージャー(AVM)を使用すると、システム上で異なるAnchorバージョンをインストールして管理し、将来的に簡単にAnchorバージョンを更新することができます。
以下のコマンドでAVMをインストールします:
$cargo install --git https://github.com/coral-xyz/anchor avm --force
AVMが正常にインストールされたことを確認します:
$avm --version
AVMを使用して最新バージョンのAnchor CLIをインストールします:
$avm install latest$avm use latest
バージョン番号を指定することで、特定のバージョンのAnchor CLIをインストールできます:
$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のバージョンを確認します:
$anchor --version
次のような出力が表示されるはずです:
anchor-cli 0.31.1
LinuxまたはWSLにAnchor CLIをインストールする際に、次のエラーが発生する場合があります:
error: could not exec the linker cc = note: Permission denied (os error 13)
このエラーメッセージが表示された場合:
- このページの上部にあるLinuxセクションに記載されている依存関係をインストールします。
- 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ツールのセットアップについて詳しく説明します。
ツール | 説明 | リンク |
---|---|---|
MCP | cursorと接続してSolanaのAI支援開発を向上させることができるMCPサーバー。 | https://mcp.solana.com/ |
LLMs.txt | Solanaドキュメントに関するLLMのトレーニングに使用できるLLM最適化ドキュメント。 | https://solana.com/llms.txt |
Solana CLIの基本
このセクションでは、Solana CLIの一般的なコマンドを紹介し、使い始めるための手順を説明します。
Solana Config
現在の設定を確認するには:
$solana config get
次のような出力が表示されるはずです:
Config File: /Users/test/.config/solana/cli/config.ymlRPC URL: https://api.mainnet-beta.solana.comWebSocket URL: wss://api.mainnet-beta.solana.com/ (computed)Keypair Path: /Users/test/.config/solana/id.jsonCommitment: confirmed
RPC URLとWebsocket URLは、CLIがリクエストを送信するSolanaクラスターを指定します。
以下のコマンドを使用してSolana CLIクラスターを更新できます:
$solana config set --url mainnet-beta$solana config set --url devnet$solana config set --url localhost$solana config set --url testnet
以下の短縮オプションも使用できます:
$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を生成するには、次のコマンドを実行します:
$solana-keygen new
次のような出力が表示されるはずです:
Generating a new keypairFor added security, enter a BIP39 passphraseNOTE! This passphrase improves security of the recovery seed phrase NOT thekeypair file itself, which is stored as insecure plain textBIP39 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
フラグを使用して明示的に強制上書きしない限り、このコマンドは上書きしません。
ウォレットのアドレス(公開鍵)を表示するには、次のコマンドを実行します:
$solana address
SOLのエアドロップ
トランザクションやプログラムのデプロイメントの支払いに使用するため、ウォレットにSOLのエアドロップをリクエストします。
クラスターをdevnetに設定します:
$solana config set -ud
次に、devnet SOLのエアドロップをリクエストします:
$solana airdrop 2
Devnetのエアドロップは1回のリクエストにつき5 SOLに制限されています。レート制限に達したり、エラーが発生した場合は、代わりにWebフォーセットの使用を検討してください。
ウォレットのSOL残高を確認するには、次のコマンドを実行します:
$solana balance
ローカルvalidatorの実行
Solana CLIには、ローカル開発用の組み込みのテストvalidatorが含まれています。
別のターミナルで、次のコマンドを実行してローカルvalidatorを起動します:
$solana-test-validator
Solana CLIコマンドを実行する前に、CLIをlocalhostを使用するように更新することを忘れないでください:
$solana config set -ul
Anchor CLIの基本
このセクションでは、開始するためのいくつかの一般的なAnchor CLIコマンドを説明します。Anchor CLIの詳細については、Anchorドキュメントを参照してください。
プロジェクトの初期化
新しいAnchorプロジェクトを作成するには、次のコマンドを実行します:
$anchor init <project-name>
例えば、my-project
というプロジェクトを作成するには、次のように実行します:
$anchor init my-project
このコマンドはプロジェクト名の新しいディレクトリを作成し、基本的なRustプログラムとTypeScriptテストテンプレートを含む新しいAnchorプロジェクトを初期化します。
プロジェクトディレクトリに移動します:
$cd <project-name>
Anchorプロジェクトのファイル構造を確認してください。
プログラムのデプロイ
プロジェクトをデプロイするには、次のコマンドを実行します:
$anchor deploy
このコマンドは、Anchor.toml
ファイルで指定されたcluster
にプログラムをデプロイします。
プログラムのテスト
プロジェクトをテストするには、次のコマンドを実行します:
$anchor test
このコマンドはプロジェクトのビルド、デプロイ、テストを実行します。
localnet
をAnchor.toml
のcluster
として使用すると、Anchorは自動的にローカルvalidatorを起動し、プログラムをデプロイし、テストを実行した後、validatorを停止します。
Is this page helpful?