Тестування смарт-контрактів (інтеграційні тести)

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

Інтеграційне тестування смарт-контрактів та його сліпі зони

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

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

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

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

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

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

Що дає перевірка наскрізних сценаріїв до викладки в основну мережу

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

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

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

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

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

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

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

Формати прогонів: локальний стенд, закрита мережа, основна мережа

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

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

Що порівнюємо

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

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

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

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

Етапи робіт: від розбору сценаріїв до тестування на стенді

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

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

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

Артефакти на виході: набори сценаріїв, звіти, регламенти

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

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

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

Замовник випускав оновлення зв'язки з шести контрактів: токен, пул, оракул, модуль голосування й два допоміжні.

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

Що змінили

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

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

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

Метрика До Після
Частка релізів з відкатом кожен третій один із чотирнадцяти
Час повної перевірки зв'язки дві доби вручну близько сорока хвилин
Час відкату на попередню версію три-чотири години до десяти хвилин одним сценарієм

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

Що робити, якщо зв'язка вже розгорнута й працює в основній мережі?

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

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

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

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

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

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

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

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

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

Часті технічні сумніви перед стартом

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

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

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

Чи потрібна реальна мережа?

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

Як зрозуміти, що покриття достатнє?

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

Як це впливає на працюючий продукт?

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

Обговоримо задачу: з чого почнемо й що потрібно з вашого боку

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

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

Щоб розмова була предметною, матеріали варто підготувати заздалегідь. Від замовника потрібні:

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

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

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

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

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