Структура смарт-контракта

Путешествие по Solidity & DeFi

Отправляемся в путь

Основы solidity

0/57

Встреча

Hello, Blockchain!

Структура смарт-контракта

Переменные состояния смарт-контракта

Функции и взаимодействие

Операции с данными — основы

Числовые и логические типы данных

Строки, байты и адреса

Локальные переменые и переменные состояния

Константы и неизменяемые переменные

Функции с множественными возвращаемыми значениями

Модификаторы видимости переменных

Модификаторы видимости функций и поведения

Продвинутые операции и безопасность

Remix IDE — знакомство с платформой

Remix IDE — продвинутые возможности

Основы обработки ошибок

Продвинутая обработка ошибок

Кастомные модификаторы

Массивы - основы упорядоченных данных

Mappings - ассоциативные структуры данных

Структуры и Enums - группировка данных

Размещение данных в памяти

Hardhat — установка и настройка

Hardhat — разработка контрактов

Hardhat — тестирование контрактов

Газ – основы. Часть 1: Единицы и опкоды

Газ – стратегии. Часть 2: Оптимизация и MEV

Оптимизация газа — искусство экономии

События

Прием ETH и payable функции

Три способа отправки эфира

Специальные функции обработки получаемого эфира

Паттерны управления деньгами

Переполнение и версии Solidity

Профессиональные техники математики в DeFi

Основы взаимодействия контрактов

Factory Pattern и создание контрактов

Абстрактные контракты и безопасность

Низкоуровневые вызовы между контрактами

Создание токена с нуля

Стандарт ERC-20 и OpenZeppelin

NFT и стандарт ERC-721

Мульти-токены ERC-1155

Основы безопасности и контроль доступа

Reentrancy и Integer Overflow атаки

Продвинутые атаки и защита

Работа со временем в Ethereum

Свойства блоков и транзакций

Основы стейкинга

ABI - основы и кодирование данных

Межконтрактные вызовы через ABI

Декодирование данных и практическое применение ABI

Хеш-функции и проверка целостности данных

Цифровые подписи и аутентификация

Продвинутая криптография и случайность

Основы DAO — децентрализованные автономные организации

Основы блокчейна

0/9

Блокчейн ноды

Адреса и кошельки в блокчейне

Блокчейн транзакции

Блоки

Консенсус и безопасность

Структура базы данных Ethereum

EVM

Ethereum как протокол

Реализация базы данных Ethereum

Основы криптографии

0/10

Алгоритмическая сложность

Хеш-функции

Майнинг и Proof of Work

Основы шифрования

Симметричные и асимметричные алгоритмы

Цифровые подписи

Кошельки, ключи и адреса

Эллиптические кривые

Факторизация

Деревья Меркла

Мир токенов

Скидки на «Starter» и «Pro» до

Выбрать тариф

