跳到內容

環境設定

建立統一的 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。