区块链100讲：代币锁仓后逐步释放的ERC20智能合约实践

时间  2019-11-21
标签 区块 代币 逐步 释放 erc20 erc 智能 合约 实践 栏目 比特币 繁體版
原文   原文链接

image

1

摘要

【本文目标】 经过本文学习，能够实现区块链私募，基金会员工期权(代币)激励时锁仓必定时间，逐步释放的方法。git

【前置条件】 1）已经完成了一个ERC20的代币，本文以做者接触的CLB为样例。 2） 懂得在REMIX调试SOLIDITY语言，不熟悉的参考文章Solidity语言编辑器REMIX指导大全。github

2

需求实现描述

通常区块链项目在私募或者员工沟通时，都会明确代币发放的政策，通常来讲都会要求项目上线后锁仓多久，分几年释放。若是经过合同的方式来人工操做，一个是实现比较麻烦或者存在不可控性，另外一方面也存在没法取信私募机构或者员工的状况。微信

那么专业的团队会选择经过智能合约来实现，这是更可信、公开、且不可串改的最佳方式。app

这个实现归纳讲包括3步： 1）发布ERC20代币智能合约 2）配置锁仓合约参数, 发布锁仓的智能合约 3）把要锁仓的ERC20代币转入锁仓智能合约编辑器

其中锁仓智能合约的文章极少，不少人不知怎么实现，辉哥来作个分享。函数

3

锁仓智能合约分析

锁仓智能合约核心代码：工具

/** 

 * @title TokenVesting

 * @dev A token holder contract that can release its token balance gradually like a

 * typical vesting scheme, with a cliff and vesting period. Optionally revocable by the

 * owner.

 */

contract TokenVesting is Ownable {
  using SafeMath for uint256;

  using SafeERC20 for Colorbay;

  event Released(uint256 amount);

  event Revoked();

  // beneficiary of tokens after they are released

  address public beneficiary;

  uint256 public cliff;

  uint256 public start;

  uint256 public duration;

  bool public revocable;

  mapping (address => uint256) public released;

  mapping (address => bool) public revoked;

  /**

   * @dev Creates a vesting contract that vests its balance of any ERC20 token to the

   * _beneficiary, gradually in a linear fashion until _start + _duration. By then all

   * of the balance will have vested.

   * @param _beneficiary address of the beneficiary to whom vested tokens are transferred

   * @param _cliff duration in seconds of the cliff in which tokens will begin to vest

   * @param _start the time (as Unix time) at which point vesting starts

   * @param _duration duration in seconds of the period in which the tokens will vest

   * @param _revocable whether the vesting is revocable or not

   */

  constructor(

    address _beneficiary,

    uint256 _start,

    uint256 _cliff,

    uint256 _duration,

    bool _revocable

  )

    public

  {

    require(_beneficiary != address(0));

    require(_cliff <= _duration);

    beneficiary = _beneficiary;

    revocable = _revocable;

    duration = _duration;

    cliff = _start.add(_cliff);

    start = _start;

  }

  /**

   * @notice Transfers vested tokens to beneficiary.

   * @param _token Colorbay token which is being vested

   */

  function release(Colorbay _token) public {

    uint256 unreleased = releasableAmount(_token);

    require(unreleased > 0);

    released[_token] = released[_token].add(unreleased);

    _token.safeTransfer(beneficiary, unreleased);

    emit Released(unreleased);

  }

  /**

   * @notice Allows the owner to revoke the vesting. Tokens already vested

   * remain in the contract, the rest are returned to the owner.
   * @param _token ERC20 token which is being vested

   */  function revoke(Colorbay _token) public onlyOwner {

    require(revocable);

    require(!revoked[_token]);

    uint256 balance = _token.balanceOf(address(this));

    uint256 unreleased = releasableAmount(_token);

    uint256 refund = balance.sub(unreleased);

    revoked[_token] = true;

    _token.safeTransfer(owner, refund);

    emit Revoked();

  }

  /**

   * @dev Calculates the amount that has already vested but hasn't been released yet.

   * @param _token Colorbay token which is being vested

   */

  function releasableAmount(Colorbay _token) public view returns (uint256) {

    return vestedAmount(_token).sub(released[_token]);

  }

  /**

   * @dev Calculates the amount that has already vested.

   * @param _token ERC20 token which is being vested

   */  function vestedAmount(Colorbay _token) public view returns (uint256) {

    uint256 currentBalance = _token.balanceOf(this);

    uint256 totalBalance = currentBalance.add(released[_token]);

        if (block.timestamp < cliff) {

      return 0;

    } else if (block.timestamp >= start.add(duration) || revoked[_token]) {

      return totalBalance;

    } else {

      return totalBalance.mul(block.timestamp.sub(start)).div(duration);

    }

  }

}

函数说明：学习

