Переходим на сайт тестнета, меняем кошелек на SUI и коннектим его.

Не забываем переключиться в кошельке SUI на Testnet.

Далеем запрашиваем тестовые токены для свапов. Не забывайте заклеймить тестовые SUI внутри самого кошелька для этих транзакций. Если внутренний кран не работает, пробуйте этот.

Далее гоняем туда-сюда монеты в нескольких парах и сохраняем ID транзакции свапов для гугл-формы.

Все транзакции можно глянуть в эксплорере суи. Там вводим свой адрес SUI и копируем айди.

Заливаем ликвидность

Идем в пулы и выбираем доступный.

Выбираем монеты, кол-во и жмем добавить ликвидность.

Подтверждаем транзу и сохраняем айди для формы. Также нужно заскринить добавленную ликвидность.

Теперь нужно изъять ликвидность из своего пула.

В открывшейся вкладке выбираем процент изъятия (я взял 50%) и жмем Remove. Подтверждаем транзакцию.

Теперь идем к ним в дискорд в раздел feedback и оставляем ревью, как вы с кайфом выполняли задания тестнета. Также отправляем скрины и транзакции в эту форму.

P.S.S. Рекомендуют оставлять данные дискорда Kethali#3401 и твиттера.

Hardhat Tools

Hardhat - это среда разработки Ethereum для разработчиков, которая позволяет выполнять частые задачи.

Помимо простого развертывания контрактов и запуска тестов, Hardhat предоставляет еще несколько функций, которые делают его более мощным и уникальным.

Давайте рассмотрим эти возможности по порядку.

Hardhat Network

Hardhat поставляется в комплекте с Hardhat Network — локальной нодой сети Ethereum для разработки, который предоставляет множество функций, таких как автоматические сообщения об ошибках, форкинг сети и режимы майнинга.

Поэтому если вы используете Hardhat, вы уже по умолчанию используете Hardhat Network. Она добывает блок с каждой полученной транзакцией, по порядку и без задержек.

Plugins

Плагины — это расширения, которые могут быть загружены в программу для улучшения ее функциональности.

В разработке Hardhat используется 30+ плагинов, поэтому они считаются основой Hardhat.

Ниже перечислили некоторые из популярных плагинов с указанием их функциональных возможностей:

• nomiclabs/hardhat-ethers: Позволяет разработчикам внедрять ethers.js в Hardhat Runtime Environment.
• nomiclabs/hardhat-waffle: Позволяет добавить провайдер, совместимый с Waffle, Hardhat Runtime Environment.
• nomiclabs/hardhat-etherscan: Автоматически проверяет контракты на Etherscan.
• hardhat-gas-reporter: Gas reporter помогает подтвердить использование газа на единичный тест и среднее использование газа на метод.

Тестирование

Hardhat обеспечивает очень простую процедуру тестирования, предоставляя разработчикам возможность писать автоматизированные тесты при создании смарт-контрактов.

Hardhat предоставляет отличную документацию для понимания методов тестирования с помощью Hardhat.

Truffle Tools

Как и Hardhat, Truffle — это среда разработки, относящаяся к блокчейну Эфируима.

Truffle очень популярный фреймворк и за ним стоит большое комьюнити разработчиков.

Для разработки dapps девсы используют Truffle Suite.

Truffle Suite — это экосистема Web 3 разработки, состоящая из 3х разных инструментов: Truffle, Ganache, и Drizzle:

• Truffle — это среда разработки, использующая EVM для разработки смарт-контрактов.
• Ganache — это инструмент, используемый для создания собственного локального блокчейна Ethereum, который можно использовать для развертывания и тестирования смарт-контрактов.
  Кроме того, Ganache позволяет разработчикам избежать ненужных платежей за газ в процессе разработки.
• Drizzle — это набор библиотек для фронтенда, основой которого является магазин Redux.Благодаря этому разработка фронтенда становится намного проще.

Truffle предлагает несколько различных функций, таких как:

Управление смарт-контрактами
Truffle помогает управлять артефактами смарт-контрактов, чтобы вы могли сосредоточиться на других частях процесса разработки и тратить меньше времени на организацию файлов.

Миграция и развертывание с помощью скриптов

С помощью Truffle вы можете писать скрипты развертывания, которые позволяют учитывать тот факт, что ваши Dapps будут меняться со временем.

Мощная интерактивная консоль

Truffle предоставляет 2 различные консоли, чтобы выбрать лучший инструмент для ваших нужд.

(A) Truffle Console: Базовая интерактивная консоль, подключаемая к любому клиенту Ethereum. Чтобы запустить консоль, используйте команду truffle console. Когда вы загрузите консоль, вы сразу же увидите следующее приглашение:

Консоль Truffle позволит вам подключиться к контрактам, развернутым на клиенте EVM, и взаимодействовать с ними способом, аналогичным тому, который вы используете с помощью javascript.

(B) Truffle Develop: Интерактивная консоль, которая также запускает блокчейн разработки. Она служит той же цели, что и hardhat node.

Вы можете легко запустить Truffle Develop, используя командуtruffle develop.

Truffle Dashboard

Недавно компания Truffle представила Truffle Dashboard, обеспечивающую более простой способ использования существующего кошелька Metamask для развертывания и транзакций. Вы также можете использовать Truffle Dashboard внутри любых проектов Hardhat. Truffle предоставил отличную документацию, чтобы следовать за ним и использовать Truffle Dashboard в своем проекте.

