如何將 Tonkeeper 連接到 TON dApp

錢包準備和網路驗證

1. 從 tonkeeper.com 或經過驗證的 iOS、Android 或桌面平台應用程式商店安裝官方 Tonkeeper 應用程式。

2. 啟動 Tonkeeper 並確認它正在 TON 主網上運行——通過檢查頂部欄中的網絡指示器來驗證這一點；如果顯示“Testnet”，請訪問“設置”，點擊 Tonkeeper 徽標五次以打開“開發人員菜單”，然後切換到主網。

3. 確保錢包至少包含 0.1 TON 來支付大多數 dApp 所需的初始交易費用和合約部署成本。

4. 將 24 字恢復短語備份到安全的離線位置 — 此步驟是不可逆的，並且在任何鏈上交互之前都是強制性的。

5. 確認沒有第三方擴充或疊加層幹擾錢包的 UI 渲染或簽章提示。

透過 dApp 介面啟動連接

1. 使用支援的瀏覽器（例如​​啟用了 JavaScript 的 Chrome、Edge 或 Safari）導覽至基於 TON 的目標 dApp。

2. 找到並點擊「連接錢包」按鈕－通常位於 dApp 介面的右上角。

3. 在顯示的錢包清單中選擇「Tonkeeper」；除非 dApp 連線流程明確指示，否則避免掃描 QR 碼。

4. Tonkeeper 內將出現一個彈出模式，請求許可共享您的公共地址並簽署會話請求 - 點擊“批准”。

5. dApp將顯示您連接的位址，並可能觸發自動餘額同步；不會傳輸任何私密金鑰或助記詞。

地址格式和相容性處理

1. Tonkeeper 預設產生可退回格式的位址（例如EQB4c1b2ede12aa76f4a44353944258bcc8f99e9c7c474711a152c78b43218e296 ），支援自動糾錯，是使用者互動的首選使用者。

2. 某些 dApp 需要不可退回的位址來進行智慧合約呼叫－Tonkeeper 在「帳戶資訊」>「複製位址」> 切換選項下提供了兩種變體。

3. 驗證 dApp 是否正確解析工作鏈 ID（0 表示基礎鏈）和帳號 ID 元件；不符的工作鏈處理會導致靜默連線失敗。

4. 如果 dApp 使用 TonConnect 協定 v2，請確保 Tonkeeper 版本≥4.12.0——舊版本缺乏對多重簽名會話握手的支援。

5. 不要手動編輯或截斷位址字串－校驗和和前綴編碼以加密方式綁定到底層公鑰。

簽名和交易授權流程

1. 當發起交易或資料簽章請求時，dApp 會傳送包含方法名稱、參數和過期時間戳記的結構化負載。

2. Tonkeeper 顯示本機確認螢幕，顯示確切的操作類型（ sendMessage或signData ）、目標位址、金額和附加備忘錄。

3. 使用者必須明確批准每個操作－設計上不允許大量批准或自動簽名策略。

4. 獲得批准後，Tonkeeper 在規範化有效負載上計算 Ed25519 簽名，並將其與簽署的訊息哈希一起返回 dApp。

5. 失敗的簽章總是會導致區塊鏈層級立即拒絕；不會發生部分或回退執行。

常見連線故障故障排除

1. 如果錢包未能出現在連接器清單中，請清除瀏覽器快取並停用廣告攔截器或過濾 WebSocket 或註入腳本的隱私擴充。

2. 持續存在的「無效會話」錯誤表示 TonConnect 配對已過期 - 透過點擊 dApp 中的「斷開錢包」來重新連接，然後重新啟動連接。

3. 空白或凍結的確認模式通常源自於過時的 Tonkeeper 版本 - 透過官方應用程式商店或 tonkeeper.com/download 進行更新。

4. dApp 顯示與 Tonkeeper 的「帳戶資訊」之間的位址不符表示網路上下文不正確 - 仔細檢查 dApp 後端和錢包是否在相同的 TON 網路端點上運行。

5. 簽章請求期間重複出現逾時訊息表示本機網路不穩定或 ISP 等級 WebSocket 阻塞 - 切換到行動資料或在 Tonkeeper 設定中啟用 Tor 模式。

常見問題解答

Q：我可以將 Tonkeeper 同時連接到多個 dApp 而無需重新批准嗎？答：是的－Tonkeeper 維護每個 dApp 網域的持久會話金鑰；每個新來源都需要一次性配對，但後續互動將跳過重新驗證，除非手動撤銷。

Q：連接到 dApp 是否會授予其存取我的交易記錄或餘額詳細資訊的權限？答：不，僅共享公共地址；所有餘額和歷史查詢都必須透過由用戶同意和明確 RPC 呼叫控制的 TON API 端點執行。

Q：為什麼有些 dApp 即使選擇了 Tonkeeper，仍顯示「不支援的錢包」？答：當 dApp 強制執行與 Tonkeeper 當前適配器層不相容的舊版 TonConnect v1 或自訂 RPC 包裝器時，就會發生這種情況 - 請檢查 dApp 文件以了解支援的最低 SDK 版本。

Q：將 Tonkeeper 連線到非 HTTPS 網域上託管的 dApp 是否安全？答：否 — Tonkeeper 完全封鎖與 HTTP 來源的連線；僅允許具有有效憑證的 TLS 安全性網域啟動錢包會話。