使用Truffle开发以太坊投票DAPP

投票最担心的是暗箱操作、利用区块链的去中心化技术，来实现一个DAPP保证投票公平公正，来看看如何实现，通过本文可以了解到映射mapping 、结构体struct 及事件 event 的使用。

投票需求分及实现效果

要实现一个投票DApp，对于合约来说有两个基本需求：

1. 每人（账号）只能投一票；
2. 记录下一共有多少候选人
3. 记录每个候选人的得票数。

在界面上，需要看到每个候选人的得票数， 已经选择投票人进行投票，来看看实现的效果图：

投票合约实现

数据存储

每人（账号）只能投一票很容易实现，只需要使用一个mapping 来记录每个地址的投票信息

定义一个 mapping 记录投票记录：

mapping(address => bool) public voters;

记录候选人及得票数， 我们思考下，如何合约中表示一个候选人，这里我们用一个结构体来表示候选人：

struct Candidate {
    uint id;
    string name;  // 候选人的名字
    uint voteCount;
}

在Candidate结构体中，用voteCount表示得票数。我们还需要记录下一共有多少个候选人，直觉是保存到一个数组，前端需要候选人列表时，直接把这个数组返回给前端。

基于EVM的限制，外部函数是没法返回动态的内容，更多可阅读Solidity数组，所以这里我们需要使用一个变通的方案。

用一个变量保存一共有多少个候选人uint public candidatesCount，然后定义一个映射：

mapping(uint => Candidate) public candidates

通过id作为key访问映射candidates来取候选人。

投票功能实现

接下来就是添加功能： 主要是两个功能： 添加候选人及投票。

每添加一个候选人就加入到candidates映射中，同时候选人数量加1，添加候选人addCandidate函数实现为：

    function addCandidate (string memory _name) private {
        candidatesCount ++;
        candidates[candidatesCount] = Candidate(candidatesCount, _name, 0);
    }

我们在合约创建的时候，就把候选人添加好，在构造函数中，调用addCandidate，构造函数实现如下：

    constructor () public {
        addCandidate("Tiny 熊");
        addCandidate("Big 熊");
    }

投票就是在对应的候选人的voteCount加1，同时这个函数需要一个参数即给哪一个候选人投票，另外需要进行一些合法性检查: 候选人是有效的，投票人必须没有投过票，投票vote函数实现如下：

    function vote (uint _candidateId) public {
        require(!voters[msg.sender]);
        require(_candidateId > 0 && _candidateId <= candidatesCount);

        voters[msg.sender] = true;
        candidates[_candidateId].voteCount ++;
    }

事件Event

为了有更好的前端体验， 在用户投票之后，应该及时的刷新页面， 这就需要用到事件了。

你还可以阅读另外一篇文章：详解 Solidity 事件Event 了解更多事件知识。

先定义一个事件：

    // voted event
    event votedEvent (
        uint indexed _candidateId
    );

然后在投票vote函数中最后一行加入发出事件：

emit votedEvent(_candidateId);

合约部分代码编写完了， 订阅小专栏 获取完整源代码。

合约部署

为合约Election，添加一个部署脚本：

var Election = artifacts.require("./Election.sol");

module.exports = function(deployer) {
  deployer.deploy(Election);
};

在部署之前，还需要打开以太坊的模拟节点Ganache，并确保Truffle配置文件truffle.js 链接节点的地址和端口与Ganache 一致。

Ganache 的安装使用可阅读开发、部署第一个DApp 如果要部署到以太坊正式网络可阅读用Truffle 开发一个链上记事本

然后运行一下命令进行部署：

truffle migrate

前端界面

有一个html table标签显示候选人列表:

    <table class="table">
      <thead>
        <tr>
          <th scope="col">#</th>
          <th scope="col">候选人</th>
          <th scope="col">得票数</th>
        </tr>
      </thead>
      <tbody id="candidatesResults">
      </tbody>
    </table>

candidatesResults的内容，需要使用web3.js从合约中读取候选人信息后动态填入。

使用form标签执行投票操作：

    <form onSubmit="App.castVote(); return false;">
      <div class="form-group">
        <label for="candidatesSelect">选择候选人</label>
        <select class="form-control" id="candidatesSelect">
        </select>
      </div>
      <button type="submit" class="btn btn-primary">投票</button>
      <hr />
    </form>

合约交互

分三个部分：

1. 初始化 web3 及合约
2. 获取候选人填充到前端页面
3. 用户提交投票

初始化

在initWeb3函数中，完成web3的初始化

  initWeb3: async function() {
    if (window.ethereum) {
      App.web3Provider = window.ethereum;
      try {
        await window.ethereum.enable();
      } catch (error) {
        console.error("User denied account access")
      }
    }
    else if (window.web3) {
      App.web3Provider = window.web3.currentProvider;
    }
    else {
      App.web3Provider = new Web3.providers.HttpProvider('http://localhost:9545');
    }
    web3 = new Web3(App.web3Provider);
    return App.initContract();
}

web3的初始化，调用App.initContract进行合约初始化：

 initContract: function() {
    $.getJSON("Election.json", function(election) {
      App.contracts.Election = TruffleContract(election);
      App.contracts.Election.setProvider(App.web3Provider);
      App.listenForEvents();
      return App.render();
    });
  }

监听投票事件

listenForEvents: function() {    App.contracts.Election.deployed().then(function(instance) {
      instance.votedEvent({}, {
        fromBlock: 0,
        toBlock: 'latest'
      }).watch(function(error, event) {
        App.render();
      });
    });
  }

这里有一份web3.js 监听事件 API文档说明

候选人界面渲染

  render: function() {
    var electionInstance;
    App.contracts.Election.deployed().then(function(instance) {
      electionInstance = instance;
      return electionInstance.candidatesCount();  // ❶
    }).then(function(candidatesCount) {
      var candidatesResults = $("#candidatesResults");
      candidatesResults.empty();

      var candidatesSelect = $('#candidatesSelect');
      candidatesSelect.empty();

      for (var i = 1; i <= candidatesCount; i++) {
        electionInstance.candidates(i).then(function(candidate) {  // ❷
          var id = candidate[0];
          var name = candidate[1];
          var voteCount = candidate[2];

          // Render candidate Result
          var candidateTemplate = "<tr><th>" + id + "</th><td>" + name + "</td><td>" + voteCount + "</td></tr>"
          candidatesResults.append(candidateTemplate); // ❸

          // Render candidate ballot option
          var candidateOption = "<option value='" + id + "' >" + name + "</ option>"
          candidatesSelect.append(candidateOption);  // ❹
        });
      }
    }

• ❶ 获取候选人数量
• ❷ 依次获取某一个候选人信息
• ❸ 候选人信息写入候选人表格内
• ❹ 候选人信息写入投票选项

运行DApp

使用以下命令，启动DApp 服务：

npm run dev

在浏览器打开http://localhost:3000 ， 浏览器的MetaMask 小狐狸插件需要连接到Ganache网络， 因为只有网络一致才可以读取到网络上的合约数据。

如何设置MetaMask 可阅读开发、部署第一个去中心化应用。

本文为保持主干清晰，代码有删减， 完整代码请订阅小专栏查看。

参考文档

Truffle 官方文档-中文版

学习中如遇问题，欢迎到区块链技术问答提问，这里有老师为你解惑。