Какой инструмент наиболее полезный?

Исправление багов
Solidity трудно отлаживать. Вы просто получаете сообщение об ошибке, когда что-то ломается, и чаще всего найти, что именно пошло не так, очень трудно.

К счастью, Hardhat ввел в Solidity так называемую функцию console.log.

Таким образом, вы можете просто импортировать плагин консоли и использовать его внутри своих функций.

Вот как это выглядит:

Добавьтеconsole.log внутрь функции

Лог будет отображаться при запуске тестов:

EVM, созданный hardhat, специально поддерживает эту функцию и, следовательно, является родным для Hardhat Node. Эта возможность сама по себе является большим плюсом для Hardhat.

С другой стороны, Truffle совершенствует свой дебаг-инструмент и имеет некоторые плагины для него, но Hardhat считается более простым и мощным инструментом, используемым для исправления багов.

Библиотеки (Ethersjs and Web3)

Hardhat использует ethersjs по умолчанию, но может быть легко апнут для использования Web3. В то время как Truffle использует Web3 в качестве плагина по умолчанию для разработки.

Вы также можете использовать Etherjs в Truffle, но это считается более сложным и трудно реализуемым.

Хотя ethers-js и web3-js похожи, большинство разработчиков используют ethers-js по умолчанию.

Local Ethereum Network Node

Hardhat comes inbuilt with Hardhat Node. However, it does not have a GUI for developers to see account info in real-time.

Truffle, on the other hand, uses Ganache which has to be set up separately. However, it comes with both a CLI and a GUI version allowing flexibility for the developer.

If you prefer the GUI you should choose Ganache.

Развертывание

Для развертывания контракта Hardhat использует базовые скрипты Js, поэтому с ним легче начать работу.

В то время как Truffle использует migration-based процедуру развертывания, которые сами по себе являются js-файлами, но имеют последовательный порядок выполнения, что немного сложнее для новичка, но может быть полезно в долгосрочной перспективе, учитывая, что ваши потребности в развертывании могут измениться в будущем.

Но за простоту начала работы с развертыванием hardhat определенно берет приз.

Тестирование

Для выполнения различных тестов и Truffle, и Hardhat используют библиотеку Chai и Mocha в качестве фреймворка для тестирования, но hardhat также включает waffle. Они оба сильны, когда дело доходит до тестирования.

Статистика

До появления Hardhat самым популярным фреймворком для тестирования смарт-контрактов был Web3.

Сейчас можно увидеть, что тенденция меняется со временем, и Hardhat приобрел большую популярность по сравнению с Truffle.

Согласно статистике NPMJS, Truffle имеет почти 30 тыс. еженедельных загрузок. В то время как у Hardhat около 86 тыс. еженедельных загрузок, что вдвое больше, чем у Truffle.

Помощь комьюнити

Сообщество Truffle на Github довольно активно и полезно, в то время как комьюнити Hardhat взаимодействует на сервере Discord. Следует отметить, что Truffle поддерживается компанией Consensys, поэтому вы можете рассчитывать на "службу поддержки". Hardhat также разрабатывается и управляется организацией Nomic Foundation и имеет удивительную и не менее хорошую систему поддержки через свой сервер Discord.

Заключение

Очень трудно сказать, что лучше. Выбор между Truffle и Hardhat сводится к собственным предпочтениям и юзкейсам, поскольку оба они являются мощными инструментами.

Если вы совсем новичок в обоих фреймворках, то вам определенно стоит изучить оба и решить, что вам больше подходит.

Тем не менее, мы надеемся, что эта статья дала вам представление о различиях между ними и помогла определиться с выбором.

Не забудьте подписаться на наш канал для разработчиков и хакатонщиков — Definition. Если вы еще не сделали этого:)

Hardhat Tool

Hardhat is an Ethereum development environment for developers that allows performing frequent tasks.

Other than just deploying and running tests, Hardhat also provides some more features that make it more powerful and unique.

Let’s consider these features one by one.

Hardhat Network

Hardhat comes built-in with Hardhat Network, a local Ethereum network node designed for development providing multiple features like automated error messages, mainnet forking and mining modes.

So if you’re using Hardhat, then by default you’re already using Hardhat Network. It mines a block with each transaction that it receives, in order and with no delay.

Plugins

Plugins, in simpler words, are extensions that can be loaded on a program to improve its functionality.

There are 30+ plugins used in development with Hardhat which is why it is considered the backbone of Hardhat.

We have listed some of the popular plugins below with their functionalities:

• nomiclabs/hardhat-ethers: It allows developers to inject ethers.js into the Hardhat Runtime Environment.
• nomiclabs/hardhat-waffle: It allows you to add a Waffle-compatible provider to the Hardhat Runtime Environment.
• nomiclabs/hardhat-etherscan: It automatically verifies contracts on Etherscan
• hardhat-gas-reporter: Gas reporter helps to acknowledge the gas usage per unit test and average gas usage per method.

Testing

Hardhat provides a very simple procedure for testing smart contracts, providing developers to write automated tests when building smart contracts.

Hardhat provides great documentation for understanding testing methods with Hardhat.

Truffle Tools

Like Hardhat, Truffle is also a development environment dedicated to Ethereum blockchain.

