7.7 智能合约案例:投票

本节将介绍一个用Solidity语言编写的智能合约案例。代码来源于“Solidity官方文档”中的示例。

该智能合约实现了一个自动化且透明的投票应用。投票发起人可以发起投票,将投票权赋予投票人;投票人可以自己投票,或将自己的票委托给其他投票人;任何人都可以公开查询投票的结果。

7.7.1 智能合约代码

实现上述功能的合约代码如下所示,并不复杂,语法跟JavaScript十分类似:


 
  

pragma solidity ^0.4.11;

contract Ballot {
   struct Voter {
       uint weight;
       bool voted;
       address delegate;
       uint vote;
   }

   struct Proposal {
       bytes32 name;
       uint voteCount;
   }

   address public chairperson;
   mapping(address => Voter) public voters;
   Proposal[] public proposals;

   // Create a new ballot to choose one of `proposalNames`
   function Ballot(bytes32[] proposalNames) {
       chairperson = msg.sender;
       voters[chairperson].weight = 1;

       for (uint i = 0; i < proposalNames.length; i++) {
           proposals.push(Proposal({
               name: proposalNames[i],
               voteCount: 0
           }));
       }
   }

   // Give `voter` the right to vote on this ballot.
   // May only be called by `chairperson`.
   function giveRightToVote(address voter) {
       require((msg.sender == chairperson) && !voters[voter].voted);
       voters[voter].weight = 1;
   }

   // Delegate your vote to the voter `to`.
   function delegate(address to) {
       Voter sender = voters[msg.sender];
       require(!sender.voted);
       require(to != msg.sender);

       while (voters[to].delegate != address(0)) {
           to = voters[to].delegate;

           // We found a loop in the delegation, not allowed.
           require(to != msg.sender);
       }

       sender.voted = true;
       sender.delegate = to;
       Voter delegate = voters[to];
       if (delegate.voted) {
           proposals[delegate.vote].voteCount += sender.weight;
       } else {
           delegate.weight += sender.weight;
       }
   }

   // Give your vote (including votes delegated to you)
   // to proposal `proposals[proposal].name`.
   function vote(uint proposal) {
       Voter sender = voters[msg.sender];
       require(!sender.voted);
       sender.voted = true;
       sender.vote = proposal;

       proposals[proposal].voteCount += sender.weight;
   }

   // @dev Computes the winning proposal taking all
   // previous votes into account.
   function winningProposal() constant
           returns (uint winningProposal)
   {
       uint winningVoteCount = 0;
       for (uint p = 0; p < proposals.length; p++) {
           if (proposals[p].voteCount > winningVoteCount) {
               winningVoteCount = proposals[p].voteCount;
               winningProposal = p;
           }
       }
   }

   // Calls winningProposal() function to get the index
   // of the winner contained in the proposals array and then
   // returns the name of the winner
   function winnerName() constant
           returns (bytes32 winnerName)
   {
       winnerName = proposals[winningProposal()].name;
   }
}


7.7.2 代码解析

1.指定版本

在第一行,pragma关键字指定了和该合约兼容的编译器版本:


 
  

pragma solidity ^0.4.11;


该合约指定,不兼容比0.4.11更旧的编译器版本,且^符号表示也不兼容从0.5.0起的新编译器版本。即兼容版本范围是0.4.11<=version<0.5.0。该语法与npm的版本描述语法一致。

2.结构体类型

Solidity中的合约(contract)类似面向对象编程语言中的类。每个合约可以包含状态变量、函数、事件、结构体类型和枚举类型等。一个合约也可以继承另一个合约。

在本例命名为Ballot的合约中,声明了两个结构体类型:Voter和Proposal:

·struct Voter:投票人,其属性包括uint weight(该投票人的权重)、bool voted(是否已投票)、address delegate(如果该投票人将投票委托给他人,则记录受委托人的账户地址)和uint vote(投票做出的选择,即相应提案的索引号);

·struct Proposal:提案,其属性包括bytes32 name(名称)和uint voteCount(获得的票数)。

需要注意,address类型记录了一个以太坊账户的地址。address可看作一个数值类型,但也包括一些与以太币相 关的方法,如查询余额

.balance、向该地址转账
.transfer(uint256 amount)等。

3.状态变量

合约中的状态变量会长期保存在区块链中。通过调用合约中的函数,这些状态变量可以被读取和改写。

本例中声明了3个状态变量:chairperson、voters、proposals:

·address public chairperson:投票发起人,类型为address;

·mapping(address=>Voter)public voters:所有投票人,类型为address到Voter的映射;

