Справочник CLI

Последнее обновление: 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`	URL конечной точки Solana RPC	`http://127.0.0.1:8899`	`kora --rpc-url https://api.devnet.solana.com`
`--help`	Вывести справочную информацию	-	`kora --help`
`--version`	Вывести информацию о версии	-	`kora --version`

Флаги RPC-сервера

Настройте RPC-сервер с помощью этих флагов (используются с kora rpc start):

Флаг	Описание	По умолчанию	Пример
`--signers-config`	Путь к файлу конфигурации мультиподписанта (TOML)	Обязательно*	`--signers-config signers.toml`
`--no-load-signer`	Пропустить инициализацию подписанта	`false`	`--no-load-signer`
`-p`, `--port`	HTTP-порт для RPC-запросов	`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 settings
kora --config path/to/kora.toml rpc start --signers-config path/to/signers.toml

# Start with custom port and config
kora --config path/to/kora.toml rpc start \
  --signers-config path/to/signers.toml \
  --port 8080 \
  --logging-format json

# Start for testing without signers
kora --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 checks
kora --config path/to/kora.toml --rpc-url https://api.mainnet-beta.solana.com \
  config validate-with-rpc

Команда validate-with-rpc выполняет дополнительную верификацию в блокчейне:

Аккаунты программ: Проверяет, что все разрешённые программы существуют и являются исполняемыми
Токен-минты: Подтверждает, что все разрешённые токены существуют как валидные mint account
Токены для оплаты: Проверяет, что все SPL-токены для оплаты являются валидными минтами
ATA адресов оплаты: Проверяет наличие у адреса оплаты ATA для всех разрешённых токенов
Типы аккаунтов: Гарантирует, что аккаунты имеют ожидаемый тип (программа или минт)

Управление ATA

# Initialize ATAs for payment address/signers
kora rpc initialize-atas --signers-config signers.toml

# Initialize with custom fee payer and priority
kora rpc initialize-atas \
  --signers-config signers.toml \
  --fee-payer-key "7xKXtg2CW87d3HEQ2BpKHpcPKBhpKGQPPRQJyccVLow9" \
  --compute-unit-price 1000 \
  --chunk-size 10

Переменные окружения

Эти переменные окружения могут использоваться вместо флагов командной строки:

Переменная	Описание	Эквивалентный флаг
`RPC_URL`	Конечная точка Solana RPC	`--rpc-url`

См. также

Руководство для операторов - Обзор операторов Kora
Руководство по конфигурации - Детальные параметры конфигурации
Руководство по подписантам - Типы подписантов и конфигурация
Руководство по аутентификации - Настройка аутентификации API
Руководство по быстрому старту - Начало работы с Kora

Содержание