Truffle is a highly popular development framework and provides a large community behind the tool.

For decentralized applications development, the developer uses Truffle Suite.

The Truffle Suite is an ecosystem for Web3 development that consists of three different tools: Truffle, Ganache, and Drizzle:

• Truffle is a development environment that uses the EVM for smart contract development.
• Ganache is a tool used to set up your own local Ethereum blockchain that you can use to deploy and test your smart contracts.

Other than that, Ganache enables developers to avoid paying unnecessary gas fees during the developing process.

• Drizzle is a collection of frontend libraries with a Redux store as its basis.

With this, the frontend development becomes a lot easier.

Truffle offers several different features like:

Smart Contract Management

Truffle helps you manage the artifacts of the smart contracts so that you can focus on the other parts of the development process and spend less time on the file organization.

Scriptable Migration and Deployment

With Truffle, you can write deployment scripts that allow you to account for the fact that your Dapps will change over time.

Powerful Interactive Console

Truffle provides 2 different consoles to choose the best tool for your needs.

(A) Truffle Console: A basic interactive console connecting to any Ethereum client. To launch the console, use the truffle console command. When you load the console, you'll immediately see the following prompt:

Truffle console will let you connect with the contracts deployed on the EVM client and interact with the contracts in a manner similar to the one that you would use through javascript.

(B) Truffle Develop: An interactive console that also spawns a development blockchain. It serves the same purpose as the hardhat node

You can simply launch the Truffle Develop by using the truffle develop command

Truffle Dashboard

Recently, Truffle has introduced Truffle Dashboard, providing an easier way to use your existing Metamask wallet for your deployments and transactions. Using Truffle Dashboard is not only easy but is a plug and play. You can use the Truffle Dashboard inside any Hardhat projects also. Truffle has provided great documentation to follow along and use Truffle Dashboard in your project.

Which one is more powerful?

Let's compare some of Hardhat/Truffle features and get a final answer to our question.

Debugging

Solidity is hard to debug. You just get an error message when something breaks and more often than not, it is painful to debug what exactly went wrong.

Thankfully, Hardhat introduced something known as the console.log feature for Solidity.

So you can simply import the console plugin and can use it inside your functions.

This is what it looks like:

Add some console.log inside the function

The logging output will show when you run your tests:

The EVM created by hardhat specifically supports this feature and hence is native to Hardhat Node. This feature alone is a heavy pro for Hardhat.

On the other hand, Truffle has been improving its debugger and it also has some plugins for it but Hardhat is considered a more easier and powerful tool used for debugging.

Libraries (Ethers and Web3)

Hardhat uses ethersjs by default but can be easily modified to use Web3. Whereas, Truffle uses Web3 as default plugin for development.

You can also use Etherjs with Truffle but it is considered to be trickier and hard to implement.

While ethers-js and web3-js are similar, there is a very high uptick in the number of developers using ethers-js as default.

Local Ethereum Network Node

Hardhat поставляется со встроенной нодой Hardhat. Однако у него нет графического интерфейса для разработчиков, позволяющего просматривать информацию об аккаунте в режиме реального времени.

Truffle, с другой стороны, использует Ganache, который необходимо настраивать отдельно. Однако он поставляется как с CLI, так и с GUI-версией, что обеспечивает гибкость для разработчика.

Если вы предпочитаете графический интерфейс, вам следует выбрать Ganache.

Deployment

For deploying a contract, Hardhat uses basic javascript scripts to deploy, so it’s easier to get started with it and is relatively simple to use.

Whereas, Truffle uses a migration-based deployment procedure (which are js files themselves, but have a sequential order of execution) which is a bit more complicated for a beginner, but can be helpful in the long term keeping in mind that your deployment needs might change in the future.

But for ease of getting started with deployment, hardhat definitely takes the prize.

Testing

To perform various tests, both Truffle and Hardhat use the Chai assertion library and Mocha as their testing framework but hardhat also includes waffle. They’re both strong when it comes to testing.

Statistics

Before Hardhat was launched, Web3 was the most popular framework for testing out smart contracts.

Now you can see that the trend changes over time, and Hardhat has gained more popularity as compared Truffle.

According to the NPMJS Statistics, Truffle has almost 30k weekly downloads. Whereas, Hardhat has around 86k weekly downloads, which is twice as compared Truffle’s.

Availability of Support / Helping Hand

Truffle’s Github community is quite active and helpful, whereas Hardhat provides a Discord server for their community support. It must be noted that the entire Truffle offering is supported by Consensys and hence you can expect a “support helpdesk” treatment. Hardhat too is developed and managed through an organization: the Nomic Foundation and has an amazing and equally good support system through its discord server.

Conclusion

It is really hard to say which is the best. The choice of Truffle vs Hardhat comes down to one’s own preferences and use cases, as they both are two powerful tools.

If you’re absolutely new to both frameworks, then you should definitely explore both of them and decide which one is the best for you.

However, we hope this article was able to give you an insight into the differences between them and was able to help you to find which one to use.

Don't forget to subscribe to our channel for hackathon developers — Definition. If you haven't already done so:)

• Contracts in solidity are similar to the concept of classes in Object-Oriented Languages, they can be inherited and can inherit other contracts as well.
• We can have declarations of state variables, functions, events, errors, etc.
• There are some special types of contracts also such as libraries and interfaces, which we will talk about later.
• Contracts on their own are a large topic and we will dive deep into it in upcoming parts.

