Puntos de conexión de la API de Kava: lo que los desarrolladores deben saber

Lista de verificación para la decisión sobre la API de Kava

Antes de integrar un endpoint de la API de Kava, evalúe estos criterios:

---

Entendiendo la arquitectura de doble capa de Kava

Kava es una blockchain de capa 1 construida sobre Cosmos SDK con compatibilidad total con Ethereum Virtual Machine (EVM). Esta arquitectura dual significa que los desarrolladores pueden interactuar con Kava a través de dos interfaces separadas:

• Nativa de Cosmos: Tendermint RPC, gRPC y API REST para consultar módulos de Cosmos, IBC, staking, gobernanza y más.
• Capa EVM: JSON-RPC estándar de Ethereum para implementar y llamar contratos inteligentes Solidity, transferir tokens KAVA mediante EIP-1559, y usar MetaMask u otras billeteras similares.

Cada interfaz tiene su propio conjunto de endpoints y métodos. Comprender cuál se adapta a su caso de uso es el primer paso para elegir el proveedor de API de Kava adecuado.

Tipos de endpoints de la API de Kava

Nodos Pruning vs. Archive

• Nodos pruning: Conservan solo los últimos ~1000 bloques de estado. Adecuados para enviar transacciones y consultar saldos actuales. Menor costo de almacenamiento y sincronización más rápida.
• Nodos archive: Almacenan el historial completo de todos los cambios de estado desde el génesis. Requeridos para consultas como saldos históricos de tokens, trazas de transacciones pasadas y registros de eventos completos.

Ambos tipos están disponibles para mainnet y testnet.

EVM JSON-RPC

Compatible con herramientas de Ethereum (ethers.js, web3.js, Hardhat, Foundry). Métodos estándar JSON-RPC y algunas extensiones específicas de Kava.

Ejemplo: Obtener el número del último bloque usando curl

curl -X POST https://evm.kava.io \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'

Ejemplo: Enviar una transacción usando ethers.js

const { ethers } = require("ethers");

const provider = new ethers.JsonRpcProvider("https://evm.kava.io");
const block = await provider.getBlockNumber();
console.log("Current block:", block);

Tendermint RPC

Para operaciones nativas de Cosmos: consultar validadores, propuestas de gobernanza, transferencias IBC y staking.

Ejemplo: Obtener el último bloque usando Tendermint RPC

curl https://rpc.kava.io/block?latest

API REST (Cosmos SDK)

Endpoints RESTful para los módulos bank, staking, distribution y otros. Útil para construir servicios backend.

Ejemplo: Consultar saldo de cuenta

curl https://api.kava.io/cosmos/bank/v1beta1/balances/kava1...

WebSocket

Para suscripciones a eventos en tiempo real, como nuevos bloques, transacciones pendientes o filtros de logs.

Ejemplo: Suscribirse a nuevos encabezados

const { Web3 } = require("web3");
const web3 = new Web3("wss://evm.kava.io/ws");

const subscription = web3.eth.subscribe("newBlockHeaders", (error, block) => {
  if (!error) console.log("New block:", block.number);
});

Proveedores de API de Kava públicos vs. gestionados

Los endpoints públicos (como evm.kava.io, rpc.kava.io) son proporcionados por Kava Labs y socios de forma gratuita, pero tienen límites de tasa que pueden dificultar el uso en producción. Para un acceso confiable, muchos desarrolladores recurren a servicios de infraestructura gestionada.

Cuando necesite límites de tasa más altos, confiabilidad de WebSocket o acceso a archive, considere un nodo dedicado o un servicio RPC gestionado. Servicios como Kava RPC de OnFinality ofrecen endpoints escalables con infraestructura global, análisis de solicitudes y opciones de nodo dedicado.

Casos de uso comunes para la API de Kava

