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

IoTeX 是一个兼容 EVM 的 Layer 1 区块链，专为 DePIN（去中心化物理基础设施网络）和机器经济优化。要在 IoTeX 上构建，你需要一个 RPC 端点，让你的钱包、dApp 或后端与链通信。本指南涵盖了你需要的一切：官方端点、链设置、示例连接以及选择正确 RPC 提供商的检查清单。

IoTeX RPC 决策检查清单

在设置 IoTeX 连接时使用此清单：

• 验证正确的链 ID（主网为 4689，测试网为 4690）
• 选择全节点（轻量、快速）或归档节点（支持历史状态查询）
• 通过测试调用评估提供商延迟和稳定性
• 如果 dApp 需要实时事件，确认 WebSocket 支持
• 了解速率限制——公共端点可能会限制高流量
• 决定使用公共共享 RPC 还是用于生产工作负载的专用或私有端点
• 检查测试网是否可用于开发和预发布

IoTeX 网络链设置

IoTeX RPC 端点

IoTeX 基金会和多个第三方提供商提供公共 RPC 端点。以下是主网和测试网的常见选项。

主网全节点端点

主网归档节点端点

测试网端点

如何连接到 IoTeX

使用 ethers.js（JavaScript）

import { ethers } from "ethers";

// 连接到 IoTeX 主网
const provider = new ethers.JsonRpcProvider("https://babel-api.mainnet.iotex.io");

// 获取链 ID 以验证连接
const network = await provider.getNetwork();
console.log(`Connected to chain ID: ${network.chainId}`); // 应为 4689n

// 获取当前区块号
const blockNumber = await provider.getBlockNumber();
console.log(`Current block: ${blockNumber}`);

// 查询地址余额
const balance = await provider.getBalance("0xYourIoTeXAddress");
console.log(`Balance: ${ethers.formatEther(balance)} IOTX`);

使用 curl

# 获取最新区块号
curl -X POST https://babel-api.mainnet.iotex.io \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'

# 检查 ETH 余额（IOTX）
curl -X POST https://babel-api.mainnet.iotex.io \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"eth_getBalance","params":["0xYourIoTeXAddress", "latest"],"id":1}'

将 IoTeX 添加到 MetaMask

打开 MetaMask → 网络 → 手动添加网络并填写：

• 网络名称: IoTeX 主网
• RPC URL: 任意全节点端点（例如 https://babel-api.mainnet.iotex.io）
• 链 ID: 4689
• 符号: IOTX
• 浏览器 URL: https://iotexscan.io

如何选择 IoTeX RPC 提供商

并非所有 RPC 端点都相同。根据项目需求，使用以下标准评估提供商。

公共 vs. 专用 RPC

• 公共 RPC：免费且易于启动，但由许多用户共享。速率限制和偶尔的拥塞可能影响可靠性。
• 专用 RPC：具有预留容量、稳定性能且通常可访问归档或追踪 API 的私有端点。适用于生产级 dApp。

OnFinality 为需要可预测性能和支持的团队提供专用 IoTeX 节点。访问 IoTeX 网络页面 了解详情。

设置本地 IoTeX RPC 节点

如果你更喜欢完全控制，可以运行自己的 IoTeX 全节点。IoTeX 文档提供了基于 Docker 部署的 引导指南。你需要下载快照（包括用于 RPC 查询的数据库索引）并暴露端口 15014 用于以太坊 JSON-RPC 网关。这种方法提供无限的请求，但需要持续的基础设施维护。

常见 IoTeX RPC 问题排查

• 连接超时：确保你的防火墙允许出站流量到 RPC 端点。如果某个端点较慢，尝试其他提供商。
• 速率受限：如果收到 HTTP 429 错误，降低请求频率或切换到限制更高的提供商。
• 错误的链 ID：验证链 ID 为 4689（主网）或 4690（测试网）。使用错误的 ID 可能导致交易被拒绝。
• 缺少归档数据：对于历史查询，使用归档端点。全节点仅保留近期状态。

关键要点

• IoTeX 使用兼容 EVM 的 RPC——你可以重用标准的以太坊开发工具。
• 官方端点免费但可能有速率限制；对于生产环境，根据延迟、归档支持、WebSocket 和定价评估提供商。
• OnFinality 提供公共 IoTeX RPC 和具有一致性能和支持的专用节点。
• 在集成前始终验证链 ID（4689）并使用简单的 eth_blockNumber 调用进行测试。

有关支持的网络和基础设施选项的完整列表，请访问 OnFinality 网络。