Kava API 端点：开发者需要了解的内容

Kava API 决策清单

在集成 Kava API 端点之前，请评估以下标准：

---

理解 Kava 的双层架构

Kava 是一个基于 Cosmos SDK 构建的 Layer-1 区块链，完全兼容以太坊虚拟机 (EVM)。这种双重架构意味着开发者可以通过两个不同的接口与 Kava 交互：

• Cosmos 原生：Tendermint RPC、gRPC 和 REST API，用于查询 Cosmos 模块、IBC、质押、治理等。
• EVM 层：标准以太坊 JSON-RPC，用于部署和调用 Solidity 智能合约、通过 EIP-1559 转移 KAVA 代币，以及使用 MetaMask 或类似钱包。

每个接口都有自己的端点和方法集。了解哪个适合您的用例是选择正确 Kava API 提供者的第一步。

Kava API 端点类型

修剪节点 vs. 归档节点

• 修剪节点：仅保留最近约 1000 个区块的状态。适用于提交交易和查询当前余额。存储成本更低，同步速度更快。
• 归档节点：存储自创世以来的所有状态变更历史。用于历史代币余额、过往交易追踪和完整事件日志等查询。

主网和测试网均可使用这两种类型。

EVM JSON-RPC

与以太坊工具（ethers.js、web3.js、Hardhat、Foundry）兼容。标准 JSON-RPC 方法以及一些 Kava 特定扩展。

示例：使用 curl 获取最新区块号

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

示例：使用 ethers.js 发送交易

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

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

Tendermint RPC

用于 Cosmos 原生操作：查询验证者、治理提案、IBC 转账和质押。

示例：使用 Tendermint RPC 获取最新区块

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

REST API（Cosmos SDK）

用于银行、质押、分发及其他模块的 RESTful 端点。适用于构建后端服务。

示例：查询账户余额

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

WebSocket

用于实时事件订阅，如新区块、待处理交易或日志过滤器。

示例：订阅新区块头

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("新区块:", block.number);
});

公共 vs. 托管 Kava API 提供者

公共端点（如 evm.kava.io、rpc.kava.io）由 Kava Labs 和合作伙伴免费提供，但存在速率限制，可能影响生产环境使用。为了可靠访问，许多开发者转向托管基础设施服务。

当您需要更高的速率限制、WebSocket 可靠性或归档访问时，请考虑专用节点或托管 RPC 服务。像 OnFinality 的 Kava RPC 这样的服务提供可扩展的端点，具有全球基础设施、请求分析和专用节点选项。

Kava API 的常见用例

• DeFi dApp：在 Kava 的 EVM 兼容协议上交换、借贷和抵押代币。需要 EVM JSON-RPC 以及可能用于查询 IBC 余额的 Tendermint RPC。
• 钱包：需要获取 KAVA 余额、交易历史并提交已签名的交易。通常使用 REST（用于余额）和 EVM RPC（用于代币转账）的组合。
• 索引器与分析：需要归档节点来重建完整的历史状态。托管归档端点可以节省大量存储和同步时间。
• 跨链中继器：通过 Tendermint RPC 与 IBC 模块交互。需要可靠、低延迟的连接。
• 机器人与自动化：使用 WebSocket 连接进行实时事件监控和交易提交。

常见问题排查

1. 速率限制错误 (429)：公共端点通常会对激进请求进行限制。降低请求频率或升级到付费提供者。
2. WebSocket 断连：确保客户端处理重新连接逻辑。某些提供者限制 WebSocket 会话时长。
3. 错误的链 ID：Kava 主网使用 chain-id: kava_2222-10。签署交易时请仔细检查。
4. EVM 与 Cosmos 混淆：为您的操作使用正确的端点。EVM RPC 不提供诸如 cosmos.staking.v1beta1.Query/Validators 等 Cosmos 查询。

如何选择 Kava API 提供者

根据您的工作负载进行评估：

• 低流量 / 测试：公共端点（谨慎使用）或托管提供者的免费套餐。
• 生产环境 dApp：寻找可靠性保证、专用节点或高限制计划。检查提供者是否同时提供 EVM 和 Tendermint RPC 以及 WebSocket。
• 历史分析：归档支持是必须的。某些提供者提供仅归档端点。
• 多链需求：如果您的应用还使用其他网络（如以太坊、BNB Chain），统一提供者可简化集成。

如需并排比较 RPC 提供者，请参阅我们的 RPC 提供者选择指南。

关键要点

• Kava 提供四种 API 接口：EVM JSON-RPC、Tendermint RPC、REST API 和 WebSocket。
• 归档节点对于历史数据至关重要；修剪节点适用于当前状态。
• 公共端点适合测试，但不适用于生产环境。
• 在选定提供者之前评估速率限制、协议支持和定价。
• 像 OnFinality 这样的托管基础设施服务可以简化扩展并降低运营负担。

常见问题

Kava 链 ID 是什么？ 主网：kava_2222-10。测试网：kava_2221-10。

我可以使用 MetaMask 与 Kava 交互吗？ 可以。添加自定义网络，RPC URL：https://evm.kava.io，链 ID 2222。

Kava 是否支持 WebSocket？ 是的，支持 EVM（wss://evm.kava.io/ws）和 Tendermint（wss://rpc.kava.io/websocket）。

如何获得专用 Kava 节点？ 您可以使用托管服务，如 OnFinality，它提供 专用 Kava 节点，具有可自定义规格和保证资源。

Kava EVM 和 Kava Tendermint RPC 有什么区别？ Kava EVM 遵循以太坊 JSON-RPC 规范，用于智能合约交互。Tendermint RPC 提供对 Cosmos SDK 模块的访问，包括质押、治理和 IBC。

有关支持的网络和端点的完整列表，请访问我们的 网络页面。要查看 Kava RPC 的定价方案，请参阅 RPC 定价。