如何使用 WalletConnect 将我的移动钱包链接到桌面 dApp？

了解 WalletConnect 协议

1. WalletConnect 是一种开源协议，可实现不同设备上的去中心化应用程序和加密货币钱包之间的安全通信。

2. 它使用端到端加密通过桥接服务器中继消息，而不会暴露私钥或敏感用户数据。

3. 该协议通过会话 URI 运行——对连接参数和元数据进行编码的加密签名字符串。

4. 桌面 dApp 生成包含会话 URI 的二维码，移动钱包扫描该二维码以启动配对。

5. 扫描后，移动钱包会验证 dApp 的身份并提示用户批准，然后再建立持久的加密会话。

桌面到移动链接的先决条件

1. 兼容的桌面浏览器，例如安装了 MetaMask 或其他支持 Web3 的扩展的 Chrome、Brave 或 Firefox。

2. 支持 WalletConnect v2.x 的移动钱包 — 示例包括 Trust Wallet、Rainbow、Phantom 和 Coinbase Wallet。

3. 两台设备必须具有稳定的互联网连接，才能通过 WalletConnect 中继网络同步会话请求和响应。

4. 移动钱包必须在其设置中启用 WalletConnect 功能，通常可以在“DApp 浏览器”或“WalletConnect”切换选项下找到。

5. 确保没有广告拦截器或隐私扩展程序干扰 dApp 端 WalletConnect SDK 使用的 WebSocket 连接。

分步连接工作流程

1. 使用桌面浏览器导航到目标 dApp，然后找到钱包连接按钮 - 通常标记为“Connect Wallet”或“WalletConnect”。

2. 从可用连接器中选择 WalletConnect 选项；这会触发屏幕上生成二维码。

3. 打开您的移动钱包应用程序并访问其内置的 WalletConnect 扫描仪 - 通常可通过 + 图标、QR 选项卡或专用的“扫描 QR”菜单项进行访问。

4. 将手机摄像头对准桌面屏幕上显示的二维码；移动钱包解码会话 URI 并显示 dApp 的名称、URL 和请求的权限。

5. 在您的移动设备上确认连接请求；获得批准后，桌面 dApp 会收到会话确认并获得帐户地址的只读访问权限和交易签名功能。

管理活动会话

1. 每个已建立的 WalletConnect 会话都会显示在您的移动钱包中的“活动会话”下，列出 dApp 域、连接的链和上次活动时间戳。

2. 您可以从移动钱包界面远程终止任何会话，立即切断与 dApp 的所有进一步交互。

3. 会话持久性取决于客户端超时和中继服务器行为 - 会话可能会在长时间不活动或任一端点突然断开连接后过期。

4. 一些钱包允许重命名会话以便于识别，特别是在跨 EVM 兼容链（如以太坊、Polygon 或 Arbitrum）连接多个 dApp 时。

5. 重新连接不需要重新扫描——如果会话仍然有效，dApp 可以在页面重新加载时自动恢复通信。

常见问题解答

问：我可以将 WalletConnect 与 Ledger 或 Trezor 等硬件钱包一起使用吗？是的 - 前提是硬件钱包与支持 WalletConnect 的移动或桌面钱包应用程序配对，例如 Ledger Live 或 Trust Wallet。硬件设备本身并不直接连接，而是作为签名后端。

问：为什么我的手机钱包扫描后显示“连接失败”？这种情况通常是由于链 ID 不匹配、会话 URI 过期或网络限制阻止访问 WalletConnect 中继（例如 wss://relay.walletconnect.com）而发生。验证两台设备上的时间同步并检查防火墙设置。

问：使用 WalletConnect 连接到未知的 dApp 是否安全？否 — WalletConnect 仅确保传输安全；它不验证 dApp 的合法性。在批准权限或签署交易之前，请务必验证合约地址、审计报告和社区声誉。

问：我可以同时将多个移动钱包连接到同一个桌面 dApp 吗？是 - WalletConnect 支持多个并发会话。每个会话都是由唯一的主题标识符隔离和标识的。然而，大多数 dApp 只显示一个活跃账户，除非明确编码来处理多钱包上下文。