Встановіть Solana CLI та Anchor

Цей розділ охоплює кроки для налаштування вашого локального середовища для розробки на 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 для Linux), а потім встановити залежності, вказані в розділі Linux нижче.
Користувачі Linux повинні спочатку встановити залежності, вказані в розділі Linux нижче.
Користувачі Mac повинні почати з інструкцій з встановлення Rust нижче.

Встановлення Rust

Розробники створюють програми Solana за допомогою мови програмування Rust.

Встановіть Rust за допомогою rustup.

Виконайте наступну команду для встановлення Rust:

Terminal

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

Після завершення встановлення ви повинні побачити таке повідомлення:

Виконайте наступну команду, щоб перезавантажити змінну середовища PATH, включивши директорію bin Cargo:

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), або використовувати одну з трьох символічних назв каналів: 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, щоб команда була доступна у вашому терміналі.

Спочатку виконайте наступну команду, щоб перевірити, яку оболонку ви використовуєте:

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 — це клієнт validator від Anza, раніше відомий як клієнт validator від Solana Labs.

Щоб пізніше оновити Solana CLI до останньої версії, ви можете використати наступну команду:

Terminal

$ agave-install update

Встановлення Anchor CLI

Anchor — це фреймворк для розробки програм Solana. Фреймворк Anchor використовує макроси Rust для спрощення процесу написання програм Solana.

Ви можете встановити Anchor CLI та інструменти двома способами:

Anchor Version Manager (AVM) — рекомендований метод встановлення
Без AVM — встановлення безпосередньо з GitHub

Менеджер версій Anchor (AVM) дозволяє встановлювати та керувати різними версіями Anchor у вашій системі та легко оновлювати версії Anchor у майбутньому.

Встановіть AVM за допомогою наступної команди:

Terminal

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

Підтвердіть, що AVM встановлено успішно:

Terminal

$ avm --version

Встановіть останню версію Anchor CLI за допомогою AVM:

Terminal

$ avm install latest
$ avm use latest

Ви можете встановити конкретну версію Anchor CLI, вказавши номер версії:

Terminal

$ avm install 0.30.1
$ avm use 0.30.1

Не забудьте виконати команду avm use, щоб вказати версію Anchor CLI, яка буде використовуватися у вашій системі.

Якщо ви встановили версію latest, виконайте avm use latest.
Якщо ви встановили версію 0.30.1, виконайте avm use 0.30.1.

Щоб перевірити успішність встановлення, перевірте версію Anchor CLI:

Terminal

$ anchor --version

Ви повинні побачити результат, схожий на такий:

anchor-cli 0.31.1

При встановленні Anchor CLI на Linux або WSL ви можете зіткнутися з такою помилкою:

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

Якщо ви бачите це повідомлення про помилку:

Встановіть залежності, перелічені в розділі Linux на початку цієї сторінки.
Спробуйте встановити Anchor CLI знову.

Node.js та Yarn

Типовий тестовий файл проєкту Anchor (TypeScript), створений за допомогою команди anchor init, потребує Node.js та Yarn. (Шаблон тесту Rust доступний за допомогою anchor init --test-template rust)

Якщо під час запуску anchor build ви зіткнетеся з такими помилками:

Після застосування попереднього рішення спробуйте знову запустити anchor build.

При запуску anchor test після створення нового проекту Anchor на Linux або WSL, ви можете зіткнутися з наступними помилками, якщо у вас не встановлено Node.js або Yarn:

Permission denied (os error 13)

No such file or directory (os error 2)

Основи Solana CLI

Цей розділ розглядає деякі поширені команди Solana CLI, щоб допомогти вам почати роботу.

Конфігурація Solana

Щоб переглянути поточну конфігурацію:

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 визначають кластер Solana, до якого CLI надсилає запити.

Ви можете оновити кластер 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 (keypair), який використовується Solana CLI для оплати комісій за транзакції та розгортання програм. За замовчуванням цей файл зберігається в ~/.config/solana/id.json.

Створення гаманця

Щоб надсилати транзакції за допомогою Solana CLI, вам потрібен гаманець Solana з коштами в SOL.

Щоб згенерувати keypair за стандартним шляхом Keypair Path, виконайте таку команду:

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

Аirdrop SOL

Запитайте аirdrop SOL на ваш гаманець для оплати транзакцій та розгортання програм.

Встановіть ваш кластер на devnet:

Terminal

$ solana config set -ud

Потім запитайте аirdrop devnet SOL:

Terminal

$ solana airdrop 2

Airdrop у devnet обмежує запити до 5 SOL за один запит. Якщо ви досягли обмеження швидкості або зіткнулися з помилками, спробуйте натомість використати Web Faucet.

Щоб перевірити баланс SOL вашого гаманця, виконайте таку команду:

Terminal

$ solana balance

Запустіть локальний validator

Solana CLI включає вбудований тестовий validator для локальної розробки.

У окремому терміналі виконайте таку команду, щоб запустити локальний validator:

Terminal

$ solana-test-validator

Не забудьте також оновити ваш CLI для використання localhost перед виконанням команд Solana CLI:

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

Ця команда створює новий каталог з назвою проекту та ініціалізує новий проект Anchor з базовою програмою на Rust та шаблоном тесту на TypeScript.

Перейдіть до каталогу проекту:

Terminal

$ cd <project-name>

Ознайомтеся зі структурою файлів проекту Anchor.

Збірка програми

Щоб зібрати ваш проект, виконайте таку команду:

Terminal

$ anchor build

Скомпільовану програму можна знайти в каталозі /target/deploy.

Розгортання програми

Щоб розгорнути ваш проект, виконайте таку команду:

Terminal

$ anchor deploy

Ця команда розгортає вашу програму на cluster, вказаному у файлі Anchor.toml.

Тестування програми

Щоб протестувати ваш проект, виконайте таку команду:

Terminal

$ anchor test

Ця команда збирає, розгортає та запускає тести для вашого проекту.

Коли ви використовуєте localnet як cluster у Anchor.toml, Anchor автоматично запускає локальний validator, розгортає вашу програму, запускає тести, а потім зупиняє validator.

Windows Subsystem for Linux (WSL)

Linux

Повідомлення про успішне встановлення Rust

Встановлення Node

Встановлення Yarn

error: not a directory

lock file version 4 requires `-Znext-lockfile-bump

Зміст