Разработка ERC-20 токена: где ломаются контракты
Ошибки при выпуске токена почти никогда не в логике — они в деталях, которые в тестовой сети ничего не ломают. Десятичная точность задаётся один раз и на всю жизнь контракта: ноль вместо восемнадцати — и кошелёк покажет одну единицу вместо целого объёма. Переполнение при сложении балансов в сборке без проверок даёт цикличный перенос и «бесконечный» баланс у одного адреса.
Отдельная группа — права. Если выпуск не закрыт ролью, начислить себе произвольный объём может любой адрес. Неудачно и обратное: роль на выпуск закреплена за обычным кошельком без мультиподписи — потеря ключа останавливает эмиссию навсегда, компрометация отдаёт контроль над предложением злоумышленнику.
Третья — незащищённые операции с балансом. Перевод без проверки нулевого адреса отправляет токены в недоступное место, отсутствие события Transfer ломает индексаторы и обменники, а списание по разрешению без учёта остатка лимита позволяет снять больше подтверждённого.
Четвёртая — несовместимость токена с кошельками и внешними сервисами: нестандартный возврат у перевода и одобрения, иные названия полей метаданных, отсутствие привычных событий. Актив не отображается в кошельке или не зачисляется на депозит биржи, а уязвимость смарт-контракта всплывает уже после листинга — исправление требует перевыпуска и раздачи нового актива держателям.
Как эти сценарии закрываются на этапе проектирования и проверок — разбираем ниже.
Что даёт корректно спроектированный токен
Корректно спроектированный контракт ERC-20 — это не только работающий перевод. В него заранее заложены проверки, которые снимают целый класс отказов: отправка на адрес контракта, не умеющего принимать токены, потеря точности при дроблении долей, повторный вызов одной и той же операции. Доля отклонённых транзакций уходит с нескольких процентов до единичных случаев, и каждая такая операция перестаёт превращаться в ручной разбор с повторной отправкой.
Совместимость с кошельками и сервисами проверяется, а не подразумевается. Контракт ведёт себя одинаково для кастодиальных решений, депозитных адресов бирж и обозревателей сети: события перевода отдаются в ожидаемом виде, балансы сходятся до последнего знака. Подключение нового сервиса сокращается с недель переписки и доработок до нескольких дней — на стороне интеграции просто нечего чинить.
Стабильный выпуск токена держится на предсказуемости. Лимиты, роли и права на эмиссию описаны явно, скрипты массовых начислений идемпотентны, повтор не создаёт дублей. Число ручных операций при начислениях падает в разы: сверка идёт по выгрузке, а не построчно.
Отдельный эффект — управляемость без ломки выданных балансов. Административные функции отделены от логики переводов, лимиты и паузы меняются параметрами, а не перевыпуском контракта. Это запас прочности, который позволяет добавлять новые сценарии — начисления, кэшбэк, стейкинг — не останавливая обращения.
Форматы выпуска: базовый стандарт и расширенная логика
Формат выпуска токена определяет не «навороченность», а то, какие операции с активом нужны на старте и что придётся добавлять позже. Стандартная логика контракта — перевод, баланс, разрешение на списание, выпуск и сжигание — это минимум кода и минимум поверхности для ошибок. Расширенная логика токена добавляет роли, лимиты на операции, начисление и заморозку: каждая надстройка усложняет аудит и меняет то, как токен принимают кошельки и биржи.
Ниже — четыре варианта, между которыми реально выбирают на этапе проектирования. Ограничения ERC-20 показаны честно: часть задач стандарт не решает в принципе, и это лучше увидеть до разработки.
| Вариант | Когда подходит | Ограничения |
|---|---|---|
| Минимальный стандарт | Раздача, листинг, учёт доли без сложных правил | Нет ролей и лимитов; новые правила потребуют миграции на новый контракт |
| Токен с ролями и лимитами | Нужны администратор, пауза переводов, суточные лимиты, разделение прав | Больше кода — больше поверхность атаки; частая смена правил настораживает держателей и биржи |
| Контракт с начислением и заморозкой | Поощрение держателей, вестинг команды, блокировка доли до срока | Нужны надёжные внешние источники данных; усложняется учёт и отчётность перед биржей |
| Обёртка вокруг существующего актива | Перенос готового актива в сеть без нового предложения | Требует ответственного держателя резерва и регулярного подтверждения обеспечения; доверие к обёртке не выше, чем к нему |
Перед выбором мы разбираем сценарии, которые должны работать через год: миграция, ручное вмешательство по решению владельца, приём токена на площадках.
Этапы инженерной работы над контрактом
Порядок этапов нужен не для отчётности, а чтобы поймать дорогие ошибки до публикации. Код в сети неизменяем: после развёртывания исправить опечатку в условии или дыру в правах доступа без выпуска нового контракта и миграции держателей уже нельзя. Поэтому цена правки растёт с каждым шагом — идём от спецификации к коду, а не наоборот.
- Разбор задачи и модели экономики актива: сколько токенов выпускается, есть ли доэмиссия и сжигание, какие ограничения на переводы и комиссии. Модель фиксируется в спецификации до первой строки кода.
- Схема ролей и прав: кто выпускает, замораживает адреса, меняет параметры. Отдельно проверяем, что привилегии нельзя получить в обход — через прокси, делегирование или вызов из другого контракта.
- Сборка контракта: базовые функции стандарта берём из проверенных библиотек, дописываем только недостающую логику. Поверхность ошибки выходит меньше, чем при написании с нуля.
- Локальные прогоны и тестирование контракта: граничные значения — нулевые адреса, переполнения, повторные вызовы, лимиты. Затем прогон на тестовой сети с реальными кошельками и сценариями.
- Независимый аудит смарт-контракта: разбираем отчёт, закрываем замечания, спорные места проверяем повторно.
- Публикация токена: развёртывание в основной сети и верификация исходников в обозревателе, чтобы адрес можно было сверить с кодом.
- Передача и обучение команды: документация по ролям, инструкция по выпуску и отзыву, порядок действий при инциденте.
Артефакты передачи: код, схемы, регламенты выпуска
Передача проекта не заканчивается развёртыванием контракта в основной сети. Заказчик получает комплект, по которому токен можно развивать и сопровождать без нас: код, разграничение прав, регламенты и проверки. Ниже — что именно фиксируется в акте передачи.
- Исходный код контракта с комментариями: читаемая структура, пояснения к внешним вызовам и событиям, отсутствие «магических» констант, зашитых в логику.
- Схема ролей и прав доступа: кто может выпускать и сжигать токены, останавливать операции и менять параметры, как права разносятся между адресами и мультиподписью.
- Регламент выпуска токена: пошаговая процедура эмиссии с лимитами на операцию, очерёдностью подписей и проверкой адреса получателя перед выпуском.
- Процедура остановки операций: при каких условиях срабатывает пауза, кто принимает решение, как операции возобновляются и что происходит с уже выпущенными балансами.
- Инструкция по восстановлению доступа: ротация ключей, передача административной роли, порядок действий при компрометации подписанта.
- Набор проверок: модульные и интеграционные тесты на ключевые сценарии, статический анализ и отчёт внешнего аудита с перечнем закрытых замечаний.
- Документация на контракт: описание внешнего интерфейса, адреса развёрнутых экземпляров в тестовой и основной сети, параметры выпуска и ограничения.
Все артефакты передаются в репозитории заказчика вместе с историей изменений — обновление токена или смена подрядчика не начинаются с обратной разработки.
Кейс: сняли класс отказов при выпуске актива
Точка отсчёта
Актив выпускался как быстрый прототип: дополнительная эмиссия, заморозка адресов и сверка балансов шли через ручные скрипты — девять операций на один цикл, каждую запускали только после проверки глазами. Доля отклонённых транзакций держалась на уровне около 7%: часть падала из-за неверно выставленных лимитов, часть — на повторном списании, когда два скрипта успевали обратиться к одному резерву. На разбор одного такого случая уходило до часа, а полная сверка реестра занимала ещё половину рабочего дня.
Что изменили и что стало
Логику перенесли в один контракт с разделёнными ролями и защитой от повторного исполнения, а рутинные действия — в скрипты с обязательной симуляцией на тестовой сети до отправки. Партия выпускается одним вызовом, лимиты считаются от текущего состояния сети, поэтому транзакция не «сгорает» впустую. Класс отказов, связанный с ручным вводом адресов и сумм, закрыт полностью.
Стало: доля отклонённых транзакций — 0,4%, и это осознанные отмены оператором, а не сбои. Цикл выпуска сократился с 40 до 6 минут, ручных операций на партию — две вместо девяти. Сверку реестра снимаем автоматически по данным Etherscan, расхождений с внутренним учётом нет уже несколько релизов подряд — проверка занимает минуты вместо полудня.
Что делать, если контракт уже развёрнут и менять его нельзя
Развёрнутый контракт изменить нельзя — в этом и смысл неизменяемости: ни административных функций, ни подмены адреса задним числом там уже не появится. Но состояние токена живёт не в коде, а в хранилище балансов, поэтому миграция контракта строится не на правке старого, а на выпуске нового и переносе держателей.
Базовая операция — снапшот балансов на конкретном номере блока. По нему считываются все адреса и суммы один раз, и дальше список не пересчитывается: так у держателей не остаётся способа перекинуть токены между кошельками и задвоить начисления. Снапшот становится официальным источником прав при замене развёрнутого токена.
Новый контракт публикуется отдельно, а старый продолжает работать — площадки не переключаются в один день. Держатель отправляет прежние токены в контракт-обменник и получает новые по фиксированному курсу, как правило один к одному; адрес обменника и курс объявляются заранее.
Период на переход задаётся с запасом, после чего обмен закрывается, а невыкупленные остатки блокируются. Это дисциплинирует держателей и не даёт ликвидности распыляться между двумя версиями актива.
Отдельное направление — согласование с биржами, кошельками и обозревателями: им нужны адрес нового контракта, дата смены тикера и подтверждение снапшота. Когда это сделано, переезд проходит без потери истории и без ручной правки балансов каждого держателя.
Технические сомнения: доступ, лимиты, проверка кода
Права выпуска, лимиты и заморозка — это часть модели доступа, которую проектируют вместе с контрактом, а не дописывают после запуска. Ниже — вопросы, которые чаще всего поднимают инженерные команды при разборе прав администратора и приёмке кода.
Кому принадлежат права на выпуск токена и как они передаются?
Выпуск открывает отдельная роль: адрес, который может создавать новые токены. На старте это кошелёк развёртывания, затем права переезжают на мультиподпись, а роль развёртывающего отзывается. Роли на заморозку и на изменение параметров выдаём раздельно — компрометация одного ключа не даёт управлять всем предложением.
Можно ли изменить логику контракта после запуска?
Зависит от шаблона. Неизменяемый контракт править нельзя: доработки означают миграцию на новый адрес. Обновляемый держит логику за прокси, и её меняет администратор — удобно, но весь риск переезжает в права администратора. Поэтому закрываем их мультиподписью и задержкой на исполнение: у держателей есть окно, чтобы увидеть изменение заранее.
Как подтверждается соответствие опубликованного кода исходникам?
Верификация контракта — это публикация исходников и параметров сборки, из которых воспроизводится тот же байткод, что лежит по адресу. Проходим её сразу после развёртывания: до этого снаружи виден только байткод, и логику никто не проверит. Контрольные суммы артефактов фиксируем в отчёте о выпуске.
Что именно проверяет аудит и что остаётся за его рамками?
Аудит смотрит арифметику, разграничение ролей, внешние вызовы и граничные сценарии переводов. Отдельно прогоняем инварианты по лимитам переводов и заморозке активов: сумма балансов не расходится с выпуском, а заблокированный адрес не обходит ограничение через посредника. Аудит не подтверждает экономическую модель и не заменяет процедуры работы с ключами — это зона эксплуатации на вашей стороне.
Обсудим задачу и вернёмся с планом выпуска
Оценка разработки токена без контекста превращается в широкую вилку «от и до», поэтому начинаем не с часов, а с модели актива. Пришлите то, что уже есть — черновик токеномики, презентацию для инвесторов, переписку с юристами: этого достаточно, чтобы увидеть реальный объём работ и узкие места.
- Назначение актива: что токен подтверждает — долю, право требования, доступ к сервису или внутреннюю учётную единицу.
- Сценарии использования: выпуск, переводы, сжигание, заморозка адресов, ограничения на передачу, роли администратора и их полномочия.
- Требования регулятора и партнёров: процедуры проверки держателей, лимиты на операции, отчётность, юрисдикции участников.
- Куда планируется размещение: площадки и кошельки, их требования к стандарту токена и к метаданным.
- Существующие наработки: черновики контрактов, тесты, отчёты аудита, если код уже писался другой командой.
- Жёсткие рамки: привязка к событию, объёмы эмиссии, условия разблокировки и график выплат.
По этим вводным возвращаемся с планом работ по контракту: схема контракта с перечнем функций, ролей и прав доступа, состав этапов с измеримым результатом на каждом, сроки выпуска и порядок проверок перед публикацией.
Чтобы обсудить задачу выпуска предметно, достаточно описать её в свободной форме — соберём оценку, план и вернёмся с вопросами, если чего-то не хватит.







