Εγκατάσταση

Ψάχνετε για τη beta; Δείτε Εγκατάσταση Beta για Docker images και kora-cli@2.2.0-beta.7.

Ξεκινήστε με το Kora εγκαθιστώντας το εργαλείο CLI για τη λειτουργία ενός Kora node ή το TypeScript SDK για εφαρμογές-πελάτες που αλληλεπιδρούν με ένα Kora node.

Απαιτήσεις Συστήματος

Για CLI (Διακομιστής)

• Rust: Έκδοση 1.86 ή νεότερη (δεν απαιτείται για Docker)

Για TypeScript SDK (Πελάτης)

• Node.js: Έκδοση LTS ή νεότερη
• TypeScript: τελευταία έκδοση

Προαιρετικές Εξαρτήσεις

• Solana CLI: Χρήσιμο για τη δημιουργία κλειδιών και δοκιμές
• Docker: Για αναπτύξεις σε containers

Kora CLI

Το Kora CLI είναι ο κύριος τρόπος για να εκτελέσετε και να διαχειριστείτε Kora nodes. Επιλέξτε την προτιμώμενη μέθοδο εγκατάστασης:

Επιλογή 1: Εγκατάσταση από Cargo

Εγκαταστήστε απευθείας από το crates.io χρησιμοποιώντας το Cargo:

cargo install kora-cli

Επιλογή 2: Δημιουργία από τον Πηγαίο Κώδικα

Κλωνοποιήστε και δημιουργήστε την τελευταία σταθερή έκδοση από τον πηγαίο κώδικα:

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

Σημείωση: Το branch main του Kora είναι ένα branch ενσωμάτωσης και μπορεί να περιέχει αλλαγές που δεν έχουν κυκλοφορήσει ή beta αλλαγές. Κάντε πάντα checkout το τελευταίο σταθερό release tag. Δείτε τη σελίδα κυκλοφοριών για την τελευταία σταθερή έκδοση.

Αυτό θα δημιουργήσει και θα εγκαταστήσει το binary kora στον τοπικό κατάλογο Cargo bin.

Επιλογή 3: Docker

Κατεβάστε το επίσημο Docker image από το GitHub Container Registry:

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

Εκτελέστε με τα αρχεία διαμόρφωσής σας προσαρτημένα:

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

Επαλήθευση Εγκατάστασης

Επαληθεύστε ότι το Kora CLI έχει εγκατασταθεί σωστά:

kora --version

TypeScript SDK

Εγκαταστήστε το Kora TypeScript SDK για εφαρμογές-πελάτες:

pnpm add @solana/kora

Εξαρτήσεις Ομότιμων Πακέτων

Το Kora απαιτεί το @solana/kit και αρκετά πακέτα πρόσθετων Kit ως εξαρτήσεις ομότιμων πακέτων. Οι περισσότεροι διαχειριστές πακέτων (pnpm v7+, npm v7+) εγκαθιστούν αυτόματα τις εξαρτήσεις ομότιμων πακέτων, οπότε συνήθως χρειάζεστε μόνο:

pnpm add @solana/kora @solana/kit

Εάν ο διαχειριστής πακέτων σας δεν εγκαθιστά αυτόματα τα ομότιμα πακέτα, εγκαταστήστε τα χειροκίνητα:

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

Απαιτήσεις Έκδοσης

• KoraClient (αυτόνομο): Λειτουργεί με @solana/kit v5.0+
• koraPlugin() (συνθέσιμο): Απαιτεί @solana/kit v5.4+ για το μοτίβο createEmptyClient().use()
• createKitKoraClient() (πελάτης Kit): Απαιτεί @solana/kit v6.1+ για πλήρη σύνθεση πρόσθετων

Δείτε την Επισκόπηση JSON-RPC API για λεπτομερή παραδείγματα χρήσης του πελάτη.

Επαλήθευση Εγκατάστασης SDK

Επαληθεύστε την εγκατάσταση του SDK με μια απλή δοκιμή σύνδεσης:

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

Αντιμετώπιση Προβλημάτων

Προβλήματα CLI

"kora: command not found": Βεβαιωθείτε ότι το ~/.cargo/bin βρίσκεται στο PATH σας:

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

Η κατασκευή αποτυγχάνει: Ενημερώστε το Rust στην τελευταία σταθερή έκδοση:

rustup update stable

Προβλήματα SDK

Προειδοποιήσεις εξαρτήσεων ομότιμων κόμβων (peer dependency): Εγκαταστήστε τις απαιτούμενες εξαρτήσεις Solana που αναφέρονται παραπάνω.

Σφάλματα TypeScript: Βεβαιωθείτε ότι η έκδοση TypeScript είναι 4.5+ και εγκαταστήστε τους ορισμούς τύπων:

pnpm add -D @types/node

Άρνηση σύνδεσης: Βεβαιωθείτε ότι ο διακομιστής Kora εκτελείται και είναι προσβάσιμος στο καθορισμένο τελικό σημείο (endpoint).