如何用Solidity判断合约是否运行在zkSync链上foundry-devops的ZkSyncChainChecker详解【免费下载链接】foundry-devops项目地址: https://gitcode.com/gh_mirrors/fo/foundry-devops在 Solidity 开发中让同一个合约兼容以太坊和 zkSync 链并不简单——两者的虚拟机存在差异某些预编译合约和测试行为都不一样。foundry-devops项目中的ZkSyncChainChecker提供了一个开箱即用的抽象合约帮你一行代码判断当前合约是否运行在 zkSync 链上并通过修饰符自动跳过或限定执行非常适合刚接触多链部署的 Solidity 新手。为什么 Solidity 合约要区分 zkSync 链zkSync 是一条 zkEVM 层2链它的执行环境是 EraVM与传统以太坊 EVM 有若干关键差异部分预编译合约缺失如 ripemd1600x03、identity0x04、modexp0x05、ecPairing0x08在 zkSync 上不支持chainId 不同主网为 324、测试网为 300、本地节点为 260测试工具链不同官方推荐的 foundry-zksync 分支与原生 Foundry 的行为尤其是 cheatcodes互不兼容如果你的合约里用到了这些特性直接在 zkSync 上部署就会踩坑。ZkSyncChainChecker源码见src/ZkSyncChainChecker.sol正是为解决这个问题而生。ZkSyncChainChecker 的两种检测方法ZkSyncChainChecker是抽象合约提供两种互补的检测手段全部逻辑集中在 ZkSyncChainChecker.sol 中不到 70 行代码非常易读。方法一通过 chainId 判断isOnZkSyncChainId最直观的方式是检查block.chainid环境chainIdzkSync 主网324zkSync Sepolia 测试网300zkSync 内存节点260命中其中任意一个即判定为 zkSync 链。⚠️ 但要注意这种方式在本地 Foundry 开发环境会失效本地 chainId 通常是 31337所以单独使用并不稳妥。方法二预编译合约探测isOnZkSyncPrecompiles这是更巧妙的行为探测法合约内部用低级别call依次尝试调用 4 个预编译地址——ripemd0x03、identity0x04、modexp0x05、ecPairing0x08。由于这 4 个预编译至少在撰写时都不被 zkSync 支持任何一个调用失败success为 false就可以断定当前运行在 zkSync 上。 这种方法不依赖链 ID因此即便链 ID 被复用在其他环境探测依然可靠但注释中也明确提醒未来如果 zkSync 支持了这些预编译该检测会失效需要升级维护。一步到位isZkSyncChain()两个方法之外合约还封装了统一的入口函数isZkSyncChain()先做 chainId 快速判断若未命中再用预编译探测兜底两种手段组合后判断准确率最高。3 行代码上手skipZkSync 与 onlyZkSync 修饰符对于新手来说最省事的方式是使用它自带的修饰符。只需继承抽象合约就能让函数在 zkSync 上自动跳过或仅在 zkSync 上执行import {ZkSyncChainChecker} from lib/foundry-devops/src/ZkSyncChainChecker.sol; contract MyContract is ZkSyncChainChecker { // 在 zkSync 链上运行时自动跳过 function doStuff() public skipZkSync { // ... } // 只在 zkSync 链上运行时才执行 function onlyOnZkSync() public onlyZkSync { // ... } }这两个修饰符在测试中特别好用——同一套测试用例可以同时跑在以太坊主网 fork 和 zkSync 上不相关的场景会自动跳过并打印日志。快速安装步骤一键引入 foundry-devops在项目根目录执行以下命令即可安装需要已安装 Foundryforge install Cyfrin/foundry-devops --no-commit安装后按 READMEREADME.md建议将lib/forge-std更新到较新版本以使用新的 FS cheatcodes。如果你是贡献者也可以直接克隆仓库进行开发git clone https://gitcode.com/gh_mirrors/fo/foundry-devops cd foundry-devops进阶区分 foundry-zksync 与原生 Foundry除了判断链src/FoundryZkSyncChecker.sol还帮你判断当前跑测试的是哪个 Foundry通过vm.ffi执行forge --version读取版本号forge 0.0.2→ foundry-zksync 分支forge 0.2.0/forge 0.3.0→ 原生 Foundry提供onlyFoundryZkSync和onlyVanillaFoundry两个修饰符⚠️ 使用该功能需在foundry.toml中开启ffi true参考本项目的foundry.toml配置且注意只有以--zksync标志运行 foundry-zksync 时相关函数才可用。运行测试一条命令验证两种环境项目的makefile已准备好常用命令make test # 在原生 foundry 上运行测试 make test-zksync # 在 foundry-zksync 上运行测试测试代码值得一读test/ZkSyncChainCheckerTest.t.sol通过vm.createSelectFork分别 fork 主网和 zkSync 验证 chainId 判断test/ZkSyncChainCheckerLocalTest.t.sol则单独测试本地环境——因为 foundry-zksync 下无法使用vm.selectFork所以需要拆分测试文件。常见限制与注意事项注意点说明不可部署带检测器的合约foundry-zksync 编译到 EraVM 后不识别 cheatcodes会困惑因此带 Checker 的合约只用于测试/脚本场景chainId 法在本地失效本地 anvil 环境 chainId 不是 324/300/260预编译法可能过期zkSync 未来若补齐预编译需更新检测地址需要 ffi 权限FoundryZkSyncChecker 依赖ffi true总结多链开发者的瑞士军刀foundry-devops的ZkSyncChainChecker用不到 70 行代码src/ZkSyncChainChecker.sol就解决了一个经典难题让 Solidity 合约自己感知我跑在 zkSync 上吗。chainId 检查 预编译行为探测的双重保障加上skipZkSync/onlyZkSync修饰符让新手也能轻松写出跨链兼容的测试与脚本。再配合FoundryZkSyncChecker区分测试工具链多链开发的工作流就完整了。【免费下载链接】foundry-devops项目地址: https://gitcode.com/gh_mirrors/fo/foundry-devops创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考