什么是 peaq 网络 RPC？如何连接？

peaq 网络 RPC 是应用程序用于在 peaq 区块链上读写数据的端点，peaq 是一个兼容 EVM 的 Layer-1，专为去中心化物理基础设施网络（DePIN）和机器经济而设计。如果您要在 peaq 上连接钱包、运行索引器或构建自动化服务，RPC 端点就是集成的起点。本参考涵盖 peaq 链设置、JSON-RPC 基础知识、提供商评估标准、常见故障模式，以及如何从公共测试端点迁移到生产级访问。

peaq 网络 RPC 决策清单

在将您的应用连接到 peaq RPC 端点之前，请完成此清单。

• 确认 peaq 链详细信息：链 ID 3338，网络名称 peaq，符号 PEAQ，18 位小数。
• 为每个环境选择端点：公共端点用于暂存，托管或专用 RPC 用于生产。
• 验证您依赖的 JSON-RPC 方法在所选端点上存在，包括 eth_getLogs、eth_sendRawTransaction 和 WebSocket 订阅。
• 如果您的 dApp 需要实时区块或日志更新，请检查 WebSocket 支持。
• 使用代表性工作负载测试速率限制，而不是单个 eth_blockNumber 调用。
• 决定是否需要归档数据、trace 方法或 peaq 特定的 pallet RPC。
• 规划故障转移：至少保留两个端点，或使用跨多个区域路由的提供商。

什么是 peaq 网络 RPC？

peaq 网络 RPC（远程过程调用）是您的应用程序与 peaq 区块链之间的 API 网关。它允许您查询链状态、估算 gas、提交交易以及订阅事件。由于 peaq 是构建在 Substrate 运行时上的 EVM 兼容网络，它除了自身的机器经济功能外，还公开了标准的以太坊 JSON-RPC 方法。大多数 Web3 工具可以像连接任何 EVM 链一样连接 peaq，只要它们具有正确的链配置。

peaq 将自己描述为机器的经济基础设施。该链支持机器身份、声誉、支付以及机器人、车辆、传感器和 AI 代理的代币化所有权。对于开发者来说，这意味着 peaq 上的 RPC 流量可能与典型的 DeFi 链不同。您可能会看到高频遥测写入、自主代理交易或来自 DePIN 传感器的大量日志查询。这些工作负载使得 RPC 选择和容量规划比简单的读密集型链更为重要。

在底层，peaq 使用基于 Substrate 的运行时，并带有 EVM 兼容层。RPC 请求可以通过标准的以太坊 JSON-RPC 接口发送，而 peaq 特定的身份、信用和机器收益模块在 Substrate 级别仍然可用。对于大多数应用程序开发者来说，EVM 接口就足够了。您将 peaq 网络配置添加到您的工具中，然后开始调用方法。

peaq 网络链设置

当您将 peaq 网络添加到钱包或配置 Web3 库时，请使用以下值。

这些公共端点便于原型开发，但可能会受到速率限制或随时间变化。请查看 ChainList 或 peaq 文档以获取当前列表。对于生产应用程序，请使用托管 RPC 提供商，其端点支持扩展、WebSocket 和故障转移。OnFinality 的 peaq 网络页面 显示了可用的托管选项。

以下是一个示例配置对象，您可以在钱包或 viem 等库中使用：

const peaqNetwork = {
  id: 3338,
  name: 'peaq',
  nativeCurrency: {
    name: 'peaq',
    symbol: 'PEAQ',
    decimals: 18,
  },
  rpcUrls: {
    default: { http: ['https://quicknode1.peaq.xyz'] },
    public: { http: ['https://quicknode1.peaq.xyz'] },
  },
  blockExplorers: {
    default: { name: 'Subscan', url: 'https://peaq.subscan.io' },
  },
}

如何测试 peaq RPC 端点

您可以使用简单的 JSON-RPC 请求测试任何 peaq RPC 端点。以下 curl 命令返回链 ID。如果端点返回 0xd0a (3338)，则您的连接正常。

curl -X POST <YOUR_PEAQ_RPC_URL> \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"eth_chainId","params":[],"id":1}'

将 <YOUR_PEAQ_RPC_URL> 替换为上表中的端点或您的 RPC 提供商提供的端点。要检查最新区块号，请使用：

curl -X POST <YOUR_PEAQ_RPC_URL> \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'

如果您使用 JavaScript 客户端，相同的调用如下所示：

import { createPublicClient, http } from 'viem'

const client = createPublicClient({
  chain: peaqNetwork,
  transport: http(),
})

const blockNumber = await client.getBlockNumber()
console.log('Latest peaq block:', blockNumber)

peaq 开发者的关键 JSON-RPC 方法

由于 peaq 兼容 EVM，您可以使用标准的以太坊 JSON-RPC 方法：

• eth_chainId — 验证您已连接到链 3338。
• eth_blockNumber — 获取最新的最终确定区块。
• eth_getBalance — 读取账户余额。
• eth_call — 执行只读合约调用。
• eth_sendRawTransaction — 广播已签名的交易。
• eth_getTransactionReceipt — 确认交易结果。
• eth_getLogs — 查询事件日志以进行索引或监控。
• eth_subscribe — 通过 WebSocket 订阅新区块、日志或待处理交易。