Новый день — новые возможностиНа следующее утро Алекс проснулся с необычным чувством. Его первый контракт уже был развернут в блокчейне — пусть и простой, он был живым. И этот факт не давал покоя:
— «Вчера я просто поздоровался с блокчейном…» — задумчиво тянет он, глядя в потолок. — «Но сегодня я хочу большего. Просто поздороваться — это слишком просто. Хочу, чтобы с моим контрактом можно было взаимодействовать!»
Он начинает изучать документацию Solidity. И вдруг обнаруживает: для этого всего есть инструменты. Переменные. Функции. Всё, как в обычном программировании — только внутри блокчейна.
Алекс проснулся
﻿
ТерминыРазвертывание контракта — процесс публикации смарт-контракта в блокчейне. При развертывании код контракта записывается в блокчейн навсегда, получает уникальный адрес и становится доступным для взаимодействия. После развертывания контракт нельзя изменить, но можно вызывать его функции.
Лицензия — указание на условия использования кода смарт-контракта. Определяет, как можно использовать, модифицировать и распространять код. Обычно указывается в начале файла в формате SPDX.
Версия Solidity — указание на то, какая версия компилятора Solidity должна использоваться для компиляции контракта. Разные версии могут иметь разный синтаксис и возможности.
Импорт — подключение внешних библиотек или контрактов к текущему контракту. Позволяет использовать готовые проверенные решения и не писать код с нуля.
Структура (struct) — пользовательский тип данных, который группирует несколько связанных переменных под одним именем. Например, структура User может содержать имя, возраст и адрес пользователя.
Перечисление (enum) — пользовательский тип данных с ограниченным набором именованных значений. Например, статус заказа может быть только "новый", "обработанный" или "отправленный".
Событие (event) — способ уведомления внешних приложений о том, что в контракте произошло что-то важное. События записываются в логи блокчейна и могут быть отслежены.
Модификатор (modifier) — специальная конструкция, которая позволяет добавить проверки или ограничения к функциям. Используется для контроля доступа и валидации условий.
Конструктор — специальная функция, которая выполняется только один раз при создании контракта. Используется для инициализации переменных состояния и настройки начальных параметров.
Структура смарт-контрактаСмарт-контракт похож на класс в объектно-ориентированном языке программирования. Он представляет из себя набор данных и функций – действий, способных работать с данными. Обычно функции и данные в одном смарт-контракте связаны логически. Например, смарт-контракт может следить за балансом пользователя или управлять счетчиком. Одна задача – один смарт-контракт.
Смарт-контракт имеет следующую структуру:
Лицензия
Версия Solidity
Импорты
Объявление контракта
Объявление структур, перечислений, событий, модификаторов
Переменные
Конструктор
Функции
Сложный смарт-контракт
﻿
Далее мы рассмотрим каждый элемент структуры смарт-контракта.
ЛицензияЛицензия определяет, как можно использовать смарт-контракт. Например, лицензия MIT позволяет использовать код без ограничений, а лицензия GPL требует, чтобы код, созданный на основе этого кода, также был открытым. Смарт-контракты обычно имеют лицензию MIT.
Solidity
// SPDX-License-Identifier: MIT
Версия SolidityВерсия Solidity определяет, какие возможности и синтаксис будут доступны в коде.
Solidity
pragma solidity ^0.8.0;
﻿
ИмпортыПодключение библиотек позволяет использовать готовые функции и структуры, которые уже были протестированы и проверены.
Пример импорта библиотеки OpenZeppelin:
Solidity
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
﻿
import "@openzeppelin/contracts/token/ERC20/ERC20.sol";
﻿
...
Объявление контрактаОбъявление контракта задает имя смарт-контракта.
Solidity
contract MyContract {
    // Код контракта
}
Объявление структур, перечислений, событий, модификаторовСтруктуры, перечисления и события определяют типы данных, которые могут использоваться в контракте.
Структуры группируют логически связанные данные в один тип.
Перечисления позволяют создать собственный тип данных с ограниченным набором именованных вариантов. Например, статус пользователя может быть только "активный", "заблокированный" или "удаленный" — никаких других значений быть не может.
События используются для уведомления внешнего мира о произошедших событиях.
Solidity
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
﻿
contract SimpleStorage {
    // Структура, хранящая айди пользователя, его имя и статус
    struct User {
        uint256 id;
        string name;
        UserStatus status;
    }
﻿
    // Перечисление статусов пользователя
    enum UserStatus {
        ACTIVE,
        INACTIVE,
        BANNED
    }
﻿
    // Событие, уведомляющее о том, что пользователь изменил свое имя
    event NameChanged(uint256 id, string name);
﻿
    ...
}
Кастомные модификаторы используются для ограничения доступа к функциям смарт-контракта. Мы можем определить, кто может вызывать функцию, и какие действия можно выполнять с ней.
Solidity
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
﻿
contract SimpleStorage {
    ...
    // Модификатор, ограничивающий доступ к функции только для владельца контракта
    modifier onlyOwner() {
        require(msg.sender == owner, "Only owner can call this function");
        _;
    }
﻿
    // Модификатор, ограничивающий доступ к функции только для активных пользователей
    modifier onlyActive() {
        require(user.status == UserStatus.ACTIVE, "User is not active");
        _;
    }
﻿
    ...
}
Кастомные модификаторы можно указать в объявлении функции, чтобы контролировать, кто может её вызывать.
ПеременныеПеременные нужны для хранения данных в смарт-контракте. Они могут быть публичными, приватными или внутренними.
Solidity
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
﻿
contract SimpleStorage {
    ...
    uint256 public counter = 0;  // публичная переменная
    string private message = "Hello, world!"; // приватная переменная
    address internal owner; // внутренняя переменная
﻿
    ...
}
В зависимости от типа видимости переменные могут быть доступны для чтения снаружи, внутри контракта или только внутри его функций.
Важно: public переменная не означает, что её можно изменить извне! Это объявление только создает геттер – функцию для чтения переменной извне. Для изменения необходимо присвоить переменной новое значение в функции.
ФункцииФункции — это действия, которые может выполнять смарт-контракт. Они могут быть публичными, приватными или внутренними.
Solidity
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
﻿
contract SimpleStorage {
    ...
﻿
    // Функция для изменения сообщения
    function setMessage(string memory newMessage) public {
        message = newMessage;
    }
﻿
    ...
}
В зависимости от типа видимости функции могут быть доступны, либо недоступны для вызова снаружи. Например, private функции доступны для вызова только внутри другой функции текущего смарт-контракта, их невозможно вызвать извне. public функции могут быть вызваны другими смарт-контрактами или пользователелями в транзакции.
КонструкторКонструктор — это специальная функция, которая вызывается при создании смарт-контракта. Она используется для инициализации переменных.
Solidity
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
﻿
contract SimpleStorage {
﻿
    address public owner;
    ...
﻿
    constructor() {
        // Кладем в переменную owner адрес пользователя, который создал контракт
        owner = msg.sender;  
    }
﻿
    ...
}
Практическое заданиеАлекс изучил структуру смарт-контракта и решил создать свой контракт для управления пользователями. Но когда он писал код, его младший брат решил "помочь" и перемешал все части контракта! Теперь лицензия находится посередине, функции в начале, а переменные разбросаны по всему файлу.
— «Компилятор не понимает мой код! Нужно расставить все части в правильном порядке!» — в панике воскликнул Алекс.
Помоги Алексу восстановить правильную структуру смарт-контракта.
Практические задания
Загрузка...
Дополнительные материалыОфициальная документация﻿Solidity by example﻿
﻿Solidity Documentation - Contract Structure — подробное описание структуры контракта
﻿SPDX License Identifiers — список доступных лицензий для использования в смарт-контрактах

