Смарт-контракты: что согласовать в блокчейн-проекте перед началом работ
Смарт-контракты — это программы, которые исполняются в блокчейне и меняют состояние учёта по заранее заданным правилам: переводят токены, фиксируют голоса, выдают доступ, ведут реестр. Заказчик обычно приходит с формулировкой «нужен смарт-контракт для…», и дальше начинается самая дорогая часть — выяснение того, что именно должно происходить, кто имеет право запускать операции и что делать, когда что-то пойдёт не так.
Ошибки на этой стадии стоят дороже самого кода. После запуска в основной сети исправление может потребовать миграции, новых договорённостей с пользователями и повторного аудита. Ниже — набор вопросов, которые стоит закрыть до начала работ: они помогают сформулировать задачу так, чтобы исполнитель оценил её реалистично, а вы получили то, что заказывали.
Материал не заменяет юридическую консультацию и не описывает правила конкретной сети: это редакционный чек-лист согласования.
Что такое смарт-контракт и что именно вы заказываете
Технически смарт-контракт состоит из трёх частей: кода, хранимого состояния (данные, балансы, права) и среды исполнения — сети, в которой он развёрнут. Меняется любая часть — меняется проект. Поэтому первый разговор с исполнителем полезно начинать не с выбора языка программирования, а с вопроса: какой учёт или какое обязательство вы переносите в код?
Типичные сценарии: учёт взносов участников, выпуск и распределение токенов, права доступа к сервису, голосования, условное перечисление средств по событию, реестр записей. В каждом случае «смарт-контракт» означает разный объём работ, разный набор рисков и разную стоимость эксплуатации.
Разделяйте смарт-контракт и юридический договор. Договор фиксирует обязательства сторон и способы защиты при их нарушении; смарт-контракт исполняет формализованные правила. Один не заменяет другой автоматически: признание записи в блокчейне, применимое право и порядок разрешения споров — вопросы, которые решает не код, а право и договорённости сторон. В проекте почти всегда есть два документа: коммерческий договор и техническая спецификация.
Отдельный вопрос — внешние данные. Контракт сам по себе не знает, что произошло за пределами блокчейна: доставлен ли товар, каков курс, подтверждён ли платёж в другой системе. Для этого нужен оракул — механизм передачи внешних данных в контракт. Это самостоятельный компонент со своими рисками: кто поставляет данные, что происходит при расхождении, кто оплачивает обновления и как отключается неисправный источник. Если в вашей схеме есть внешние события, оракулы обсуждаются на старте, а не «прикручиваются потом».
Выбор сети — тоже архитектурное решение, а не формальность. От него зависят комиссии за транзакции, доступные инструменты, совместимость с кошельками пользователей, доступность разработчиков и аудиторов. Смена сети в середине проекта обычно означает переписывание значительной части работы.
Границы задачи: сценарии, состояния и приёмка
Практический минимум согласования — перечислить события и реакции на них. Это удобно делать в виде схемы состояний или простого списка; главное, чтобы список был письменным и согласованным обеими сторонами.
- Инициализация: какие параметры задаются при развёртывании, кто их задаёт и можно ли изменить их позже.
- Обычная операция: кто и при каких условиях её вызывает, какие проверки выполняются, что происходит с данными.
- Аварийный режим: возможна ли приостановка, кто её включает, что происходит с уже начатыми операциями и обязательствами перед пользователями.
- Завершение: как выводятся средства, закрывается доступ и что остаётся в блокчейне после завершения проекта.
- Спорная ситуация: что считается ошибкой, кто и на каком основании принимает решение, предусмотрен ли механизм возврата.
Полезно отдельно проговорить, чего контракт делать не должен. Например, хранить персональные данные в открытом виде или выполнять операции, которые вы не готовы объяснить пользователям. Границы «не входит в объём» защищают обе стороны от расползания проекта.
Кто управляет контрактом: роли и ключи
У контракта почти всегда есть роли: владелец, администратор, оператор, казначей, наблюдатель с правом чтения. Для каждой роли нужно ответить на три вопроса: кто её занимает, какие действия она разрешает и как передаётся право. Отдельно фиксируется, что происходит при утере ключа, увольнении сотрудника или компрометации.
Обсудите с исполнителем разделение полномочий: критичные операции требуют подтверждения нескольких ключей (мультисиг), а не одного. Если в проекте один человек с единственным ключом, это единая точка отказа, даже если код безупречен.
Приёмочные критерии формулируются до разработки: набор сценариев, которые должны проходить в тестовой сети, требования к документации, критерии критичности замечаний и порядок, при котором замечание блокирует приёмку. Без этого спор о «готовности» решается субъективно.
Комиссии, платежи и эксплуатация
Транзакцию в сети оплачивает тот, кто её отправляет. Если операцию инициирует пользователь, расходы обычно на нём; если действия выполняет сервис — на сервисе. Это нужно решить до запуска, потому что от распределения расходов зависит и пользовательский опыт, и экономика проекта.
Если контракт принимает средства, согласуйте: адрес получателя, условия и порядок вывода, что происходит при ошибочном переводе (в блокчейне транзакции, как правило, необратимы), есть ли административный вывод и кто им управляет. Отдельно проговорите, что видит пользователь перед подтверждением операции — предупреждение о необратимости и о сумме комиссии снижает число обращений в поддержку.
Тестовая сеть похожа на основную, но не идентична: загрузка, поведение комиссий и внешних источников данных отличаются. Поэтому запуску полезно иметь план: ограниченные лимиты на первых операциях, наблюдение за событиями, назначенный ответственный и заранее описанный порядок действий при инциденте.
Эксплуатация — отдельная статья согласования. Кто следит за событиями контракта, кто реагирует на аномалии, кто обновляет зависимости и где хранится документация. Если после сдачи проекта эти обязанности ни за кем не закреплены, первая же нештатная ситуация превращается в поиск виноватого.
Безопасность: аудит, тестирование и управление доступом
Смарт-контракт работает с активами и правами, поэтому ошибка в нём — это не только баг, но и потенциальная финансовая потеря. Обсудите с исполнителем, какие классы рисков он проверяет: корректность контроля доступа, повторный вход (reentrancy), арифметические ошибки, зависимость от внешних данных, манипуляции с источниками, ошибки в логике расчётов.
Независимый аудит кода до запуска — разумная практика для проектов, которые работают с ценностями или правами пользователей. В договоре фиксируется: кто проводит аудит, по какому именно объёму кода (конкретная версия, хэш коммита), что входит в отчёт, кто и за чей счёт исправляет замечания, что считается критичным и блокирует запуск, предусмотрена ли повторная проверка исправлений.
Аудит снижает риск, но не даёт гарантии отсутствия ошибок. Поэтому к нему добавляют тесты: модульные проверки отдельных функций, сценарии «как у пользователя», проверка граничных значений и попыток нештатных вызовов.
Обновляемый контракт или неизменяемый
У этого выбора нет универсально правильного ответа, но есть последствия. Неизменяемый код нельзя исправить: при обнаружении ошибки остаётся развернуть новый контракт и провести миграцию — с новыми адресами, уведомлениями пользователей и переносом состояния. Обновляемый вариант (например, через прокси-паттерн) позволяет вносить исправления, но концентрирует власть у того, кто управляет обновлением, и добавляет поверхность атаки. Решение фиксируется до разработки, потому что архитектура в этих двух случаях разная.
Обратите внимание: операции в блокчейне, как правило, необратимы, а доступ к ключам равносилен доступу к средствам и правам. Не передавайте ключи в переписке, не храните их в одном месте и заранее опишите порядок действий при компрометации. Актуальные рекомендации по безопасности проверяйте в официальной документации выбранной сети и кошельков.
Полезная привычка: фиксируйте версию кода, которую принимаете и отправляете на аудит, — хэш коммита, версии компилятора и зависимостей. Это снимает споры о том, что именно проверялось и что именно вы принимаете.
Юридическая рамка: что проверить до старта
Код исполняется, но не отвечает на вопросы: кто стороны, какое право применяется, что происходит при ошибке и как вернуть средства. Эти вопросы закрываются договором и, при необходимости, консультацией юриста. Автоматическое исполнение само по себе не создаёт обязательств и не отменяет их.
Если проект предполагает выпуск токенов для пользователей, приём платежей, хранение средств или посредничество между сторонами, модель может подпадать под требования финансового регулирования, включая правила противодействия отмыванию денег, защиту потребителей и налоговый учёт. Это не автоматический вывод — но и не вопрос, который можно отложить до запуска. Применимые требования уточняйте по официальным источникам и у профильного юриста: правила меняются, а их применение зависит от конкретной схемы.
Отдельная тема — персональные данные. Всё, что попало в публичный блокчейн, практически невозможно удалить или изменить. Если в сценарии есть имена, контакты или идентификаторы, оцените, нужны ли они в цепи: часто достаточно хранить хэш или ссылку на запись вне блокчейна. Такое решение может требовать дополнительной проверки на соответствие требованиям к обработке персональных данных, поэтому его лучше обсуждать с юристом или ответственным за данные, а не только с разработчиком.
Что уточнить у юриста
- Как квалифицируется ваш сервис или токен и какие требования могут применяться.
- Кто является стороной договора и как он соотносится с работой кода.
- Какое право применяется и как разрешаются споры.
- Какие налоги и формы отчётности возникают у проекта и у пользователей.
- Можно ли хранить те или иные данные в блокчейне и как отвечать на запросы пользователей.
- Что и в какой форме нужно раскрыть пользователям перед операцией.
Эти вопросы не решаются «по ходу разработки»: ответы на них влияют на архитектуру и на текст пользовательских согласий.
Что зафиксировать в договоре с исполнителем
Разработка смарт-контракта — это проект с ограниченным объёмом и высокой ценой ошибки, поэтому договор строится вокруг результата и приёмки. Та же дисциплина, что при согласовании обычной разработки ПО (см. материал о согласовании разработки на C++), работает и здесь, но с поправкой на необратимость запуска.
- Объём: перечень контрактов, функций и сценариев, а также явный список того, что не входит в работу.
- Спецификация и приёмочные критерии: какие проверки должны проходить до сдачи.
- Окружения и версии: тестовая сеть, версия кода, компилятора и зависимостей.
- Аудит: кто проводит, по какой версии кода, кто исправляет замечания и что блокирует запуск.
- Права на результат: передача репозитория, документации, схем и прав на использование кода.
- Ключи и доступы: кто владеет ими в процессе работы и как они передаются заказчику.
- Ответственность и гарантийный период: что считается дефектом и в какие сроки устраняется.
- Конфиденциальность: режим работы с исходниками и данными проекта.
- Этапы и оплата: привязка платежей к проверяемым результатам, а не к календарю.
- Поддержка после запуска: мониторинг, порядок обновлений и реакция на инциденты.
Если в схеме участвуют внешние исполнители или автоматизированные сервисы, помогает та же логика согласования процессов, что описана в разборе про AI-агентов: заранее определить, кто что делает, где границы ответственности и как проверяется результат.
Типичные ошибки на старте
- Начинать с кода, а не со сценариев. Исполнитель пишет то, что понял из переписки, и приёмка превращается в спор о трактовках.
- Один ключ на все операции. Удобно на старте, но создаёт единую точку отказа и повышает цену ошибки.
- Экономить на проверке кода. Аудит стоит денег, но ошибка в контракте, работающем с активами, обычно обходится дороже.
- Забыть про внешние данные. Оракулы и интеграции добавляют риски, которые не видны в коде самого контракта.
- Хранить персональные данные в блокчейне «на всякий случай». Удалить их потом почти невозможно.
- Не иметь плана реагирования. Без ответственного, алертов и порядка действий инцидент затягивается.
- Откладывать юридические вопросы. Модель, которая требует согласований, лучше выявить до разработки, чем после запуска.
Чем смарт-контракт отличается от обычного договора?
Договор фиксирует обязательства сторон и способы защиты при их нарушении, а смарт-контракт исполняет формализованные правила: переводит средства, открывает доступ, фиксирует записи. Автоматическое исполнение не отвечает на вопросы о сторонах, применимом праве и порядке споров — для этого нужен юридический документ и, при необходимости, консультация юриста.
Сколько стоит разработка смарт-контракта?
Цена зависит от объёма: количества контрактов и функций, сложности сценариев, наличия внешних источников данных, требований к аудиту и поддержке. Корректная оценка возможна только после письменной спецификации, поэтому сравнивать предложения исполнителей имеет смысл по одинаковому описанию задачи, а не по короткой формулировке «нужен смарт-контракт».
Обязателен ли аудит смарт-контракта?
Универсального требования нет: необходимость зависит от задачи, рисков и требований тех, с кем вы работаете. Для проектов, которые оперируют средствами или правами пользователей, независимая проверка кода до запуска — разумная практика. Объём аудита, порядок исправлений и критерии блокировки запуска стоит закрепить в договоре.
Можно ли исправить ошибку после запуска контракта?
Зависит от архитектуры. Неизменяемый контракт исправить нельзя — обычно разворачивают новый и переносят состояние, что требует миграции и уведомления пользователей. Обновляемый вариант позволяет вносить изменения, но концентрирует управление у владельца и добавляет риски. Этот выбор нужно сделать до начала разработки.
Кто платит комиссии сети за операции?
Как правило, тот, кто отправляет транзакцию: если операцию инициирует пользователь — расходы на нём, если сервис — на сервисе. Конкретное распределение расходов стоит зафиксировать в договорённостях и объяснить пользователю до подтверждения операции.
Нужен ли юрист, если проект небольшой?
Объём консультации зависит от модели. Если есть токены для пользователей, приём платежей, хранение средств или персональные данные в блокчейне, юридическая проверка до запуска помогает выявить требования, которые сложно выполнить задним числом. Применимые нормы уточняйте по официальным источникам и у профильного специалиста.