Разработка контракта для airdrop через Merkle distributor

Массовая раздача токенов ломается на пиковой нагрузке: часть адресов не получает выплату, а команда неделями сверяет списки вручную. Мы разрабатываем airdrop смарт контракт с пакетной раздачей и берём проект под ключ — от схемы распределения до проверки получателей. Раздача десятков тысяч адресов проходит без сбоев, а расходы на выплаты перестают расти.

Разработка контракта для airdrop через Merkle distributor

Разработка токеновПростой~2-3 дня
Часто задаваемые вопросы

Почему airdrop смарт контракт ломается на массовых выплатах

Массовая раздача токенов — это не одна транзакция, а десятки тысяч вызовов airdrop смарт контракта, и каждый лишний вызов оплачивает отправитель. Когда распределение собирают «в лоб» — циклом по всему списку получателей внутри одного вызова в Ethereum, — контракт упирается в лимит блока: часть адресов проходит, часть откатывается, а состояние остаётся неполным.

Дальше подключается человеческий фактор. Ошибки в списке получателей — дубли, потерянные адреса, суммы не по той разрядности — всплывают уже после публикации, когда исправление требует отдельного распределителя и повторной сверки. Ручные транзакции превращают массовые выплаты токенов в многочасовую операцию: сбитый порядок nonce, зависшие в мемпуле подписи, выплаты, которые нельзя воспроизвести по журналу.

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

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

Что меняется после перехода на пакетные выплаты

После перехода на пакетные выплаты airdrop перестаёт быть серией переводов и превращается в один корень, опубликованный в смарт-контракте. Каждый участник сам обращается к контракту и предъявляет доказательство — ветку дерева Меркла, ведущую к его листу. Контракт сверяет ветку с корнем и только после этого переводит токены: время распределения перестаёт зависеть от длины списка, потому что выплаты идут параллельно и не блокируют друг друга.

Класс двойных выплат закрывается на уровне самой проверки. Лист собирается из адреса и суммы, а факт получения фиксируется отдельным флагом состояния; повторный вызов с той же веткой не проходит, даже если участник ошибётся сетью или отправит транзакцию дважды. Ручные сверки в таблицах «кто уже получил» уходят — доля ручных операций падает до подготовки списка и публикации корня.

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

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

Варианты раздачи токенов: сравнение подходов

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

Вариант Когда подходит Ограничения
Пакетная раздача через дерево Меркла Список получателей большой, суммы известны заранее Хранится корень дерева плюс доказательства по каждому адресу; изменение любой суммы требует пересчёта корня
Построчные переводы в цикле Список в пределах десятков адресов Нагрузка на сеть растёт линейно, пачка перестаёт помещаться в блок, откат гасит всю транзакцию целиком
Единый контракт раздачи Выдача по расписанию, с периодами блокировки и повторными раундами Средства лежат в контракте, нужны логика пауз и аварийный вывод
Раздача по частям, эпохами Нужно растянуть выдачу во времени Больше транзакций и учёта, получатель видит несколько начислений
Прямая эмиссия новых токенов Токен без фиксированного лимита выпуска, нужен полный контроль Меняет заявленную токеномику и плохо проходит аудит перед листингом

Построчные переводы и прямая эмиссия выглядят проще всего ровно до первого крупного списка: цикл по массиву адресов быстро упирается в лимит блока, а выпуск токенов «на лету» расходится с тем, что записано в токеномике. Единый контракт раздачи решает вопрос с расписанием, но забирает средства под свою логику, поэтому его отдельно проверяют на сценарии паузы, отзыва роли и вывода остатка — иначе раздача превращается в неконтролируемое хранилище.

Этапы внедрения контракта распределения

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

  1. Аудит схемы раздачи. Сверяем источник данных о получателях с правилами начисления, фиксируем расхождения и граничные условия. На выходе — согласованная логика и перечень рисков, которые ломали бы раздачу.

  2. Проектирование списка и структуры. Из выгрузки собираем дерево хешей Merkle: убираем дубликаты и нулевые адреса, проверяем округления сумм. Каждый получатель получает доказательство включения, корень дерева фиксируется в контракте.

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

  4. Проверка корректности распределения. Сверяем рассчитанные суммы с исходными данными до последней единицы: ошибка округления на этом шаге дороже любой ошибки в коде.

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

  6. Перенос в основную сеть. Публикуем контракт теми же параметрами, что прошли проверку, вносим корень дерева и передаём права администратора заказчику.

  7. Передача контракта заказчику. Отдаём исходники, адреса, инструкцию по раздаче и порядок действий в спорных ситуациях.

Что передаётся заказчику: конфигурации, схемы, регламенты

Комплект передаётся не «на словах»: у каждого артефакта зафиксирован владелец и порядок обновления. Заказчик получает возможность провести следующую раздачу токенов силами своей команды или отдать поддержку другому подрядчику без обратного проектирования.

  • Исходный код контракта и скриптов подготовки данных — с контрольными суммами и инструкцией по воспроизводимой сборке из чистого окружения.
  • Конфигурация раздачи: список адресов и сумм, корень дерева Меркла, окно получения токенов, лимиты на адрес.
  • Схемы распределения: откуда берётся срез балансов, как считаются веса категорий, как проверяется отсутствие дублей и «мёртвых» адресов.
  • Политики доступа к ключам: разделение ролей администратора и оператора, требования к мультиподписи, порядок ротации и хранения ключей вне репозитория.
  • Регламент выплат: обработка невыбранных токенов после закрытия окна, действия при спорных адресах и ошибочных получателях.
  • Документация контракта: назначение функций и событий, коды ошибок, инварианты, которые проверяются тестами.
  • Регламент повторного запуска раздачи: пошаговый порядок — новый срез, пересборка дерева, обновление корня, прогон на тестовой сети, публикация.

