Розробка контракту launchpad: токенсейли, whitelist, вестинг

Провести продаж токенів без збоїв і спірних умов розблокування — завдання, де помилка коштує довіри інвесторів. Ми розробляємо launchpad-контракти під ключ: білий список, алокації, графік розблокування та ролі доступу — з зрозумілою логікою і передаванням управління вашій команді. Це скорочує строк підготовки запуску і знижує ризик спірних ситуацій з інвесторами.
Часті запитання

Розробка launchpad контракту: де ламається токенсейл

Контракт токенсейлу — найбільш навантажена ділянка launchpad: він першим приймає кошти, останнім віддає токени і залишається публічно читаним після запуску.

Помилки в білому списку тут не абстракція: адреса, що потрапила до переліку двічі — як гаманець і як контракт-посередник, — отримує подвоєну алокацію, і розподіл з'їжджає ще до відкриття продажу.

Окрема біда, коли ліміт рахується за адресою відправника: один учасник заводить кілька гаманців і проходить кап по кожному, витісняючи інших з раунду.

Подвійна участь у продажу зазвичай спливає вже після закриття, коли рахувати пізно: суми зібрані, а алокації доводиться перезбирати вручну.

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

Спірні алокації між раундами додають третю проблему — пріоритет заявок не зафіксований, і черга на розподіл визначається тим, хто встиг відправити транзакцію першим.

Ціна у всіх сценаріїв одна: повернення, ручний перерахунок і інвестори, які не прийдуть на наступний запуск.

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

Логіка продажу: білий список, алокації та графік розблокування

Список учасників не переписується в контракт построково — у сховищі лежить тільки корінь дерева хешів, а адреса приходить на купівлю з доказом включення і своєю сумою алокації.

Тому продаж витримує десятки тисяч адрес, зріз стану фіксується на конкретному блоці, а правка одного запису не потребує перезбирання контракту.

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

Ціна раунду задається конфігом, тому наступні раунди запускаються зміною параметрів, а не нового коду.

Вестинг будується за принципом «все нараховано, але не все виводимо»: період очікування, потім лінійне розблокування від старту продажу.

Токени кожен учасник забирає сам окремим викликом — контракт не розсилає баланси циклом по масиву, тому вартість операції не зростає з кількістю власників.

Це знімає головний клас відмов на виводі: відмова в однієї адреси не блокує інших. Ролі, паузу та захист від повторного входу беремо з готових перевірених бібліотек OpenZeppelin, а не пишемо самостійно.

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

Формати запуску: власний контракт, фабрика, модуль платформи

Формат запуску визначає, скільки коду пишемо один раз, а скільки перевикористовуємо. Власний контракт продажу дає повний контроль над раундами, лімітами на гаманець і графіком розблокування, але аудит і підтримка лягають на нас цілком.

Фабрика розгортає копії вже перевіреного шаблону, а модуль платформи додає готову адмінку, облік часток і допуск за списком.

Вибір упирається в модель розподілу: скільки раундів і цінових рівнів, як формується список допуску, чи є повернення і як саме розблоковується вестинг.

Якщо правила нестандартні хоча б за одним пунктом, шаблон доведеться доопрацьовувати — і це простіше вирішити до запуску, ніж переносити стан після.

Порівняння форматів запуску

Формат Коли підходить Обмеження
Власний контракт продажу Нестандартні раунди, приватні умови, ліміти на гаманець, зв'язка із зовнішніми сервісами Повний цикл аудиту та підтримки, довше до запуску, адмінку та облік пишемо самі
Контракт-фабрика Серія продажів за однаковими правилами, кілька проєктів під одним управлінням Шаблон фіксований: відхилення потребують нової версії, помилка тиражується на всі копії
Модуль платформи Стандартні раунди, готовий список допуску, шаблонний вестинг, запуск у стислі терміни Логіка обмежена рамками платформи, частина параметрів недоступна, залежність від її оновлень

Зміна формату на живому продажу — окрема задача: переносяться снапшоти допуску, накопичені частки та незакриті клейми, а попередні контракти залишаються тільки на читання. Тому формат обираємо під фінальну модель розподілу, а не під швидкість першого раунду.

Етапи роботи: від моделі розподілу до передачі управління

Ми не починаємо писати код, поки модель продажу не зафіксована на папері: контракт у блокчейні не можна тихо поправити після публікації, і помилка в розрахунку раунду або графіку виплат коштує дорожче, ніж зайвий день узгодження.

