附錄：MetaMask 新增 Base Sepolia 網路，以及顯示測試幣與 MLC 學習幣

第 7 週附錄 ｜ 115/10/30（五） ｜ 授課教師：馬可博士 / 李正冬 ｜ 淡江大學 資訊管理學系

這一頁是第 7 週實作的操作附錄，把教科書第五步到第七步之間「錢包這一端要做什麼」拆成一步一步。上課時同學會遇到兩種情況：一種是錢包裡看不到老師發的測試幣，另一種是領幣成功了卻找不到那 100 枚 MLC。兩種情況的原因完全不同，解決的方法也不同，請先看清症狀再動手。

附-1　先分清兩個症狀：看不到 ETH，還是看不到 MLC

多數同學卡住的時候，畫面上都長得很像——「餘額是 0」。但真正的問題可能出在三個不同的地方：網路、地址、代幣顯示。先花三十秒判斷你在哪一種，後面就不會亂做。

三種情況的判斷方式

1. 你看到的畫面 錢包上方顯示的是 Ethereum 或 Ethereum Mainnet，餘額 0 ETH，但錢包地址是對的。
真正的原因 你的錢包還在以太坊主網。老師的測試幣發在 Base Sepolia 這條測試鏈上，兩條鏈是各自獨立的帳本，主網看不到測試鏈的餘額。請參考 附-2（電腦版） 或 附-3（手機版）。
2. 你看到的畫面 網路已經是 Base Sepolia，上方有少量 ETH，但資產清單裡找不到 MLC。
真正的原因 錢包預設只顯示原生幣 ETH。MLC 是另一份合約發行的 ERC-20 代幣，必須手動「匯入代幣」才會列出來。請參考 附-4（電腦版） 或 附-5（手機版）。
3. 你看到的畫面 網路對了、學習幣也匯入了，但 MLC 餘額是 0、ETH 也是 0。
真正的原因 這不是設定問題，是幣還沒發到這個地址。請確認你提供給老師的地址，和你錢包上方顯示的地址是同一串（比對前 6 碼與後 4 碼），然後找老師核對。
先講結論：順序一定是「先加網路 → 再領測試幣（Gas）→ 再領 MLC → 最後匯入學習幣」。順序顛倒會出現兩種卡法：沒有測試幣就沒有 Gas，按下領取會被錢包拒絕；沒有先切到 Base Sepolia 就領取學習幣，會匯到錯誤的鏈上而顯示 0。

附-2　電腦版：新增 Base Sepolia 網路（Chrome／Brave／Edge 擴充功能）

桌上型與筆記型電腦上，MetaMask 是以瀏覽器擴充功能的形式運作。Base Sepolia 不是 MetaMask 內建的網路，一定要自己把下面五個參數填進去，錢包才知道要去哪裡讀資料。

Base Sepolia 網路參數（照抄，一個字都不要改）

填錯任何一欄，錢包就會連到不存在的地方，或是顯示錯誤的鏈。鏈 ID 只填數字 84532，不要加 0x。

網路名稱Base Sepolia（這欄只是給你看的標籤，可以自己取，但建議照抄）
新增 RPC URLhttps://sepolia.base.org（必須含 https://）
鏈 ID84532
貨幣符號ETH
區塊瀏覽器 URLhttps://sepolia.basescan.org

操作步驟

從打開擴充功能到切換完成，大約 1 分鐘。

  1. 點瀏覽器右上角的 MetaMask 狐狸圖示，解鎖錢包。 如果圖示被收在拼圖選單裡，先把它釘選到工具列，課堂上會一直用到。
  2. 點錢包畫面上方的網路名稱（預設寫著 Ethereum），打開網路選單。 這份選單列出你「已經加過」的網路。第一次操作時裡面不會有 Base Sepolia，這是正常的。
  3. 在選單最下方點「新增自訂網路」（Add a custom network）。 部分版本要先點「顯示測試網路」開關才看得到測試鏈相關選項；但那個開關只會顯示 MetaMask 內建的 Sepolia，不會幫你加好 Base Sepolia，仍然要走自訂網路這條路。
  4. 把上面表格的五個欄位逐一貼上：網路名稱 Base Sepolia、RPC URL https://sepolia.base.org、鏈 ID 84532、貨幣符號 ETH、區塊瀏覽器 https://sepolia.basescan.org。 貼上後把每一欄前後多餘的空白刪掉。RPC URL 前後多一個空格，連線就會失敗，這是實際最常見的錯。
  5. 點「儲存」。錢包會問你是否要立刻切換到這個網路，選「切換網路」。 如果沒跳出詢問，回到步驟 2 的網路選單，手動點一次 Base Sepolia 就會切過去。
  6. 確認錢包上方顯示 Base Sepolia，帳戶下方出現以 ETH 計價的餘額。 剛加好時餘額是 0 很正常——老師的測試幣還沒發到你的地址。等老師發完，餘額會自動出現，也可以按重新整理。
