Розробка launchpad контракту: де ламається токенсейл
Контракт токенсейлу — найбільш навантажена ділянка launchpad: він першим приймає кошти, останнім віддає токени і залишається публічно читаним після запуску.
Помилки в білому списку тут не абстракція: адреса, що потрапила до переліку двічі — як гаманець і як контракт-посередник, — отримує подвоєну алокацію, і розподіл з'їжджає ще до відкриття продажу.
Окрема біда, коли ліміт рахується за адресою відправника: один учасник заводить кілька гаманців і проходить кап по кожному, витісняючи інших з раунду.
Подвійна участь у продажу зазвичай спливає вже після закриття, коли рахувати пізно: суми зібрані, а алокації доводиться перезбирати вручну.
Завислий графік розблокування — друга класика самостійного складання: клейм рахується від часу старту, а не від фактичного внеску, або переказ токенів до строку нічим не обмежений, і розблокування обходиться парою транзакцій.
Спірні алокації між раундами додають третю проблему — пріоритет заявок не зафіксований, і черга на розподіл визначається тим, хто встиг відправити транзакцію першим.
Ціна у всіх сценаріїв одна: повернення, ручний перерахунок і інвестори, які не прийдуть на наступний запуск.
Контракт продажу проєктується так, щоб спірних місць не залишалося на рівні логіки: білий список збирається в детерміноване дерево з перевіркою унікальності, розмір внеску рахується від підписанта, а вестинг зберігає власний баланс і не дозволяє обійти строк переказами. Нижче розбираємо, як це закривається в розробці launchpad контракту.
Логіка продажу: білий список, алокації та графік розблокування
Список учасників не переписується в контракт построково — у сховищі лежить тільки корінь дерева хешів, а адреса приходить на купівлю з доказом включення і своєю сумою алокації.
Тому продаж витримує десятки тисяч адрес, зріз стану фіксується на конкретному блоці, а правка одного запису не потребує перезбирання контракту.
Алокація та ліміти на купівлю перевіряються в одній точці: персональна стеля, стеля раунду та загальний розмір продажу. Перевищення не обрізається тихо — транзакція відхиляється, учасник бачить причину, а не урізану частку.
Ціна раунду задається конфігом, тому наступні раунди запускаються зміною параметрів, а не нового коду.
Вестинг будується за принципом «все нараховано, але не все виводимо»: період очікування, потім лінійне розблокування від старту продажу.
Токени кожен учасник забирає сам окремим викликом — контракт не розсилає баланси циклом по масиву, тому вартість операції не зростає з кількістю власників.
Це знімає головний клас відмов на виводі: відмова в однієї адреси не блокує інших. Ролі, паузу та захист від повторного входу беремо з готових перевірених бібліотек OpenZeppelin, а не пишемо самостійно.
Ефект вимірний: повторний раунд — це нуль ручних правок адрес, звірка алокацій — порівняння одного хешу замість построкового розбору вигрузки, спірні нарахування розбираються за коренем зрізу стану.
Формати запуску: власний контракт, фабрика, модуль платформи
Формат запуску визначає, скільки коду пишемо один раз, а скільки перевикористовуємо. Власний контракт продажу дає повний контроль над раундами, лімітами на гаманець і графіком розблокування, але аудит і підтримка лягають на нас цілком.
Фабрика розгортає копії вже перевіреного шаблону, а модуль платформи додає готову адмінку, облік часток і допуск за списком.
Вибір упирається в модель розподілу: скільки раундів і цінових рівнів, як формується список допуску, чи є повернення і як саме розблоковується вестинг.
Якщо правила нестандартні хоча б за одним пунктом, шаблон доведеться доопрацьовувати — і це простіше вирішити до запуску, ніж переносити стан після.
Порівняння форматів запуску
| Формат | Коли підходить | Обмеження |
|---|---|---|
| Власний контракт продажу | Нестандартні раунди, приватні умови, ліміти на гаманець, зв'язка із зовнішніми сервісами | Повний цикл аудиту та підтримки, довше до запуску, адмінку та облік пишемо самі |
| Контракт-фабрика | Серія продажів за однаковими правилами, кілька проєктів під одним управлінням | Шаблон фіксований: відхилення потребують нової версії, помилка тиражується на всі копії |
| Модуль платформи | Стандартні раунди, готовий список допуску, шаблонний вестинг, запуск у стислі терміни | Логіка обмежена рамками платформи, частина параметрів недоступна, залежність від її оновлень |
Зміна формату на живому продажу — окрема задача: переносяться снапшоти допуску, накопичені частки та незакриті клейми, а попередні контракти залишаються тільки на читання. Тому формат обираємо під фінальну модель розподілу, а не під швидкість першого раунду.
Етапи роботи: від моделі розподілу до передачі управління
Ми не починаємо писати код, поки модель продажу не зафіксована на папері: контракт у блокчейні не можна тихо поправити після публікації, і помилка в розрахунку раунду або графіку виплат коштує дорожче, ніж зайвий день узгодження.
Тому етапи розробки контракту вибудувані так, що кожен закінчується перевіреним артефактом — специфікацією, схемою ролей або прогоном тестів.
- Розбір моделі розподілу: раунди, ліміти на учасника, ціна токена, пауза перед першими нарахуваннями, частки команди та резерву. Фіксуємо односторінковою специфікацією з прикладами розрахунків.
- Схема ролей і доступів: хто веде білий список, хто відкриває раунд, хто виводить кошти. Окремо відзначаємо, які права віддаємо мультипідпису, а які спалюємо після фінального раунду.
- Складання контрактів: продаж, токен, вестинг і розподіл — окремими модулями із загальною схемою обліку балансів і лімітів.
- Перевірка контракту: тестами закриваємо повторні заявки, переповнення раунду, достроковий вивід, скасування продажу та роботу адміністратора.
- Тестовий запуск продажу на копії мережі: повний цикл купівлі, нарахування за графіком і виводу, звірка обсягів і черговості виплат.
- Передача контракту: публікація, передача управління замовнику, документація за ролями та пам'ятка для підтримки першого раунду.
Комплект передачі: контракти, схеми, політики та регламенти
Передача проєкту — це не тільки доступи та розгорнутий код. Ми віддаємо комплект, за яким нова команда вводиться в курс за один розбір: що де налаштовано, хто чим управляє, як діяти при збої. Нижче — що саме залишається у замовника.
- Документація за контрактом — призначення модулів, параметри розгортання (ціна етапу, ліміти, вікна продажів), перелік функцій власника та точок, де зміна параметра зачіпає вже активні продажі.
- Схема розподілу — маршрут коштів від покупця до фонду проєкту, пулу ліквідності та резерву, правила переведення виплати в наступний статус і момент, з якого вивід стає доступним.
- Матриця ролей доступу — хто додає адреси до білого списку, хто змінює графік розблокування, хто зупиняє торги; які операції потребують двох підтверджень і як передати права при зміні адміністратора.
- Інструкція адміністратора — сценарії типових операцій (старт етапу, додавання учасників, дострокове завершення, зняття коштів) з переліком параметрів для перевірки та розбором подій транзакції.
- Регламент супроводу — періодичність перевірок, порядок оновлення конфігурації, зберігання та ротація ключів, межа нашої відповідальності після передачі.
- Регламент при інциденті — що робити при завислій транзакції, помилці в ціні етапу або ознаках компрометації ключа: перша дія, коло відповідальних, порядок фіксації слідів.
Кейс: продаж з білим списком і графіком розблокування
Платформа проводила продаж з білим списком і графіком розблокування. До нас зарахування йшло вручну: оператор звіряв заявки, додавав адреси партіями і окремо рахував частки в таблиці.
На піку це давало чергу заявок на кілька годин і помилки в сумах, які знаходили вже після закриття раунду.
Ми переписали контур продажу: контракт приймає адресу тільки за підтвердженням з білого списку, частка фіксується в момент зарахування, а графік розблокування заданий розписом всередині контракту. Учасник сам викликає розблокування — оператор у цьому не бере участі.
Базові реалізації токена та вестингу взяли з OpenZeppelin, тести закрили сценарії з достроковим виводом і повторним зарахуванням.
Що змінилося в метриках
| Метрика | До | Після |
|---|---|---|
| Ручні операції при зарахуванні | кожна заявка вручну | 0, тільки видача ролі |
| Випуск нової кампанії | 4-5 днів | один робочий день |
| Звернення щодо розблокування | 50-60 на тиждень | поодинокі |
| Відмови транзакцій у пік | 10-15% заявок | 0 |
| Інциденти з розрахунком часток | 3-4 за кампанію | 0 |
Відмови в пік прибрали чергою: заявки збираються пакетами, повтор відправляється автоматично, запас за газом виставляється заздалегідь. Підтримка перестала бути вузьким місцем — звільнені години пішли на підготовку наступного раунду.
Що робити, якщо продаж уже триває, а умови розблокування змінюються
Коротка відповідь: правки в розгорнутий контракт внести не можна — можна тільки замінити його цілком або надбудувати поруч новий шар. Вибір залежить від двох фактів: чи лежать токени та кошти кампанії всередині старого контракту і чи є в нього керована реалізація з паузою.
Звідси три робочі сценарії: міграція контракту, надбудова поверх поточного та друга кампанія з чистими правилами.
Міграція — найпередбачуваніший варіант. На фіксованому блоці знімаємо снапшот: адреси, сплачені суми, розмір алокацій і вже отримане за графіком.
У новому контракті, зібраному на перевірених бібліотеках OpenZeppelin, учасник підтверджує ті самі дані, а зміна графіка розблокування застосовується тільки до невиданої частини.
Старий контракт переводимо в режим тільки на читання, щоб подвійне отримання було технічно неможливим.
Надбудова дешевша за ризиком, коли продаж і вестинг рознесені: продаж тримає ціну, ліміти та whitelist, а розблокування йде окремим контрактом.
Тоді оновлення правил продажу — це розгортання нового контракту вестингу та перемикання вказівника на нього, а учасники нічого не перепідписують.
Друга кампанія доречна, коли умови не можна змінювати заднім числом: поточний продаж закриваємо за фактом, залишки нерозподілених алокацій переносимо в новий пул, правила фіксуємо заново.
Що обрати, вирішують права адміністратора в контракті та наявність механізму паузи — від цього залежить, чи пройде міграція автоматично, чи потребуватиме ручного переведення учасників.
Технічні питання щодо запуску продажу та ролей доступу
Перед публікацією контракту продажу ми розводимо дві множини: що задається при розгортанні і що залишається змінним.
Ціна, вікно раунду, жорсткий кап і ліміт на гаманець записуються в незмінні поля; змінюються тільки заздалегідь оголошені перемикачі — пауза купівель і дострокове завершення при досягненні капу. Нижче — короткі відповіді на сумніви, які найчастіше піднімають перед стартом.
Чи можна змінити умови раунду після публікації?
Ні. Оновити їх вийде тільки новим контрактом продажу з явною міграцією та оголошенням. Кожен виклик паузи або завершення фіксується подією — стан продажу видно в оглядачі блоків.
Як контракт перевіряє право адреси на купівлю?
Список хешується поза мережею в дерево, контракт зберігає тільки корінь, а покупець пред'являє доказ — стан залишається компактним, а перевірка коштує однаково для будь-якого розміру списку.
Другий варіант — підпис з обмеженим терміном дії, зручний для закритих раундів без публікації списку. В обох випадках звіряється адреса отримувача, тому право не можна переслати іншому гаманцю.
Кому переходять адміністративні права після запуску?
Мультипідпису проєкту, а не одному ключу розробника. Для критичних операцій налаштовуємо затримку виконання: оголошена дія набирає чинності через заданий інтервал і весь цей час видно в мережі — встигнути відреагувати можна до виконання. Після розблокування токенів адміністративні функції знімаються повністю.
Що перевіряється до публікації контракту?
Прогін на тестовій мережі за сценаріями: купівля понад ліміт, повторний вхід у функцію купівлі, купівля поза вікном раунду, спроба забрати токени до розблокування.
Потім незалежний аудит і звірка опублікованого коду з перевіреною версією — розбіжності в розрахунку часток і графіку розблокування знаходяться до старту, а не після.
Обговоримо задачу та повернемося з планом робіт із продажу
Щоб оцінка та план робіт із запуску продажу токенів були предметними, а не «плюс-мінус за досвідом схожих проєктів», нам потрібні ввідні від замовника.
Без них неясно, де основна складність: у механіці раундів, у юридичних обмеженнях за країнами покупців чи в інтеграціях з гаманцями.
Що потрібно надіслати, щоб ми повернулися з розрахунком:
- Мережа та стандарт токена: EVM-сумісна, Solana або власна мережа — від цього залежить архітектура контракту та підтримка гаманців.
- Механіка раундів: фіксована ціна, ступінчаста за раундами або аукціон, ліміти на гаманець, цільові суми збору та умови повернення коштів при недосягненні порогу.
- Правила whitelist: ручний список адрес, дерево Меркла, підпис від вашого сервера або відкрита купівля з перевіркою особи.
- Вестинг і клейм: кліф, лінійний або ступінчастий графік, дата виходу на ринок, порядок роботи з нерозподіленими токенами.
- Токеноміка: розподіл, адреси казначейства, реферальні нарахування, куди надходять кошти від продажу.
- Приймання платежів: які активи та мережі приймаємо, чи потрібне автоматичне повернення.
- Доступи та контроль: хто володіє адміністративними ролями, чи потрібен мультисиг, чи планується незалежний аудит і передача прав команді замовника.
У відповідь надсилаємо схему контрактів з ролями та потоками коштів, етапи робіт із порядком і залежностями, склад того, що передаємо після запуску — вихідники, політики доступу, інструкції для підтримки.
План не зобов'язує ні до обсягу, ні до термінів: його можна взяти цілком, почати з одного контракту токенсейлу або відкласти. Опишіть задачу — повернемося з оцінкою та планом робіт.







