部署智能合约并与之交互 - OpenZeppelin 文档

部署和交互智能合约

与大多数软件不同，智能合约不是在你的计算机或某人的服务器上运行：它们存在于以太坊网络本身。这意味着与它们的交互与更传统的应用程序略有不同。

本指南将涵盖你开始使用合约所需了解的一切，包括：

• 设置本地区块链

• 部署智能合约

• 从控制台交互

• 以编程方式交互

设置本地区块链

在我们开始之前，我们首先需要一个可以部署合约的环境。以太坊区块链（通常被称为“主网”，即“主网络”）需要花费真金白银才能使用它，以 Ether（其原生货币）的形式。这使得它在尝试新想法或工具时成为一个糟糕的选择。

为了解决这个问题，存在许多“测试网”（即“测试网络”）：这些包括 Sepolia 和 Holesky 区块链。它们的工作方式与主网非常相似，但有一个区别：你可以免费获得这些网络的 Ether，因此使用它们不需要你花费一分钱。但是，你仍然需要处理私钥管理、12 秒或更长的区块时间和实际获取这些免费的 Ether。

在开发过程中，最好使用本地区块链。它在你的机器上运行，不需要互联网访问，为你提供所需的所有 Ether，并立即挖掘区块。这些原因也使本地区块链非常适合自动化测试。

Hardhat 自带一个内置的本地区块链，即 Hardhat Network。

启动后，Hardhat Network 将创建一组未锁定的账户并为其提供 Ether。

$ npx hardhat node

Hardhat Network 将打印出其地址 http://127.0.0.1:8545，以及可用账户列表及其私钥。

请记住，每次运行 Hardhat Network 时，它都会创建一个全新的本地区块链——不保留先抢跑的状态。这对于短期的实验来说是可以的，但这意味着你需要打开一个窗口运行 Hardhat Network 才能完成这些指南。

部署智能合约

在开发智能合约指南中，我们设置了我们的开发环境。

如果你还没有完成此设置，请创建并设置项目，然后创建并编译我们的 Box 智能合约。

在完成项目设置后，我们现在可以部署合约了。我们将部署来自开发智能合约指南的 Box。请确保你在 contracts/Box.sol 中有一个 Box 的副本。

Hardhat 使用声明式部署或脚本来部署合约。

我们将创建一个脚本来部署我们的 Box 合约。我们将此文件另存为 scripts/deploy.js。

// scripts/deploy.js
async function main () {
  // We get the contract to deploy
  // 我们获取要部署的合约
  const Box = await ethers.getContractFactory('Box');
  console.log('Deploying Box...');
  // 部署 Box...
  const box = await Box.deploy();
  await box.waitForDeployment();
  console.log('Box deployed to:', await box.getAddress());
  // Box 部署到：
}

main()
  .then(() => process.exit(0))
  .catch(error => {
    console.error(error);
    process.exit(1);
  });

我们在脚本中使用 ethers，因此我们需要安装它和 @nomicfoundation/hardhat-ethers 插件。

$ npm install --save-dev @nomicfoundation/hardhat-ethers ethers

我们需要在配置中添加我们正在使用 @nomicfoundation/hardhat-ethers 插件。

// hardhat.config.js
require("@nomicfoundation/hardhat-ethers");

...
module.exports = {
...
};

使用 run 命令，我们可以将 Box 合约部署到本地网络（Hardhat Network）：

$ npx hardhat run --network localhost scripts/deploy.js
Deploying Box...
// 部署 Box...
Box deployed to: 0x5FbDB2315678afecb367f032d93F642f64180aa3
// Box 部署到：0x5FbDB2315678afecb367f032d93F642f64180aa3

全部完成！在真实网络上，此过程将花费几秒钟，但在本地区块链上几乎是瞬间完成的。

从控制台交互

在我们部署了 Box 合约后，我们可以立即开始使用它。

我们将使用 Hardhat 控制台与我们在 localhost 网络上部署的 Box 合约进行交互。

$ npx hardhat console --network localhost
Welcome to Node.js v20.17.0.
Type ".help" for more information.
> const Box = await ethers.getContractFactory('Box');
undefined
> const box = Box.attach('0x5FbDB2315678afecb367f032d93F642f64180aa3')
undefined

发送交易

Box 的第一个函数 store 接收一个整数值并将其存储在合约存储中。由于此函数修改区块链状态，我们需要发送交易到合约才能执行它。

我们将发送一个交易来调用带有数值的 store 函数：

