Web3 钱包跨端通信协议之WalletConnect

3 阅读2分钟

WalletConnect 是 Web3 跨端通信的标准协议,核心作用是让移动端钱包 ↔ 桌面 / 网页 DApp 能安全通信,私钥永不离设备,目前 v2 是主流,支持多链与去中心化中继。

官网

一、介绍

WalletConnect 是开源、去中心化、链无关的通信协议,为 DApp 与钱包提供端到端加密的跨设备连接通道,私钥全程离线,仅在钱包本地签名。

网页 DApp ↔ 手机钱包建立加密安全连接

特点

  • 跨端隔离:手机钱包(如 Trust Wallet)连桌面 DApp(如 Uniswap)
  • 私钥安全:私钥永不导出,避免 DApp / 中继窃取
  • 多链统一:一套协议兼容 Ethereum、Solana、Cosmos 等170 + 链
  • 生态标准:连接700 + 钱包、8.5 万 + DApp

适用场景

  1. 手机冷钱包、硬件钱包连接网页
  2. 移动端 DApp 跳转钱包签名
  3. 桌面端连接移动端钱包

重点区分

  • EIP-6963/EIP-1193:只负责浏览器内置插件钱包(MetaMask、小狐狸)
  • WalletConnect:专门负责移动端外置钱包(imToken、TP、OK 钱包、TrustWallet)

二、V1 vs V2

维度v1(2018)v2(2022+,主流)
架构中心化中继(单点故障)去中心化 Waku 网络(高可用)
多链单会话单链,需重连单会话多链(EVM + 非 EVM)
会话临时短连接,易掉线持久化会话(7 天),自动重连
配对每次连接必扫二维码一次配对,多次会话(复用配对)
权限模糊授权Namespace 精细化权限控制
性能延迟高、稳定性差低延迟、高并发,支持大规模 DApp

实战

其他钱包协议

1. Browser Extension 浏览器插件协议

  • EIP-1193旧版注入钱包标准,单钱包独占 window.ethereum,容易冲突报错
  • EIP-6963最新官方标准,多钱包共存发现协议,现在 Web3 前端必学,解决 - 32002 重复授权报错

所有桌面钱包插件不走 WalletConnect,直接和插件通信

2. WalletConnect v2 协议

端到端加密 + 去中心化中继的跨设备通信协议。

  • 手机钱包(小狐狸移动端、TP、OKX、imToken)
  • 跨端扫码 / 跳转连接这是 RainbowKit 最常用的移动钱包通道

3. Coinbase SDK 协议

Coinbase Wallet 专用原生 SDK,Coinbase 自己的连接方案,不走注入、不走 WalletConnect。

  • 专门用于 Coinbase 钱包跳转、授权