Referência da CLI

Última Atualização: 25-08-2025

Referência completa para a interface de linha de comando do Kora, incluindo comandos e flags.

Instalação

cargo install kora-cli

Uso Básico

kora [OPTIONS]

Comandos CLI Comuns

Comando	Descrição
`kora config validate`	Validar arquivo de configuração (rápido, sem chamadas RPC)
`kora config validate-with-rpc`	Validar configuração com verificação de conta on-chain
`kora rpc start`	Iniciar o servidor RPC
`kora rpc initialize-atas`	Inicializar ATAs para todos os tokens de pagamento

Flags do Kora

Personalize o comportamento do Kora com estas flags globais de linha de comando após o comando kora:

Flag	Descrição	Padrão	Exemplo
`--config`	Caminho para o arquivo de configuração do Kora (formato TOML)	`kora.toml`	`kora --config path/to/kora.toml`
`--rpc-url`	URL do endpoint RPC da Solana	`http://127.0.0.1:8899`	`kora --rpc-url https://api.devnet.solana.com`
`--help`	Exibir informações de ajuda	-	`kora --help`
`--version`	Exibir informações de versão	-	`kora --version`

Flags do Servidor RPC

Configure o servidor RPC com estas flags (usadas com kora rpc start):

Flag	Descrição	Padrão	Exemplo
`--signers-config`	Caminho para o arquivo de configuração multi-signatário (TOML)	Obrigatório*	`--signers-config signers.toml`
`--no-load-signer`	Ignorar inicialização do signatário	`false`	`--no-load-signer`
`-p`, `--port`	Porta HTTP para requisições RPC	`8080`	`--port 3000`
`--logging-format`	Formato de saída para logs (`standard` ou `json`)	`standard`	`--logging-format json`
`--help`	Exibir informações de ajuda	-	`kora rpc start --help`

*Obrigatório, a menos que esteja usando --no-load-signer

Flags de Inicialização de ATA

Configure a inicialização de ATA com estas flags (usadas com kora rpc initialize-atas):

Flag	Descrição	Padrão	Exemplo
`--signers-config`	Caminho para o arquivo de configuração de multi-assinatura	Obrigatório*	`--signers-config signers.toml`
`--fee-payer-key`	Chave pública do assinante a ser usado como pagador de taxas (deve estar em signers.toml)	Primeiro assinante	`--fee-payer-key "pubkey123..."`
`--compute-unit-price`	Taxa de prioridade em micro-lamports	Nenhum	`--compute-unit-price 1000`
`--compute-unit-limit`	Limite de unidades de computação para transações	Nenhum	`--compute-unit-limit 200000`
`--chunk-size`	Número de ATAs a criar por transação	Nenhum	`--chunk-size 10`

Exemplos de Uso Comum

Iniciando o Servidor 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

Validação de Configuração

# 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

O comando validate-with-rpc realiza verificação adicional on-chain:

Contas de programa: Verifica se todos os programas permitidos existem e são executáveis
Mints de token: Confirma se todos os tokens permitidos existem como contas de mint válidas
Tokens de pagamento: Valida se todos os tokens SPL pagos são mints válidos
ATAs de endereço de pagamento: Verifica se o endereço de pagamento possui ATAs para todos os tokens permitidos
Tipos de conta: Garante que as contas tenham o tipo esperado (programa vs mint)

Gerenciando 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

Variáveis de Ambiente

Estas variáveis de ambiente podem ser usadas em vez de flags de linha de comando:

Variável	Descrição	Flag Equivalente
`RPC_URL`	Endpoint RPC da Solana	`--rpc-url`

Veja Também

Guia de Operadores - Visão geral dos operadores Kora
Guia de Configuração - Opções detalhadas de configuração
Guia de Assinantes - Tipos de assinantes e configuração
Guia de Autenticação - Configurando autenticação de API
Guia de Início Rápido - Primeiros passos com Kora

Índice