> await box.store(42)
{
  hash: '0x3d86c5c2c8a9f31bedb5859efa22d2d39a5ea049255628727207bc2856cce0d3',
...

查询状态

Box 的另一个函数称为 retrieve，它返回存储在合约中的整数值。这是区块链状态的查询，因此我们不需要发送交易：

> await box.retrieve()
42n

由于查询仅读取状态而不发送交易，因此没有交易哈希要报告。这也意味着使用查询不花费任何 Ether，并且可以在任何网络上免费使用。

> (await box.retrieve()).toString()
'42'

以编程方式交互

控制台对于原型设计和运行一次性查询或交易非常有用。但是，最终你需要从你自己的代码中与你的合约进行交互。

在本节中，我们将了解如何从 JavaScript 与我们的合约进行交互，并使用 Hardhat 运行我们的脚本以及我们的 Hardhat 配置。

设置

让我们从一个新的 scripts/index.js 文件开始编码，我们将在其中编写我们的 JavaScript 代码，首先是一些样板代码，包括用于编写异步代码。

// scripts/index.js
async function main () {
  // Our code will go here
  // 我们的代码将放在这里
}

main()
  .then(() => process.exit(0))
  .catch(error => {
    console.error(error);
    process.exit(1);
  });

我们可以通过询问本地节点一些内容来测试我们的设置，例如启用账户的列表：

// Retrieve accounts from the local node
// 从本地节点检索账户
const accounts = (await ethers.getSigners()).map(signer => signer.address);
console.log(accounts);

使用 hardhat run 运行上面的代码，并检查你是否收到响应中可用账户的列表。

$ npx hardhat run --network localhost ./scripts/index.js
[\
  '0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266',\
  '0x70997970C51812dc3A010C7d01b50e0d17dc79C8',\
...\
]

这些账户应该与你之前启动本地区块链时显示的账户匹配。现在我们有了第一个从区块链中获取数据的代码段，让我们开始使用我们的合约。请记住，我们将代码添加到上面定义的 main 函数内部。

获取合约实例

为了与我们部署的 Box 合约进行交互，我们将使用 ethers 合约实例。

ethers 合约实例是一个 JavaScript 对象，表示我们在区块链上的合约，我们可以使用它与我们的合约进行交互。为了将其附加到我们已部署的合约，我们需要提供合约地址。

// Set up an ethers contract, representing our deployed Box instance
// 设置一个 ethers 合约，代表我们部署的 Box 实例
const address = '0x5FbDB2315678afecb367f032d93F642f64180aa3';
const Box = await ethers.getContractFactory('Box');
const box = Box.attach(address);

我们现在可以使用此 JavaScript 对象与我们的合约进行交互。

调用合约

让我们首先显示 Box 合约的当前值。

我们需要调用合约的只读 retrieve() 公共方法，并等待响应：

// Call the retrieve() function of the deployed Box contract
// 调用已部署 Box 合约的 retrieve() 函数
const value = await box.retrieve();
console.log('Box value is', value.toString());
// Box 值为

此代码段等效于我们之前从控制台运行的查询。现在，通过再次运行该脚本并检查打印的值来确保一切顺利运行：

$ npx hardhat run --network localhost ./scripts/index.js
Box value is 42
// Box 值为 42

发送交易

我们现在将发送一个交易到 store 以在我们的 Box 中存储一个新值。

让我们在我们的 Box 中存储一个值为 23，然后使用我们之前编写的代码来显示更新后的值：

// Send a transaction to store() a new value in the Box
// 发送一个交易到 store() 以在 Box 中存储一个新值
await box.store(23);

// Call the retrieve() function of the deployed Box contract
// 调用已部署 Box 合约的 retrieve() 函数
const value = await box.retrieve();
console.log('Box value is', value.toString());
// Box 值为

我们现在可以运行该代码段，并检查 Box 的值是否已更新！

$ npx hardhat run --network localhost ./scripts/index.js
Box value is 23
// Box 值为 23

下一步

既然你知道如何设置本地区块链、部署合约以及手动和以编程方式与它们进行交互，你将需要了解有关测试环境、公共测试网络和投入生产的更多信息：

• 编写自动化测试

• 连接到公共测试网络

• 为主网做准备

← 开发智能合约

编写自动化测试 →

• 原文链接： docs.openzeppelin.com/le...
• 登链社区 AI 助手，为大家转译优秀英文文章，如有翻译不通的地方，还请包涵～