Documentação de Operadores Kora

O que é um Operador de Nó Kora?

Como operador de nó Kora, você executa um serviço de pagador mestre que patrocina taxas de transação Solana para seus usuários. Seu nó aceita pagamentos em tokens SPL e utiliza seu SOL para pagar as taxas reais da rede, possibilitando transações sem gás para sua aplicação.

Por que Executar um Nó Kora?

Melhor UX: Seus usuários realizam transações sem precisar de SOL (integração simplificada, melhor retenção, etc.)
Fonte de Receita: Receba taxas nos tokens de preferência do seu negócio (USDC, BONK, etc.)

Início Rápido

Quer experimentar localmente primeiro? Inicie um nó Kora local em poucos minutos: → Guia de Início Rápido Local

Conceitos Fundamentais

Como operador de nó Kora, você é responsável por executar um serviço de pagador mestre seguro que possibilita transações sem gás para seus usuários. Seu nó tem quatro responsabilidades principais:

1. Validar Transações

Configure seu nó para aceitar apenas transações que atendam aos requisitos do seu negócio via kora.toml:

Listas de permissão de tokens: Defina quais tokens SPL você aceita como pagamento (suporta SPL e Token-2022)
Listas de permissão de programas: Estabeleça com quais programas Solana os usuários podem interagir
Limites de transação: Defina as taxas máximas que você está disposto a pagar e limites de assinatura
Listas de bloqueio de contas: Impeça interações com endereços problemáticos
Oráculos de preços: Configure o Jupiter ou preços simulados para cálculos de taxas
Tokens de pagamento: Especifique quais tipos de tokens você aceitará como pagamento
Políticas de pagador de taxas: Controle quais operações seu pagador de taxas pode realizar (transferências, queimas, aprovações, etc.)
Extensões Token-2022: Bloqueie extensões específicas do Token-2022 para maior segurança
Cache: Habilite o cache Redis para melhorar o desempenho reduzindo chamadas RPC
Limites de uso: Defina limites de transação por carteira para prevenir abuso, garantir uso justo ou recompensar usuários com transações subsidiadas até um determinado limite

→ Referência Completa de Configuração do Kora.toml → Exemplo de kora.toml

2. Assinar Transações

Seu nó precisa de keypair(s) da Solana para assinar transações como pagador de taxas. Para implantações em produção, o Kora suporta configurações multi-assinante para melhor confiabilidade e distribuição de bloqueio de conta. Considere implementar rotação de chaves, controles de acesso, backups e outras estratégias para segurança dos assinantes. Opções de assinatura disponíveis:

Chave Privada Local: Armazene a chave privada diretamente no ambiente do servidor (como base58, arquivo .json ou array u8)
Turnkey: Gestão de chaves privadas de forma simples. Crie carteiras, assine transações e automatize ações onchain.
Privy: Infraestrutura cripto facilitada. Crie carteiras whitelabel de forma segura e assine transações.
HashiCorp Vault: Gerencie Segredos e Proteja Dados Sensíveis

→ Guia Completo de Configuração de Assinantes

3. Pagar Taxas de Transação

Mantenha SOL suficiente para cobrir as taxas de rede para o volume de transações esperado:

Monitoramento de saldo: Acompanhe o saldo de SOL e configure alertas de saldo baixo (o Kora fornece métricas integradas do Prometheus - consulte Monitoramento)
Automação: Implemente procedimentos automáticos de recarga de SOL para ambientes de produção
Planejamento de capacidade: Planeje considerando o caso de uso esperado, volume de usuários, etc.

É importante que você entenda como o Kora estima as taxas e como configurar seu nó para maximizar sua receita. Consulte o Guia de Estimativa de Taxas para mais detalhes.

4. Monitorar Operações

Acompanhe continuamente as métricas de segurança, desempenho e negócios do seu nó:

Monitoramento de segurança: Padrões incomuns, validações com falha e violações de limite de taxa
Alertas operacionais: Saúde do sistema, avisos de saldo e eventos de segurança
Acompanhamento financeiro: Custos em SOL vs. receita em tokens, análise de lucratividade
Monitoramento de saldo dos assinantes: Acompanhe o saldo dos assinantes e configure alertas de saldo baixo

O Kora fornece um endpoint /metrics opcional que disponibiliza dados de desempenho em tempo real no formato Prometheus.

→ Guia de Referência de Monitoramento do Kora

5. Otimizar o Desempenho (Opcional)

Para implantações de alto tráfego, ative o cache Redis para reduzir as chamadas RPC e melhorar os tempos de resposta:

Cache de contas: Armazena em cache os dados de contas Solana com tempo de vida (TTL) configurável
Fallback automático: Retorna normalmente para chamadas RPC diretas se o Redis estiver indisponível
Gestão de cache: Expiração automática e capacidades de atualização forçada para operações críticas

CLI do Kora

O crate kora-cli é um binário Rust pronto para produção que fornece tudo o que você precisa para executar um nó paymaster Kora. É distribuído como um executável autônomo que você pode instalar globalmente ou implantar em contêineres.

Opções de Instalação

Instalação Global (recomendado para desenvolvimento)

cargo install kora-cli

Ou compilar a partir do código-fonte (recomendado para contribuir)

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

Uso Básico

O servidor RPC do Kora expõe um endpoint JSON-RPC (padrão: http://localhost:8080). Inicie-o com o 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 mais informações sobre o uso da CLI do Kora, consulte o Guia da CLI.

As aplicações podem acessar o Servidor RPC do Kora através do SDK TS do Kora

Configuração

Cada nó RPC do Kora deve ser configurado com pelo menos:

um endpoint RPC Solana (especificado através da flag --rpc-url ou da variável de ambiente RPC_URL) [padrão: http://127.0.0.1:8899]
configuração de assinante(s) Solana (especificada através da flag --signers-config signers.toml)
um arquivo de configuração, kora.toml (especificado através da flag --config path/to/kora.toml)

kora.toml

Antes de implantar, você precisará criar e configurar um kora.toml para especificar:

Limitação de taxa e autenticação
Endereço de destino de pagamento
Disponibilidade de métodos RPC
Regras de validação de transações
Políticas de segurança (lista de permissões ou bloqueio de tokens SPL, programas, contas, extensões de token, etc.)
Modelos de precificação de taxas
Políticas aprimoradas de pagador de taxas (proteção contra comportamento indesejado de assinantes)
Coleta de métricas
Configuração de cache Redis (opcional)

signers.toml

Você também precisará criar um arquivo signers.toml para especificar:

Signatário(s) para o seu nó
Estratégia de seleção de signatários
Configuração de cada signatário e chaves aplicáveis

Implantação no Railway

Mais guias de integração em breve

Precisa de Ajuda?

Solana Stack Exchange - Faça perguntas/compartilhe aprendizados (certifique-se de usar a tag kora)
GitHub Issues - Relate bugs ou obtenha ajuda
Execute kora rpc --help para ver todas as flags e opções de configuração disponíveis