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

阶段 02 · 第 4 / 13 课

Connect Wallet:从连接账户到确认交易

学习目标:分清连接、登录、代币授权和交易签名,建立完整的钱包状态管理。

建议先读:钱包开发分类。示例采用 EVM 的 EIP-1193 Provider 接口。

先看一个场景

用户连接后在钱包切到另一个地址。页面若继续用旧账号查余额或提交订单,会显示错误的资产与权限。

读完试一试

为账户变化、网络变化、断开与拒绝连接分别定义界面状态。


第一次点连接,会看到什么

打开一家演示商店,页面还不知道你是哪一个地址。点「连接钱包」后,钱包让你挑选愿意公开给这个站点的账号。批准后,页面显示地址 A。此时商店不一定已经为你建立登录会话,你也尚未购买任何东西。

随后店铺可能要求签一条登录消息,让服务器确认你控制 A。真正结账前核对金额、网络与接收方,之后再按钱包提示签交易或完成代币授权。如果中途切到地址 B,原页面虽然能显示 B,A 的订单仍需跟随 A 的会话权限。看不懂弹窗时,回到签名和授权对照它要求批准哪一种动作。

1. Connect Wallet 不是一个唯一的库

“Connect Wallet”通常是连接钱包的产品动作或按钮名称。项目可以使用连接组件、连接器、钱包 SDK 或标准 Provider 来实现;不能仅凭这个名字确定安装哪个包。

MetaMask 等是钱包产品;WalletConnect 是连接通信生态与协议;EIP-1193 定义以太坊 Provider 的请求和事件接口。它们处在不同层级。

2. 四种动作必须分开

动作 得到什么 不代表什么
连接账户 获准读取钱包暴露的地址 不代表登录了后端
签名登录 后端验证用户控制指定地址 不代表可以转走代币
代币授权 spender 获得指定额度的使用权限 不代表兑换已经执行
签名并发送交易 请求一次链上状态变更 不代表已成功确认

签名也可能授权后续资产操作,例如某些 permit 或订单签名。不能把“没有立即消耗 Gas”解释为“签名没有资金影响”。

3. 最小连接示例

下面是浏览器 JavaScript 函数,不依赖 React;provider 由应用的钱包发现或连接器层传入。现代多插件环境可使用 EIP-6963 发现多个 Provider,不应默认只有一个 window.ethereum。

export async function connectWallet(provider, expectedChainId) {
  if (!provider || typeof provider.request !== "function") {
    throw new Error("请选择可用的钱包");
  }
  const accounts = await provider.request({ method: "eth_requestAccounts" });
  const chainId = await provider.request({ method: "eth_chainId" });
  if (!Array.isArray(accounts) || !accounts[0]) {
    throw new Error("钱包没有返回可用账户");
  }
  return {
    account: accounts[0],
    chainId,
    // 例如 0x1 表示 Ethereum 主网;由应用显式传入目标网络。
    wrongNetwork: BigInt(chainId) !== BigInt(expectedChainId),
  };
}

由用户点击触发权限请求,并在等待期间禁用重复连接按钮。示例只返回连接结果;真正发送交易前仍应重新核对账户和网络。

4. 状态机比一个布尔值更可靠

stateDiagram-v2
    [*] --> disconnected
    disconnected --> connecting: 用户点击
    connecting --> connected: 成功
    connecting --> disconnected: 拒绝或失败
    connected --> wrongNetwork: 网络不匹配
    wrongNetwork --> connected: 切回支持网络
    connected --> disconnected: 账户为空或会话结束

应用应订阅 accountsChanged 和 chainChanged,组件卸载时移除监听。账户改变后要失效化旧余额、授权缓存、后端会话和未提交操作,防止把 A 账户的状态用于 B 账户。

刷新页面时可用 eth_accounts 查询已有授权状态;不宜在加载时自动反复触发权限弹窗。disconnect 事件描述 Provider 连接状态,也不等于用户撤销了所有站点权限。

5. 错误处理与网络切换

情况 常见含义 界面动作
4001 用户拒绝请求 恢复可操作状态,不无限重试
-32002 某些钱包已有待处理请求 提示查看钱包窗口
网络不匹配 当前链不是业务目标链 显示链名称,提供切换入口
钱包不认识网络 需要添加网络或改用支持网络 校验网络配置后再请求
移动端跳转后无响应 会话或深链可能中断 查询会话状态,允许重连

具体错误码还要依据钱包文档。切换可使用钱包支持的 wallet_switchEthereumChain;添加链参数必须来自可信配置,不直接接受 URL 中传入的任意 RPC。

6. 登录与交易的后续流程

签名登录应包含域名、地址、链、一次性 nonce、签发与过期时间等,并由后端验证、消费 nonce。不能仅把前端传来的地址当作登录凭证。

交易流程应展示“等待签名 → 已提交 → 等待确认 → 成功或失败”,保存交易哈希,处理取消、替换和超时。断开应用连接不会自动撤销 allowance,也不会取消已广播交易。

7. 自测与参考答案

问题:用户切换账户后,界面仍显示旧账户余额,可以只改地址文案吗?

答案:不可以。应清理或按 (chainId, account) 重新获取相关状态,并检查后端认证是否仍匹配。

练习:分别验证拒签、重复点击、切链、切账户、刷新恢复和移动端返回六种行为,记录按钮状态与缓存变化。

8. 延伸阅读


← 返回学习导航 · 回到顶部

记录本课进度

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

搜索课程