Instal Solana CLI dan Anchor

Bagian ini mencakup langkah-langkah untuk menyiapkan lingkungan lokal Anda untuk pengembangan Solana.

Instalasi Cepat

Di Mac dan Linux, jalankan perintah tunggal ini untuk menginstal semua dependensi.

Terminal

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

Pengguna Windows: Anda harus terlebih dahulu menginstal WSL (lihat Instal Dependensi). Kemudian jalankan perintah sebelumnya di terminal Ubuntu (Linux).

Setelah instalasi, Anda akan melihat output seperti berikut:

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

Jika perintah instalasi cepat tidak berfungsi, silakan merujuk ke bagian Instal Dependensi di bawah ini untuk petunjuk menginstal setiap dependensi secara individual.

Jika perintah instalasi cepat berhasil dijalankan, lewati ke bagian Dasar-dasar Solana CLI dan Dasar-dasar Anchor CLI di bawah ini.

Instal Dependensi

Instruksi di bawah ini memandu Anda melalui proses instalasi setiap dependensi secara individual.

Pengguna Windows harus terlebih dahulu menginstal WSL (Windows subsystem for Linux) dan kemudian menginstal dependensi yang ditentukan di bagian Linux di bawah ini.
Pengguna Linux harus terlebih dahulu menginstal dependensi yang ditentukan di bagian Linux di bawah ini.
Pengguna Mac harus mulai dengan instruksi instalasi Rust di bawah ini.

Instal Rust

Pengembang membangun program Solana menggunakan bahasa pemrograman Rust.

Instal Rust dengan rustup.

Jalankan perintah berikut untuk menginstal Rust:

Terminal

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

Anda akan melihat pesan berikut setelah instalasi selesai:

Jalankan perintah berikut untuk memuat ulang variabel lingkungan PATH Anda agar menyertakan direktori bin Cargo:

Terminal

$ . "$HOME/.cargo/env"

Untuk memverifikasi bahwa instalasi berhasil, periksa versi Rust:

Terminal

$ rustc --version

Anda akan melihat output seperti berikut:

rustc 1.86.0 (05f9846f8 2025-03-31)

Instal Solana CLI

Solana CLI menyediakan semua alat yang diperlukan untuk membangun dan men-deploy program Solana.

Instal rangkaian alat Solana CLI menggunakan perintah instalasi resmi:

Terminal

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

Anda dapat mengganti stable dengan tag rilis yang sesuai dengan versi perangkat lunak dari rilis yang Anda inginkan (misalnya v2.0.3), atau gunakan salah satu dari tiga nama saluran simbolis: stable, beta, atau edge.

Untuk instalasi pertama kali Solana CLI, Anda mungkin melihat pesan berikut yang meminta Anda untuk menambahkan variabel lingkungan PATH:

Tutup dan buka kembali terminal Anda untuk menerapkan perubahan PATH atau jalankan perintah berikut di shell yang sedang aktif:

export PATH="/Users/test/.local/share/solana/install/active_release/bin:$PATH"

Jika Anda menggunakan Linux atau WSL, Anda perlu menambahkan binary Solana CLI ke PATH agar perintah tersebut tersedia di terminal Anda.

Pertama, jalankan perintah berikut untuk memeriksa shell apa yang Anda gunakan:

Terminal

$ echo $SHELL

Jika output berisi /bash, gunakan .bashrc.
Jika output berisi /zsh, gunakan .zshrc.

Tergantung pada shell Anda, jalankan perintah yang sesuai.

Untuk Bash (bashrc):

Terminal

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

Untuk Zsh (zshrc):

Terminal

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

Kemudian jalankan perintah berikut untuk menyegarkan sesi terminal atau restart terminal Anda.

Terminal

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

Untuk memverifikasi bahwa instalasi berhasil, periksa versi Solana CLI:

Terminal

$ solana --version

Anda akan melihat output seperti berikut:

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

Anda dapat melihat semua versi yang tersedia di repositori Github Agave.

Agave adalah klien validator dari Anza, yang sebelumnya dikenal sebagai klien validator Solana Labs.

Untuk memperbarui CLI Solana ke versi terbaru di kemudian hari, Anda dapat menggunakan perintah berikut:

Terminal

$ agave-install update

Instal Anchor CLI

Anchor adalah kerangka kerja untuk mengembangkan program Solana. Kerangka kerja Anchor memanfaatkan makro Rust untuk menyederhanakan proses penulisan program Solana.

Anda dapat menginstal CLI dan peralatan Anchor dengan dua cara:

Anchor Version Manager (AVM) - Metode instalasi yang direkomendasikan
Tanpa AVM - Instal langsung dari GitHub

Anchor version manager (AVM) memungkinkan Anda menginstal dan mengelola berbagai versi Anchor pada sistem Anda dan dengan mudah memperbarui versi Anchor di masa mendatang.

Instal AVM dengan perintah berikut:

Terminal

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

Konfirmasi bahwa AVM berhasil diinstal:

Terminal

$ avm --version

Instal versi terbaru Anchor CLI menggunakan AVM:

Terminal

$ avm install latest
$ avm use latest

Anda dapat menginstal versi spesifik Anchor CLI dengan menentukan nomor versi:

Terminal

$ avm install 0.30.1
$ avm use 0.30.1

Jangan lupa untuk menjalankan perintah avm use untuk mendeklarasikan versi Anchor CLI yang akan dijalankan pada sistem Anda.

Jika Anda menginstal versi latest, jalankan avm use latest.
Jika Anda menginstal versi 0.30.1, jalankan avm use 0.30.1.

Untuk memverifikasi bahwa instalasi berhasil, periksa versi Anchor CLI:

Terminal

$ anchor --version

Anda akan melihat output seperti berikut:

