Installation

Cette section couvre les étapes pour configurer votre environnement local pour le développement Solana.

Installation rapide

Sur Mac et Linux, exécutez cette commande unique pour installer toutes les dépendances.

Terminal
$
curl --proto '=https' --tlsv1.2 -sSfL https://solana-install.solana.workers.dev | bash

Utilisateurs Windows : vous devez d'abord installer WSL (voir Installer les dépendances). Ensuite, exécutez la commande précédente dans le terminal Ubuntu (Linux).

Après l'installation, vous devriez voir une sortie comme celle-ci :

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

Si la commande d'installation rapide ne fonctionne pas, veuillez vous référer à la section Installer les dépendances ci-dessous pour les instructions d'installation individuelle de chaque dépendance.

Si la commande d'installation rapide s'exécute avec succès, passez aux sections Bases de la CLI Solana et Bases de la CLI Anchor ci-dessous.

Installer les dépendances

Les instructions ci-dessous vous guident à travers l'installation individuelle de chaque dépendance.

  • Les utilisateurs Windows doivent d'abord installer WSL (sous-système Windows pour Linux) puis installer les dépendances spécifiées dans la section Linux ci-dessous.
  • Les utilisateurs Linux doivent d'abord installer les dépendances spécifiées dans la section Linux ci-dessous.
  • Les utilisateurs Mac doivent commencer par les instructions d'installation de Rust ci-dessous.

Installer Rust

Les développeurs construisent des programmes Solana en utilisant le langage de programmation Rust.

Installez Rust avec rustup.

Exécutez la commande suivante pour installer Rust :

Terminal
$
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y

Vous devriez voir le message suivant après la fin de l'installation :

Exécutez la commande suivante pour recharger votre variable d'environnement PATH afin d'inclure le répertoire bin de Cargo :

Terminal
$
. "$HOME/.cargo/env"

Pour vérifier que l'installation a réussi, vérifiez la version de Rust :

Terminal
$
rustc --version

Vous devriez voir une sortie comme celle-ci :

rustc 1.86.0 (05f9846f8 2025-03-31)

Installer la CLI Solana

La CLI Solana fournit tous les outils nécessaires pour créer et déployer des programmes Solana.

Installez la suite d'outils CLI Solana en utilisant la commande d'installation officielle :

Terminal
$
sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)"

Vous pouvez remplacer stable par le tag de version correspondant à la version logicielle de votre choix (par exemple v2.0.3), ou utiliser l'un des trois noms de canaux symboliques : stable, beta, ou edge.

Pour une première installation de la CLI Solana, vous pourriez voir le message suivant vous invitant à ajouter une variable d'environnement 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"

Si vous utilisez Linux ou WSL, vous devez ajouter le binaire CLI Solana à votre PATH afin que la commande soit disponible dans votre terminal.

D'abord, exécutez la commande suivante pour vérifier quel shell vous utilisez :

Terminal
$
echo $SHELL
  • Si la sortie contient /bash, utilisez .bashrc.
  • Si la sortie contient /zsh, utilisez .zshrc.

Selon votre shell, exécutez la commande appropriée.

Pour Bash (bashrc) :

Terminal
$
echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.bashrc
$
source ~/.bashrc

Pour Zsh (zshrc) :

Terminal
$
echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.zshrc
$
source ~/.zshrc

Ensuite, exécutez la commande suivante pour actualiser la session du terminal ou redémarrez votre terminal.

Terminal
$
source ~/.bashrc # If using Bash
$
source ~/.zshrc # If using Zsh

Pour vérifier que l'installation a réussi, vérifiez la version de la CLI Solana :

Terminal
$
solana --version

Vous devriez voir une sortie comme celle-ci :

solana-cli 2.2.12 (src:0315eb6a; feat:1522022101, client:Agave)

Vous pouvez consulter toutes les versions disponibles sur le dépôt Github Agave.

Agave est le client validateur d'Anza, anciennement connu sous le nom de client validateur Solana Labs.

Pour mettre à jour ultérieurement la CLI Solana vers la dernière version, vous pouvez utiliser la commande suivante :

Terminal
$
agave-install update

Installer la CLI Anchor

Anchor est un framework pour développer des programmes Solana. Le framework Anchor utilise des macros Rust pour simplifier le processus d'écriture des programmes Solana.

Vous pouvez installer la CLI Anchor et les outils de deux façons :

  1. Anchor Version Manager (AVM) - Méthode d'installation recommandée
  2. Sans AVM - Installation directe depuis GitHub

Le gestionnaire de versions Anchor (AVM) vous permet d'installer et de gérer différentes versions d'Anchor sur votre système et de mettre à jour facilement les versions d'Anchor à l'avenir.

Installez AVM avec la commande suivante :

Terminal
$
cargo install --git https://github.com/coral-xyz/anchor avm --force

Confirmez qu'AVM a été installé avec succès :

Terminal
$
avm --version

Installez la dernière version d'Anchor CLI en utilisant AVM :

Terminal
$
avm install latest
$
avm use latest

Vous pouvez installer une version spécifique d'Anchor CLI en précisant le numéro de version :

Terminal
$
avm install 0.30.1
$
avm use 0.30.1

N'oubliez pas d'exécuter la commande avm use pour déclarer la version d'Anchor CLI à exécuter sur votre système.

  • Si vous avez installé la version latest, exécutez avm use latest.
  • Si vous avez installé la version 0.30.1, exécutez avm use 0.30.1.

