关于 peaq 网络，我应该了解什么？

何时需要 peaq RPC 端点（以及何时不需要）

大多数搜索 peaq 网络的开发者属于以下三类之一：他们正在评估 peaq 作为 DePIN 项目的结算层；他们已经部署了合约或 pallet，需要一种可靠的方式来读写链状态；或者他们正在连接钱包或索引器并遇到连接问题。关键决策不是 peaq 是否支持 RPC——它通过基于 Substrate 的 JSON-RPC 接口支持——而是你将在生产环境中如何访问该接口。

如果你在原型设计，公共端点通常足以部署合约、查询余额和测试外部交易。如果你运行后端服务、索引器或持续提交交易的设备群，你会需要托管的 RPC 提供商或专用节点。权衡在于运营：公共端点免费但共享且限速，托管端点付费但有监控和支持，专用节点提供隔离容量，但需要你自己运行基础设施或付费让提供商运行。

本文解释 peaq 是什么、其 RPC 接口如何工作、如何连接，以及如何在公共、托管和专用访问之间做出选择。它不假设你已经了解 Substrate 工具。

peaq 网络究竟是什么

peaq 是一条为去中心化物理基础设施网络设计的 Layer-1 区块链——这些网络由机器、传感器、车辆和机器人组成，它们需要在不依赖中央运营商的情况下识别自己、进行交易并获得奖励。通用链将设备视为普通账户，而 peaq 将面向机器的原语构建到协议层中。

对开发者最相关的原语包括：

• 自主主权机器身份。 设备可以持有去中心化标识符（DID），并在没有中心化注册表的情况下证明所有权或控制权。
• 机器 NFT 和代币化资产。 物理资产可以在链上表示，以便进行融资、租赁或共享。
• 自主交易流程。 机器可以使用网络的原生代币相互支付数据、能源或计算费用。
• 基于 Substrate 的运行时。 peaq 使用 Substrate 构建，这意味着它在支持的地方暴露标准的 Substrate JSON-RPC 接口以及 EVM 兼容工具。

由于 peaq 基于 Substrate，RPC 接口与以太坊节点并不完全相同。你会看到 chain_getHeader、state_getStorage 和 author_submitExtrinsic 等方法，而不仅仅是 eth_getBlockByNumber。如果你的应用假设使用以太坊形式的 RPC，请在编写集成代码之前检查你针对的是哪个兼容层。

链设置概览

在连接之前，确认你目标环境对应的网络参数。peaq 有主网和测试网（agung），混淆两者是导致令人困惑的错误的最常见原因之一。

如果不确定需要哪个环境，请从测试网开始。部署、测试你的外部交易流程，只有在集成稳定后才迁移到主网。OnFinality 将 peaq 列为其支持的 RPC 网络之一，peaq 网络页面是确认当前端点详细信息的权威位置。

连接到 peaq：配置和代码

Substrate 工具通常通过 Polkadot.js、Substrate RPC 库或 WebSocket 端点连接。下面的模式展示了使用 Polkadot.js 进行最小连接和余额查询。将端点占位符替换为来自你的提供商或 peaq 网络页面的端点。

import { ApiPromise, WsProvider } from '@polkadot/api';

// Use the WebSocket endpoint issued by your RPC provider.
const provider = new WsProvider('wss://<your-peaq-endpoint>');
const api = await ApiPromise.create({ provider });

const [chain, nodeName, nodeVersion] = await Promise.all([
  api.rpc.system.chain(),
  api.rpc.system.name(),
  api.rpc.system.version(),
]);

console.log(`Connected to ${chain} via ${nodeName} v${nodeVersion}`);

// Query the balance of an SS58 address.
const { data: { free } } = await api.query.system.account('<SS58_ADDRESS>');
console.log(`Free balance: ${free.toHuman()}`);

如果不想安装依赖，快速检查连接性，可以使用 curl 请求 HTTP 端点，确认节点可达并响应：

curl -sS -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"system_chain","params":[]}' \
  https://<your-peaq-endpoint>

健康的响应会返回链名称。如果收到连接错误，说明端点错误或不可达；如果收到 JSON-RPC 错误，说明该节点不支持该方法。在调试时，这种区分可以节省时间。

生产就绪检查清单

从测试网原型迁移到实时 DePIN 工作负载会改变你对端点的需求。在发布前完成以下清单：

1. 分离读写路径。 索引器和仪表板不应与交易提交竞争相同的连接预算。
2. 使用 WebSocket 处理事件。 通过订阅比轮询更容易跟踪设备状态变化和外部交易确认。
3. 规划重连。 长寿命的 WebSocket 连接会断开。你的客户端应自动重连并重新订阅。
4. 监控区块高度。 区块高度指标停滞是端点落后的最快信号。
5. 保留备用端点。 如果主提供商发生故障，第二个端点可以防止完全中断。
6. 确认归档需求。 如果查询历史状态，请验证端点提供归档数据，而不仅仅是最近的区块。
7. 用真实负载测试。 设备群提交交易的行为与单个测试脚本不同。

