如何使用 WalletConnect 桌面 DApp？ （二維碼掃描）

了解 WalletConnect 協議

1. WalletConnect 是一種開源協議，可實現桌面去中心化應用程式和行動加密錢包之間的安全通訊。

2. 它透過端對端加密進行操作，確保私鑰在會話發起或交易簽章期間永遠不會離開使用者的裝置。

3. 此協定使用中繼伺服器在 dApp 和錢包之間轉送加密的有效負載，而無需存取訊息內容。

4. 桌面 dApp 產生一個唯一的配對 URI，其中包含臨時主題和橋接 URL，作為握手基礎。

5. 會話建立需要相互批准：dApp 請求連接，錢包必須明確確認才能進行任何互動。

在桌面上產生二維碼

1. 啟動桌面 dApp 時，使用者點擊「連接錢包」並選擇 WalletConnect 作為首選方法。

2. 應用程式使用 WalletConnect v2.0 會話提案格式、嵌入項目 ID、所需鍊和元資料呈現動態產生的 QR 碼。

3. 此 QR 碼編碼格式為​​ wc:// 或 wc: 的深層鏈接，後面跟著 Base64 編碼的會話參數和版本標識符。

4. 某些 dApp 會顯示後備文字（例如 12 個單字的短語或字母數字代碼），以便在掃描失敗時手動輸入。

5. 二維碼有效期限約三分鐘；刷新時過期會觸發自動再生。

使用手機錢包掃描

1. 使用者開啟 MetaMask Mobile、Trust Wallet 或 Rainbow 等相容錢包，然後導覽至 WalletConnect 掃描器介面。

2. 攝影機啟動並偵測 QR 碼，將其有效負載解析為結構化會話請求物件。

3. 錢包顯示 dApp 名稱、請求的權限、支援的網路以及從 dApp 元資料端點取得的圖示。

4. 用戶批准後，錢包透過中繼發回確認有效負載，建立持久的 WebSocket 通道。

5. 連線後，錢包會顯示活動會話徽章，允許交易或登入訊息的簽署請求。

會話管理和安全注意事項

1. 每個活動的 WalletConnect 會話都分配有一個唯一的主題哈希，該哈希在錢包的連接清單中與上次使用的時間戳一起可見。

2. 使用者可以在錢包應用程式中手動終止會話，立即切斷來自該 dApp 的所有待處理和未來的 RPC 呼叫。

3. 桌面 dApp 無法發起任意呼叫－權限範圍僅限於配對期間宣告的方法，例如 eth_sendTransaction 或 individual_sign。

4. 如果 dApp 嘗試未經授權的 RPC 方法，錢包會拒絕該調用並在本地記錄該調用，而不向中繼廣播錯誤詳細資訊。

5. 中繼伺服器不會儲存超出訊息傳遞的會話有效負載；有效負載使用傳輸後丟棄的暫存密鑰進行加密。

常見問題解答

Q：我可以在桌面上將 WalletConnect 與硬體錢包一起使用嗎？是的——Ledger Live 和 Trezor Suite 原生支援 WalletConnect v2.0。它們充當中介，透過 USB 或藍牙將簽名請求從桌面 dApp 轉發到實體設備。

Q：為什麼我掃描了二維碼，錢包卻顯示「Unknown dApp」？當 dApp 未能在其會話提案中包含有效的元資料（名稱、描述、圖示）時，就會發生這種情況。當元資料欄位遺失或格式錯誤時，錢包預設使用通用標籤。

Q：從不受信任的網站掃描 WalletConnect 二維碼安全嗎？不會。掃描會啟動加密握手，授予 dApp 對您錢包的有限存取權限。在連接之前，請務必驗證網域的真實性並檢查 dApp 的原始程式碼或審核報告。

Q：如果我在 WalletConnect 會話處於活動狀態時關閉桌面瀏覽器，會發生什麼事？會話在錢包端保持開啟狀態，直到手動斷開連接或逾時。一旦瀏覽器標籤關閉，dApp 就會失去發送新請求的能力，但不會保留對錢包的控制權。