Установка 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 указывает на кошелек Solana по умолчанию (keypair), используемый CLI Solana для оплаты комиссий за транзакции и развертывания программ. По умолчанию этот файл хранится в ~/.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

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

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

Terminal

$ solana config set -ud

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

Terminal

$ solana airdrop 2

Аирдропы в devnet ограничены до 5 SOL на запрос. Если вы столкнулись с ограничениями или ошибками, попробуйте использовать Веб-кран вместо этого.

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

Terminal

$ solana balance

Запустите локальный валидатор

Solana CLI включает встроенный тестовый 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

Содержание