使用Foundry调用Etherscan API遇「缺失/无效API密钥」错误求助

问题描述 #

使用forge clone命令克隆以太坊主网WETH合约（地址0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2）时，尽管已在项目根目录的foundry.toml中配置了在其他工具可正常使用的Etherscan API密钥，却持续收到Missing/Invalid API Key错误。

执行的命令：

forge clone 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2 WETH9

foundry.toml相关配置：

[etherscan]
  mainnet = { key = "my_actual_api_key_here" }

项目通过克隆foundry-template仓库初始化，已尝试重新生成API密钥、检查配置格式等操作，问题仍未解决。

可行解决思路 #

1. 优先使用环境变量测试 #

Foundry会优先读取环境变量ETHERSCAN_API_KEY，而非配置文件中的值。可临时设置环境变量验证是否生效：

ETHERSCAN_API_KEY=你的有效密钥 forge clone 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2 WETH9

如果生效，将环境变量写入shell配置文件（如~/.bashrc或~/.zshrc）长期生效：

export ETHERSCAN_API_KEY=你的有效密钥

2. 确认foundry.toml的位置与格式 #

• 确保foundry.toml在执行forge clone命令的当前目录下；
• 检查toml缩进格式，mainnet配置需缩进2个空格（或统一使用制表符），避免格式错误导致配置未被读取：

[etherscan]
  mainnet = { key = "你的有效密钥" }

3. 更新Foundry至最新版本 #

旧版本可能存在Etherscan API交互bug，执行更新命令：

foundryup

更新完成后重新尝试克隆操作。

4. 显式指定Etherscan API端点 #

若存在端点解析问题，可在foundry.toml中直接指定主网API URL：

[etherscan]
  mainnet = { key = "你的有效密钥", url = "https://api.etherscan.io/api" }

5. 验证API密钥权限 #

登录Etherscan后台确认密钥的权限状态，确保未被限制访问合约源码相关的API端点（默认密钥权限足够，但可排查是否存在异常限制）。

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