Каждый пункт привязан к роли: что заказчик делает сам, где нужна наша команда, а где достаточно дежурного инженера на поддержке.

Кейс: раздача на десятки тысяч адресов без сбоев

Проект запускал раздачу токенов на 38 000 адресов после смены модели вознаграждений. Первый раунд делали вручную: списки сводили в таблице, транзакции отправляли пачками по 200 адресов, между пачками сверяли остатки. На это уходило около двух суток работы инженера, и примерно каждый четырнадцатый адрес получал выплату дважды или не получал вовсе — расхождение всплывало уже по обращениям в поддержку.

Мы перенесли логику в распределитель на дереве Merkle: список участников и сумм хешируется в дерево, в контракт попадает только корень, а участник сам вызывает получение и предъявляет доказательство включения. Повторный вызов, чужой адрес и изменённая сумма отсекаются проверкой, а не регламентом.

Подготовка раунда сократилась с двух суток до трёх часов: инженер собирает список, считает дерево и публикует корень одним вызовом. Доля ошибочных начислений ушла с 7% до нуля — двойные выплаты и пропуски стали невозможны по построению, а не по внимательности оператора. Обращений в поддержку по теме «не пришла выплата» стало на порядок меньше: статус получения виден в контракте, а не в переписке.

Шаблон выдержал ещё четыре раунда раздачи: менялся только список, код оставался тем же. Комиссию за транзакцию оплачивает сам участник, поэтому раздача не зависит от остатка на одном кошельке, и класс отказов «часть адресов осталась без выплаты» ушёл полностью.

Чем пакетный airdrop отличается от построчных выплат?

Обе схемы дают один результат — токены на кошельках участников — но по-разному ведут себя под нагрузкой. Разница видна на двух осях: сколько транзакций уходит в сеть и насколько легко доказать корректность распределения.

В Merkle Distributor список сворачивается в один корень дерева, опубликованный в контракте. Получатель сам вызывает контракт и предъявляет доказательство своей ветки — сеть обрабатывает столько транзакций, сколько людей пришло за выплатой, а не сколько адресов в списке. Проверяемость максимальная: дерево пересобирается из опубликованного файла и сверяется с корнем.

Построчные выплаты — цикл отправок: отдельная транзакция и запись в хранилище на каждый адрес. На списке в тысячи адресов выдача растягивается: ранние получатели видят баланс сразу, поздние — через часы, и всё это время контракт остаётся точкой отказа. Зато участнику не нужно делать ничего самому.

Вариант Когда подходит Ограничения
Пакетный airdrop по корню дерева Списки от сотен адресов, нужна публичная проверяемость Корень неизменяем, правки — новым раундом
Построчные выплаты из контракта Короткий список, получатели не делают ничего сами Транзакций столько же, сколько адресов
Пакетный раунд плюс довыпуск Основной список и спорные адреса отдельно Два контура учёта, сложнее сверка

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

Технические сомнения перед запуском раздачи токенов

Перед публикацией корня дерева у команды остаётся десяток вопросов, не видных в демо: опечатка в адресе, повторный раунд, подтверждение права на выплату, доступ к ключам. Разбираем их до запуска — на приёмке они всплывают чаще всего.

Что делать с опечаткой в адресе получателя?

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

Как пройдёт повторный раунд и не будет ли двойной выплаты?

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

Как получатель проверяет своё право на выплату?

Доказательство считается по паре «адрес и сумма» и сверяется с опубликованным корнем. Прогоняем проверку локально до запуска: если участник из выборки не проходит, раздача не стартует.

У кого остаётся доступ к ключам?

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

Обсудим задачу: разберём вашу схему распределения

Чтобы вернуться с оценкой и планом, а не с общими словами, нужен минимум вводных. Собираем их одним списком — если часть данных ещё не зафиксирована, помечаем как открытый вопрос и выносим отдельным этапом.

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

Дальше собираем план работ: проектирование правил и дерева начислений, разработка и проверки, тестовая раздача на ограниченном наборе адресов, аудит, затем запуск. Раздача идёт этапами — сначала небольшой пул, потом основной, чтобы пик обращений не лёг на сеть и остался запас на откат.

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

Направления блокчейн-разработки

Последние работы

  • Разработка сайта компании B2B ADVANCE
    Разработка сайта компании B2B ADVANCE
    1574
  • Разработка веб-приложения для компании FEEDME
    Разработка веб-приложения для компании FEEDME
    1427
  • Разработка веб-сайта для компании БЕЛФИНГРУПП
    Разработка веб-сайта для компании БЕЛФИНГРУПП
    1105
  • Разработка интернет магазина для компании FURNORO
    Разработка интернет магазина для компании FURNORO
    1421
  • Разработка логотипа компании B2B Advance
    Разработка логотипа компании B2B Advance
    858
  • Разработка веб-приложения для компании Enviok
    Разработка веб-приложения для компании Enviok
    1181