智能合约与以太坊 / 系统课时

核对签名者恢复与过期时间

核对签名者恢复与过期时间

离线签名授权允许用户提交由指定账户签署的消息,但合约不能仅凭签名能够恢复出地址就认定授权有效。本文实现一套可验证的授权检查:同时核对签名格式、签名者身份、截止时间和重复使用状态,拒绝伪造、过期或重放的授权请求。

学习目标

  • 理解 ECDSA 地址恢复与授权身份验证的区别。
  • 使用 OpenZeppelin 实现签名格式、零地址和截止时间检查。
  • 验证错误签名、过期签名与重复提交的拒绝行为。

地址恢复不等于授权成功

以太坊外部账户通常使用 secp256k1 椭圆曲线数字签名。ECDSA 恢复操作根据消息摘要和签名得到一个地址,但恢复过程本身不知道哪个地址拥有业务授权。

例如,系统指定地址 A 为授权签名者。攻击者使用自己的私钥签署相同消息,可能成功恢复出地址 B。密码学恢复成功并不意味着地址 B 有权批准操作。

因此,授权必须同时满足以下条件:

  1. 签名对应当前合约实际计算的消息摘要。
  2. 签名编码合法,恢复过程没有失败。
  3. 恢复地址非零,且严格等于预先指定的授权地址。
  4. 当前区块时间没有超过授权截止时间。
  5. 授权尚未使用,消息绑定了正确的调用者、链和合约。

离线签名授权验证流程图

对于普通外部账户,OpenZeppelin Contracts 5.x 的 ECDSA.recover 可处理标准的 65 字节签名,并检查恢复参数和签名可塑性约束。格式错误可能直接触发 revert,不能假设任何无效签名都会返回零地址。

实现完整的授权检查

以下示例适用于 Solidity 0.8.20 及以上版本与 OpenZeppelin Contracts 5.x。项目必须安装相应依赖,并保证编译器版本符合依赖要求。

示例采用 EIP-191 的个人消息签名格式,通过 MessageHashUtils.toEthSignedMessageHash 将原始消息哈希转换为带以太坊签名前缀的摘要。

solidity
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;

import {ECDSA} from "@openzeppelin/contracts/utils/cryptography/ECDSA.sol";
import {MessageHashUtils} from "@openzeppelin/contracts/utils/cryptography/MessageHashUtils.sol";

contract SignedAuthorization {
    address public immutable authorizedSigner;
    mapping(uint256 => bool) public usedNonces;

    error InvalidSigner();
    error AuthorizationExpired();
    error AuthorizationAlreadyUsed();

    constructor(address signer) {
        // 部署时固定可信签名者,禁止配置零地址。
        if (signer == address(0)) revert InvalidSigner();
        authorizedSigner = signer;
    }

    function execute(
        uint256 nonce,
        uint256 deadline,
        bytes calldata signature
    ) external {
        // 截止时间由签名覆盖,调用者不能单方面延长。
        if (block.timestamp > deadline) {
            revert AuthorizationExpired();
        }
        if (usedNonces[nonce]) {
            revert AuthorizationAlreadyUsed();
        }

        // 绑定合约、链、调用者及授权参数,限制跨域重放。
        bytes32 payloadHash = keccak256(
            abi.encode(
                address(this),
                block.chainid,
                msg.sender,
                nonce,
                deadline
            )
        );
        bytes32 digest =
            MessageHashUtils.toEthSignedMessageHash(payloadHash);

        address recovered = ECDSA.recover(digest, signature);
        if (
            recovered == address(0) ||
            recovered != authorizedSigner
        ) {
            revert InvalidSigner();
        }

        // 验证通过后消耗 nonce,阻止相同授权再次执行。
        usedNonces[nonce] = true;
    }
}

这是可编译的最小授权验证合约。execute 成功只代表授权被验证并消耗,不执行转账或其他业务操作。实际项目应在验证通过后接入具体业务,并明确该业务的权限和失败回滚规则。

部署时传入可信外部账户作为 signer。调用者必须提前取得这个账户对完全相同参数的签名,否则恢复出的地址不会匹配。

保证链下签名与链上摘要一致

签名验证常见问题不是密码学算法错误,而是链下、链上编码不一致。比如链下使用 abi.encodePacked,链上使用 abi.encode,生成的哈希通常不同;或者链下签的是十六进制文本而不是 32 字节哈希。

