Installatie

Op zoek naar de bèta? Zie Bèta-installatie voor Docker-images en kora-cli@2.2.0-beta.7.

Ga aan de slag met Kora door de CLI-tool te installeren voor het beheren van een Kora-node of de TypeScript SDK voor clientapplicaties die communiceren met een Kora-node.

Systeemvereisten

Voor CLI (Server)

Rust: Versie 1.86 of hoger (niet vereist voor Docker)

Voor TypeScript SDK (Client)

Node.js: Versie LTS of hoger
TypeScript: nieuwste versie

Optionele Afhankelijkheden

Solana CLI: Nuttig voor sleutelgeneratie en testen
Docker: Voor gecontaineriseerde implementaties

Kora CLI

De Kora CLI is de belangrijkste manier om Kora-nodes uit te voeren en te beheren. Kies je voorkeursmethode voor installatie:

Optie 1: Installeren vanuit Cargo

Installeer rechtstreeks vanuit crates.io met Cargo:

cargo install kora-cli

Optie 2: Bouwen vanuit broncode

Kloon en bouw de nieuwste stabiele versie vanuit broncode:

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

Let op: De main-branch van Kora is een integratiebranch en kan niet-uitgebrachte of bètawijzigingen bevatten. Checkout altijd de nieuwste stabiele release-tag. Zie de releasepagina voor de nieuwste stabiele versie.

Dit zal het kora-binaire bestand bouwen en installeren in je lokale Cargo bin-directory.

Optie 3: Docker

Haal de officiële Docker-image op van GitHub Container Registry:

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

Voer uit met je configuratiebestanden gemount:

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

Installatie verifiëren

Controleer of de Kora CLI correct is geïnstalleerd:

kora --version

TypeScript SDK

Installeer de Kora TypeScript SDK voor clientapplicaties:

pnpm add @solana/kora

Kora vereist @solana/kit en verschillende Kit-pluginpakketten als peer dependencies. De meeste pakketbeheerders (pnpm v7+, npm v7+) installeren peer dependencies automatisch, dus meestal heb je alleen dit nodig:

pnpm add @solana/kora @solana/kit

Als je pakketbeheerder geen peers automatisch installeert, installeer ze dan handmatig:

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

Versievereisten

KoraClient (standalone): Werkt met @solana/kit v5.0+
koraPlugin() (composable): Vereist @solana/kit v5.4+ voor het createEmptyClient().use()-patroon
createKitKoraClient() (Kit client): Vereist @solana/kit v6.1+ voor volledige plugincompositie

Zie het JSON-RPC API-overzicht voor gedetailleerde voorbeelden van clientgebruik.

SDK-installatie verifiëren

Controleer je SDK-installatie met een eenvoudige verbindingstest:

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

Probleemoplossing

CLI-problemen

"kora: command not found": Zorg ervoor dat ~/.cargo/bin in je PATH staat:

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

Build mislukt: Update Rust naar de nieuwste stabiele versie:

rustup update stable

SDK-problemen

Peer dependency waarschuwingen: Installeer de vereiste Solana-afhankelijkheden die hierboven worden vermeld.

TypeScript fouten: Zorg ervoor dat je TypeScript versie 4.5+ is en installeer typedefinities:

pnpm add -D @types/node

Verbinding geweigerd: Zorg ervoor dat je Kora-server draait en toegankelijk is op het opgegeven eindpunt.