Розробка ERC-1155: де ламається облік активів
На старті проєкт із кількома типами активів майже завжди збирають з окремих контрактів: під взаємозамінний токен — один, під колекційні предмети — другий, під ліцензії або доступи — третій.
Запуск при цьому проходить гладко, а розходиться потім облік активів: баланси живуть у різних місцях, права на випуск і заморожування продубльовані, і кожен новий тип активу потребує ще одного контракту і ще одного набору інтеграцій.
Розрізнені контракти погано тримають операції, де бере участь більше одного активу. Обмін «предмет плюс внутрішня валюта», видача набору ліцензій однією угодою, міграція колекції — усе це розпадається на ланцюжок викликів, які проходять частково.
Кожен такий ланцюжок дає розсинхрон, і ловлять його вручну: звірка гаманців, донарахування, розбір звернень до підтримки.
Мульти-токен знімає проблему на рівні моделі. В одному контракті лежать усі типи активів, у кожного свій ідентифікатор і свій обсяг випуску, а переведення кількох типів активів виконується однією операцією — цілком або не виконується взагалі.
Права описані один раз і працюють на всю лінійку, тому новий тип активу стає записом у наявному реєстрі, а не новою системою зі своїми перевірками і своєю звітністю.
Саме тому розробка ERC-1155 — це передусім проєктування обліку активів, а не випуск чергового токена. Нижче розбираємо, де саме ламаються такі схеми і як це закривається.
Що дає єдиний реєстр різнотипних активів
Єдиний реєстр активів — це один контракт, де тип активу задається ідентифікатором, а баланс власника — записом у спільній таблиці. Окремий контракт під кожну серію, клас або предмет більше не розгортається: нова позиція з’являється всередині вже працюючої системи. Так влаштований стандарт ERC-1155 — і на ньому виграш починається не з коду, а з архітектури.
Пакетні операції змінюють характер масових сценаріїв. Видача партії з двохсот предметів — не двісті транзакцій, а одна: метод safeBatchTransferFrom приймає масиви ідентифікаторів і одержувачів та обробляє їх за один виклик.
Для ігрових інвентарів, квиткових залів і складських партій це прибирає головне джерело затримки — очікування підтвердження по кожній одиниці окремо.
Логіка прав доступу перестає копіюватися. Ролі випуску, спалювання, заморожування й адміністрування живуть в одному модулі, тому зміна політики — це одна правка, а не синхронізація десятків контрактів, де розбіжність версій відкриває діру в правах.
Супровід контрактів стискається до однієї кодової бази: один аудит, один набір тестів, один сценарій оновлення. Звідси й зменшення кількості відмов — менше точок відмови і менше місць, де логіка встигла розійтися між копіями. Патч закриває уразливість одразу в усіх типах активів, а не по одній позиції за реліз.
Формати реалізації: розробка ERC-1155 або окремі контракти
ERC-1155 — це один контракт на багато типів активів: взаємозамінні та унікальні позиції живуть у спільній таблиці балансів, а пакетна передача набору вкладається в одну операцію.
Це не універсальна відповідь: чим більше логіки навішується на єдиний контракт, тим дорожче його змінювати і тим ширша поверхня відмови.
Як вибираємо формат контракту
Дивимося на чотири речі: кількість типів, частоту їх додавання, чи потрібна атомарна передача набору і звідки надходить підтвердження випуску.
| Варіант | Коли підходить | Обмеження |
|---|---|---|
| Єдиний мульти-токен ERC-1155 | Багато типів активів, пакетні операції, частина позицій взаємозамінна, частина унікальна | Спільна поверхня відмови: правка логіки зачіпає весь набір типів |
| Набір окремих контрактів | Типів мало, у кожного свій життєвий цикл, аудити проводяться незалежно | Немає атомарної передачі набору, дублювання коду, кілька адрес в інтеграції |
| Гібридна схема: ядро і модулі | Спільні права та облік виносяться в ядро, специфіка типів — у розширення | Складніша схема зберігання, потрібен контроль сумісності модулів під час оновлення ядра |
| Зовнішній реєстр активів із випуском за підтвердженням | Випуск прив’язаний до події поза мережею, потрібен аудит джерела даних | Затримка між подією і випуском, залежність від підписувача, відкат події складніший |
На практиці більшість проєктів закриває гібридна схема: ядро тримає права й облік, модулі — поведінку конкретних типів. Зовнішній реєстр активів виправданий там, де випуск не можна підтвердити всередині мережі, і це усвідомлений обмін частини контролю на гнучкість.
Етапи впровадження: від аудиту активів до передачі
Етапи впровадження вибудувані так, щоб рішення щодо архітектури ухвалювалися до першого рядка коду. Помилка в схемі ролей або способі зберігання метаданих спливає вже після розгортання — коли виправлення потребує міграції балансів у зовнішніх утримувачів. Нижче — порядок робіт, який проходять проєкти.
-
Аудит активів і сценаріїв обігу. Розбираємо, що саме випускається: взаємозамінні партії та унікальні екземпляри в одному контракті, хто і на якій підставі їх погашає та блокує. На виході — таблиця типів активів і правил, яких контракт зобов’язаний дотримуватися.
-
Схема контрактів. Визначаємо, потрібен один контракт на всі види активів чи кілька пов’язаних, де лежать описи та зображення — у реєстрі чи в зовнішньому сховищі — і що станеться при недоступності цього ресурсу.
-
Матриця доступів. Розкладаємо права за окремими ролями: випуск, погашення, заморожування, правка описів, призупинення. Ключові операції не лежать на одній адресі — підпис кількох учасників, роль адміністратора обмежена або відкликана.
-
Реалізація і налаштування ролей. Перевірки граничних значень, ліміти випуску, пауза. Пакетні операції передають сотні екземплярів одним викликом замість сотні окремих — витрати утримувача падають на порядок.
-
Перевірка перед запуском. Тестовий контур повторює основну мережу: масовий випуск, дроблення, виклики чужих методів з адреси без ролі, відкликання прав. Фіксуємо покриття шляхів і поведінку при збої зовнішнього сховища.
-
Передача і навчання. Вихідники, схема розгортання, матриця доступів і регламент випуску. Показуємо команді, як видавати й відкликати ролі та що робити при компрометації ключа.
Артефакти постачання: контракти, ролі, регламенти
Постачання не закінчується контрактами, розгорнутими в мережі. Без матриці ролей, описаних політик і регламенту команда замовника не зможе ні випустити новий клас токенів, ні розібрати інцидент із завислим переказом.
Тому кожен проєкт закриваємо пакетом артефактів, за яким передача відбувається без «спитати в розробника».
- Вихідники та розгорнуті контракти — код у репозиторії замовника, верифікований в оглядачі мережі, адреси всіх модулів із прив’язкою до мережі.
- Матриця ролей — хто володіє випуском, спалюванням, паузою та оновленням, які операції йдуть через мультипідпис і затримку, як права передаються й відкликаються.
- Політики доступу — ліміти на партії випуску, обмеження на спалювання за класами токенів, порядок зміни адреси метаданих, правила для зовнішніх операторів.
- Схеми — архітектура контрактів і потоків: випуск, перекази між класами, зв’язок із зовнішнім сховищем метаданих і мостом.
- Документація контракту — методи й події, формат ідентифікаторів токенів і структури метаданих, приклади викликів для інтеграції.
- Тести та звіт про покриття — сценарії на випуск, пакетний переказ, спалювання, паузу й відновлення доступу.
- Регламент супроводу — що моніторимо, як реагуємо на інцидент, у якому порядку оновлюємо контракти і як відкочуємося на попередню версію.
- Чек-ліст приймання — за якими пунктами замовник сам перевіряє постачання, не залучаючи нас.
Кейс: три типи активів в одному реєстрі
Замовник — оператор трьох лінійок цифрових активів: колекційні предмети, перепустки на доступ і внутрішні розрахункові жетони. Кожна лінійка жила в окремому контракті, а залишки та власники дублювалися в зовнішній таблиці.
Ідентифікатори між лінійками не перетиналися, тому комплект «предмет плюс перепустка» одному покупцеві збирали вручну.
Партія з 500 предметів випускалася поштучно — близько 40 хвилин підтверджень підряд і стільки ж рядків у таблиці, які потім звіряли очима.
Частка операцій, де потрібна була ручна звірка двох джерел, становила 100%: ланцюжок і таблиця розходилися вже на другий-третій день, а перевірити зв’язку «перепустка і предмет в одного власника» інакше було неможливо.
Ми звели три лінійки в один реєстр на ERC-1155: тип активу кодується самим ідентифікатором, кількість лежить у тому самому балансі, а метадані збираються за шаблонною адресою для кожної лінійки.
Ролі розділили — випуск, призупинення, оновлення метаданих, — і завели ліміт на розмір партії, щоб один виклик не впирався в ліміт газу мережі Polygon.
Після переїзду партія тих самих 500 позицій випускається одним викликом із масивом ідентифікаторів і кількостей — близько двох хвилин, і це одна транзакція замість п’ятисот.
Частка операцій із ручною звіркою впала з 100% до 6%: вручну залишилися тільки замовлення, що надійшли із зовнішніх каналів. Відкат до попереднього стану реєстру тепер робиться призупиненням ролі, а не розбором трьох контрактів.
Три контракти й дві таблиці перетворилися на один реєстр і один журнал подій — власник, тип і кількість читаються з одного місця.
Що робити, якщо частина активів уже на окремих контрактах?
Звичайний сценарій: взаємозамінні предмети живуть в одному контракті, унікальні — в іншому, частина випусків залишилася на ранньому прототипі.
Єдиний реєстр за стандартом ERC-1155 закриває завдання, але зупиняти обіг на час перенесення не можна — активи мають залишатися видимими в гаманцях власників. Тому міграція активів будується не як заміна, а як паралельний контур із поетапним переходом.
Перенесення балансів іде за знімком стану: фіксуємо власників та обсяги на певній висоті, потім випускаємо еквівалент у новому реєстрі. Ключове тут — атомарність: випуск і блокування старого контракту йдуть однією операцією. Інакше між ними виникає момент, коли актив продубльований і його можна продати двічі.
Поки перенесення йде, старий контракт залишається робочим — обмін і перекази за ним не припиняються.
Зворотна сумісність забезпечується на рівні читання: новий реєстр відповідає за старими ідентифікаторами, тому вітрини й гаманці отримують коректні дані без правок на їхньому боці.
Поетапний перехід іде в чотири кроки: дублювальний облік і звірка сум, перемикання читання на новий реєстр, переведення запису і лише потім блокування старого контракту. Будь-який крок оборотний — до фінального блокування достатньо повернути читання назад.
Переносити потрібно не все. Активи з живим обігом і історією йдуть у єдиний реєстр, а архівні та експериментальні випуски дешевше залишити в старому контракті в режимі лише читання: вони не створюють навантаження і зберігають історію володіння.
Обмеження стандарту і типові технічні сумніви
Єдиний контракт ERC-1155 тримає кілька типів активів із різними правилами: квитки, частки, внутрішні бали, права доступу.
Це спрощує розгортання, але частина логіки переїжджає в ідентифікатори й перевірки — тому на прийманні спливають питання, які дешевше закрити до запуску, ніж після першого великого переказу.
Чи можна додати новий тип активу після запуску?
Так, якщо контракт спроєктований під розширення: тип задається ідентифікатором і набором правил, а випуск винесений в окрему роль. Додавання нового типу — це операція випуску, а не перевипуск контракту.
Якщо типи однотипні й змінюються рідко, дешевше зафіксувати їх на старті — менше поверхні для помилок.
Як розмежувати права підрозділів?
Права ділимо за рівнями: випуск, заморожування, переказ, зміна правил. Випуск віддаємо бізнес-підрозділу, заморожування — службі контролю, зміну логіки — лише адміністратору. Кожна дія пишеться подією, тому видно, хто і коли змінив стан активу.
Як обмежити перекази за статусом активу?
Поки актив у статусі «на перевірці» або «заблокований», переказ відхиляється на рівні контракту, а не інтерфейсу. Правило задається набором умов — статус, одержувач, ліміт за типом, і обійти його прямим зверненням до контракту не можна.
Як переконатися, що логіка правильна до запуску?
Проганяємо сценарії: випуск усіх типів, пакетні перекази, спроба переказу заблокованого активу, зміна прав, повторний випуск. Окремо дивимося поведінку при збої — відкат не повинен залишати актив у проміжному статусі.
Обговоримо завдання і повернемося з оцінкою та планом
Щоб повернутися не із загальними словами, а зі схемою рішення, складом робіт і строками, нам достатньо короткого опису завдання. Нижче — що варто зазначити в заявці: за цими ввідними ми розкладемо проєкт на етапи і покажемо, що і в якій послідовності робимо.
- Які типи активів потрібні та скільки їх: взаємозамінні, унікальні, випущені обмеженим тиражем — від цього залежить розбиття на ідентифікатори й логіка емісії.
- Економіка токена: хто і на яких умовах випускає та погашає активи, чи є ліміти, відрахування правовласнику, заморожування окремих утримувачів.
- Ролі та права: хто виступає адміністратором, які дії потребують підтвердження кількох сторін, чи потрібен журнал змін.
- Де токен буде обертатися: власний реєстр, публічна мережа чи закритий контур — це визначає вимоги до доступів і порядок підтвердження операцій.
- Вимоги до метаданих: де зберігаються описи та зображення, чи допускається оновлення після випуску, чи потрібна прив’язка до зовнішніх довідників.
- Точки інтеграції: особистий кабінет, інтернет-магазин, облікова система, обмін із зовнішніми майданчиками — що вже працює і з чим потрібно стикуватися.
- Обмеження: бажане вікно запуску, вимоги внутрішньої безпеки та регуляторів, чи потрібна незалежна перевірка коду перед введенням у роботу.
- Хто на вашому боці ухвалює рішення щодо логіки випуску і погоджує зміни.
Опишіть завдання у вільній формі — повернемося зі схемою рішення, складом робіт, планом впровадження і строками.







