開發適配
開發者中心
從錢包連接、網路切換到交易與簽名提示，開發者應讓使用者清楚知道每次互動的目的、範圍與可能結果。
錢包連接與網路處理
DApp 應在請求連接前說明用途，不應在頁面載入後反覆彈出連接要求。取得公開地址後，應處理帳戶切換、網路切換與連線中斷等狀態，避免把錯誤資訊誤判為已完成交易。
- 清楚說明連接目的
- 支援帳戶與網路狀態變更
- 對錯誤與取消提供可理解提示
- 不要求使用者提交助記詞或私鑰
交易、簽名與授權提示
交易請求應顯示目標地址、資產、數量、網路與主要合約用途。訊息簽名應讓使用者閱讀完整內容，並避免使用難以理解或與實際用途不符的文字。代幣授權應採取符合需求的額度，不以無限授權作為唯一選項。
| 互動 | 介面應說明 | 安全建議 |
|---|---|---|
| 連接錢包 | 用途、帳戶與網路 | 允許使用者取消或切換 |
| 訊息簽名 | 完整訊息與有效範圍 | 避免模糊或誘導性文字 |
| 交易請求 | 接收方、數量、合約與費用 | 送出前提供再次確認 |
| 代幣授權 | 資產、合約與授權額度 | 提供合理額度與清理方式 |
適配測試與支援範圍
上線前應在支援網路中測試連接、切換、簽名、交易失敗、使用者取消與節點延遲等情境。TokenPocket 提供實際範圍內的適配方向與問題溝通，不描述不存在的 API、SDK 或保證性能力。
- 準備測試環境
確認網路、合約與測試資產。 - 覆蓋主要流程
測試連接、切換、簽名與交易。 - 處理異常狀態
驗證取消、失敗、逾時與重試。 - 提交問題資訊
提供可重現步驟、網路與交易雜湊。
以使用者可理解為原則
任何權限、簽名或交易提示都應清楚、具體且與實際行為一致。