Java调用返回tuple[]的智能合约函数抛出异常如何解决？

错误根因 #

web3j 解码tuple类型返回值时，不支持直接使用通用的DynamicStruct作为泛型参数，要求必须显式定义和ABI中tuple结构完全匹配的自定义结构体类，类中需要包含对应字段、且构造函数参数的类型、顺序和ABI的components完全对应。

解决步骤 #

1. 自定义对应RewardData结构体的Java类

import org.web3j.abi.datatypes.Address;
import org.web3j.abi.datatypes.DynamicStruct;
import org.web3j.abi.datatypes.Uint256;

public class RewardData extends DynamicStruct {
    public final Address token;
    public final Uint256 amount;

    // 构造函数参数顺序必须和ABI中components顺序完全一致：先address类型的token，再uint256类型的amount
    public RewardData(Address token, Uint256 amount) {
        super(token, amount);
        this.token = token;
        this.amount = amount;
    }
}

2. 修改返回类型声明
   把原来的返回类型定义替换为自定义的RewardData类型：

List<TypeReference<?>> claimableRewardsReturnTypes = Arrays.<TypeReference<?>>asList(
    new TypeReference<DynamicArray<RewardData>>() {}
);

3. 解析返回结果
   解码后直接转换为对应类型即可取值：

DynamicArray<RewardData> rewardsList = (DynamicArray<RewardData>) claimableRewardsSomeTypes.get(0);
for (RewardData reward : rewardsList.getValue()) {
    // 取token地址
    String token = reward.token.getValue();
    // 取奖励数量
    BigInteger amount = reward.amount.getValue();
    // 业务逻辑处理
}

额外优化建议 #

如果不想手动处理编解码和类型匹配，可以直接使用web3j官方提供的合约代码生成工具，导入合约ABI文件直接生成完整的合约调用Java类，调用对应方法即可直接拿到结构化的返回值，无需手动构造Function和处理编解码逻辑。

内容的提问来源于stack exchange，提问作者Coin Lover