Отправляемся в путь

Основы solidity

0/57

Встреча

Hello, Blockchain!

Структура смарт-контракта

Переменные состояния смарт-контракта

Функции и взаимодействие

Операции с данными — основы

Числовые и логические типы данных

Строки, байты и адреса

Локальные переменые и переменные состояния

Константы и неизменяемые переменные

Функции с множественными возвращаемыми значениями

Модификаторы видимости переменных

Модификаторы видимости функций и поведения

Продвинутые операции и безопасность

Remix IDE — знакомство с платформой

Remix IDE — продвинутые возможности

Основы обработки ошибок

Продвинутая обработка ошибок

Кастомные модификаторы

Массивы - основы упорядоченных данных

Mappings - ассоциативные структуры данных

Структуры и Enums - группировка данных

Размещение данных в памяти

Hardhat — установка и настройка

Hardhat — разработка контрактов

Hardhat — тестирование контрактов

Газ – основы. Часть 1: Единицы и опкоды

Газ – стратегии. Часть 2: Оптимизация и MEV

Оптимизация газа — искусство экономии

События

Прием ETH и payable функции

Три способа отправки эфира

Специальные функции обработки получаемого эфира

Паттерны управления деньгами

Переполнение и версии Solidity

Профессиональные техники математики в DeFi

Основы взаимодействия контрактов

Factory Pattern и создание контрактов

Абстрактные контракты и безопасность

Низкоуровневые вызовы между контрактами

Создание токена с нуля

