SimpleChain开发文档

编写合约

一. 项目代码管理

项目的代码库

二. 单个众筹合约实现

1.创建空合约CrowFunding

进⼊到项⽬⽬录，创建⽂件basicFunding.sol

33.1.png

并添加如下代码：

pragma solidity ^0.4.24;

contractCrowFunding {

}

2.基本属性(状态变量)

状态变量类型作⽤
creatoraddress项⽬发起⼈，负责创建合约、花费申请、花费执⾏
projectNamestring众筹项⽬名称
supportBalanceuint众筹⽀持⾦额
targetBalanceuint众筹项⽬⽬标筹集⾦额
endTimeuint众筹截⽌⽇期，到此时间时若筹不⻬⾦额则众筹失败

3.构造函数实现

pragma solidity ^0.4.24;

contract CrowFunding {
   address public creator; // 发起人
   string public projectName; // 项目名称
   uint public supportBalance; // 参与众筹金额
   uint public targetBalance; // 众筹目标金额 
   uint public endTime; // 众筹截止时间

constructor(string _projectName, uint _supportBalance, uint _targetBalance, uin t _durationInSeconds) public {
   creator = msg.sender;
   projectName = _projectName;
   supportBalance = _supportBalance;
   targetBalance = _targetBalance; 
   //传递进来剩余的秒数，比如若众筹30天，则传入：30天 * 24小时 * 60分 * 60秒 = 2592000 
   endTime = now + _durationInSeconds; //2592000
   } 
}

测试

4.参与众筹

实现

添加参与人属性

address[] public investors; //参与众筹的人，即投资人

参与众筹即向合约中转账，并将参与人的地址添加到集合中，代码如下：

function invest() public payable { 
   require(investorExistMap[msg.sender] == false);//每个人只能参与一次

   require(msg.value == supportBalance); // 支持固定金额
   investors.push(msg.sender); // 添加到众筹人数组中
   investorExistMap[msg.sender] = true; // 标记当前账户为参与人
}

为了能够快速校验一个账户是否在参与人数组中，我们提供一个mapping(address=>bool)来进行标记，mapping的特点是所有的key都默认存在，只不过默认值是false，如果不存在，则返回false,我们将用户地址作为key,设置值为true,即可完成索引，mapping是线性索引的，比使用for循环遍历investors数组高效且经济，所以还需要添加如下属性：

mapping(address => bool) public investorExistMap; //标记一个人是否参与了当前众筹

测试

测试，请部署后按照数字顺序操作

33.6.png

众筹失败退款（实现）

退款即将所有筹到的钱逐一退换还给投资者人。同时增加了两个辅助函数，便于测试。

//众筹失败，退款
function drawBack() public {
    for (uint i = 0 ; i < investors.length; i++) {
        investors[i].transfer(supportBalance);
}
//查看合约当前余额
function getCurrentBalance() public view returns(uint) {
    return address(this).balance;
}
//返回所有投资人
function getInvestors() public view returns(address[]) {
    return investors;
}

测试

33.7.png

花费请求(实现)

  • 定义结构 众筹成功，项目启动，需要指出一笔费用，这笔费用需要包含如下信息：
  1. 用途：买什么？
  2. 花费金额：需要多少钱？
  3. 商家地址：向谁购买？
  4. 当前已经赞成的票数：多少人赞成了，超半数则批准支出
  5. 这个花费申请的当前状态：这个申请的当前状态：完成？待批准？代执行？
  6. 标记已经投过票的人的集合：mapping(address=>bool),赞成人的标记集合，防止一人投票多次。

根据分析，定义结构代码：

struct Request {
   string purpose; //买什么？
   uint cost; //需要多少钱？
   address shopAddress; // 向谁购买？
   uint voteCount; // 多少人赞成了，超半数则批准支出
   mapping(address => bool) investorVotedMap; //赞成人的标记集合，防止一人重复投票多次
   RequestStatus status; //这个申请的当前状态：投票中？已批准？已完成？
}

定义一个枚举，描述申请状态：

enum RequestStatus {Voting,Approved,Completed}
  • 定义方法 这个函数比较简单，创建一个新的请求结构，然后添加到数组中即可。

代码如下：

Request[] public requests; //请求可能有多个，所以定义一个数组
function createRequest(string _purpose, uint _cost, address _shopAddress) public {
       Request memory request = Request({
           purpose : _purpose,
           cost : _cost,
           shopAddress : _shopAddress,
           voteCount : 0,
           status : RequestStatus.Voting
       });
      requests.push(request); //将新的请求添加至数组中
}

测试

在createRequest中添加参数：

"小胖子减肥", 100, "0xca35b7d915458ef540ade6068dfe2f44e8fa733c"

在request中搜索第0个请求，图示如下：

33.9.png

批准支付申请

实现

项目方发起申请后，由众筹人进行审批，如果投资人不支持。则无需理会，默认为false(不支持)，如果想支持，则需要执行批准动作。即对申请结构的数据进行状态修改，包括：

  1. 检验这个人是否投票过，若未通过，则允许投票，反之退出。
  2. voteCount 数据加1。
  3. 将该投票人再investorVotedMap映射中的值设为true。

代码如下：

//批准⽀付申请
function approveRequest(uint256 index) public {
    // 1. 检验这个⼈是否投过票，若未投过，则允许投票，反之退出
    // 2. voteCount数据加1。
    // 3. 将该投票⼈在investorVotedMap映射中的值设置为true。

    //⾸先要确保是参与众筹的⼈，否则⽆权投票
    require(investExitMapping[msg.sender]);
    //根据索引找到特定的请求
    Request storage req = requests[index];
    //确保没有投过票，⼈⼿⼀票
    require(req.investorVotedMap[msg.sender] == false);
    //如果已经完成，或者已经获得批准了，就不⽤投票了，当前投票不会影响决策。
    require(req.status == RequestStatus.Voting);

    //⽀持票数加1
    req.voteCount += 1;
    //标记为已投票
    req.investorVotedMap[msg.sender] = true;
    if (req.voteCount * 2 > investors.length) {
        req.status == RequestStatus.Approved;
    }
}

测试

批准侯查看该请求，voteCount变为1

33.11.png

完成花费请求

实现

当投票人数过半时，花费被批准，可以由项目方执行花费动作，也可以由项目方执行花费动作，也可以由合约自动执行。我们选择手动执行，因为有可能项目方改变注意了，计划右边不需要购买了等等因素，所以我们把权利下放到项目方。

这个函数主要做两件事：

1.票数过半，则执行转账。 2.更新request的状态

代卖如下：

function finalizeRequest(uint256 index) public onlyManager{
    // 这个函数主要做两件事：
    // 1. 票数过半，则执⾏转账。
    // 2. 更新request的状态。

    Request storage req = requests[index];
    //合约⾦额充⾜才可以执⾏
    require(address(this).balance >= req.cost);
    //赞成⼈数过半
    require(req.voteCount * 2 > investors.length);
    //转账
    req.shopAddress.transfer(req.cost);
    //更新请求状态为已完成
    req.status = RequestStatus.Completed;
}

测试

三个人投资，一个人赞成，两个人反对，执行支付失败。

33.12.png

两个人赞成，执行支付成功

33.13.png

智能合约全部实现还需要实现几个方法，以及合约方法的互相调用。这些都可以直接在看源码学习。但是合约的编写，以及测试都在上面的几个基础方法中现在。

← 编写合约Dapp前端实现 →