Installer la CLI Solana et Anchor

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 consulter 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 Solana CLI et Bases d'Anchor CLI 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 créent 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 une fois l'installation terminée :

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 pour 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 validator d'Anza, anciennement connu sous le nom de client validator 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 ses outils de deux façons :

Anchor Version Manager (AVM) - Méthode d'installation recommandée
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 à utiliser 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, vérifiez la version d'Anchor CLI :

Terminal

$ anchor --version

Vous devriez voir une sortie comme 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 :

Installez les dépendances listées dans la section Linux en haut de cette page.
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 vous n'avez pas Node.js ou Yarn installés :

Permission denied (os error 13)

No such file or directory (os error 2)

Configuration des outils d'IA pour le développement Solana

Cette section détaille la configuration optionnelle des outils d'IA que vous pouvez utiliser pour accélérer votre développement Solana.

Outil	Description	Lien
MCP	Serveur MCP auquel vous pouvez vous connecter avec cursor pour améliorer le développement Solana assisté par IA.	https://mcp.solana.com/
LLMs.txt	Documentation optimisée pour les LLM que vous pouvez utiliser pour entraîner les LLM sur la documentation Solana.	https://solana.com/llms.txt

Bases de la CLI Solana

Cette section présente quelques commandes courantes de l'interface en ligne de commande (CLI) Solana 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 l'interface CLI envoie des requêtes.

Vous pouvez mettre à jour le cluster de l'interface CLI Solana 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 abrégées 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 du keypair pointe vers le portefeuille Solana par défaut (keypair) utilisé par l'interface 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 l'interface CLI Solana, vous avez besoin d'un portefeuille Solana approvisionné en SOL.

Pour générer un keypair au chemin de keypair 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 enregistré dans le système de fichiers à l'emplacement par défaut, cette commande ne l'écrasera pas, sauf si vous forcez explicitement le remplacement en utilisant l'option --force.

Pour voir 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 sur le devnet :

Terminal

$ solana airdrop 2

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

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

Terminal

$ solana balance

Exécuter un validator local

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

Dans un terminal séparé, exécutez la commande suivante pour démarrer un validator 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 le 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 validator local, déploie votre programme, exécute les tests, puis arrête le validator.

Sous-système Windows pour Linux (WSL)

Linux

Message d'installation réussie de Rust

Installation de Node

Installation de Yarn

erreur : ce n'est pas un répertoire

la version 4 du fichier de verrouillage nécessite `-Znext-lockfile-bump`

Table des matières