什么是 peaq 主网 RPC 端点？

peaq 是一个基于 Substrate 构建、接入 Polkadot 生态的 EVM 兼容 Layer-1 区块链。它专为 DePIN（去中心化物理基础设施网络）和机器导向应用而设计，但从 RPC 角度来看，它就像一个标准的 EVM 链，链 ID 为 3338，原生代币为 PEAQ。本文将介绍 peaq 主网 RPC 的配置、链设置、JSON-RPC 示例、端点选择，以及连接钱包或后端服务时可能遇到的常见问题。

peaq 主网 RPC 决策检查清单

在将 peaq 添加到钱包或将 peaq RPC 接入后端之前，请逐项检查以下列表：

• 确认链 ID 为 3338（0xd0a）。链 ID 错误会导致钱包和库在交易签名时出错。
• 通过 HTTP 进行 JSON-RPC 调用时应使用 HTTPS，通过 WebSocket 进行订阅时应使用 WSS。纯 HTTP 和 WS 仅应在本地测试中使用。
• 生产流量应优先使用托管端点或专用节点，而不是共享的公共 URL。公共 URL 可能被限流或在不另行通知的情况下更改。
• 验证端点是否支持你所需的以太坊 JSON-RPC 方法，例如 eth_chainId、eth_blockNumber、eth_getLogs 和 eth_sendRawTransaction。
• 检查你是否需要 Substrate 特定方法。peaq 运行在 Substrate 上，因此一些提供商也会暴露 chain_getBlock 和 chain_getFinalizedHead 等方法。
• 在启动前测试应用的请求模式。大型 eth_getLogs 查询、重复轮询和 WebSocket 订阅都会影响端点行为。
• 决定是否需要存档数据。如果你的应用读取历史余额或过去的事件，可能需要存档节点或支持存档的 RPC 套餐。
• 监控延迟、错误率和故障转移行为。生产环境中的单个 RPC URL 可能成为瓶颈。

什么是 peaq 主网？

peaq 是一个 Layer-1 网络，通过让机器和物理基础设施能够注册身份、进行交易并从数据中获利，来支持“万物经济”。该网络基于 Substrate 构建，并作为 Polkadot 平行链运行。它提供两种执行环境：用 Solidity 编写的 EVM 智能合约，以及用 Rust 编写的 Substrate pallet。

对开发者而言，这种双重执行模型意味着 peaq 主网 RPC 不仅仅是一个兼容以太坊的 JSON-RPC 端点。同一个节点还可以暴露 Polkadot 风格的 JSON-RPC 方法。在实践中，大多数 EVM 工具都可以直接使用：Hardhat、Foundry、ethers.js、viem 和 MetaMask 都可在配置正确的网络设置后与 peaq 交互。如果你使用基于 Substrate 的工具，也可以通过 Polkadot API 生态中的 RPC 方法查询链。

peaq 主网链设置速览

下表列出了在将 peaq 添加到钱包、索引器或中间件服务时最可能需要设置的参数。

你可以在 ChainList 等聚合器中验证当前的公共端点和链元数据列表，但在生产环境使用之前，请务必对照网络的官方文档确认端点。

如何连接 peaq 主网 RPC

测试 peaq RPC 端点最简单的方法是发送 JSON-RPC 请求并比较返回的链 ID。curl 请求如下所示：

curl -sS -X POST https://peaq.api.onfinality.io/public -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","method":"eth_chainId","params":[],"id":1}'

如果端点正常，响应包含 "result":"0xd0a"，这是 3338 的十六进制表示。

你也可以使用 ethers.js 在 JavaScript 中执行相同检查：

import { ethers } from "ethers";

const provider = new ethers.JsonRpcProvider("https://peaq.api.onfinality.io/public");
const network = await provider.getNetwork();
console.log(network.chainId.toString()); // 3338

对于生产应用，请将公共 URL 替换为 RPC 提供商账户中的端点。托管提供商通常会为你提供 API 密钥和仪表盘，你可以在其中监控用量并在需要时轮换密钥。

在使用 peaq 主网 RPC 端点之前应该检查什么

一个可用的端点只是最低要求。在依赖它之前，请检查它在应用实际产生的负载下表现如何。

方法覆盖

peaq 同时支持以太坊风格和 Substrate 风格的 RPC 方法。提供商可能暴露完整的以太坊 JSON-RPC 方法集，也可能只暴露一部分。如果你的应用通过 eth_subscribe 订阅待处理交易或事件日志，请确认提供商在 WSS 上支持该方法。如果你的应用需要 Substrate 方法，请确认这些方法也可用。

存档和 trace 支持

存档节点保留历史状态，这对索引器、分析工具以及显示历史余额的 dApp 很有用。并非每个 peaq RPC 端点都提供存档数据。如果你知道应用会查询历史状态，请选择提供存档节点或 trace 节点的提供商。trace 方法在 peaq RPC 上不太常见，因此在构建依赖这些方法的功能之前，请先确认其可用性。

WebSocket 可靠性

