Installeer de Solana CLI en Anchor

Dit gedeelte behandelt de stappen om je lokale omgeving op te zetten voor Solana ontwikkeling.

Snelle installatie

Op Mac en Linux kun je dit enkele commando uitvoeren om alle afhankelijkheden te installeren.

Terminal

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

Windows-gebruikers: je moet eerst WSL installeren (zie Afhankelijkheden installeren). Voer daarna het bovenstaande commando uit in de Ubuntu (Linux) terminal.

Na de installatie zou je output moeten zien zoals het volgende:

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

Als het snelle installatiecommando niet werkt, raadpleeg dan de Afhankelijkheden installeren sectie hieronder voor instructies om elke afhankelijkheid afzonderlijk te installeren.

Als het snelle installatiecommando succesvol wordt uitgevoerd, ga dan direct naar de Solana CLI Basics en Anchor CLI Basics secties hieronder.

Afhankelijkheden installeren

De onderstaande instructies leiden je door het individueel installeren van elke afhankelijkheid.

Windows-gebruikers moeten eerst WSL (Windows subsystem for Linux) installeren en vervolgens de afhankelijkheden installeren die in de Linux-sectie hieronder worden gespecificeerd.
Linux-gebruikers moeten eerst de afhankelijkheden installeren die in de Linux- sectie hieronder worden gespecificeerd.
Mac-gebruikers moeten beginnen met de Rust-installatie-instructies hieronder.

Installeer Rust

Ontwikkelaars bouwen Solana-programma's met behulp van de Rust-programmeertaal.

Installeer Rust met rustup.

Voer het volgende commando uit om Rust te installeren:

Terminal

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

Je zou het volgende bericht moeten zien nadat de installatie is voltooid:

Voer het volgende commando uit om je PATH-omgevingsvariabele opnieuw te laden zodat deze de bin-directory van Cargo bevat:

Terminal

$ . "$HOME/.cargo/env"

Om te verifiëren of de installatie is geslaagd, controleer de Rust-versie:

Terminal

$ rustc --version

Je zou output moeten zien zoals het volgende:

rustc 1.86.0 (05f9846f8 2025-03-31)

Installeer de Solana CLI

De Solana CLI biedt alle tools die nodig zijn om Solana-programma's te bouwen en te deployen.

Installeer de Solana CLI-toolsuite met het officiële installatiecommando:

Terminal

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

Je kunt stable vervangen door de release-tag die overeenkomt met de softwareversie van je gewenste release (bijv. v2.0.3), of gebruik een van de drie symbolische kanaalnamen: stable, beta, of edge.

Bij een eerste installatie van de Solana CLI zie je mogelijk het volgende bericht dat je vraagt om een PATH omgevingsvariabele toe te voegen:

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"

Als je Linux of WSL gebruikt, moet je de Solana CLI-binary toevoegen aan je PATH zodat het commando beschikbaar is in je terminal.

Voer eerst het volgende commando uit om te controleren welke shell je gebruikt:

Terminal

$ echo $SHELL

Als de output /bash bevat, gebruik dan .bashrc.
Als de output /zsh bevat, gebruik dan .zshrc.

Afhankelijk van je shell, voer het juiste commando uit.

Voor Bash (bashrc):

Terminal

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

Voor Zsh (zshrc):

Terminal

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

Voer daarna het volgende commando uit om de terminalsessie te vernieuwen of herstart je terminal.

Terminal

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

Om te verifiëren dat de installatie is geslaagd, controleer de Solana CLI versie:

Terminal

$ solana --version

Je zou output moeten zien zoals het volgende:

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

Je kunt alle beschikbare versies bekijken op de Agave Github repo.

Agave is de validator client van Anza, voorheen bekend als Solana Labs validator client.

Om later de Solana CLI bij te werken naar de nieuwste versie, kun je het volgende commando gebruiken:

Terminal

$ agave-install update

Installeer Anchor CLI

Anchor is een framework voor het ontwikkelen van Solana programma's. Het Anchor framework maakt gebruik van Rust macros om het proces van het schrijven van Solana programma's te vereenvoudigen.

Je kunt de Anchor CLI en tooling op twee manieren installeren:

Anchor Version Manager (AVM) - Aanbevolen installatiemethode
Zonder AVM - Direct installeren vanaf GitHub

De Anchor version manager (AVM) stelt je in staat om verschillende Anchor versies op je systeem te installeren en te beheren en Anchor versies in de toekomst gemakkelijk bij te werken.

Installeer AVM met het volgende commando:

Terminal

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

Bevestig dat AVM succesvol is geïnstalleerd:

Terminal

$ avm --version

Installeer de nieuwste versie van Anchor CLI met behulp van AVM:

Terminal

$ avm install latest
$ avm use latest

Je kunt een specifieke versie van Anchor CLI installeren door het versienummer op te geven:

Terminal

$ avm install 0.30.1
$ avm use 0.30.1

Vergeet niet om het avm use commando uit te voeren om de Anchor CLI versie te declareren die op je systeem moet draaien.

Als je de latest versie hebt geïnstalleerd, voer dan avm use latest uit.
Als je versie 0.30.1 hebt geïnstalleerd, voer dan avm use 0.30.1 uit.

Om te verifiëren dat de installatie is geslaagd, controleer de Anchor CLI versie:

Terminal

$ anchor --version

Je zou output moeten zien zoals het volgende:

anchor-cli 0.31.1

Bij het installeren van de Anchor CLI op Linux of WSL kun je deze fout tegenkomen:

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

Als je dit foutbericht ziet:

Installeer de afhankelijkheden die staan vermeld in de Linux sectie bovenaan deze pagina.
Probeer de Anchor CLI opnieuw te installeren.

Node.js en Yarn

