Référence CLI

Dernière mise à jour : 2025-08-25

Référence complète de l'interface en ligne de commande Kora, incluant les commandes et les options.

Installation

cargo install kora-cli

Utilisation de base

kora [OPTIONS]

Commandes CLI courantes

Commande	Description
`kora config validate`	Valider le fichier de configuration (rapide, sans appels RPC)
`kora config validate-with-rpc`	Valider la configuration avec vérification du compte on-chain
`kora rpc start`	Démarrer le serveur RPC
`kora rpc initialize-atas`	Initialiser les ATA pour tous les jetons de paiement

Options Kora

Personnalisez le comportement de Kora avec ces options globales de ligne de commande après la commande kora :

Option	Description	Par défaut	Exemple
`--config`	Chemin vers le fichier de configuration Kora (format TOML)	`kora.toml`	`kora --config path/to/kora.toml`
`--rpc-url`	URL du point de terminaison RPC Solana	`http://127.0.0.1:8899`	`kora --rpc-url https://api.devnet.solana.com`
`--help`	Afficher les informations d'aide	-	`kora --help`
`--version`	Afficher les informations de version	-	`kora --version`

Options du serveur RPC

Configurez le serveur RPC avec ces options (utilisées avec kora rpc start) :

Option	Description	Par défaut	Exemple
`--signers-config`	Chemin vers le fichier de configuration multi-signataire (TOML)	Requis*	`--signers-config signers.toml`
`--no-load-signer`	Ignorer l'initialisation du signataire	`false`	`--no-load-signer`
`-p`, `--port`	Port HTTP pour les requêtes RPC	`8080`	`--port 3000`
`--logging-format`	Format de sortie pour les journaux (`standard` ou `json`)	`standard`	`--logging-format json`
`--help`	Afficher les informations d'aide	-	`kora rpc start --help`

*Requis sauf si vous utilisez --no-load-signer

Indicateurs d'initialisation ATA

Configurez l'initialisation ATA avec ces indicateurs (utilisés avec kora rpc initialize-atas) :

Indicateur	Description	Par défaut	Exemple
`--signers-config`	Chemin vers le fichier de configuration multi-signataire	Requis*	`--signers-config signers.toml`
`--fee-payer-key`	Clé publique du signataire à utiliser comme payeur de frais (doit être dans signers.toml)	Premier signataire	`--fee-payer-key "pubkey123..."`
`--compute-unit-price`	Frais de priorité en micro-lamports	Aucun	`--compute-unit-price 1000`
`--compute-unit-limit`	Limite d'unités de calcul pour les transactions	Aucune	`--compute-unit-limit 200000`
`--chunk-size`	Nombre d'ATA à créer par transaction	Aucun	`--chunk-size 10`

Exemples d'utilisation courante

Démarrage du serveur 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

Validation de la configuration

# 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

La commande validate-with-rpc effectue une vérification on-chain supplémentaire :

Comptes de programme : Vérifie que tous les programmes autorisés existent et sont exécutables
Tokens mint : Confirme que tous les tokens autorisés existent en tant que comptes mint valides
Tokens de paiement : Valide que tous les tokens SPL payés sont des mints valides
ATA d'adresse de paiement : Vérifie si l'adresse de paiement possède des ATA pour tous les tokens autorisés
Types de comptes : S'assure que les comptes ont le type attendu (programme vs mint)

Gestion des 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

Variables d'environnement

Ces variables d'environnement peuvent être utilisées à la place des indicateurs de ligne de commande :

Variable	Description	Équivalent indicateur
`RPC_URL`	Point de terminaison RPC Solana	`--rpc-url`

Voir également

Guide des opérateurs - Vue d'ensemble des opérateurs Kora
Guide de configuration - Options de configuration détaillées
Guide des signataires - Types de signataires et configuration
Guide d'authentification - Configuration de l'authentification API
Guide de démarrage rapide - Premiers pas avec Kora

Table des matières