Чому airdrop смарт-контракт ламається на масових виплатах
Масова роздача токенів — це не одна транзакція, а десятки тисяч викликів airdrop смарт-контракту, і кожен зайвий виклик оплачує відправник.
Коли розподіл збирають «в лоб» — циклом по всьому списку отримувачів усередині одного виклику в Ethereum, — контракт впирається в ліміт блоку: частина адрес проходить, частина відкочується, а стан залишається неповним.
Далі підключається людський фактор. Помилки у списку отримувачів — дублі, загублені адреси, суми не тієї розрядності — спливають уже після публікації, коли виправлення потребує окремого розподілювача й повторної звірки.
Ручні транзакції перетворюють масові виплати токенів на багатогодинну операцію: збитий порядок nonce, підписи, що зависли в мемпулі, виплати, які неможливо відтворити за журналом.
Окремий клас збоїв — незакриті права на випуск. Якщо в контракту-емітента залишається активний ключ, той, хто отримав до нього доступ, додруковує токени після роздачі та обнуляє розрахункову частку кожного учасника. Тут ламається не механіка переказу, а економіка всієї кампанії.
Усі три збої — про архітектуру розподілу, а не про уважність виконавця. Розбираємо, як це закривається на рівні контракту, списку отримувачів і розподілу прав.
Що змінюється після переходу на пакетні виплати
Після переходу на пакетні виплати airdrop перестає бути серією переказів і перетворюється на один корінь, опублікований у смарт-контракті. Кожен учасник сам звертається до контракту й пред'являє доказ — гілку дерева Меркла, що веде до його листа.
Контракт звіряє гілку з коренем і лише після цього переказує токени: час розподілу перестає залежати від довжини списку, бо виплати йдуть паралельно й не блокують одна одну.
Клас подвійних виплат закривається на рівні самої перевірки. Лист збирається з адреси й суми, а факт отримання фіксується окремим прапорцем стану; повторний виклик із тією самою гілкою не проходить, навіть якщо учасник помилиться мережею або надішле транзакцію двічі.
Ручні звірки в таблицях «хто вже отримав» зникають — частка ручних операцій падає до підготовки списку й публікації кореня.
Витрати на проведення транзакцій перестають зростати лінійно разом із кількістю отримувачів. Проєкт платить за одну публікацію кореня, решту учасники беруть на себе; у разі зміни умов змінюється лише стан контракту, а не весь список адрес.
Окремо до запуску фіксуємо терміни отримання, долю незатребуваних сум і право паузи. Саме ці параметри визначають, чим закінчиться роздача — передбачуваним розподілом за деревом чи розбором звернень до підтримки.
Варіанти роздачі токенів: порівняння підходів
Схему роздачі обирають не за зовнішнім виглядом, а за трьома речами: яке навантаження лягає на мережу, скільки транзакцій доведеться підписувати та наскільки просто виправити або відкликати раунд.
Кожен варіант додатково перевіряємо на сумісність із уже випущеним токеном, із контрактами-гаманцями отримувачів і з біржовими адресами, куди токен іде далі.
| Варіант | Коли підходить | Обмеження |
|---|---|---|
| Пакетна роздача через дерево Меркла | Список отримувачів великий, суми відомі заздалегідь | Зберігається корінь дерева плюс докази для кожної адреси; зміна будь-якої суми потребує перерахунку кореня |
| Построкові перекази в циклі | Список у межах десятків адрес | Навантаження на мережу зростає лінійно, пачка перестає вміщатися в блок, відкат гасить усю транзакцію цілком |
| Єдиний контракт роздачі | Видача за розкладом, з періодами блокування та повторними раундами | Кошти лежать у контракті, потрібні логіка пауз і аварійний вивід |
| Роздача частинами, епохами | Потрібно розтягнути видачу в часі | Більше транзакцій та обліку, отримувач бачить кілька нарахувань |
| Пряма емісія нових токенів | Токен без фіксованого ліміту випуску, потрібен повний контроль | Змінює заявлену токеноміку й погано проходить аудит перед лістингом |
Построкові перекази та пряма емісія виглядають найпростіше рівно до першого великого списку: цикл по масиву адрес швидко впирається в ліміт блоку, а випуск токенів «на льоту» розходиться з тим, що записано в токеноміці.
Єдиний контракт роздачі вирішує питання з розкладом, але забирає кошти під свою логіку, тому його окремо перевіряють на сценарії паузи, відкликання ролі та виведення залишку — інакше роздача перетворюється на неконтрольоване сховище.
Етапи впровадження контракту розподілу
Порядок робіт будується так, щоб на момент публікації контракту в основній мережі жодна цифра не викликала питань. Починаємо з аудиту схеми роздачі — джерело даних про отримувачів, правила нарахування, ліміти, захист від повторного отримання. Кожен етап закінчується артефактом, який можна звірити незалежно.
-
Аудит схеми роздачі. Звіряємо джерело даних про отримувачів із правилами нарахування, фіксуємо розбіжності та граничні умови. На виході — узгоджена логіка й перелік ризиків, які ламали б роздачу.
-
Проєктування списку та структури. З вивантаження збираємо дерево хешів Merkle: прибираємо дублікати й нульові адреси, перевіряємо округлення сум. Кожен отримувач отримує доказ включення, корінь дерева фіксується в контракті.
-
Налаштування контракту. Задаємо вікно роздачі, комісію за отримання, можливість паузи та розмежування прав. Окремо перевіряємо, що одну й ту саму суму не можна отримати двічі.
-
Перевірка коректності розподілу. Звіряємо розраховані суми з вихідними даними до останньої одиниці: помилка округлення на цьому кроці дорожча за будь-яку помилку в коді.
-
Тестова мережа. Розгортаємо контракт, проганяємо повний список отримувачів, перевіряємо граничні випадки — повторне звернення, чужий доказ, закрите вікно. Дивимося поведінку за масових запитів.
-
Перенесення в основну мережу. Публікуємо контракт тими самими параметрами, що пройшли перевірку, вносимо корінь дерева й передаємо права адміністратора замовнику.
-
Передача контракту замовнику. Віддаємо вихідні коди, адреси, інструкцію з роздачі та порядок дій у спірних ситуаціях.
Що передається замовнику: конфігурації, схеми, регламенти
Комплект передається не «на словах»: у кожного артефакту зафіксовано власника й порядок оновлення. Замовник отримує можливість провести наступну роздачу токенів силами своєї команди або віддати підтримку іншому підряднику без зворотного проєктування.
- Вихідний код контракту та скриптів підготовки даних — з контрольними сумами й інструкцією щодо відтворюваного складання з чистого середовища.
- Конфігурація роздачі: список адрес і сум, корінь дерева Меркла, вікно отримання токенів, ліміти на адресу.
- Схеми розподілу: звідки береться зріз балансів, як рахуються ваги категорій, як перевіряється відсутність дублів і «мертвих» адрес.
- Політики доступу до ключів: розділення ролей адміністратора й оператора, вимоги до мультипідпису, порядок ротації та зберігання ключів поза репозиторієм.
- Регламент виплат: обробка невибраних токенів після закриття вікна, дії у разі спірних адрес і помилкових отримувачів.
- Документація контракту: призначення функцій і подій, коди помилок, інваріанти, які перевіряються тестами.
- Регламент повторного запуску роздачі: покроковий порядок — новий зріз, перезбирання дерева, оновлення кореня, прогін на тестовій мережі, публікація.
Кожен пункт прив'язаний до ролі: що замовник робить сам, де потрібна наша команда, а де достатньо чергового інженера на підтримці.
Кейс: роздача на десятки тисяч адрес без збоїв
Проєкт запускав роздачу токенів на 38 000 адрес після зміни моделі винагород. Перший раунд робили вручну: списки зводили в таблиці, транзакції надсилали пачками по 200 адрес, між пачками звіряли залишки.
На це йшло близько двох діб роботи інженера, і приблизно кожна чотирнадцята адреса отримувала виплату двічі або не отримувала зовсім — розбіжність спливала вже за зверненнями до підтримки.
Ми перенесли логіку в розподілювач на дереві Merkle: список учасників і сум хешується в дерево, у контракт потрапляє лише корінь, а учасник сам викликає отримання й пред'являє доказ включення. Повторний виклик, чужа адреса та змінена сума відсікаються перевіркою, а не регламентом.
Підготовка раунду скоротилася з двох діб до трьох годин: інженер збирає список, рахує дерево й публікує корінь одним викликом. Частка помилкових нарахувань упала з 7% до нуля — подвійні виплати та пропуски стали неможливі за побудовою, а не за уважністю оператора.
Звернень до підтримки на тему «не надійшла виплата» стало на порядок менше: статус отримання видно в контракті, а не в листуванні.
Шаблон витримав ще чотири раунди роздачі: змінювався лише список, код залишався тим самим. Комісію за транзакцію оплачує сам учасник, тому роздача не залежить від залишку на одному гаманці, і клас відмов «частина адрес залишилася без виплати» зник повністю.
Чим пакетний airdrop відрізняється від построкових виплат?
Обидві схеми дають один результат — токени на гаманцях учасників — але по-різному поводяться під навантаженням. Різниця видна на двох осях: скільки транзакцій іде в мережу та наскільки легко довести коректність розподілу.
У Merkle Distributor список згортається в один корінь дерева, опублікований у контракті. Отримувач сам викликає контракт і пред'являє доказ своєї гілки — мережа обробляє стільки транзакцій, скільки людей прийшло за виплатою, а не скільки адрес у списку. Перевірюваність максимальна: дерево перезбирається з опублікованого файлу й звіряється з коренем.
Построкові виплати — цикл відправок: окрема транзакція та запис у сховище на кожну адресу. На списку в тисячі адрес видача розтягується: ранні отримувачі бачать баланс одразу, пізні — через години, і весь цей час контракт залишається точкою відмови. Зате учаснику не потрібно робити нічого самому.
| Варіант | Коли підходить | Обмеження |
|---|---|---|
| Пакетний airdrop за коренем дерева | Списки від сотень адрес, потрібна публічна перевірюваність | Корінь незмінний, правки — новим раундом |
| Построкові виплати з контракту | Короткий список, отримувачі не роблять нічого самі | Транзакцій стільки ж, скільки адрес |
| Пакетний раунд плюс довипуск | Основний список і спірні адреси окремо | Два контури обліку, складніша звірка |
Правки після запуску — головна розбіжність. Корінь незмінний, тому помилку в адресі чи сумі закривають другим раундом із новим коренем. У построковій схемі список правлять до першої виплати, але транзакцію, що вже пішла, не скасувати — виправлення оформлюють окремим переказом.
Технічні сумніви перед запуском роздачі токенів
Перед публікацією кореня дерева в команди залишається десяток питань, не видимих у демо: одрук в адресі, повторний раунд, підтвердження права на виплату, доступ до ключів. Розбираємо їх до запуску — на прийманні вони спливають найчастіше.
Що робити з одруком в адресі отримувача?
Частину одруків відсікає перевірка контрольної суми, але не всі — список проходить нормалізацію, дедуплікацію та звірку з вихідним вивантаженням. Потім фіксуємо його хешем: правки після публікації кореня йдуть новим раундом.
Як пройде повторний раунд і чи не буде подвійної виплати?
У листа є прапорець виплати, повторний виклик скасовується на рівні контракту. Новий раунд отримує власний корінь, листя старого до нього не потрапляє, а залишок переноситься окремою операцією.
Як отримувач перевіряє своє право на виплату?
Доказ рахується за парою «адреса й сума» та звіряється з опублікованим коренем. Проганяємо перевірку локально до запуску: якщо учасник із вибірки не проходить, роздача не стартує.
У кого залишається доступ до ключів?
Ключ адміністратора може вивести залишок пулу, тому не зберігається в однієї людини. Управління — через мультипідпис із кількома власниками та затримкою виконання: підозрілу операцію видно й можна скасувати.
Обговоримо задачу: розберемо вашу схему розподілу
Щоб повернутися з оцінкою та планом, а не із загальними словами, потрібен мінімум ввідних. Збираємо їх одним списком — якщо частина даних ще не зафіксована, позначаємо як відкрите питання й виносимо окремим етапом.
- мережа та стандарт токена: де розміщується контракт, чи підтримуються перекази з побічними викликами й хто тримає права випуску;
- знімок балансів: блок і момент, за якими рахуються учасники, та правила відсікання ботів і дублів адрес;
- список отримувачів: порядок розміру, розподіл сум, чи потрібен період очікування й поступове розблокування;
- ролі та доступи: хто тримає мультипідпис адміністратора, чи потрібні таймлок і відкликання прав після роздачі;
- механіка отримання: один раунд чи кілька, чи можна поповнювати пул і змінювати дерево нарахувань між раундами;
- навантаження: скільки звернень до контракту прийде в перші години й хто гасить пік;
- приймання: хто з боку замовника підтверджує коректність нарахувань.
Далі збираємо план робіт: проєктування правил і дерева нарахувань, розробка та перевірки, тестова роздача на обмеженому наборі адрес, аудит, потім запуск. Роздача йде етапами — спочатку невеликий пул, потім основний, щоб пік звернень не ліг на мережу й залишився запас на відкат.
Передача під супровід — окремий етап, а не формальність: віддаємо конфігурації, схему прав і мультипідпису, порядок оновлення дерева під новий раунд, інструкцію з поповнення пулу та регламент реакції на інциденти.
Опишіть задачу — повернемося з оцінкою та планом запуску, де кожному пункту відповідає етап і відповідальний.







