Розробка ERC-20 токена під ключ: створення, аудит, верифікація

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

Розробка ERC-20 токена: де ламаються контракти

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

Переповнення під час додавання балансів у збірці без перевірок дає циклічне перенесення і «нескінченний» баланс в однієї адреси.

Окрема група — права. Якщо випуск не закритий роллю, нарахувати собі довільний обсяг може будь-яка адреса.

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

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

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

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

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

Що дає коректно спроєктований токен

Коректно спроєктований контракт ERC-20 — це не лише працюючий переказ.

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

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

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

Підключення нового сервісу скорочується з тижнів листування та доопрацювань до кількох днів — на стороні інтеграції просто нічого лагодити.

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

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

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

Формати випуску: базовий стандарт і розширена логіка

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

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

Нижче — чотири варіанти, між якими реально обирають на етапі проєктування. Обмеження ERC-20 показані чесно: частину завдань стандарт не вирішує в принципі, і це краще побачити до розробки.

Варіант Коли підходить Обмеження
Мінімальний стандарт Роздача, лістинг, облік частки без складних правил Немає ролей і лімітів; нові правила потребуватимуть міграції на новий контракт
Токен із ролями та лімітами Потрібні адміністратор, пауза переказів, добові ліміти, розподіл прав Більше коду — більше поверхня атаки; часта зміна правил насторожує держателів і біржі
Контракт із нарахуванням і заморозкою Заохочення держателів, вестинг команди, блокування частки до строку Потрібні надійні зовнішні джерела даних; ускладнюється облік і звітність перед біржею
Обгортка навколо наявного активу Перенесення готового активу в мережу без нової пропозиції Потребує відповідального держателя резерву та регулярного підтвердження забезпечення; довіра до обгортки не вища, ніж до нього

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

Етапи інженерної роботи над контрактом

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

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

Артефакти передачі: код, схеми, регламенти випуску

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

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

Усі артефакти передаються в репозиторії замовника разом з історією змін — оновлення токена або зміна підрядника не починаються зі зворотної розробки.

Кейс: зняли клас відмов під час випуску активу

Точка відліку

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

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

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

Що змінили і що стало

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

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

Стало: частка відхилених транзакцій — 0,4%, і це усвідомлені скасування оператором, а не збої. Цикл випуску скоротився з 40 до 6 хвилин, ручних операцій на партію — дві замість дев’яти.

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

Що робити, якщо контракт уже розгорнуто і змінити його не можна

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

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

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

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

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

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

Технічні сумніви: доступ, ліміти, перевірка коду

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

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

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

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

Чи можна змінити логіку контракту після запуску?

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

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

Як підтверджується відповідність опублікованого коду вихідним кодам?

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

Що саме перевіряє аудит і що залишається поза його межами?

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

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

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

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

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

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

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

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

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

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

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