Установка 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

В этом разделе описана настройка дополнительных инструментов ИИ, которые вы можете использовать для ускорения разработки на Solana.

Инструмент	Описание	Ссылка
MCP	Сервер MCP, к которому вы можете подключиться с помощью курсора для улучшения разработки с поддержкой ИИ на 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 по умолчанию в пути 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

Airdrop SOL

Запросите airdrop SOL на ваш кошелёк, чтобы оплачивать транзакции и развертывание программ.

Установите ваш кластер на devnet:

Terminal

$ solana config set -ud

Затем запросите airdrop devnet SOL:

Terminal

$ solana airdrop 2

Airdrop в devnet ограничивает запросы до 5 SOL за один запрос. Если вы достигли лимита запросов или столкнулись с ошибками, попробуйте использовать Web Faucet.

Чтобы проверить баланс SOL вашего кошелька, выполните следующую команду:

Terminal

$ solana balance

Запуск локального валидатора

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

В отдельном терминале выполните следующую команду, чтобы запустить локальный валидатор:

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 автоматически запускает локальный валидатор, развёртывает вашу программу, выполняет тесты, а затем останавливает валидатор.

Windows Subsystem for Linux (WSL)

Linux

Сообщение об успешной установке Rust

Установка Node

Установка Yarn

error: not a directory

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

Содержание