• DeFi dApps: Intercambiar, prestar y tomar prestados tokens en protocolos compatibles con EVM de Kava. Requiere tanto EVM JSON-RPC como, potencialmente, Tendermint RPC para consultar saldos IBC.
• Billeteras: Necesitan obtener saldos de KAVA, historial de transacciones y enviar transacciones firmadas. Usualmente usan una combinación de REST (para saldos) y EVM RPC (para transferencias de tokens).
• Indexadores y análisis: Requieren nodos archive para reconstruir el estado histórico completo. Un endpoint de archive gestionado puede ahorrar tiempo de almacenamiento y sincronización significativos.
• Relayers entre cadenas: Interactúan con módulos IBC a través de Tendermint RPC. Necesitan conexiones confiables y de baja latencia.
• Bots y automatización: Usan conexiones WebSocket para monitoreo de eventos en tiempo real y envío de transacciones.

Solución de problemas comunes

1. Errores de límite de tasa (429): Los endpoints públicos a menudo limitan las solicitudes agresivas. Reduzca la frecuencia de solicitudes o actualice a un proveedor de pago.
2. Desconexiones de WebSocket: Asegúrese de manejar la lógica de reconexión en su cliente. Algunos proveedores limitan la duración de la sesión WebSocket.
3. ID de cadena incorrecto: La mainnet de Kava usa chain-id: kava_2222-10. Verifique al firmar transacciones.
4. Confusión entre EVM y Cosmos: Use el endpoint correcto para su operación. EVM RPC no sirve consultas de Cosmos como cosmos.staking.v1beta1.Query/Validators.

Cómo elegir un proveedor de API de Kava

Evalúe según su carga de trabajo:

• Volumen bajo / pruebas: Endpoints públicos (con precaución) o nivel gratuito de un proveedor gestionado.
• dApp en producción: Busque expectativas de confiabilidad, nodos dedicados o planes con límites de tasa altos. Verifique si el proveedor ofrece tanto EVM como Tendermint RPC, además de WebSocket.
• Análisis histórico: El soporte de archive es innegociable. Algunos proveedores ofrecen endpoints solo de archive.
• Requisitos multicadena: Si su aplicación también usa otras redes (ej. Ethereum, BNB Chain), un proveedor unificado simplifica la integración.

Para una comparación lado a lado de proveedores de RPC, consulte nuestra guía de selección de proveedores de RPC.

Conclusiones clave

• Kava ofrece cuatro interfaces API: EVM JSON-RPC, Tendermint RPC, API REST y WebSocket.
• Los nodos archive son esenciales para datos históricos; los nodos pruning son suficientes para el estado actual.
• Los endpoints públicos son convenientes para pruebas, pero no son de grado de producción.
• Evalúe los límites de tasa, el soporte de protocolo y los precios antes de comprometerse con un proveedor.
• Los servicios de infraestructura gestionada como OnFinality pueden simplificar el escalado y reducir la carga operativa.

Preguntas frecuentes

¿Cuál es el ID de cadena de Kava? Mainnet: kava_2222-10. Testnet: kava_2221-10.

¿Puedo usar MetaMask con Kava? Sí. Agregue una red personalizada con URL RPC: https://evm.kava.io e ID de cadena 2222.

¿Kava soporta WebSocket? Sí, tanto para EVM (wss://evm.kava.io/ws) como para Tendermint (wss://rpc.kava.io/websocket).

¿Cómo obtengo un nodo dedicado de Kava? Puede usar un servicio gestionado como OnFinality, que proporciona nodos dedicados de Kava con especificaciones personalizables y recursos garantizados.

¿Cuál es la diferencia entre Kava EVM y Kava Tendermint RPC? Kava EVM sigue la especificación JSON-RPC de Ethereum para la interacción con contratos inteligentes. Tendermint RPC proporciona acceso a los módulos de Cosmos SDK, incluyendo staking, gobernanza e IBC.

Para una lista completa de redes y endpoints compatibles, visite nuestra página de redes. Para explorar los planes de precios de Kava RPC, consulte Precios de RPC.