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

阶段 02 · 第 5 / 13 课

SIWE 与后端登录会话

学完能做到:设计钱包登录、会话过期与地址切换后的处理。

建议先读:连接钱包与账户切换。

先看一个场景

用户在浏览器连接账户后想进入订单页。服务端根据一次性登录声明验证密钥控制权,建立可撤销的网站会话。

核心原理

Sign-In with Ethereum 使用约定的消息格式绑定域、地址、链、Nonce 与时间等字段。登录服务验证消息内容和签名,再存储身份与会话。

需要区分的概念

连接发生在客户端;SIWE 签名证明声明所述地址的控制权;后端 session 决定 API 权限;合约钱包签名验证可能依赖 ERC-1271。

登录接口设计

接口 输入 服务端动作
获取挑战 应用会话、当前地址和网络 产生一次性 nonce,设置短有效期,记录挑战归属
验证签名 完整消息、签名 核对预期字段和签名,原子消费挑战,建立会话
读取会话 站点会话标识 检查失效时间与当前业务权限
退出 当前会话 使站点会话失效

用户点击钱包拒绝时保留可重试入口。账号切换后,先将已有会话标为待重新验证,禁止使用新地址预览旧地址专属订单。签名挑战只表达登录用途,交易和代币授权分别通过专门入口请求。

一份可以读懂的登录挑战

服务端先发出一次性编号。浏览器把站点名、当前地址、链、编号和时效组成待签消息;签完后把原消息和签名交还服务端。服务端校验这些字段,确认签名来自预期账户,随后建立网站会话。下面只是字段示意,实际构造按标准格式。

哪个站点        shop.example
要证明的账号    地址 A
哪个网络        示例网络
一次性编号      训练用随机编号
这次做什么      登录以查看订单

编号在验证成功后应只消费一次。若旧请求被重放、域名不匹配,或用户已切换账号,各自应有明确的错误结果。能打开订单是服务端会话的权限,登录之后要扣款还需要对应的授权与交易。

动手练习

客户端请求 nonce;钱包签署完整声明;后端校验域、URI、时效、链和签名;原子消费 nonce;建立会话;切换账户时重新绑定。

自测

同一登录签名被重复提交两次,后端如何处理?

查看参考答案

首次成功时将 nonce 标记为已消费,后续请求不再创建新会话。Nonce 消费与会话建立应考虑并发。

延伸阅读

记录本课进度

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

搜索课程