安装 | Solana

正在寻找测试版？ 请参阅测试版安装获取 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()（可组合版）：需要 @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 服务器正在运行并且可以通过指定的端点访问。

Table of Contents