下面使用 ethers.js v6 生成与合约一致的签名。片段示例依赖已创建的 ethers Provider、拥有签名权限的授权账户,以及部署后的合约地址。为避免依赖真实网络,使用明确的测试参数演示哈希与签名生成。

javascript
import {
  AbiCoder,
  Wallet,
  getBytes,
  keccak256
} from "ethers";

const signer = Wallet.createRandom(); // 仅供本地测试
const contractAddress = "0x1111111111111111111111111111111111111111";
const caller = "0x2222222222222222222222222222222222222222";
const chainId = 31337n;
const nonce = 1n;
const deadline = 2000000000n;

// 字段顺序及类型必须与 Solidity abi.encode 一致。
const encoded = AbiCoder.defaultAbiCoder().encode(
  ["address", "uint256", "address", "uint256", "uint256"],
  [contractAddress, chainId, caller, nonce, deadline]
);
const payloadHash = keccak256(encoded);
const signature = await signer.signMessage(getBytes(payloadHash));

console.log(signature.length);
console.log(signature.startsWith("0x"));
console.log(signer.address.length);

预期输出:

text
132
true
42

132 个字符对应 0x 加 130 个十六进制字符,即标准 65 字节签名。Wallet.createRandom() 每次产生不同账户和签名,不能把该随机钱包当成真实授权账户。

在本地链实际调用时,应使用真实部署地址、当前 chainId、交易发送者地址和未来截止时间,并使用同一个授权钱包签名。由于签名绑定了 msg.sender,只有对应调用者能够成功提交。

检查截止时间与签名边界

本例采用 block.timestamp > deadline 判断过期,因此区块时间恰好等于 deadline 时仍有效。签名截止时间使用 Unix 秒级时间戳,不是 JavaScript 常用的毫秒时间戳。

假设签名者授权截止时间为 2,000,000,000 秒:

区块时间戳 检查结果
1,999,999,999 未过期
2,000,000,000 未过期
2,000,000,001 已过期,revert

截止时间必须包含在被签名的消息中。本例将它放入 abi.encode,攻击者即使修改提交参数,也无法让原签名验证通过。

签名格式还应检查以下边界:

  • 空字节数组:不满足标准签名格式,ECDSA 恢复失败。
  • 非法长度:本示例的 ECDSA.recover(bytes32,bytes) 不直接接受 64 字节紧凑签名,应先按支持的格式转换或使用对应接口。
  • 非法恢复参数或高 s 值:OpenZeppelin 的恢复实现会拒绝不符合要求的签名。
  • 有效但由攻击者签署的签名:能够恢复攻击者地址,但与 authorizedSigner 不相等。
  • 将授权账户设为零地址:部署时直接拒绝,避免错误的身份配置。

注意,签名长度等于 65 字节并不代表签名有效。长度检查只能过滤部分格式错误,不能替代密码学恢复和身份比较。

验证拒绝行为与重放防护

使用本地开发链部署合约,将授权账户配置为固定测试钱包,再准备一个独立调用账户。测试时应签署链上实际使用的合约地址、链 ID 和调用账户地址。

测试场景 预期结果
正确签名,未过期,nonce 未使用 执行成功,usedNonces 变为 true
攻击者使用自己的私钥签名 InvalidSigner()
截止时间早于区块时间 AuthorizationExpired()
同一授权再次提交 AuthorizationAlreadyUsed()
签名为空或格式非法 ECDSA 库错误,交易 revert
修改 nonce 或调用者 恢复身份不匹配,交易 revert
在另一合约或链上复用签名 消息摘要变化,验证失败

可以使用 Foundry、Hardhat 或 Remix 逐项执行。对于有效授权,应同时检查交易成功及 usedNonces(nonce) 返回 true;对于失败调用,检查交易回滚,并确认 nonce 没有被消耗。

需要注意的是,nonce 在示例中采用全局唯一编号。如果业务有多个授权签名者,通常应改为按签名者或授权主体分别维护 nonce,并把对应身份纳入签名消息。

生产环境还应结合业务处理授权失效问题:仅有过期时间和 nonce 不支持主动撤销尚未使用的签名。如果需要立即撤销,可以增加授权版本号、签名者轮换机制或可撤销的授权标识,并把这些信息纳入签名摘要。

最终验收标准是:只有指定签名者针对当前调用者、当前链、当前合约以及未过期参数签署的未使用授权才能通过;所有其他输入必须失败,且不能产生未经授权的业务状态变化。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

核对签名者恢复与过期时间

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通