Documentación de Operadores de Kora

¿Qué es un Operador de Nodo de Kora?

Como operador de nodo de Kora, ejecutas un servicio de paymaster que patrocina las tarifas de transacción de Solana para tus usuarios. Tu nodo acepta pagos en tokens SPL y utiliza tu SOL para pagar las tarifas reales de la red, permitiendo transacciones sin gas para tu aplicación.

¿Por qué Ejecutar un Nodo de Kora?

Mejor UX: Tus usuarios realizan transacciones sin necesitar SOL (incorporación simplificada, mejor retención, etc.)
Flujo de Ingresos: Cobra tarifas en los tokens que prefiera tu negocio (USDC, BONK, etc.)

Inicio Rápido

¿Quieres probarlo localmente primero? Inicia un nodo local de Kora en pocos minutos: → Guía de Inicio Rápido Local

Conceptos Fundamentales

Como operador de nodo de Kora, eres responsable de ejecutar un servicio paymaster seguro que habilita transacciones sin gas para tus usuarios. Tu nodo tiene cuatro responsabilidades clave:

1. Validar Transacciones

Configura tu nodo para aceptar solo transacciones que cumplan con los requisitos de tu negocio mediante kora.toml:

Listas de tokens permitidos: Define qué tokens SPL aceptas como pago (soporta tanto SPL como Token-2022)
Listas de programas permitidos: Crea una lista blanca de los programas de Solana con los que los usuarios pueden interactuar
Límites de transacción: Establece las tarifas máximas que estás dispuesto a pagar y límites de firmas
Listas de cuentas bloqueadas: Previene interacciones con direcciones problemáticas
Oráculos de precios: Configura Jupiter o precios simulados para cálculos de tarifas
Tokens de pago: Especifica qué tipo de tokens aceptarás como pago
Políticas de feepayer: Controla qué operaciones puede realizar tu feepayer (transferencias, quemas, aprobaciones, etc.)
Extensiones Token-2022: Bloquea extensiones específicas de Token-2022 para mayor seguridad
Almacenamiento en caché: Habilita el caché de Redis para mejorar el rendimiento reduciendo llamadas RPC
Límites de uso: Establece límites de transacciones por wallet para prevenir abusos, asegurar un uso justo o recompensar a los usuarios con transacciones subsidiadas hasta cierto límite

→ Referencia Completa de Configuración de Kora.toml → Ejemplo de kora.toml

2. Firmar Transacciones

Tu nodo necesita keypair(s) de Solana para firmar transacciones como pagador de comisiones. Para despliegues en producción, Kora admite configuraciones multi-firmante para mejorar la fiabilidad y distribución de bloqueo de cuentas. Considera implementar rotación de claves, controles de acceso, copias de seguridad y otras estrategias para la seguridad de los firmantes. Opciones de firma disponibles:

Clave Privada Local: Almacena la clave privada directamente en el entorno del servidor (como base58, archivo .json o array u8)
Turnkey: Gestión de claves privadas simplificada. Crea billeteras, firma transacciones y automatiza acciones onchain.
Privy: Infraestructura cripto fácil. Crea billeteras de marca blanca de forma segura y firma transacciones.
HashiCorp Vault: Gestiona Secretos y Protege Datos Sensibles

→ Guía Completa de Configuración de Firmantes

3. Pagar Comisiones de Transacción

Mantén suficiente SOL para cubrir las comisiones de red según tu volumen de transacciones esperado:

Monitoreo de saldo: Rastrea el saldo de SOL y configura alertas de saldo bajo (Kora proporciona métricas integradas de Prometheus - consulta Monitoreo)
Automatización: Implementa procedimientos automáticos de recarga de SOL para entornos de producción
Planificación de capacidad: Planifica según el caso de uso esperado, volumen de usuarios, etc.

