Referensi Solana CLI

Antarmuka baris perintah solana mengonfigurasi koneksi cluster, membaca status jaringan, mengirim SOL, mengelola durable nonce, men-deploy program, dan mengoperasikan akun stake dan vote.

Referensi ini mengikuti Agave v4.2.1. Jalankan solana --version untuk memeriksa rilis yang terpasang dan gunakan --help untuk melihat opsi persis yang tersedia di versi tersebut.

Perintah yang membuat, mentransfer, mengotorisasi, menarik dana, atau men-deploy akan mengirimkan transaksi. Pastikan cluster dan signer yang dikonfigurasi sudah benar sebelum menjalankannya. Token Devnet dan Testnet tidak bernilai; perintah Mainnet menggunakan SOL sungguhan.

Struktur perintah

solana [GLOBAL_OPTIONS] <COMMAND> [COMMAND_OPTIONS]

Dapatkan bantuan di setiap tingkat:

solana --help
solana transfer --help
solana address-lookup-table extend --help

Opsi global

Opsi global dapat ditempatkan sebelum perintah. Bantuan khusus perintah mengulang opsi yang berlaku untuk perintah tersebut.

Opsi	Fungsi
`-u, --url <URL_OR_MONIKER>`	Pilih URL RPC atau `mainnet-beta`, `testnet`, `devnet`, atau `localhost`.
`--ws <URL>`	Menimpa endpoint WebSocket.
`-k, --keypair <KEYPAIR>`	Pilih file keypair, `ASK`, stdin (`-`), atau URL signer yang didukung.
`-C, --config <FILEPATH>`	Gunakan file konfigurasi CLI yang berbeda.
`--commitment <LEVEL>`	Baca pada tingkat commitment `processed`, `confirmed`, atau `finalized`.
`--output <FORMAT>`	Mengembalikan `json` atau `json-compact` jika didukung.
`--skip-preflight`	Kirim tanpa simulasi RPC. Gunakan hanya jika Anda memahami konsekuensi kegagalannya.
`--use-tpu-client`	Kirim transaksi melalui klien TPU.
`--no-address-labels`	Cetak alamat tanpa label lokal.
`--skip-seed-phrase-validation`	Izinkan frasa pemulihan di luar daftar bahasa Inggris BIP39.
`-v, --verbose`	Tampilkan output perintah tambahan.
`-V, --version`	Cetak versi CLI yang terpasang.

Mengonfigurasi CLI

# Inspect the effective configuration.
solana config get

# Use Devnet and a specific signer by default.
solana config set --url devnet
solana config set --keypair ./devnet-keypair.json

# Override defaults for one command.
solana --url mainnet-beta --keypair usb://ledger address

Konfigurasi berisi URL RPC, URL WebSocket, signer default, dan commitment. Opsi baris perintah menimpa nilai tersimpan untuk pemanggilan tersebut.

Alur kerja akun dan transaksi umum

# Print the default signer's address and balance.
solana address
solana balance

# Read an account as JSON.
solana account <ACCOUNT_ADDRESS> --output json

# Request Devnet SOL.
solana airdrop 1 --url devnet

# Send SOL and then confirm the returned signature.
solana transfer <RECIPIENT_ADDRESS> 0.1 --allow-unfunded-recipient
solana confirm <TRANSACTION_SIGNATURE>

# Inspect recent activity and stream logs mentioning an address.
solana transaction-history <ADDRESS> --limit 20
solana logs <ADDRESS>

transfer menerima SOL secara default. Gunakan ALL sebagai jumlah untuk memindahkan saldo yang tersedia setelah biaya. Untuk contoh token, lihat panduan cepat token.

Alur kerja program

# Deploy or upgrade an SBF program.
solana program deploy ./target/deploy/my_program.so

# Inspect the deployed program and list programs controlled by the signer.
solana program show <PROGRAM_ID>
solana program show --programs

# Close a program buffer and recover its lamports.
solana program close <BUFFER_ADDRESS>

Teruskan --program-id <KEYPAIR_OR_ADDRESS> ketika deployment harus menggunakan ID program tertentu. --final membuat deployment baru menjadi immutable; baca bantuannya dengan cermat sebelum menggunakannya karena upgrade authority tidak dapat dipulihkan.

Alur kerja durable nonce

