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 一致。
原理流程
- 用户安装 MetaMask,访问 DApp。
- DApp 检查
window.ethereum是否存在。 - DApp 调用
window.ethereum.request({ method: 'eth_requestAccounts' })。 - MetaMask 弹窗请求用户授权,用户同意后返回地址。
- 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 绑定)。
原理流程
- 用户访问 DApp,前端调用
GET /api/nonce从后端获取随机 nonce。 - 前端构造 SIWE 消息:
example.com 想让你登录: 0x1234...5678 Chain ID: 1 Nonce: abc123 Expiration: 2026-11-22T12:00:00Z - 用户用钱包签名
personal_sign(message, address)。 - 前端把签名 + 消息发给后端
POST /api/login。 - 后端验证签名:
ecrecover(message, signature) == address。 - 后端检查 nonce 是否用过、expiration 是否过期、chainId 是否匹配。
- 后端签发 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 减少钓鱼(用户看到明确内容)。
原理流程
- personal_sign:前端构造文本消息,钱包显示十六进制字符串。
- EIP-712:前端构造结构化数据(domain、types、message),钱包显示可读信息。
- 用户看到 EIP-712 的清晰内容,决定是否签名。
- 签名后,后端验证签名。
代码或图示
// 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:过期时间,超过就拒绝。
原理流程
- 后端生成随机 nonce,前端请求时返回。
- 前端构造 SIWE 消息,包含 nonce、chainId、expiration。
- 用户签名,前端把签名 + 消息发给后端。
- 后端验证:
- nonce 是否用过(用过就拒绝)。
- chainId 是否匹配当前链(不匹配就拒绝)。
- expiration 是否过期(过期就拒绝)。
- 验证通过,签发 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 格式错误(十六进制字符串)。
原理流程
- DApp 请求切换到 Polygon(chainId=137)。
- 调用
wallet_switchEthereumChain,参数{ chainId: '0x89' }(十六进制)。 - 如果链未添加,钱包返回错误
4902。 - 调用
wallet_addEthereumChain,参数包含 chainId、rpcUrls、blockExplorerUrls。 - 用户确认添加,钱包切换到新链。
代码或图示
// 切换链
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 小、类型安全、性能好。
原理流程
- 早期 DApp 用 ethers.js。
- viem 出现,提供更轻量、更类型安全的 API。
- wagmi 基于 viem,封装 React Hooks。
- 项目从 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:钱包断开连接,前端清除会话。
原理流程
- DApp 监听
accountsChanged:用户切换账户,前端更新address。 - DApp 监听
chainChanged:用户切换链,前端刷新数据(重新拉取余额、持仓)。 - 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 上。
原理流程
- 钓鱼网站伪造
example.com,诱导用户访问。 - 用户在钓鱼网站签名了"登录到 example.com"的消息。
- 钓鱼网站把这个签名发到
example.com的后端。 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。
原理流程
- 用户用 Safe 作为登录身份。
- 前端构造 SIWE 消息,用户在 Safe 里签名。
- Safe 聚合多个 owner 的签名。
- 前端把签名 + 消息发给后端。
- 后端调用 Safe 的
isValidSignature(hash, signature)验证。 - 如果返回 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。
原理流程
- 用户 SIWE 登录,后端签发 JWT(短期,如 1 小时)。
- 前端把 JWT 存在 localStorage 或 httpOnly cookie。
- 后续请求带 JWT。
- JWT 过期,前端用 refresh token 获取新 JWT。
- 后端维护撤销列表(用户登出时加入)。
代码或图示
// 后端签发
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。
- 验收标准:
- 能连接 MetaMask,获取地址。
- 能 SIWE 登录,后端验证签名。
- 能处理 accountsChanged/chainChanged 事件。
练习 2:实现多链切换
- 任务:写一个按钮,点击后切换到 Polygon(chainId=137),处理链未添加、用户拒绝的错误。
- 验收标准:
- 能切换到 Polygon。
- 链未添加时,先调用 wallet_addEthereumChain。
- 用户拒绝时,提示用户手动切换。
自检清单
- [ ( 能否描述 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 的最佳实践