Es importante que comprendas cómo Kora estima las comisiones y cómo configurar tu nodo para maximizar tus ingresos. Consulta la Guía de Estimación de Comisiones para más detalles.

4. Monitorear Operaciones

Realiza un seguimiento continuo de las métricas de seguridad, rendimiento y negocio de tu nodo:

Monitoreo de seguridad: Patrones inusuales, validaciones fallidas y violaciones de límites de tasa
Alertas operacionales: Estado del sistema, advertencias de saldo y eventos de seguridad
Seguimiento financiero: Costos de SOL vs. ingresos en tokens, análisis de rentabilidad
Monitoreo de saldo de firmantes: Rastrea el saldo de los firmantes y configura alertas de saldo bajo

Kora proporciona un punto de conexión opcional /metrics que ofrece datos de rendimiento en tiempo real en formato Prometheus.

→ Guía de Referencia de Monitoreo de Kora

5. Optimizar el Rendimiento (Opcional)

Para implementaciones de alto tráfico, habilita el almacenamiento en caché de Redis para reducir las llamadas RPC y mejorar los tiempos de respuesta:

Almacenamiento en caché de cuentas: Almacena en caché los datos de cuentas de Solana con tiempo de vida (TTL) configurable
Respaldo automático: Recurre elegantemente a llamadas RPC directas si Redis no está disponible
Gestión de caché: Capacidades de expiración automática y actualización forzada para operaciones críticas

CLI de Kora

El crate kora-cli es un binario de Rust listo para producción que proporciona todo lo necesario para ejecutar un nodo de pagador de Kora. Se distribuye como un ejecutable independiente que puedes instalar globalmente o implementar en contenedores.

Opciones de Instalación

Instalación Global (recomendada para desarrollo)

cargo install kora-cli

O compilar desde el código fuente (recomendado para contribuir)

git clone https://github.com/solana-foundation/kora.git
cd kora
just install

Uso Básico

El servidor RPC de Kora expone un punto de conexión JSON-RPC (predeterminado: http://localhost:8080). Inícialo con el comando kora rpc:

# Run with specified kora.toml and signers.toml
kora --config path/to/kora.toml rpc start --signers-config path/to/signers.toml

# Help
kora rpc --help

Para obtener más información sobre el uso de la CLI de Kora, consulta la Guía de CLI.

Las aplicaciones pueden acceder al Servidor RPC de Kora a través del SDK de TS de Kora

Configuración

Cada nodo RPC de Kora debe configurarse con al menos:

un punto de conexión RPC de Solana (especificado mediante el indicador --rpc-url o la variable de entorno RPC_URL) [predeterminado: http://127.0.0.1:8899]
configuración de firmante(s) de Solana (especificado mediante el indicador --signers-config signers.toml)
un archivo de configuración, kora.toml (especificado mediante el indicador --config path/to/kora.toml)

kora.toml

Antes de implementar, necesitarás crear y configurar un kora.toml para especificar:

Limitación de velocidad y autenticación
Dirección de destino de pago
Disponibilidad de métodos RPC
Reglas de validación de transacciones
Políticas de seguridad (lista blanca o lista negra de tokens SPL, programas, cuentas, extensiones de tokens, etc.)
Modelos de precios de tarifas
Políticas mejoradas de pagador de tarifas (protección contra comportamiento no deseado del firmante)
Recopilación de métricas
Configuración de almacenamiento en caché de Redis (opcional)

signers.toml

También necesitarás crear un archivo signers.toml para especificar:

Firmante(s) para tu nodo
Estrategia de selección de firmantes
Configuración de cada firmante y claves aplicables

Implementación en Railway

Más guías de integración próximamente

¿Necesitas Ayuda?

Solana Stack Exchange - Haz preguntas/comparte aprendizajes (asegúrate de usar la etiqueta kora)
GitHub Issues - Reporta errores u obtén ayuda
Ejecuta kora rpc --help para ver todas las opciones de configuración y banderas disponibles