Withdraw Ether From Smart Contract¶
So far we have sent Ether to our Smart Contract. But there is currently no way to get Ether back out again! So, what’s next? Yes! A function to withdraw Ether would be good, ey?!
Add a Withdraw Function¶
Let’s add the following function to the Smart Contract:
This function will send all funds stored in the Smart Contract to the person who calls the «withdrawMoney()» function.
Deploy the new Smart Contract¶
- Deploy the new version and send again 1 Ether to the Smart Contract.
- To avoid confusion I recommend you close the previous Instance, we won’t need it anymore
At the end you should end up with one active Instance of your Smart Contract.
The same procedure as before:
- Put in «1 Ether» into the value input box
- hit «receiveMoney» in your new contract Instance
Your balance should be 1 Ether again:
If your balance is 0, then double check the value field
If your balance is 2 Ether, then double check the contract Instance you are interacting with!
Withdraw Funds from the Smart Contract¶
Now it’s time we use our new function! But to make things more exciting, we’re going to withdraw to a different Account.
Select the second Account from the Accounts dropdown:
Then hit the «withdrawMoney» button:
Observe the amount of Ether you have now in your Account:
It’s more than the previous 100 Ether! We got our 1 Ether through our Smart Contract into another Account! AWESOME!
Why not 101 Ether?
Are you wondering why you don’t have 101 Ether in your Account? After all, you had 100 Ether before, and now you added 1 Ether, so, why is it not 101 Ether? Is the Math you learned in school worthless?
No, the Math you learned in School comes in handy actually.
What you can observe here is the concept of «Gas» on the Ethereum Blockchain. Every transaction on Ethereum costs a little bit. And it’s not different here on a simulated chain. Same principles apply. How much is the Gas you paid, you’re wondering? Well, you can open the transaction details and see for yourself. We’re covering this — in depth — later on in the course. I also made a dedicated video and blog post about this if you want to deep dive right now.
While we can withdraw our funds now, the whole function itself is pretty useless, isn’t it?! Anyone can withdraw funds to his Account. There are no fractions of the Amount — all in all, pretty insecure.
I still hope the concept is a bit clearer now!
Let’s to another function, which allows us the send the full amount to a specific Address! It will still be insecure, but at least teaches a new concept — one at a time!
Как извлечь деньги из смарт контракта эфириум
Я новичок в технологии блокчейн, и у меня есть вопрос. Я только что развернул смарт-контракт Ethereum в тестовой сети Rinkeby и создал несколько NFT. При проверке адреса моего контракта на rinkeby.etherscan.io я вижу баланс смарт-контракта.
Вопрос в том, как я могу перевести эти эфириумы с баланса смарт-контракта на свой кошелек. Поскольку я являюсь владельцем, я должен каким-то образом получать эти ETH на свой кошелек метамаски, нет?
Работа со смарт-контрактами через Ethereum RPC API
Всем привет. В этой статье мы рассмотрим основные приемы по публикации смарт-контрактов и взаимодействию с ними с использованием Ethereum RPC API. Обсуждаемые методы API позволяют решать такие задачи:
- Создание счёта.
- Создание корректного смарт-контракта.
- Получение информации со смарт-контракта.
- Изменение состояния смарт-контракта.
- Некоторые общие замечания
- Упаковка параметров и возвращаемых данных
- Создание счёта и работа с ним
- Создание смарт-контракта
- Компиляция исходного кода смарт-контракта
- Извлечение кода из транзакции
- Рассчёт стоимости опубликования контракта
- Выполнение транзакции на публикацию контракта
- Создание контракта с параметрами
- Идентификация методов контракта
- Вызов методов запроса информации
- Вызов методов, изменяющих состояние контракта
Некоторые общие замечания
- Все предлагаемые действия иллюстрируются реальными данными из тестовой сети Rinkeby (на момент написания статьи).
- Состояние транзакций, счетов и смарт-контрактов в Rinkeby можно отслеживать по сайту https://rinkeby.etherscan.io/ (для подсети Ropsten будет, соответственно, https://ropsten.etherscan.io/).
Упаковка параметров и возвращаемых данных
Эта часть также носит общий характер и поэтому вынесена в отдельную главку, но её изучение можно отложить до момента, когда непосредственно понадобится использовать параметры или разобрать ответ смарт-контракта.
Входящий (параметры) или исходящий пакет данных для контракта формируется по следующему принципу:
- Фиксированные по длине типы данных (address, uint32, bytes32) передаются с выравниванием до 32-байтного слова (64 hex-цифры).
- Переменные по длине типы данных (строковые, массивы) передаются по следующей схеме:
- В позиции объекта в списке передается смещение блока с его данными относительно начала пакета (с выравниванием до 32-байтного слова).
- В первом 32-байтном слове блока передается число единиц данных.
- В последующих 32-байтных словах передаются сами данные.
В строке 000 передается адрес 0х570f5d143ee469d12dc29bf8b3345fa5536476d9 .
В строке 020 передается ссылка на блок, описывающий переменную типа string — 0x80 байт от начала блока.
В строке 040 передается целое число 0х1234 .
В строке 060 передается ссылка на блок, описывающий массив address[] — 0xc0 байт от начала блока.
В строке 080 передается счетчик символов переменной типа string — 3 .
В строке 0a0 передаются сами символы переменной типа string — слово New .
В строке 0c0 передается счетчик элементов массива address[] — 2 .
В строке 0e0 передается первый элемент массива address[] — 0хaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa .
В строке 100 передается второй элемент массива address[] — 0хbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb .Внимание! Весь блок передается одним слитным массивом:
Создание счёта и работа с ним
Для создания нового счёта используется метод personal_newAccount , в качестве параметра которому передаётся пароль, который в дальнейшем будет использоваться для разблокировки счёта:
В ответ приходит идентификатор счёта, в данном случае — 0xfbeda9914b78b58a0f0e810298f9d545f8379f8d .
Все дальнейшие манипуляции мы будем производить с этого счета — 0xfbeda9914b78b58a0f0e810298f9d545f8379f8d .
Теперь нам необходимо положить на него некоторую сумму для оплаты исполнения транзакций. Так как в тестовой сети Rinkeby поучаствовать в майнинге человеку со стороны невозможно, то для пополнения счетов предусмотрен специальный «кран», процедура использования которого описана здесь — https://faucet.rinkeby.io/.
Для пополнения счета необходимо:
-
Зарегистрироваться на github.com и создать новый gist:
Создание смарт-контракта
Технически смарт-контракт создаётся транзакцией, содержащей в поле данных байт-код контракта и блок параметров инициализации, если такие предусмотрены смарт-контрактом.
Байт-код контракта для формирования транзакции создания может быть получен следующими способами:
- Компиляцией из исходного текста смарт-контракта.
- Извлечением из другой транзакции создания такого же смарт-контракта.
Технически можно извлечь код транзакции непосредственно по идентификатору уже существующего смарт-контракта (метод eth_getCode), но этого делать НЕЛЬЗЯ, так как он выдаёт байт-код, подвергшийся специальной обработке при создании смарт-контракта (в частности, из него удаляются блоки инициализации).
Компиляция исходного кода смарт-контракта
Для компиляции исходного кода на Solidity я использую Remix — https://remix.ethereum.org/.
Вводим текст контракта, если ошибок нет — в поле Bytecode будет находиться собственно байткод, в нашем случае:
Извлечение кода из транзакции
Для извлечения кода из транзакции используется метод eth_getTransactionByHash . В нашем примере «клонируемый» смарт-контракт был создан транзакцией 0xc4d20bb8f9eede45968fc6bc850397e92b9f263eeb11200615cc08562d46c2e7 .
В тэге input ответа содержится байткод контракта.
Обратите внимание, что если конструктор смарт-контракта предусматривает использование параметров, то кроме байт-кода в тэге input будут указаны значения параметров, следующих сразу следом за байт-кодом. При создании шаблона смарт-контракта для последующего клонирования можно использовать нулевые значения параметров.
Расчет стоимости опубликования контракта
Для расчета стоимости опубликования контракта используется метод eth_estimateGas , в параметрах которого следует указать номер счета (тэг from ), с которого будет создан контракт, а также байт-код контракта (тэг data ). В ответе будет указано необходимое количество Gas.
Если конструктор смарт-контракта предполагает использование параметров, то они должны быть включены в запрос в тэге data сразу после байт-кода. В противном случае расчет Gas будет некорректным.
Обратите внимание, что в некоторых случаях смарт-контракты содержат семантические (не синтаксические) ошибки, которые пропускаются компилятором, но приводят к неработоспособности контракта. Одним из признаков появления такой ошибки будет резкое — в разы, возрастание стоимости создания контракта.
Выполнение транзакции на публикацию контракта
Для публикации контракта используется метод eth_sendTransaction . В качестве параметров методу передаются:
- номер счета, с которого создаётся контракт (тэг from );
- стоимость публикации в Gas (тэг gas , берется из предыдущего пункта);
- байт-код контракта с пристыкованным блоком параметров конструктора (тэг data , должен полностью совпадать с использованным в предыдущем пункте).
В ответ мы получим номер транзакции:
или сообщение об ошибке:
Теперь необходимо дождаться завершения транзакции и получить результат её исполнения — создан контракт или нет. Для этого используется метод eth_getTransactionReceipt :
Пока транзакция находится в «листе ожидания» (Pending Txn), будет выдаваться следующий ответ:
После исполнения транзакции мы получим полную «квитанцию», в теге contractAddress которой будет содержаться адрес созданного смарт-контракта:
Если в течении 5 минут квитанция не получена, то либо в сети проблемы, либо ваш узел не разослал проводку по сети. Чтобы понять истинную причину, следует просмотреть очередь Pending Txn на etherscan.io (https://rinkeby.etherscan.io/txsPending). Если транзакции там нет — значит, надо перезапустить клиент Ethereum и повторить публикацию заново.
Теперь следует проверить, корректно ли создался смарт-контракт. Для этого можно использовать метод eth_getCode — получение кода контракта по его адресу:
Если контракт создался некорректно, то будет получен ответ:
Если в тэге result выдаются некоторые данные, отличные от 0x , то контракт создан успешно.
Взаимодействие со смарт-контрактом
Для демонстрации взаимодействия со смарт-контрактом будем использовать следующий образцовый смарт-контракт:
При создании контракта (конструктор — функция Test ) ему передаются адрес Продавца ( seller_ ) и адрес Банка ( bank_ ). Метод GetStatus возвращает адресa Продавца, Банка и текущий статус контракта. Метод SetBankCert предназначен для сохранения в контракте некоторого цифрового идентификатора с переводом в статус «Confirmed».
Создание контракта с параметрами
Если конструктор смарт-контракта использует параметры (как в нашем демонстрационном примере), то они должны быть «упакованы» в соответствии с описанием «Упаковка параметров и возвращаемых данных» и присоединены в хвост к байт-коду контракта.
В нашем случае, передача адреса Продавца 0x794ce6de39fa2d274438cc1692db04dfb5bea836 и адреса Банка 0xfbeda9914 b78b58a0f0e810298f9d545f8379f8d при создании смарт-контракта будет выглядеть следующим образом (байт-код контракта кончается на 0029 ):
Еще раз обращаю внимание, что расчет Gas должен выполняться для всего блока Байт-код + Параметры, иначе контракт или не будет создан, или будет неработоспособен.
Наш тестовый демо-контракт был создан по адресу 0x3d20e579f5befdc7d3f589adb6155f684d9a751c .
Идентификация методов контракта
Для идентификации метода смарт-контракта, к которому мы обращаемся, используются первые 4 байта (8 шестнадцатеричных цифр) от хэша описания метода.
Например, для метода GetStatus демо-контракта описанием будет GetStatus() , а для метода SetBankCert — SetBankCert(address) . Особое внимание следует обратить на отсутствие пробелов в описании — были печальные прецеденты :(.
Для определения хэша используется метод web3_sha3 , при этом строчное значение следует давать в шестнадцатеричном представлении (для GetStatus() это будет 0x4765745374617475732829 ):
Соответственно, идентификатором метода GetStatus будет 0xabd95b95 , для метода SetBankCert идентификатор — 0x1bb71149 .
Вызов методов запроса информации
Для вызова методов, не связанных с изменением состояния контракта (например, для получения информации о его текущем статусе), может быть использован метод API eth_call .
Запрос метода имеет такую структуру:
Блок <Данные запроса> формируется следующим образом:
<Идентификатор метода><Данные параметров>
где <Данные параметров> формируются, как указано в пункте «Упаковка параметров и возвращаемых данных».
Если метод не предполагает наличия параметров, то блок <Данные запроса> состоит только из идентификатора метода.
Например, для вызова метода GetStatus демо-контракта Test используется запрос:
на который будет дан ответ:
Разберем полученный ответ в соответствии с правилами пункта «Упаковка параметров и возвращаемых данных» и с учетом описания метода GetStatus — function GetStatus() constant returns (address, address, string retVal).
Для удобства анализа разложим ответ на 32-байтные слова:
Исходя из описания мы ожидаем получение следующего набора переменных: address, string. Таким образом:
- в строке 000 находится адрес Продавца (тип address ) — 0x794ce6de39fa2d274438cc1692db04dfb5bea836
- в строке 020 находится адрес Продавца (тип address ) — 0xfbeda9914b78b58a0f0e810298f9d545f8379f8d
- в строке 040 находится ссылка на блок описания статуса контракта (тип string ) — блок начинается с адреса 060
- в строке 060 находится счетчик символов в строке статуса контракта — 3 символа
- в строке 080 находятся собственно символы статуса контракта в шестнадцатеричной кодировке — New
Вызов методов, изменяющих состояние контракта
Для вызова методов, изменяющих состояние контракта, должен быть использован метод API eth_sendTransaction .
Запрос метода имеет такую структуру:
<Адрес инициатора> должен иметь баланс, достаточный для выплаты <Стоимости исполнения> . Кроме того, следуют учитывать, что контракт может содержать внутренние условия по контролю <Адреса инициатора> , как, например, в методе SetBankCert нашего демо-контракта.
Блок <Данные запроса> формируется следующим образом:<Идентификатор метода><Данные параметров>
где <Данные параметров> формируются, как указано в параграфе «Упаковка параметров и возвращаемых данных».
Если метод не предполагает наличия параметров, то блок <Данные запроса> состоит только из идентификатора метода.
Например, для вызова метода SetBankCert(«0хf7b0f8870a5596a7b57dd3e035550aeb5af16607») демо-контракта, <Данные запроса> будут иметь следующий вид:
Для определения стоимости исполнения, как и при создании смарт-контракта, используется метод eth_estimateGas , в который передаются всё те же параметры, которые затем будут переданы в методе eth_sendTransaction .
Как показывает опыт, если в вызываемом методе содержится транзакционный вызов других смарт-контрактов, то сумма Gas может быть рассчитана неверно и транзакция не исполнится. Поэтому рекомендую указывать заведомо большее количество Gas, так как, по идее, излишек использован не будет. В таких случаях я указываю количество Gas, близкое к максимальному — 0х200000 .
Далее вызываем метод eth_sendTransaction :
и получаем в ответ идентификатор транзакции:
Как и в случае с созданием смарт-контракта, ожидаем исполнения транзакции, запрашивая квитанцию (метод eth_getTran sactionReceipt):
Как только квитанция пришла — транзакция исполнилась:
Однако, само по себе исполнение транзакции вовсе не означает, что смарт-контракт переключился в нужное состояние, кроме того, могут не исполниться внутренние транзакционные вызовы других смарт-контрактов.
На мой взгляд, самый надежный способ проверить, что всё отработало — снова запросить состояние смарт-контракта и убедиться, что всё изменилось «как надо».
Разобрав ответ, мы увидим, что статус изменился на «Confirmed».
Резюме
В этом руководстве мы рассмотрели выполнение ряда задач, связанных с публикацией смарт-контрактов и взаимодействием с ними с помощью RPC API блокчейн-платформы Ethereum. Разобрались, как создавать счёт, как создавать корректный смарт-контракт, получать по нему информацию и изменять его состояние, а также выяснили, как с этим смарт-контрактом взаимодействовать.
Если у вас возникнут дополнительные вопросы, рад буду ответить/подсказать.
Что такое смарт-контракты в Ethereum: полный обзор технологии
Антон Дулинец 16 июля, 2018Смарт-контракт эфириума – это условие сделки, записанное при помощи кода, которое требуется исполнить получателю и продавцу каких-либо товаров или валюты. По сути, смарт-контракт выполняет роль посредника между двумя сторонами.
Для примера, разберем небольшую транзакцию с использованием smart contract Ethereum: два пользователя решили совершить обмен криптовалюты при помощи данной технологии. Один из них отправляет свои средства в программу, где они хранятся под надежной защитой. Сейчас к ним никто не может получить доступ. Второй пользователь должен выполнить свои условия: перечислить определенную сумму в эту же программу. Как только это условие выполнено, трейдеры получают средства. Если один из участников не выполнил соглашения, деньги возвращаются обратно их владельцам.
Как только была зафиксирована сделка, все данные о ней сохраняются в blockchain. И никто не может эту информацию удалить или скорректировать – десятки тысяч копий находятся на компьютерах разных пользователей по всему миру.
Большое преимущество создания смарт-контракта на Ethereum – это его полный автоматизм. Участие посторонних людей вообще не требуется. А это значит, что пользователи могут сэкономить достаточно много денег на комиссиях, которые нужно было бы уплачивать посредникам.
Подобные сделки, кстати, проводятся и в сфере недвижимости: в прошлом году, например, в Киеве один пользователь воспользовался сервисом Propy для покупки квартиры в городе. Правда, по причине того, что официально пользоваться криптовалютами в Украине нельзя, пришлось оформлять дополнительный договор обмена. Также потребовалось обратиться к юристу для переоформления бумаг на имя другого человека: однако оплата производилась с помощью smart contract Ethereum.
Разработка смарт-контракта на Ethereum: как создавалась инновация?
Идея создания программы, которая регулировала бы финансовые сделки автоматически, появилась довольно давно. Ее разработка связана с именем Ника Сабо, который еще в 1994 году разрабатывал подобный инструмент. Однако на то время еще никто не придумал блокчейн и реализовать такие идеи было практически невозможно.
Все изменилось с появлением первой криптовалюты: в 2008 году Сатоши Накамото рассказал миру о своем продукте. В исходном коде биткоина уже тогда были встроены элементы смарт-контрактов для безопасного оформления финансовых сделок. Однако в то время разработчики популярной криптовалюты не задействовали всего потенциала блокчейна.
Но все изменилось, когда собственную цифровую валюту начал разрабатывать Виталик Бутерин со своей командой. Они решили внедрить пойти дальше всех остальных и создали эфириум контракты, которые позволили оформлять безопасные сделки в интернете с использование криптовалют.
Первоначально разработчики планировали создать лишь инструмент для безопасных операций в сети. Немного позже криптовалюта Ethereum начала становится полноценным коином, который сейчас является одним из самых популярных на рынке.
Смарт-контракты в Ethereum: где их можно использовать?
Сфера применения новой технологии очень широка: вы можете использовать Ethereum контракты практически во всех торговых сферах. Однако самое большое распространение контракт получил, конечно же, в интернет-торговле.
Сегодня потребители очень большую часть товаров покупают напрямую через интернет. И им важно знать, что они точно получать свой товар, если заплатят его онлайн-магазину. Данная инновация нашла свое применение не только в покупке мелких товаров, но также в сфере услуг.
Предположим, вы приехали на отдых в Италию и вам нужно снять квартиру на несколько недель, чтобы спокойно провести время у моря. Отлично, вы можете заранее найти подходящий вариант в интернете. Сейчас оплату можно произвести и не встречаясь с арендодателем: вы можете оформить сделку через смарт-контракт, внести определенную сумму за проживание, а также деньги в качестве залога.
Сам владелец квартиры может установить в жилище некоторые инструменты “умного дома” и, например, поставить блокировку замков при истечении двух недель. Как только время аренды завершается, замки автоматически закрываются, а вы получаете свой залог при помощи smart-contract Ethereum.
Также известны случаи, когда люди составляли завещание и помещали его в смарт-контракты. Это позволяло не обращаться к посторонним лицам для распределения наследства и быть уверенным в том, что после смерти все имущество будет распределено так, как это написано в завещании.
Сама программа будет периодически проверять список умерших, который государство размещает в сети. Как только там появится владелец наследства, все деньги автоматически перейдут в руки наследников. И все эти операции будут выполнены с помощью программы.
Нетрудно догадаться о том, что создание смарт-контракта на Ethereum подразумевает за собой интеграцию с внешними источниками информации. Проверять требуемые данные тоже можно в автоматическом режиме. Для этого используются оракулы.
Эфириум-контракты: зачем нужен оракул и как он работает?
Сегодня основные задачи, которые ставят перед собой разработчики смарт-контрактов – это совершенствование путей получения данных, которые говорили бы об исполнении условий того или иного контракта.
Оракулы созданы для того, чтобы перерабатывать полученную из источников информацию и поставлять ее в смарт-контракт Эфириума в пригодном для считывания виде. Это своеобразный посредник, который адаптирует данные.
Как вы понимаете, в сфере получения объективной информации есть некоторые проблемы: сейчас в сети очень много источников и многие из них противоречат друг другу. Поэтому задача программистов сегодня – разработка оракулов, которые смогут добывать достоверную и проверенную информацию. А этого добиться не так уж и просто.
Причем следует добиться того, чтобы оракулы имели доступ в абсолютно все возможные сферы человеческой деятельности: любые колебания цен на биржах, финансовое состояние той или иной компании и другие важные сведения. Это позволит использовать Ethereum-контракты при различных сделках и обеспечивать безопасность транзакций.
Сейчас над разработкой способов получения объективных данных работает множество специалистов. Так, например, Microsoft и IBM вкладывают огромные средства в разработку платформ, которые помогут собирать различную информацию в одном месте. Но, стоит отметить, что в данной сфере еще очень много работы.
Сегодня, кстати, многие программисты получают неплохой заработок на написании смарт-контрактов для Ethereum, ведь основная проблема при создании кода – найти путь получений важных фактов. А это трудозатратная работа, которая стоит дорого.
Создание смарт-контракта на Ethereum: основные преимущества
Что же, давайте выделим некоторые плюсы, которые может получить любой пользователь при использовании данной технологии. Почему многие эксперты считают, что данное нововведение может стать неотъемлемой частью торговли в будущем?
- Сфера применения. Вы можете использовать данные контракты практически при любых операциях. Причем транзакции с использованием смарт-контрактов всегда будут безопасными;
- Скорость обмена. По причине отсутствия посредников, скорость транзакций в разы увеличится. Давно известно, что чем меньше «цепь» из участников сделки, тем быстрее она завершается. В данном случае обмен происходит напрямую между покупателем и продавцом;
- Сохранение всех данных. Сведения о транзакциях невозможно будет подделать, удалить или изменить. Этот факт помогает предотвратить незаконные действия мошенников и обезопасить процесс торговли.
Это основные преимущества, которые делают Ethereum смарт-контракты перспективными для развития.
Смарт-контракты в Ethereum: минусы разработки
Но не все так гладко, как хотелось бы разработчикам и пользователям. При использовании данных инноваций есть некоторые недостатки, которые нельзя обойти вниманием. Почему смарт-контракты не так хороши?
- При работе с данными контрактами всегда используются криптоденьги. А они, в свою очередь, не так популярны. И во многих странах правительства их попросту игнорируют, что создает некоторые несостыковки с законом;
- Чтобы разобраться, как создать смарт-контракт на Ethereum, нужно потратить довольно много времени. Обычно его разрабатывают программисты. При его создании нельзя допускать никаких ошибок – иначе сделки будут недействительны, либо будут проводиться по неправильным алгоритмам;
- Также можно выделить ряд проблем с получением достоверных данных в сети. Объективность получаемой оракулами информации по прежнему остается спорной.
Что же, как вы можете видеть, Ethereum смарт-контракты имеют ряд преимуществ и недостатков. И сложно точно сказать о том, смогут ли они в будущем использоваться повсеместно, ведь не так легко внедрить данную технологию в жизнь. Однако частные случаи показывают, что использование подобных контрактов улучшают работу любой системы.
Что такое смарт-контракт
Смарт-контракт — компьютерный алгоритм, который формирует, хранит и автоматически регулирует договоренности между двумя или более сторонами. Как только активируется ранее прописанное условие, он тут-же выполняет соответствующее ему соглашение. Объектом могут выступать криптовалюты, акции, NFT и другие цифровые активы.
Содержание
Понятие умного контракта было введено разработчиком Нико Сабо, но оно никогда не предполагало использование искусственного интеллекта. Согласно его видению, обычный вендинговый автомат представляет собой образец смарт-контракта.
- Пользователь изучает условия соглашения.
- Принимает их, опуская деньги в купюроприемник.
- Техника автоматически выполняет договоренность — выдает покупку.
До создания блокчейна не было платформ, на которых можно было бы реализовать идею умных соглашений, поэтому она существовала только в виде концепции. Теперь, благодаря записи условий в отдельный блок блокчейна, цифровой договор не может быть подделан или аннулирован любой из сторон. Все участники берут на себя обязательства без доверия и знания друг друга. Если кто-то не выполнит свою часть, то сделка будет отменена, а объекты возвращены изначальным владельцам.
Например, при участии в ICO инвесторы без опасений переводят средства, т.к. в случае неудачного краудфандинга деньги вернуться на кошелек. Если же нужная сумма собрана и достаточное количество участников активировало ключи, то доходы пересылаются на счет разработчиков.
Как понять — Smart или не Smart
Отличия от обычных контрактов:
- концепция соблюдения (самостоятельное срабатывание независимого алгоритма),
- метод написания (программирование),
- возможные юридические последствия (практически отсутствуют, т.к. технология находится в серой зоне и не подходит под текущие законы).
Главные элементы умных соглашений.
- Наличие среды, в которой они могут фиксироваться и работать. Например, децентрализованный сервис Ethereum.
- Для электронной подписи используются публичные и приватные ключи, которыми владеют все стороны.
- Объект договора и необходимый объем средств для оплаты (как правило, криптовалюты на электронном кошельке).
- Четко прописанные условия, при которых контракт будет выполнен. Подтвержденное согласие участников сделки.
Принцип работы
Основной алгоритм работы — выполнение принципа “если… то. ”
Это значит, что если соблюдены определенные условия, то программа выполняет заранее заложенные в нее действия. Функционирование определяется кодом, записанным и запущенным в распределенной системе.
Впервые технология была применена на блокчейне биткоина, но из-за его ограниченного языка сценариев подходила только для финансовых переводов. Создавать собственные, более сложные сценарии, разработчикам позволила другая сеть. В блокчейне Etherium смарт-контракты регулируют исполнение договоренностей между пользователями. Они представлены в виде адресов, на которые направляются запросы участников сети. Личными аккаунтами являются адреса кошельков, которые не являются контрактами.
Внутри содержатся следующие данные:
- код с условиями,
- публичный ключ от создателя соглашения,
- второй публичный ключ в виде самого контракта (цифровой ID).
При проведении подходящей транзакции в сети, активируется выполнение прописанных действий. Запуск может произойти благодаря личному аккаунту пользователя или другому smart-контракту. При это запустить цепочку взаимозависимых алгоритмов может только личный аккаунт (т.е. человек).
Важно! Благодаря среде Etherium разработчики создают децентрализованные приложения (dApps), которые управляются единым универсальным протоколом. Это упрощает и ускоряет использование dApps пользователями, т.к. нет необходимости постоянно переключаться между ними.
Области применения
- ICO — первичное размещение криптовалюты и его аналоги (IFO, IDO). Умные алгоритмы защищают инвесторов и перераспределяют собранные деньги по заранее оглашенным правилам.
- Сервисы децентрализованных финансов — приложения DeFi сектора используются для выдачи кредитов, получения займов под залог цифровых ценностей. На DeFi биржах анонимно торгуют токенами, деривативами.
- DAO — децентрализованные автономные организации. Вся деятельность, в том числе и управление ресурсами, осуществляется по заранее согласованным правилам, записанными в виде четкого алгоритма. Яркий пример — The DAO, фонд венчурного инвестирования (на ICO собрано $150 млн).
- Интеллектуальная собственность. Музыка, картины, видео могут быть сконвертированы в невзаимозаменяемые токены, владение которым будет подтверждать права на привязанные к нему ценности. Например, картину Бэнкси стоимостью $95 тыс. превратили в NFT, а после сожгли. Теперь права на изображение принадлежат владельцу токена.
Перспективы дальнейшего развития
- Автоматические банковские платежи. Смарт-контракт гарантирует, что нужная сумма будет переведена в точное время на конкретные счета.
- Транзакции в энергосекторе. В будущем поставка, траты и оплата энергоресурсов могут регулироваться автоматически между источником и конечным потребителем-физлицом.
- Регистрация собственности или смена владельца. Вся сопроводительная документация может фиксироваться в блокчейне. Здесь же можно будет проследить достоверную историю объекта собственности, внести изменения через умный договор.
Топ-7 блокчейнов, поддерживающих технологию
- Ethereum. Большинство мировых децентрализованных приложений запускается именно на этом блокчейне. Основными проблемами остается масштабируемость и низкая скорость (максимум 20 бит/сек).
- RSK. Платформа на базе блокчейна Bitcoin, что делает ее одной из самых безопасных и надежных среди конкурентов. Функционал не уступает Эфириуму, и в перспективе может решить все его проблемы. Быстрому развитию мешает невысокая известность проекта.
- EOS. Основное преимущество проекта в опытной команде разработчиков, среди которых Дэн Лаример (ex Steem, Bitshares). Минус — централизация многих процессов. Например, формирование блоков доступно только для 21 узла. . Имеет четкий роадмэп, согласно которому будет децентрализовано все онлайн-пространство. Тормозит реализацию планов нестабильная медийная атмосфера вокруг проекта. То появляются слухи о болезни основателя, то он сотрудничестве с организацией Ponzi. . Генеральный директор Джэд Маккалеб (ex Ripple, Mt. Gox) заключил договора с Wirex и IBM о продвижении криптовалютной сферы в развивающихся странах. Платформа находится в сильной зависимости от нескольких узлов, из-за чего транзакции могут застрять на час и более. . Проект реализован одноименной криптовалютной биржей. Благодаря обширной маркетинговой поддержки приобрел популярность в DeFi. . ICO стало одним из наиболее успешных по показателю ROI. В сети применяется делегированный алгоритм консенсуса византийской отказоустойчивости. Это упрощает масштабирование, и при оптимизации может повысить скорость до 10000 Tps. Одна из проблем — агрессивная политика Китая, который является важной частью экосистемы NEO, по отношению к криптовалютам.
- Waves. Российский проект построен на языке программирования RIDE, созданном специально для платформы. Для проведения транзакций не используется “газ”, комиссия всегда известна заранее. До 2019 г. в сети Waves работали только ограниченные смарт-контракты, а после уже появился тип полного тюринга.
Создание и развертка смарт-контрактов
Для этого нужно знать язык программирования (Mutan, Serpent или Solidity). Как правило, разработчиками смарт-контрактов являются опытные программисты, прошедшие программу повышения квалификации. В русскоязычном сообществе ее проводит Waves Enterprise.
Базовая платформа SCP используется для создания и управления контрактами в той или иной сети. Дополнительный протокол SCMS облегчает эти процессы, добавляя графическую оболочку. То есть работа может вестись не только с помощью ручного вбивания кода.
Вот как это происходит (на примере Azure в Visual Studio Code):
- В командах выбирают “Создать проект Solidity”, далее “Базовый проект”.
- Применяют команду Build Contracts для компиляции всех контрактов проекта.
- Кликают правой кнопкой по файлу HelloBlockchain sol, в ниспадающем меню нажимают Deploy contracts.
- Выбрать сеть консорциума.
- Запустить команду Generate mnemonic, вписать название для файла с мнемоническим кодом.
Для дальнейшего развертывания используется Truffle.
Где посмотреть адреса
Узнать адрес действующего контракта на Etherium и адреса, которые туда отправляли деньги можно с помощью сервиса Etherscan . Для каждого блокчейна есть аналогичный сервис. Так, посмотреть транзакции и адреса в Binance Smart Chain можно на Bscscan . Также это можно сделать программно с помощью библиотеки Web3.
How to send and withdraw Ether from a smart contract
In this article, we’ll be checking out an example of a smart contract that will we can send money to, check it’s balance and then withdraw the money to an address only if the address calling the function is the owner, commonly known as the Owner Model.
This is actually from a bank smart contract I developed and built a website around. More on that later
Creating a smart contract with an Owner
Okay so first things first: We have to create a new file, name it MySmartContract.sol (or ideally, whatever you want lol) and add the license and Solidity version statements like this:
Then we create an address variable to store the owner of the contract below:
Next we will create a constructor that stores the address that deployed the contract as the owner. A constructor is a special function that is only called once when the contract is deployed. We will use the msg object’s sender property. msg.sender is a built-in variable in solidity that stores the address interacting with the smart contract at any given time.
Go ahead and save the contract, compile and deploy. Click the contractOwner button to see the address that deployed the contract is now the owner.
Send money to smart contract
Next, we are going to create a function that allows any address to send money to the contract.
We can use the keyword payable to specify that the function can receive Ether.
In the getBalance function, the keyword this refers to this particular contract (MySmartContract).
Now we’ll go ahead and deploy the contract and test you can send ether to the contract and check the balance of the contract
Withdraw all money from smart contract
Now, create a withdrawAll function that passes the address we wish to send the money too.
When you deploy and test out the contract, you’ll notice that anyone can run this withdrawAll function. Lets only allow to sendcontract owner to execute this function. We use the require to check for conditions and throw an exception if the condition is not met. Just to keep things secure
In this case, we check that the address calling the function is the same as the contract owner. If it fails, it will rollback the transaction. This contract now meets the Owner model where it checks if address calling the function is the owner before allowing it to proceed further.
So that’s it for this simple smart contract that allows money to be sent to it, and only allows the owner to withdraw all the money from the smart contract.
If you found this article helpful, feel free to give me a Clap, as this brightens my day knowing I may have helped someone in their journey in making stuff.
You may also send me a message if you need any further help. I’d be happy to assist.
Работа со смарт-контрактами через Ethereum RPC API
Всем привет. В этой статье мы рассмотрим основные приемы по публикации смарт-контрактов и взаимодействию с ними с использованием Ethereum RPC API. Обсуждаемые методы API позволяют решать такие задачи:
- Создание счёта.
- Создание корректного смарт-контракта.
- Получение информации со смарт-контракта.
- Изменение состояния смарт-контракта.
- Некоторые общие замечания
- Упаковка параметров и возвращаемых данных
- Создание счёта и работа с ним
- Создание смарт-контракта
- Компиляция исходного кода смарт-контракта
- Извлечение кода из транзакции
- Рассчёт стоимости опубликования контракта
- Выполнение транзакции на публикацию контракта
- Создание контракта с параметрами
- Идентификация методов контракта
- Вызов методов запроса информации
- Вызов методов, изменяющих состояние контракта
Некоторые общие замечания
- Все предлагаемые действия иллюстрируются реальными данными из тестовой сети Rinkeby (на момент написания статьи).
- Состояние транзакций, счетов и смарт-контрактов в Rinkeby можно отслеживать по сайту https://rinkeby.etherscan.io/ (для подсети Ropsten будет, соответственно, https://ropsten.etherscan.io/).
Упаковка параметров и возвращаемых данных
Эта часть также носит общий характер и поэтому вынесена в отдельную главку, но её изучение можно отложить до момента, когда непосредственно понадобится использовать параметры или разобрать ответ смарт-контракта.
Входящий (параметры) или исходящий пакет данных для контракта формируется по следующему принципу:
- Фиксированные по длине типы данных (address, uint32, bytes32) передаются с выравниванием до 32-байтного слова (64 hex-цифры).
- Переменные по длине типы данных (строковые, массивы) передаются по следующей схеме:
- В позиции объекта в списке передается смещение блока с его данными относительно начала пакета (с выравниванием до 32-байтного слова).
- В первом 32-байтном слове блока передается число единиц данных.
- В последующих 32-байтных словах передаются сами данные.
В строке 000 передается адрес 0х570f5d143ee469d12dc29bf8b3345fa5536476d9 .
В строке 020 передается ссылка на блок, описывающий переменную типа string — 0x80 байт от начала блока.
В строке 040 передается целое число 0х1234 .
В строке 060 передается ссылка на блок, описывающий массив address[] — 0xc0 байт от начала блока.
В строке 080 передается счетчик символов переменной типа string — 3 .
В строке 0a0 передаются сами символы переменной типа string — слово New .
В строке 0c0 передается счетчик элементов массива address[] — 2 .
В строке 0e0 передается первый элемент массива address[] — 0хaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa .
В строке 100 передается второй элемент массива address[] — 0хbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb .Внимание! Весь блок передается одним слитным массивом:
Создание счёта и работа с ним
Для создания нового счёта используется метод personal_newAccount , в качестве параметра которому передаётся пароль, который в дальнейшем будет использоваться для разблокировки счёта:
В ответ приходит идентификатор счёта, в данном случае — 0xfbeda9914b78b58a0f0e810298f9d545f8379f8d .
Все дальнейшие манипуляции мы будем производить с этого счета — 0xfbeda9914b78b58a0f0e810298f9d545f8379f8d .
Теперь нам необходимо положить на него некоторую сумму для оплаты исполнения транзакций. Так как в тестовой сети Rinkeby поучаствовать в майнинге человеку со стороны невозможно, то для пополнения счетов предусмотрен специальный «кран», процедура использования которого описана здесь — https://faucet.rinkeby.io/.
Для пополнения счета необходимо:
-
Зарегистрироваться на github.com и создать новый gist:
Создание смарт-контракта
Технически смарт-контракт создаётся транзакцией, содержащей в поле данных байт-код контракта и блок параметров инициализации, если такие предусмотрены смарт-контрактом.
Байт-код контракта для формирования транзакции создания может быть получен следующими способами:
- Компиляцией из исходного текста смарт-контракта.
- Извлечением из другой транзакции создания такого же смарт-контракта.
Технически можно извлечь код транзакции непосредственно по идентификатору уже существующего смарт-контракта (метод eth_getCode), но этого делать НЕЛЬЗЯ, так как он выдаёт байт-код, подвергшийся специальной обработке при создании смарт-контракта (в частности, из него удаляются блоки инициализации).
Компиляция исходного кода смарт-контракта
Для компиляции исходного кода на Solidity я использую Remix — https://remix.ethereum.org/.
Вводим текст контракта, если ошибок нет — в поле Bytecode будет находиться собственно байткод, в нашем случае:
Извлечение кода из транзакции
Для извлечения кода из транзакции используется метод eth_getTransactionByHash . В нашем примере «клонируемый» смарт-контракт был создан транзакцией 0xc4d20bb8f9eede45968fc6bc850397e92b9f263eeb11200615cc08562d46c2e7 .
В тэге input ответа содержится байткод контракта.
Обратите внимание, что если конструктор смарт-контракта предусматривает использование параметров, то кроме байт-кода в тэге input будут указаны значения параметров, следующих сразу следом за байт-кодом. При создании шаблона смарт-контракта для последующего клонирования можно использовать нулевые значения параметров.
Расчет стоимости опубликования контракта
Для расчета стоимости опубликования контракта используется метод eth_estimateGas , в параметрах которого следует указать номер счета (тэг from ), с которого будет создан контракт, а также байт-код контракта (тэг data ). В ответе будет указано необходимое количество Gas.
Если конструктор смарт-контракта предполагает использование параметров, то они должны быть включены в запрос в тэге data сразу после байт-кода. В противном случае расчет Gas будет некорректным.
Обратите внимание, что в некоторых случаях смарт-контракты содержат семантические (не синтаксические) ошибки, которые пропускаются компилятором, но приводят к неработоспособности контракта. Одним из признаков появления такой ошибки будет резкое — в разы, возрастание стоимости создания контракта.
Выполнение транзакции на публикацию контракта
Для публикации контракта используется метод eth_sendTransaction . В качестве параметров методу передаются:
- номер счета, с которого создаётся контракт (тэг from );
- стоимость публикации в Gas (тэг gas , берется из предыдущего пункта);
- байт-код контракта с пристыкованным блоком параметров конструктора (тэг data , должен полностью совпадать с использованным в предыдущем пункте).
В ответ мы получим номер транзакции:
или сообщение об ошибке:
Теперь необходимо дождаться завершения транзакции и получить результат её исполнения — создан контракт или нет. Для этого используется метод eth_getTransactionReceipt :
Пока транзакция находится в «листе ожидания» (Pending Txn), будет выдаваться следующий ответ:
После исполнения транзакции мы получим полную «квитанцию», в теге contractAddress которой будет содержаться адрес созданного смарт-контракта:
Если в течении 5 минут квитанция не получена, то либо в сети проблемы, либо ваш узел не разослал проводку по сети. Чтобы понять истинную причину, следует просмотреть очередь Pending Txn на etherscan.io (https://rinkeby.etherscan.io/txsPending). Если транзакции там нет — значит, надо перезапустить клиент Ethereum и повторить публикацию заново.
Теперь следует проверить, корректно ли создался смарт-контракт. Для этого можно использовать метод eth_getCode — получение кода контракта по его адресу:
Если контракт создался некорректно, то будет получен ответ:
Если в тэге result выдаются некоторые данные, отличные от 0x , то контракт создан успешно.
Взаимодействие со смарт-контрактом
Для демонстрации взаимодействия со смарт-контрактом будем использовать следующий образцовый смарт-контракт:
При создании контракта (конструктор — функция Test ) ему передаются адрес Продавца ( seller_ ) и адрес Банка ( bank_ ). Метод GetStatus возвращает адресa Продавца, Банка и текущий статус контракта. Метод SetBankCert предназначен для сохранения в контракте некоторого цифрового идентификатора с переводом в статус «Confirmed».
Создание контракта с параметрами
Если конструктор смарт-контракта использует параметры (как в нашем демонстрационном примере), то они должны быть «упакованы» в соответствии с описанием «Упаковка параметров и возвращаемых данных» и присоединены в хвост к байт-коду контракта.
В нашем случае, передача адреса Продавца 0x794ce6de39fa2d274438cc1692db04dfb5bea836 и адреса Банка 0xfbeda9914 b78b58a0f0e810298f9d545f8379f8d при создании смарт-контракта будет выглядеть следующим образом (байт-код контракта кончается на 0029 ):
Еще раз обращаю внимание, что расчет Gas должен выполняться для всего блока Байт-код + Параметры, иначе контракт или не будет создан, или будет неработоспособен.
Наш тестовый демо-контракт был создан по адресу 0x3d20e579f5befdc7d3f589adb6155f684d9a751c .
Идентификация методов контракта
Для идентификации метода смарт-контракта, к которому мы обращаемся, используются первые 4 байта (8 шестнадцатеричных цифр) от хэша описания метода.
Например, для метода GetStatus демо-контракта описанием будет GetStatus() , а для метода SetBankCert — SetBankCert(address) . Особое внимание следует обратить на отсутствие пробелов в описании — были печальные прецеденты :(.
Для определения хэша используется метод web3_sha3 , при этом строчное значение следует давать в шестнадцатеричном представлении (для GetStatus() это будет 0x4765745374617475732829 ):
Соответственно, идентификатором метода GetStatus будет 0xabd95b95 , для метода SetBankCert идентификатор — 0x1bb71149 .
Вызов методов запроса информации
Для вызова методов, не связанных с изменением состояния контракта (например, для получения информации о его текущем статусе), может быть использован метод API eth_call .
Запрос метода имеет такую структуру:
Блок <Данные запроса> формируется следующим образом:
<Идентификатор метода><Данные параметров>
где <Данные параметров> формируются, как указано в пункте «Упаковка параметров и возвращаемых данных».
Если метод не предполагает наличия параметров, то блок <Данные запроса> состоит только из идентификатора метода.
Например, для вызова метода GetStatus демо-контракта Test используется запрос:
на который будет дан ответ:
Разберем полученный ответ в соответствии с правилами пункта «Упаковка параметров и возвращаемых данных» и с учетом описания метода GetStatus — function GetStatus() constant returns (address, address, string retVal).
Для удобства анализа разложим ответ на 32-байтные слова:
Исходя из описания мы ожидаем получение следующего набора переменных: address, string. Таким образом:
- в строке 000 находится адрес Продавца (тип address ) — 0x794ce6de39fa2d274438cc1692db04dfb5bea836
- в строке 020 находится адрес Продавца (тип address ) — 0xfbeda9914b78b58a0f0e810298f9d545f8379f8d
- в строке 040 находится ссылка на блок описания статуса контракта (тип string ) — блок начинается с адреса 060
- в строке 060 находится счетчик символов в строке статуса контракта — 3 символа
- в строке 080 находятся собственно символы статуса контракта в шестнадцатеричной кодировке — New
Вызов методов, изменяющих состояние контракта
Для вызова методов, изменяющих состояние контракта, должен быть использован метод API eth_sendTransaction .
Запрос метода имеет такую структуру:
<Адрес инициатора> должен иметь баланс, достаточный для выплаты <Стоимости исполнения> . Кроме того, следуют учитывать, что контракт может содержать внутренние условия по контролю <Адреса инициатора> , как, например, в методе SetBankCert нашего демо-контракта.
Блок <Данные запроса> формируется следующим образом:<Идентификатор метода><Данные параметров>
где <Данные параметров> формируются, как указано в параграфе «Упаковка параметров и возвращаемых данных».
Если метод не предполагает наличия параметров, то блок <Данные запроса> состоит только из идентификатора метода.
Например, для вызова метода SetBankCert(«0хf7b0f8870a5596a7b57dd3e035550aeb5af16607») демо-контракта, <Данные запроса> будут иметь следующий вид:
Для определения стоимости исполнения, как и при создании смарт-контракта, используется метод eth_estimateGas , в который передаются всё те же параметры, которые затем будут переданы в методе eth_sendTransaction .
Как показывает опыт, если в вызываемом методе содержится транзакционный вызов других смарт-контрактов, то сумма Gas может быть рассчитана неверно и транзакция не исполнится. Поэтому рекомендую указывать заведомо большее количество Gas, так как, по идее, излишек использован не будет. В таких случаях я указываю количество Gas, близкое к максимальному — 0х200000 .
Далее вызываем метод eth_sendTransaction :
и получаем в ответ идентификатор транзакции:
Как и в случае с созданием смарт-контракта, ожидаем исполнения транзакции, запрашивая квитанцию (метод eth_getTran sactionReceipt):
Как только квитанция пришла — транзакция исполнилась:
Однако, само по себе исполнение транзакции вовсе не означает, что смарт-контракт переключился в нужное состояние, кроме того, могут не исполниться внутренние транзакционные вызовы других смарт-контрактов.
На мой взгляд, самый надежный способ проверить, что всё отработало — снова запросить состояние смарт-контракта и убедиться, что всё изменилось «как надо».
Разобрав ответ, мы увидим, что статус изменился на «Confirmed».
Резюме
В этом руководстве мы рассмотрели выполнение ряда задач, связанных с публикацией смарт-контрактов и взаимодействием с ними с помощью RPC API блокчейн-платформы Ethereum. Разобрались, как создавать счёт, как создавать корректный смарт-контракт, получать по нему информацию и изменять его состояние, а также выяснили, как с этим смарт-контрактом взаимодействовать.
Если у вас возникнут дополнительные вопросы, рад буду ответить/подсказать.