• Visual Studio Code (VS Code) 是目前最流行的智能合约开发编辑器,拥有丰富的插件生态。
• 推荐安装 Solidity 插件，提供语法高亮、代码提示、编译错误检查等功能。

你的第一个智能合约：一个简单的投票合约

让我们通过一个简单的投票合约来学习 Solidity 语言的基本语法和合约结构。

1. 创建项目目录：

   my-vote-dapp
   cd my-vote-dapp

2. 初始化 Truffle 项目：

   truffle init

   这会创建一些基本文件夹和配置文件，如 contracts/（存放智能合约代码）、migrations/（部署脚本）、test/（测试文件）等。

3. 编写智能合约代码：

   • 在 contracts/ 目录下创建一个名为 Voting.sol 的文件。
   • 编写以下代码：

   // SPDX-License-Identifier: MIT
   pragma solidity ^0.8.20;
   /**
    * @title Voting
    * @dev 一个简单的投票合约，允许对多个选项进行投票。
    */
   contract Voting {
       // 定义一个候选人的结构体
       struct Candidate {
           uint id;
           string name;
           uint voteCount;
       }
       // 存储候选人的映射，键为候选人ID，值为Candidate结构体
       mapping(uint => Candidate) public candidates;
       // 存储投票者地址的映射，防止重复投票
       mapping(address => bool) public voters;
       // 候选人数量
       uint public candidatesCount;
       // 事件：当有人投票时触发
       event VotedEvent(uint indexed candidateId, address voter);
       // 构造函数：部署合约时初始化候选人
       constructor(string[] memory candidateNames) {
           candidatesCount = 0;
           for (uint i = 0; i < candidateNames.length; i++) {
               candidates[candidatesCount] = Candidate(candidatesCount, candidateNames[i], 0);
               candidatesCount++;
           }
       }
       // 投票函数
       function vote(uint _candidateId) public {
           // 检查候选人ID是否有效
           require(_candidateId < candidatesCount, "Invalid candidate ID");
           // 检查投票者是否已经投过票
           require(!voters[msg.sender], "Already voted");
           // 记录投票者
           voters[msg.sender] = true;
           // 增加候选人的票数
           candidates[_candidateId].voteCount++;
           // 触发投票事件
           emit VotedEvent(_candidateId, msg.sender);
       }
       // 获取候选人信息
       function getCandidate(uint _candidateId) public view returns (uint id, string memory name, uint voteCount) {
           Candidate storage candidate = candidates[_candidateId];
           return (candidate.id, candidate.name, candidate.voteCount);
       }
   }

代码解释：

• SPDX-License-Identifier 和 pragma solidity：Solidity 合约的标准开头,指定许可证版本和编译器版本。
• contract Voting：定义一个名为 Voting 的合约。
• struct Candidate：定义候选人结构体，包含ID、姓名和票数。
• mapping：类似于哈希表,用于存储候选人信息和投票记录。
• constructor：合约部署时执行的构造函数,用于初始化候选人列表。
• vote：核心投票函数,包含权限检查和票数更新。
• getCandidate：获取指定候选人信息的视图函数（不消耗gas）。

编译和测试智能合约

1. 编译合约：

   • 确保 Ganache 已经启动并运行。
   • 在项目根目录的终端中运行：

     truffle compile

   • 如果成功，build/contracts/ 目录下会生成编译后的 JSON 文件（ABI 和字节码）。

2. 编写测试用例（可选但推荐）：

   • 在 test/ 目录下创建一个 JavaScript 测试文件，test/voting.test.js：

     const Voting = artifacts.require("Voting");
     contract("Voting", accounts => {
         it("should initialize with the correct candidate names", async () => {
             const votingInstance = await Voting.deployed();
             const candidate0 = await votingInstance.getCandidate(0);
             const candidate1 = await votingInstance.getCandidate(1);
             assert.equal(candidate0[1], "Candidate 1", "First candidate name incorrect");
             assert.equal(candidate1[1], "Candidate 2", "Second candidate name incorrect");
         });
         it("should allow a voter to vote", async () => {
             const votingInstance = await Voting.deployed();
             const voter = accounts[0];
             await votingInstance.vote(0, { from: voter });
             const candidate0 = await votingInstance.getCandidate(0);
             assert.equal(candidate0[2], "1", "Vote count not incremented");
             const voterStatus = await votingInstance.voters(voter);
             assert.equal(voterStatus, true, "Voter status not updated");
         });
     });

   • 运行测试：

     truffle test

部署智能合约到测试网络

1. 配置网络：

   • 在 truffle-config.js（或 truffle.js）中，配置 Ganache 的本地网络：

     module.exports = {
       networks: {
         development: {
           host: "127.0.0.1",     // Localhost (default: none)
           port: 7545,            // Standard Ethereum port (default: none)
           network_id: "*",       // Any network (default: none)
         },
         // 可以添加其他测试网络，如 Ropsten, Rinkeby, Goerli 等
       },
       compilers: {
         solc: {
           version: "0.8.20",    // 指定 Solidity 编译器版本
         }
       }
     };

2. 编写迁移脚本：

   • 在 migrations/ 目录下创建一个新的迁移脚本，2_deploy_contracts.js：

     const Voting