另一條路（可當驗收）：直接開領幣頁面 https://mlc2026.tohot.xyz 並按「連接錢包」，我設計的頁面會偵測你的鏈，並自動帶著完全相同的五個參數跳出「新增網路／切換網路」的確認視窗，按確認就好。課堂上還是請先手動加一次，你才會知道鏈 ID 在整個流程裡的角色。

附-3　手機版：新增 Base Sepolia 網路（MetaMask App）

手機版 App 的選單位置和擴充功能不同，但填的參數完全一樣。手機上最容易誤解的一點是：手機沒有瀏覽器擴充功能，所以領幣的網頁不是用 Safari 或 Chrome 開的，詳見本節最後的提醒。

操作步驟

iOS 與 Android 的 MetaMask App 流程相同。

  1. 打開 MetaMask App，解鎖後停在錢包主頁。
  2. 點畫面上方的網路選擇器，進入網路清單。可能要按一下右上方的漢堡選單，選擇網路。
  3. 在清單最下方找到 「自訂」分頁（Custom），點擊「添加網路」。 如果只看到內建網路清單，請把清單往下滑到底，自訂與新增的入口固定在最後。
  4. 逐一填入同一組參數：
    網路名稱：Base Sepolia
    RPC (遠端程序呼叫) URL：https://sepolia.base.org、
    RPC (遠端程序呼叫) 名稱：自動帶出
    鏈 ID：84532
    符號：ETH
    區塊瀏覽器 URL：https://sepolia.basescan.org手機輸入長網址容易漏字。建議把這一頁開在手機上看，長按複製我給的字串再貼上，不要手打。
  5. 點擊「儲存」，回到網路清單選 Base Sepolia，確認主畫面位在上方顯示這個網路名稱。
手機的兩個專屬陷阱：
① 網路不會跨裝置同步。電腦加過，手機仍然是一片空白，兩邊要各自加一次；換手機或重新安裝 App 之後也要重加。
② 不能用 Safari／Chrome 開領幣頁面。手機的一般瀏覽器沒有辦法把錢包「注入」網頁，頁面會顯示找不到錢包。請在 MetaMask App 內建的「瀏覽器／探索（Explore）」分頁輸入 https://mlc2026.tohot.xyz，才能在手機上完成連接錢包與領幣。

附-4　電腦版：匯入 MLC 代幣，看見 100 枚學習幣

領幣交易成功後，鏈上確實已經把 100 MLC 記到你的地址，但錢包不會自動列出來。原因很單純：全世界有數百萬種 ERC-20 代幣，錢包不可能預先載入所有代幣，你必須告訴它「我持有這個合約發行的代幣（MLC 學習幣）」。

MLC 代幣合約（以鏈上實查為準）

代幣合約地址0xfB145f51BB16E379cb8DC5EDf3A962dA36847F21
代幣名稱drMarcoLab Coin（貼上地址後錢包會自動帶出，不必手打）
代幣符號MLC
小數位數18
所在網路Base Sepolia（鏈 ID 84532）

操作步驟

  1. 先確認錢包上方是 Base Sepolia。 代幣是綁在「某條鏈上的某個合約」。在以太坊主網貼這個地址，錢包會說找不到代幣，或匯入一個永遠是 0 的項目。
  2. 點錢包下方的「代幣」分頁（Tokens），把資產清單叫出來。
  3. 點該區塊右上或右側的三個點 ⋯，選「匯入代幣」（Import tokens）。
  4. 切到「自訂代幣」分頁（Custom token），在「代幣合約地址」欄位貼上 0xfB145f51BB16E379cb8DC5EDf3A962dA36847F21。 貼上的位置只有一個欄位要填，其餘三格會自動帶出。若沒有自動帶出，通常是網路沒切對，或地址前後多了空白。
  5. 確認錢包帶出 drMarcoLab Coin、MLC、18 三個值，點「匯入」（部分版本是「新增自訂代幣」→「匯入代幣」）。
  6. 回到錢包主畫面，資產清單出現 100 MLC。 看到這一列，代表你已經成功把鏈上資產顯示在錢包裡——這是本週實作里程碑要截圖的畫面之一。

附-5　手機版：匯入 MLC 代幣

操作步驟

  1. 確認 App 上方網路是 Base Sepolia。
  2. 在錢包主頁把代幣清單滑到最底，點「匯入代幣」；若沒看到，改點右上角的 ⋯ 或 ＋ 找同一個功能。
  3. 在「代幣合約地址」貼上 0xfB145f51BB16E379cb8DC5EDf3A962dA36847F21。 長按貼上，不要手打 42 個字元。地址錯一個字就是另一個合約，匯入後會顯示 0。
  4. 確認自動帶出 drMarcoLab Coin / MLC / 18，點「匯入」。
  5. 回到主頁，代幣清單出現 100 MLC，完成。
