최종 업데이트: 2025-08-25
명령어 및 플래그를 포함한 Kora 커맨드라인 인터페이스의 완전한 레퍼런스입니다.
설치
cargo install kora-cli
기본 사용법
kora [OPTIONS]
일반 CLI 명령어
| 명령어 | 설명 |
|---|---|
kora config validate | 구성 파일 검증 (빠름, RPC 호출 없음) |
kora config validate-with-rpc | 온체인 계정 검증을 통한 구성 검증 |
kora rpc start | RPC 서버 시작 |
kora rpc initialize-atas | 모든 결제 토큰에 대한 ATA 초기화 |
Kora 플래그
kora 명령어 뒤에 다음 전역 커맨드라인 플래그를 사용하여 Kora의 동작을 사용자
지정할 수 있습니다:
| 플래그 | 설명 | 기본값 | 예시 |
|---|---|---|---|
--config | Kora 구성 파일 경로 (TOML 형식) | kora.toml | kora --config path/to/kora.toml |
--rpc-url | Solana RPC 엔드포인트 URL | http://127.0.0.1:8899 | kora --rpc-url https://api.devnet.solana.com |
--help | 도움말 정보 출력 | - | kora --help |
--version | 버전 정보 출력 | - | kora --version |
RPC 서버 플래그
kora rpc start와 함께 사용되는 다음 플래그로 RPC 서버를 구성할 수 있습니다:
| 플래그 | 설명 | 기본값 | 예시 |
|---|---|---|---|
--signers-config | 멀티 서명자 구성 파일 경로 (TOML) | 필수* | --signers-config signers.toml |
--no-load-signer | 서명자 초기화 건너뛰기 | false | --no-load-signer |
-p, --port | RPC 요청을 위한 HTTP 포트 | 8080 | --port 3000 |
--logging-format | 로그 출력 형식 (standard 또는 json) | standard | --logging-format json |
--help | 도움말 정보 출력 | - | kora rpc start --help |
*--no-load-signer를 사용하지 않는 경우 필수
ATA 초기화 플래그
다음 플래그를 사용하여 ATA 초기화를 구성합니다(kora rpc initialize-atas와 함께
사용):
| 플래그 | 설명 | 기본값 | 예시 |
|---|---|---|---|
--signers-config | 다중 서명자 구성 파일 경로 | 필수* | --signers-config signers.toml |
--fee-payer-key | 수수료 지불자로 사용할 서명자의 공개키(signers.toml에 있어야 함) | 첫 번째 서명자 | --fee-payer-key "pubkey123..." |
--compute-unit-price | 마이크로 램포트 단위의 우선순위 수수료 | 없음 | --compute-unit-price 1000 |
--compute-unit-limit | 트랜잭션의 컴퓨팅 유닛 제한 | 없음 | --compute-unit-limit 200000 |
--chunk-size | 트랜잭션당 생성할 ATA 수 | 없음 | --chunk-size 10 |
일반적인 사용 예시
RPC 서버 시작하기
# Basic start with default settingskora --config path/to/kora.toml rpc start --signers-config path/to/signers.toml# Start with custom port and configkora --config path/to/kora.toml rpc start \--signers-config path/to/signers.toml \--port 8080 \--logging-format json# Start for testing without signerskora --config path/to/kora.toml rpc start --no-load-signer
구성 검증
# Quick validation (offline)kora --config path/to/kora.toml config validate# Thorough validation with RPC checkskora --config path/to/kora.toml --rpc-url https://api.mainnet-beta.solana.com \config validate-with-rpc
validate-with-rpc 명령은 추가적인 온체인 검증을 수행합니다:
- 프로그램 계정: 허용된 모든 프로그램이 존재하고 실행 가능한지 확인합니다
- 토큰 민트: 허용된 모든 토큰이 유효한 민트 계정으로 존재하는지 확인합니다
- 결제 토큰: 모든 SPL 유료 토큰이 유효한 민트인지 검증합니다
- 결제 주소 ATA: 결제 주소가 허용된 모든 토큰에 대한 ATA를 보유하고 있는지 확인합니다
- 계정 유형: 계정이 예상되는 유형(프로그램 vs 민트)을 가지고 있는지 확인합니다
ATA 관리
# Initialize ATAs for payment address/signerskora rpc initialize-atas --signers-config signers.toml# Initialize with custom fee payer and prioritykora rpc initialize-atas \--signers-config signers.toml \--fee-payer-key "7xKXtg2CW87d3HEQ2BpKHpcPKBhpKGQPPRQJyccVLow9" \--compute-unit-price 1000 \--chunk-size 10
환경 변수
다음 환경 변수를 명령줄 플래그 대신 사용할 수 있습니다:
| 변수 | 설명 | 동등한 플래그 |
|---|---|---|
RPC_URL | 솔라나 RPC 엔드포인트 | --rpc-url |
참고 자료
Is this page helpful?