In this article, we are keeping it easy and are just exploring different components of a contract. The same article in russian.

State Variables

State variables are variables whose value is permanently stored in the storage. Below is an example of a state variable.

uint storedData;

• State variables can be set to public, internal, private.
• When a state variable is declared public, the compiler will automatically generate a getter function for that variable.
• If we try to access a public variable from inside the same contract using thethis keyword then it will invoke the getter function. If we try to access the state variable without this keyword then we get the value directly from the storage.
• Declaring a variable internal works similar to protected access modifier in c/cpp. External contracts won't be able to access this variable but the derived contracts can access them.
• If we mark a variable private then external contracts and derived contracts won't be able to access it.

Note

Making something private or internal only prevents other contracts from reading or modifying the information, but it will still be visible to the whole world outside of the blockchain.

Functions

They are reusable and executable units of code that can be called again and again. Functions can be defined both inside and outside of a contract. Below is an example of a function

function helper(uint x) pure returns (uint)

Let us understand what the above code snippet means:

• The word function is a keyword that is used to declare a function.
• helper is the name of the function, by which it will be invoked later at some point.
• inside brackets, uint x means that it takes a parameter of type uint.
• word pure is also a keyword, which means that this function is not modifying or reading the variable of any state variable.
• `returns (uint) means that this function is returning a value of type uint.
• Function calls can happen internally or externally depending upon the visibility of the function.

Function Modifiers

Modifiers can be used to change the behavior of a function in a declarative way. For example, you can use a modifier to automatically check a condition prior to executing a function.

Modifiers are derivable properties of a contract only if they are marked virtual.Modifiers are overridable but NOT overloadable. Below is an example of a function modifier.

contract Mutex {
 bool locked;
 modifier noReentrancy() {
 require(
 !locked,
 "Reentrant call."
 );
 locked = true;
 _;
 locked = false;
 }

 /// This function is protected by a mutex, which means that
 /// reentrant calls from within `msg.sender.call` cannot call `f` again.
 /// The `return 7` statement assigns 7 to the return value but still
 /// executes the statement `locked = false` in the modifier.
 function f() public noReentrancy returns (uint) {
 (bool success,) = msg.sender.call("");
 require(success);
 return 7;
 }
}

Let’s understand what’s going on here.

• It is a regular contract named Mutex, which contains one Boolean variable, one modifier, and one function.

Let us understand the modifier noReetrancy.

• This modifier is taking care that no one re-enters and it is applied to the function f().
• The _ means that the function body will be executed after this and there can be multiple _ in a function, each of them will be replaced with the function body.
• After the function is returned the value will be returned but the control flow will continue, i.e, locked will be marked false afterward.
• Thus when the function will return 7 then the value locked will be re-initialized to false.
• Multiple modifiers can be applied to a function and they will be evaluated in the order presented.

Events

Events give abstractions on top of EVM’s logging functionality. Application (usually frontend apps) can subscribe to different events and can listen and act accordingly when an event is fired. Let’s see an example of an event.

event HighestBidIncreased(address bidder, uint amount); // Event function bid() public payable { // ... 
emit HighestBidIncreased(msg.sender, msg.value); // Triggering event }

Errors

The error helps to pre-define the name of the error and its data that can occur later in the code. They are used with revert statements. In comparison to string descriptions errors are much cheaper and allow us to encode additional data. Now it is time to see an example of an error

error NotEnoughFunds(uint requested, uint available); 
if (balance < amount) revert NotEnoughFunds(amount, balance);

• If we take a closer look at the example, we can see that we have defined an error which will be used when the requested amount is greater than the amount available.
• We can see that when we check the condition of insufficient balance we revert instantly with NotEnoughFunds error with current amount and balance as data of error.

Struct Types

If you are familiar with c/cpp you might be already familiar with the concept of structs. Struct is a custom/user-defined data type, that can group different variables. An example of struct type is given below.

struct Voter { // Struct 
uint weight; 
bool voted; 
address delegate; 
uint vote; 
}

Enums Types

Enums are used to define custom data types but with a finite set of possible values. Its representation is very similar to that in C programming language. Let us understand this with an example.

enum State { Created, Locked, Inactive }

• Enums can be used for state management also.
• Like in the above example we can see that State enum can have only three values/states Created, Locked and Inactive.
• We can react accordingly depending upon the State.
• You may be already familiar with the approach of state management with enum classes if you are familiar with Kotlin programming language.

Originally published at GitHub.

• Контракты в solidity похожи на концепцию классов в объектно-ориентированных языках, они могут наследоваться и могут наследовать другие контракты.
• Мы можем иметь объявления переменных состояния, функций, событий, ошибок и т.д.
• Существуют также некоторые специальные типы контрактов, такие как библиотеки и интерфейсы, о которых мы поговорим позже.
• Контракты сами по себе являются большой темой, и мы углубимся в нее в следующих частях.

В этой статье мы не будем усложнять и просто изучим различные компоненты контракта.

Переменные состояния

Переменные состояния — это переменные, значение которых постоянно хранится в памяти. Ниже приведен пример такой переменной

uint storedData;

• Переменные состояния могут быть объявлены как public, internal, private.
• Когда переменная состояния объявляется публичной, компилятор автоматически генерирует функцию getter для этой переменной.
• Если мы попытаемся получить доступ к публичной переменной изнутри того же контракта, используя ключевое слово thethis, то будет вызвана функция getter.Если мы попытаемся обратиться к переменной состояния без кейворда this, то получим значение напрямую из хранилища.
• Объявление переменной internal работает аналогично protected модификатору доступа в c/cpp. Внешние контракты не смогут получить доступ к этой переменной, но производные контракты смогут получить к ней доступ.
• Если мы пометим переменную как private, то внешние контракты и производные контракты не смогут получить к ней доступ.
  

Примечание

Придание чему-либо приватного или внутреннего характера предотвращает только чтение или изменение инфы другими контрактами, но она все равно будет видна всем за пределами блокчейна.

Функции

Они представляют собой многократно используемые и исполняемые части кода, которые можно вызывать снова и снова. Функции могут быть определены как внутри, так и вне контракта. Ниже приведен пример функции

function helper(uint x) pure returns (uint)

Давайте разберемся, что означает приведенный выше фрагмент кода.

• Слово function - это ключевое слово, которое используется для объявления функции.
• helper — это имя функции, под которым она будет вызываться в дальнейшем.
• в скобках uint x означает, что функция принимает параметр типа uint.
• слово pure также является кейвордом, что означает, что эта функция не изменяет и не читает переменную какого-либо состояния.
• `returns (uint) означает, что эта функция возвращает значение типа uint.
• вызовы функций могут происходить внутри или снаружи, в зависимости от видимости функции.

