No tutorial de hoje eu vou ensinar como você configura, passo a passo, o seu computador para desenvolvimento de programas para a blockchain Solana. O ambiente de desenvolvimento Solana consiste em:
- Node.js, ambiente de execução do framework de desenvolvimento e da IDE;
- Rust, linguagem de programação usada nos programas para Solana;
- Visual Studio Code, IDE que utilizaremos;
- Solana CLI, cliente da blockchain Solana;
- Anchor, framework de desenvolvimento para Solana;
- uma carteira cripto com suporte a Solana (Brave Wallet, por exemplo);
A instalação do Node.js e Visual Studio Code já foram cobertas no vídeo abaixo, assista ele caso precise de auxílio com esses dois.
E neste tutorial eu ensino (inclui vídeo) como configurar a carteira de criptomoedas Brave Wallet para desenvolvimento na rede Solana, incluindo como obter fundos de teste.
Escolha abaixo o seu sistema operacional para ver as instruções mais apropriadas para os passos seguintes.
Para a versão original e oficial deste tutorial, visite o site da Solana (em Inglês).
Vamos lá!
Instruções para Windows
Agora que você já tem o VS Code, o Node.js e o Brave Wallet instalados (ou outra carteira à sua escolha), vamos preparar nosso Windows. Usuários de Windows devem ter o WSL instalado e configurado em suas máquinas para conseguir rodar o ambiente de desenvolvimento para Solana. Para instalar o WSL rode o seguinte comando no terminal do PowerShell.
|
1 2 3 |
wsl --install |
Por padrão o WSL vai instalar um Linux Ubuntu para você e está tudo certo, só seguir o processo de instalação e criar uma conta de usuário padrão em determinado momento conforme instruções. Com o WSL instalado e devidamente configurado, você pode abrir um terminal de Linux no Windows procurando por Ubuntu no menu iniciar.
É interessante também instalar a extensão do WSL no VS Code também, assim você pode abrir o Linux por dentro dele clicando no canto inferior esquerdo da ferramenta (aba azul). Com o terminal do WSL aberto, seja pelo VS Code ou não, rode o comando abaixo para instalar TODAS dependências necessárias para programar Solana no Linux do WSL.
|
1 2 3 |
curl --proto '=https' --tlsv1.2 -sSfL https://raw.githubusercontent.com/solana-developers/solana-install/main/install.sh | bash |
Para verificar se tudo foi instalado corretamente, basta ver se ao término da execução a saída se parece com essa.
|
1 2 3 4 5 6 7 8 |
Installed Versions: Rust: rustc 1.85.0 (4d91de4e4 2025-02-17) Solana CLI: solana-cli 2.1.14 (src:3ad46824; feat:3271415109, client:Agave) Anchor CLI: anchor-cli 0.30.1 Node.js: v23.8.0 Yarn: 1.22.1 |
Essas são as informações das versões dos itens instalados. Caso este comando resulte em falha para você, use as instruções da seção Linux abaixo para instalar tudo manualmente, mas ainda dentro do WSL.
Instruções para Linux
Agora que você já tem o VS Code, o Node.js e o Brave Wallet instalados (ou outra carteira à sua escolha), vamos preparar nosso Linux ou WSL. O jeito mais fácil de deixar seu Linux ou WSL preparado para desenvolvimento Solana é rodando o único comando abaixo no seu terminal.
|
1 2 3 |
curl --proto '=https' --tlsv1.2 -sSfL https://raw.githubusercontent.com/solana-developers/solana-install/main/install.sh | bash |
Para verificar se tudo foi instalado corretamente, basta ver se ao término da execução a saída se parece com essa.
|
1 2 3 4 5 6 7 8 |
Installed Versions: Rust: rustc 1.85.0 (4d91de4e4 2025-02-17) Solana CLI: solana-cli 2.1.14 (src:3ad46824; feat:3271415109, client:Agave) Anchor CLI: anchor-cli 0.30.1 Node.js: v23.8.0 Yarn: 1.22.1 |
Essas são as informações das versões dos itens instalados. Caso a instalação rápida resulte em falha, siga as instruções a seguir para instalar manualmente as dependências.
As instruções disponíveis são para Debian/Ubuntu e começam com a tradicional atualização do registro de pacotes do SO.
|
1 2 3 |
sudo apt-get update |
Na sequência, instale as seguintes dependências.
|
1 2 3 4 5 6 7 |
sudo apt-get install -y \ build-essential \ pkg-config \ libudev-dev llvm libclang-dev \ protobuf-compiler libssl-dev |
Se você tiver o erro abaixo é porque faltou (ou falhou) atualizar o registro como dito acima.
|
1 2 3 4 5 |
Package protobuf-compiler is not available, but is referred to by another package. This may mean that the package is missing, has been obsoleted, or is only available from another source |
Agora vamos instalar o Rust. Use o comando abaixo no seu terminal, selecionando a opção padrão quando questionado o tipo de instalação e na sequência mais algumas configurações adicionais.
|
1 2 3 4 5 |
curl --proto '=https' --tlsv1.2 https://sh.rustup.rs -sSf | sh source $HOME/.cargo/env rustup component add rustfmt |
Para verificar se ele foi instalado corretamente, use o comando abaixo.
|
1 2 3 |
rustup --version |
Agora que está com o Rust ok, hora de instalarmos o Solana CLI, para termos um nó de Solana para desenvolvimento. O comando abaixo faz isso com o cliente Agave, o mais recomendado atualmente, sendo que o segundo comando é para adicionar o cli no path do terminal.
|
1 2 3 4 |
sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)" export PATH="/Users/test/.local/share/solana/install/active_release/bin:$PATH" |
Se você estiver usando o terminal do Linux ou WSL do Windows, rode os comandos abaixo para que ele se atualize para as novas dependências instaladas.
|
1 2 3 |
export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH" |
Para verificar se o Solana CLI foi instalado com sucesso, rode o comando abaixo.
|
1 2 3 |
solana --version |
E caso precise no futuro atualizar o cli para a última versão, o comando é esse:
|
1 2 3 |
agave-install update |
Com Rust e Solana instalados, bem como suas dependências, podemos instalar agora o Anchor. O Anchor é um framework de desenvolvimento para Solana, facilitando bastante a escrita, testes, deploy e interação com programas Solana. Para instalar o Anchor, vamos instalar primeiro o AVM (Anchor Version Manager) com o comando abaixo (o segundo comando é para ver se ele instalou com sucesso).
|
1 2 3 4 |
cargo install --git https://github.com/coral-xyz/anchor avm --force avm --version |
Agora para instalar o Anchor CLI, use os comandos abaixo, sendo que o segundo é para garantir que a versão recém instalada seja a utilizada por padrão e o último para ver se o Anchor foi instalado com sucesso.
|
1 2 3 4 5 |
avm install latest avm use latest anchor --version |
Caso você tenha o erro abaixo, é porque não tem alguma das dependências iniciais instaladas. Instale elas e tente novamente a instalação do AVM em diante.
|
1 2 3 |
error: could not exec the linker cc = note: Permission denied (os error 13) |
Agora sim, seu Linux ou WSL está pronto para desenvolvimento Solana!
Instruções para Mac OS (M1)
Agora que você já tem o VS Code, o Node.js e o Brave Wallet instalados (ou outra carteira à sua escolha), vamos preparar nosso Mac M1. O jeito mais fácil de deixar seu Mac preparado para desenvolvimento Solana é rodando o único comando abaixo no seu terminal.
|
1 2 3 |
curl --proto '=https' --tlsv1.2 -sSfL https://raw.githubusercontent.com/solana-developers/solana-install/main/install.sh | bash |
Para verificar se tudo foi instalado corretamente, basta ver se ao término da execução a saída se parece com essa.
|
1 2 3 4 5 6 7 8 |
Installed Versions: Rust: rustc 1.85.0 (4d91de4e4 2025-02-17) Solana CLI: solana-cli 2.1.14 (src:3ad46824; feat:3271415109, client:Agave) Anchor CLI: anchor-cli 0.30.1 Node.js: v23.8.0 Yarn: 1.22.1 |
Essas são as informações das versões dos itens instalados. Caso a instalação rápida resulte em falha, siga as instruções a seguir para instalar manualmente as dependências. Primeiro instale o package manager Brew, caso ainda não possua.
|
1 2 3 |
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" |
Com o Brew instalado, rode este comando para instalar as dependências necessárias.
|
1 2 3 |
brew install python@3.9 protobuf llvm cmake openssl coreutils |
Agora vamos instalar o Rust. Use o comando abaixo no seu terminal, selecionando a opção padrão quando questionado o tipo de instalação e na sequência mais algumas configurações adicionais.
|
1 2 3 4 5 |
curl --proto '=https' --tlsv1.2 https://sh.rustup.rs -sSf | sh source $HOME/.cargo/env rustup component add rustfmt |
Para verificar se ele foi instalado corretamente, use o comando abaixo.
|
1 2 3 |
rustup --version |
Agora que está com o Rust ok, hora de instalarmos o Solana CLI, para termos um nó de Solana para desenvolvimento. O comando abaixo faz isso com o cliente Agave, o mais recomendado atualmente, sendo que o segundo comando é para adicionar o cli no path do terminal.
|
1 2 3 4 |
sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)" export PATH="/Users/test/.local/share/solana/install/active_release/bin:$PATH" |
Se você estiver usando o terminal zsh do Mac, rode os comandos abaixo para que ele se atualize para as novas dependências instaladas.
|
1 2 3 4 |
echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.zshrc source ~/.zshrc |
Para verificar se o Solana CLI foi instalado com sucesso, rode o comando abaixo.
|
1 2 3 |
solana --version |
E caso precise no futuro atualizar o cli para a última versão, o comando é esse:
|
1 2 3 |
agave-install update |
Com Rust e Solana instalados, bem como suas dependências, podemos instalar agora o Anchor. O Anchor é um framework de desenvolvimento para Solana, facilitando bastante a escrita, testes, deploy e interação com programas Solana. Para instalar o Anchor, vamos instalar primeiro o AVM (Anchor Version Manager) com o comando abaixo (o segundo comando é para ver se ele instalou com sucesso).
|
1 2 3 4 |
cargo install --git https://github.com/coral-xyz/anchor avm --force avm --version |
Agora para instalar o Anchor CLI, use os comandos abaixo, sendo que o segundo é para garantir que a versão recém instalada seja a utilizada por padrão e o último para ver se o Anchor foi instalado com sucesso.
|
1 2 3 4 5 |
avm install latest avm use latest anchor --version |
Agora sim, seu Mac M1 está pronto para desenvolvimento Solana!
Como criar sua própria carteira de criptomoedas com JS (Solana) - Parte 2
Como configurar a Brave Wallet para desenvolvimento blockchain
Como configurar a MetaMask para desenvolvimento blockchain
Como criar sua própria carteira de criptomoedas com JS (Solana)
Olá, tudo bem?
O que você achou deste conteúdo? Conte nos comentários.