В прошлом уроке мы написали наш первый ICO смарт-контракт! (полный список уроков тут) В этом уроке мы продолжим изучать как написать смарт-контракт ICO на эфире. И сделаем следующие улучшения:
- Установим границу сбора средств — hardcap. Т.е. если необходимая сумма в эфире собрана, то продажу токенов останавливаем. Конечно мы можем продолжить и дальше сбор. Но! Обычно цели на которые собираются средства прописываются в White Paper (информация о проекте для инвесторов). И на каждую цель указывается сумма, чтобы инвестор понимал куда пойдут его деньги. Если нет границы на сбор средств то это будет выглядеть подозрительно и у инвесторов возникнет много вопросов.
- После окончания ICO выпустим долю токенов для своих нужд. В White Paper как правило прописывается доля токенов в процентном соотношении, которая остается у основателей. Часть из них может пойти основателям в карман, часть на оплату баунти-кампаний (пиар-кампании в соц.сетях, СМИ, блогах, форумах).
Итак, приступим.
Во первых вынесем код проверки дат ICO в модификатор (код контракта ICO можно посмотреть в конце предыдущего урока). Раньше проверка у нас была такой:
1 |
require(now > start && now < start + period*24*60*60); |
А теперь будет как модификатор:
1 2 3 4 |
modifier saleIsOn() { require(now > start && now < start + period * 1 days); _; } |
Тут внимательный читатель заметит, что вместо умножения «24*60*60» мы использовали «1 days». В solidty есть встроенные единицы измерения (ссылка на официальную документацию). Вот они:
- 1 == 1 seconds
- 1 minutes == 60 seconds
- 1 hours == 60 minutes
- 1 days == 24 hours
- 1 weeks == 7 days
- 1 years == 365 days
Соответственно при их использовании происходит пересчет в секунды. Есть тонкий момент. Если вы используете число с единицей измерения, например вот так:
1 |
uint time = 2 days; |
то все будет работать нормально. Если же вы хотите умножить на переменную и запишите так
1 |
uint time = period * days; |
То компилятор будет ругаться, поэтому необходимо использовать так:
1 |
uint time = period * 1 days; |
В контракте ICO обычно полученный эфир не отсылают на адрес владельца контракта, а отсылают его на отдельный адрес. Это делается затем, что на отдельном адресе может быть как обычный аккаунт, так и контракт эскроу (специальный счет, управляемый доверенными лицами, в целях повышения доверия инвесторов — об этом мы поговорим в следующих уроках). В нашем случае мы будем задавать адрес простого аккаунта в конструкторе. Называться у нас он будет multisig.
1 |
address multisig; |
Теперь добавим ограничение на сумму, которую нам нужно собрать. Если сумма собрана, то попытка пользователя купить токены будет отклоняться. Для начала введем переменную hardcap, которая будет хранить границу суммы которую нужно собрать.
1 |
uint hardcap; |
Пока задавать значение не будем. Все это мы сделаем в конце в конструкторе контракта ICO.
Теперь напишем модификатор, который будет проверять условие по hardcap. Мы имеем верхнюю границу hardcap и адрес на который будут отправляться средства, а баланс аккаунта хранится в поле balance. Запишем наш модификатор
1 2 3 4 |
modifier isUnderHardCap() { require(multisig.balance <= hardcap); _; } |
Еще немного рефакторинга. Вынесем код из fallback (напоминаю — fallback функция вызывается у контракта, когда на него пересылают эфир) функции в отдельную функцию. Заменим условие начала распродажи на модификатор и добавим модификатор верхней границы средств.
1 2 3 4 5 6 7 8 |
function createTokens() isUnderHardCap saleIsOn payable { multisig.transfer(msg.value); token.mint(msg.sender, msg.value); } function() external payable { createTokens(); } |
Для удобств введем коэффициент пересчета эфира в наши токены. Инициализировать его также будем в конструкторе.
1 |
uint rate; |
Тогда наша функция createTokens немного изменится:
1 2 3 4 5 |
function createTokens() isUnderHardCap saleIsOn payable { multisig.transfer(msg.value); uint tokens = rate.mul(msg.value).div(1 ether); token.mint(msg.sender, tokens); } |
Мы используем операции div и mul из библиотеки безопасных математических операций SafeMath (см. урок 6), поэтому не забываем ее подключить.
1 |
using SafeMath for uint; |
Обратите внимание что функция createTokens объявлена как payable, потому что принимаем эфир. Частая ошибка когда забывают указать payable!
Теперь давайте разберемся с выпуском токенов для наших нужд. Как мы уже отмечали ранее обычно в White Paper указывается какой процент токенов пойдет на распродажу, а какой останется для разработчиков и других нужд. Наш контракт заранее не выпускает токены, поэтому мы не можем заранее узнать сколько токенов будет выпущено. Поэтому рассчитывать токены себе мы будем в конце ICO. Мы напишем функцию finishMinting, которую самостоятельно будем вызывать в конце ICO. И она нам рассчитает и выпустит токены. Для этого укажем счет — restricted . А также процент токенов, который мы хотим получить — restricedPercent.
1 2 3 |
uint restrictedPercent; address restricted; |
Осталось написать нашу функцию для расчета:
1 2 3 4 5 6 |
function finishMinting() public onlyOwner { uint issuedTokenSupply = token.totalSupply(); uint restrictedTokens = issuedTokenSupply.mul(restrictedPercent).div(100 - restrictedPercent); token.mint(restricted, restrictedTokens); token.finishMinting(); } |
В ней мы берем у контракта токена количество всех выпущенных токенов, рассчитываем сколько нужно довыпустить нам restrictedTokens. Выпускаем их на счет restricted. А дальше вызываем finishMinting у контракта токена — эта функция запрещает выпускать новые токены (Содержится в шаблоне MintableToken см. урок 6). Обратите внимание что мы не забыли использовать модификатор onlyOwner (он определен в контракте Ownable), потому как наша функция должна вызываться только владельцем контракта! В противном случае завершить ICO сможет любой посторонний человек.
Настало время посмотреть как выглядить наш контракт распродажи после всех улучшений.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 |
contract Crowdsale is Ownable { using SafeMath for uint; address multisig; uint restrictedPercent; address restricted; SimpleTokenCoin public token = new SimpleTokenCoin(); uint start; uint period; uint hardcap; uint rate; function Crowdsale() { // initialize all fields } modifier saleIsOn() { require(now > start && now < start + period * 1 days); _; } modifier isUnderHardCap() { require(multisig.balance <= hardcap); _; } function finishMinting() public onlyOwner { uint issuedTokenSupply = token.totalSupply(); uint restrictedTokens = issuedTokenSupply.mul(restrictedPercent).div(100 - restrictedPercent); token.mint(restricted, restrictedTokens); token.finishMinting(); } function createTokens() isUnderHardCap saleIsOn payable { multisig.transfer(msg.value); uint tokens = rate.mul(msg.value).div(1 ether); token.mint(msg.sender, tokens); } function() external payable { createTokens(); } } |
Осталось только инициализировать поля в конструкторе, а для этого понадобится:
- Адрес куда будет перчислятся эфир — multisig. Пусть будет 0xEA15Adb66DC92a4BbCcC8Bf32fd25E2e86a2A770.
- Адрес куда будут перечисляться токены для наших нужд — restricted. Пусть будет — 0xb3eD172CC64839FB0C0Aa06aa129f402e994e7De.
- Процент токенов на наши нужды restrictedPercent пусть будет 40%.
- Время начала ICO — GMT в UNIX формате (см. урок 7) — start. Пусть будет как в 7-мом уроке — 18 июля 2017 года в 15 часов. В UNIX — 1500379200. Для тестирования не забывайте поменять дату на свою!
- Время проведения ICO в днях — period. У нас будет 28 дней.
- rate у нас будет — 100000000000000000000
После всего этого полный контракт со всеми шаблонами выглядит так:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 |
pragma solidity ^0.4.13; /** * @title ERC20Basic * @dev Simpler version of ERC20 interface * @dev see https://github.com/ethereum/EIPs/issues/179 */ contract ERC20Basic { uint256 public totalSupply; function balanceOf(address who) constant returns (uint256); function transfer(address to, uint256 value) returns (bool); event Transfer(address indexed from, address indexed to, uint256 value); } /** * @title ERC20 interface * @dev see https://github.com/ethereum/EIPs/issues/20 */ contract ERC20 is ERC20Basic { function allowance(address owner, address spender) constant returns (uint256); function transferFrom(address from, address to, uint256 value) returns (bool); function approve(address spender, uint256 value) returns (bool); event Approval(address indexed owner, address indexed spender, uint256 value); } /** * @title SafeMath * @dev Math operations with safety checks that throw on error */ library SafeMath { function mul(uint256 a, uint256 b) internal constant returns (uint256) { uint256 c = a * b; assert(a == 0 || c / a == b); return c; } function div(uint256 a, uint256 b) internal constant returns (uint256) { // assert(b > 0); // Solidity automatically throws when dividing by 0 uint256 c = a / b; // assert(a == b * c + a % b); // There is no case in which this doesn't hold return c; } function sub(uint256 a, uint256 b) internal constant returns (uint256) { assert(b <= a); return a - b; } function add(uint256 a, uint256 b) internal constant returns (uint256) { uint256 c = a + b; assert(c >= a); return c; } } /** * @title Basic token * @dev Basic version of StandardToken, with no allowances. */ contract BasicToken is ERC20Basic { using SafeMath for uint256; mapping(address => uint256) balances; /** * @dev transfer token for a specified address * @param _to The address to transfer to. * @param _value The amount to be transferred. */ function transfer(address _to, uint256 _value) returns (bool) { balances[msg.sender] = balances[msg.sender].sub(_value); balances[_to] = balances[_to].add(_value); Transfer(msg.sender, _to, _value); return true; } /** * @dev Gets the balance of the specified address. * @param _owner The address to query the the balance of. * @return An uint256 representing the amount owned by the passed address. */ function balanceOf(address _owner) constant returns (uint256 balance) { return balances[_owner]; } } /** * @title Standard ERC20 token * * @dev Implementation of the basic standard token. * @dev https://github.com/ethereum/EIPs/issues/20 * @dev Based on code by FirstBlood: https://github.com/Firstbloodio/token/blob/master/smart_contract/FirstBloodToken.sol */ contract StandardToken is ERC20, BasicToken { mapping (address => mapping (address => uint256)) allowed; /** * @dev Transfer tokens from one address to another * @param _from address The address which you want to send tokens from * @param _to address The address which you want to transfer to * @param _value uint256 the amout of tokens to be transfered */ function transferFrom(address _from, address _to, uint256 _value) returns (bool) { var _allowance = allowed[_from][msg.sender]; // Check is not needed because sub(_allowance, _value) will already throw if this condition is not met // require (_value <= _allowance); balances[_to] = balances[_to].add(_value); balances[_from] = balances[_from].sub(_value); allowed[_from][msg.sender] = _allowance.sub(_value); Transfer(_from, _to, _value); return true; } /** * @dev Aprove the passed address to spend the specified amount of tokens on behalf of msg.sender. * @param _spender The address which will spend the funds. * @param _value The amount of tokens to be spent. */ function approve(address _spender, uint256 _value) returns (bool) { // To change the approve amount you first have to reduce the addresses` // allowance to zero by calling `approve(_spender, 0)` if it is not // already 0 to mitigate the race condition described here: // https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729 require((_value == 0) || (allowed[msg.sender][_spender] == 0)); allowed[msg.sender][_spender] = _value; Approval(msg.sender, _spender, _value); return true; } /** * @dev Function to check the amount of tokens that an owner allowed to a spender. * @param _owner address The address which owns the funds. * @param _spender address The address which will spend the funds. * @return A uint256 specifing the amount of tokens still available for the spender. */ function allowance(address _owner, address _spender) constant returns (uint256 remaining) { return allowed[_owner][_spender]; } } /** * @title Ownable * @dev The Ownable contract has an owner address, and provides basic authorization control * functions, this simplifies the implementation of "user permissions". */ contract Ownable { address public owner; /** * @dev The Ownable constructor sets the original `owner` of the contract to the sender * account. */ function Ownable() { owner = msg.sender; } /** * @dev Throws if called by any account other than the owner. */ modifier onlyOwner() { require(msg.sender == owner); _; } /** * @dev Allows the current owner to transfer control of the contract to a newOwner. * @param newOwner The address to transfer ownership to. */ function transferOwnership(address newOwner) onlyOwner { require(newOwner != address(0)); owner = newOwner; } } /** * @title Mintable token * @dev Simple ERC20 Token example, with mintable token creation * @dev Issue: * https://github.com/OpenZeppelin/zeppelin-solidity/issues/120 * Based on code by TokenMarketNet: https://github.com/TokenMarketNet/ico/blob/master/contracts/MintableToken.sol */ contract MintableToken is StandardToken, Ownable { event Mint(address indexed to, uint256 amount); event MintFinished(); bool public mintingFinished = false; modifier canMint() { require(!mintingFinished); _; } /** * @dev Function to mint tokens * @param _to The address that will recieve the minted tokens. * @param _amount The amount of tokens to mint. * @return A boolean that indicates if the operation was successful. */ function mint(address _to, uint256 _amount) onlyOwner canMint returns (bool) { totalSupply = totalSupply.add(_amount); balances[_to] = balances[_to].add(_amount); Mint(_to, _amount); return true; } /** * @dev Function to stop minting new tokens. * @return True if the operation was successful. */ function finishMinting() onlyOwner returns (bool) { mintingFinished = true; MintFinished(); return true; } } contract SimpleTokenCoin is MintableToken { string public constant name = "Simple Coint Token"; string public constant symbol = "SCT"; uint32 public constant decimals = 18; } contract Crowdsale is Ownable { using SafeMath for uint; address multisig; uint restrictedPercent; address restricted; SimpleTokenCoin public token = new SimpleTokenCoin(); uint start; uint period; uint hardcap; uint rate; function Crowdsale() { multisig = 0xEA15Adb66DC92a4BbCcC8Bf32fd25E2e86a2A770; restricted = 0xb3eD172CC64839FB0C0Aa06aa129f402e994e7De; restrictedPercent = 40; rate = 100000000000000000000; start = 1500379200; period = 28; hardcap = 10000000000000000000000; } modifier saleIsOn() { require(now > start && now < start + period * 1 days); _; } modifier isUnderHardCap() { require(multisig.balance <= hardcap); _; } function finishMinting() public onlyOwner { uint issuedTokenSupply = token.totalSupply(); uint restrictedTokens = issuedTokenSupply.mul(restrictedPercent).div(100 - restrictedPercent); token.mint(restricted, restrictedTokens); token.finishMinting(); } function createTokens() isUnderHardCap saleIsOn payable { multisig.transfer(msg.value); uint tokens = rate.mul(msg.value).div(1 ether); token.mint(msg.sender, tokens); } function() external payable { createTokens(); } } |
В этом уроке мы научились выпускать дополнительные токены по окончанию ICO. А также установили границу по сбору средств. Еще мы сделали несколько небольших улучшений. И теперь наш контракт выглядит почти как настоящий!
Ему не хватает только одной вещи — бонусов для тех инвесторов кто вкладывается пораньше. Поэтому в следующем уроке мы продолжим изучать как написать смарт-контракт ICO на эфире и займемся бонусами!
Продолжение читать тут. Предыдущий урок тут.
Если у вас возникли вопросы то можете смело писать на электронную почту (раздел «контакты«). Также приветствуется критика.
Если статья показалась вам полезной и вы желаете отблагодарить автора, то это можно сделать отослав немного эфира на адрес 0xEA15Adb66DC92a4BbCcC8Bf32fd25E2e86a2A770.
9-ая часть видится мне описанием типовой структуры виртуальной организации с учетом всех вспомогательных контрактов, коллегиальное управление счетом и так далее.
Да, это интересная тема.
Прежде чем к ней приступить необходимо познакомить читателя с возможностью
тестирования контрактов через тестовую сеть средствами кошельков MyEtherWallet и Mist. (Remix подходит только для простых контрактов).
Приблизительный план такой.
1) Отдельно будет статья по тестирования контрактов в тестовой сети.
2) 9-ая часть — добавим бонусы и мелкие доработки в ICO.
После этого закрою тему ICO и посмотрим виртуальную организацию.
Спасибо автору за труды. Опишите тему ico подробнее, интересны связи контракта ico с токеном для этого ico. т.е. мы выпускаем токен контракт, потом ico контракт.. какое кол-во токенов закладывать, как курс устанавливать (сколько токенов через ico отправлять инвестору).. тема новая и нюансов много непонятных..
Спасибо за труды!
Маленькое замечание:
Похоже, в конструкторе Crowdsale забыли инициировать поле hardcap.
Спасибо, поправил.
1. В соответствиис этим кодом, если я олтправлю 1 эфир то сколько мне придет Токенов?
2. Мы собрали определенную (заранее обозначенную) сумму и после этого к этой сумме прибавляем наши 40% токенов. И таким образом 60% у народа и 40% у нас?
Не понял, что значит строчка rate = 100000000000000000000; поясните пожалуйста?
Видимо то, что если отослать на контракт 1 эфир, тебе придет 100 SimpleTokenCoin’ов
В функции createTokens, которая вызывается при «оплате», вызывается функция token.mint(msg.sender, tokens). Она имеет модификатор «onlyOwner». Как в таком случае, покупку может совершить «сторонний» покупатель? При смене аккаунтов все работает, но я не могу понять почему.
насколько я понимаю, у контракта SimpleTokenCoin есть владелец — адрес контракта Crowdsale (когда Crowdsale разворачивается в сети, то сразу создается контракт SimpleTokenCoin). В итоге мы получаем, что token.mint(msg.sender, tokens); хоть и вызывает якобы отправитель эфира на адрес контракта Crowdsale, но дальше вызов token.mint производится от имени контракта Crowdsale (а он владелец контракта SimpleTokenCoin). Потому условие модификатора onlyOwner срабатывает при продаже токенов любому покупателю.
Если не прав в формулировках, то коллеги меня поправят.
Как можно получить токены, которые были выделены для баунти? мне не совсем понятно как они(токены для баунти) распределяются вручную или смартконтрактом ? Если смартконтрактом, тогда как это происходить можете подсказать ?
Добрый день. Где в Смарт контракте указать свой сайт, как к сайту вообще привязать? Спасибо.
Ваш комментарий ожидает проверки.
К какому сайту Вы хотите привязать?? Это смарт контракт который выкладываться в Ehter сеть, и зная его адрес вы можете получить все необходимые данные по данному контракту и купить токены.
К какому сайту Вы хотите привязать?? Это смарт контракт который выкладываться в Ehter сеть, и зная его адрес вы можете получить все необходимые данные по данному контракту и купить токены.
Подскажите привольно ли я понял, что функцию finishMinting() в Crowdsale контракте владелец должен вызвать самостоятельно(в ручную) после завершения ICO ?? И получается что владелеч может в любое время «прервать» свое ICO просто вызвав эту функцию??
Остается не ясен момент с token.mint(msg.sender, tokens);
Метод доступен только owner. Значит ли что Crowdsale является onwer для SimpleTokenCoin?
Если так, то как тогда потом управлять контрактом SimpleTokenCoin? Ведь его владелец навсегда останется Crowdsale и нельзя будет вызвать методы доступные для Owner…
После покупки токена эфир перечисляется к владельцу, а у аккаунта который купил токен как был 0 так и остается. С чем это связано?
Ребят, а хардкап и софткап в чем указывается? Эфире или токенах?