Het standaard Anchor project testbestand (TypeScript) dat is aangemaakt met het anchor init commando vereist Node.js en Yarn. (Rust test template is beschikbaar via anchor init --test-template rust)

Wanneer je anchor build uitvoert en de volgende fouten tegenkomt:

Na het toepassen van de voorgaande oplossing, probeer anchor build opnieuw uit te voeren.

Bij het uitvoeren van anchor test na het aanmaken van een nieuw Anchor project op Linux of WSL, kun je de volgende fouten tegenkomen als je Node.js of Yarn niet hebt geïnstalleerd:

Permission denied (os error 13)

No such file or directory (os error 2)

AI-tools instellen voor Solana-ontwikkeling

Dit gedeelte beschrijft de optionele AI-tools die je kunt gebruiken om je Solana-ontwikkeling te versnellen.

Tool	Beschrijving	Link
MCP	MCP-server waarmee je verbinding kunt maken met cursor om Solana AI-ondersteunde ontwikkeling te verbeteren.	https://mcp.solana.com/
LLMs.txt	LLM-geoptimaliseerde documentatie die je kunt gebruiken om LLMs te trainen op Solana-docs.	https://solana.com/llms.txt

Solana CLI-basisprincipes

Deze sectie behandelt enkele veelgebruikte Solana CLI-commando's om je op weg te helpen.

Solana Config

Om je huidige configuratie te bekijken:

Terminal

$ solana config get

Je zou output moeten zien zoals het volgende:

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

De RPC URL en Websocket URL specificeren de Solana cluster waarnaar de CLI verzoeken stuurt.

Je kunt de Solana CLI cluster bijwerken met de volgende commando's:

Terminal

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

Je kunt ook de volgende korte opties gebruiken:

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

Het Keypair Pad verwijst naar de standaard Solana wallet (keypair) die door de Solana CLI wordt gebruikt om transactiekosten te betalen en programma's te implementeren. Standaard wordt dit bestand opgeslagen op ~/.config/solana/id.json.

Wallet aanmaken

Om transacties te verzenden met de Solana CLI heb je een Solana wallet nodig die gevuld is met SOL.

Om een keypair te genereren op het standaard Keypair Pad, voer het volgende commando uit:

Terminal

$ solana-keygen new

Je zou output moeten zien zoals het volgende:

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

Als je al een bestandssysteem wallet hebt opgeslagen op de standaardlocatie, zal dit commando deze niet overschrijven tenzij je expliciet forceert met de --force vlag.

Om het adres van je wallet (publieke sleutel) te bekijken, voer uit:

Terminal

$ solana address

Airdrop SOL

Vraag een airdrop van SOL aan voor je wallet om transacties en programma-implementaties te betalen.

Stel je cluster in op devnet:

Terminal

$ solana config set -ud

Vraag vervolgens een airdrop van devnet SOL aan:

Terminal

$ solana airdrop 2

Devnet airdrops beperken verzoeken tot 5 SOL per aanvraag. Als je tegen limieten aanloopt of fouten tegenkomt, probeer dan de Web Faucet te gebruiken.

Om het SOL-saldo van je wallet te controleren, voer je het volgende commando uit:

Terminal

$ solana balance

Lokale validator uitvoeren

De Solana CLI bevat een ingebouwde test validator voor lokale ontwikkeling.

Start in een apart terminalvenster een lokale validator met het volgende commando:

Terminal

$ solana-test-validator

Vergeet niet om je CLI bij te werken om localhost te gebruiken voordat je Solana CLI-commando's uitvoert:

Terminal

$ solana config set -ul

Anchor CLI basisprincipes

Deze sectie behandelt enkele veelgebruikte Anchor CLI-commando's om je op weg te helpen. Voor meer informatie over de Anchor CLI, zie de Anchor documentatie.

Project initialiseren

Om een nieuw Anchor-project te maken, voer het volgende commando uit:

Terminal

$ anchor init <project-name>

Bijvoorbeeld, om een project genaamd my-project te maken, voer uit:

Terminal

$ anchor init my-project

Dit commando maakt een nieuwe map aan met de projectnaam en initialiseert een nieuw Anchor-project met een basis Rust-programma en TypeScript-testsjabloon.

Navigeer naar de projectmap:

Terminal

$ cd <project-name>

Bekijk de bestandsstructuur van het Anchor-project.

Programma bouwen

Om je project te bouwen, voer het volgende commando uit:

Terminal

$ anchor build

Je kunt het gecompileerde programma vinden in de map /target/deploy.

Programma implementeren

Om je project te implementeren, voer het volgende commando uit:

Terminal

$ anchor deploy

Dit commando implementeert je programma naar de cluster die is gespecificeerd in het Anchor.toml bestand.

Programma testen

Om je project te testen, voer het volgende commando uit:

Terminal

$ anchor test

Dit commando bouwt, implementeert en voert de tests uit voor je project.

Wanneer je localnet gebruikt als de cluster in Anchor.toml, start Anchor automatisch een lokale validator, implementeert je programma, voert tests uit en stopt vervolgens de validator.

Installatie

Snelle installatie

Afhankelijkheden installeren

Installeer Rust

Installeer de Solana CLI

Installeer Anchor CLI

Node.js en Yarn

AI-tools instellen voor Solana-ontwikkeling

Solana CLI-basisprincipes

Solana Config

Wallet aanmaken

Airdrop SOL

Lokale validator uitvoeren

Anchor CLI basisprincipes

Project initialiseren

Programma bouwen

Programma implementeren

Programma testen

Inhoudsopgave

Windows Subsystem for Linux (WSL)

Linux

Succesvol Rust-installatiebericht

Node installatie

Yarn installatie

error: not a directory

lock file version 4 requires `-Znext-lockfile-bump

Inhoudsopgave