跳转到内容

RPC 验证

在读取链上状态或请求签名前,先确认 RPC 端点接入的是 D9 主网,再生成强类型 PAPI 3 描述文件。

前置条件: 已完成环境配置中的 src/config.ts。

使用任意 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. 基于同一个最终确认区块读取”
  1. 调用 chain_getFinalizedHead 获取最新最终确认区块哈希。
  2. 将该哈希作为 at 参数传入所有相互关联的 state_getStorage 与 state_call 请求。

若不固定区块高度,价格、池子储备与手续费估算可能来自不同区块,导致状态不一致。

  1. 在 Shell 中导出已验证的 RPC 地址(PAPI CLI 不会自动读取 Vite 的 .env 文件):

    终端窗口
    export VITE_D9_RPC_URL=wss://rpc-hermes.d9network.com # 第 1 步验证过的地址
  2. 在 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
  3. 将生成的 .papi 配置与元数据文件提交到版本库。

  4. 每次完成审核的 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 命令。