Модификаторы функций

Модификаторы можно использовать для изменения поведения функции с описанным результатом. Например, вы можете использовать модификатор для автоматической проверки условия перед выполнением функции.

Модификаторы являются производными свойствами контракта, только если они помечены как virtual. Модификаторы можно переопределять, но НЕ перегружать. Ниже приведен пример модификатора функции.

contract Mutex {
 bool locked;
 modifier noReentrancy() {
 require(
 !locked,
 "Reentrant call."
 );
 locked = true;
 _;
 locked = false;
 }

 /// This function is protected by a mutex, which means that
 /// reentrant calls from within `msg.sender.call` cannot call `f` again.
 /// The `return 7` statement assigns 7 to the return value but still
 /// executes the statement `locked = false` in the modifier.
 function f() public noReentrancy returns (uint) {
 (bool success,) = msg.sender.call("");
 require(success);
 return 7;
 }
}

Давайте разберемся, о чем эта часть кода.

• Это обычный контракт с именем Mutex, который содержит одну булевую переменную, один модификатор и одну функцию.

Давайте разберемся с модификатором noReetrancy

• Этот модификатор следит за тем, чтобы использовал повторные входы, и применяется к функцииf().
• Символ _ означает, что после него будет выполнено тело функции, причем в функции может быть _, каждая из которых будет заменена телом функции.
• После возврата функции значение будет возвращено, но флоу управления продолжится, т.е. после этого locked будет помечено как false.
• Таким образом, когда функция вернет 7, значение locked будет повторно инициализировано в false.
• К функции можно применить несколько модификаторов, и они будут оцениваться в указанном порядке.

Ивенты

Ивенты представляют собой абстракции поверх функциональности протоколирования EVM. Приложения (обычно фронтенд) могут подписываться на различные ивенты, слушать и действовать соответствующим образом при наступлении определенного события. Рассмотрим пример.

event HighestBidIncreased(address bidder, uint amount); // Event function bid() public payable { // ... 
emit HighestBidIncreased(msg.sender, msg.value); // Triggering event }

Ошибки

Класс error помогает заранее определить имя ошибки и ее данные, которые могут возникнуть позже в коде. Они используются с операторами возврата. По сравнению со string descriptionsошибки намного дешевле и позволяют кодировать дополнительную дату. Рассмотрим пример.

error NotEnoughFunds(uint requested, uint available); 
if (balance < amount) revert NotEnoughFunds(amount, balance);

• Если мы внимательно посмотрим на пример, то увидим, что мы определили error, которая будет использоваться, когда запрашиваемая сумма превышает доступную.
• При проверке условия недостаточного баланса мы мгновенно возвращаемся к ошибке NotEnoughFunds с текущей суммой и балансом в качестве данных ошибки.

Типы структур

Если вы знакомы с c/cpp, то, возможно, вам уже знакома концепция структур. Структура — это кастомный тип данных, который может группировать различные переменные. Пример типа struct приведен ниже.

struct Voter { // Struct 
uint weight; 
bool voted; 
address delegate; 
uint vote; 
}

Типы перечисления

Enums используются для определения пользовательских типов данных, но с конечным набором возможных значений. Их представление схоже с программирование на C. Давайте увидим это на примере.

enum State { Created, Locked, Inactive }

• Перечисления можно использовать и для управления состояниями.
• Как в примере выше, мы видим, что перечисление State может иметь только три значения/состояния Created, Locked и Inactive.
• Мы можем реагировать соответствующим образом в зависимости от State.
• Возможно, вы уже знакомы с подходом к управлению состояниями с помощью классов перечислений, если вы знакомы с языком программирования Kotlin.

Оригинал статьи на GitHub.

ReactJs

Библиотека JS для создания пользовательских интерфейсов.

ReactJs позволяет создавать инкапсулированные компоненты, которые позже компонуются для создания комплексных пользовательских интерфейсов.

