Een handleiding voor het opzetten van je lokale Solana-ontwikkelomgeving. Leer hoe je Rust, de Solana CLI en Anchor Framework installeert op Windows (WSL), Linux en Mac. Gebruik deze handleiding als je liever elke afhankelijkheid afzonderlijk installeert, of als de snelle installatie om welke reden dan ook mislukt.
Vereisten
Installeer Rust
Ontwikkelaars bouwen Solana-programma's met behulp van de programmeertaal Rust.
- Installeer Rust met behulp van rustup door het volgende commando in je terminal in te voeren:
$curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
Na een succesvolle installatie zie je het volgende bericht:
- Herlaad je PATH-omgevingsvariabele om de bin-directory van Cargo op te nemen:
$. "$HOME/.cargo/env"
- Controleer of de installatie succesvol was.
$rustc --version
Je zult output zien zoals het volgende:
rustc 1.86.0 (05f9846f8 2025-03-31)
Installeer 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 behulp van het officiële installatiecommando:
$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.
- Voeg een PATH-omgevingsvariabele toe
Een eerste installatie van de Solana CLI kan je vragen om een PATH
omgevingsvariabele toe te voegen. Om dit te doen, sluit en heropen je terminal
of voer het volgende uit in je shell:
export PATH="/Users/test/.local/share/solana/install/active_release/bin:$PATH"
- Update je PATH-omgevingsvariabele
Als je Linux of WSL gebruikt, moet je het Solana CLI-binaire bestand aan je PATH toevoegen zodat het commando beschikbaar is in je terminal. Volg hiervoor de onderstaande stappen:
a. Controleer welke shell je gebruikt:
$echo $SHELL
- Als de output
/bashbevat, gebruik dan.bashrc. - Als de output
/zshbevat, gebruik dan.zshrc.
b. Voer het juiste commando uit, afhankelijk van je shell.
Voor Bash (bashrc):
$echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.bashrc$source ~/.bashrc
Voor Zsh (zshrc):
$echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.zshrc$source ~/.zshrc
- Herstart je terminal of voer het volgende commando uit om de terminal sessie te vernieuwen:
$source ~/.bashrc # If using Bash$source ~/.zshrc # If using Zsh
- Controleer of de installatie is geslaagd door de Solana CLI versie te controleren:
$solana --version
Je ziet output 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.
- Update de Solana CLI naar de nieuwste versie, indien nodig (Optioneel)
$agave-install update
Installeer Anchor CLI
Anchor is een framework voor het ontwikkelen van Solana-programma's. Het Anchor-framework maakt gebruik van Rust-macro's om het proces van het schrijven van Solana-programma's te vereenvoudigen.
Vereisten
Het standaard Anchor-projecttestbestand (TypeScript) dat is aangemaakt met het
commando anchor init vereist Node.js en Yarn. (De Rust-testtemplate is
beschikbaar via anchor init --test-template rust)
Installatie
Je kunt de Anchor CLI en tooling op twee manieren installeren:
- Anchor Version Manager (AVM) — aanbevolen installatiemethode
- Zonder AVM — installeer rechtstreeks vanaf GitHub
De Anchor Version Manager (AVM) stelt je in staat om verschillende Anchor-versies op je systeem te installeren en te beheren, en om in de toekomst eenvoudig Anchor-versies bij te werken. Volg de onderstaande stappen om Anchor te installeren met AVM:
- Installeer AVM met het volgende commando:
$cargo install --git https://github.com/solana-foundation/anchor avm --force
- Bevestig dat AVM succesvol is geïnstalleerd:
$avm --version
- Installeer Anchor CLI met behulp van AVM:
Om de nieuwste versie te installeren:
$avm install latest$avm use latest
Om een specifieke versie te installeren, geef het versienummer op:
$avm install 0.30.1$avm use 0.30.1
Bij het installeren van de Anchor CLI op Linux of WSL, kun je deze foutmelding tegenkomen:
error: could not exec the linker cc = note: Permission denied (os error 13)
Als je deze foutmelding ziet, volg dan deze stappen:
- Installeer de afhankelijkheden die vermeld staan in de sectie Linux bovenaan deze pagina.
- Probeer de Anchor CLI opnieuw te installeren.
- Verifieer dat de installatie is geslaagd door de Anchor CLI-versie te controleren:
$anchor --version
Je ziet output zoals het volgende:
anchor-cli 0.31.1
Vergeet niet om het commando avm use uit te voeren om de Anchor
CLI-versie te declareren die op je systeem moet draaien.
- Als je de versie
latesthebt geïnstalleerd, voer danavm use latestuit. - Als je de versie
0.30.1hebt geïnstalleerd, voer danavm use 0.30.1uit.
Installeer Surfpool CLI
Surfpool is een tool voor lokale ontwikkeling en een
verbeterde vervanging voor solana-test-validator. Lees meer over de functies
van Surfpool in de Surfpool-documentatie.
- Installeer Surfpool met het volgende commando:
$curl -sL https://run.surfpool.run/ | bash
- Verifieer dat de installatie is gelukt door de Surfpool CLI-versie te controleren:
$surfpool --version
Je ziet output zoals het volgende:
surfpool 0.12.0
Stel AI-tooling in voor Solana-ontwikkeling
Deze sectie beschrijft optionele AI-tooling die je kunt gebruiken om je Solana-ontwikkeling te versnellen.
| Tool | Beschrijving | Link |
|---|---|---|
| MCP | MCP-server waarmee je kunt verbinden met cursor om AI-ondersteunde Solana-ontwikkeling te verbeteren. | https://mcp.solana.com/ |
| LLMs.txt | LLM-geoptimaliseerde documentatie die je kunt gebruiken om LLM's te trainen op Solana-docs. | https://solana.com/llms.txt |
Is this page helpful?