Instalasi

Mencari versi beta? Lihat Instalasi Beta untuk Docker image dan kora-cli@2.2.0-beta.7.

Mulai dengan Kora dengan menginstal alat CLI untuk mengoperasikan node Kora atau TypeScript SDK untuk aplikasi klien yang berinteraksi dengan node Kora.

Persyaratan Sistem

Untuk CLI (Server)

Rust: Versi 1.86 atau lebih tinggi (tidak diperlukan untuk Docker)

Untuk TypeScript SDK (Klien)

Node.js: Versi LTS atau lebih tinggi
TypeScript: versi terbaru

Dependensi Opsional

Solana CLI: Berguna untuk pembuatan kunci dan pengujian
Docker: Untuk deployment berbasis kontainer

Kora CLI

Kora CLI adalah cara utama untuk menjalankan dan mengelola node Kora. Pilih metode instalasi yang Anda inginkan:

Opsi 1: Instal dari Cargo

Instal langsung dari crates.io menggunakan Cargo:

cargo install kora-cli

Opsi 2: Build dari Source

Clone dan build versi stabil terbaru dari source:

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

Catatan: Branch main Kora adalah branch integrasi dan mungkin berisi perubahan yang belum dirilis atau beta. Selalu checkout tag rilis stabil terbaru. Lihat halaman rilis untuk versi stabil terbaru.

Ini akan mem-build dan menginstal binary kora ke direktori bin Cargo lokal Anda.

Opsi 3: Docker

Pull Docker image resmi dari GitHub Container Registry:

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

Jalankan dengan file konfigurasi Anda yang di-mount:

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

Verifikasi Instalasi

Verifikasi bahwa Kora CLI telah terpasang dengan benar:

kora --version

TypeScript SDK

Instal Kora TypeScript SDK untuk aplikasi klien:

pnpm add @solana/kora

Kora memerlukan @solana/kit dan beberapa paket plugin Kit sebagai dependensi peer. Sebagian besar manajer paket (pnpm v7+, npm v7+) menginstal dependensi peer secara otomatis, jadi biasanya Anda hanya perlu:

pnpm add @solana/kora @solana/kit

Jika manajer paket Anda tidak menginstal peer secara otomatis, instal secara manual:

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

Persyaratan Versi

KoraClient (standalone): Berfungsi dengan @solana/kit v5.0+
koraPlugin() (composable): Memerlukan @solana/kit v5.4+ untuk pola createEmptyClient().use()
createKitKoraClient() (Kit client): Memerlukan @solana/kit v6.1+ untuk komposisi plugin penuh

Lihat Ringkasan JSON-RPC API untuk contoh penggunaan klien secara rinci.

Verifikasi Instalasi SDK

Verifikasi instalasi SDK Anda dengan tes koneksi sederhana:

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();

Pemecahan Masalah

Masalah CLI

"kora: command not found": Pastikan ~/.cargo/bin ada di PATH Anda:

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

Build gagal: Perbarui Rust ke versi stabil terbaru:

rustup update stable

Masalah SDK

Peringatan peer dependency: Instal dependensi Solana yang diperlukan seperti yang tercantum di atas.

Error TypeScript: Pastikan versi TypeScript Anda adalah 4.5+ dan instal definisi tipe:

pnpm add -D @types/node

Koneksi ditolak: Pastikan server Kora Anda berjalan dan dapat diakses di endpoint yang ditentukan.