跳转到内容

环境配置

定义统一的 d9Config 配置模块,供所有指南与示例代码导入。

前置条件: 一个 Vite + TypeScript 项目,以及主网端点中的主网参数。

  1. 在 .env.local(或构建环境变量)中添加以下配置(主网示例):

    终端窗口
    VITE_D9_RPC_URL=wss://rpc-hermes.d9network.com
    VITE_D9_GENESIS_HASH=0xc3140da27f348abd94a638e9ca7ee7e9005caf5f2b451044c9487905ea5e0991
    VITE_D9_RELAY_URL=wss://relay.d9network.com
    VITE_D9_PROJECT_ID=d9-wallet-public
    VITE_D9_WALLET_SCHEME=d9wallet
    • 确保所有变量来自同一目标网络。
    • 必须从可信发布配置中复制 VITE_D9_GENESIS_HASH,切勿直接取自待校验的 RPC 节点。
    • VITE_D9_PROJECT_ID 可为任意非空字符串,D9 Relay 不使用该值进行鉴权。
  2. 新建 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"),
    };
  3. 保留 Vite 生成的 src/vite-env.d.ts,确保 TypeScript 能够识别 import.meta.env。

启动应用,若缺少任一变量将抛出 缺少环境变量: <name>。配置完成后,请在请求任何签名之前执行 RPC 验证。

  • 验证创世哈希后,应直接从链上读取 Runtime 版本、元数据、资产精度、手续费参数、储备下限、锁定期与冷却期,并将相互关联的查询固定在同一个最终确认区块上。
  • 钱包协议链 ID 应从 @d9-network/dapp-connector/protocol 导入;它不用于选择网络,也不能替代创世哈希校验。

钱包初始化选项请参阅 Connector API。