Поскольку логика компонентов написана на JavaScript, а не в шаблонах, вы можете легко передавать дату через ваше приложение и держать состояние вне DOM.

React также может выполнять рендеринг на сервере с помощью Node и работать с мобильными приложениями с помощью React Native.

Документация ReactJs.

NodeJs

Справочная документация API предоставляет подробную информацию о функции или объекте в Node.js. Эта документация указывает, какие аргументы принимает метод, какое значение он возвращает и какие ошибки могут быть связаны с этим методом. Она также указывает, какие методы доступны для различных версий Node.js.

Эта документация описывает встроенные модули, предоставляемые Node.js. Она не cоберает модули от комьюнити.

Документация NodeJs.

Web3js

Это набор библиотек, позволяющих взаимодействовать с локальными или удаленными нодами Ethereum с помощью HTTP, IPC или WebSocket.

Приведенная ниже документация поможет вам установить и запустить web3.js, а также предоставит справочную документацию по API с примерами.

Документация Web3Js.

И еще пару туториалов от индусов и не только:)

На этом закончим статью. Надеемся, все было понятно.

Ладно, раскроем этапы чуточку подробнее. В этой статье разберем первую часть роадмэпа: языки и инструменты.

Языки для изучения

1. Solidity
2. Javascript

Solidity

Solidity — это хай-левл объектно-ориентированный язык для создания смарт-контрактов. На создания этого языка повлияли C++, Python и JavaScript. Солидити разработан для виртуальной машины Ethereum (EVM). Более подробную информацию о том, какие языки послужили источником для Solidity, можно найти в разделе «Влияние языков».

Solidity статически типизирован, поддерживает наследование, библиотеки и сложные типы среди прочих фишек.

С помощью Solidity можно создавать контракты для голосования, краудфандинга, блайнд аукционы и мульти-сигнатурные кошельки.

При развертывании контрактов следует использовать последнюю выпущенную версию Solidity. Обычно только последняя версия получает исправления безопасности. Кроме того, регулярно вносятся изменения, приводящие как к багам:) так и к новому функционалу.

Видео туториал по солидити можно глянуть ниже.

Библиотека документов по Solidity.

Javascript

Вместе с Javascript вы должны знать о front-end разработке, т.е. HTML, CSS, Bootstrap, React, Typescript.

Для изучения этого языка также есть множество бесплатных курсов, в том числе и на YouTube.

Инструменты, которые нужно освоить

Remix

Мастхэв познакомиться с Remix. Это приложение с открытым исходным кодом. Оно ускоряет разработку и имеет богатый набор плагинов с интуитивно понятным графическим интерфейсом. Ремикс используется на всем пути разработки контрактов, а также выступает в качестве игровой площадки для изучения и преподавания Ethereum.

Truffle

Среда тестирования для блокчейнов с использованием EVM. Служит для облегчения жизни девса. С Truffle вы получаете:

• Встроенную компиляцию смарт-контрактов, связывание, развертывание и бинарный менеджмент.
• Автоматизированное тестирование контрактов для быстрой разработки.
• Расширяемая сценариями структура развертывания и миграции.
• Управление сетью для развертывания в любом количестве публичных и частных сетей.
• Управление пакетами с помощью EthPM и NPM с использованием стандарта ERC190.
• Интерактивная консоль для прямого связи с контрактом.
• Настраиваемый пайплайн с поддержкой тесной интеграции.
• Внешний скрипт-бегунок, выполняющий скрипты в среде Truffle.
  

Документы по Truffle здесь.

А на видео ниже индус обучит вас Truffle за полтора часа.

UPD

В чате порекомендовали HardHat вместо Truffle. Он более гибкий и на нем можно решать более широкий круг задач. Хотя на начальном этапе нет разницы.

MetaMask

Это безопасный зашифрованный кошелек для покупки/продажи/обмена/хранения крипты. Доступен как расширение для браузера и мобильное приложение.

MetaMask предоставляет собой самый простой и в то же время безопасный способ подключения к приложениям на основе блокчейна. Вы всегда контролируете ситуацию при взаимодействии с новым децентрализованным интернетом.

MetaMask генерирует пароли и ключи на вашем устройстве, поэтому только вы имеете доступ к своим учетным записям и данным.

Ganache

Персональный блокчейн для разработки Ethereum, который можно использовать для развертывания контрактов, разработки приложений и тестирования апок. Есть декстопная версия и в виде командной строки (ранее известной как TestRPC). Ganache доступен для Windows, Mac и Linux.

Ganache — это блокчейн для быстрой разработки распределенных приложений Ethereum и Corda. Вы можете использовать Ganache на протяжении всего цикла разработки; это позволит вам разрабатывать, развертывать и тестировать ваши приложения в безопасной и детерминированной среде.

Ganache поставляется в двух вариантах: UI и CLI. Ganache UI - это декстопное приложение, поддерживающее технологии Ethereum и Corda. Инструмент командной строки, ganache-cli , доступен для разработки Ethereum.

Документы для разработки с помощью командной строки.

