环境配置
定义统一的 d9Config 配置模块,供所有指南与示例代码导入。
前置条件: 一个 Vite + TypeScript 项目,以及主网端点中的主网参数。
-
在
.env.local(或构建环境变量)中添加以下配置(主网示例):终端窗口 VITE_D9_RPC_URL=wss://rpc-hermes.d9network.comVITE_D9_GENESIS_HASH=0xc3140da27f348abd94a638e9ca7ee7e9005caf5f2b451044c9487905ea5e0991VITE_D9_RELAY_URL=wss://relay.d9network.comVITE_D9_PROJECT_ID=d9-wallet-publicVITE_D9_WALLET_SCHEME=d9wallet- 确保所有变量来自同一目标网络。
- 必须从可信发布配置中复制
VITE_D9_GENESIS_HASH,切勿直接取自待校验的 RPC 节点。 VITE_D9_PROJECT_ID可为任意非空字符串,D9 Relay 不使用该值进行鉴权。
-
新建
src/config.ts:function required(name: string): string {const value = import.meta.env[name]?.trim();if (!value) throw new Error(`缺少环境变量: ${name}`);return value;}export const d9Config = {rpcUrl: required("VITE_D9_RPC_URL"),expectedGenesisHash: required("VITE_D9_GENESIS_HASH"),relayUrl: required("VITE_D9_RELAY_URL"),projectId: required("VITE_D9_PROJECT_ID"),walletScheme: required("VITE_D9_WALLET_SCHEME"),}; -
保留 Vite 生成的
src/vite-env.d.ts,确保 TypeScript 能够识别import.meta.env。
启动应用,若缺少任一变量将抛出 缺少环境变量: <name>。配置完成后,请在请求任何签名之前执行 RPC 验证。
- 验证创世哈希后,应直接从链上读取 Runtime 版本、元数据、资产精度、手续费参数、储备下限、锁定期与冷却期,并将相互关联的查询固定在同一个最终确认区块上。
- 钱包协议链 ID 应从
@d9-network/dapp-connector/protocol导入;它不用于选择网络,也不能替代创世哈希校验。
钱包初始化选项请参阅 Connector API。