Стандарт ERC-20 и OpenZeppelin

NFT и стандарт ERC-721

Мульти-токены ERC-1155

Основы безопасности и контроль доступа

Reentrancy и Integer Overflow атаки

Продвинутые атаки и защита

Работа со временем в Ethereum

Свойства блоков и транзакций

Основы стейкинга

ABI - основы и кодирование данных

Межконтрактные вызовы через ABI

Декодирование данных и практическое применение ABI

Хеш-функции и проверка целостности данных

Цифровые подписи и аутентификация

Продвинутая криптография и случайность

Основы DAO — децентрализованные автономные организации

Основы блокчейна

0/9

Блокчейн ноды

Адреса и кошельки в блокчейне

Блокчейн транзакции

Блоки

Консенсус и безопасность

Структура базы данных Ethereum

EVM

Ethereum как протокол

Реализация базы данных Ethereum

Основы криптографии

0/10

Алгоритмическая сложность

Хеш-функции

Майнинг и Proof of Work

Основы шифрования

Симметричные и асимметричные алгоритмы

Цифровые подписи

Кошельки, ключи и адреса

Эллиптические кривые

Факторизация

Деревья Меркла

Мир токенов

Скидки на «Starter» и «Pro» до

Выбрать тариф

Новый день — новые возможностиНа следующее утро Алекс проснулся с необычным чувством. Его первый контракт уже был развернут в блокчейне — пусть и простой, он был живым. И этот факт не давал покоя:
— «Вчера я просто поздоровался с блокчейном…» — задумчиво тянет он, глядя в потолок. — «Но сегодня я хочу большего. Просто поздороваться — это слишком просто. Хочу, чтобы с моим контрактом можно было взаимодействовать!»
Он начинает изучать документацию Solidity. И вдруг обнаруживает: для этого всего есть инструменты. Переменные. Функции. Всё, как в обычном программировании — только внутри блокчейна.
Алекс проснулся
﻿
ТерминыРазвертывание контракта — процесс публикации смарт-контракта в блокчейне. При развертывании код контракта записывается в блокчейн навсегда, получает уникальный адрес и становится доступным для взаимодействия. После развертывания контракт нельзя изменить, но можно вызывать его функции.
Лицензия — указание на условия использования кода смарт-контракта. Определяет, как можно использовать, модифицировать и распространять код. Обычно указывается в начале файла в формате SPDX.
Версия Solidity — указание на то, какая версия компилятора Solidity должна использоваться для компиляции контракта. Разные версии могут иметь разный синтаксис и возможности.
Импорт — подключение внешних библиотек или контрактов к текущему контракту. Позволяет использовать готовые проверенные решения и не писать код с нуля.
Структура (struct) — пользовательский тип данных, который группирует несколько связанных переменных под одним именем. Например, структура User может содержать имя, возраст и адрес пользователя.
Перечисление (enum) — пользовательский тип данных с ограниченным набором именованных значений. Например, статус заказа может быть только "новый", "обработанный" или "отправленный".
Событие (event) — способ уведомления внешних приложений о том, что в контракте произошло что-то важное. События записываются в логи блокчейна и могут быть отслежены.
Модификатор (modifier) — специальная конструкция, которая позволяет добавить проверки или ограничения к функциям. Используется для контроля доступа и валидации условий.
Конструктор — специальная функция, которая выполняется только один раз при создании контракта. Используется для инициализации переменных состояния и настройки начальных параметров.
Структура смарт-контрактаСмарт-контракт похож на класс в объектно-ориентированном языке программирования. Он представляет из себя набор данных и функций – действий, способных работать с данными. Обычно функции и данные в одном смарт-контракте связаны логически. Например, смарт-контракт может следить за балансом пользователя или управлять счетчиком. Одна задача – один смарт-контракт.
Смарт-контракт имеет следующую структуру:
Лицензия
Версия Solidity
Импорты
Объявление контракта
Объявление структур, перечислений, событий, модификаторов
Переменные
Конструктор
Функции
Сложный смарт-контракт
﻿
Далее мы рассмотрим каждый элемент структуры смарт-контракта.
ЛицензияЛицензия определяет, как можно использовать смарт-контракт. Например, лицензия MIT позволяет использовать код без ограничений, а лицензия GPL требует, чтобы код, созданный на основе этого кода, также был открытым. Смарт-контракты обычно имеют лицензию MIT.
Solidity
// SPDX-License-Identifier: MIT
Версия SolidityВерсия Solidity определяет, какие возможности и синтаксис будут доступны в коде.
Solidity
pragma solidity ^0.8.0;
﻿
ИмпортыПодключение библиотек позволяет использовать готовые функции и структуры, которые уже были протестированы и проверены.
Пример импорта библиотеки OpenZeppelin:
Solidity
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
﻿
import "@openzeppelin/contracts/token/ERC20/ERC20.sol";
﻿
...
Объявление контрактаОбъявление контракта задает имя смарт-контракта.
Solidity
contract MyContract {
    // Код контракта
}
Объявление структур, перечислений, событий, модификаторовСтруктуры, перечисления и события определяют типы данных, которые могут использоваться в контракте.
Структуры группируют логически связанные данные в один тип.
Перечисления позволяют создать собственный тип данных с ограниченным набором именованных вариантов. Например, статус пользователя может быть только "активный", "заблокированный" или "удаленный" — никаких других значений быть не может.
События используются для уведомления внешнего мира о произошедших событиях.
Solidity
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
﻿
contract SimpleStorage {
    // Структура, хранящая айди пользователя, его имя и статус
    struct User {
        uint256 id;
        string name;
        UserStatus status;
    }
﻿
    // Перечисление статусов пользователя
    enum UserStatus {
        ACTIVE,
        INACTIVE,
        BANNED
    }
﻿
    // Событие, уведомляющее о том, что пользователь изменил свое имя
    event NameChanged(uint256 id, string name);
﻿
    ...
}
Кастомные модификаторы используются для ограничения доступа к функциям смарт-контракта. Мы можем определить, кто может вызывать функцию, и какие действия можно выполнять с ней.
Solidity
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
﻿
contract SimpleStorage {
    ...
    // Модификатор, ограничивающий доступ к функции только для владельца контракта
    modifier onlyOwner() {
        require(msg.sender == owner, "Only owner can call this function");
        _;
    }
﻿
    // Модификатор, ограничивающий доступ к функции только для активных пользователей
    modifier onlyActive() {
        require(user.status == UserStatus.ACTIVE, "User is not active");
        _;
    }
﻿
    ...
}
Кастомные модификаторы можно указать в объявлении функции, чтобы контролировать, кто может её вызывать.
ПеременныеПеременные нужны для хранения данных в смарт-контракте. Они могут быть публичными, приватными или внутренними.
Solidity
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
﻿
contract SimpleStorage {
    ...
    uint256 public counter = 0;  // публичная переменная
    string private message = "Hello, world!"; // приватная переменная
    address internal owner; // внутренняя переменная
﻿
    ...
}
В зависимости от типа видимости переменные могут быть доступны для чтения снаружи, внутри контракта или только внутри его функций.
Важно: public переменная не означает, что её можно изменить извне! Это объявление только создает геттер – функцию для чтения переменной извне. Для изменения необходимо присвоить переменной новое значение в функции.
ФункцииФункции — это действия, которые может выполнять смарт-контракт. Они могут быть публичными, приватными или внутренними.
Solidity
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
﻿
contract SimpleStorage {
    ...
﻿
    // Функция для изменения сообщения
    function setMessage(string memory newMessage) public {
        message = newMessage;
    }
﻿
    ...
}
В зависимости от типа видимости функции могут быть доступны, либо недоступны для вызова снаружи. Например, private функции доступны для вызова только внутри другой функции текущего смарт-контракта, их невозможно вызвать извне. public функции могут быть вызваны другими смарт-контрактами или пользователелями в транзакции.
КонструкторКонструктор — это специальная функция, которая вызывается при создании смарт-контракта. Она используется для инициализации переменных.
Solidity
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
﻿
contract SimpleStorage {
﻿
    address public owner;
    ...
﻿
    constructor() {
        // Кладем в переменную owner адрес пользователя, который создал контракт
        owner = msg.sender;  
    }
﻿
    ...
}
Практическое заданиеАлекс изучил структуру смарт-контракта и решил создать свой контракт для управления пользователями. Но когда он писал код, его младший брат решил "помочь" и перемешал все части контракта! Теперь лицензия находится посередине, функции в начале, а переменные разбросаны по всему файлу.
— «Компилятор не понимает мой код! Нужно расставить все части в правильном порядке!» — в панике воскликнул Алекс.
Помоги Алексу восстановить правильную структуру смарт-контракта.
Практические задания
Загрузка...
Дополнительные материалыОфициальная документация﻿Solidity by example﻿
﻿Solidity Documentation - Contract Structure — подробное описание структуры контракта
﻿SPDX License Identifiers — список доступных лицензий для использования в смарт-контрактах

