// 開發者

將 Bitroot 加入 MetaMask:RPC 與 Chain ID

Bitroot 遵循標準 JSON-RPC 介面,任何支援自訂 EVM 網路的錢包都可以直接連線。本頁介紹如何在 MetaMask、Rabby 或 OKX Wallet 中加入 Bitroot 網路,以及去哪裡查看目前的 RPC 位址與 Chain ID。

1. 網路參數去哪裡看

區塊瀏覽器 BRTSCAN(https://devnet.bitroot.co/overview)是目前網路名稱、RPC URL、Chain ID、貨幣符號、區塊瀏覽器 URL 的權威來源。本頁不抄錄這些值:測試網參數可能隨版本升級調整,寫死一個過期值,更可能讓你連錯網路。

測試網與未來的主網參數不同。複製之前,先確認 BRTSCAN 目前展示的是哪個環境。

2. 在 MetaMask 中加入網路

  1. 開啟 MetaMask,點擊網路選擇器,選擇"新增網路",再選"手動新增網路"。
  2. 開啟 BRTSCAN,把網路資訊區列出的五項參數原樣填入表單。
  3. 儲存並切換到 Bitroot 網路。在領取測試幣之前餘額為 0 BRT 屬於正常情況,領取方式見水龍頭指南。

Rabby 與 OKX Wallet 的流程一致:找到"自訂網路"或"手動新增網路"入口,填入同樣的五項參數。

3. 確認連到了正確的鏈

簽署之前,先比對錢包顯示的 Chain ID 與 BRTSCAN 公示的值。在程式碼裡不要只信設定檔,應在執行時驗證:

import { ethers } from "ethers";

const provider = new ethers.JsonRpcProvider(process.env.BITROOT_RPC_URL);
const { chainId } = await provider.getNetwork();

if (chainId !== BigInt(process.env.BITROOT_CHAIN_ID!)) {
  throw new Error(`Unexpected chain id: ${chainId}`);
}

4. 下一步

5. 常見問題

為什麼本頁沒有列出 RPC 位址? 該值可能隨網路版本變化。BRTSCAN 始終展示目前值,所以我們只建議以它為準。

我現有的錢包能直接用嗎? 任何允許新增自訂 EVM 網路的錢包都可以,不需要外掛或轉接層。

測試網和主網的參數相同嗎? 不同。RPC URL 與 Chain ID 因環境而異。