·Proposal[]public proposals:所有提案,类型为动态大小的Proposal数组。

3个状态变量都使用了public关键字,使得变量可以被外部访问(即通过消息调用)。事实上,编译器会自动为public的变量创建同名的getter函数,供外部直接读取。

状态变量还可设置为internal或private。internal的状态变量只能被该合约和继承该合约的子合约访问,private的状态变量只能被该合约访问。状态变量默认为internal。

将上述关键状态信息设置为public能够增加投票的公平性和透明性。

4.函数

合约中的函数用于处理业务逻辑。函数的可见性默认为public,即可以从内部或外部调用,是合约的对外接口。函数可见性也可设置为external、internal和private。

本例实现了6个public函数,可看作6个对外接口,功能分别描述如下。

(1)创建投票

用函数function Ballot(bytes32[]proposalNames)创建一个新的投票。所有提案的名称通过参数bytes32[]proposalNames 传入,逐个记录到状态变量proposals中。同时用msg.sender获取当前调用消息的发送者的地址,记录为投票发起人chairperson, 该发起人投票权重设为1。

(2)赋予投票权

用函数function giveRightToVote(address voter)实现给投票人赋予投票权。该函数给address voter赋予投票权,即将voter的投票权重设为1,存入voters状态变量。

这个函数只有投票发起人chairperson可以调用。这里用到了 require((msg.sender==chairperson)&&!voters[voter].voted)函数。如果 require中表达式结果为false,这次调用会中止,且回滚所有状态和以太币余额的改变到调用前。但已消耗的Gas不会返还。

(3)委托投票权

用函数function delegate(address to)把投票委托给其他投票人。其中,用voters[msg.sender]获取委托人,即此次调用的发起人。用require确保发起人没有投过票, 且不是委托给自己。由于被委托人也可能已将投票委托出去,所以接下来,用while循环查找最终的投票代表。找到后,如果投票代表已投票,则将委托人的权 重加到所投的提案上;如果投票代表还未投票,则将委托人的权重加到代表的权重上。

该函数使用了while循环,这里合约编写者需要十分谨慎,防止调用者消耗过多Gas,甚至出现死循环。

(4)进行投票

用函数function vote(uint proposal)实现投票过程。其中,用voters[msg.sender]获取投票人,即此次调用的发起人。接下来检查是否是重复投票,如果不是,进行投票后相关状态变量的更新。

(5)查询获胜提案

用函数function winningProposal()constant returns(uint winningProposal)将返回获胜提案的索引号。

这里,returns(uint winningProposal)指定了函数的返回值类型,constant表示该函数不会改变合约状态变量的值。

函数通过遍历所有提案进行记票,得到获胜提案。

(6)查询获胜者名称

用函数function winnerName()constant returns(bytes32 winnerName)实现返回获胜者的名称。这里采用内部调用winningProposal()函数的方式获得获胜提案。如果需要采用外部调用,则需 要写为this.winningProposal()。

本章小结

以太坊项目将区块链技术在数字货币的基础上进行了延伸,提出了打造更为通用的智能合约平台的宏大构想,并基于开源技术构建了以太坊为核心的开源生态系统。

本章内容介绍了以太坊的相关知识,包括核心概念、设计、工具,以及客户端的安装、智能合约的使用和编写等。

比照比特币项目,可以掌握以太坊的相关改进设计,并学习智能合约的编写。实际上,智能合约并不是一个新兴概念,但区块链技术的出现为智能合约的“代码即律法”提供提供了信任基础和实施架构。通过引入智能合约,区块链技术释放了支持更多应用领域的巨大潜力。

以太坊项目将区块链技术在数字货币的基础上进行了延伸,提出了打造更为通用的智能合约平台的宏大构想,并基于开源技术构建了以太坊为核心的开源生态系统。

本章内容介绍了以太坊的相关知识,包括核心概念、设计、工具,以及客户端的安装、智能合约的使用和编写等。

比照比特币项目,可以掌握以太坊的相关改进设计,并学习智能合约的编写。实际上,智能合约并不是一个新兴概念,但区块链技术的出现为智能合约的“代码即律法”提供提供了信任基础和实施架构。通过引入智能合约,区块链技术释放了支持更多应用领域的巨大潜力。



来源:我是码农,转载请保留出处和链接!

本文链接:http://www.54manong.com/?id=939

'); (window.slotbydup = window.slotbydup || []).push({ id: "u3646208", container: s }); })();
'); (window.slotbydup = window.slotbydup || []).push({ id: "u3646147", container: s }); })();

你可能感兴趣的:(7.7 智能合约案例:投票)