Установите 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 — это клиент валидатора от Anza, ранее известный как клиент валидатора 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 по пути по умолчанию, выполните следующую команду:

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 для Linux (WSL)

Linux

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

Установка Node

Установка Yarn

ошибка: не является директорией

версия файла блокировки 4 требует `-Znext-lockfile-bump

Содержание