钱包和实时仪表盘依赖 WebSocket 连接来接收新区块、日志和交易确认。稳定的 WSS 端点与 HTTPS 端点同样重要。如果只用 curl 测试，你可能会忽略仅在持续使用下才会出现的连接断开、高重连频率或订阅限制。

速率限制

共享或公共 RPC 端点通常同时响应来自许多用户的许多请求。在高负载下，你可能会看到 HTTP 429 响应或连接限流。托管 RPC 提供商提供更高的限制和更清晰的用量指标，而专用节点则为你提供不与其他工作负载共享的端点。

为 peaq 选择公共 RPC、托管 RPC 还是专用节点？

你的选择取决于你是在快速开发原型、运行小型生产应用，还是在运营需要严格控制的基础设施。

• 公共 RPC 端点适合快速测试、教程和本地开发。它们不是生产环境的稳定基础，因为其可用性和限制可能会变化。
• 托管 RPC API（例如 OnFinality RPC API）为你提供托管端点，带有 API 密钥管理、用量监控和网络特定配置。对于希望避免节点运维的团队来说，这是一个很好的中间选择。
• 专用节点为你提供隔离的 peaq 节点，可用于数据密集型工作负载、存档查询、自定义调优，以及不希望与其他项目共享基础设施的场景。OnFinality 为需要这种控制级别的团队提供专用节点配置服务。

你可以在 RPC 定价页面上比较当前选项，并在 支持的网络页面上查看包含哪些网络。具体到 peaq，peaq 网络页面 列出了当前的端点选项和连接详情。

调试常见 peaq RPC 问题

即使链设置正确，连接 peaq 主网时仍可能遇到问题。以下是常见的故障模式及应对方法。

钱包或 SDK 中的链 ID 错误

如果交易签名失败或钱包显示错误的网络，请检查链 ID。peaq 主网的链 ID 是 3338。有些工具接受十六进制链 ID，例如 0xd0a。注意不要误用 peaq 测试网的链 ID。

HTTP 429 或速率限制

当请求因 429 Too Many Requests 失败时，说明端点正在对你的流量进行限流。请减小批量大小、增加退避，或改用托管/专用提供商。不应将公共端点视为无限的基础设施。

eth_getLogs 超时

在较大的区块范围内查询日志可能会超时，尤其是在共享端点上。请使用更小的区块范围并并行执行查询；如果应用经常需要大规模日志扫描，可以使用索引器。

WebSocket 断开

WebSocket 连接可能因网络变化、空闲超时或提供商限制而断开。请实施带指数退避的重连策略，并订阅支持你使用场景的 WSS 端点。

缺少 Substrate RPC 方法

如果某个工具期望 chain_getBlockHash 或类似 Substrate 方法，请确认该端点是兼容 Substrate 的 peaq 节点。一些提供商仅暴露 EVM 方法集；在这种情况下，请使用同时暴露两种方法集的提供商。

使用 OnFinality 获取 peaq 主网 RPC

OnFinality 为 peaq 和许多其他网络提供托管的 RPC 基础设施。如果你需要 peaq 主网 RPC 端点又不想自己运行节点，可以创建 API 密钥并使用托管 RPC API。OnFinality 还为需要隔离基础设施以进行存档查询、高请求量或自定义需求的团队提供专用节点。具体能力和套餐记录在 peaq 网络页面 和 RPC 定价页面 上。

由于 peaq 是兼容 EVM 的 Substrate 链，你可能希望在同一个应用中使用以太坊 JSON-RPC 方法和 Substrate 方法。OnFinality 通过其通用 RPC API 服务 和 专用节点服务 支持该网络。开始前请查看网络页面，了解当前的端点格式和访问详情。

关键要点

• peaq 主网使用链 ID 3338 和原生代币 PEAQ。
• 由于 peaq 兼容 EVM，你可以使用标准以太坊 JSON-RPC 工具进行连接。
• 实时订阅需要 WSS；请求/响应调用使用 HTTPS 即可。
• 公共端点适合测试，但生产工作负载应使用托管 RPC 提供商或专用节点。
• 在扩展之前，请验证端点的方法覆盖、存档支持和速率限制。
• OnFinality 为 peaq 提供托管 RPC 和专用节点选项；请查看网络页面获取最新详情。

常见问题

peaq 主网 RPC 的链 ID 是什么？

peaq 主网的链 ID 是 3338，十六进制为 0xd0a。

peaq 主网是否兼容 EVM？

是的。peaq 基于 Substrate 构建，但支持以太坊 JSON-RPC API，因此 EVM 钱包和 SDK 只需正确的链设置即可连接。

peaq 主网使用什么代币作为 Gas？

peaq 主网使用原生 PEAQ 代币作为 Gas 和价值转移。

我可以在生产环境中使用公共 peaq RPC 端点吗？

公共端点适合测试，但它们是共享的，可能会受到速率限制。对于生产环境，请使用托管 RPC 服务或专用节点，以获得稳定的访问和明确的用量限制。