如何使用 WalletConnect 將您的應用鏈接到 dApp？

了解 WalletConnect 協議

1. WalletConnect 是一種開源協議，可以在不暴露私鑰的情況下實現加密貨幣錢包和去中心化應用程序之間的安全通信。

2. 它通過中繼服務器運行，該服務器使用配對期間建立的對稱密鑰在 dApp 和錢包之間轉發加密的有效負載。

3. 配對過程生成一個二維碼或深層鏈接，其中包含會話提案以及鏈 ID、所需權限和應用程序信息等元數據。

4. 用戶使用手機錢包掃描二維碼或單擊深層鏈接，在受信任的客戶端界面上啟動連接批准。

5. 一旦獲得批准，就會建立持久的端到端加密會話，允許跨設備進行簽名交易和錢包交互。

集成 WalletConnect v2 SDK

1. 開發人員將 @walletconnect/modal 包與 @walletconnect/core 和 @walletconnect/sign-client 一起安裝，以與 EVM 和非 EVM 鏈完全兼容。

2. 必須從 WalletConnect Cloud 儀表板獲取項目 ID，並在客戶端初始化期間傳遞該 ID，以啟用分析和中繼路由。

3. 模式 UI 使用可選主題選項和支持的錢包進行初始化，無需自定義 UI 開發即可實現無縫用戶入門。

4. 會話命名空間配置為聲明所需的鏈、帳戶和方法，例如 eth_signTransaction 或 cosmos_signAmino。

5. 註冊 connect、disconnect 和 session_update 的事件偵聽器來處理狀態更改並相應地更新應用程序 UI。

實時處理錢包請求

1. 當 dApp 請求交易簽名時，它會構造一個請求對象，其中包含特定於鏈的參數，例如交易數據、gas 限制和接收者地址。

2. 使用 request() 方法通過活動會話發送請求，在連接的錢包界面內觸發提示。

3. 錢包返回帶有簽名交易的成功響應或拒絕錯誤，這兩者都必須由 dApp 邏輯妥善處理。

4. 對於批量操作，可以對多個請求進行排隊，但必須遵守中繼網絡施加的會話級速率限制和超時閾值。

5. 通過唯一 ID 跟踪待處理請求，並使用相同 ID 匹配響應，以防止並發錢包交互期間出現競爭情況。

安全注意事項和最佳實踐

1. 切勿在客戶端存儲會話密鑰；依賴 WalletConnect 的內置持久層或使用符合平台特定準則的安全存儲機制。

2. 根據已知的 dApp 來源驗證所有傳入會話提案，並執行嚴格的域白名單以減少網絡釣魚嘗試。

3. 拒絕請求過多權限的會話，例如訪問所有帳戶或不受限制的簽名功能，除非應用程序功能明確證明合理。

4. 對超過 120 秒的待處理請求實施超時處理，以避免錢包無響應時出現無限期掛起狀態。

5. 審核生產環境中使用的所有中繼端點，並首選自託管中繼，其中合規性要求要求對消息路由基礎設施進行完全控制。

常見問題解答

問：WalletConnect 可以與硬件錢包一起使用嗎？是的，包括 Ledger 和 Trezor 在內的多家硬件錢包提供商提供與 WalletConnect 兼容的應用程序，支持通過藍牙或 USB 接口建立會話和簽名。

問：如果中繼服務器掉線了怎麼辦？會話保持活動狀態，因為加密密鑰保存在本地；只有新的會話提案和通知需要中繼可用性。現有連接將繼續運行，直到手動終止。

問：WalletConnect 與 Solana dApp 兼容嗎？是的，WalletConnect v2 通過指定 solana:namespace 的命名空間配置以及相應的方法（如 solana_signTransaction 和 solana_signMessage）來支持 Solana。

問：用戶每次訪問 dApp 都需要重新配對嗎？不，如果保留本地存儲，會話在瀏覽器重新啟動後仍然存在。用戶可以隨時選擇手動斷開連接或通過錢包設置撤銷訪問權限。