Asennus

Etsitkö betaa? Katso Beta-asennus Docker-kuville ja kora-cli@2.2.0-beta.7.

Aloita Koran käyttö asentamalla CLI-työkalu Kora-noden käyttämiseen tai TypeScript SDK -kehitysympäristö asiakassovelluksille, jotka kommunikoivat Kora-noden kanssa.

Järjestelmävaatimukset

CLI:lle (palvelin)

Rust: Versio 1.86 tai uudempi (ei vaadita Dockerille)

TypeScript SDK:lle (asiakas)

Node.js: LTS-versio tai uudempi
TypeScript: uusin versio

Valinnaiset riippuvuudet

Solana CLI: Hyödyllinen avainten luomiseen ja testaukseen
Docker: Konttipohjaisia asennuksia varten

Kora CLI

Kora CLI on ensisijainen tapa käyttää ja hallita Kora-nodeja. Valitse haluamasi asennustapa:

Vaihtoehto 1: Asenna Cargosta

Asenna suoraan crates.io-palvelusta käyttämällä Cargoa:

cargo install kora-cli

Vaihtoehto 2: Käännä lähdekoodista

Kloonaa ja käännä uusin vakaa versio lähdekoodista:

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

Huomio: Koran main-haara on integrointihaara ja saattaa sisältää julkaisemattomia tai beta-muutoksia. Checkout aina uusin vakaa julkaisuversio. Katso julkaisusivulta uusin vakaa versio.

Tämä kääntää ja asentaa kora-binäärin paikalliseen Cargo bin -hakemistoosi.

Vaihtoehto 3: Docker

Hae virallinen Docker-kuva GitHub Container Registrystä:

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

Suorita määritystiedostosi liitettynä:

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

Asennuksen varmistaminen

Varmista, että Kora CLI on asennettu oikein:

kora --version

TypeScript SDK

Asenna Kora TypeScript SDK -kehitysympäristö asiakassovelluksille:

pnpm add @solana/kora

Kora vaatii @solana/kit-kirjaston ja useita Kit-laajennuspaketteja vertaisriippuvuuksina. Useimmat paketinhallintaohjelmat (pnpm v7+, npm v7+) asentavat vertaisriippuvuudet automaattisesti, joten tavallisesti tarvitset vain:

pnpm add @solana/kora @solana/kit

Jos paketinhallintaohjelmasi ei asenna vertaisriippuvuuksia automaattisesti, asenna ne manuaalisesti:

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

Versiovaatimukset

KoraClient (itsenäinen): Toimii @solana/kit v5.0+ -version kanssa
koraPlugin() (koostettava): Vaatii @solana/kit v5.4+ -version createEmptyClient().use()-mallia varten
createKitKoraClient() (Kit-asiakasohjelma): Vaatii @solana/kit v6.1+ -version täydelliseen laajennusten koostamiseen

Katso yksityiskohtaiset esimerkit asiakaskäytöstä sivulta JSON-RPC API -yleiskatsaus.

SDK-asennuksen varmistaminen

Varmista SDK-asennuksesi yksinkertaisella yhteystestillä:

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

Vianmääritys

CLI-ongelmat

"kora: komentoa ei löydy": Varmista, että ~/.cargo/bin on PATH-ympäristömuuttujassasi:

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

Käännös epäonnistuu: Päivitä Rust uusimpaan vakaaseen versioon:

rustup update stable

SDK-ongelmat

Vertaisriippuvuusvaroitukset: Asenna yllä luetellut vaaditut Solana-riippuvuudet.

TypeScript-virheet: Varmista, että TypeScript-versiosi on 4.5+ ja asenna tyyppimääritykset:

pnpm add -D @types/node

Yhteys evätty: Varmista, että Kora-palvelimesi on käynnissä ja käytettävissä määritetyssä päätepisteessä.