Pour vérifier que l'installation a réussi, contrôlez la version d'Anchor CLI :

Terminal
$
anchor --version

Vous devriez voir une sortie similaire à celle-ci :

anchor-cli 0.31.1

Lors de l'installation d'Anchor CLI sur Linux ou WSL, vous pourriez rencontrer cette erreur :

error: could not exec the linker cc = note: Permission denied (os error 13)

Si vous voyez ce message d'erreur :

  1. Installez les dépendances listées dans la section Linux en haut de cette page.
  2. Réessayez d'installer Anchor CLI.

Node.js et Yarn

Le fichier de test par défaut du projet Anchor (TypeScript) créé avec la commande anchor init nécessite Node.js et Yarn. (Le modèle de test Rust est disponible en utilisant anchor init --test-template rust)

Lors de l'exécution de anchor build, si vous rencontrez les erreurs suivantes :

Après avoir appliqué la solution précédente, essayez d'exécuter anchor build à nouveau.

Lors de l'exécution de anchor test après avoir créé un nouveau projet Anchor sur Linux ou WSL, vous pourriez rencontrer les erreurs suivantes si Node.js ou Yarn ne sont pas installés :

Permission denied (os error 13)
No such file or directory (os error 2)

Notions de base de Solana CLI

Cette section présente quelques commandes courantes de Solana CLI pour vous aider à démarrer.

Configuration de Solana

Pour voir votre configuration actuelle :

Terminal
$
solana config get

Vous devriez voir une sortie comme celle-ci :

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

L'URL RPC et l'URL Websocket spécifient le cluster Solana auquel la CLI envoie des requêtes.

Vous pouvez mettre à jour le cluster Solana CLI en utilisant les commandes suivantes :

Terminal
$
solana config set --url mainnet-beta
$
solana config set --url devnet
$
solana config set --url localhost
$
solana config set --url testnet

Vous pouvez également utiliser les options courtes suivantes :

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

Le chemin de la paire de clés pointe vers le portefeuille Solana par défaut (keypair) utilisé par la CLI Solana pour payer les frais de transaction et déployer des programmes. Par défaut, ce fichier est stocké à ~/.config/solana/id.json.

Créer un portefeuille

Pour envoyer des transactions à l'aide de la CLI Solana, vous avez besoin d'un portefeuille Solana approvisionné en SOL.

Pour générer une paire de clés au chemin de paire de clés par défaut, exécutez la commande suivante :

Terminal
$
solana-keygen new

Vous devriez voir une sortie comme celle-ci :

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
===========================================================================

Si vous avez déjà un portefeuille système de fichiers enregistré à l'emplacement par défaut, cette commande ne le remplacera pas, sauf si vous forcez explicitement le remplacement en utilisant l'option --force.

Pour afficher l'adresse de votre portefeuille (clé publique), exécutez :

Terminal
$
solana address

Airdrop de SOL

Demandez un airdrop de SOL sur votre portefeuille pour payer les transactions et les déploiements de programmes.

Configurez votre cluster sur le devnet :

Terminal
$
solana config set -ud

Puis demandez un airdrop de SOL devnet :

Terminal
$
solana airdrop 2

Les airdrops du devnet limitent les demandes à 5 SOL par requête. Si vous atteignez les limites de taux ou rencontrez des erreurs, essayez d'utiliser le Faucet Web à la place.

Pour vérifier le solde SOL de votre portefeuille, exécutez la commande suivante :

Terminal
$
solana balance

Exécuter un validateur local

La CLI Solana inclut un validateur de test intégré pour le développement local.

Dans un terminal séparé, exécutez la commande suivante pour démarrer un validateur local :

Terminal
$
solana-test-validator

N'oubliez pas de mettre à jour votre CLI pour utiliser localhost avant d'exécuter les commandes CLI Solana :

Terminal
$
solana config set -ul

Bases de la CLI Anchor

Cette section présente quelques commandes courantes de la CLI Anchor pour vous aider à démarrer. Pour plus d'informations sur la CLI Anchor, consultez la documentation Anchor.

Initialiser un projet

Pour créer un nouveau projet Anchor, exécutez la commande suivante :

Terminal
$
anchor init <project-name>

Par exemple, pour créer un projet appelé my-project, exécutez :

Terminal
$
anchor init my-project

Cette commande crée un nouveau répertoire avec le nom du projet et initialise un nouveau projet Anchor avec un programme Rust de base et un modèle de test TypeScript.

Naviguez vers le répertoire du projet :

Terminal
$
cd <project-name>

Consultez la structure de fichiers du projet Anchor.

Compiler le programme

Pour compiler votre projet, exécutez la commande suivante :

Terminal
$
anchor build

Vous pouvez trouver le programme compilé dans le répertoire /target/deploy.

Déployer le programme

Pour déployer votre projet, exécutez la commande suivante :

Terminal
$
anchor deploy

Cette commande déploie votre programme sur le cluster spécifié dans le fichier Anchor.toml.

Tester le programme

Pour tester votre projet, exécutez la commande suivante :

Terminal
$
anchor test

Cette commande compile, déploie et exécute les tests pour votre projet.

Lorsque vous utilisez localnet comme cluster dans Anchor.toml, Anchor démarre automatiquement un validateur local, déploie votre programme, exécute les tests, puis arrête le validateur.

Is this page helpful?