Скидки на «Starter» и «Pro» до

Выбрать тариф

Путешествие по Solidity & DeFi

Отправляемся в путь

Основы solidity

0/57

Встреча

Hello, Blockchain!

Структура смарт-контракта

Переменные состояния смарт-контракта

Функции и взаимодействие

Операции с данными — основы

Числовые и логические типы данных

Строки, байты и адреса

Локальные переменые и переменные состояния

Константы и неизменяемые переменные

Функции с множественными возвращаемыми значениями

Модификаторы видимости переменных

Модификаторы видимости функций и поведения

Продвинутые операции и безопасность

Remix IDE — знакомство с платформой

Remix IDE — продвинутые возможности

Основы обработки ошибок

Продвинутая обработка ошибок

Кастомные модификаторы

Массивы - основы упорядоченных данных

Mappings - ассоциативные структуры данных

Структуры и Enums - группировка данных

Размещение данных в памяти

Hardhat — установка и настройка

Hardhat — разработка контрактов

Hardhat — тестирование контрактов

Газ – основы. Часть 1: Единицы и опкоды

Газ – стратегии. Часть 2: Оптимизация и MEV

Оптимизация газа — искусство экономии

События

Прием ETH и payable функции

Три способа отправки эфира

Специальные функции обработки получаемого эфира