solana-keygen new --outfile nonce-account.json
solana create-nonce-account nonce-account.json 0.1
solana nonce nonce-account.json
solana new-nonce nonce-account.json
solana withdraw-from-nonce-account nonce-account.json <RECIPIENT_ADDRESS> ALL

Gunakan authorize-nonce-account untuk mengubah nonce authority dan nonce-account untuk memeriksa status akun secara lengkap. Transaksi yang menggunakan nonce juga menerima --nonce dan --nonce-authority pada perintah yang didukung.

Alur kerja stake

solana-keygen new --outfile stake-account.json
solana create-stake-account stake-account.json 1
solana delegate-stake stake-account.json <VOTE_ACCOUNT_ADDRESS>
solana stake-account stake-account.json

solana deactivate-stake stake-account.json
solana withdraw-stake stake-account.json <RECIPIENT_ADDRESS> ALL

Deaktivasi selesai pada batas epoch dan dapat memakan waktu lebih dari satu epoch. Gunakan stakes, validators, stake-history, dan stake-minimum-delegation untuk memeriksa status cluster dan delegasi sebelum mengirimkan perubahan.

Utilitas alamat

# Derive a PDA from typed seeds.
solana find-program-derived-address \
  <PROGRAM_ID> \
  string:profile \
  pubkey:<OWNER_ADDRESS>

# Create and extend an address lookup table.
solana address-lookup-table create
solana address-lookup-table extend \
  <LOOKUP_TABLE_ADDRESS> \
  --addresses <ADDRESS_1>,<ADDRESS_2>

seed PDA menggunakan format PREFIX:VALUE. Prefiks yang didukung meliputi string, pubkey, hex, u8, dan encoding bilangan bulat bertanda atau tak bertanda dengan lebar tetap seperti u64le.

Pesan off-chain dan shell completion

solana sign-offchain-message "terms accepted"
solana verify-offchain-signature \
  "terms accepted" \
  <SIGNATURE> \
  --signer <SIGNER_ADDRESS>

# Print a completion script for the current shell.
solana completion --shell zsh

Indeks perintah lengkap

Indeks berikut mencakup setiap perintah tingkat atas di Agave v4.2.1. Perintah seperti program, config, feature, dan address-lookup-table berisi perintah bersarang; jalankan <command> --help untuk menampilkannya.

