Riferimento CLI

Ultimo aggiornamento: 25-08-2025

Riferimento completo per l'interfaccia a riga di comando di Kora, inclusi comandi e flag.

Installazione

cargo install kora-cli

Uso di base

kora [OPTIONS]

Comandi CLI comuni

Comando	Descrizione
`kora config validate`	Convalida il file di configurazione (veloce, senza chiamate RPC)
`kora config validate-with-rpc`	Convalida la configurazione con verifica dell'account on-chain
`kora rpc start`	Avvia il server RPC
`kora rpc initialize-atas`	Inizializza gli ATA per tutti i token di pagamento

Flag di Kora

Personalizza il comportamento di Kora con questi flag globali da riga di comando dopo il comando kora:

Flag	Descrizione	Predefinito	Esempio
`--config`	Percorso del file di configurazione di Kora (formato TOML)	`kora.toml`	`kora --config path/to/kora.toml`
`--rpc-url`	URL dell'endpoint RPC di Solana	`http://127.0.0.1:8899`	`kora --rpc-url https://api.devnet.solana.com`
`--help`	Stampa le informazioni di aiuto	-	`kora --help`
`--version`	Stampa le informazioni sulla versione	-	`kora --version`

Flag del server RPC

Configura il server RPC con questi flag (utilizzati con kora rpc start):

Flag	Descrizione	Predefinito	Esempio
`--signers-config`	Percorso del file di configurazione multi-firmatario (TOML)	Obbligatorio*	`--signers-config signers.toml`
`--no-load-signer`	Salta l'inizializzazione del firmatario	`false`	`--no-load-signer`
`-p`, `--port`	Porta HTTP per le richieste RPC	`8080`	`--port 3000`
`--logging-format`	Formato di output per i log (`standard` o `json`)	`standard`	`--logging-format json`
`--help`	Stampa le informazioni di aiuto	-	`kora rpc start --help`

*Obbligatorio a meno che non si utilizzi --no-load-signer

Flag di Inizializzazione ATA

Configura l'inizializzazione ATA con questi flag (utilizzati con kora rpc initialize-atas):

Flag	Descrizione	Predefinito	Esempio
`--signers-config`	Percorso del file di configurazione multi-firmatario	Obbligatorio*	`--signers-config signers.toml`
`--fee-payer-key`	Chiave pubblica del firmatario da utilizzare come pagatore delle commissioni (deve essere in signers.toml)	Primo firmatario	`--fee-payer-key "pubkey123..."`
`--compute-unit-price`	Commissione prioritaria in micro-lamport	Nessuno	`--compute-unit-price 1000`
`--compute-unit-limit`	Limite di unità di calcolo per le transazioni	Nessuno	`--compute-unit-limit 200000`
`--chunk-size`	Numero di ATA da creare per transazione	Nessuno	`--chunk-size 10`

Esempi di Utilizzo Comune

Avvio del Server 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

Validazione della Configurazione

# 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

Il comando validate-with-rpc esegue una verifica aggiuntiva on-chain:

Account dei programmi: Verifica che tutti i programmi consentiti esistano e siano eseguibili
Mint dei token: Conferma che tutti i token consentiti esistano come account mint validi
Token di pagamento: Valida che tutti i token SPL pagati siano mint validi
ATA dell'indirizzo di pagamento: Controlla se l'indirizzo di pagamento ha ATA per tutti i token consentiti
Tipi di account: Assicura che gli account abbiano il tipo previsto (programma vs mint)

Gestione degli 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

Variabili d'Ambiente

Queste variabili d'ambiente possono essere utilizzate al posto dei flag da riga di comando:

Variabile	Descrizione	Equivalente Flag
`RPC_URL`	Endpoint RPC Solana	`--rpc-url`

Vedi Anche

Guida per Operatori - Panoramica degli operatori Kora
Guida alla Configurazione - Opzioni di configurazione dettagliate
Guida ai Firmatari - Tipi di firmatari e configurazione
Guida all'Autenticazione - Configurazione dell'autenticazione API
Guida Rapida - Primi passi con Kora

Indice dei contenuti