peaq 上的 DePIN 项目通常依赖 eth_getLogs 进行遥测索引。查询非常大的日志范围可能会导致共享端点超时。如果工作负载较重，请将范围拆分为较小的块或使用专用节点。

对于 Substrate 级别的访问，peaq 还为其链特定的 pallet 公开了 RPC 方法。大多数 peaqOS 功能可通过合约获得，因此 EVM 工具足以满足大多数构建需求。

如何选择 peaq RPC 提供商

公共 peaq RPC 端点适用于开发，但生产 dApp 需要基础设施计划。下表总结了在比较 peaq 网络的 RPC 提供商时应评估的内容。

一个 peaq 特定的考虑因素是工作负载形状。DePIN 应用程序通常从许多设备发送许多小写入。共享公共端点可能将其视为滥用流量。具有明确吞吐量限制的托管提供商或专用节点可为您提供可预测的余量。您还应该检查提供商的端点策略是否处理 WebSocket 连接限制，因为自主机器可能保持长期订阅打开。

如果您正在评估提供商，请从 RPC 提供商选择指南 开始，以正式确定您的标准。支持的网络页面 列出了 OnFinality 管理的链，包括 peaq，RPC 定价页面 解释了公共、付费和专用层级之间的区别。

常见的 peaq RPC 错误及修复方法

即使链设置正确，您也会遇到错误。以下是最常见的错误。

链 ID 不匹配

如果钱包或 dApp 提示链 ID 错误，您可能输入了十进制 3338，但提供商期望十六进制值，反之亦然。peaq 的十六进制值为 0xd0a。

超出速率限制

公共 peaq 端点在负载下通常返回 429 Too Many Requests 或空响应。缓解措施：缓存读取、批量请求、使用托管端点或切换到专用节点。

eth_getLogs 超时

在单个请求中扫描宽区块范围可能会超过网关的响应时间限制。缓解措施：查询较小的范围、分页，或使用专用 RPC 运行索引器。

Nonce 太低

当钱包使用过时的 nonce 重试交易时会发生这种情况。在 peaq 上，与其他 EVM 链一样，跟踪每个地址的待处理 nonce，并使用 eth_getTransactionCount(address, 'pending') 重试。

RPC 响应为空或 null

如果 eth_call 在应有值的合约上返回 null，请确认您使用了正确的区块标签，并且该地址存在于链 3338 上。

待处理交易卡住

如果交易长时间处于待处理状态，端点可能未传播提交，或者 gas 价格低于当前最低要求。监控内存池，并在必要时使用更新的费用重新提交。

使用 OnFinality 获取 peaq 网络 RPC

OnFinality 作为其托管基础设施服务的一部分，提供 peaq RPC API 端点。该网络列在 支持的网络 目录中，您可以从 peaq 网络页面 获取连接详细信息。OnFinality 还为需要隔离容量、自定义方法覆盖或归档数据的团队提供 专用节点 基础设施。对于仍在估算流量的团队，API 服务 提供共享和可扩展的 RPC 访问，而无需运行节点硬件。

当您将 OnFinality 与运行自己的 peaq 节点进行比较时，请考虑运营成本。peaq 节点必须保持同步、监控，并在网络发布后升级。托管 RPC 消除了该工作负载，使您的团队可以专注于机器经济应用层。

关键要点

• peaq 网络使用链 ID 3338、原生代币 PEAQ 和 Subscan 浏览器 https://peaq.subscan.io。
• peaq 公开标准的 EVM JSON-RPC 方法，因此大多数以太坊工具只需简单的网络配置即可工作。
• 公共 peaq RPC 端点适合原型开发，但可能会限制您的流量；生产应用程序应使用托管或专用基础设施。
• 在选择提供商之前，验证 WebSocket 支持、eth_getLogs 行为和专用容量。
• OnFinality 提供 peaq RPC API 和专用节点选项。有关详细信息，请参阅 peaq 网络页面 和 RPC 定价 页面以进行层级比较。

常见问题解答

什么是 peaq 网络 RPC？

peaq 网络 RPC 是允许应用程序在 peaq 区块链上查询链状态和提交交易的 API 端点。由于 peaq 兼容 EVM，它支持标准的以太坊 JSON-RPC 方法。

peaq 链 ID 是什么？

peaq 链 ID 是 3338。十六进制表示为 0xd0a。

官方 peaq RPC URL 是什么？

没有单一的官方公共 RPC URL。社区维护的公共端点目前是 https://quicknode1.peaq.xyz、https://quicknode2.peaq.xyz 和 https://quicknode3.peaq.xyz。对于生产环境，请使用托管提供商，并查看 peaq 网络页面 获取端点配置。

peaq RPC 是否支持 WebSocket 订阅？

peaq 通过托管提供商和一些公共端点公开 WebSocket 端点。如果您的 dApp 依赖 eth_subscribe，请在生产前与您的提供商确认 WebSocket 支持。

我需要为 peaq 使用专用节点吗？

这取决于您的工作负载。如果您索引大量 eth_getLogs 数据、发送高频机器交易或需要一致的延迟，专用 peaq 节点会有所帮助。从共享 RPC 开始进行开发，当您看到速率限制或性能下降时再升级。