什么是 Kaia RPC 端点以及如何连接到 Kaia？

Kaia 端点决策清单

在选择 Kaia RPC 端点之前，请评估以下因素：

• 可靠性：公共端点可能会在高负载下限制请求或不可用。对于生产环境，请考虑专用节点或提供 SLA 保证的提供商。
• 延迟：地理分布式的端点可以减少往返时间。检查提供商是否在您的用户或后端附近有边缘节点。
• 数据访问：归档数据和跟踪 API 对于某些 dApp 至关重要。确认支持 kaia_getLogs、debug_traceTransaction 等。
• WebSocket 支持：对于实时订阅，确保提供商提供 WSS 端点。
• 速率限制：公共端点通常限制每秒请求数。仔细阅读细则以避免中断。
• 定价：比较按需付费、固定费率和专用节点方案。一些提供商为低量测试提供免费套餐。

Kaia 网络概述

Kaia（原名 Klaytn）是一个高性能 L1 区块链，针对企业应用进行了优化，尤其是在亚洲。它采用基于 BFT 的共识机制，专为稳定币和金融应用设计。该网络有两个主要链：

• Cypress – 主网
• Kairos – 公共测试网（取代 Baobab）

要与任一链交互，您的应用程序向端点节点发送 JSON-RPC 请求。您可以运行自己的节点或使用托管的 RPC 提供商。

公共 Kaia 端点

Kaia 为主网和测试网提供免费的公共端点。这些端点适用于原型开发、小规模测试和轻度使用。请注意速率限制和潜在的停机时间。

注意：旧的 Klaytn 端点（public-en-cypress.klaytn.net 等）已于 2024 年 9 月弃用。请将您的配置更新到新的 URL。

运行自己的 Kaia 端点节点与使用提供商

运行 Kaia 端点节点 (EN) 可以完全控制，但会带来运维开销：

• 硬件：主网需要至少 8 核、32GB RAM 和约 1TB SSD 的机器。
• 维护：从创世块同步需要数天；必须监控存储、更新节点软件并处理网络问题。
• 成本：云托管费用、工程时间以及潜在的备份基础设施。

托管的 RPC 提供商可以减轻这些顾虑。它们提供：

• 预先配置的节点，具备负载均衡和故障转移。
• 按需扩展，无需改变基础设施。
• 访问归档数据和高级 API。

OnFinality 提供具有全球边缘分布、专用节点和 WebSocket 支持的 Kaia RPC 端点，作为按需付费或订阅服务提供。

如何选择 Kaia RPC 提供商

在评估 Kaia 应用的提供商时，请使用此表：

查看 RPC 定价 和 支持的网络 以获取当前选项。

常见的 Kaia RPC 方法及示例

Kaia 支持标准的以太坊 JSON-RPC 方法以及 Kaia 特定的扩展。以下是获取 Cypress 当前区块编号的简单 curl 示例：

curl -X POST https://public-en.node.kaia.io \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "kaia_blockNumber",
    "params": [],
    "id": 1
  }'

其他常用的方法：

• kaia_getBalance – 查询地址的 KLAY 余额
• kaia_call – 执行只读合约调用
• eth_sendRawTransaction – 广播已签名的交易
• kaia_getTransactionReceipt – 检查交易状态

对于 WebSocket 订阅，请使用 eth_subscribe 方法配合专用的 WSS 端点。

调试与故障排除

连接 Kaia 端点时的常见问题：

• 端点 URL 无效：再次确认您使用了正确的网络（Cypress vs Kairos）和 URL 格式。
• 速率限制：公共端点可能返回 HTTP 429 或错误消息。使用指数退避重试，或切换到私有提供商。
• 过时的端点：如果您之前使用 klaytn.net URL，请从 2024 年 9 月起更新为 kaia.io。
• 链 ID 不匹配：Cypress 链 ID 为 8217，Kairos 为 1001。确保您的钱包或应用使用正确的链 ID。
• WebSocket 断开：某些公共 WSS 端点有连接限制。对于稳定的实时数据流，请使用支持专用 WebSocket 的提供商。

关键要点

• Kaia 为 Cypress 和 Kairos 提供免费的公共端点，但这些端点有速率限制且无 SLA。
• 对于生产基础设施，请评估提供可靠性、低延迟和归档数据的托管提供商。
• 将您的工具更新到当前的 Kaia URL（.kaia.io），并避免使用已弃用的 Klaytn 端点。
• 在构建应用之前，使用简单的 curl 或 RPC 库进行测试。
• 对于生产工作负载，考虑使用专用节点或如 OnFinality 的服务。

常见问题

我可以将以太坊工具与 Kaia 一起使用吗？
可以。Kaia 兼容 EVM，因此 MetaMask、Hardhat 和 ethers.js 等工具在正确的链设置下可以工作。将链 ID 设置为 8217（Cypress）或 1001（Kairos）。

Kaia 测试网叫什么，如何获取测试 KLAY？
测试网是 Kairos。使用 Kaia 水龙头 请求测试 KLAY。一些提供商也提供水龙头访问。

有免费的 Kaia RPC 提供商吗？
有，上面列出的公共端点是免费的。许多第三方提供商也提供每日有限次数的免费套餐。

如何从 Klaytn 端点迁移到 Kaia 端点？
将 URL 域名从 .klaytn.net 替换为 .kaia.io，并根据需要更新链 ID。请参阅 Kaia 文档获取完整的迁移指南。

我可以在公共端点上获取归档数据吗？
可以。Kaia 提供公共归档端点（例如 archive-en.node.kaia.io）。但是，这些端点可能受到速率限制。对于繁重的归档使用，请考虑专用提供商。