Foundry 官方文档中文版

部署

Forge 可以使用 forge create 命令将智能合约部署到指定网络。

Forge 一次只能部署一个合约。

要部署合约，您必须提供 RPC URL（env：ETH_RPC_URL）和部署合约的帐户私钥。

将 MyContract 部署到网络：

$ forge create --rpc-url <your_rpc_url> --private-key <your_private_key> src/MyContract.sol:MyContract
compiling...
success.
Deployer: 0xa735b3c25f...
Deployed to: 0x4054415432...
Transaction hash: 0x6b4e0ff93a...

Solidity 文件可能包含多个合约。上面的 :MyContract 指定了从 src/MyContract.sol 文件部署哪个合约。

使用 --constructor-args 标志将参数传递给构造函数：

// SPDX-License-Identifier: UNLICENSED
pragma solidity ^0.8.0;

import {ERC20} from "solmate/tokens/ERC20.sol";

contract MyToken is ERC20 {
    constructor(
        string memory name,
        string memory symbol,
        uint8 decimals,
        uint256 initialSupply
    ) ERC20(name, symbol, decimals) {
        _mint(msg.sender, initialSupply);
    }
}

此外，我们可以告诉 Forge 在 Etherscan、Sourcify 或 Blockscout 上验证我们的合约（如果网络支持），方法是传递 --verify。

$ forge create --rpc-url <your_rpc_url> \
    --constructor-args "ForgeUSD" "FUSD" 18 1000000000000000000000 \
    --private-key <your_private_key> \
    --etherscan-api-key <your_etherscan_api_key> \
    --verify \
    src/MyToken.sol:MyToken

验证已部署的合约

建议在 forge create 中使用 --verify 标志，以便部署后在 explorer 上自动验证合约。请注意，对于 Etherscan，必须设置 ETHERSCAN_API_KEY。

如果您正在验证已部署的合约，请继续阅读。

您可以使用 forge verify-contract 命令在 Etherscan、Sourcify 或 Blockscout 上验证合约。

您必须提供：

合约地址
合约名称或合约路径 <path>:<contractname>
您的 Etherscan API 密钥（env：ETHERSCAN_API_KEY）（如果在 Etherscan 上验证）。

此外，您可能需要提供：

ABI 编码格式的构造函数参数，如果有的话
编译器版本用于构建，由提交版本前缀的 8 位十六进制数字组成（提交通常不是 nightly 版本）。如果未指定，则会自动检测。
优化次数，如果激活了 Solidity 优化器。如果未指定，则会自动检测。
链 ID，如果合约不在以太坊主网上

假设您想验证 MyToken（见上文）。您将优化次数设置为 100 万，使用 v0.8.10 对其进行编译，并将其部署到如上所示的 Sepolia 测试网（链 ID : 11155111). 请注意，如果在验证时没有设置 --num-of-optimizations 将默认为 0，而如果在部署时没有设置则默认为 200，所以如果你使用默认的编译设置，请确保输入 --num-of-optimizations 200。

验证方法如下：

forge verify-contract \
    --chain-id 11155111 \
    --num-of-optimizations 1000000 \
    --watch \
    --constructor-args $(cast abi-encode "constructor(string,string,uint256,uint256)" "ForgeUSD" "FUSD" 18 1000000000000000000000) \
    --etherscan-api-key <your_etherscan_api_key> \
    --compiler-version v0.8.10+commit.fc410830 \
    <the_contract_address> \
    src/MyToken.sol:MyToken 

Submitted contract for verification:
                Response: `OK`
                GUID: `a6yrbjp5prvakia6bqp5qdacczyfhkyi5j1r6qbds1js41ak1a`
                url: https://sepolia.etherscan.io//address/0x6a54…3a4c#code

建议在使用 verify-contract 命令的同时使用 --watch 标志以便轮询验证结果。

如果未提供 --watch 标志，您可以使用 forge verify-check 命令检查验证状态：

$ forge verify-check --chain-id 11155111 <GUID> <your_etherscan_api_key>
Contract successfully verified.

💡 提示

使用 Cast 的 abi-encode 对参数进行 ABI 编码。

在这个例子中，我们运行了 cast abi-encode "constructor(string,string,uint8,uint256)" "ForgeUSD" "FUSD" 18 1000000000000000000000 来对参数进行 ABI 编码。

故障排除

`Invalid character 'x' at position 1`

确保私钥字符串不以 0x 开头。

`EIP-1559 not activated`

RPC 服务器不支持或未激活 EIP-1559。传递 --legacy 标志以使用旧交易而不是 EIP-1559 交易。如果您在本地环境中进行开发，则可以使用 Hardhat 而不是 Ganache。

`Failed to parse tokens`

确保传递的参数类型正确。

`Signature error`

确保私钥正确。

`Compiler version commit for verify`

如果您想检查您在本地运行的确切提交，请尝试：~/.svm/0.x.y/solc-0.x.y --version 其中 x 和 y 分别是主要和次要版本号。其输出类似于：

solc, the solidity compiler commandline interface
Version: 0.8.12+commit.f00d7308.Darwin.appleclang

注意：您不能只粘贴整个字符串“0.8.12+commit.f00d7308.Darwin.appleclang”作为编译器版本的参数。但是您可以使用提交的 8 位十六进制数字来准确查找您应该从编译器版本复制和粘贴的内容。

已知的问题

验证具有不明确导入路径的合约

Forge 将源目录（src、lib、test 等）作为 --include-path 参数传递给编译器。这意味着给定以下项目树结构

|- src
|-- folder
|--- Contract.sol
|--- IContract.sol

可以使用 folder/IContract.sol 导入路径在 Contract.sol 中导入IContract。

Etherscan 无法重新编译此类源代码。考虑更改导入方式为相对路径。

验证没有字节码哈希的合约

目前，在 Etherscan 上，如果 bytecode_hash 设置为 none，则无法验证合约。单击 here 了解更多关于元数据哈希如何用于源代码验证的信息。

Foundry 中文文档