使用Hardhat部署至Moonbeam¶
概览¶
Hardhat是一个以太坊开发环境，可帮助开发人员管理和自动化构建智能合约和DApp所固有的重复性任务。Hardhat可以直接与Moonbeam的以太坊API交互，因此可以在部署智能合约至Moonbeam时使用。
本教程将涵盖如何使用Hardhat在Moonbase Alpha测试网上编译、部署和调试以太坊智能合约。本教程也同样适用于Moonbeam、Moonriver和Moonbeam开发节点。
查看先决条件¶
在开始之前，您将需要准备以下内容：
- 安装MetaMask并将其连接至Moonbase Alpha
- 具有拥有一定数量资金的账户。 您可以每24小时一次从Moonbase Alpha水龙头上获取DEV代币以在Moonbase Alpha上进行测试
- 要在Moonbeam或Moonriver网络上测试本指南中的示例，您可以从受支持的网络端点提供商之一获取您自己的端点和API密钥。
创建Hardhat项目¶
如果您还未有Hardhat项目，您将需要创建一个。为此，您可以执行以下步骤：
-
为您的项目创建一个目录
mkdir hardhat && cd hardhat -
初始化将创建
package.json文件的项目npm init -y -
安装Hardhat
npm install hardhat -
创建项目
npx hardhat注意事项
npx用于运行安装在项目中的本地可执行文件。虽然Hardhat可以全网安装，但是我们建议在每个项目中进行本地安装，这样您可以按项目控制项目版本。 -
系统将会显示菜单，允许您创建新的项目或使用范本项目。在本示例中，您可以选择Create an empty hardhat.config.js
这将在您的项目目录中创建一个Hardhat配置文件（hardhat.config.js）。
Hardhat项目创建完毕后，您可以安装Ethers plugin。这将为使用Ethers.js代码库与网络交互提供一种简便方式。您可以运行以下命令进行安装：
npm install @nomiclabs/hardhat-ethers ethers
合约文件¶
现在您已经创建了一个空白的项目，接下来您可以通过运行以下命令创建一个contracts目录：
mkdir contracts && cd contracts
将要作为示例部署的智能合约被称为Box，这将存储一个数值，用于稍后检索使用。在contracts目录中，您可以创建Box.sol文件：
touch Box.sol
打开文件，并为其添加以下合约内容：
// contracts/Box.sol
pragma solidity ^0.8.1;
contract Box {
uint256 private value;
// Emitted when the stored value changes
event ValueChanged(uint256 newValue);
// Stores a new value in the contract
function store(uint256 newValue) public {
value = newValue;
emit ValueChanged(newValue);
}
// Reads the last stored value
function retrieve() public view returns (uint256) {
return value;
}
}
Hardhat配置文件¶
在部署合约至Moonbase Alpha之前，您将需要修改Hardhat配置文件，并创建一个安全的文件以便您存储私钥。
您可以通过运行以下命令创建一个secrets.json文件以存储您的私钥：
touch secrets.json
接下来将您的私钥添加至文件中：
{
"privateKey": "YOUR-PRIVATE-KEY-HERE"
}
请确保将文件添加至项目的.gitignore中，切勿泄漏您的私钥。
注意事项
请妥善管理您的私钥，使用指定的secret manager或类似管理器。切勿将您的私钥保存或提交至代码库。
接下来您可以遵循以下步骤修改hardhat.config.js文件并将Moonbase Alpha添加为网络：
-
导入Ethers plugin
-
导入
secrets.json文件 -
在
module.exports中，您需要提供Solidity版本（根据我们的合约文件，Solidity版本为0.8.1） -
添加Moonbase Alpha网络配置
// 1. Import the Ethers plugin required to interact with the contract
require('@nomiclabs/hardhat-ethers');
// 2. Import your private key from your pre-funded Moonbase Alpha testing account
const { privateKey } = require('./secrets.json');
module.exports = {
// 3. Specify the Solidity version
solidity: "0.8.1",
networks: {
// 4. Add the Moonbase Alpha network specification
moonbase: {
url: 'https://rpc.api.moonbase.moonbeam.network',
chainId: 1287, // 0x507 in hex,
accounts: [privateKey]
}
}
};
您可以修改hardhat.config.js文件以使用任何Moonbeam网络：
moonbeam: {
url: 'RPC-API-ENDPOINT-HERE', // Insert your RPC URL here
chainId: 1284, // (hex: 0x504),
accounts: [privateKey]
},
moonriver: {
url: 'RPC-API-ENDPOINT-HERE', // Insert your RPC URL here
chainId: 1285, // (hex: 0x505),
accounts: [privateKey]
},
moonbase: {
url: 'https://rpc.api.moonbase.moonbeam.network',
chainId: 1287, // (hex: 0x507),
accounts: [privateKey]
},
dev: {
url: 'http://127.0.0.1:9944',
chainId: 1281, // (hex: 0x501),
accounts: [privateKey]
},
恭喜您！您现在可以开始部署了！
编译Solidity¶
您可以简单运行以下命令编译合约：
npx hardhat compile
编译后，将会创建一个artifacts目录：这保存了合约的字节码和元数据，为.json文件。您可以将此目录添加至您的.gitignore。
部署合约¶
要部署Box.sol智能合约，您将需要撰写一个简单的部署脚本。您可以为此脚本创建一个新目录并命名为scripts，然后为其添加一个名为deploy.js的新文件：
mkdir scripts && cd scripts
touch deploy.js
接下来，您需要通过ethers撰写一个部署脚本。因为您将使用Hardhat运行此脚本，所以您无需导入任何代码库。
要开始操作，您可以执行以下步骤：
-
通过
getContractFactory方法为合约创建一个本地实例 -
使用此实例中存在的
deploy方法来实例化智能合约 -
使用
deployed等待部署 -
部署后，您可以使用合约实例获取合约的地址
// scripts/deploy.js
async function main() {
// 1. Get the contract to deploy
const Box = await ethers.getContractFactory('Box');
console.log('Deploying Box...');
// 2. Instantiating a new Box smart contract
const box = await Box.deploy();
// 3. Waiting for the deployment to resolve
await box.deployed();
// 4. Use the contract instance to get the contract address
console.log('Box deployed to:', box.address);
}
main()
.then(() => process.exit(0))
.catch((error) => {
console.error(error);
process.exit(1);
});
您现在可以使用run命令并指定moonbase作为网络来部署Box.sol合约：
npx hardhat run --network moonbase scripts/deploy.js
如果您正在使用另一个Moonbeam网络，请确保您已指定正确的网络。网络名称需要与hardhat.config.js中所定义的网络相匹配。
稍等片刻，合约将成功部署，您可以在终端看到合约地址。
恭喜您，您的合约已完成！请保存地址，用于后续与合约实例的交互。
与合约交互¶
要在Moonbase Alpha上与您刚部署的合约交互，您可以通过运行以下命令启动Hardhat console：
npx hardhat console --network moonbase
接下来，您可以执行以下步骤（一次输入一行）：
-
创建一个
Box.sol合约的本地实例const Box = await ethers.getContractFactory('Box'); -
使用合约地址，将本地实例连接至已部署的合约
const box = await Box.attach('0x425668350bD782D80D457d5F9bc7782A24B8c2ef'); -
与此合约交互。在本示例中，您可以调用
store方法并存储一个简单的值await box.store(5)
交易将通过您的Moonbase账户进行签署并传送至网络。后台输出将如下所示：
请注意您的地址将被标记为from，即合约地址，以及正在传送的data。现在，您可以通过运行以下命令来检索数值：
(await box.retrieve()).toNumber()
您将看到5或者您初始存储的数值。
恭喜您，您已经成功使用Hardhat部署合约并与之交互。
| Created: March 21, 2022