環境設定
建立統一的 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。
