以太坊开发入门,使用Truffle框架搭建你的第一个智能合约项目

node -v
npm -v

npm install -g truffle

truffle version

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
/**
 * @title HelloWorld
 * @dev 一个简单的合约，返回问候语
 */
contract HelloWorld {
    string public greeting = "Hello, Truffle!";
    /**
     * @dev 返回问候语
     * @return greeting 问候语字符串
     */
    function greet() public view returns (string memory) {
        return greeting;
    }
    /**
     * @dev 设置新的问候语
     * @param _newGreeting 新的问候语
     */
    function setGreeting(string memory _newGreeting) public {
        greeting = _newGreeting;
    }
}

编译智能合约

编写完合约后，我们需要使用Truffle将其编译成以太坊虚拟机（EVM）可执行的字节码。

在项目根目录的终端中,运行：

truffle compile

如果编译成功，你会在终端看到类似以下的输出，并且在build/contracts目录下会生成对应的HelloWorld.json文件，该文件包含了合约的ABI、字节码等关键信息。

Compiling your contracts...
> Everything is compiled, next step is to run migrations.
> To run migrations, run "truffle migrate"

编写测试脚本

测试是保证智能合约质量的重要环节，Truffle支持使用JavaScript（或TypeScript）编写测试。

1. 在test目录下，创建一个新的测试文件，例如helloWorld.test.js。

2. 编写以下测试代码：

   const HelloWorld = artifacts.require("HelloWorld");
   contract("HelloWorld", (accounts) => {
       it("should initialize with the correct greeting", async () => {
           const helloWorldInstance = await HelloWorld.deployed();
           const greeting = await helloWorldInstance.greet();
           assert.equal(greeting, "Hello, Truffle!", "Greeting was not initialized correctly");
       });
       it("should be able to set a new greeting", async () => {
           const helloWorldInstance = await HelloWorld.deployed();
           const newGreeting = "Hello, Updated World!";
           await helloWorldInstance.setGreeting(newGreeting);
           const updatedGreeting = await helloWorldInstance.greet();
           assert.equal(updatedGreeting, newGreeting, "Greeting was not updated correctly");
       });
   });

   这个测试文件包含了两个测试用例：

   • should initialize with the correct greeting：验证合约部署后初始问候语是否正确。
   • should be able to set a new greeting：验证setGreeting函数是否能正确修改问候语。

3. 运行测试：

   在项目根目录终端执行：

   truffle test

   如果测试通过,你会看到类似以下的输出：

   Using network 'develop'.
   Compiling your contracts...
   > Everything is compiled, next step is to run migrations.
   > To run migrations, run "truffle migrate"
   Contract: HelloWorld
   ✓ should initialize with the correct greeting (100ms)
   ✓ should be able to set a new greeting (85ms)
   2 passing (1s)

部署智能合约

合约编译和测试通过后，就可以将其部署到区块链网络了，Truffle使用migrations目录下的脚本来管理部署过程。

1. 在migrations目录下，创建一个新的部署脚本文件，文件名以数字开头，按执行顺序排列，例如2_deploy_contracts.js。

2. 编写以下部署脚本：

   const HelloWorld = artifacts.require("HelloWorld");
   module.exports = function (deployer) {
       // 部署 HelloWorld 合约
       deployer.deploy(HelloWorld);
   };

3. 配置网络（可选，默认使用develop网络）： 打开truffle-config.js文件,你可以看到默认的网络配置：

   networks: {
     develop: {
       host: "127.0.0.1",     // Localhost (default: none)
       port: 7545,            // Standard Ethereum port (default: none)
       network_id: "*",       // Any network (default: none)
     },
     // 你可以在这里添加其他网络配置，如Ropsten, Goerli等
   },

   develop网络是Truffle内置的本地开发网络，它会自动启动一个本地的私有区块链节点,方便开发测试。

4. 执行部署：

   在项目根目录终端执行：

   truffle migrate

   如果部署成功，你会看到合约被部署到指定网络,并显示合约地址等信息。

   
   Using network 'develop'.
   Running migration: 1_initial_migration.js
     Deploying Migrations...
     ... 0x1234567890abcdef