備援做法（電腦、手機都適用）：用錢包內建瀏覽器開 https://sepolia.basescan.org/token/0xfB145f51BB16E379cb8DC5EDf3A962dA36847F21，區塊瀏覽器的代幣頁面通常有一個「Add MLC to MetaMask」的錢包按鈕，按下去就自動完成匯入。這個做法同時讓你親眼看到代幣的總發行量與持有人數。

附-6　完成驗收：三個地方都要對得上

不要只憑「錢包看起來有數字」就交作業。以下三項都符合，才算這一節真的完成；前兩項是里程碑截圖，第三項是你能對同學解釋「為什麼」的證據。

附-7　常見錯誤排除表

症狀 原因與處理方式
按「儲存」時提示「此鏈 ID 已存在」 你（或這台裝置先前）已經加過 Base Sepolia。直接關掉表單，從網路選單選 Base Sepolia 即可，不必重複新增。
RPC URL 貼上後，餘額一直轉圈或顯示連線失敗 檢查是否漏了 https://、是否多了空白、是否把 sepolia.base.org 打成 basescan.org（前者是節點，後者是瀏覽器，兩者不同）。
鏈 ID 填了 0x14a34 被拒 那是同一條鏈的十六進位表示。MetaMask 的欄位要十進位，請填 84532。
匯入代幣時顯示「找不到代幣」 八成是網路沒切到 Base Sepolia。先切鏈，再重貼一次合約地址。
匯入成功但 MLC 顯示 0 兩種可能：① 這個地址還沒領過；② 你領幣時用的是錢包的另一個帳戶。切回領幣時使用的帳戶，或比對地址前 6 碼與後 4 碼。
手機在 Safari 打開領幣頁，按「連接錢包」沒反應 手機一般瀏覽器無法注入錢包。改用 MetaMask App 內建的「瀏覽器／探索」分頁開同一個網址。
交易送出後一直 Pending Base Sepolia 正常約 2 秒出塊。先等 1 分鐘再重新整理；若仍卡住，多半是測試 ETH 不足，請向老師補發 Gas。
換了手機／重裝 App 後，網路與代幣都不見了 用助記詞還原錢包後，自訂網路與已匯入的代幣清單都要重做一次；資產本身在鏈上，不會消失。所以助記詞要收好，這是唯一的還原憑證。

附-8　安全提醒

  1. 只從官方網站安裝 MetaMask。搜尋結果最上面常有購買關鍵字的假站，裝到偽造擴充功能，資產會在幾秒內被搬走。
  2. 助記詞不外流。任何人（包含自稱客服、助教、老師的私訊）向你要助記詞，都是詐騙。真正的老師只需要你的公開地址來發幣。
  3. 合約地址只從這一頁或領幣頁面複製。不要從 LINE 群組、私訊或陌生網站貼來的地址匯入代幣——那是常見的「假代幣」手法。
  4. 測試幣沒有價值，但習慣要正確。Base Sepolia 的 ETH 與 MLC 都只是練習用；不過「先確認鏈、再確認地址、最後才簽名」這個順序，在主網上是保護你真金白銀的同一套動作。

附-9　名詞小辭典

RPC URL
錢包讀寫區塊鏈的「門口」。https://sepolia.base.org 是 Base 官方提供的公開節點，你的錢包所有查詢與送交易都經由它。
鏈 ID（Chain ID）
每一條鏈的身分證字號。Base Sepolia 是 84532，以太坊主網是 1，Base 主網是 8453。錢包靠它分辨「我現在在哪一條鏈上」，填錯就會連到別的鏈或直接失敗。
原生幣 vs ERC-20 代幣
ETH 是這條鏈自己的原生幣，付 Gas 用它；MLC 是部署在鏈上的合約所發行的代幣，本質是一份記錄「誰有多少 MLC」的智慧合約。這就是為什麼 ETH 自動顯示、MLC 要手動匯入。
代幣合約地址
那份 ERC-20 合約在鏈上的門牌號碼，本課程是 0xfB145f51BB16E379cb8DC5EDf3A962dA36847F21。匯入代幣時錢包就是靠它去讀你的餘額。
Gas
執行任何鏈上動作要付的手續費，用原生幣計價。在 Base Sepolia 上領一次幣的 Gas 約 0.000005 ETH，數值極小，但沒有它就送不出交易。
本頁為第 7 週課程附錄，配合教科書第五～七步使用 ｜ 版本：2026-10-29 ｜ 網路參數依 Base 官方文件（docs.base.org）與 MetaMask 官方說明整理；代幣合約之名稱、符號與小數位數已於 2026-10-29 直接向 Base Sepolia 鏈上查詢確認。