Kurulum

Bu bölüm, Solana geliştirme için yerel ortamınızı kurma adımlarını kapsar.

Hızlı Kurulum

Mac ve Linux'ta, tüm bağımlılıkları kurmak için bu tek komutu çalıştırın.

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

Windows kullanıcıları: önce WSL'yi kurmalısınız (bkz. Bağımlılıkları Kur). Ardından yukarıdaki komutu Ubuntu (Linux) terminalinde çalıştırın.

Kurulumdan sonra, aşağıdakine benzer bir çıktı görmelisiniz:

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

Hızlı kurulum komutu çalışmazsa, lütfen her bir bağımlılığı ayrı ayrı kurmak için aşağıdaki Bağımlılıkları Kur bölümüne bakın.

Hızlı kurulum komutu başarıyla çalışırsa, aşağıdaki Solana CLI Temelleri ve Anchor CLI Temelleri bölümlerine geçin.

Bağımlılıkları Kur

Aşağıdaki talimatlar, her bir bağımlılığı ayrı ayrı kurma konusunda size rehberlik eder.

  • Windows kullanıcıları önce WSL'yi (Windows için Linux Alt Sistemi) kurmalı ve ardından aşağıdaki Linux bölümünde belirtilen bağımlılıkları kurmalıdır.
  • Linux kullanıcıları önce aşağıdaki Linux bölümünde belirtilen bağımlılıkları kurmalıdır.
  • Mac kullanıcıları aşağıdaki Rust kurulum talimatlarıyla başlamalıdır.

Rust'ı Yükleyin

Geliştiriciler, Solana programlarını Rust programlama dili kullanarak oluşturur.

Rust'ı rustup ile yükleyin.

Rust'ı yüklemek için aşağıdaki komutu çalıştırın:

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

Kurulum tamamlandıktan sonra aşağıdaki mesajı görmelisiniz:

PATH ortam değişkeninizi yeniden yüklemek ve Cargo'nun bin dizinini dahil etmek için aşağıdaki komutu çalıştırın:

Terminal
$
. "$HOME/.cargo/env"

Kurulumun başarılı olduğunu doğrulamak için Rust sürümünü kontrol edin:

Terminal
$
rustc --version

Aşağıdakine benzer bir çıktı görmelisiniz:

rustc 1.86.0 (05f9846f8 2025-03-31)

Solana CLI'yi yükleyin

Solana CLI, Solana programlarını oluşturmak ve dağıtmak için gereken tüm araçları sağlar.

Resmi yükleme komutu kullanarak Solana CLI araç setini yükleyin:

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

stable yerine istediğiniz sürümün yazılım sürümüyle eşleşen sürüm etiketini (örneğin v2.0.3) kullanabilir veya üç sembolik kanal adından birini kullanabilirsiniz: stable, beta veya edge.

Solana CLI'nin ilk kez kurulumunda, PATH ortam değişkeni eklemenizi isteyen aşağıdaki mesajı görebilirsiniz:

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"

Linux veya WSL kullanıyorsanız, komutun terminalinizde kullanılabilir olması için Solana CLI ikili dosyasını PATH değişkeninize eklemeniz gerekir.

Öncelikle, hangi kabuğu kullandığınızı kontrol etmek için aşağıdaki komutu çalıştırın:

Terminal
$
echo $SHELL
  • Çıktı /bash içeriyorsa, .bashrc kullanın.
  • Çıktı /zsh içeriyorsa, .zshrc kullanın.

Kabuğunuza bağlı olarak, uygun komutu çalıştırın.

Bash için (bashrc):

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

Zsh için (zshrc):

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

Ardından terminal oturumunu yenilemek veya terminalinizi yeniden başlatmak için aşağıdaki komutu çalıştırın.

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

Kurulumun başarılı olduğunu doğrulamak için Solana CLI sürümünü kontrol edin:

Terminal
$
solana --version

Aşağıdakine benzer bir çıktı görmelisiniz:

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

Mevcut tüm sürümleri Agave Github deposunda görüntüleyebilirsiniz.

Agave, eskiden Solana Labs validator istemcisi olarak bilinen Anza tarafından geliştirilen validator istemcisidir.

Daha sonra Solana CLI'yi en son sürüme güncellemek için aşağıdaki komutu kullanabilirsiniz:

Terminal
$
agave-install update

Anchor CLI'yi kurma

Anchor, Solana programları geliştirmek için bir çerçevedir. Anchor çerçevesi, Solana programları yazma sürecini basitleştirmek için Rust makrolarından yararlanır.

Anchor CLI'yi ve araçlarını iki şekilde kurabilirsiniz:

  1. Anchor Version Manager (AVM) - Önerilen kurulum yöntemi
  2. AVM olmadan - Doğrudan GitHub'dan kurulum

Anchor sürüm yöneticisi (AVM), sisteminizde farklı Anchor sürümlerini kurmanıza ve yönetmenize ve gelecekte Anchor sürümlerini kolayca güncellemenize olanak tanır.

AVM'yi aşağıdaki komutla kurun:

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

AVM'nin başarıyla kurulduğunu doğrulayın:

Terminal
$
avm --version

AVM kullanarak Anchor CLI'nin en son sürümünü yükleyin:

Terminal
$
avm install latest
$
avm use latest

Sürüm numarasını belirterek belirli bir Anchor CLI sürümünü yükleyebilirsiniz:

Terminal
$
avm install 0.30.1
$
avm use 0.30.1

Sisteminizde çalıştırılacak Anchor CLI sürümünü belirtmek için avm use komutunu çalıştırmayı unutmayın.

  • Eğer latest sürümünü yüklediyseniz, avm use latest komutunu çalıştırın.
  • Eğer 0.30.1 sürümünü yüklediyseniz, avm use 0.30.1 komutunu çalıştırın.

