Інтеграційне тестування смарт-контрактів та його сліпі зони
Модульні перевірки підтверджують, що окремий контракт працює за своєю специфікацією. Цінність протоколу народжується на стиках — між токеном і сховищем, між розрахунком і виплатою, між логікою та зовнішнім джерелом даних.
Інтеграційне тестування смарт-контрактів перевіряє зв'язку загалом у тому порядку викликів, у якому її побачить мережа Ethereum в межах однієї транзакції.
Відмови на стиках поодинці майже не видно: отримувач вважає, що оплата пройшла, відправник уже зафіксував списання, а між ними спрацював відкат. Розсинхрон станів виринає пізніше, коли за розбіжними даними рахують ліміти, частки чи винагороди, і відновлювати доводиться вручну.
Окрема зона — порядок викликів і повторні входи. Якщо виплата йде на зовнішню адресу до оновлення балансу, отримувач встигає викликати функцію знову й вивести більше, ніж йому дозволено. Такий захист перевіряється лише на рівні ланцюжка викликів, а не одного контракту.
Пропущені гілки сценаріїв — друга типова діра. Перевіряють успішний шлях і повну відмову, але не часткову: збій на середині відкочує транзакцію повністю, а зовнішній сервіс уже отримав подію й записав операцію у свою базу. Розбіжність між мережею та обліковою системою виявляється на звірці, тобто запізно.
Інциденти після оновлення коштують найдорожче: логіку змінюють у новому контракті, а суміжні модулі продовжують звертатися до старого, і частина стану залишається неврахованою. Розбираємо, що саме перевіряємо на зв'язці та як ловимо ці розбіжності до викочування.
Що дає перевірка наскрізних сценаріїв до викладки в основну мережу
Наскрізний сценарій проганяє весь ланцюжок — від виклику публічного методу до зміни стану й події, яку читає зовнішній сервіс. Ми піднімаємо ізольований стенд з локальною копією стану основної мережі, фіксуємо номер блоку й розгортаємо всю зв'язку контрактів.
Це дає відтворюваність: той самий набір транзакцій на одному знімку стану дає ідентичний результат у будь-якого інженера й у будь-якому складальному середовищі.
Повний набір сценаріїв проходить за хвилини замість годин ручних перевірок: паралельні прогони на копіях стенда не заважають одне одному, а стан відкочується знімком.
Повторюваність результатів — головний ефект: падіння означає реальну помилку в логіці, а не різницю в балансі тестового акаунта чи часі блоку.
Так знімаються цілі класи відмов: розбіжність прав між ролями, неправильний порядок викликів під час переказів між контрактами, повторний вхід, переповнення під час розрахунку часток, невідповідність подій і фактичного стану.
Частка дефектів, що доходять до користувача, падає — їх ловлять там, де виправлення займає години, а не розбір інциденту в основній мережі.
Оновлення перевіряється тим самим контуром: сценарій застосовує нову версію до знімка поточного стану й проганяє міграцію. Видно, що старі дані читаються коректно, а час простою під час оновлення обмежується однією транзакцією заміни, а не пошуком причини збою після неї.
Формати прогонів: локальний стенд, закрита мережа, основна мережа
Вибір середовища визначає, які дефекти прогін узагалі здатен зловити. Локальний стенд дає повну ізоляцію тестових даних і секунди на цикл, але не відтворює поведінку реальних пулів ліквідності, оракулів і завантаження мережі.
Закрита мережа з тими самими контрактами й знімками стану закриває середину: поведінка близька до бойової, а дані не перетинаються з робочими.
Що порівнюємо
| Варіант | Коли підходить | Обмеження середовища |
|---|---|---|
| Локальний стенд | Логіка контракту, права доступу, межі значень, регрес після кожної зміни коду | Немає реального завантаження, зовнішні виклики підмінюються заглушками |
| Закрита мережа | Сценарії між кількома контрактами, міграції стану, умови, що залежать від часу | Потрібно піднімати й супроводжувати вузли, стан перезбирається під кожен прогін |
| Прогін в основній мережі | Фінальна перевірка перед запуском: реальні зовнішні виклики, достовірна оцінка витрат газу | Транзакції необоротні, ізоляції тестових даних немає — лише читання або окремі акаунти |
Основний критерій вибору — ізоляція тестових даних. Прогін в основній мережі виправданий, коли перевіряється стикування із зовнішніми контрактами й фактична вартість операцій, а не логіка.
Закрита мережа зазвичай стає робочим режимом для інтеграційних сценаріїв: вона єдина дає і достовірність, і можливість відкотити стан.
Обмеження задає й середовище: різні версії вузлів, ліміти точок доступу й тайминги включення блоків можуть розходитися, тому набори перевірок ми тримаємо окремими під кожен режим.
Етапи робіт: від розбору сценаріїв до тестування на стенді
Інтеграційне тестування смарт-контрактів починається не з коду тестів, а з розбору зв'язки: як контракти викликають одне одного, що очікують від зовнішніх сервісів і в якому стані залишається система після кожної операції.
Помилка в порядку викликів або в очікуваному стані сусіднього контракту проявляється вже після розгортання, коли виправлення потребує міграції. Тому порядок робіт у нас такий: спочатку карта зв'язки, потім тести.
- Аудит сценаріїв — збираємо користувацькі шляхи та ролі: хто викликає метод, які ліміти й стани при цьому перевіряються, де очікуються відмови. На виході — перелік сценаріїв з пріоритетом за ризиком.
- Карта викликів — фіксуємо зв'язки між контрактами, токенами й зовнішніми джерелами даних: хто кого викликає, які значення передає й що повертає. Карта відразу показує місця, де тест зобов'язаний перевіряти й побічні зміни стану.
- Схема сценаріїв — кожен шлях перетворюємо на набір кроків з очікуваним станом до й після виклику, щоб розбіжність читалася точково, а не як «упав весь прогін».
- Налаштування середовища — стенд повторює цільову мережу за параметрами комісій, порядком підтверджень і версіями залежностей; окремо піднімаємо тестову мережу для перевірок, які локально не відтворюються.
- Прогін і розбір розбіжностей — запускаємо сценарії пакетами, логуємо входи, стан і події, кожну розбіжність доводимо до причини: помилка в контракті, в середовищі чи в самому очікуванні тесту.
- Критерії приймання — до фінального прогону узгоджуємо, які сценарії обов'язкові й який результат вважаємо успішним, щоб приймання не перетворилося на переговори.
- Передача — віддаємо набір тестів, конфігурації стенда й звіт із покриттям шляхів, щоб прогін повторювався у вашої команди без нас.
Артефакти на виході: набори сценаріїв, звіти, регламенти
Передаємо не папку з тестами, а робочий контур: запускуваний набір сценаріїв, відтворювані дані й правила, за якими ваша команда сама проганяє й оновлює перевірки після кожної правки контрактів. Нижче — що фізично залишається у вас у репозиторії та в документації.
- Набір сценаріїв інтеграційного тестування — згруповано за доменами: токен, доступи, виплати, зовнішні виклики. Кожен сценарій запускається окремо, тому перевірка, що впала, вказує на конкретну функцію, а не на «щось зламалося».
- Фікстури й документація щодо даних — описано, з якого стану піднімається стенд: знімок основної мережі на потрібній висоті блоку, профінансовані адреси, попередньо встановлені ролі. Стенд піднімається однією командою й дає однаковий результат у розробника й на сервері збірки.
- Схема взаємодії модулів — карта викликів між контрактами й зовнішніми сервісами з позначкою, що покрито перевірками, а що залишилося на ручному контролі.
- Звіт про прогін — пройдені й завалені сценарії, час виконання, зміна витрат газу відносно попереднього запуску, покриття гілок. Регрес видно до викладки, а не після.
- Регламент оновлення — обов'язковий набір сценаріїв під час правки контракту, хто підтверджує прогін, як фіксується нова версія й як відкотитися на попередню.
- Ролі й доступи — матриця прав на зміну сценаріїв, ключі тестових мереж, розділення доступу до стенда й до бойових конфігурацій.
Кейс: як пішов клас відмов під час випуску оновлення
Замовник випускав оновлення зв'язки з шести контрактів: токен, пул, оракул, модуль голосування й два допоміжні.
Модулі тестували окремо, а спільну поведінку перевіряли руками на тестовій мережі — випуск займав дві доби, і приблизно третину релізів доводилося відкочувати, бо несумісність інтерфейсів виринав уже після публікації.
Що змінили
Зібрали єдиний прогін: фікстури розгортають всю зв'язку в ізольованій мережі, включно з оновленням зі збереженням накопиченого сховища, тому перевіряється не лише новий код модуля, а й сумісність із уже записаними даними.
Додали перевірки інваріантів — сума часток, права ролей, ліміти випуску — вони проганяються після кожної операції, а не один раз наприкінці. Сценарій відкату на попередню версію став частиною прогону, а не аварійною процедурою за інструкцією.
Розгортання й запуск побудовані на Hardhat: ті самі сценарії виконуються в інженера локально й у збірці — розбіжностей між середовищами немає.
| Метрика | До | Після |
|---|---|---|
| Частка релізів з відкатом | кожен третій | один із чотирнадцяти |
| Час повної перевірки зв'язки | дві доби вручну | близько сорока хвилин |
| Час відкату на попередню версію | три-чотири години | до десяти хвилин одним сценарієм |
Тепер реліз не чекає вікна наприкінці тижня: прогін стартує на кожну зміну й падає на несумісності до публікації. Відкат перестав бути інцидентом з ручними кроками — це той самий сценарій із прогону, виконаний на бойовій мережі.
Що робити, якщо зв'язка вже розгорнута й працює в основній мережі?
Жива система відрізняється тим, що зупинити її для перевірки не можна: баланси й сховище змінюються під руками.
Перевірка будується на копії — знімок стану на фіксованому блоці розгортається в ізольованому вузлі, де відтворюється будь-яка послідовність викликів без ризику для основної мережі.
Цей самий знімок слугує точкою порівняння: після прогону звіряємо баланси, події та сховище з очікуваними значеннями.
Другий контур — тіньовий прогін: нова версія логіки приймає ті самі виклики, але результат нікуди не надсилається й порівнюється з відповіддю працюючого контракту. Розбіжність хоча б в одному сценарії означає несумісність, і збірка до мережі не доходить.
Зовнішні залежності — оракули, пули, контракти партнерів — підмінюються керованими заглушками із заданою поведінкою, включно з відмовами й затримками відповіді.
Окремо перевіряємо зворотну сумісність оновлень: старі записи у сховищі мають читатися новою логікою, а випущені події — залишитися зрозумілими індексаторам і гаманцям.
У оновлюваних контрактах порядок полів і слоти зберігання фіксуємо заздалегідь на схемах OpenZeppelin: нове поле додається лише в кінець. Так іде клас відмов, за яких після оновлення обнуляються баланси або ламаються права доступу.
Випуск іде поетапно: знімок, тіньовий прогін на копії, обмежений запуск на частці трафіку з лімітами й миттєвим відкатом. Між етапами тримаємо метрики — частка успішних викликів і розбіжність з емуляцією.
Якщо розбіжностей немає, версія розкочується на всю систему; якщо є — відкат займає один виклик, і користувачі його не помічають.
Часті технічні сумніви перед стартом
Перед стартом замовники ставлять той самий набір запитань, і майже всі вони про межі: що саме перевіряємо, на якій мережі, як це відображається на працюючому продукті. Нижче — предметні відповіді на ті, що найчастіше гальмують рішення.
Чим це відрізняється від перевірки окремих модулів?
Модульні перевірки ізолюють одну функцію. Інтеграційний сценарій проходить шлях повністю: виклик контракту, переказ активів, запис події, новий стан. Тут виринають неправильні дозволи, порядок викликів і повторний вхід — те, що ізоляція не бачить.
Чи потрібна реальна мережа?
Основний обсяг проганяємо на локальній копії стану мережі: середовище піднімається з конфігурації за хвилини, один сценарій іде секунди. Реальний контур потрібен на фінальному прогоні — він підтверджує поведінку зі справжніми адресами й лімітами.
Як зрозуміти, що покриття достатнє?
Рахуємо не рядки, а гілки сценаріїв: успішний шлях, відмова за правами, відмова за лімітами, граничні суми, відкат. Якщо гілка може зупинити виведення коштів — вона покрита тестом.
Як це впливає на працюючий продукт?
Прогони не торкаються основної мережі, робочі ключі в них не використовуються. Рідкісні стани — порожній резерв, ліміт на межі, зависла транзакція — відтворюємо примусово через знімок стану, тому тести йдуть паралельно з роботою сервісу.
Обговоримо задачу: з чого почнемо й що потрібно з вашого боку
Перший дзвінок щодо інтеграційного тестування смарт-контрактів — технічний, а не презентаційний: розбираємо архітектуру протоколу, межі між контрактами й зовнішнім світом та сценарії, де помилка коштує найдорожче.
Години зазвичай достатньо, щоб зрозуміти обсяг — скільки контрактів у зв'язці, які з них оновлювані, що викликається ззовні й які ролі мають право змінювати стан.
Щоб розмова була предметною, матеріали варто підготувати заздалегідь. Від замовника потрібні:
- репозиторій або архів контрактів разом із наявними тестами, навіть частковими;
- опис протоколу: ролі, права доступу, логіка оновлення контрактів;
- адреси розгорнутих контрактів і тестових мереж, до яких є робочий доступ;
- перелік зовнішніх інтеграцій — оракули, мости, пули, кастодіальні сервіси — та їхні інтерфейси;
- ключі й вузли для тестових мереж плюс складальне середовище, якщо сценарії мають іти в конвеєрі;
- журнал інцидентів і відомих дефектів: що вже ламалося й за яких умов відтворювалося;
- вимоги до приймання — за якими сценаріями вважаємо покриття достатнім.
Розмова закінчується не «дякую, подумаємо», а планом робіт: етапи, склад локального стенда й копій основної мережі, перелік сценаріїв з пріоритетами, формат звітів і оцінка обсягу — за строками й завантаженням команди. Старт проєкту — одразу після узгодження плану. Опишіть задачу — повернемося з планом та оцінкою.







