Skip to content

使用Foundry部署合约至Moonbeam

概览

Foundry是一个用Rust语言编写的以太坊部署环境,能够帮助开发者管理依赖项、编译项目、运行测试、部署合约以及从命令行与区块链交互。Foundry可以直接与Moonbeam的以太坊API交互,所以可以直接用于将智能合约部署至Moonbeam。

Foundry由四个工具组成:

  • Forge - 编译、测试和部署合约
  • Cast - 用于与合约交互的命令行界面
  • Anvil - 用于开发目的的本地测试节点,可分叉预先存在的网络
  • Chisel - 用于快速测试Solidity片段的Solidity REPL(交互式编程环境)

本教程将涵盖如何使用Foundry在Moonbase Alpha TestNet上编译、部署和调试以太坊智能合约。此教程同样适用于Moonbeam、Moonriver和Moonbeam开发节点。

查看先决条件

开始之前,您将需要准备以下内容:

  • 拥有资金的账户。 您可以每24小时一次从Moonbase Alpha水龙头上获取DEV代币以在Moonbase Alpha上进行测试
  • 要在Moonbeam或Moonriver网络上测试本指南中的示例,您可以从受支持的网络端点提供商之一获取您自己的端点和API密钥
  • 提前安装Foundry

创建Foundry项目

如果您尚未拥有Foundry项目,您需要通过以下步骤创建一个:

  1. 如果您尚未安装,您需要先安装Foundry。如果您在Linux或MacOS系统操作,您可以运行以下命令:

    curl -L https://foundry.paradigm.xyz | bash
    foundryup
    

    如果在Windows系统操作,您必须安装Rust,然后从源代码构建Foundry:

    curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs/ | sh
    cargo install --git https://github.com/foundry-rs/foundry foundry-cli anvil --bins --locked
    
  2. 创建项目,这将创建一个文件夹并打开它,其中包含三个文件夹,:

    forge init foundry && cd foundry
    

创建默认项目后,您将看到以下三个文件夹:

  • lib - 项目所有的依赖项以git子模块的形式
  • src - 用于存放智能合约(以及功能)
  • test - 用于存放项目的Forge测试,这些测试是用Solidity编写的

除了这三个文件夹,还将创建一个git项目以及一个预先编写的.gitignore文件,其中相关文件类型和文件夹被忽略。

源代码文件夹

src文件夹可能已经包含Counter.sol(一个最小的Solidity合约),您可以自行删除此合约。同时为了避免可能出现的报错,您也需要删除 scripts 文件夹中的 Counter.s.sol 以及 test 文件夹中的 Counter.t.sol. 下一步您需要部署一个ERC-20合约。在合约目录中,您可以创建一个MyToken.sol文件:

cd src
touch MyToken.sol

打开文件并添加以下合约:

pragma solidity ^0.8.0;

// Import OpenZeppelin Contract
import "@openzeppelin/contracts/token/ERC20/ERC20.sol";

// This ERC-20 contract mints the specified amount of tokens to the contract creator
contract MyToken is ERC20 {
    constructor(uint256 initialSupply) ERC20("MyToken", "MYTOK") {
        _mint(msg.sender, initialSupply);
    }
}

在尝试编译合约之前,您需要安装OpenZeppelin合约作为依赖项。您可能需要先将以前的更改提交到git。默认情况下,Foundry使用git子模块而非npm程序包,因此没有使用传统的npm导入路径和命令。相反,使用OpenZeppelin GitHub repository的名称。

forge install OpenZeppelin/openzeppelin-contracts

编译Solidity

安装完所有的依赖项后,您可以开始编译合约:

forge build
forge build [⠒] Compiling... [⠰] Compiling 30 files with 0.8.23 [⠔] Solc 0.8.23 finished in 2.29s Compiler run successful!

编译完成后,将创建两个文件夹:outcache。您合约的ABI和字节码将包含在out文件夹中。这两个文件夹已被默认Foundry项目初始化中包含的.gitignore忽略。

