Installazione

Cerchi la versione beta? Consulta Installazione Beta per le immagini Docker e kora-cli@2.2.0-beta.7.

Inizia a usare Kora installando lo strumento CLI per gestire un nodo Kora o l'SDK TypeScript per applicazioni client che interagiscono con un nodo Kora.

Requisiti di Sistema

Per la CLI (Server)

Rust: Versione 1.86 o superiore (non richiesto per Docker)

Per l'SDK TypeScript (Client)

Node.js: Versione LTS o superiore
TypeScript: ultima versione

Dipendenze Opzionali

CLI di Solana: Utile per la generazione di chiavi e i test
Docker: Per distribuzioni containerizzate

CLI di Kora

La CLI di Kora è il metodo principale per eseguire e gestire i nodi Kora. Scegli il tuo metodo di installazione preferito:

Opzione 1: Installa da Cargo

Installa direttamente da crates.io usando Cargo:

cargo install kora-cli

Opzione 2: Compila dal Codice Sorgente

Clona e compila l'ultima versione stabile dal codice sorgente:

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

Nota: Il branch main di Kora è un branch di integrazione e potrebbe contenere modifiche non rilasciate o in versione beta. Esegui sempre il checkout dell'ultimo tag di rilascio stabile. Consulta la pagina dei rilasci per l'ultima versione stabile.

Questo compilerà e installerà il file binario kora nella tua directory bin locale di Cargo.

Opzione 3: Docker

Scarica l'immagine Docker ufficiale dal GitHub Container Registry:

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

Esegui con i tuoi file di configurazione montati:

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

Verifica dell'Installazione

Verifica che la CLI di Kora sia installata correttamente:

kora --version

SDK TypeScript

Installa l'SDK TypeScript di Kora per le applicazioni client:

pnpm add @solana/kora

Kora richiede @solana/kit e diversi pacchetti plugin Kit come dipendenze peer. La maggior parte dei gestori di pacchetti (pnpm v7+, npm v7+) installa automaticamente le dipendenze peer, quindi in genere è sufficiente:

pnpm add @solana/kora @solana/kit

Se il tuo gestore di pacchetti non installa automaticamente le dipendenze peer, installale manualmente:

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

Requisiti di Versione

KoraClient (standalone): Funziona con @solana/kit v5.0+
koraPlugin() (componibile): Richiede @solana/kit v5.4+ per il pattern createEmptyClient().use()
createKitKoraClient() (client Kit): Richiede @solana/kit v6.1+ per la composizione completa dei plugin

Consulta la Panoramica dell'API JSON-RPC per esempi dettagliati sull'utilizzo del client.

Verifica dell'Installazione dell'SDK

Verifica l'installazione dell'SDK con un semplice test di connessione:

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

Risoluzione dei Problemi

Problemi con la CLI

"kora: comando non trovato": Assicurati che ~/.cargo/bin sia nel tuo PATH:

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

Errore di build: Aggiorna Rust all'ultima versione stabile:

rustup update stable

Problemi con l'SDK

Avvisi sulle dipendenze peer: Installa le dipendenze Solana richieste elencate sopra.

Errori TypeScript: Assicurati che la tua versione di TypeScript sia 4.5+ e installa le definizioni dei tipi:

pnpm add -D @types/node

Connessione rifiutata: Assicurati che il tuo server Kora sia in esecuzione e accessibile all'endpoint specificato.