Referencia de CLI

Última actualización: 25-08-2025

Referencia completa de la interfaz de línea de comandos de Kora, incluyendo comandos y flags.

Instalación

cargo install kora-cli

Uso básico

kora [OPTIONS]

Comandos CLI comunes

Comando	Descripción
`kora config validate`	Validar archivo de configuración (rápido, sin llamadas RPC)
`kora config validate-with-rpc`	Validar configuración con verificación de cuenta en cadena
`kora rpc start`	Iniciar el servidor RPC
`kora rpc initialize-atas`	Inicializar ATAs para todos los tokens de pago

Flags de Kora

Personaliza el comportamiento de Kora con estos flags globales de línea de comandos después del comando kora:

Flag	Descripción	Predeterminado	Ejemplo
`--config`	Ruta al archivo de configuración de Kora (formato TOML)	`kora.toml`	`kora --config path/to/kora.toml`
`--rpc-url`	URL del endpoint RPC de Solana	`http://127.0.0.1:8899`	`kora --rpc-url https://api.devnet.solana.com`
`--help`	Mostrar información de ayuda	-	`kora --help`
`--version`	Mostrar información de versión	-	`kora --version`

Flags del servidor RPC

Configura el servidor RPC con estos flags (usados con kora rpc start):

Flag	Descripción	Predeterminado	Ejemplo
`--signers-config`	Ruta al archivo de configuración multi-firmante (TOML)	Requerido*	`--signers-config signers.toml`
`--no-load-signer`	Omitir inicialización del firmante	`false`	`--no-load-signer`
`-p`, `--port`	Puerto HTTP para solicitudes RPC	`8080`	`--port 3000`
`--logging-format`	Formato de salida para logs (`standard` o `json`)	`standard`	`--logging-format json`
`--help`	Mostrar información de ayuda	-	`kora rpc start --help`

*Requerido a menos que se use --no-load-signer

Banderas de Inicialización de ATA

Configure la inicialización de ATA con estas banderas (usadas con kora rpc initialize-atas):

Bandera	Descripción	Predeterminado	Ejemplo
`--signers-config`	Ruta al archivo de configuración de firmantes múltiples	Requerido*	`--signers-config signers.toml`
`--fee-payer-key`	Clave pública del firmante a usar como pagador de comisión (debe estar en signers.toml)	Primer firmante	`--fee-payer-key "pubkey123..."`
`--compute-unit-price`	Comisión prioritaria en micro-lamports	Ninguno	`--compute-unit-price 1000`
`--compute-unit-limit`	Límite de unidades de cómputo para transacciones	Ninguno	`--compute-unit-limit 200000`
`--chunk-size`	Número de ATAs a crear por transacción	Ninguno	`--chunk-size 10`

Ejemplos de Uso Comunes

Iniciar el 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

Validación de Configuración

# 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

El comando validate-with-rpc realiza verificación adicional en cadena:

Cuentas de programa: Verifica que todos los programas permitidos existan y sean ejecutables
Mints de tokens: Confirma que todos los tokens permitidos existan como cuentas mint válidas
Tokens de pago: Valida que todos los tokens SPL pagados sean mints válidos
ATAs de dirección de pago: Verifica si la dirección de pago tiene ATAs para todos los tokens permitidos
Tipos de cuenta: Asegura que las cuentas tengan el tipo esperado (programa vs mint)

Gestión de 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

Variables de Entorno

Estas variables de entorno pueden usarse en lugar de banderas de línea de comandos:

Variable	Descripción	Equivalente de Bandera
`RPC_URL`	Endpoint RPC de Solana	`--rpc-url`

Ver También

Guía de Operadores - Descripción general de los operadores de Kora
Guía de Configuración - Opciones detalladas de configuración
Guía de Firmantes - Tipos de firmantes y configuración
Guía de Autenticación - Configuración de autenticación API
Guía de Inicio Rápido - Primeros pasos con Kora

Tabla de Contenidos