Foundry项目中的forge脚本验证虚拟机版本不匹配问题分析

问题概述

在Foundry项目的使用过程中，开发者发现当使用forge script命令配合--evm-version参数和--verify选项进行合约验证时，会出现虚拟机版本不匹配的问题。具体表现为：虽然通过--evm-version指定了特定版本（如london），但实际提交给验证服务（如Sourcify）的元数据中却显示为另一个版本（如cancun），导致验证失败。

技术背景

Foundry是一个流行的Solidity开发工具套件，其中的forge工具提供了完整的智能合约开发工作流。forge script命令用于执行部署脚本，而--verify选项允许在部署后自动验证合约代码。虚拟机版本指定了合约编译时使用的区块链虚拟机特性集。

问题复现步骤

1. 编写一个使用pragma solidity ^0.8.28;的Solidity合约
2. 使用forge script部署并验证合约：

   forge script <script path> --evm-version london --broadcast --optimize --optimizer-runs 200 --verify --verifier sourcify --verification-url http://localhost:5555
   

3. 观察验证服务接收到的元数据，会发现evmVersion字段被错误地设置为cancun而非指定的london

问题影响

这个bug会导致以下后果：

1. 合约验证失败，影响开发流程
2. 实际部署的合约与验证的合约虚拟机版本不一致，可能产生潜在的安全隐患
3. 开发者需要手动验证合约，降低了开发效率

技术分析

通过对比测试发现：

• 使用forge verify-contract命令时，虚拟机版本参数能正确传递
• 仅在forge script配合--verify选项时会出现版本不匹配
• 问题与合约的pragma声明无关（测试用例中使用的是^0.8.28）

这表明问题出在forge script命令处理验证请求时的元数据生成逻辑中，虚拟机版本参数没有被正确传递到最终的验证请求中。

解决方案建议

对于遇到此问题的开发者，可以采取以下临时解决方案：

1. 使用forge verify-contract命令单独进行验证
2. 手动检查验证服务接收到的元数据
3. 等待Foundry团队发布修复版本

从代码层面来看，修复方向应该是检查forge script命令中验证请求的元数据生成逻辑，确保虚拟机版本参数能够正确传递到最终的验证请求中。

总结

Foundry作为强大的Solidity开发工具，在大多数情况下都能提供流畅的开发体验。这个虚拟机版本验证问题虽然影响不大，但确实会为开发流程带来不便。开发者在使用时应当注意检查验证结果，或者暂时使用替代验证方法。相信Foundry团队会很快修复这个问题，进一步提升工具的可靠性。