如何將自訂代幣添加到 Sui 錢包

了解自訂令牌集成

1. Sui錢包不會自動偵測或顯示Sui區塊鏈上部署的所有代幣。

2. 代幣必須使用其鏈上識別碼（稱為代幣類型的物件 ID）明確註冊在錢包的代幣清單中。

3. 幣類型遵循嚴格的格式： 0x[address]::[module]::[struct] ，其中每個段均源自 Move 包部署。

4. 使用者不能添加任意字串－僅接受 Sui 網路識別的有效、已部署和已驗證的幣種。

5. 未能匹配確切的大小寫、間距或模組路徑會導致在令牌新增過程中被拒絕。

手動新增的先決條件

1. 與活動帳戶完全同步的 Sui Wallet 擴充功能或行動應用程式。

2. 造訪代幣的官方文件或瀏覽器頁面，確認其代幣類型 ID 。

3. 確認代幣合約已發佈在主網或目標網路上，而不僅僅是開發網或測試網。

4. 使用者位址中至少一個令牌物件實例的所有權，透過sui client object CLI 指令進行驗證。

5. 了解代幣是否正確實現Coin介面 - 缺乏適當 Coin 特徵遵守的自訂結構不會出現在餘額中。

分步令牌註冊

1. 開啟 Sui Wallet 介面並導覽至「Tokens」標籤。

2. 點選或點選右上角的+ 新增令牌按鈕。

3. 選擇自訂令牌而不是搜尋預設清單。

4. 將完整的硬幣類型字串貼到輸入欄位中 - 不允許截斷或別名。

5.確認網路相容性；錢包將根據目前連接的網路（例如，主網與測試網）驗證類型。

6. 驗證成功後，將從鏈上元資料自動取得代幣符號、名稱和小數精確度。

7. 點選新增完成註冊並觸發餘額同步。

驗證和可見性問題

1. 新增後，檢查資產視圖 - 令牌可能需要長達 30 秒的時間才能反映節點是否處於負載狀態。

2. 如果令牌仍然不可見，請在 CLI 中使用sui client objects --address [your-address]驗證物件所有權。

3. 透過將物件 ID 貼到搜尋欄中並檢查套件結構，對照 Sui Explorer 交叉檢查硬幣類型。

4. 確保沒有尾部空格或不可見的 Unicode 字元與硬幣類型字串一起複製。

5. 停用任何干擾錢包注入或腳本執行的第三方瀏覽器擴充功能。

常見問題解答

Q：我可以在不擁有任何代幣的情況下添加代幣嗎？答：不需要。錢包需要至少一個擁有的硬幣物件實例來填充餘額資料。新增沒有所有權的代幣會導致餘額為零且沒有交易歷史。

Q：為什麼我的自訂令牌名稱顯示為「未知」？答：當鏈上包缺少元資料發佈或 Move 模組的CoinMetadata結構中的名稱和符號欄位為空時，就會發生這種情況。

Q：貼上來自不受信任來源的硬幣類型是否安全？答：並不是本質上不安全——硬幣類型本身是不可變的和公開的——但驗證其來源可以防止意外添加惡意命名的克隆或容易重入的變體。

Q：錢包版本更新後需要重新加入Token嗎？答：不會。代幣配置會本地儲存在加密錢包儲存中，並在更新後持續存在，除非手動清除或重置錢包資料。