Foundry Book

部署

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> src/MyToken.sol:MyToken \
    --etherscan-api-key <your_etherscan_api_key> \
    --verify

验证预先存在的合约

建议将 --verify 标志与 forge create 一起使用，以在部署后自动验证 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 对其进行编译，并将其部署到如上所示的 Kovan 测试网（链 ID : 42). 请注意，如果未在验证时设置 --num-of-optimizations 将默认为 0，而如果未在部署时设置则默认为 200，因此请确保在离开时通过 --num-of-optimizations 200 默认编译设置。

验证方法如下：

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

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

建议使用 --watch 标志使用 verify-contract 命令轮询验证结果。

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

$ forge verify-check --chain-id 42 <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 编码。

故障排除

`位于 1 处的无效字符 'x'`

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

`EIP-1559 未激活`

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

`无法解析tokens`

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

`签名错误`

确保私钥正确。

`用于验证的编译器版本提交`

如果您想检查您在本地运行的确切提交，请尝试：~/.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 无法重新编译此类源代码。考虑更改导入以使用相对导入路径。

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

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

Foundry 中文