Instalacja

Szukasz wersji beta? Zobacz Instalacja Beta dla obrazów Docker i kora-cli@2.2.0-beta.7.

Rozpocznij pracę z Kora instalując narzędzie CLI do obsługi węzła Kora lub TypeScript SDK do aplikacji klienckich wchodzących w interakcję z węzłem Kora.

Wymagania systemowe

Dla CLI (Serwer)

Rust: Wersja 1.86 lub wyższa (nie jest wymagany dla Docker)

Dla TypeScript SDK (Klient)

Node.js: Wersja LTS lub wyższa
TypeScript: najnowsza wersja

Opcjonalne zależności

Solana CLI: Przydatny do generowania kluczy i testowania
Docker: Do wdrożeń konteneryzowanych

Kora CLI

Kora CLI to podstawowy sposób uruchamiania i zarządzania węzłami Kora. Wybierz preferowaną metodę instalacji:

Opcja 1: Instalacja z Cargo

Zainstaluj bezpośrednio z crates.io używając Cargo:

cargo install kora-cli

Opcja 2: Budowanie ze źródeł

Sklonuj i zbuduj najnowszą stabilną wersję ze źródeł:

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

Uwaga: Gałąź main Kora jest gałęzią integracyjną i może zawierać niewydane lub betowe zmiany. Zawsze pobieraj najnowszy stabilny tag wydania. Zobacz stronę wydań aby poznać najnowszą stabilną wersję.

Spowoduje to zbudowanie i zainstalowanie pliku binarnego kora w lokalnym katalogu bin Cargo.

Opcja 3: Docker

Pobierz oficjalny obraz Docker z GitHub Container Registry:

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

Uruchom z zamontowanymi plikami konfiguracyjnymi:

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

Weryfikacja instalacji

Sprawdź, czy interfejs CLI Kora został poprawnie zainstalowany:

kora --version

SDK TypeScript

Zainstaluj SDK TypeScript dla Kora w aplikacjach klienckich:

pnpm add @solana/kora

Kora wymaga @solana/kit oraz kilku pakietów wtyczek Kit jako zależności równorzędnych. Większość menedżerów pakietów (pnpm v7+, npm v7+) automatycznie instaluje zależności równorzędne, więc zazwyczaj wystarczy:

pnpm add @solana/kora @solana/kit

Jeśli Twój menedżer pakietów nie instaluje automatycznie zależności równorzędnych, zainstaluj je ręcznie:

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

Wymagania dotyczące wersji

KoraClient (autonomiczny): Działa z @solana/kit v5.0+
koraPlugin() (kompozytowalny): Wymaga @solana/kit v5.4+ dla wzorca createEmptyClient().use()
createKitKoraClient() (klient Kit): Wymaga @solana/kit v6.1+ dla pełnej kompozycji wtyczek

Zobacz Przegląd API JSON-RPC, aby uzyskać szczegółowe przykłady użycia klienta.

Weryfikacja instalacji SDK

Zweryfikuj instalację SDK za pomocą prostego testu połączenia:

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

Rozwiązywanie problemów

Problemy z CLI

"kora: command not found": Upewnij się, że ~/.cargo/bin znajduje się w Twojej zmiennej PATH:

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

Błąd kompilacji: Zaktualizuj Rust do najnowszej stabilnej wersji:

rustup update stable

Problemy z SDK

Ostrzeżenia dotyczące zależności równorzędnych: Zainstaluj wymagane zależności Solana wymienione powyżej.

Błędy TypeScript: Upewnij się, że używasz TypeScript w wersji 4.5+ i zainstaluj definicje typów:

pnpm add -D @types/node

Odmowa połączenia: Upewnij się, że serwer Kora jest uruchomiony i dostępny pod wskazanym adresem.