Perintah	Deskripsi
`account`	Tampilkan lamport, pemilik, data, dan status executable dari sebuah akun.
`address`	Cetak kunci publik dari signer yang dipilih.
`address-lookup-table`	Buat, perluas, bekukan, nonaktifkan, tutup, dan periksa address lookup table.
`airdrop`	Minta SOL dari faucet cluster.
`alpenglow-genesis-info`	Baca informasi tentang sertifikat genesis Alpenglow.
`authorize-nonce-account`	Tetapkan authority untuk akun durable nonce.
`balance`	Tampilkan saldo SOL sebuah akun.
`block`	Ambil blok terkonfirmasi berdasarkan slot.
`block-height`	Tampilkan tinggi blok saat ini.
`block-production`	Tampilkan produksi blok leader untuk rentang slot.
`block-time`	Perkirakan waktu produksi sebuah blok.
`catchup`	Tunggu hingga validator menyusul ketertinggalannya dari cluster.
`close-vote-account`	Tutup akun vote dan tarik dana yang tersisa.
`cluster-date`	Perkirakan tanggal cluster dari waktu genesis dan waktu jaringan.
`cluster-version`	Tampilkan versi perangkat lunak dari entrypoint cluster.
`completion`	Hasilkan skrip shell completion.
`config`	Dapatkan atau atur nilai default CLI.
`confirm`	Periksa status konfirmasi dari tanda tangan transaksi.
`create-address-with-seed`	Turunkan alamat sistem dari base, seed, dan ID program.
`create-nonce-account`	Buat dan inisialisasi akun durable nonce.
`create-stake-account`	Buat akun stake.
`create-stake-account-checked`	Buat akun stake sambil memeriksa withdraw authority sebagai signer.
`create-vote-account`	Buat akun vote validator.
`deactivate-stake`	Mulai menonaktifkan stake yang didelegasikan.
`decode-transaction`	Dekode transaksi yang telah diserialisasi.
`delegate-stake`	Delegasikan akun stake ke akun vote.
`epoch`	Tampilkan nomor epoch saat ini.
`epoch-info`	Tampilkan informasi epoch, slot, tinggi blok, dan jumlah transaksi.
`feature`	Periksa dan kelola akun fitur runtime.
`find-program-derived-address`	Turunkan PDA dan canonical bump dari seed bertipe.
`first-available-block`	Tampilkan blok lengkap pertama yang disimpan oleh node RPC.
`genesis-hash`	Tampilkan hash genesis cluster.
`gossip`	Daftar node yang terlihat melalui gossip.
`help`	Cetak bantuan root atau bantuan perintah.
`inflation`	Tampilkan informasi inflation governor, tingkat inflasi, atau reward.
`largest-accounts`	Daftar akun terbesar di cluster.
`leader-schedule`	Tampilkan jadwal leader.
`live-slots`	Streaming perkembangan slot saat ini.
`logs`	Streaming log transaksi, dapat difilter berdasarkan alamat.
`merge-stake`	Gabungkan akun stake yang kompatibel.
`new-nonce`	Majukan durable nonce.
`nonce`	Cetak nilai durable nonce.
`nonce-account`	Tampilkan status lengkap akun durable nonce.
`program`	Deploy, upgrade, periksa, dump, atur authority, atau tutup program dan buffer.
`recent-prioritization-fees`	Tampilkan biaya prioritas terbaru untuk akun yang dapat ditulis.
`rent`	Hitung minimum bebas rent untuk ukuran data akun.
`resolve-signer`	Petakan referensi signer umum seperti URL Ledger ke path spesifiknya.
`sign-offchain-message`	Tandatangani pesan off-chain UTF-8.
`slot`	Tampilkan slot saat ini.
`split-stake`	Pisahkan lamport dari satu akun stake ke akun stake lain.
`stake-account`	Tampilkan authority, saldo, dan status delegasi dari akun stake.
`stake-authorize`	Ubah stake authority atau withdraw authority.
`stake-authorize-checked`	Ubah stake authority sambil memeriksa authority baru sebagai signer.
`stake-history`	Tampilkan riwayat aktivasi dan deaktivasi stake di cluster.
`stake-minimum-delegation`	Tampilkan delegasi stake minimum di cluster.
`stake-set-lockup`	Atur lockup akun stake.
`stake-set-lockup-checked`	Atur lockup sambil memeriksa custodian baru sebagai signer.
`stakes`	Daftar akun stake, dapat difilter berdasarkan validator atau authority.
`supply`	Tampilkan suplai SOL yang beredar, tidak beredar, dan total.
`transaction-count`	Tampilkan jumlah transaksi di cluster.
`transaction-history`	Daftar transaksi yang melibatkan suatu alamat, dari yang terbaru hingga terlama.
`transfer`	Transfer SOL antar akun sistem.
`upgrade-nonce-account`	Upgrade akun nonce lama secara idempoten.
`validator-info`	Publikasikan atau baca informasi validator.
`validators`	Tampilkan ringkasan stake, komisi, skip rate, dan versi validator.
`verify-offchain-signature`	Verifikasi pesan off-chain yang telah ditandatangani.
`vote-account`	Tampilkan authority, komisi, kredit, dan vote dari akun vote.
`vote-authorize-voter`	Ubah voter authority dari akun vote.
`vote-authorize-voter-checked`	Ubah voter authority sambil memeriksa authority baru sebagai signer.
`vote-authorize-withdrawer`	Ubah withdraw authority dari akun vote.
`vote-authorize-withdrawer-checked`	Ubah withdraw authority sambil memeriksa authority baru sebagai signer.
`vote-update-commission`	Ubah komisi dari akun vote.
`vote-update-validator`	Ubah identitas validator yang ditetapkan ke akun vote.
`withdraw-from-nonce-account`	Tarik sebagian atau seluruh SOL dari akun durable nonce.
`withdraw-from-vote-account`	Tarik lamport dari akun vote.
`withdraw-stake`	Tarik SOL yang tidak aktif dari akun stake.

Output skrip

Gunakan --output json atau --output json-compact jika didukung, alih-alih mem-parsing output yang dapat dibaca manusia:

solana epoch-info --output json
solana account <ACCOUNT_ADDRESS> --output json-compact
solana validators --output json > validators.json

Tidak semua perintah mendukung output terstruktur. Periksa bantuan perintah sebelum mengandalkannya dalam otomatisasi, dan anggap exit status bukan nol sebagai kegagalan.

Daftar Isi