Установка

Ищете бета-версию? См. Установка бета-версии для 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

Установите TypeScript SDK для Kora для клиентских приложений:

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: команда не найдена": Убедитесь, что ~/.cargo/bin находится в вашем PATH:

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

Сборка завершается с ошибкой: Обновите Rust до последней стабильной версии:

rustup update stable

Проблемы с SDK

Предупреждения о peer-зависимостях: Установите необходимые зависимости Solana, перечисленные выше.

Ошибки TypeScript: Убедитесь, что используется TypeScript версии 4.5 или выше, и установите определения типов:

pnpm add -D @types/node

Отказ в соединении: Убедитесь, что ваш сервер Kora запущен и доступен по указанному эндпоинту.