anchor-cli 0.31.1

Ketika menginstal Anchor CLI di Linux atau WSL, Anda mungkin mengalami error ini:

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

Jika Anda melihat pesan error ini:

Instal dependensi yang tercantum di bagian Linux di bagian atas halaman ini.
Coba kembali menginstal Anchor CLI.

Node.js dan Yarn

File tes proyek Anchor default (TypeScript) yang dibuat dengan perintah anchor init memerlukan Node.js dan Yarn. (Template tes Rust tersedia menggunakan anchor init --test-template rust)

Saat menjalankan anchor build, jika Anda mengalami error berikut:

Setelah menerapkan solusi di atas, coba jalankan anchor build lagi.

Saat menjalankan anchor test setelah membuat proyek Anchor baru di Linux atau WSL, Anda mungkin mengalami error berikut jika Anda belum menginstal Node.js atau Yarn:

Permission denied (os error 13)

No such file or directory (os error 2)

Menyiapkan alat AI untuk pengembangan Solana

Bagian ini menjelaskan pengaturan alat AI opsional yang dapat Anda gunakan untuk mempercepat pengembangan Solana Anda.

Alat	Deskripsi	Tautan
MCP	Server MCP yang dapat Anda hubungkan dengan cursor untuk meningkatkan pengembangan Solana berbantuan AI.	https://mcp.solana.com/
LLMs.txt	Dokumentasi yang dioptimalkan untuk LLM yang dapat Anda gunakan untuk melatih LLM pada dokumentasi Solana.	https://solana.com/llms.txt

Dasar-dasar CLI Solana

Bagian ini membahas beberapa perintah CLI Solana umum untuk membantu Anda memulai.

Konfigurasi Solana

Untuk melihat konfigurasi Anda saat ini:

Terminal

$ solana config get

Anda akan melihat output seperti berikut:

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

URL RPC dan URL Websocket menentukan cluster Solana yang akan dihubungi oleh CLI.

Anda dapat memperbarui cluster Solana CLI menggunakan perintah berikut:

Terminal

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

Anda juga dapat menggunakan opsi singkat berikut:

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

Jalur Keypair menunjuk ke dompet Solana default (keypair) yang digunakan oleh Solana CLI untuk membayar biaya transaksi dan men-deploy program. Secara default, file ini disimpan di ~/.config/solana/id.json.

Membuat Dompet

Untuk mengirim transaksi menggunakan Solana CLI, Anda membutuhkan dompet Solana yang telah diisi dengan SOL.

Untuk menghasilkan keypair di Jalur Keypair default, jalankan perintah berikut:

Terminal

$ solana-keygen new

Anda akan melihat output seperti berikut:

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

Jika Anda sudah memiliki dompet sistem file yang tersimpan di lokasi default, perintah ini tidak akan menimpanya kecuali Anda secara eksplisit memaksa penimpaan menggunakan flag --force.

Untuk melihat alamat dompet Anda (kunci publik), jalankan:

Terminal

$ solana address

Airdrop SOL

Minta airdrop SOL ke dompet Anda untuk membayar transaksi dan deployment program.

Atur cluster Anda ke devnet:

Terminal

$ solana config set -ud

Kemudian minta airdrop SOL devnet:

Terminal

$ solana airdrop 2

Airdrop devnet membatasi permintaan hingga 5 SOL per permintaan. Jika Anda mencapai batas atau mengalami kesalahan, coba gunakan Web Faucet sebagai alternatif.

Untuk memeriksa saldo SOL dompet Anda, jalankan perintah berikut:

Terminal

$ solana balance

Menjalankan validator lokal

Solana CLI menyertakan validator pengujian bawaan untuk pengembangan lokal.

Di terminal terpisah, jalankan perintah berikut untuk memulai validator lokal:

Terminal

$ solana-test-validator

Ingat untuk memperbarui CLI Anda agar menggunakan localhost sebelum menjalankan perintah Solana CLI:

Terminal

$ solana config set -ul

Dasar-dasar Anchor CLI

Bagian ini membahas beberapa perintah Anchor CLI umum untuk membantu Anda memulai. Untuk informasi lebih lanjut tentang Anchor CLI, lihat dokumentasi Anchor.

Inisialisasi proyek

Untuk membuat proyek Anchor baru, jalankan perintah berikut:

Terminal

$ anchor init <project-name>

Misalnya, untuk membuat proyek bernama my-project, jalankan:

Terminal

$ anchor init my-project

Perintah ini membuat direktori baru dengan nama proyek dan menginisialisasi proyek Anchor baru dengan program Rust dasar dan template pengujian TypeScript.

Navigasikan ke direktori proyek:

Terminal

$ cd <project-name>

Lihat struktur file proyek Anchor.

Membangun program

Untuk membangun proyek Anda, jalankan perintah berikut:

Terminal

$ anchor build

Anda dapat menemukan program yang telah dikompilasi di direktori /target/deploy.

Deploy Program

Untuk men-deploy proyek Anda, jalankan perintah berikut:

Terminal

$ anchor deploy

Perintah ini men-deploy program Anda ke cluster yang ditentukan dalam file Anchor.toml.

Test Program

Untuk menguji proyek Anda, jalankan perintah berikut:

Terminal

$ anchor test

Perintah ini membangun, men-deploy, dan menjalankan pengujian untuk proyek Anda.

Ketika menggunakan localnet sebagai cluster di Anchor.toml, Anchor secara otomatis memulai validator lokal, men-deploy program Anda, menjalankan pengujian, dan kemudian menghentikan validator.

Windows Subsystem for Linux (WSL)

Linux

Pesan Instalasi Rust Berhasil

Instalasi Node

Instalasi Yarn

error: not a directory

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

Daftar Isi