创建合约文件

在 contracts/ 目录下新建 HelloWorld.sol，编写以下代码：

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;
/**HelloWorld
 * @dev 一个简单的智能合约，用于存储和读取 "Hello, World!" 字符串
 */
contract HelloWorld {
    // 声明一个状态变量，存储字符串
    string public greeting;
    // 构造函数，部署合约时调用，初始化 greeting
    constructor() {
        greeting = "Hello, World!";
    }
    // 更新 greeting 的函数
    function setGreeting(string memory _newGreeting) public {
        greeting = _newGreeting;
    }
    // 读取 greeting 的函数（public 修饰符会自动生成 getter 函数）
    function getGreeting() public view returns (string memory) {
        return greeting;
    }
}

代码解析

• SPDX-License-Identifier: MIT：许可证标识，声明合约遵循MIT开源协议；
• pragma solidity ^0.8.20;：指定Solidity编译器版本（^0.8.20 表示兼容0.8.20及以上，低于0.9.0）；
• string public greeting;：状态变量，类型为 string（字符串），public 修饰符会自动生成一个 greeting() 的getter函数，无需额外编写；
• constructor()：构造函数，合约部署时自动调用，用于初始化变量（greeting 默认为 "Hello, World!"）；
• setGreeting(string memory _newGreeting)：公共函数，用于修改 greeting，参数 _newGreeting 是新的字符串；
• getGreeting()：公共视图函数（view 表示不修改状态），返回当前的 greeting。

编译与部署合约

编译合约

在终端运行Hardhat的编译命令：

npx hardhat compile

编译成功后，artifacts/contracts/HelloWorld.sol/HelloWorld.json 会生成合约的ABI（应用二进制接口）和字节码（Bytecode）。

• ABI：合约与外部交互的“说明书”，定义了函数的输入、输出、类型等信息；
• Bytecode：区块链上实际执行的机器码。

部署合约

Hardhat默认使用 scripts/ 目录下的脚本部署合约，修改 scripts/deploy.js 为以下内容：

async function main() {
  // 获取 HelloWorld 合约的工厂对象
  const HelloWorld = await ethers.getContractFactory("HelloWorld");
  // 部署合约
  const helloWorld = await HelloWorld.deploy();
  // 等待部署完成
  await helloWorld.deployed();
  // 输出合约地址
  console.log("HelloWorld 合约部署成功，地址:", helloWorld.address);
}
main()
  .then(() => process.exit(0))
  .catch((error) => {
    console.error(error);
    process.exit(1);
  });

部署前，需确保MetaMask已连接到Sepolia测试网，并在终端设置环境变量（或直接运行Hardhat节点），更简单的方式是使用Hardhat的本地网络：

npx hardhat node  # 启动本地测试节点（默认端口8545）

然后在另一个终端运行部署命令：

npx hardhat run scripts/deploy.js --network localhost

若使用Sepolia测试网，需在 hardhat.config.js 中添加网络配置：

require("@nomicfoundation/hardhat-toolbox");
/** @type import('hardhat/config').HardhatUserConfig */
module.exports = {
  solidity: "0.8.20",
  networks: {
    sepolia: {
      url: "https://sepolia.infura.io/v3/YOUR_INFURA_PROJECT_ID", // 替换为你的Infura项目ID
      accounts: ["YOUR_PRIVATE_KEY"], // 替换为MetaMask账户的私钥（不要泄露！）
    },
  },
};

部署成功后，终端会输出合约地址（如 0x5FbDB2315678afecb367f032d93F642f64180aa3），这个地址就是你的Hello World合约在区块链上的“身份证”。

与智能合约交互

部署合约后，我们需要通过MetaMask调用合约的 getGreeting() 和 setGreeting() 函数，验证合约功能。

查看合约

• 打开MetaMask，点击“连接到应用”（或使用Hardhat插件 hardhat-etherscan）；
• 访问 Sepolia Etherscan，输入合约地址，即可看到合约的交易记录、代码等信息。

调用 getGreeting()（读取状态）

• 在Hardhat项目中，可以使用 ethers.js 直接调用：

  const helloWorld = await ethers.getContractAt("HelloWorld", CONTRACT_ADDRESS);
  const greeting = await helloWorld.getGreeting();
  console.log("当前 greeting:", greeting); // 输出 "Hello, World!"

• 或使用Remix IDE（在线Solidity开发工具）：打开Remix，切换到“Deployed”标签，输入合约地址，点击 getGreeting 按钮调用。

调用 setGreeting()（修改状态）

修改状态需要发送一笔交易，并支付 gas 费：

• 在Hardhat脚本中调用：

  const tx = await helloWorld.setGreeting("Hello, Ethereum!");
  await tx.wait(); // 等待交易打包
  const newGreeting = await helloWorld.getGreeting();
  console.log("更新后的 greeting:", newGreeting); // 输出 "Hello, Ethereum!"

• 或通过MetaMask交互：
  1. 在Remix IDE中，选择 setGreeting 函数，输入参数 "Hello, Ethereum!"