Installation

Suchen Sie nach der Beta? Siehe Beta-Installation für Docker-Images und kora-cli@2.2.0-beta.7.

Starten Sie mit Kora, indem Sie das CLI-Tool für den Betrieb eines Kora-Knotens oder das TypeScript SDK für Client-Anwendungen installieren, die mit einem Kora-Knoten interagieren.

Systemanforderungen

Für CLI (Server)

Rust: Version 1.86 oder höher (nicht erforderlich für Docker)

Für TypeScript SDK (Client)

Node.js: Version LTS oder höher
TypeScript: neueste Version

Optionale Abhängigkeiten

Solana CLI: Hilfreich für Schlüsselerzeugung und Tests
Docker: Für containerisierte Deployments

Kora CLI

Die Kora CLI ist die primäre Methode zum Ausführen und Verwalten von Kora-Knoten. Wählen Sie Ihre bevorzugte Installationsmethode:

Option 1: Installation über Cargo

Installieren Sie direkt von crates.io mit Cargo:

cargo install kora-cli

Option 2: Aus Quellcode erstellen

Klonen und erstellen Sie die neueste stabile Version aus dem Quellcode:

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

Hinweis: Koras main-Branch ist ein Integrations-Branch und kann unveröffentlichte oder Beta-Änderungen enthalten. Checken Sie immer den neuesten stabilen Release-Tag aus. Siehe die Releases-Seite für die neueste stabile Version.

Dies wird die kora-Binärdatei erstellen und in Ihrem lokalen Cargo-Bin-Verzeichnis installieren.

Option 3: Docker

Laden Sie das offizielle Docker-Image aus der GitHub Container Registry herunter:

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

Führen Sie es mit Ihren gemounteten Konfigurationsdateien aus:

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

Installation überprüfen

Überprüfen Sie, ob die Kora CLI korrekt installiert wurde:

kora --version

TypeScript SDK

Installieren Sie das Kora TypeScript SDK für Client-Anwendungen:

pnpm add @solana/kora

Kora benötigt @solana/kit und mehrere Kit-Plugin-Pakete als Peer-Abhängigkeiten. Die meisten Paketmanager (pnpm v7+, npm v7+) installieren Peer-Abhängigkeiten automatisch, daher benötigen Sie in der Regel nur:

pnpm add @solana/kora @solana/kit

Wenn Ihr Paketmanager Peers nicht automatisch installiert, installieren Sie diese manuell:

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

Versionsanforderungen

KoraClient (eigenständig): Funktioniert mit @solana/kit v5.0+
koraPlugin() (kombinierbar): Erfordert @solana/kit v5.4+ für das createEmptyClient().use()-Muster
createKitKoraClient() (Kit-Client): Erfordert @solana/kit v6.1+ für vollständige Plugin-Komposition

Detaillierte Beispiele zur Client-Nutzung finden Sie in der JSON-RPC API-Übersicht.

SDK-Installation überprüfen

Überprüfen Sie Ihre SDK-Installation mit einem einfachen Verbindungstest:

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

Fehlerbehebung

CLI-Probleme

"kora: Befehl nicht gefunden": Stellen Sie sicher, dass ~/.cargo/bin in Ihrem PATH enthalten ist:

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

Build schlägt fehl: Aktualisieren Sie Rust auf die neueste stabile Version:

rustup update stable

SDK-Probleme

Peer-Dependency-Warnungen: Installieren Sie die oben aufgeführten erforderlichen Solana-Abhängigkeiten.

TypeScript-Fehler: Stellen Sie sicher, dass Ihre TypeScript-Version 4.5+ ist, und installieren Sie die Typdefinitionen:

pnpm add -D @types/node

Verbindung abgelehnt: Stellen Sie sicher, dass Ihr Kora-Server läuft und am angegebenen Endpunkt erreichbar ist.

Inhaltsverzeichnis