RPC 验证
在读取链上状态或请求签名前,先确认 RPC 端点接入的是 D9 主网,再生成强类型 PAPI 3 描述文件。
前置条件: 已完成环境配置中的 src/config.ts。
1. 验证创世哈希
Section titled “1. 验证创世哈希”使用任意 RPC 端点前,先校验创世哈希:
import { d9Config } from "./config";
const socket = new WebSocket(d9Config.rpcUrl);
socket.onopen = () => { // 创世哈希 socket.send(JSON.stringify({ jsonrpc: "2.0", id: 1, method: "chain_getBlockHash", params: [0] })); // 代币符号与精度 socket.send(JSON.stringify({ jsonrpc: "2.0", id: 2, method: "system_properties", params: [] }));};
socket.onmessage = ({ data }) => { const response = JSON.parse(String(data)); if (response.id === 1) { if (response.result !== d9Config.expectedGenesisHash) { console.error("Genesis mismatch, rejecting RPC:", response.result); socket.close(); return; } console.log("Verified genesis hash:", response.result); } else if (response.id === 2) { console.log("Chain properties:", response.result); }};验证: 控制台输出 Verified genesis hash: 以及你配置的创世哈希。
每次发起交易签名请求前,请再次核对创世哈希。
2. 基于同一个最终确认区块读取
Section titled “2. 基于同一个最终确认区块读取”- 调用
chain_getFinalizedHead获取最新最终确认区块哈希。 - 将该哈希作为
at参数传入所有相互关联的state_getStorage与state_call请求。
若不固定区块高度,价格、池子储备与手续费估算可能来自不同区块,导致状态不一致。
3. 生成 PAPI 3 描述文件
Section titled “3. 生成 PAPI 3 描述文件”-
在 Shell 中导出已验证的 RPC 地址(PAPI CLI 不会自动读取 Vite 的
.env文件):终端窗口 export VITE_D9_RPC_URL=wss://rpc-hermes.d9network.com # 第 1 步验证过的地址 -
在 DApp 项目目录下执行:
终端窗口 npm install --save-exact polkadot-api@3.3.0 @d9-network/dapp-connector@0.2.0 effect@4.0.5: "${VITE_D9_RPC_URL:?Export the verified VITE_D9_RPC_URL first}"npx papi add d9 -w "$VITE_D9_RPC_URL"npx papi generate -
将生成的
.papi配置与元数据文件提交到版本库。 -
每次完成审核的 Runtime 升级后,请重新运行
npx papi generate,并保持代码生成与运行时使用相同版本的polkadot-api。
验证: 本地生成 @polkadot-api/descriptors 包,并正常导出 d9 与 getMetadata。
| 报错信息 | 处理方式 |
|---|---|
Genesis mismatch, rejecting RPC |
换用主网端点中的其他 RPC,并核对 VITE_D9_GENESIS_HASH。 |
Export the verified VITE_D9_RPC_URL first |
在当前 Shell 会话中先执行第 3.1 步的 export 命令。 |