如果公共端点难以满足其中任何一项，那就是转向托管或专用基础设施的信号。OnFinality 的 RPC API 服务和专用节点选项正是为此过渡而构建的。

公共、托管和专用访问比较

访问 peaq 没有唯一正确的方式。正确的选择取决于你需要多少控制和可靠性，以及你愿意承担多少运营工作。

OnFinality 在这里列在第一位，因为它是本网站运营的选项；比较旨在事实性而非促销性。关键问题不是哪一行“最好”，而是哪一行匹配你的工作负载。黑客松项目和 10,000 台设备的设备群有非常不同的需求。

peaq 集成通常在哪里出问题

大多数 peaq RPC 问题并不奇特。它们集中在几个反复出现的原因上：

• 网络错误。 针对测试网端点查询主网地址会返回空余额，看起来像 bug，但其实是配置错误。
• 使用 HTTP 进行订阅。 Substrate 订阅需要 WebSocket。如果你的事件监听器从未触发，请先检查传输方式。
• 地址格式不匹配。 SS58 和 EVM 风格地址不可互换。在提交前验证格式。
• 共享端点上的速率限制。 针对公共端点的突发工作负载会被限流，表现为间歇性超时。
• 过时或非归档节点。 针对修剪节点的历史查询会失败，即使最近查询成功。
• 未处理的重连。 断开的 WebSocket 从未重新建立，会使健康的服务看起来已死。

一个有用的调试习惯是隔离层。针对你的端点运行上面的 curl 检查。如果成功，问题在你的客户端或请求中。如果失败，问题在端点或网络。这个单一测试消除了一半的可能原因。

为 peaq 选择 RPC 提供商

如果你决定使用托管提供商，请根据实际影响 DePIN 工作负载的标准来评估候选者，而不是根据头条数字。

• 传输支持。 确认 HTTP 和 WebSocket 都可用，因为订阅对设备状态跟踪至关重要。
• 归档可用性。 如果需要历史状态，请明确询问。并非每个提供商都提供归档数据。
• 方法覆盖。 验证你依赖的 Substrate 方法已暴露，尤其是任何自定义运行时方法。
• 故障转移和冗余。 询问提供商如何处理节点故障，以及你是否可以配置备用。
• 可观测性。 你需要可以告警的指标，而不仅仅是状态页面。
• 支持模式。 对于生产 DePIN，具有真实响应预期的支持渠道比微小的价格差异更重要。

有关更广泛的框架，请参阅如何选择 RPC 提供商。有关成本规划，请查看 RPC 定价，并将计划层级与你的预期请求和订阅量匹配。

关键要点

• peaq 是一条基于 Substrate 的 Layer-1，专为 DePIN 和机器经济构建，具有机器身份、代币化资产和自主交易原语。
• 其 RPC 接口是 Substrate 形式的，因此仅以太坊的假设无法直接迁移。
• 使用 WebSocket 进行订阅，HTTP 用于请求/响应，并始终确认你在主网还是 agung 测试网。
• 公共端点适合原型设计；托管 RPC 和专用节点适合需要监控、支持和隔离的生产工作负载。
• 大多数集成失败源于网络错误、传输错误、地址格式不匹配或速率限制——所有这些都可以通过一次连接检查来诊断。
• OnFinality 提供 peaq RPC API 和专用节点基础设施；从 peaq 网络页面和支持的网络开始。

常见问题

peaq 兼容 EVM 吗？ peaq 基于 Substrate，并暴露 Substrate JSON-RPC 方法。EVM 兼容性取决于你针对的特定运行时和工具层，因此在构建之前，请确认你的应用所需的方法集与你计划使用的端点匹配。

在 peaq 上构建需要专用节点吗？ 不需要。对于原型设计和低量测试，公共或托管端点就足够了。当你需要隔离容量、可预测的吞吐量或对节点环境更严格的控制时，专用节点才有意义。

为什么我的 peaq 订阅从未触发？ 最常见的原因是在需要 WebSocket 端点的地方使用了 HTTP 端点。Substrate 订阅需要持久的 WebSocket 连接，如果连接断开，客户端应重新连接并重新订阅。

如何知道我在主网还是测试网？ 使用 system_chain 查询链名称，并与你打算使用的网络进行比较。peaq 主网和 agung 测试网是独立的网络，具有独立的代币和状态。

我可以使用 OnFinality 用于 peaq 吗？ 可以。OnFinality 为 peaq 提供托管的 RPC API 访问和专用节点基础设施。查看 peaq 网络页面获取当前端点详细信息，查看 RPC 定价了解计划选项。