TokenPocket WalletConnect使用详解：扫码连接、多链会话与故障排查

WalletConnect 是链上世界事实上的「钱包-DApp 互联」标准，TokenPocket 对其支持完善。通过 WalletConnect，你可以在 PC 上打开 DApp，用手机端钱包扫码完成签名，兼顾大屏体验与移动端的私钥安全。本文围绕 TokenPocket 中的 WalletConnect 使用，覆盖原理、连接与故障排查。

一、WalletConnect 原理与优势

WalletConnect 通过一个中继服务器在 DApp 与钱包之间建立加密信道，钱包用一个本地密钥包负责签名，所有签名结果都经过端到端加密。中继服务器无法读取签名内容，私钥始终留在钱包端。

最大优势在于「私钥分离」。即便 DApp 网页运行在一个不那么可信的浏览器中，签名权仍然属于你的手机端钱包。这与 币安 等中心化交易所的网页登录截然不同——后者一旦 cookie 被盗即可发起操作；WalletConnect 中再多的会话被盗，对手也无法签名。

二、扫码连接流程

第一步：在 PC 端 DApp 页面点击「Connect Wallet」，选择 WalletConnect，得到一个二维码。第二步：在手机上打开 TokenPocket，点击右上角扫一扫，对准二维码。第三步：钱包弹出连接请求，确认 DApp 域名、链、账户后授权连接。

注意：每个二维码都有有效期，过期需要刷新。授权连接前请仔细核对域名拼写，避免连接到伪造网站。和在 OKX 上做 PC 与移动端联动时一样，扫码这一步是「最后人工核对的机会」，必须当真。

三、多链会话与切换

WalletConnect v2 支持多链会话，一次连接可以授权多条链。TokenPocket 在连接请求页面会显示 DApp 期望的所有链，用户可以勾选授权。建议只授权你当前真正会用到的链，把不需要的链取消，缩小授权面。

会话建立后，DApp 中切换链会自动通过 WalletConnect 同步到 TokenPocket；钱包端也可以单方面切换账户，DApp 会收到地址变化事件。如果你日常在 必安 与 EVM 链之间倒资金，WalletConnect 让你在 PC 端的 Swap/桥操作完全脱离手抄地址的麻烦。

四、桌面端用法

除了「PC DApp + 手机钱包」组合，WalletConnect 也支持「桌面 DApp + 桌面 TokenPocket 插件」与「移动 DApp + 桌面钱包」等。所有组合的核心仍然是「钱包负责签名、DApp 负责发起」。

在桌面端建议把 TokenPocket 安装在专门的 Chrome Profile，与日常浏览隔离。所有签名请求只在该 Profile 内出现，便于辨识异常。和 OKX交易所 的 PC 客户端类似，专用 Profile 是一种简单有效的「环境隔离」。

五、故障排查

第一类，二维码扫不上：通常是中继服务器响应慢。刷新二维码后重试，或切换网络（4G 与 Wi-Fi 之间切换）。第二类，连接成功但无法签名：先检查会话是否仍然有效，长时间不操作的会话会被自动断开，重新发起即可。第三类，签名页面卡住：很可能是 Gas 估算超时，重新输入 Gas 后再次确认。

第四类，提示「不支持的链」：DApp 默认链与你勾选的链不一致，先在 DApp 页面切换链，再发起签名。第五类，session 过多：每次 DApp 关闭后建议主动断开 session，避免一个钱包同时挂着几十个不再使用的会话，减少潜在攻击面。

六、安全要点

第一，对长期挂着的会话定期清理。第二，对超出预期范围的签名请求一律拒绝，并立即检查 DApp 是否仍然可信。第三，关注 WalletConnect 协议本身的安全公告，重要更新即时升级。第四，对高价值操作建议改用硬件钱包签名，把 WalletConnect 作为「便捷通道」而非「主力签名渠道」。

按本文流程使用，TokenPocket 与 WalletConnect 的组合就是「大屏看清、私钥不动」的代表方案。它让链上交互既舒服又安全，是多链用户值得长期投入的工作流。