Встановлення 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:

Закрийте та знову відкрийте термінал, щоб застосувати зміни PATH, або виконайте наступну команду у вашій поточній оболонці:

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

Цей розділ описує додаткові інструменти ШІ, які ви можете використовувати для прискорення вашої розробки на Solana.

Інструмент	Опис	Посилання
MCP	MCP сервер, до якого ви можете підключитися за допомогою cursor для покращення розробки на Solana з допомогою ШІ.	https://mcp.solana.com/
LLMs.txt	Оптимізована для LLM документація, яку ви можете використовувати для навчання LLM на документації Solana.	https://solana.com/llms.txt

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

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

Для відправлення транзакцій за допомогою Solana CLI вам потрібен гаманець Solana з коштами в SOL.

Щоб згенерувати 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 через аirdrop

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

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

Terminal

$ solana config set -ud

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

Terminal

$ solana airdrop 2

Аirdrop у мережі devnet обмежує запити до 5 SOL за один раз. Якщо ви досягли ліміту запитів або зіткнулися з помилками, спробуйте скористатися Веб-краном.

Щоб перевірити баланс 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 для Linux (WSL)

Linux

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

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

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

error: not a directory

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

Зміст