Встановлення

Шукаєте бета-версію? Перегляньте Встановлення бета-версії для Docker-образів та kora-cli@2.2.0-beta.7.

Почніть роботу з Kora, встановивши CLI-інструмент для керування вузлом Kora або TypeScript SDK для клієнтських застосунків, що взаємодіють з вузлом Kora.

Системні вимоги

Для CLI (Сервер)

Rust: Версія 1.86 або вища (не потрібна для Docker)

Для TypeScript SDK (Клієнт)

Node.js: Версія LTS або вища
TypeScript: остання версія

Опціональні залежності

Solana CLI: Корисно для генерації ключів та тестування
Docker: Для контейнеризованих розгортань

Kora CLI

Kora CLI — це основний спосіб запуску та керування вузлами Kora. Оберіть зручний для вас метод встановлення:

Варіант 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

Примітка: Гілка main у Kora є інтеграційною гілкою і може містити невипущені або бета-зміни. Завжди переходьте на останній тег стабільного релізу. Перегляньте сторінку релізів для останньої стабільної версії.

Це зібере та встановить бінарний файл kora у вашу локальну директорію Cargo bin.

Варіант 3: Docker

Завантажте офіційний Docker-образ з 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

Попередження про залежності однорангових пакетів: Встановіть необхідні залежності Solana, перелічені вище.

Помилки TypeScript: Переконайтеся, що ваша версія TypeScript 4.5+ і встановіть визначення типів:

pnpm add -D @types/node

Відмовлено в з'єднанні: Переконайтеся, що ваш сервер Kora запущено і доступний за вказаною адресою.

Зміст