インストール

ベータ版をお探しですか？ 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 からインストール

Cargo を使用して crates.io から直接インストールします：

cargo install kora-cli

オプション 2: ソースからビルド

最新の安定版をソースからクローンしてビルドします：

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

注意: Kora の main ブランチは統合ブランチであり、未リリースまたはベータ版の変更が含まれている場合があります。必ず最新の安定版リリースタグをチェックアウトしてください。最新の安定版については、リリースページをご覧ください。

これにより、kora バイナリがビルドされ、ローカルの Cargo bin ディレクトリにインストールされます。

オプション 3: Docker

GitHub Container Registry から公式の Docker イメージをプルします：

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()（コンポーザブル）：createEmptyClient().use()パターンのために@solana/kit v5.4+が必要です
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サーバーが実行中で、指定されたエンドポイントでアクセス可能であることを確認してください。

目次