部署合约

Foundry提供两种主要合约部署方式。第一种方法比较直接,是使用命令forge create;第二种更为灵活和强大,是使用Foundry脚本,该脚本会在任何部署之前运行模拟。以下部分将分别介绍forge create和 Foundry脚本这两种方法。

使用 Forge Create

使用forge create来部署合约只需一个命令,但您必须包含一个RPC端点、一个拥有资产的私钥和构造函数参数。MyToken.sol在其构造函数中要求提供初始代币供应量,因此以下的命令都包含100作做为一个构造参数。您可以使用以下命令部署MyToken.sol合约至正确网络的:

forge create --rpc-url INSERT_RPC_API_ENDPOINT \
--constructor-args 100 \
--private-key YOUR_PRIVATE_KEY \
src/MyToken.sol:MyToken
forge create --rpc-url INSERT_RPC_API_ENDPOINT \
--constructor-args 100 \
--private-key YOUR_PRIVATE_KEY \
src/MyToken.sol:MyToken
forge create --rpc-url https://rpc.api.moonbase.moonbeam.network \
--constructor-args 100 \
--private-key YOUR_PRIVATE_KEY \
src/MyToken.sol:MyToken
forge create --rpc-url http://127.0.0.1:9944 \
--constructor-args 100 \
--private-key YOUR_PRIVATE_KEY \
src/MyToken.sol:MyToken

部署合约后几秒钟,您应该会在终端看到合约地址。

forge create --rpc-url https://rpc.api.moonbase.moonbeam.network \ --constructor-args 100 \ --private-key INSERT_PRIVATE_KEY \ src/MyToken.sol:MyToken
[⠒] Compiling... No files changed, compilation skipped Deployer: 0x3B939FeaD1557C741Ff06492FD0127bd287A421e Deployed to: 0xc111402Aa1136ff6224106709ae51864512eC68f Transaction hash: 0xd77fc26aa296e81f35718b5878cda98e8371f6bf33b0f57e7d92997a36cf6465

恭喜!您的合约已部署成功!请保存该地址,您将在下一步中使用它与该合约实例进行交互。

使用Solidity脚本部署

Solidity脚本是一种比 forge create 更强大、更灵活的合约部署方式。 编写Solidity脚本与编写普通的Solidity智能合约相同,但您永远不会部署此脚本。

您可以使用各种参数定制forge script的行为。除了本地模拟(这是每次运行的必要部分)之外,所有组件都是可选的。forge script命令将按照以下顺序尝试执行所有步骤:

  1. Local simulation - 在本地EVM中模拟交易
  2. Onchain simulation - 通过提供的RPC URL模拟交易
  3. Broadcasting - 当提供 --broadcast 标志并且模拟成功时,交易将被发送
  4. Verification - 当提供 --verify 标志和有效API密钥时,进行基于API的智能合约验证

现在开始编写脚本。在脚本文件夹中,创建一个名为 MyToken.s.sol 的文件。复制并粘贴以下文件的内容:

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

import "forge-std/Script.sol";
import "../src/MyToken.sol";

contract MyScript is Script {
    function run() external {
        uint256 deployerPrivateKey = INSERT_PRIVATE_KEY;
        vm.startBroadcast(deployerPrivateKey);

        MyToken mytoken = new MyToken(1000000000);

        vm.stopBroadcast();
    }
}

请记住

请记住永远不要像上面那样将生产私钥存储在文件中。 这个例子仅用于演示目的。

请注意,即使上述脚本不会被部署,它仍需要符合典型Solidity合约的所有格式,例如pragma语句。

您可以使用以下命令部署 MyToken.sol 合约。请记住它将按顺序执行所有相关步骤。对于此示例,Foundry将首先尝试本地模拟和利用提供的 RPC进行模拟,然后才部署合约。如果任何模拟失败,Foundry都不会继续部署。

