本阶段课程
  1. 钱包类型与资产控制权
  2. 私钥、助记词与账户恢复
  3. 签名、授权额度与撤销
  4. 连接钱包与账户切换
  5. SIWE 与后端登录会话
  6. MPC 钱包与阈值签名
  7. 账户抽象、ERC-4337 与 EIP-7702
  8. Passkey 与嵌入式钱包
  9. 多签、会话密钥与团队授权
  10. 移动钱包连接 · 二维码、唤起与恢复
  11. 钱包权限检查 · 从连接到撤回
  12. ENS 与名称解析 · 收款别名怎样变成地址
  13. 钱包批量调用 · 多步授权和执行如何组合
本篇目录

阶段 02 · 第 10 / 13 课

案例 · 切回浏览器,连接还没恢复

移动钱包连接 · 二维码、唤起与恢复

学完能做到:为手机浏览器和桌面扫码设计会话状态与恢复动作。

先看一个场景

用户用手机浏览器打开活动页,点击连接后跳到钱包。确认结束回到浏览器,页面仍显示等待连接。另一位用户在桌面扫码,手机钱包已切换账号。两条路径都需要恢复会话并核对账户。

接入步骤

  1. 桌面展示配对二维码,移动端提供钱包唤起或选择入口。保留手动回到原页面的提示。
  2. 用户批准连接后,从会话读取允许的账号、链和方法。切链或切号时刷新页面中的账户和数据。
  3. 浏览器恢复可见后重新读取现有会话和待处理请求。依据请求结果推进 UI 状态。
  4. 请求拒绝、配对过期和断连分别提供取消、重开二维码和重新连接。已批准的交易接着查回执。
故障 用户看到 验收
配对超时 二维码已过期 可生成新会话,旧返回不能覆盖
返回站点失败 等待钱包结果并提供回到页面文案 页面恢复后继续查询原请求
钱包切到另一个地址 新地址或重新连接提示 清理旧地址未完成表单和缓存

从扫码和跳转两条路读同一份状态

桌面用户在网页看到二维码,用手机钱包扫描。在手机批准后,正确的浏览器标签页应与原请求关联并显示连接结果。手机用户在同一设备点「连接」,浏览器暂时去了后台,回到前台以后才补读会话。两条路都要保持同一个请求标识。

请求 C-001     手机已批准,获准地址 B,网络为示例链
网页原状态    仍显示等待,缓存中有地址 A 的旧订单
恢复后的动作  从钱包读会话,确认 B;清理或隔离 A 的账号数据,再验证登录

含糊的「连接失败」不给用户下一步。可用「请切回原页面继续」「连接请求已过期,请打开新二维码」「钱包已切到另一个账户,请重新登录」分别说明现场情况。

动手练习

给桌面扫码、iPhone Safari 唤起、Android 切回浏览器各写一个用例,记录请求 ID、当前账号、网络和会话状态。加入「连续点击两次连接」的用例。

自测

用户回到浏览器能看到钱包地址,是否可以沿用上一位用户的订单 Session?

查看参考答案

连接只给出当前钱包授权的地址。后端访问订单仍需校验该地址对应的站点会话,账户切换后走重新验证或退出流程。

WalletConnect Network 文档

记录本课进度

完成练习后标记。进度保存在当前浏览器。

搜索课程