Тому етапи розробки контракту вибудувані так, що кожен закінчується перевіреним артефактом — специфікацією, схемою ролей або прогоном тестів.

  1. Розбір моделі розподілу: раунди, ліміти на учасника, ціна токена, пауза перед першими нарахуваннями, частки команди та резерву. Фіксуємо односторінковою специфікацією з прикладами розрахунків.
  2. Схема ролей і доступів: хто веде білий список, хто відкриває раунд, хто виводить кошти. Окремо відзначаємо, які права віддаємо мультипідпису, а які спалюємо після фінального раунду.
  3. Складання контрактів: продаж, токен, вестинг і розподіл — окремими модулями із загальною схемою обліку балансів і лімітів.
  4. Перевірка контракту: тестами закриваємо повторні заявки, переповнення раунду, достроковий вивід, скасування продажу та роботу адміністратора.
  5. Тестовий запуск продажу на копії мережі: повний цикл купівлі, нарахування за графіком і виводу, звірка обсягів і черговості виплат.
  6. Передача контракту: публікація, передача управління замовнику, документація за ролями та пам'ятка для підтримки першого раунду.

Комплект передачі: контракти, схеми, політики та регламенти

Передача проєкту — це не тільки доступи та розгорнутий код. Ми віддаємо комплект, за яким нова команда вводиться в курс за один розбір: що де налаштовано, хто чим управляє, як діяти при збої. Нижче — що саме залишається у замовника.

  • Документація за контрактом — призначення модулів, параметри розгортання (ціна етапу, ліміти, вікна продажів), перелік функцій власника та точок, де зміна параметра зачіпає вже активні продажі.
  • Схема розподілу — маршрут коштів від покупця до фонду проєкту, пулу ліквідності та резерву, правила переведення виплати в наступний статус і момент, з якого вивід стає доступним.
  • Матриця ролей доступу — хто додає адреси до білого списку, хто змінює графік розблокування, хто зупиняє торги; які операції потребують двох підтверджень і як передати права при зміні адміністратора.
  • Інструкція адміністратора — сценарії типових операцій (старт етапу, додавання учасників, дострокове завершення, зняття коштів) з переліком параметрів для перевірки та розбором подій транзакції.
  • Регламент супроводу — періодичність перевірок, порядок оновлення конфігурації, зберігання та ротація ключів, межа нашої відповідальності після передачі.
  • Регламент при інциденті — що робити при завислій транзакції, помилці в ціні етапу або ознаках компрометації ключа: перша дія, коло відповідальних, порядок фіксації слідів.

Кейс: продаж з білим списком і графіком розблокування

Платформа проводила продаж з білим списком і графіком розблокування. До нас зарахування йшло вручну: оператор звіряв заявки, додавав адреси партіями і окремо рахував частки в таблиці.

На піку це давало чергу заявок на кілька годин і помилки в сумах, які знаходили вже після закриття раунду.

Ми переписали контур продажу: контракт приймає адресу тільки за підтвердженням з білого списку, частка фіксується в момент зарахування, а графік розблокування заданий розписом всередині контракту. Учасник сам викликає розблокування — оператор у цьому не бере участі.

Базові реалізації токена та вестингу взяли з OpenZeppelin, тести закрили сценарії з достроковим виводом і повторним зарахуванням.

Що змінилося в метриках

Метрика До Після
Ручні операції при зарахуванні кожна заявка вручну 0, тільки видача ролі
Випуск нової кампанії 4-5 днів один робочий день
Звернення щодо розблокування 50-60 на тиждень поодинокі
Відмови транзакцій у пік 10-15% заявок 0
Інциденти з розрахунком часток 3-4 за кампанію 0

Відмови в пік прибрали чергою: заявки збираються пакетами, повтор відправляється автоматично, запас за газом виставляється заздалегідь. Підтримка перестала бути вузьким місцем — звільнені години пішли на підготовку наступного раунду.

Що робити, якщо продаж уже триває, а умови розблокування змінюються

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

Звідси три робочі сценарії: міграція контракту, надбудова поверх поточного та друга кампанія з чистими правилами.

Міграція — найпередбачуваніший варіант. На фіксованому блоці знімаємо снапшот: адреси, сплачені суми, розмір алокацій і вже отримане за графіком.

