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

Масова роздача токенів ламається на піковому навантаженні: частина адрес не отримує виплату, а команда тижнями звіряє списки вручну. Ми розробляємо аірдроп-смарт-контракт із пакетною роздачею та беремо проєкт під ключ — від схеми розподілу до перевірки отримувачів. Роздача десятків тисяч адрес проходить без збоїв, а витрати на виплати перестають зростати.
Часті запитання

Чому 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