CLI-Referenz

Zuletzt aktualisiert: 25.08.2025

Vollständige Referenz für die Kora-Befehlszeilenschnittstelle, einschließlich Befehlen und Flags.

Installation

cargo install kora-cli

Grundlegende Verwendung

kora [OPTIONS]

Häufige CLI-Befehle

Befehl	Beschreibung
`kora config validate`	Konfigurationsdatei validieren (schnell, keine RPC-Aufrufe)
`kora config validate-with-rpc`	Konfiguration mit On-Chain-Kontenverifizierung validieren
`kora rpc start`	RPC-Server starten
`kora rpc initialize-atas`	ATAs für alle Zahlungstoken initialisieren

Kora-Flags

Passen Sie das Verhalten von Kora mit diesen globalen Befehlszeilen-Flags nach dem kora Befehl an:

Flag	Beschreibung	Standard	Beispiel
`--config`	Pfad zur Kora-Konfigurationsdatei (TOML-Format)	`kora.toml`	`kora --config path/to/kora.toml`
`--rpc-url`	Solana-RPC-Endpunkt-URL	`http://127.0.0.1:8899`	`kora --rpc-url https://api.devnet.solana.com`
`--help`	Hilfeinformationen ausgeben	-	`kora --help`
`--version`	Versionsinformationen ausgeben	-	`kora --version`

RPC-Server-Flags

Konfigurieren Sie den RPC-Server mit diesen Flags (verwendet mit kora rpc start):

Flag	Beschreibung	Standard	Beispiel
`--signers-config`	Pfad zur Multi-Signer-Konfigurationsdatei (TOML)	Erforderlich*	`--signers-config signers.toml`
`--no-load-signer`	Signer-Initialisierung überspringen	`false`	`--no-load-signer`
`-p`, `--port`	HTTP-Port für RPC-Anfragen	`8080`	`--port 3000`
`--logging-format`	Ausgabeformat für Logs (`standard` oder `json`)	`standard`	`--logging-format json`
`--help`	Hilfeinformationen ausgeben	-	`kora rpc start --help`

*Erforderlich, sofern nicht --no-load-signer verwendet wird

ATA-Initialisierungs-Flags

Konfigurieren Sie die ATA-Initialisierung mit diesen Flags (verwendet mit kora rpc initialize-atas):

Flag	Beschreibung	Standard	Beispiel
`--signers-config`	Pfad zur Multi-Signer-Konfigurationsdatei	Erforderlich*	`--signers-config signers.toml`
`--fee-payer-key`	Öffentlicher Schlüssel des Signers, der als Fee-Payer verwendet werden soll (muss in signers.toml enthalten sein)	Erster Signer	`--fee-payer-key "pubkey123..."`
`--compute-unit-price`	priority fee in Mikro-Lamports	Keine	`--compute-unit-price 1000`
`--compute-unit-limit`	Compute-Unit-Limit für Transaktionen	Keine	`--compute-unit-limit 200000`
`--chunk-size`	Anzahl der ATAs, die pro Transaktion erstellt werden sollen	Keine	`--chunk-size 10`

Häufige Anwendungsbeispiele

Starten des RPC-Servers

# 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

Konfigurationsvalidierung

# 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

Der Befehl validate-with-rpc führt eine zusätzliche On-Chain-Verifizierung durch:

Programm-Konten: Überprüft, ob alle erlaubten Programme existieren und ausführbar sind
Token-Mints: Bestätigt, dass alle erlaubten Token als gültige Mint-Konten existieren
Zahlungstoken: Validiert, dass alle SPL-Zahlungstoken gültige Mints sind
Zahlungsadress-ATAs: Prüft, ob die Zahlungsadresse ATAs für alle erlaubten Token besitzt
Kontotypen: Stellt sicher, dass Konten den erwarteten Typ haben (Programm vs. Mint)

Verwaltung von ATAs

# 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

Umgebungsvariablen

Diese Umgebungsvariablen können anstelle von Kommandozeilen-Flags verwendet werden:

Variable	Beschreibung	Flag-Äquivalent
`RPC_URL`	Solana-RPC-Endpunkt	`--rpc-url`

Siehe auch

Betreiber-Leitfaden - Übersicht über Kora-Betreiber
Konfigurationsleitfaden - Detaillierte Konfigurationsoptionen
Signer-Leitfaden - Signer-Typen und Konfiguration
Authentifizierungsleitfaden - Einrichtung der API-Authentifizierung
Schnellstart-Leitfaden - Erste Schritte mit Kora

Inhaltsverzeichnis