Ethers.js 中 EIP-7702 类型交易构建问题解析

前言

在区块链开发中，ethers.js 作为最受欢迎的 JavaScript 库之一，为开发者提供了丰富的功能来与区块链交互。本文将深入探讨在使用 ethers.js 6.14.3 版本构建 EIP-7702（类型 4）交易时遇到的一个典型问题，并提供解决方案。

问题背景

EIP-7702 引入了一种新型交易类型（类型 4），它包含一个授权列表（authorizationList），用于指定交易执行所需的授权信息。开发者在使用 ethers.Transaction.from() 方法构建此类交易时，可能会遇到"invalid address"错误，即使输入的授权列表对象看起来完全正确。

问题现象

当开发者尝试按照以下方式构建交易时：

const minimalTxPojo = {
    to: "0x000...000",
    type: 4,
    authorizationList: [{
        chainId: 11155111n,
        authority: "0xBCe...0cF",
        contract: "0x3D5...C99",
        nonce: 0n,
        signature: "0x1bb...1c"
    }],
    // 其他标准交易字段...
};

系统会抛出错误："invalid address (argument='address', value=null)"，提示地址无效，但实际上传入的地址都是经过验证的有效地址。

问题根源

经过分析，这个问题源于 ethers.js 内部对授权列表项的字段命名预期与实际传入的字段名不匹配。具体来说：

1. ethers.js 期望授权列表项使用 "address" 字段来指定合约地址
2. 但开发者通常直觉上会使用 "contract" 字段名
3. 同时，"authority" 字段实际上是不必要的，因为授权方的地址可以从签名中恢复出来

解决方案

正确的构建方式应该是：

const tx = ethers.Transaction.from({
    to: "0x000...000",
    type: 4,
    authorizationList: [{
        chainId: 11155111n,
        address: "0x3D5...C99", // 使用 address 而非 contract
        nonce: 0n,
        signature: ethers.Signature.from("0x1bb...1c") // 直接使用 Signature 对象
    }],
    // 其他标准交易字段...
});

最佳实践建议

1. 字段命名规范：始终使用 "address" 而非 "contract" 来指定合约地址
2. 签名处理：直接将签名字符串转换为 Signature 对象，提高代码可读性
3. 简化授权项：不需要包含 authority 字段，因为它可以从签名中推导
4. 类型检查：在构建复杂交易时，先验证各个字段的类型是否符合预期

未来改进

ethers.js 团队已经注意到这个问题，并计划在未来版本中：

1. 引入 AuthorizationLike 类型，使手动构建授权列表更加灵活
2. 提供更清晰的错误提示，帮助开发者快速定位字段命名问题
3. 完善文档，明确各种交易类型的构建规范

总结

在使用 ethers.js 构建 EIP-7702 类型交易时，开发者需要注意授权列表字段的特殊命名约定。通过使用正确的字段名和格式，可以避免常见的构建错误。随着 ethers.js 的持续更新，这类特殊交易类型的构建体验将会变得更加友好和直观。