罗罗编程学习记录 全栈面试题库
本页导航 展开查看

15.6.1 钱包连接与签名登录

所属:全栈开发面试题库 / [15 Web3 与区块链((../index.md) / [15.6 DApp 全栈与钱包((index.md)

本节要解决的问题

面试里讲"钱包连接",多数人只会说"用 MetaMask 连一下"。真正的分水岭是:能不能讲清 EIP-1193 的 API 结构、SIWE 登录的完整流程与防重放机制、以及多链切换的常见坑。本节解决四个具体问题:一是把 EIP-1193 从"window.ethereum"拆成"provider API + 事件订阅 + 错误处理"的完整模型;二是讲清 SIWE(Sign-In with Ethereum)的完整流程——前端构造签名消息、钱包签名、后端验证签名、签发会话 JWT;三是把防重放机制(nonce、chainId、expiration)讲透,知道为什么签名会被钓鱼网站复用;四是落到多链切换——wallet_switchEthereumChain 与 wallet_addEthereumChain 的差异,以及前端怎么处理用户切换网络。

学习目标

学完本节,你应当能够:

  • 描述 EIP-1193 的核心 API 与事件。
  • 画出 SIWE 登录的完整调用链(前端 → 钱包 → 后端 → 会话)。
  • 解释 SIWE 防重放的三个要素(nonce、chainId、expiration)。
  • 处理多链切换的常见错误(用户拒绝、链未添加)。

先修与前置

  • 建议先读 [15.1.2 哈希、签名、地址与密钥管理((../../15.1-区块链基础与密码学/15.1.2-哈希签名与地址与密钥管理.md),理解 ECDSA 签名基础。
  • 本节是 [15.6.3 交易发送与用户体验((15.6.3-交易发送与用户体验.md) 的前置,先掌握钱包连接再学交易发送。

知识地图

钱包连接调用链
  DApp 前端 → window.ethereum (EIP-1193)
              ├─ eth_requestAccounts() → 获取用户地址
              ├─ eth_chainId() → 获取当前链
              ├─ wallet_switchEthereumChain() → 切换链
              └─ personal_sign() → 签名消息

SIWE 登录流程
  1. 前端请求后端 nonce
  2. 前端构造 SIWE 消息(domain、address、chainId、nonce、expiration)
  3. 钱包签名 personal_sign
  4. 前端把签名 + 消息发给后端
  5. 后端验证签名(ecrecover)
  6. 后端签发会话 JWT

核心术语

  • EIP-1193:以太坊钱包 provider 标准 API,定义 window.ethereum 的方法与事件。
  • SIWE(Sign-In with Ethereum):用以太坊签名做登录的标准,EIP-4361。
  • personal_sign:钱包签名任意消息的方法,用户看到签名内容。
  • EIP-712:结构化签名,用户看到类型化数据(如"登录到 example.com")。
  • nonce:一次性随机数,防重放。
  • chainId:链标识(如 Ethereum Mainnet = 1、Goerli = 5)。
  • wallet_switchEthereumChain:切换到已添加的链。
  • wallet_addEthereumChain:添加新链到钱包。

覆盖范围

  • EIP-1193 的核心 API 与事件
  • SIWE 登录的完整流程与防重放机制
  • personal_sign 与 EIP-712 的差异
  • 多链切换的常见错误处理
  • wagmi/viem 与 ethers.js 的关系
  • 钱包连接状态管理(connect/disconnect/chainChanged/accountsChanged)

高频题速览

编号 题目 难度 频率
15.6.1-001 EIP-1193 是什么?window.ethereum 提供什么 API? 基础 ★★★★★
15.6.1-002 SIWE(Sign-In with Ethereum)登录流程是什么? 基础 ★★★★★
15.6.1-003 personal_sign 与 EIP-712 签名的区别? 基础 ★★★★
15.6.1-004 SIWE 防重放怎么做?nonce、chainId、expiration 各起什么作用? 进阶 ★★★★★
15.6.1-005 多链切换时 wallet_switchEthereumChain 与 wallet_addEthereumChain 的坑? 进阶 ★★★★
15.6.1-006 wagmi/viem 与 ethers.js 的关系?为什么要切到 viem? 进阶 ★★★
15.6.1-007 钱包连接断开/chainChanged/accountsChanged 怎么处理? 进阶 ★★★
15.6.1-008 签名被钓鱼网站复用的攻击面有哪些? 高级 ★★★
15.6.1-009 多签钱包(Safe)作为登录身份时,SIWE 有什么不同? 高级 ★★★
15.6.1-010 设计一个登录态会话:签名 → 后端签发 JWT,需要考虑什么? 高级 ★★★★

15.6.1-001 EIP-1193 是什么?window.ethereum 提供什么 API?

一句话结论

EIP-1193 是以太坊钱包 provider 标准 API,定义 window.ethereum 对象提供的方法与事件。它让 DApp 可以统一调用不同钱包(MetaMask、Coinbase Wallet、WalletConnect)的接口,无需为每个钱包单独适配。

概念解释

  • window.ethereum:钱包注入的 provider 对象,DApp 通过它与钱包通信。
  • 核心方法:eth_requestAccounts()(获取地址)、eth_chainId()(获取链)、personal_sign()(签名)。
  • 事件:accountsChanged(地址变化)、chainChanged(链变化)、disconnect(断开)。
  • 钱包差异:不同钱包实现 EIP-1193 的方式不同,但核心 API 一致。

原理流程

  1. 用户安装 MetaMask,访问 DApp。
  2. DApp 检查 window.ethereum 是否存在。
  3. DApp 调用 window.ethereum.request({ method: 'eth_requestAccounts' })。
  4. MetaMask 弹窗请求用户授权,用户同意后返回地址。
  5. DApp 监听 accountsChanged 事件,处理用户切换账户。

代码或图示

// 检查钱包是否存在
if (typeof window.ethereum !== 'undefined') {
  console.log('MetaMask is installed!');
}

// 请求连接
const accounts = await window.ethereum.request({
  method: 'eth_requestAccounts'
});
console.log('Connected account:', accounts[0();

// 获取当前链
const chainId = await window.ethereum.request({ method: 'eth_chainId' });
console.log('Chain ID:', chainId);

// 监听事件
window.ethereum.on('accountsChanged', (accounts) => {
  console.log('Account changed:', accounts[0();
});
window.ethereum.on('chainChanged', (chainId) => {
  console.log('Chain changed:', chainId);
});

常见误区

  • 误区:window.ethereum 只有 MetaMask 有;正解:所有 EIP-1193 钱包都注入(Coinbase Wallet、Brave Wallet 等)。
  • 误区:eth_requestAccounts 自动连接;正解:它需要用户在弹窗里授权。
  • 误区:EIP-1193 是最新标准;正解:它在 2020 年就发布,是行业标准。

追问

  • EIP-1193 解决了什么问题?答:统一了不同钱包的接口。机制上早期每个钱包有自己的 API(如 MetaMask、Coinbase Wallet),DApp 要适配多个钱包。EIP-1193 定义了统一接口,DApp 只需适配一次。边界在于:有些钱包有自定义扩展(如 WalletConnect),需要额外处理。延伸:wagmi/viem 封装了 EIP-1193,让前端开发更简单。
  • 怎么处理多个钱包?答:用 window.ethereum.providers 数组(多钱包共存时)。机制上如果用户安装了多个钱包,window.ethereum 可能被覆盖,需要用 providers 数组找到目标钱包。边界在于:这个情况比较复杂,很多项目用 Web3Modal 等库处理。延伸:很多项目用 WalletConnect 统一处理移动端钱包。
  • EIP-1193 的错误处理?答:返回 { code, message } 错误对象。机制上用户拒绝授权返回 4001 错误,链未添加返回 4902 错误。边界在于:不同钱包的错误码可能略有差异。延伸:很多项目用 wagmi 封装错误处理。

15.6.1-002 SIWE(Sign-In with Ethereum)登录流程是什么?

一句话结论

SIWE 登录流程:前端请求后端 nonce → 前端构造 SIWE 消息(domain、address、chainId、nonce、expiration)→ 钱包签名 personal_sign → 前端把签名 + 消息发给后端 → 后端验证签名(ecrecover)→ 后端签发会话 JWT。

概念解释

  • SIWE:EIP-4361,用以太坊签名做登录的标准。
  • 流程:前端构造消息、钱包签名、后端验证。
  • 会话:后端签发 JWT,前端后续请求带 JWT。
  • 安全:防重放(nonce 一次性)、防钓鱼(domain 绑定)。

原理流程

  1. 用户访问 DApp,前端调用 GET /api/nonce 从后端获取随机 nonce。
  2. 前端构造 SIWE 消息:
    example.com 想让你登录:
    0x1234...5678
    Chain ID: 1
    Nonce: abc123
    Expiration: 2026-11-22T12:00:00Z
    
  3. 用户用钱包签名 personal_sign(message, address)。
  4. 前端把签名 + 消息发给后端 POST /api/login。
  5. 后端验证签名:ecrecover(message, signature) == address。
  6. 后端检查 nonce 是否用过、expiration 是否过期、chainId 是否匹配。
  7. 后端签发 JWT,返回给前端。

代码或图示

// 前端
const nonce = await fetch('/api/nonce').then(r => r.text());
const message = `example.com 想让你登录:
${address}
Chain ID: 1
Nonce: ${nonce}
Expiration: 2026-11-22T12:00:00Z`;
const signature = await window.ethereum.request({
  method: 'personal_sign',
  params: [message, address(
});
await fetch('/api/login', {
  method: 'POST',
  body: JSON.stringify({ message, signature })
});

// 后端(Node.js)
const { address } = siwe.parseMessage(message);
const recovered = ethers.verifyMessage(message, signature);
if (recovered !== address) throw new Error('Invalid signature');
if (usedNonces.has(nonce)) throw new Error('Nonce reused');
if (new Date(expiration) < new Date()) throw new Error('Expired');
const jwt = sign({ address }, process.env.JWT_SECRET);

常见误区

  • 误区:SIWE 就是 personal_sign;正解:它是标准化的 personal_sign,包含 domain、nonce、expiration。
  • 误区:签名后就登录了;正解:后端要验证签名、检查 nonce、签发 JWT。
  • 误区:SIWE 是 DApp 专属;正解:它是通用的 Web3 登录标准。

追问

  • SIWE 为什么需要 domain 绑定?答:防钓鱼。机制上消息里包含 example.com,用户看到签名消息里的域名,知道是哪个网站要登录。如果钓鱼网站伪造消息,用户看到域名不对就不会签名。边界在于:用户可能不仔细看消息内容。延伸:EIP-712 结构化签名让用户看到更清晰的信息。
  • SIWE 与传统登录的区别?答:传统登录用密码,SIWE 用钱包签名。机制上传统登录需要存储密码哈希,SIWE 不需要存储任何用户凭证。边界在于:SIWE 依赖钱包安全,如果钱包私钥泄露,账户也被盗。延伸:SIWE 是 Web3 原生的登录方式。
  • SIWE 会话怎么管理?答:后端签发 JWT,前端后续请求带 JWT。机制上 JWT 有过期时间,前端定期刷新。边界在于:JWT 泄露后无法撤销,需要后端维护撤销列表。延伸:很多项目用短期 JWT + refresh token。

15.6.1-003 personal_sign 与 EIP-7122 签名的区别?

一句话结论

personal_sign 签名任意文本消息,用户看到的是十六进制字符串;EIP-712 签名结构化数据,用户看到的是可读的类型化信息(如"登录到 example.com"、"金额:100 ETH")。

概念解释

  • personal_sign:签名任意文本,用户看到十六进制字符串。
  • EIP-712:结构化签名,用户看到类型化数据。
  • 可读性:EIP-712 让用户清楚知道签名内容。
  • 安全:EIP-712 减少钓鱼(用户看到明确内容)。

原理流程

  1. personal_sign:前端构造文本消息,钱包显示十六进制字符串。
  2. EIP-712:前端构造结构化数据(domain、types、message),钱包显示可读信息。
  3. 用户看到 EIP-712 的清晰内容,决定是否签名。
  4. 签名后,后端验证签名。

代码或图示

// personal_sign
const message = 'example.com 想让你登录';
const signature = await window.ethereum.request({
  method: 'personal_sign',
  params: [message, address(
});

// EIP-712
const domain = { name: 'Example', version: '1', chainId: 1 };
const types = { Login: [{ name: 'domain', type: 'string' }, { name: 'nonce', type: 'string' }( };
const message = { domain: 'example.com', nonce: 'abc123' };
const signature = await window.ethereum.request({
  method: 'eth_signTypedData_v4',
  params: [address, JSON.stringify({ domain, types, message })(
});

常见误区

  • 误区:personal_sign 与 EIP-712 等价;正解:EIP-712 更安全(用户看到清晰内容)。
  • 误区:EIP-712 只用于交易;正解:它也用于登录、授权等。
  • 误区:personal_sign 不安全;正解:它是合法的,只是用户体验差。

追问

  • EIP-712 为什么更安全?答:因为用户看到清晰内容。机制上 personal_sign 显示十六进制字符串,用户不知道签的是什么;EIP-712 显示"登录到 example.com",用户清楚知道。边界在于:用户可能仍然不仔细看。延伸:很多 DApp 用 EIP-712 做授权(permit)。
  • EIP-712 的 domain 有什么用?答:绑定签名到特定应用。机制上 domain 包含 name、version、chainId、verifyingContract,防止签名被其他应用复用。边界在于:如果 domain 配置错误,签名可能被复用。延伸:EIP-2612(permit)用 EIP-712 做授权。
  • personal_sign 的局限性?答:用户体验差。机制上用户看到十六进制字符串,不知道签的是什么。边界在于:很多 DApp 仍然用 personal_sign,因为它简单。延伸:EIP-712 是未来趋势。

15.6.1-004 SIWE 防重放怎么做?nonce、chainId、expiration 各起什么作用?

一句话结论

SIWE 防重放靠三个要素:nonce(一次性随机数,后端记录已用 nonce)、chainId(绑定签名到特定链,防止跨链复用)、expiration(过期时间,防止长期复用)。

概念解释

  • nonce:一次性随机数,后端记录已用 nonce,用过就拒绝。
  • chainId:绑定签名到特定链,防止签名在其他链复用。
  • expiration:过期时间,超过就拒绝。

原理流程

  1. 后端生成随机 nonce,前端请求时返回。
  2. 前端构造 SIWE 消息,包含 nonce、chainId、expiration。
  3. 用户签名,前端把签名 + 消息发给后端。
  4. 后端验证:
    • nonce 是否用过(用过就拒绝)。
    • chainId 是否匹配当前链(不匹配就拒绝)。
    • expiration 是否过期(过期就拒绝)。
  5. 验证通过,签发 JWT,记录 nonce 已用。

代码或图示

// 后端
const usedNonces = new Set();

app.post('/api/login', (req, res) => {
  const { message, signature } = req.body;
  const { nonce, chainId, expiration } = parseMessage(message);

  if (usedNonces.has(nonce)) throw new Error('Nonce reused');
  if (chainId !== currentChainId) throw new Error('Wrong chain');
  if (new Date(expiration) < new Date()) throw new Error('Expired');

  usedNonces.add(nonce);
  const jwt = sign({ address }, JWT_SECRET);
  res.json({ jwt });
});

常见误区

  • 误区:nonce 只是随机数;正解:后端要记录已用 nonce,用过就拒绝。
  • 误区:chainId 不重要;正解:防止签名在其他链复用。
  • 误区:expiration 可以很长;正解:通常 24 小时内,防止长期复用。

追问

  • nonce 怎么生成?答:用密码学安全随机数生成器。机制上 crypto.randomBytes(16) 生成 16 字节随机数。边界在于:nonce 不要用时间戳,可预测。延伸:很多项目用 uuid 库生成 nonce。
  • chainId 为什么要绑定?答:防止签名在其他链复用。机制上同一个签名在 Ethereum Mainnet(chainId=1)和 Goerli(chainId=5)是不同的。边界在于:如果 chainId 不匹配,后端应该拒绝。延伸:很多 DApp 只支持特定链。
  • expiration 怎么设?答:通常 24 小时内。机制上 expiration 太长,签名可能被长期复用;太短,用户体验差。边界在于:很多项目用 24 小时 expiration。延伸:很多项目用短期 JWT + refresh token。

15.6.1-005 多链切换时 wallet_switchEthereumChain 与 wallet_addEthereumChain 的坑?

一句话结论

wallet_switchEthereumChain 切换到已添加的链,wallet_addEthereumChain 添加新链到钱包。常见坑:用户拒绝切换、链未添加、chainId 格式错误(十进制 vs 十六进制)。

概念解释

  • wallet_switchEthereumChain:切换到已添加的链。
  • wallet_addEthereumChain:添加新链到钱包。
  • 坑 1:用户拒绝切换。
  • 坑 2:链未添加,需要先 add。
  • 坑 3:chainId 格式错误(十六进制字符串)。

原理流程

  1. DApp 请求切换到 Polygon(chainId=137)。
  2. 调用 wallet_switchEthereumChain,参数 { chainId: '0x89' }(十六进制)。
  3. 如果链未添加,钱包返回错误 4902。
  4. 调用 wallet_addEthereumChain,参数包含 chainId、rpcUrls、blockExplorerUrls。
  5. 用户确认添加,钱包切换到新链。

代码或图示

// 切换链
async function switchChain(chainId) {
  try {
    await window.ethereum.request({
      method: 'wallet_switchEthereumChain',
      params: [{ chainId: `0x${chainId.toString(16)}` }(
    });
  } catch (error) {
    if (error.code === 4902) {
      // 链未添加,先添加
      await window.ethereum.request({
        method: 'wallet_addEthereumChain',
        params: [{
          chainId: `0x${chainId.toString(16)}`,
          chainName: 'Polygon',
          rpcUrls: ['https://polygon-rpc.com/'(,
          blockExplorerUrls: ['https://polygonscan.com/'(
        }(
      });
    } else if (error.code === 4001) {
      // 用户拒绝
      console.log('User rejected');
    }
  }
}

常见误区

  • 误区:chainId 用十进制;正解:EIP-1193 要求十六进制字符串。
  • 误区:switch 失败就结束;正解:如果链未添加,要先 add。
  • 误区:用户会自动同意;正解:用户可能拒绝,要处理错误。

追问

  • chainId 为什么用十六进制?答:EIP-1193 规范。机制上 eth_chainId 返回十六进制字符串(如 0x1 表示 Ethereum Mainnet)。边界在于:很多库(如 wagmi)自动处理格式。延伸:不要手动转换 chainId,用库函数。
  • 怎么处理用户拒绝?答:提示用户手动切换。机制上用户拒绝后,DApp 提示"请手动切换到 Polygon"。边界在于:用户可能不知道怎么切换,需要引导。延伸:很多 DApp 显示"请在钱包里切换到 Polygon"。
  • 怎么知道链是否已添加?答:尝试 switch,失败就 add。机制上 switch 失败返回 4902,表示链未添加。边界在于:不同钱包的错误码可能不同。延伸:很多项目用 wagmi 封装这个逻辑。

15.6.1-006 wagmi/viem 与 ethers.js 的关系?为什么要切到 viem?

一句话结论

wagmi 是 React Hooks 库,封装 EIP-1193、SIWE、交易发送;viem 是底层 JS 库,替代 ethers.js,提供更轻量、更类型安全的 API。切到 viem 是因为它 bundle 更小、类型更安全、性能更好。

概念解释

  • ethers.js:最早的以太坊 JS 库,API 简洁但 bundle 大。
  • viem:新一代库,bundle 更小、类型更安全、性能更好。
  • wagmi:React Hooks 库,基于 viem,封装常用操作(连接、签名、交易)。
  • 切换原因:viem bundle 小、类型安全、性能好。

原理流程

  1. 早期 DApp 用 ethers.js。
  2. viem 出现,提供更轻量、更类型安全的 API。
  3. wagmi 基于 viem,封装 React Hooks。
  4. 项目从 ethers.js 切到 viem + wagmi。

代码或图示

// ethers.js
import { ethers } from 'ethers';
const provider = new ethers.providers.Web3Provider(window.ethereum);
const signer = provider.getSigner();
const address = await signer.getAddress();

// viem + wagmi
import { useAccount, useSignMessage } from 'wagmi';
const { address } = useAccount();
const { signMessage } = useSignMessage();
signMessage({ message: 'Hello' });

常见误区

  • 误区:viem 是 wagmi 的重写;正解:viem 是底层库,wagmi 基于 viem。
  • 误区:ethers.js 过时了;正解:它仍然广泛使用,但 viem 是趋势。
  • 误区:切换很简单;正解:API 差异大,需要重构。

追问

  • viem 比 ethers.js 好在哪里?答:bundle 小、类型安全、性能好。机制上 viem 用 TypeScript 重写,类型更严格;tree-shaking 更好,bundle 更小。边界在于:viem 生态比 ethers.js 小,有些库不支持。延伸:很多新项目用 viem。
  • wagmi 解决了什么问题?答:React Hooks 封装。机制上 wagmi 封装了连接、签名、交易发送等常用操作,前端开发更简单。边界在于:wagmi 只支持 React,其他框架需要自己封装。延伸:很多 React DApp 用 wagmi。
  • 怎么从 ethers.js 迁移?答:逐步替换。机制上先把工具函数从 ethers.js 切到 viem,再把 React 组件切到 wagmi。边界在于:迁移成本高,需要充分测试。延伸:很多项目选择在新项目用 viem,老项目保持 ethers.js。

15.6.1-007 钱包连接断开/chainChanged/accountsChanged 怎么处理?

一句话结论

监听钱包事件:accountsChanged(用户切换账户,更新前端状态)、chainChanged(用户切换链,刷新数据)、disconnect(钱包断开,清除会话)。

概念解释

  • accountsChanged:用户在钱包里切换账户,前端更新地址。
  • chainChanged:用户在钱包里切换链,前端刷新数据。
  • disconnect:钱包断开连接,前端清除会话。

原理流程

  1. DApp 监听 accountsChanged:用户切换账户,前端更新 address。
  2. DApp 监听 chainChanged:用户切换链,前端刷新数据(重新拉取余额、持仓)。
  3. DApp 监听 disconnect:钱包断开,前端清除 JWT 会话。

代码或图示

window.ethereum.on('accountsChanged', (accounts) => {
  setAddress(accounts[0();
  // 重新登录
});

window.ethereum.on('chainChanged', (chainId) => {
  setChainId(chainId);
  // 刷新数据
  refreshData();
});

window.ethereum.on('disconnect', () => {
  setAddress(null);
  clearJWT();
});

常见误区

  • 误区:连接后就不用监听了;正解:用户可能随时切换账户/链。
  • 误区:chainChanged 只需要更新状态;正解:要刷新数据(余额、持仓)。
  • 误区:disconnect 很少发生;正解:用户可能手动断开,要处理。

追问

  • accountsChanged 为什么要重新登录?答:因为地址变了,会话要重新建立。机制上用户切换账户,前端要重新 SIWE 登录。边界在于:用户可能只是查看另一个账户,不一定要切换。延伸:很多 DApp 提示"切换账户后需要重新登录"。
  • chainChanged 为什么要刷新数据?答:因为不同链的数据不同。机制上用户切换到 Polygon,前端要拉取 Polygon 上的余额、持仓。边界在于:刷新数据可能慢,需要 loading 状态。延伸:很多 DApp 显示 loading 状态。
  • disconnect 怎么触发?答:用户手动断开、钱包被卸载、网络错误。机制上用户在钱包里点击"断开连接",或钱包被卸载。边界在于:disconnect 可能不触发(网络错误),需要超时处理。延伸:很多 DApp 定期检查连接状态。

15.6.1-008 签名被钓鱼网站复用的攻击面有哪些?

一句话结论

签名被钓鱼网站复用的攻击面:用户在钓鱼网站签名了一条消息,钓鱼网站把这个签名用在合法 DApp 上,冒充用户身份。

概念解释

  • 钓鱼网站:伪造 DApp 网站,诱导用户签名。
  • 签名复用:钓鱼网站把用户的签名用在合法 DApp 上。
  • 攻击面:用户在钓鱼网站签名了"登录到 example.com",钓鱼网站把这个签名用在 example.com 上。

原理流程

  1. 钓鱼网站伪造 example.com,诱导用户访问。
  2. 用户在钓鱼网站签名了"登录到 example.com"的消息。
  3. 钓鱼网站把这个签名发到 example.com 的后端。
  4. example.com 验证签名通过,签发 JWT,钓鱼网站冒充用户登录。

代码或图示

攻击流程:
  1. 钓鱼网站伪造 example.com
  2. 用户在钓鱼网站签名"登录到 example.com"
  3. 钓鱼网站把签名发到 example.com
  4. example.com 验证签名通过,签发 JWT
  5. 钓鱼网站冒充用户登录

常见误区

  • 误区:签名是安全的;正解:签名可能被钓鱼网站复用。
  • 误区:domain 绑定足够;正解:用户可能不仔细看域名。
  • 误区:EIP-712 完全防钓鱼;正解:它让用户看到清晰内容,但用户可能不看。

追问

  • 怎么防止签名被复用?答:nonce 一次性 + domain 绑定 + expiration。机制上 nonce 用过就拒绝,domain 绑定到特定网站,expiration 防止长期复用。边界在于:钓鱼网站可以在 expiration 内复用签名。延伸:很多项目用短期 expiration(如 1 小时)。
  • EIP-712 怎么减少钓鱼?答:让用户看到清晰内容。机制上 EIP-712 显示"登录到 example.com",用户看到域名不对就不会签名。边界在于:用户可能不仔细看。延伸:很多 DApp 用 EIP-712 做授权。
  • 钓鱼网站怎么伪造?答:伪造域名(如 examp1e.com)、伪造网站外观。机制上用户访问 examp1e.com,以为是 example.com,签名消息。边界在于:用户可能不仔细看 URL。延伸:浏览器的 HTTPS 证书、域名检测可以减少钓鱼。

15.6.1-009 多签钱包(Safe)作为登录身份时,SIWE 有什么不同?

一句话结论

多签钱包(Safe)作为登录身份时,签名不是 EOA 签名,而是 Safe 的签名聚合(EIP-1271),后端验证方式不同:调用 Safe 的 isValidSignature 函数,而不是 ecrecover。

概念解释

  • Safe:多签钱包,多个 owner 共同管理。
  • EIP-1271:合约签名验证标准,合约实现 isValidSignature 函数。
  • 验证方式:后端调用 Safe 的 isValidSignature,而不是 ecrecover。

原理流程

  1. 用户用 Safe 作为登录身份。
  2. 前端构造 SIWE 消息,用户在 Safe 里签名。
  3. Safe 聚合多个 owner 的签名。
  4. 前端把签名 + 消息发给后端。
  5. 后端调用 Safe 的 isValidSignature(hash, signature) 验证。
  6. 如果返回 magic value,验证通过。

代码或图示

// 后端
const Safe = await ethers.getContractAt('Safe', safeAddress);
const isValid = await Safe.isValidSignature(hash, signature);
if (isValid === '0x1626ba7e') {
  // EIP-1271 magic value
  // 验证通过
}

常见误区

  • 误区:Safe 登录与 EOA 登录一样;正解:Safe 用 EIP-1271 验证,不是 ecrecover。
  • 误区:后端要解析多签;正解:Safe 聚合签名,后端只需调用 isValidSignature。
  • 误区:Safe 登录更安全;正解:它依赖 Safe 的配置(owner 数量、阈值)。

追问

  • EIP-1271 是什么?答:合约签名验证标准。机制上合约实现 isValidSignature(hash, signature) 函数,后端调用它验证。边界在于:不同合约的实现可能不同。延伸:Safe 是 EIP-1271 的典型实现。
  • Safe 怎么聚合签名?答:多个 owner 各自签名,Safe 聚合。机制上 Safe 收集所有 owner 的签名,打包成一个签名。边界在于:多签需要多个 owner 签名,用户体验差。延伸:很多项目用 Safe 的"链下签名"功能。
  • Safe 登录的用户体验?答:差。机制上多签需要多个 owner 签名,用户操作复杂。边界在于:很多项目用 Safe 做管理员登录,普通用户用 EOA。延伸:很多 DApp 同时支持 EOA 和 Safe 登录。

15.6.1-010 设计一个登录态会话:签名 → 后端签发 JWT,需要考虑什么?

一句话结论

设计登录态会话需要考虑:JWT 过期时间、刷新机制、撤销机制、存储位置(localStorage vs httpOnly cookie)、CSRF 防护。

概念解释

  • JWT:会话令牌,有过期时间。
  • 刷新机制:短期 JWT + refresh token。
  • 撤销机制:后端维护撤销列表。
  • 存储位置:localStorage 易受 XSS,httpOnly cookie 防 XSS。
  • CSRF 防护:SameSite cookie、CSRF token。

原理流程

  1. 用户 SIWE 登录,后端签发 JWT(短期,如 1 小时)。
  2. 前端把 JWT 存在 localStorage 或 httpOnly cookie。
  3. 后续请求带 JWT。
  4. JWT 过期,前端用 refresh token 获取新 JWT。
  5. 后端维护撤销列表(用户登出时加入)。

代码或图示

// 后端签发
const jwt = sign({ address }, JWT_SECRET, { expiresIn: '1h' });
const refreshToken = sign({ address }, REFRESH_SECRET, { expiresIn: '7d' });

// 前端存储
localStorage.setItem('jwt', jwt);
localStorage.setItem('refreshToken', refreshToken);

// 后续请求
fetch('/api/data', {
  headers: { Authorization: `Bearer ${jwt}` }
});

// 刷新
const newJwt = await fetch('/api/refresh', {
  method: 'POST',
  body: JSON.stringify({ refreshToken })
});

常见误区

  • 误区:JWT 长期有效;正解:短期 JWT(1 小时)+ refresh token。
  • 误区:localStorage 安全;正解:易受 XSS,httpOnly cookie 更安全。
  • 误区:JWT 不能撤销;正解:后端维护撤销列表。

追问

  • JWT 为什么短期?答:防止泄露后长期可用。机制上 JWT 泄露后,攻击者可以用它冒充用户,短期 JWT 减少风险。边界在于:JWT 太短,用户频繁重新登录,体验差。延伸:很多项目用 1 小时 JWT + 7 天 refresh token。
  • localStorage 与 httpOnly cookie 的区别?答:localStorage 易受 XSS,httpOnly cookie 防 XSS。机制上 localStorage 可以被 JavaScript 读取,XSS 攻击可以窃取;httpOnly cookie 不能被 JavaScript 读取,防 XSS。边界在于:httpOnly cookie 易受 CSRF。延伸:很多项目用 httpOnly cookie + CSRF token。
  • JWT 怎么撤销?答:后端维护撤销列表。机制上用户登出时,后端把 JWT 加入撤销列表,后续请求检查。边界在于:撤销列表占用内存,需要定期清理。延伸:很多项目用短期 JWT,不需要撤销。

动手练习

练习 1:用 wagmi 实现 SIWE 登录

  • 任务:写一个 React 应用,用 wagmi 连接钱包,用 SIWE 登录,后端验证签名并签发 JWT。
  • 验收标准:
    1. 能连接 MetaMask,获取地址。
    2. 能 SIWE 登录,后端验证签名。
    3. 能处理 accountsChanged/chainChanged 事件。

练习 2:实现多链切换

  • 任务:写一个按钮,点击后切换到 Polygon(chainId=137),处理链未添加、用户拒绝的错误。
  • 验收标准:
    1. 能切换到 Polygon。
    2. 链未添加时,先调用 wallet_addEthereumChain。
    3. 用户拒绝时,提示用户手动切换。

自检清单

  • [ ( 能否描述 EIP-1193 的核心 API?
  • [ ( 能否画出 SIWE 登录的完整调用链?
  • [ ( 能否解释 personal_sign 与 EIP-712 的区别?
  • [ ( 能否说出 SIWE 防重放的三个要素?
  • [ ( 能否处理多链切换的常见错误?
  • [ ( 能否解释 wagmi/viem 与 ethers.js 的关系?
  • [ ( 能否处理钱包事件?
  • [ ( 能否设计一个登录态会话?

延伸阅读

  • EIP-1193、EIP-4361(SIWE)、EIP-712、EIP-1271 原文。
  • wagmi 官方文档:useAccount、useSignMessage、useSwitchChain。
  • viem 官方文档:createWalletClient、verifyMessage。
  • OpenZeppelin 官方文档:ECDSA、EIP1271。
  • 安全最佳实践:防 XSS、防 CSRF、JWT 管理。

待整理清单

  • [ ( 补充各浏览器钱包行为差异对照
  • [ ( 补充 WalletConnect 的连接流程
  • [ ( 补充 Web3Modal 的最佳实践