설치 | 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() (조합 가능): 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 서버가 실행 중이며 지정된 엔드포인트에서 접근 가능한지 확인하세요.

목차