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