1，锁仓合约初始化函数constructor(...)，包含5个参数：区块链

  • address _beneficiary：接受通证投放的收益帐户；测试

  • uint256 _start： 起始时间（Unix time），提示从什么时刻开始计时；

  • uint256 _cliff： 单位为秒（s），断崖时间，例如“锁仓4年，1年以后一次性解冻25%”中的1年

  • uint256 _duration： 单位为秒（s），持续锁仓时间，例如“锁仓4年，1年以后一次性解冻25%”中的4年；

  • bool _revocable： 是否可回收 （例如公司给了员工张三 10K 代币锁仓4年，张三在工做一年的时候离职了，剩余的部分公司是否可回收）

举例来讲明：

若是 _cliff=半年 ，_duration=1年 具体解冻状况以下： Month 1: I get 0 tokens Month 2: I get 0 tokens Month 3: I get 0 tokens Month 4: I get 0 tokens Month 5: I get 0 tokens Month 6: I get 0 tokens --- End of cliff Month 7: I get 700 tokens (7/12th) Month 8: I get 100 tokens (8/12th) Month 9: I get 100 tokens (9/12th) Month 10: I get 100 tokens (10/12th) Month 11: I get 100 tokens (11/12th) Month 12: I get 100 tokens (12/12th)

2，期权代币释放函数release(...)，包含1个参数：

  • Colorbay _token：_token为CLB代币的实例参数，时间到后经过该函数释放给对应的收益帐户；

3，期权代币回收函数revoke(...)，包含1个参数：

  • Colorbay _token：_token为CLB代币的实例参数，把未释放的代币打回给以前的分配帐户池；

完整的代码和CLB通证的调用函数，辉哥存放到知识星球，欢迎加入下载。

image

4

测试用例验证

1]  管理员帐号发布一个ERC20的ColorBay代币合约

  • 管理员地址： 0xca35b7d915458ef540ade6068dfe2f44e8fa733c

  • 代币合约信息以下： (1) decimals = 18; (2) totalSupply() = 10亿； (3) symbol = CLB (4) paused = false (5) owner = 0xca35b7d915458ef540ade6068dfe2f44e8fa733c (6) contract address = 0x692a70d2e424a56d2c6c27aa97d1a86395877b3a

image

CLB相关信息

2] 管理员帐号转发500万给员工激励专用帐号用于期权激励专用

  • 管理员地址： 0xca35b7d915458ef540ade6068dfe2f44e8fa733c

  • 员工激励专用帐号地址： 0x14723a09acff6d2a60dcdf7aa4aff308fddc160c

  • 转帐操做：(记得去除500万后面的",") transfer("0x14723a09acff6d2a60dcdf7aa4aff308fddc160c", "5000000,000000000000000000")

  • 【结果验证】 balanceOf("0x14723a09acff6d2a60dcdf7aa4aff308fddc160c") 检查确认余额为500万CLB。

3] 当前帐号切换到员工激励专用帐号下建立期权激励计划

  • 场景假设： 激励计划起始时间为[2018.08.06 20:25]，2分钟内不得释放，持续5分钟(300s),支持回收未释放的期权

  • 员工激励专用帐号地址： 0x14723a09acff6d2a60dcdf7aa4aff308fddc160c

  • 被员工李四的私人收益帐号地址： 0x4b0897b0513fdc7c541b6d9d7e929c4e5364d2db

  • 调用函数：  constructor("0x4b0897b0513fdc7c541b6d9d7e929c4e5364d2db", "1533558300", "120", "300", true)

    【说明】如何得到准确的起始时间，可用站长工具输入具体时间来转换。

  • 期权激励智能合约实例建立成功信息以下： (1) contract address = 0x0fdf4894a3b7c5a101686829063be52ad45bcfb7

4] 在CLB合约下，把CLB通证打给期权激励智能合约地址

  • 切换到员工激励专用帐号 0x14723a09acff6d2a60dcdf7aa4aff308fddc160c

  • 执行转帐操做，（记得去除100万后面的","） transfer("0x0fdf4894a3b7c5a101686829063be52ad45bcfb7", "1000000,000000000000000000")

  • 结果 balanceOf("0x0fdf4894a3b7c5a101686829063be52ad45bcfb7") 检查确认余额为100万，表示CLB代币已经转给期权激励智能合约了。

5] [2018.08.06 17:31] 5分钟(300s)后测试分配期权

  • 执行期权是否操做 release("0x692a70d2e424a56d2c6c27aa97d1a86395877b3a")

  • 切换到CLB合约下，查询李四私人帐号 balanceOf("0x4b0897b0513fdc7c541b6d9d7e929c4e5364d2db") 检查确认余额为100万，转帐成功。

image

查询结果

6] 离职员工激励计划实施

  • 场景假设 当前帐号切换到员工激励专用帐号下建立期权激励计划，假定给员工王五作的激励，起始时间为[2018.08.06 21:00]，2分钟内不得释放，持续5分钟(300s),支持回收期权。王五在4分钟的时候离职，公司收回未激励代币，打回到员工激励专用帐号下。

  • 员工激励专用帐号： 0x14723a09acff6d2a60dcdf7aa4aff308fddc160c

  • 被员工王五私人收益帐号： 0x583031d1113ad414f02576bd6afabfb302140225

  • **执行操做： ** constructor("0x583031d1113ad414f02576bd6afabfb302140225", "1533560400", "120", "300", true)

  • 期权激励智能合约信息以下： contract address = 0x15e08fa9fe3e3aa3607ac57a29f92b5d8cb154a2

