Michelson: чому контракти на Tezos ламаються на формальній перевірці
Michelson — це низькорівнева мова зі стековою машиною, де немає звичних змінних і циклів: програма збирається з послідовності інструкцій, кожна з яких знімає значення зі стека й кладе результат назад.
Помилка в порядку операндів або в анотації типу не «вилазить» у рантаймі — контракт просто не проходить формальну перевірку й не публікується в мережу. Розробка смарт-контрактів на Tezos тому й починається не з коду, а з точної моделі типів і потоку даних.
Найчастіша причина падіння на перевірці — помилки типізації Michelson. Стекова машина строго стежить за тим, що лежить на вершині, і вимагає явних анотацій (:int, :nat, :address) там, де тип не виводиться однозначно.
Якщо анотація розходиться з фактичним значенням — наприклад, nat передається туди, де очікується int, — перевірка відхиляє контракт цілком, а не окрему гілку.
Друга категорія — невраховані побічні ефекти.
Операції на кшталт TRANSFER_TOKENS або CREATE_CONTRACT змінюють стан мережі, і їх не можна викликати в довільному місці: порядок операцій і обробка відмов (FAILWITH) мають бути продумані так, щоб часткове виконання не залишало контракт у неузгодженому стані.
Окремо б'є по проєкту вартість газу Tezos. Неоптимальні структури даних — великі map і big_map, зайві проміжні копії, неакуратні цикли через ITER — роздувають споживання газу, і транзакція може не пройти за лімітом. Розбираємо, як це закривається на етапі проєктування типів і структур.
Що дає грамотна архітектура контракту на Michelson
Архітектура зберігання та вартість операцій
У Michelson немає динамічних структур даних у звичному вигляді: big-map винесено в окреме сховище, а вартість операції визначається обсягом записів у storage та кількістю кроків інтерпретатора.
Тому розкладка стану за кількома big-map із ключами фіксованої форми замість одного вкладеного дерева знижує ціну кожної транзакції: інтерпретатору не потрібно розгортати глибоку вкладеність, а оновлення зачіпає одну гілку.
На реальних контрактах така перебудова скорочувала витрати газу на масових операціях у рази — за того самого функціоналу.
Формальна верифікація як частина архітектури
Контракт, де інваріанти винесено в окремі перевірювані функції, а не розмазано по гілках IF, проходить формальну верифікацію швидше й з меншою кількістю ручних припущень.
Ми проєктуємо так, щоб ключові властивості — збереженість балансу, недоступність повторного виведення, коректність прав — формулювалися як окремі леми. Це прибирає цілий клас відмов, які не ловляться тестами: гонки між викликами, необроблені гілки FAILWITH, неявні переповнення.
Порівняння підходів до розробки
| Підхід | Коли підходить | Обмеження |
|---|---|---|
| Ручний Michelson | Жорсткі вимоги до газу, аудит критичних ділянок | Дорожчий у підтримці, вищий поріг входу для команди |
| Компіляція з високорівневої мови | Швидкий вивід продукту, часта логіка | Менше контролю над розкладкою storage та витратами газу |
| Гібрид: ядро на Michelson, обв'язка компільована | Складні контракти з критичним ядром | Потребує дисципліни на стику шарів |
Безпека та перевірюваність
Окремий шар — статичний аналіз і перевірка типів до деплою: він відсікає помилки, які на тестовій мережі проявляються рідко, а в основній призводять до втрати коштів. Ми фіксуємо інваріанти в коді та в специфікації, щоб аудитор перевіряв властивості, а не відновлював задум.
Michelson — низькорівнева стекова мова Tezos, де вартість і безпека контракту закладаються на етапі розкладки стану, а не оптимізуються після.
Етапи розробки та впровадження контракту на Michelson
Розробка контракту на Michelson починається не з коду, а з формалізації правил: хто викликає точки входу, які стани допустимі, що відбувається при конфлікті умов.
На цьому етапі фіксуємо схему зберігання — розкладку за big_map і звичайними полями стораджу, бо від неї залежить вартість операцій і простота майбутніх змін. Помилка в моделі даних коштує найдорожче: її виправлення після запуску потребує міграції та повторного аудиту.
Далі йдуть проєктування, реалізація та перевірка — кожен крок із відтворюваним результатом, який можна передати іншій команді.
- Аудит задачі та меж контракту. Розбираємо бізнес-логіку, ролі учасників, зовнішні виклики та ліміти. На виході — специфікація точок входу та інваріантів, які контракт зобов'язаний зберігати за будь-якого сценарію.
- Проєктування схеми зберігання та потоків викликів. Визначаємо структуру стораджу, типи даних Michelson, розміщення колекцій у big_map. Перевіряємо, що операції не впираються в ліміти газу при зростанні кількості записів.
- Реалізація на Michelson. Пишемо контракт і допоміжні view-точки, тримаємо логіку плоскою та явною — складні розгалуження ускладнюють аудит і підвищують ціну помилки. Компіляцію ведемо в актуальній гілці інструментів.
- Тестування. Проганяємо юніт-сценарії на успішні та провальні виклики, перевіряємо граничні стани та права доступу. Окремо моделюємо поведінку при паралельних викликах і повторних операціях.
- Аудит контракту. Незалежна перевірка логіки, прав і обробки винятків до публікації. Усі зауваження закриваємо з фіксацією змін, щоб правки не ламали вже перевірені інваріанти.
- Розгортання в тестовій мережі. Проганяємо повний сценарій життєвого циклу на копії реальних даних, заміряємо витрати газу та поведінку при відмовах.
- Передача контракту замовнику. Віддаємо вихідні коди, схему стораджу, звіт аудиту та інструкцію з викликів. Команда замовника може супроводжувати контракт без нас.
Опишіть задачу — повернемося з оцінкою та планом за кожним етапом.
Чим відрізняється Michelson від високорівневих мов для Tezos?
Michelson — це низькорівнева стекова мова, у яку зрештою компілюється будь-який контракт для Tezos. Високорівневі мови (LIGO, SmartPy, Archetype) дають синтаксис, типи та абстракції, але в ланцюжок потрапляє той самий байткод.
Звідси практичний висновок: michelson vs liquidity — це не про «потужніше чи слабше», а про те, на якому шарі команда хоче контролювати результат.
Компіляція в Michelson не є безкоштовною з точки зору передбачуваності. Компілятор може розгорнути цикл, додати перевірки типів або інакше розкласти зберігання — і ви отримаєте контракт, який працює, але витрачає газ не так, як ви розраховували.
Пряма розробка на Michelson прибирає цей шар: ви бачите кожну інструкцію, кожне звернення до стеку і точно знаєте розмір сховища та вартість виклику. Це критично для контрактів із жорстким лімітом газу або для аудиту, де важливо довести відсутність прихованих шляхів виконання.
Зворотний бік — ціна підтримки. На Michelson немає звичних функцій вищого порядку, словників і рядків у тому вигляді, до якого звикли розробники.
Логіка на кшталт «розподілити частки між учасниками» перетворюється на десятки рядків ручного керування стеком, де легко переплутати порядок операндів. Помилка тут коштує дорожче: типи не зловлять смислову плутанину, а відкотити вже задеплоєний контракт неможливо.
Тому порівняння мов смарт-контрактів для Tezos на практиці зводиться до вибору точки входу. Високорівневу мову беруть для бізнес-логіки, де важливі швидкість розробки та читабельність: токени, голосування, реєстри.
Michelson — коли потрібен ручний контроль над газом, нестандартна криптографія або коли контракт пишеться як еталон для аудиту та подальших реалізацій.
Вибір мови Tezos рідко буває «або-або». Робоча схема: основну логіку пишуть високорівневою мовою, а критичні ділянки — перевірку підписів, роботу з бінарними даними, оптимізацію зберігання — виносять в окремі контракти на Michelson і викликають їх з основного. Так команда отримує і швидкість розробки, і передбачуваність там, де вона важлива.
Кейс: як ми усунули клас відмов у контракті на Michelson
Замовник прийшов із контрактом на Michelson, який працював «переважно нормально»: аудит пройдено, тести зелені, але в проді частина викликів падала з помилкою виконання, а комісія за успішні операції гуляла в широкому діапазоні.
Розбір показав класику — обчислення в storage без урахування порядку операцій і розгалуження, де FAILWITH спрацьовував уже після списання газу. Поведінка контракту залежала від стану, який ніхто не перевіряв до входу в критичну гілку.
Що змінили
Переписали точку входу: перевірки передумов (amount, права, межі значень) винесли на початок, до будь-яких змін storage. Логіку розбили на дрібні внутрішні функції, щоб кожна гілка читалася й тестувалася окремо. Прибрали дублювальні обчислення — проміжні значення рахуються один раз і перевикористовуються.
Метрики до і після
| Показник | До | Після |
|---|---|---|
| Частка невдалих транзакцій | помітна | поодинокі випадки на граничних даних |
| Розкид витрат газу | широкий | вузький, передбачуваний |
| Час розбору інциденту | години | хвилини за логами |
Відмови класу «впало після списання» зникли повністю — тепер будь-яка помилка повертається до зміни стану, і сторона, що викликає, бачить причину, а не факт списання.
Що це дало
Контракт став передбачуваним: однаковий вхід дає однакову витрату газу, а поведінка на граничних значеннях описана в тестах, а не з'ясовується в проді. Ми спиралися на формальну модель виконання Michelson — вона дозволяє перевіряти інваріанти до деплою, а не після. Для замовника це означало менше ручних розборів і зрозумілий бюджет комісій на кожну операцію.
Оптимізація контракту на Tezos без втрати читабельності — це баланс між строгістю перевірок і вартістю виконання. Ми тримаємо його за рахунок тестів на кожну гілку та явних передумов.
Сумніви перед стартом: сумісність, міграція, доступи
Сумісність Michelson з уже працюючою інфраструктурою — перше питання, яке знімаємо до старту. Контракт на Michelson компілюється в той самий формат, що й наявні контракти в мережі Tezos, тому виклики із зовнішніх сервісів, індексаторів і гаманців залишаються робочими.
Якщо у вас уже є контракти на LIGO або SmartPy, міграція не потребує переписування з нуля: логіку переносимо в Michelson, інтерфейси точок входу зберігаємо сумісними, а стан переносимо окремим скриптом із перевіркою на тестовій мережі.
Доступи та ролі проєктуємо до деплою, а не після. Адміністративні точки входу (оновлення логіки, пауза, виведення коштів) закриваємо мультипідписом, операційні — окремими ключами з обмеженим набором прав. Це знімає клас відмов, коли один скомпрометований ключ відкриває весь контракт.
Що якщо контракт уже задеплоєно і його не можна змінювати?
Michelson не дозволяє правити код незмінного контракту, але оновлення логіки закладається заздалегідь — через проксі-контракт або точку входу з перевіркою прав.
Якщо такої можливості немає, розбираємо поточний стан, переносимо логіку в новий контракт і готуємо план переходу зі збереженням даних. Відкат на попередню версію залишається можливим, поки старий контракт не виведено з експлуатації.
Що якщо у нас своя команда і ми хочемо підтримувати код самі? Передаємо не лише вихідні коди, а й логіку рішень: чому обрано таку структуру зберігання, де вузькі місця за витратою газу, які перевірки обов'язкові при оновленні. Інженери замовника виходять на супровід без нас.
Що якщо потрібен аудит перед запуском? Готуємо контракт до зовнішньої перевірки: прибираємо невикористовувані точки входу, документуємо інваріанти, додаємо сценарії тестів — це скорочує час аудиту та кількість зауважень.
На руки замовник отримує:
- вихідні коди контрактів на Michelson з коментарями до кожної точки входу;
- схему ролей і матрицю доступів: хто і що може викликати;
- скрипти деплою та міграції стану з перевіркою на тестовій мережі;
- набір тестів, що покривають ключові сценарії та граничні випадки;
- інструкцію з оновлення логіки та порядок дій при відкаті;
- документацію щодо взаємодії контракту із зовнішніми сервісами.
Опишіть задачу — повернемося з оцінкою та планом: що переносимо, які ролі закриваємо, у якому порядку виходимо на деплой.
Терміни розробки контракту на Michelson за етапами
Терміни на Michelson визначає не обсяг коду, а формалізація інваріантів: контракт на Tezos описує стан і переходи, і будь-яка неоднозначність у вимогах виринає на етапі перевірок, а не під час написання коду.
Тому графік будуємо від моделі зберігання та списку умов, а не від «кількості рядків». Нижче — орієнтовні тривалості етапів; вони не прив'язані до календарних дат і уточнюються після розбору задачі.
Розкид за термінами дає саме етап перевірок: чим більше зовнішніх викликів і умов у контракті, тим довше розбір граничних випадків. Якщо модель даних і переходи зафіксовані заздалегідь, реалізація йде передбачувано, а правки після здачі зводяться до мінімуму.
Працюємо на актуальній гілці інструментів Tezos — Michelson та супутні засоби розробки, тому контракт одразу пишеться під поточні вимоги мережі, без переписування під застарілий синтаксис. Опишіть задачу — повернемося з оцінкою та планом за етапами.







