如何验证Solidity Calldata可解码为指定结构体？

问题背景 #

定义了IResolver接口，其中validateAdditionalCalldata函数需要验证传入的calldata是否符合特定结构体格式，解码失败则revert。但尝试的两种解码方式均报错：

1. bool success = abi.decode(additionalCalldataMemory, fooOptions); —— 提示abi.decode无返回值
2. abi.decode(additionalCalldata, fooOptions); —— 提示需要类型元组

接口代码：

// Resolver interface
interface IResolver {
    // Pass payment info as calldata only the manager should have the right to update it
    function resolve(uint256 amount, ResolverOptions calldata resolverOptions) external returns (uint256);

    // Reverts if the calldata passes is not a proper struct
   function validateAdditionalCalldata(bytes calldata additionalCalldata) external view;
}

原有实现（存在解码问题）：

struct fooResolverOptions {
    address[] fooAddresses; 
    uint256[] fooAmounts; 
}

contract FooResolver is IResolver {
    function validateAdditionalCalldata(bytes calldata additionalCalldata) view external {
        bytes memory additionalCalldataMemory = additionalCalldata;
        FooResolverOptions memory fooOptions;
        bool success = abi.decode(additionalCalldataMemory, fooOptions);
        require(success, "Invalid additional calldata");
    }
}

解决方案 #

核心要点 #

1. abi.decode的正确用法：它返回解码后的值，而非通过引用赋值，且第二个参数必须是元组类型（即使单个结构体也要用括号包裹）。
2. 解码失败的验证方式：abi.decode格式错误会直接revert，无法通过返回值判断，需用try/catch捕获异常来验证有效性。

修正后的合约代码 #

struct FooResolverOptions {
    address[] fooAddresses; 
    uint256[] fooAmounts; 
}

// 注意：接口中的ResolverOptions需要提前定义，或者与业务逻辑匹配
interface IResolver {
    struct ResolverOptions {} // 根据实际场景补充结构体字段
    function resolve(uint256 amount, ResolverOptions calldata resolverOptions) external returns (uint256);
    function validateAdditionalCalldata(bytes calldata additionalCalldata) external view;
}

contract FooResolver is IResolver {
    function validateAdditionalCalldata(bytes calldata additionalCalldata) external view {
        try this.decodeFooOptions(additionalCalldata) {
            // 解码成功，无需额外操作
        } catch {
            require(false, "Invalid additional calldata");
        }
    }

    // 单独抽离解码逻辑为外部函数，方便try/catch捕获异常
    function decodeFooOptions(bytes calldata data) external pure returns (FooResolverOptions memory) {
        // 第二个参数为元组类型，包裹目标结构体
        return abi.decode(data, (FooResolverOptions));
    }

    // 实现接口要求的resolve函数
    function resolve(uint256 amount, ResolverOptions calldata resolverOptions) external returns (uint256) {
        // 补充你的业务逻辑
        return amount;
    }
}

关键说明 #

• 元组格式是Solidity ABI解码的强制要求，即使只解码单个结构体，也要用(FooResolverOptions)作为abi.decode的第二个参数。
• 当calldata格式不符合结构体要求时，decodeFooOptions会触发revert，被catch块捕获后执行require(false)抛出指定错误。
• 接口中的ResolverOptions必须实际定义字段，否则合约无法通过编译。

内容的提问来源于stack exchange，提问作者Ritzy Dev