Kurulum

Beta sürümünü mü arıyorsunuz? Docker imajları ve kora-cli@2.2.0-beta.7 için Beta Kurulumu bölümüne bakın.

Bir Kora düğümü çalıştırmak için CLI aracını veya bir Kora düğümü ile etkileşime geçen istemci uygulamaları için TypeScript SDK'yı yükleyerek Kora'ya başlayın.

Sistem Gereksinimleri

CLI İçin (Sunucu)

Rust: Sürüm 1.86 veya üzeri (Docker için gerekli değildir)

TypeScript SDK İçin (İstemci)

Node.js: LTS sürümü veya üzeri
TypeScript: en son sürüm

İsteğe Bağlı Bağımlılıklar

Solana CLI: Anahtar oluşturma ve test için faydalıdır
Docker: Konteyner tabanlı dağıtımlar için

Kora CLI

Kora CLI, Kora düğümlerini çalıştırmanın ve yönetmenin birincil yoludur. Tercih ettiğiniz kurulum yöntemini seçin:

Seçenek 1: Cargo'dan Yükleme

Cargo kullanarak doğrudan crates.io üzerinden yükleyin:

cargo install kora-cli

Seçenek 2: Kaynaktan Derleme

En son kararlı sürümü kaynaktan klonlayın ve derleyin:

git clone https://github.com/solana-foundation/kora.git
cd kora
git checkout v2.0.5
just install

Not: Kora'nın main dalı bir entegrasyon dalıdır ve yayınlanmamış veya beta değişiklikler içerebilir. Her zaman en son kararlı sürüm etiketini checkout edin. En son kararlı sürüm için sürümler sayfasına bakın.

Bu, kora binary dosyasını yerel Cargo bin dizininize derleyecek ve yükleyecektir.

Seçenek 3: Docker

Resmi Docker imajını GitHub Container Registry üzerinden çekin:

docker pull ghcr.io/solana-foundation/kora:latest

Yapılandırma dosyalarınızı bağlayarak çalıştırın:

docker run -v $(pwd)/kora.toml:/app/kora.toml \
  -v $(pwd)/signers.toml:/app/signers.toml \
  -p 8080:8080 \
  ghcr.io/solana-foundation/kora:latest \
  rpc start --signers-config /app/signers.toml

Kurulumu Doğrulama

Kora CLI'nin doğru şekilde kurulduğunu doğrulayın:

kora --version

TypeScript SDK

İstemci uygulamaları için Kora TypeScript SDK'sını yükleyin:

pnpm add @solana/kora

Kora, eş bağımlılık olarak @solana/kit ve birkaç Kit eklenti paketini gerektirir. Çoğu paket yöneticisi (pnpm v7+, npm v7+) eş bağımlılıkları otomatik olarak yükler, bu nedenle genellikle yalnızca şunlara ihtiyacınız vardır:

pnpm add @solana/kora @solana/kit

Paket yöneticiniz eş bağımlılıkları otomatik olarak yüklemiyorsa, bunları manuel olarak yükleyin:

pnpm add @solana/kit @solana-program/token @solana-program/compute-budget \
  @solana/kit-plugin-instruction-plan @solana/kit-plugin-payer @solana/kit-plugin-rpc

Sürüm Gereksinimleri

KoraClient (bağımsız): @solana/kit v5.0+ ile çalışır
koraPlugin() (birleştirilebilir): createEmptyClient().use() kalıbı için @solana/kit v5.4+ gerektirir
createKitKoraClient() (Kit istemcisi): Tam eklenti birleştirme için @solana/kit v6.1+ gerektirir

Ayrıntılı istemci kullanım örnekleri için JSON-RPC API Genel Bakış bölümüne bakın.

SDK Kurulumunu Doğrulama

SDK kurulumunuzu basit bir bağlantı testiyle doğrulayın:

import { KoraClient } from "@solana/kora";

async function testConnection() {
  const client = new KoraClient({ rpcUrl: "http://localhost:8080" }); // Replace with your Kora server URL

  try {
    const config = await client.getConfig();
    console.log("✅ Successfully connected to Kora server");
  } catch (error) {
    console.error("❌ Connection failed:", error.message);
  }
}

testConnection();

Sorun Giderme

CLI Sorunları

"kora: komut bulunamadı": ~/.cargo/bin dizininin PATH'inizde olduğundan emin olun:

echo 'export PATH="$HOME/.cargo/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Derleme başarısız oluyor: Rust'ı en son kararlı sürüme güncelleyin:

rustup update stable

SDK Sorunları

Eş bağımlılık uyarıları: Yukarıda listelenen gerekli Solana bağımlılıklarını yükleyin.

TypeScript hataları: TypeScript sürümünüzün 4.5+ olduğundan emin olun ve tür tanımlarını yükleyin:

pnpm add -D @types/node

Bağlantı reddedildi: Kora sunucunuzun çalıştığından ve belirtilen uç noktada erişilebilir olduğundan emin olun.