Схема выглядит так:
1️⃣Юзер: подписывает метатранзакцию (то есть сообщение, содержащее информацию о транзакции, которую он хотел бы выполнить).
2️⃣Релаер: веб-сервер с кошельком, который подписывает действительную транзакцию и отправляет ее в блокчейн.
3️⃣Форвард: контракт, отвечающий за проверку подписи метатранзакции, которая перенаправляет запрос контракту-получателю.
4️⃣Получатель: контракт, который пользователь намеревался вызвать без оплаты платы за газ, этот контракт должен уметь определять личность пользователя, который первоначально запросил транзакцию.

В Ethereum такие ретрансляторы организованы в сеть, в так называемую Open Gas Station Network (OGSN (https://opengsn.org/)). Механизм OGSN такой же, но сеть ретрансляторов обеспечивает децентрализацию и многие другие преимущества.

Давайте попробуем воссоздать упрощенную схему метатранзакций без кассиров, хаба ретрансляторов и др. участников.

Перенаправляющий контракт

Отправной точкой для понимания основного механизма является реализация OpenZeppelin MinimalForwarder, который будет использоваться вместе с контрактом, совместимым с ERC2771, в качестве контракта получателя.

Давайте рассмотрим контракт MinimalForwarder.sol:

contract MinimalForwarder is EIP712

Контракт соответствует предложению по усовершенствованию EIP-712, стандарту хэширования и подписи типизированных структурированных данных, реализуя схему разделителя доменов для защиты от атак повторного воспроизведения при возможном форке чейна.

struct ForwardRequest {
 address from;
 address to;
 uint256 value;
 uint256 gas;
 uint256 nonce;
 bytes data;
 }

Он имеет тип struct, определяющий необходимые поля Meta Transaction.

mapping(address => uint256) private _nonces;

Мэппинг между адресами и одноразовым токеном доступа, это связано с тем, что мета-транзакции не регистрируются в блокчейне, поэтому контракт должен самостоятельно проверять количество мета-транзакций, отправленных с данного адреса, чтобы избежать атак повторного воспроизведения.

function verify(ForwardRequest calldata req, bytes calldata signature) public view returns (bool)

Эта функция проверяет, что Мета-транзакция (ForwarderRequest) имеет валидную подпись Пользователя и ее nonce корректен.

function execute(ForwardRequest calldata req, bytes calldata signature)
 public
 payable
 returns (bool, bytes memory)
 {

После метода верификации эта функция обновляет nonce пользователя и пересылает мета-транзакцию контракту-получателю.

Контракт получателя

Теперь нам нужен пример контракта с получателем. Его иллюстрация на картинке ниже.

Этот контракт имеет в памяти объект флага, который изначально белый и не имеет владельца.

Любой пользователь может вызвать метод setFlagOwner контракта, заявить о своем праве собственности на флаг и покрасить его в тот цвет, который он предпочитает.

Контракт получателя должен работать как с прямыми, так и с перенаправленными транзакциями. Разница между ними заключается в значении msg.sender.

В перенаправленных транзакциях msg.sender — это адрес контракта форвардера. Таким образом, в этой ситуации контракт получателя должен получить фактический msg.sender из полезной нагрузки транзакции.

Это достигается путем расширения контракта @openzeppelin/contracts/metatx/ERC2771Context.sol

contract Recipient is ERC2771Context

Кроме того, контракт должен быть развернут с указанием трастового форвардера (единственного, которому разрешено пересылать транзакции):

constructor(address trustedForwarder) ERC2771Context(trustedForwarder) {}

и в коде контракта msg.sender должен быть заменен на метод _msgSender().

function setFlagOwner(string memory _color) external {
 address previousHolder = currentHolder;
 currentHolder = _msgSender();
 color = _color;
 emit FlagCaptured(previousHolder, currentHolder, color);
 }

Ниже показано, как метод _msgSender() может получить предполагаемого отправителя сообщения как для прямых, так и для перенаправленных транзакций.

function _msgSender() internal view virtual override returns (address sender) {
 if (isTrustedForwarder(msg.sender)) {
 assembly {
 sender := shr(96, calldataload(sub(calldatasize(), 20)))
 }
 } else {
 return msg.sender;
 }
 }

Аналогичные подходы, которые следует изучить:

• https://wyvernprotocol.com/docs
• https://github.com/etherdelta/smart_contract
• https://protocol.0x.org/en/latest/index.html
• https://github.com/DexyProject/protocol

Пример

Работающий пример доступен на Vercel.

Веб-интерфейс доступен для пользователей, которые хотят вызвать метод setFlagOwner без оплаты за газ. Единственным требованием является наличие установленного в браузере плагина metamask для подписи сообщений, но кто-то все равно должен платить за газ. Плата за газ (разумеется, тестовый) будет оплачиваться демо-сервером Relayer.

Код контракта и демо-сервера.

Жертве социальных сетей сообщали, в основном на YouTube или в социальных сетях, что он может покупать и продавать гэпы ликвидности на Pancakeswap.

Мошенник сообщает пользователю, что ему не нужно быть экспертом или много знать о смарт-контрактах, и отправляет ссылку для развертывания контракта.

Пример кода этого скама.

constructor(
 string memory _tokenName,
 string memory _tokenSymbol,
 uint256 _loanAmount
 ) public {
 tokenName = _tokenName;
 tokenSymbol = _tokenSymbol;
 flashLoanAmount = _loanAmount;
 router = new RouterV2();
 }

Ссылка на контракт роутера отличается от того, что говорит нам контракт. Обратите внимание, что в строке 9 написано router = new routerV2();

Помните, что это функция-конструктор, которая должна выполняться перед любой другой функцией в контракте.

Перед выполнением контракта вызывается функция router.

Скопируйте URL из роутера в браузер, и вы увидите другой контракт. Ссылка импортирует функцию router V2 в первый контракт, который запускает следующий.

contract RouterV2 {
 function pancakeRouterV2Address() public pure returns (address) {
 return 0x05fF2B0DB69458A0750badebc4f9e13aDd608C7F;
 }

 function compareStrings(string memory a, string memory b)
 public pure
 returns (bool)
 {
 return (keccak256(abi.encodePacked((a))) ==
 keccak256(abi.encodePacked((b))));
 }

 function pancakeSwapAddress() public pure returns (address) {
 return 0x65163Fd9FEac0a9B52862bC1a0e32Cd6656597f2;

 }

Заметьте разницу между двумя контрактами, проверьте адрес в эксплореле и появится вот это.

Этот счет получает ETH от ничего не подозревающих пользователей, которые запускают код и отправляют свои средства в надежде получить своп или кредит.

FLIP-COIN Scam

Один из самых древних и простых разводов. Жертве сообщают, что по конкретному адресу нужно отправить сумму монет, которая обязательно удвоится. Так скамили совсем недавно с миллионным фейковым аккаунтом Илона Маска в инстаграме с использованием дипфейка.

Мошенники использовали также аккаунты Джеффа Безоса, Apple, Uber, Барака Обамы и Джо Байдена.

На таком глупом скаме жертвы потеряли более $2 млн.

Pump and Dump Scam

Влиятельные люди, инфлиенсеры и внутренние трейдеры покупают крипту по низкой цене. Взамен рекламируют в социальных сетях и пампят за счет своей аудитории.

Инсайдер получает огромную прибыль от сброса монеты на пике пампа, зарабатывая больше денег, в то время как ничего не подозревающие покупатели теряют свои средства, когда цена падает.

Читая такие простые схемы скама, кажется, что никогда не попадешься. Но мошенники становятся изобретательнее с каждым днем. Рекомендуем прочитать статью по защите от скама просто на всякий случай.

Создание контракта

Первое, что мы должны определить, это контракт, который будет работать как чат-сервер. Для этого мы можем начать создавать простой контракт, в котором определим структуру сообщения.

pragma solidity >=0.7.0 <0.9.0;

contract Chat {

struct Message {

uint id;

address from;

string text;

}

}

Получение сообщения

Чат-приложения обычно работают с сокетами для того, чтобы "прослушивать" серверное приложение на случай отправки новых сообщений пользователю.

В Solidity способ сообщить фронтенду о том, что что-то произошло, - это события, поэтому именно их мы будем использовать для получения сообщения.

pragma solidity >=0.7.0 <0.9.0;

contract Chat {

struct Message {

uint id;

address from;

string message;

}

// tells the frontend that a new message has been sent.

event sendMessageEvent(uint indexed _id, address indexed _from, string _message);

Отправка сообщений

Для запуска действий внутри смарт-контракта мы можем поступать, как обычно в других языках программирования, вызывая функции, поэтому в данном случае мы вызовем функцию внутри смарт-контракта, которая создаст новое сообщение и запустит sendMessageEvent, чтобы сообщить получателю, что новое сообщение было отправлено.

pragma solidity >=0.7.0 <0.9.0;

contract Chat {

// ...

// We can use an autoincremental id for each new message.

uint lastMessageId;

function sendMessage(string _text) public {

// increments id and sends message.

lastMessageId++;

sendMessageEvent(lastMessageId, msg.sender, _text);

}

}

Создание диалога

Очень важной особенностью чатов является возможность не только отправлять и получать сообщения как пользователь, но и составлять список всех старых сообщений, которые мы отправляли друг другу во время разговора.

Для этого в языке программирования Solidity есть удобный тип под названием mapping . С помощью этого типа данных мы можем хранить массивы данных, сопоставленных по индексам.

pragma solidity >=0.7.0 <0.9.0;

contract Chat {

// the list of old messages in the chat

mapping(uint => Message) public messagesList;

function listMessages() public constant returns (uint[]){

// if the chat is empty

if(lastMessageId == 0) {

return new uint[](0);

}

// give me the ids.

uint[] memory ids = new uint[](lastMessageId);

// loads all the message ids on 'ids' list.

for (uint i = 1; i <= lastMessageId; i++) {

// if the sender is different than me.

if(messages[i].sender != msg.sender) {

ids[numOfMessages] = messagesList[i].id;

}

}

return ids;

}

}

Проблема теперь в том, что messageList всегда пуст, для загрузки этого списка нам нужно изменить функцию sendMessage, чтобы загружать новое сообщение в мэппинг каждый раз, когда отправляется одно сообщение.

pragma solidity >=0.7.0 <0.9.0;

contract Chat {

function sendMessage(string _text) public {

lastMessageId++;

// loads the message into the list.

messageList[messageIdCounter] = Message(

lastMessageId,

msg.sender,

_text

);

//Trigger event

newMessageEvent(lastMessageId, msg.sender, _text);

}

}

Развертывание контракта

Существует множество платформ, на которых вы можете очень просто протестировать свои собственные контракты на фронтенд-приложениях. Наиболее популярной из них является Remix, вы можете написать контракт, развернуть его в тестовой цепочке и докручивать его там.