Kurulumun başarılı olduğunu doğrulamak için Anchor CLI sürümünü kontrol edin:

Terminal
$
anchor --version

Aşağıdakine benzer bir çıktı görmelisiniz:

anchor-cli 0.31.1

Linux veya WSL'de Anchor CLI'yi kurarken şu hatayı alabilirsiniz:

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

Bu hata mesajını görürseniz:

  1. Bu sayfanın üst kısmındaki Linux bölümünde listelenen bağımlılıkları yükleyin.
  2. Anchor CLI'yi yeniden yüklemeyi deneyin.

Node.js ve Yarn

anchor init komutuyla oluşturulan varsayılan Anchor proje test dosyası (TypeScript), Node.js ve Yarn gerektirir. (Rust test şablonu anchor init --test-template rust kullanılarak mevcuttur)

anchor build çalıştırırken, aşağıdaki hatalarla karşılaşırsanız:

Yukarıdaki çözümü uyguladıktan sonra, anchor build komutunu tekrar çalıştırmayı deneyin.

Linux veya WSL'de yeni bir Anchor projesi oluşturduktan sonra anchor test komutunu çalıştırırken, Node.js veya Yarn yüklü değilse aşağıdaki hatalarla karşılaşabilirsiniz:

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

Solana CLI temelleri

Bu bölüm, başlamanıza yardımcı olmak için bazı yaygın Solana CLI komutlarını açıklar.

Solana yapılandırması

Mevcut yapılandırmanızı görmek için:

Terminal
$
solana config get

Aşağıdakine benzer bir çıktı görmelisiniz:

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

RPC URL ve Websocket URL, CLI'nin istekleri gönderdiği Solana kümesini belirtir.

Aşağıdaki komutları kullanarak Solana CLI kümesini güncelleyebilirsiniz:

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

Ayrıca aşağıdaki kısa seçenekleri de kullanabilirsiniz:

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, Solana CLI tarafından işlem ücretlerini ödemek ve programları dağıtmak için kullanılan varsayılan Solana cüzdanını (keypair) gösterir. Varsayılan olarak, bu dosya ~/.config/solana/id.json konumunda saklanır.

Cüzdan oluştur

Solana CLI kullanarak işlem göndermek için SOL ile fonlanmış bir Solana cüzdanına ihtiyacınız vardır.

Varsayılan Keypair Path konumunda bir keypair oluşturmak için aşağıdaki komutu çalıştırın:

Terminal
$
solana-keygen new

Aşağıdakine benzer bir çıktı görmelisiniz:

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

Eğer varsayılan konumda zaten kaydedilmiş bir dosya sistemi cüzdanınız varsa, bu komut --force bayrağını kullanarak açıkça zorlamadığınız sürece üzerine yazmaz.

Cüzdanınızın adresini (açık anahtarını) görüntülemek için şunu çalıştırın:

Terminal
$
solana address

SOL airdrop al

İşlemler ve program dağıtımları için ödeme yapmak üzere cüzdanınıza SOL airdrop'u talep edin.

Kümenizi devnet'e ayarlayın:

Terminal
$
solana config set -ud

Ardından devnet SOL airdrop'u isteyin:

Terminal
$
solana airdrop 2

Devnet airdrop'ları, istek başına 5 SOL ile sınırlıdır. Eğer hız sınırlarına ulaşırsanız veya hatalarla karşılaşırsanız, bunun yerine Web Faucet kullanmayı deneyin.

Cüzdanınızın SOL bakiyesini kontrol etmek için aşağıdaki komutu çalıştırın:

Terminal
$
solana balance

Yerel validator çalıştırın

Solana CLI, yerel geliştirme için yerleşik bir test validator içerir.

Ayrı bir terminalde, yerel bir validator başlatmak için aşağıdaki komutu çalıştırın:

Terminal
$
solana-test-validator

Solana CLI komutlarını çalıştırmadan önce CLI'nizi localhost kullanacak şekilde güncellemeyi unutmayın:

Terminal
$
solana config set -ul

Anchor CLI temelleri

Bu bölüm, başlamanız için bazı yaygın Anchor CLI komutlarını açıklar. Anchor CLI hakkında daha fazla bilgi için Anchor dokümantasyonu'na bakın.

Projeyi başlatın

Yeni bir Anchor projesi oluşturmak için aşağıdaki komutu çalıştırın:

Terminal
$
anchor init <project-name>

Örneğin, my-project adında bir proje oluşturmak için şunu çalıştırın:

Terminal
$
anchor init my-project

Bu komut, proje adıyla yeni bir dizin oluşturur ve temel bir Rust programı ve TypeScript test şablonuyla yeni bir Anchor projesi başlatır.

Proje dizinine gidin:

Terminal
$
cd <project-name>

Anchor projesinin dosya yapısına bakın.

Programı Derleme

Projenizi derlemek için aşağıdaki komutu çalıştırın:

Terminal
$
anchor build

Derlenmiş programı /target/deploy dizininde bulabilirsiniz.

Programı Dağıtma

Projenizi dağıtmak için aşağıdaki komutu çalıştırın:

Terminal
$
anchor deploy

Bu komut, programınızı Anchor.toml dosyasında belirtilen cluster üzerine dağıtır.

Programı Test Etme

Projenizi test etmek için aşağıdaki komutu çalıştırın:

Terminal
$
anchor test

Bu komut, projenizi derler, dağıtır ve testleri çalıştırır.

Anchor.toml içinde cluster olarak localnet kullanıldığında, Anchor otomatik olarak yerel bir validator başlatır, programınızı dağıtır, testleri çalıştırır ve ardından validator'ı durdurur.

Is this page helpful?