Web3.js 4.x版本中二维数组参数校验问题解析

在区块链智能合约开发中，Web3.js库是开发者与区块链交互的重要工具。近期在Web3.js 4.4.0版本中发现了一个关于二维数组参数校验的问题，这个问题会影响开发者调用包含二维数组参数的智能合约方法。

问题现象

当开发者尝试调用一个包含二维数组参数的智能合约方法时，例如：

const addr1 = ['0xaddr']
const addr2 = [['0xaddr','0xaddr','0xaddr'],['0xaddr'], ['0xaddr','0xaddr']]
contract.methods.xxMethod(addr1, addr2).estimateGas()

会遇到参数校验失败的情况。错误信息显示系统错误地将二维数组的最大项目数限制为1，这显然不符合实际需求。

技术背景

在Web3.js中，参数校验是通过JSON Schema实现的。对于智能合约方法的参数，Web3.js会根据ABI定义自动生成校验规则。在4.x版本中，对于二维数组的处理存在缺陷。

问题根源分析

通过检查生成的JSON Schema，我们发现对于二维数组的校验规则定义存在问题：

{
  "type":"array",
  "items":[
    {"type":"array","$id":"addr1","items":{"format":"address","required":true}},
    {"type":"array","items":[{"type":"array","$id":"addr2","items":{"format":"address","required":true}}]}
  ],
  "maxItems":2,
  "minItems":2
}

问题出在第二维数组的校验规则上。系统错误地添加了maxItems:1的限制，导致任何包含多个子数组的二维数组都无法通过校验。

影响范围

这个问题会影响所有使用Web3.js 4.x版本并且需要传递二维数组参数的场景，特别是：

• 调用包含二维数组参数的智能合约方法
• 使用estimateGas方法估算交易gas费用
• 使用encodeABI方法编码交易数据

解决方案

社区开发者已经提交了修复方案，主要修改点是：

1. 修正二维数组的JSON Schema生成逻辑
2. 确保不添加不合理的项目数量限制
3. 保持与1.x版本的兼容性

开发者建议

在等待官方修复发布期间，开发者可以采取以下临时解决方案：

1. 暂时降级使用Web3.js 1.10.2版本
2. 对于紧急项目，可以手动修改本地Web3.js库的校验逻辑
3. 考虑使用其他方式传递二维数组参数，如先编码再传递

总结

这个问题提醒我们在使用新版本库时需要充分测试各种参数组合。对于复杂的参数结构，特别是多维数组，应该特别注意兼容性问题。Web3.js团队正在积极解决这个问题，预计在后续版本中会发布修复。