合约钱包与 EIP-1271 登录支持

📚 作者：Henry 🧱 系列：《Web2 到 Web3：登录与身份验证机制全面进化》 · 第 8 篇 👨‍💻 受众：Web2 & Web3 开发者 / 区块链学习者 👉 系列持续更新中，建议收藏专栏或关注作者

背景：为什么需要额外标准？

在 Web3 登录中，签名行为默认基于 EOA（Externally Owned Account）：

• 拥有私钥
• 能直接调用 signMessage()、signTypedData()
• 可通过 recoverAddress() 恢复地址用于身份认证

但：合约钱包（Smart Contract Wallet）没有私钥，无法签名

合约钱包（SCW）工作方式

• 钱包行为通过合约逻辑代理，如 Gnosis Safe、Kernel、4337 钱包
• 用户行为（如签名）由合约内部调用或特定模块处理
• 结果：客户端调用签名方法可能失败或返回不可用签名

识别合约钱包（是否为 SCW）

✅ 方法一（客户端）

import { getBytecode } from 'viem';

const bytecode = await getBytecode(client, { address });
const isContract = !!bytecode && bytecode !== '0x';

✅ 方法二（服务端）

使用 RPC 接口查询：

eth_getCode(address, 'latest')

返回非 0x 即为合约地址。

引出解决方案：EIP-1271 签名验证接口

EIP-1271 定义了合约签名验证标准接口：

function isValidSignature(bytes32 hash, bytes memory signature)
    public view returns (bytes4 magicValue);

✅ 返回值说明

• `0x1626ba...