Kora | Solana

Kora é a sua infraestrutura de assinatura Solana. Ative transações sem taxas de gás onde os usuários pagam taxas em qualquer token—USDC, BONK ou o token nativo do seu app—ou gerencie qualquer assinatura de transação que exija um assinante confiável.

Por que Kora?

Melhor UX: Os usuários nunca precisam de SOL
Controle de Receita: Colete taxas em USDC, seu token ou qualquer outra coisa
Pronto para Produção: Validação segura, limitação de taxa, monitoramento integrado
Integração Fácil: API JSON-RPC + SDK TypeScript
Implantação Flexível: Railway, Docker ou qualquer plataforma na nuvem

Arquitetura

Linguagem: Rust com SDK TypeScript
Protocolo: JSON-RPC 2.0
Assinantes: Chave Privada Solana, Turnkey, Privy
Autenticação: Chave de API, HMAC ou nenhuma
Implantação: Opções de implantação flexíveis (Docker, Railway, etc.)

Recursos

Regras de validação configuráveis e listas de permissões
Suporte completo ao Token-2022 com filtragem de extensões
Cache Redis para melhor desempenho
Limitação de taxa e proteção de gastos
Gerenciamento seguro de chaves (Turnkey, Privy, Vault)
Autenticação HMAC e chave de API
Métricas e monitoramento Prometheus
Políticas aprimoradas de proteção do pagador de taxas

Início Rápido

Instale o Kora:

cargo install kora-cli

Uso básico:

kora rpc [OPTIONS] # --help for full list of options

→ Guia de Início Rápido - Tenha o Kora funcionando localmente em minutos

→ Guia do Operador de Nó - Execute um paymaster

SDK TypeScript

Kora fornece uma interface JSON-RPC simples com três opções de cliente:

// Option 1: Standalone client
import { KoraClient } from "@solana/kora";
const kora = new KoraClient({ rpcUrl: "http://localhost:8080" });
const signed = await kora.signTransaction({ transaction });

// Option 2: Kit client (recommended) — handles planning, fees, signing, and sending
import { createKitKoraClient } from "@solana/kora";
import { address } from "@solana/kit";
const client = await createKitKoraClient({
  endpoint: "http://localhost:8080",
  rpcUrl: "https://api.mainnet-beta.solana.com",
  feeToken: address("EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"),
  feePayerWallet: userSigner
});

→ Referência da API - Métodos JSON-RPC e SDK TypeScript

Desenvolvimento Local

Pré-requisitos

Rust 1.86+ ou
Solana CLI 2.2+
Node.js 20+ e pnpm (para SDK)

Instalação

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

Compilar

just build

Executando o Servidor

Uso básico:

kora rpc [OPTIONS]

Ou para executar com uma configuração de teste, execute:

just run

Testes Locais

E execute todos os testes:

just test-all

Comunidade e Suporte

Dúvidas? Pergunte no Solana Stack Exchange (use a tag kora)
Problemas? Reporte em GitHub Issues

Outros Recursos

Kora CLI Crates.io - Crate Rust para executar um nó Kora
@solana/kora NPM Package - SDK TypeScript para interagir com um nó Kora

Fonte

Repositório GitHub

Desenvolvido e mantido pela Solana Foundation.

Licenciado sob MIT. Consulte LICENSE para detalhes.

Índice