forge script script/MyToken.s.sol --rpc-url https://rpc.api.moonbase.moonbeam.network --broadcast

如果您的脚本执行成功,您的终端应展示一下内容:

forge script script/MyToken.s.sol --rpc-url https://rpc.api.moonbase.moonbeam.network --broadcast [⠒] Compiling... Script ran successfully. EIP-3855 is not supported in one or more of the RPCs used. Unsupported Chain IDs: 1287. Contracts deployed with a Solidity version equal or higher than 0.8.20 might not work properly. For more information, please see https://eips.ethereum.org/EIPS/eip-3855 ## Setting up 1 EVM. ==========================
Chain 1287 Estimated gas price: 3.25 gwei Estimated total gas used for script: 1346155 Estimated amount required: 0.00437500375 ETH ==========================
Finding wallets for all the necessary addresses... Sending transactions [0 - 0]. ⠁ [00:00:00] [#################################################] 1/1 txes (0.0s) Waiting for receipts. ⠉ [00:00:25] [#############################################] 1/1 receipts (0.0s) ##### moonbase
✅ [Success]Hash: 0x95766ca2c8bc94171f9de783652d62468f004d686eb5ab82b3546774eee301bc Contract Address: 0x2A19aD12E9e8479207B78c39f5bCc848D386b9DA Block: 5881522 Paid: 0.00309613125 ETH (990762 gas * 3.125 gwei) ONCHAIN EXECUTION COMPLETE & SUCCESSFUL. Total Paid: 0.00309613125 ETH (990762 gas * avg 3.125 gwei) Transactions saved to: /Users/ubuntu-jammy/foundry/foundry/broadcast/MyToken.s.sol/1287/run-latest.json Sensitive values saved to: /Users/ubuntu-jammy/foundry/foundry/cache/MyToken.s.sol/1287/run-latest.json

这样就成了。有关使用Foundry进行Solidity脚本编写的更多信息,请查看Foundry文档

与合约交互

Foundry包括cast,一个用于执行以太坊RPC调用的CLI。

尝试使用Cast检索Token名称,其中INSERT_YOUR_CONTRACT_ADDRESS是您在上一部分部署合约的地址:

cast call INSERT_YOUR_CONTRACT_ADDRESS "name()" --rpc-url INSERT_RPC_API_ENDPOINT
cast call INSERT_YOUR_CONTRACT_ADDRESS "name()" --rpc-url INSERT_RPC_API_ENDPOINT
cast call INSERT_YOUR_CONTRACT_ADDRESS "name()" --rpc-url https://rpc.api.moonbase.moonbeam.network
cast call INSERT_YOUR_CONTRACT_ADDRESS "name()" --rpc-url http://127.0.0.1:9944

您需要获取此数据的hex格式:

0x000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000074d79546f6b656e00000000000000000000000000000000000000000000000000

此数据非可读,但您可以使用Cast将其转换成您想要的格式。在这种情况下,数据是文本,因此您可以将其转换为ASCII字符以查看“My Token”:

cast --to-ascii 0x000000000000000000000000000000000000000000000000000000000000002000 000000000000000000000000000000000000000000000000000000000000074d7954 6f6b656e00000000000000000000000000000000000000000000000000
MyToken
cast --to-ascii 0x000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000074d79546f6b656e00000000000000000000000000000000000000000000000000

您也可以使用cast来改变数据。通过将其发送到0地址来尝试销毁Token。

cast send --private-key YOUR_PRIVATE_KEY \
--rpc-url INSERT_RPC_API_ENDPOINT \
--chain 1284 \
YOUR_CONTRACT_ADDRESS \
"transfer(address,uint256)" 0x0000000000000000000000000000000000000001 1
cast send --private-key YOUR_PRIVATE_KEY \
--rpc-url INSERT_RPC_API_ENDPOINT \
--chain 1285 \
YOUR_CONTRACT_ADDRESS \
"transfer(address,uint256)" 0x0000000000000000000000000000000000000001 1
cast send --private-key YOUR_PRIVATE_KEY \
--rpc-url https://rpc.api.moonbase.moonbeam.network \
--chain 1287 \
YOUR_CONTRACT_ADDRESS \
"transfer(address,uint256)" 0x0000000000000000000000000000000000000001 1
cast send --private-key YOUR_PRIVATE_KEY \
--rpc-url http://127.0.0.1:9944 \
--chain 1281 \
YOUR_CONTRACT_ADDRESS \
"transfer(address,uint256)" 0x0000000000000000000000000000000000000001 1

交易将由您的Moonbase账户签署并传播到网络。输出应如下所示:

cast send --private-key INSERT_PRIVATE_KEY \ --rpc-url https://rpc.api.moonbase.moonbeam.network \ --chain 1287 \ INSERT_CONTRACT_ADDRESS \ "transfer(address,uint256)" 0x0000000000000000000000000000000000000001 1

blockHash 0x6f99fac1bb49feccb7b0476e0ffcd3cef4c456aa9111e193ce11c7a1ab62314e blockNumber 5892860 contractAddress cumulativeGasUsed 51332 effectiveGasPrice 3125000000 gasUsed 51332 logs [{"address":"0xc111402aa1136ff6224106709ae51864512ec68f","topics":["0xddf252ad1be2c89b69 c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef", "0x0000000000000000000000003b939fead155 7c741ff06492fd0127bd287a421e", "0x0000000000000000000000000000000000000000000000000000000000000001"], "data":"0x0000000000000000000000000000000000000 000000000000000000000000001", "blockHash":"0x6f99fac1bb49feccb7b0476e0ffcd3cef4c4 56aa9111e193ce11c7a1ab62314e", "blockNumber":"0x59eafc", "transactionHash":"0xdd5f11be68d5 2967356ccf34b9a4b2632d0d5ac8932ff27e72c544320dec33e3", "transactionIndex":"0x0","logIndex":"0x0","transactionLogIndex":"0x0","removed":false}] logsBloom 0x000000000000000000000000000000000000000000000000000000000000000000000000000000004 00000000000000000000000000000000000000000040000000000000000000000000008000000000000 00000004000000000000000000000000000000000000000100000000000000000000000000000000001 00000010000000000000000000000000000000000000000000000000000000002000000040000000000 00000000000000000000000000000000000000000000000000000000002000000000000000000000000 00000000000000000000000000004000000000000000000000000000000000000000000000000000000 0001000000 root status 1 transactionHash 0xdd5f11be68d52967356ccf34b9a4b2632d0d5ac8932ff27e72c544320dec33e3 transactionIndex 0 type 2

恭喜您!您已成功使用Foundry部署和交互合约!

使用Anvil进行分叉

如上所述,Anvil是用于开发目的的本地测试网节点,可以分叉预先存在的网络。分叉Moonbeam允许用户与部署在网络上的实时合约交互。

使用Anvil分叉时需要注意一些限制。由于Anvil是基于EVM实现,因此您无法与任何Moonbeam已编译的合约及其功能交互。预编译是Substrate实现的一部分,因此无法在模拟的EVM环境中复制。从而,您无法与在Moonbeam上的跨链资产和基于Substrate的功能(如质押和治理)进行交互。

要分叉Moonbeam或Moonriver,您将需要用到您的端点和API钥匙,您可通过支持的端点提供商获取。

要从命令行分叉Moonbeam,您可以在Foundry项目的目录中运行以下命令:

anvil --fork-url INSERT_RPC_API_ENDPOINT
anvil --fork-url INSERT_RPC_API_ENDPOINT
anvil --fork-url https://rpc.api.moonbase.moonbeam.network

分叉的实例将拥有10个已经预先注资10,000测试Token的开发账户。分叉的实例位于http://127.0.0.1:8545/。终端输出应类似于以下内容:

anvil --fork-url https://rpc.api.moonbase.moonbeam.network

Available Accounts ================== (0) "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266" (10000.000000000000000000 ETH) (1) "0x70997970C51812dc3A010C7d01b50e0d17dc79C8" (10000.000000000000000000 ETH) (2) "0x3C44CdDdB6a900fa2b585dd299e03d12FA4293BC" (10000.000000000000000000 ETH) (3) "0x90F79bf6EB2c4f870365E785982E1f101E93b906" (10000.000000000000000000 ETH) (4) "0x15d34AAf54267DB7D7c367839AAf71A00a2C6A65" (10000.000000000000000000 ETH) (5) "0x9965507D1a55bcC2695C58ba16FB37d819B0A4dc" (10000.000000000000000000 ETH) (6) "0x976EA74026E726554dB657fA54763abd0C3a0aa9" (10000.000000000000000000 ETH) (7) "0x14dC79964da2C08b23698B3D3cc7Ca32193d9955" (10000.000000000000000000 ETH) (8) "0x23618e81E3f5cdF7f54C3d65f7FBc0aBf5B21E8f" (10000.000000000000000000 ETH) (9) "0xa0Ee7A142d267C1f36714E4a8F75612F20a79720" (10000.000000000000000000 ETH)
Private Keys ================== (0) 0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80 (1) 0x59c6995e998f97a5a0044966f0945389dc9e86dae88c7a8412f4603b6b78690d (2) 0x5de4111afa1a4b94908f83103eb1f1706367c2e68ca870fc3fb9a804cdab365a (3) 0x7c852118294e51e653712a81e05800f419141751be58f605c371e15141b007a6 (4) 0x47e179ec197488593b187f80a00eb0da91f1b9d0b13f8733639f19c30a34926a (5) 0x8b3a350cf5c34c9194ca85829a2df0ec3153be0318b5e2d3348e872092edffba (6) 0x92db14e403b83dfe3df233f83dfa3a0d7096f21ca9b0d6d6b8d88b2b4ec1564e (7) 0x4bbbf85ce3377467afe5d46f804f221813b2bb87f24d81f60f1fcdbf7cbf4356 (8) 0xdbda1821b80551c9d65939329250298aa3472ba22feea921c0cf5d620ea67b97 (9) 0x2a871d0798f97d79848a013d4936a73bf4cc922c825d33c1cf7073dff6d409c6
Wallet ================== Mnemonic: test test test test test test test test test test test junk Derivation path: m/44'/60'/0'/0/
Fork ================== Endpoint: https://rpc.api.moonbase.moonbeam.network Block number: 5892944 Block hash: 0xc9579299f55d507c305d5357d4c1b9d9c550788ddb471b0231d8d0146e7144b7 Chain ID: 1287
Base Fee ================== 125000000
Gas Limit ================== 30000000
Genesis Timestamp ================== 1705278817
Listening on 127.0.0.1:8545

要验证您是否已分叉了网络,您可以查询最新的区块号:

curl --data '{"method":"eth_blockNumber","params":[],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545 

如果您已经将result从16进制转换成十进制,您应该在分叉网络时获得了最新区块号。您可以使用区块浏览器交叉查询区块号。

从这里,您可以将新合约部署到您的Moonbeam的分叉实例或与已部署的合约进行交互。在本教程的上述示例的基础上,您可以使用Cast进行调用,来检查您部署合约的帐户中铸造的MYTOK Token的余额:

cast call INSERT_CONTRACT_ADDRESS  "balanceOf(address)(uint256)" INSERT_YOUR_ADDRESS --rpc-url http://localhost:8545

使用Chisel

Chisel是一个Solidity REPL,或shell。它允许开发者直接在控制台中编写Solidity以测试比较小的代码片段,让开发者跳过项目设置和合约部署步骤,实现快速的操作流程。

由于Chisel主要用于快速测试,因此可以用于Foundry以外的项目。但是,如果在Foundry项目内执行,在运行时会将配置保留在foundry.toml中。

在本示例中,您将在Solidity中测试一些abi的功能。因为其相对比较复杂可以很好地演示Chisel的作用。要开始使用Chisel,请在命令行中运行以下命令以启动Chisel shell:

chisel

在Chisel shell中,您可以像在函数中运行一样编写Solidity代码:

bytes memory myData = abi.encode(100, true, "Develop on Moonbeam");

假设您对abi如何编码数据感兴趣,因为您正在研究如何最有效地将数据存储在区块链上,从而节省gas费用。要查看myData是如何存储在内存中的,您可以在Chisel shell中使用以下命令:

!memdump

memdump将显示当前会话中的所有数据。您可能会看到类似下面这样的内容。如果您不熟悉hex格式或者ABI编码的工作原理,那么您可能无法找到myData变量的存储位置。

chisel
Welcome to Chisel! Type `!help` to show available commands. bytes memory myData = abi.encode(100, true, "Develop on Moonbeam");
!memdump [0x00:0x20]: 0x0000000000000000000000000000000000000000000000000000000000000000 [0x20:0x40]: 0x0000000000000000000000000000000000000000000000000000000000000000 [0x40:0x60]: 0x0000000000000000000000000000000000000000000000000000000000000140 [0x60:0x80]: 0x0000000000000000000000000000000000000000000000000000000000000000 [0x80:0xa0]: 0x00000000000000000000000000000000000000000000000000000000000000a0 [0xa0:0xc0]: 0x0000000000000000000000000000000000000000000000000000000000000064 [0xc0:0xe0]: 0x0000000000000000000000000000000000000000000000000000000000000001 [0xe0:0x100]: 0x0000000000000000000000000000000000000000000000000000000000000060 [0x100:0x120]: 0x0000000000000000000000000000000000000000000000000000000000000013 [0x120:0x140]: 0x446576656c6f70206f6e204d6f6f6e6265616d00000000000000000000000000

幸运的是,Chisel会轻松帮您找到这些信息存储位置。使用!rawstack命令,您可以找到变量值在栈中的位置。

!rawstack myData

在此情况下,因为字节的长度超过32个字节,因此将显示内存指针。这样您已经从!memdump命令了解了整个栈。

chisel
Welcome to Chisel! Type `!help` to show available commands. bytes memory myData = abi.encode(100, true, "Develop on Moonbeam");
!memdump [0x00:0x20]: 0x0000000000000000000000000000000000000000000000000000000000000000 [0x20:0x40]: 0x0000000000000000000000000000000000000000000000000000000000000000 [0x40:0x60]: 0x0000000000000000000000000000000000000000000000000000000000000140 [0x60:0x80]: 0x0000000000000000000000000000000000000000000000000000000000000000 [0x80:0xa0]: 0x00000000000000000000000000000000000000000000000000000000000000a0 [0xa0:0xc0]: 0x0000000000000000000000000000000000000000000000000000000000000064 [0xc0:0xe0]: 0x0000000000000000000000000000000000000000000000000000000000000001 [0xe0:0x100]: 0x0000000000000000000000000000000000000000000000000000000000000060 [0x100:0x120]: 0x0000000000000000000000000000000000000000000000000000000000000013 [0x120:0x140]: 0x446576656c6f70206f6e204d6f6f6e6265616d00000000000000000000000000 !rawstack myData
Type: bytes32 └ Data: 0x0000000000000000000000000000000000000000000000000000000000000080

!rawstack命令显示myData变量存储在0x80中,与从!memdump命令检索到的内存内容对比时,看起来myData存储如下所示:

[0x80:0xa0]: 0x00000000000000000000000000000000000000000000000000000000000000a0
[0xa0:0xc0]: 0x0000000000000000000000000000000000000000000000000000000000000064
[0xc0:0xe0]: 0x0000000000000000000000000000000000000000000000000000000000000001
[0xe0:0x100]: 0x0000000000000000000000000000000000000000000000000000000000000060
[0x100:0x120]: 0x0000000000000000000000000000000000000000000000000000000000000013
[0x120:0x140]: 0x446576656c6f70206f6e204d6f6f6e6265616d00000000000000000000000000

乍一看数据很合理,因为0xa0的值0x64等于100,0xc0的值0x01等于true。如果您想要了解ABI编码的工作原理,请参考ABI的Solidity文档。在本示例中,这种数据打包方式有很多个零,因此作为智能合约开发者,您可以尝试使用结构或者bitwise(按位)代码更有效地将数据打包在一起。

由于您已经完成这段代码,您可以清除Chisel的状态,以防止其干扰您想要尝试的任何未来逻辑(在运行相同的Chisel实例时):

!clear

测试Chisel还有一个更简单的方式。当编写以分号(;)结尾的代码时,Chisel将其作为一个语句来运行,并将其值存储在Chisel的Runtime(运行时)状态中。但是,如果您真的只需要查看ABI编码数据的表示方式,那么您可以将代码作为表达式运行。要使用相同的abi示例进行尝试,请在Chisel shell中编写以下内容:

abi.encode(100, true, "Develop on Moonbeam")

您应该看到如下所示输出:

!clear Cleared session! abi.encode(100, true, "Develop on Moonbeam") Type: dynamic bytes ├ Hex (Memory): ├─ Length ([0x00:0x20]): 0x00000000000000000000000000000000000000000000000000000000000000a0 ├─ Contents ([0x20:..]): 0x0000000000000000000000000000000000000000000000000000000000000064 0000000000000000000000000000000000000000000000000000000000000001 0000000000000000000000000000000000000000000000000000000000000060 0000000000000000000000000000000000000000000000000000000000000001 34446576656c6f70206f6e204d6f6f6e6265616d00000000000000000000000000 ├ Hex (Tuple Encoded): ├─ Pointer ([0x00:0x20]): 0x0000000000000000000000000000000000000000000000000000000000000020 ├─ Length ([0x20:0x40]): 0x00000000000000000000000000000000000000000000000000000000000000a0 └─ Contents ([0x40:..]): 0x0000000000000000000000000000000000000000000000000000000000000064 0000000000000000000000000000000000000000000000000000000000000001 0000000000000000000000000000000000000000000000000000000000000060 0000000000000000000000000000000000000000000000000000000000000001 34446576656c6f70206f6e204d6f6f6e6265616d00000000000000000000000000

虽然它没有以相同的方式显示数据,但您仍然可以获得数据的内容,并且它还进一步分解了信息的编码方式,例如让您知道0xa0值定义了数据长度。

默认情况下,当您离开Chisel shell时,不会保留任何数据。但是你可以通过指示chisel进行操作。 例如,您可以执行以下步骤存储一个变量:

  1. 在Chisel中存储uint256

    uint256 myNumber = 101;
    
  2. 使用!save存储会话。在本示例中,您可以使用数字1作为存储ID

    !save 1
    
  3. 退出对话

    !quit
    

然后,要查看并与您存储的Chisel状态进行交互,您可以执行以下步骤:

  1. 查看存储的Chisel状态列表

    chisel list
    
  2. 加载存储的状态

    chisel load 1
    
  3. 查看上一组步骤中保存在Chisel中的uint256

    !rawstack myNumber
    
uint256 myNumber = 101; !save 1 Saved session to cache with ID = 1 !quit chisel list ⚒️ Chisel Sessions ├─ "2024-01-15 01:17:34" - chisel-1.json chisel load 1 Welcome to Chisel! Type `!help` to show available commands. !rawstack myNumber Type: bytes32 └ Data: 0x0000000000000000000000000000000000000000000000000000000000000065

您甚至可以在使用Chisel时分叉网络:

!fork https://rpc.api.moonbase.moonbeam.network

然后,例如,您可以查询其中一个Moonbase Alpha收集人的余额:

0x12E7BCCA9b1B15f33585b5fc898B967149BDb9a5.balance
!fork https://rpc.api.moonbase.moonbeam.network Set fork URL to https://rpc.api.moonbase.moonbeam.network 0x12E7BCCA9b1B15f33585b5fc898B967149BDb9a5.balance Type: uint ├ Hex: 0x000000000000000000000000000000000000000000000358affd3d76ebb78555 └ Decimal: 15803094286802091476309

如果您想要获取关于Chisel的更多信息,请下载Foundry并参考其官方页面

通过Hardhat使用Foundry

通常,您希望集成的项目的所有设置都在Hardhat中,因此将整个项目转换为Foundry是一项艰巨的任务。通过创建同时使用Hardhat和Foundry功能的混合项目,可以避免这项额外的工作。这可以通过Hardhat的hardhat-foundry插件来实现。

要将预先存在的Foundry项目转换成混合项目,您需要先在同一个文件夹中安装Hardhat项目:

npm init
npm install --save-dev hardhat @nomicfoundation/hardhat-foundry
npx hardhat init

更多信息,请参考创建Hardhat项目的文档。

初始化新的Hardhat项目后,将会出现一些新的文件夹和文件:contractshardhat.config.jsscriptstest/Lock.js。您只需稍微调整即可创建一个混合项目:

  1. 在Repo中编辑hardhat.config.js文件。打开后,在头部添加下方指令:

    require("@nomicfoundation/hardhat-foundry");
    

    添加hardhat-foundry插件后,Hardhat的contracts文件夹将失效,因为现在Hardhat期望所有智能合约都存储在Foundry的src文件夹中

  2. contracts文件夹中的所有智能合约移至src文件夹,然后删除contracts文件夹

  3. 编辑foundry.toml文件以确保通过Git子模块和npm安装的依赖项可以由Forge工具编译。编辑profile.default以确保libs条目同时具有libnode_modules

    [profile.default]
    src = 'src'
    out = 'out'
    libs = ['lib', 'node_modules']
    solc = '0.8.20'
    evm_version = 'london'
    

现在,无论依赖关系如何,forge buildnpx hardhat compile都应该可以工作。 forge testnpx hardhat test现在应该能够访问所有智能合约和依赖项。forge test将仅用于Solidity测试,而npx Hardhat test将仅用于JavaScript测试。如果您想结合使用它们,那么您可以在package.json文件中创建一个新脚本:

"scripts": {
    "test": "npx hardhat test && forge test"
}

您可以运行以下指令:

npm run test

最后,虽非必要,但可以将所有JavaScript脚本从scripts文件夹移动到Foundry的script文件夹中,并删除scripts文件夹,这样就不会出现两个具有相同用途的文件夹。

本网站的所有信息由第三方提供,仅供参考之用。Moonbeam文档网站(https://docs.moonbeam.network/)上列出和描述的任何项目与Moonbeam立场无关。Moonbeam Foundation不保证网站信息的准确性、完整性或真实性。如使用或依赖本网站信息,需自行承担相关风险,Moonbeam Foundation不承担任何责任和义务。这些材料的所有陈述和/或意见由提供方个人或实体负责,与Moonbeam Foundation立场无关,概不构成任何投资建议。对于任何特定事项或情况,应寻求专业权威人士的建议。此处的信息可能会包含或链接至第三方提供的信息与/或第三方服务(包括任何第三方网站等)。这类链接网站不受Moonbeam Foundation控制。Moonbeam Foundation对此类链接网站的内容(包括此类链接网站上包含的任何信息或资料)概不负责也不认可。这些链接内容仅为方便访客而提供,Moonbeam Foundation对因您使用此信息或任何第三方网站或服务提供的信息而产生的所有责任概不负责。
Last update: May 14, 2024
| Created: August 18, 2022