如何使用 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. 中继服务器不存储超出消息传递的会话有效负载；有效负载使用传输后丢弃的临时密钥进行加密。

常见问题解答

问：我可以在桌面上将 WalletConnect 与硬件钱包一起使用吗？是的——Ledger Live 和 Trezor Suite 原生支持 WalletConnect v2.0。它们充当中介，通过 USB 或蓝牙将签名请求从桌面 dApp 转发到物理设备。

问：为什么我扫描了二维码，钱包却显示“Unknown dApp”？当 dApp 未能在其会话提案中包含有效的元数据（名称、描述、图标）时，就会发生这种情况。当元数据字段丢失或格式错误时，钱包默认使用通用标签。

问：从不受信任的网站扫描 WalletConnect 二维码安全吗？不会。扫描会启动加密握手，授予 dApp 对您钱包的有限访问权限。在连接之前，请务必验证域的真实性并检查 dApp 的源代码或审核报告。

问：如果我在 WalletConnect 会话处于活动状态时关闭桌面浏览器，会发生什么情况？会话在钱包端保持打开状态，直到手动断开连接或超时。一旦浏览器选项卡关闭，dApp 就会失去发送新请求的能力，但不会保留对钱包的控制权。