如何通过web3js在Solidity中构建包含数千元素的大型字符串数组

问题根因排查 #

• 首先确认ABIEncoderV2的开启方式：需要在合约开头声明 pragma abicoder v2; （Solidity 0.8+版本默认开启ABICoder v2不需要额外声明），你遇到的交易回滚大概率是gas limit设置不足，或者数千元素的动态数组入参+存储操作总消耗超过了以太坊单区块gas上限（当前主网上限约3000万），而非ABICoder本身不支持字符串数组入参
• Solidity的16个入参限制是底层栈深度约束，无法突破，分上百次调用的方案gas冗余消耗极高，不建议采用

推荐解决方案按优先级排序 #

方案1：单字符串批量编码上链（最高性价比，仅需1次交易） #

• 链下web3js侧：将所有字符串用不会出现在业务字符串中的特殊分隔符（例如\|）拼接为单个长字符串，若业务字符串可能包含任意字符，可以先对每个字符串做base64编码后再拼接，确保分隔符不会和内容冲突
• 合约侧：仅需接收1个string calldata类型的长字符串参数，编写纯函数对长字符串按分隔符拆分，还原为字符串数组后存入合约存储即可
• 该方案gas成本仅为单交易的基础开销，哪怕是上万元素的数组也可以一次完成上链

方案2：固定批次批量上链（适合需要链上直接处理数组元素的场景） #

• 合约定义入参为string[] calldata strs（需确保ABICoder v2开启），单次调用传输100~200个字符串即可，每次调用后将传入的数组合并到全局存储数组的末尾
• 交易发送前先调用eth_estimateGas预估gas，给预估结果加30%的冗余值作为最终gas limit，可避免交易回滚
• 千元素数组仅需5~10次调用即可完成，gas成本比分16参数批次调用低70%以上

方案3：IPFS存根方案（适合仅需链上存证、无需链上读取元素内容的场景） #

• 链下将整个字符串数组序列化为JSON/二进制文件上传到IPFS，仅将得到的IPFS哈希存入合约即可，只需要1次交易，gas成本不到直接上链数组的1%
• 需要读取数组时，从链上取出IPFS哈希即可查询到完整的原始数组内容

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