7]  在CLB合约下，通证打给期权激励智能合约地址

  • 切换到员工激励专用帐号，在CLB合约下操做 0x14723a09acff6d2a60dcdf7aa4aff308fddc160c

  • 王五期权激励智能合约实例地址： 0x15e08fa9fe3e3aa3607ac57a29f92b5d8cb154a2

  • 具体操做（记得去除100万后面的","） transfer("0x15e08fa9fe3e3aa3607ac57a29f92b5d8cb154a2", "1000000,000000000000000000")

  • 查询王五期权激励智能合约的帐户余额： balanceOf("0x15e08fa9fe3e3aa3607ac57a29f92b5d8cb154a2") 检查确认余额为100万

  • 查询员工期权激励智能合约的帐户余额： balanceOf("0x14723a09acff6d2a60dcdf7aa4aff308fddc160c") 检查确认余额为300万

8] [2018.08.06 21:03] 3分钟(180s)后测试分配期权

  • 2分钟内操做release均会失败回滚。21:03操做释放函数： release("0x692a70d2e424a56d2c6c27aa97d1a86395877b3a")

  • 切换到CLB合约下，查询王五私人帐号 balanceOf("0x583031d1113ad414f02576bd6afabfb302140225") 检查有76万代币释放到王五收益帐户。

image

9] [2018.08.06 21:05] 4分钟(240s)后，李四离职，收回分配期权

revoke("0x692a70d2e424a56d2c6c27aa97d1a86395877b3a")

  • 切换到CLB合约下，查询李四私人帐号 balanceOf("0x583031d1113ad414f02576bd6afabfb302140225") 检查有76万代币在王五收益帐户，没有增长。

image

  • 查询员工专用帐户余额 balanceOf("0x14723a09acff6d2a60dcdf7aa4aff308fddc160c")

发现王五剩余未释放的额度所有返回到员工专用帐号了。

5

商用实现需求

辉哥给了一个命题需求，看看谁能把这个需求实现。除了功能，要提供网页查询页面，用户输入以太坊地址，能够查到对应帐户的期权代币总额，已释放额度，未释放额度。

某项目方发布10亿的代币总额，其中：

1] 机构方私募为 1.5 亿枚， 上交易所后私募锁仓三个月，以后逐月释放 20%；

2] 基金会核心运做团队持有 2 亿枚， 锁定一年， 两年内逐步释放；

3] 社区建设 1 亿枚， 海外社区核心团队， 锁定一年，两年内逐步释放。

转化为具体的时间点动做为：

1] 私募总额1.5亿枚，2018.09.01上交易所，私募锁仓三个月到2018.12.01到期，以后逐月释放状况

[2019.01.01 - 20%, 3000万枚; 2019.02.01 - 20%, 3000万枚; 2019.03.01 - 20%, 3000万枚; 2019.04.01 20%, 3000万枚; 2019.05.01 20%, 3000万枚; ]

2] 基金会核心运做团队 2亿枚,2018.09.01上交易所，锁定一年到2019.09.01， 两年内按月逐步释放；

[2019.10.01 - 2亿1/24, 约833万枚; ...; 2020.10.01 - 2亿1/24, 约833万枚;]

3]  海外社区核心团队 1 亿枚，2018.09.01上交易所，锁定一年到2019.09.01，两年内逐步释放；

[2019.10.01 - 1亿1/24, 约416万枚; ...; 2020.10.01 - 1亿1/24, 约416万枚;]

6

参考资料

1）关于ERC20代币的锁仓（https://zhuanlan.zhihu.com/p/36439229）

2） 受权和释放合约（https://github.com/OpenZeppelin/openzeppelin-solidity/blob/master/contracts/token/ERC20/TokenVesting.sol）

3） 定时释放合约（https://github.com/OpenZeppelin/openzeppelin-solidity/blob/master/contracts/token/ERC20/TokenTimelock.sol）

本文做者：HiBlock区块链技术布道群-辉哥

原文发布于简书

原文连接：

https://www.jianshu.com/p/db7cb9431ecc

加微信baobaotalk_com，加入技术布道群

线上课程推荐  学习还能赚钱

线上课程1：《揭开神秘的数字货币交易-2节课创建一个数字货币交易所》

培训讲师：墨村程序猿 虎头锤

课程原价：199元，现价 49元

更多福利：

  • @全部人，识别下图二维码转发课程邀请好友报名，便可得到报名费50%返利（学习还能够赚钱，全部人都可参与，分享越多赚的越多）

image

线上课程2：《8小时区块链智能合约开发实践》

培训讲师：《白话区块链》做者 蒋勇

课程原价：999元，现价 399元

更多福利：

  • @全部人，识别下图二维码转发课程邀请好友报名，便可得到报名费50%返利（学习还能够赚钱，全部人都可参与，分享越多赚的越多）

  • @学员，报名学习课程并在规定时间内完成考试便可瓜分10000元奖金

image

如下是咱们的社区介绍，欢迎各类合做、交流、学习：）

image

相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程