Довідник 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: підтверджує, що всі дозволені токени існують як дійсні mint-облікові записи
Платіжні токени: перевіряє, що всі платні SPL-токени є дійсними mint
ATA платіжної адреси: перевіряє, чи платіжна адреса має ATA для всіх дозволених токенів
Типи облікових записів: забезпечує відповідність облікових записів очікуваному типу (програма чи mint)

Керування 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

Зміст