Instalasi

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 untuk petunjuk menginstal setiap dependensi secara individual.

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

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 memulai 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 software yang Anda inginkan (misalnya v2.0.3), atau gunakan salah satu dari tiga nama channel simbolis: stable, beta, atau edge.

Untuk instalasi pertama kali Solana CLI, Anda mungkin akan melihat pesan berikut yang meminta Anda untuk menambahkan variabel lingkungan 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"

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

Pertama, jalankan perintah berikut untuk memeriksa shell mana 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 Repo Github Agave.

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

Untuk memperbarui Solana CLI ke versi terbaru nanti, Anda dapat menggunakan perintah berikut:

Terminal
$
agave-install update

Instal Anchor CLI

Anchor adalah framework untuk mengembangkan program Solana. Framework Anchor memanfaatkan makro Rust untuk menyederhanakan proses penulisan program Solana.

Anda dapat menginstal Anchor CLI dan peralatannya dengan dua cara:

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

Anchor version manager (AVM) memungkinkan Anda menginstal dan mengelola berbagai versi Anchor di 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 Anchor CLI tertentu dengan menentukan nomor versinya:

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

Saat 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:

  1. Instal dependensi yang tercantum di bagian Linux di bagian atas halaman ini.
  2. Coba instal ulang 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)

Ketika 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 Node.js atau Yarn belum terpasang:

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

Dasar-dasar Solana CLI

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

Konfigurasi Solana

Untuk melihat konfigurasi 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 digunakan CLI untuk membuat permintaan.

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

Keypair Path menunjuk ke dompet Solana (keypair) default 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 memerlukan dompet Solana yang diisi dengan SOL.

Untuk menghasilkan keypair di Keypair Path 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 disimpan 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 rate atau mengalami error, coba gunakan Web Faucet sebagai alternatif.

Untuk memeriksa saldo SOL dompet Anda, jalankan perintah berikut:

Terminal
$
solana balance

Menjalankan validator lokal

Solana CLI menyertakan test validator 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.

Navigasi ke direktori proyek:

Terminal
$
cd <project-name>

Lihat struktur file proyek Anchor.

Build 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.

Is this page helpful?

Daftar Isi

Edit Halaman