Паттерны управления деньгами

Переполнение и версии Solidity

Профессиональные техники математики в DeFi

Основы взаимодействия контрактов

Factory Pattern и создание контрактов

Абстрактные контракты и безопасность

Низкоуровневые вызовы между контрактами

Создание токена с нуля

Стандарт ERC-20 и OpenZeppelin

NFT и стандарт ERC-721

Мульти-токены ERC-1155

Основы безопасности и контроль доступа

Reentrancy и Integer Overflow атаки

Продвинутые атаки и защита

Работа со временем в Ethereum

Свойства блоков и транзакций

Основы стейкинга

ABI - основы и кодирование данных

Межконтрактные вызовы через ABI

Декодирование данных и практическое применение ABI

Хеш-функции и проверка целостности данных

Цифровые подписи и аутентификация

Продвинутая криптография и случайность

Основы DAO — децентрализованные автономные организации

Основы блокчейна

0/9

Блокчейн ноды

Адреса и кошельки в блокчейне

Блокчейн транзакции

Блоки

Консенсус и безопасность

Структура базы данных Ethereum

EVM

Ethereum как протокол

Реализация базы данных Ethereum

Основы криптографии

0/10

Алгоритмическая сложность

Хеш-функции

Майнинг и Proof of Work

Основы шифрования

Симметричные и асимметричные алгоритмы

Цифровые подписи

Кошельки, ключи и адреса

Эллиптические кривые

Факторизация

Деревья Меркла

Мир токенов

Зарегистрируйте аккаунт

Регистрация

08.03.2025

Последнее обновление

0 — Стрик

0 — XP

0 — Стрик

0 — XP

Структура смарт-контрактаОсновы solidity, Отправляемся в путь

SolidityGetting Started

АлексBF Heroes