У новому контракті, зібраному на перевірених бібліотеках OpenZeppelin, учасник підтверджує ті самі дані, а зміна графіка розблокування застосовується тільки до невиданої частини.

Старий контракт переводимо в режим тільки на читання, щоб подвійне отримання було технічно неможливим.

Надбудова дешевша за ризиком, коли продаж і вестинг рознесені: продаж тримає ціну, ліміти та whitelist, а розблокування йде окремим контрактом.

Тоді оновлення правил продажу — це розгортання нового контракту вестингу та перемикання вказівника на нього, а учасники нічого не перепідписують.

Друга кампанія доречна, коли умови не можна змінювати заднім числом: поточний продаж закриваємо за фактом, залишки нерозподілених алокацій переносимо в новий пул, правила фіксуємо заново.

Що обрати, вирішують права адміністратора в контракті та наявність механізму паузи — від цього залежить, чи пройде міграція автоматично, чи потребуватиме ручного переведення учасників.

Технічні питання щодо запуску продажу та ролей доступу

Перед публікацією контракту продажу ми розводимо дві множини: що задається при розгортанні і що залишається змінним.

Ціна, вікно раунду, жорсткий кап і ліміт на гаманець записуються в незмінні поля; змінюються тільки заздалегідь оголошені перемикачі — пауза купівель і дострокове завершення при досягненні капу. Нижче — короткі відповіді на сумніви, які найчастіше піднімають перед стартом.

Чи можна змінити умови раунду після публікації?

Ні. Оновити їх вийде тільки новим контрактом продажу з явною міграцією та оголошенням. Кожен виклик паузи або завершення фіксується подією — стан продажу видно в оглядачі блоків.

Як контракт перевіряє право адреси на купівлю?

Список хешується поза мережею в дерево, контракт зберігає тільки корінь, а покупець пред'являє доказ — стан залишається компактним, а перевірка коштує однаково для будь-якого розміру списку.

Другий варіант — підпис з обмеженим терміном дії, зручний для закритих раундів без публікації списку. В обох випадках звіряється адреса отримувача, тому право не можна переслати іншому гаманцю.

Кому переходять адміністративні права після запуску?

Мультипідпису проєкту, а не одному ключу розробника. Для критичних операцій налаштовуємо затримку виконання: оголошена дія набирає чинності через заданий інтервал і весь цей час видно в мережі — встигнути відреагувати можна до виконання. Після розблокування токенів адміністративні функції знімаються повністю.

Що перевіряється до публікації контракту?

Прогін на тестовій мережі за сценаріями: купівля понад ліміт, повторний вхід у функцію купівлі, купівля поза вікном раунду, спроба забрати токени до розблокування.

Потім незалежний аудит і звірка опублікованого коду з перевіреною версією — розбіжності в розрахунку часток і графіку розблокування знаходяться до старту, а не після.

Обговоримо задачу та повернемося з планом робіт із продажу

Щоб оцінка та план робіт із запуску продажу токенів були предметними, а не «плюс-мінус за досвідом схожих проєктів», нам потрібні ввідні від замовника.

Без них неясно, де основна складність: у механіці раундів, у юридичних обмеженнях за країнами покупців чи в інтеграціях з гаманцями.

Що потрібно надіслати, щоб ми повернулися з розрахунком:

  • Мережа та стандарт токена: EVM-сумісна, Solana або власна мережа — від цього залежить архітектура контракту та підтримка гаманців.
  • Механіка раундів: фіксована ціна, ступінчаста за раундами або аукціон, ліміти на гаманець, цільові суми збору та умови повернення коштів при недосягненні порогу.
  • Правила whitelist: ручний список адрес, дерево Меркла, підпис від вашого сервера або відкрита купівля з перевіркою особи.
  • Вестинг і клейм: кліф, лінійний або ступінчастий графік, дата виходу на ринок, порядок роботи з нерозподіленими токенами.
  • Токеноміка: розподіл, адреси казначейства, реферальні нарахування, куди надходять кошти від продажу.
  • Приймання платежів: які активи та мережі приймаємо, чи потрібне автоматичне повернення.
  • Доступи та контроль: хто володіє адміністративними ролями, чи потрібен мультисиг, чи планується незалежний аудит і передача прав команді замовника.

У відповідь надсилаємо схему контрактів з ролями та потоками коштів, етапи робіт із порядком і залежностями, склад того, що передаємо після запуску — вихідники, політики доступу, інструкції для підтримки.

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

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

Останні роботи

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