Розробка токена ERC-1155 (мульти-токен)

Різнотипні активи живуть у різних реєстрах — звідси розбіжності в обліку та ручні звірки. Ми розробляємо ERC-1155 під ключ: один реєстр для взаємозамінних і унікальних активів, з ролями випуску та регламентами. Це скорочує обсяг звірок і прискорює виведення нових типів активів.
Часті запитання

Розробка ERC-1155: де ламається облік активів

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

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

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

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

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

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

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

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

Єдиний реєстр активів — це один контракт, де тип активу задається ідентифікатором, а баланс власника — записом у спільній таблиці. Окремий контракт під кожну серію, клас або предмет більше не розгортається: нова позиція з’являється всередині вже працюючої системи. Так влаштований стандарт ERC-1155 — і на ньому виграш починається не з коду, а з архітектури.

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

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

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

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

Формати реалізації: розробка ERC-1155 або окремі контракти

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

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

Як вибираємо формат контракту

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

Варіант Коли підходить Обмеження
Єдиний мульти-токен ERC-1155 Багато типів активів, пакетні операції, частина позицій взаємозамінна, частина унікальна Спільна поверхня відмови: правка логіки зачіпає весь набір типів
Набір окремих контрактів Типів мало, у кожного свій життєвий цикл, аудити проводяться незалежно Немає атомарної передачі набору, дублювання коду, кілька адрес в інтеграції
Гібридна схема: ядро і модулі Спільні права та облік виносяться в ядро, специфіка типів — у розширення Складніша схема зберігання, потрібен контроль сумісності модулів під час оновлення ядра
Зовнішній реєстр активів із випуском за підтвердженням Випуск прив’язаний до події поза мережею, потрібен аудит джерела даних Затримка між подією і випуском, залежність від підписувача, відкат події складніший

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

Етапи впровадження: від аудиту активів до передачі

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

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

  2. Схема контрактів. Визначаємо, потрібен один контракт на всі види активів чи кілька пов’язаних, де лежать описи та зображення — у реєстрі чи в зовнішньому сховищі — і що станеться при недоступності цього ресурсу.

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

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

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

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

Артефакти постачання: контракти, ролі, регламенти

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

Тому кожен проєкт закриваємо пакетом артефактів, за яким передача відбувається без «спитати в розробника».

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

Кейс: три типи активів в одному реєстрі

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

Ідентифікатори між лінійками не перетиналися, тому комплект «предмет плюс перепустка» одному покупцеві збирали вручну.

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

Частка операцій, де потрібна була ручна звірка двох джерел, становила 100%: ланцюжок і таблиця розходилися вже на другий-третій день, а перевірити зв’язку «перепустка і предмет в одного власника» інакше було неможливо.

Ми звели три лінійки в один реєстр на ERC-1155: тип активу кодується самим ідентифікатором, кількість лежить у тому самому балансі, а метадані збираються за шаблонною адресою для кожної лінійки.

Ролі розділили — випуск, призупинення, оновлення метаданих, — і завели ліміт на розмір партії, щоб один виклик не впирався в ліміт газу мережі Polygon.

Після переїзду партія тих самих 500 позицій випускається одним викликом із масивом ідентифікаторів і кількостей — близько двох хвилин, і це одна транзакція замість п’ятисот.

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

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

Що робити, якщо частина активів уже на окремих контрактах?

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

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

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

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

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

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

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

Обмеження стандарту і типові технічні сумніви

Єдиний контракт ERC-1155 тримає кілька типів активів із різними правилами: квитки, частки, внутрішні бали, права доступу.

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

Чи можна додати новий тип активу після запуску?

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

Якщо типи однотипні й змінюються рідко, дешевше зафіксувати їх на старті — менше поверхні для помилок.

Як розмежувати права підрозділів?

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

Як обмежити перекази за статусом активу?

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

Як переконатися, що логіка правильна до запуску?

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

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

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

  • Які типи активів потрібні та скільки їх: взаємозамінні, унікальні, випущені обмеженим тиражем — від цього залежить розбиття на ідентифікатори й логіка емісії.
  • Економіка токена: хто і на яких умовах випускає та погашає активи, чи є ліміти, відрахування правовласнику, заморожування окремих утримувачів.
  • Ролі та права: хто виступає адміністратором, які дії потребують підтвердження кількох сторін, чи потрібен журнал змін.
  • Де токен буде обертатися: власний реєстр, публічна мережа чи закритий контур — це визначає вимоги до доступів і порядок підтвердження операцій.
  • Вимоги до метаданих: де зберігаються описи та зображення, чи допускається оновлення після випуску, чи потрібна прив’язка до зовнішніх довідників.
  • Точки інтеграції: особистий кабінет, інтернет-магазин, облікова система, обмін із зовнішніми майданчиками — що вже працює і з чим потрібно стикуватися.
  • Обмеження: бажане вікно запуску, вимоги внутрішньої безпеки та регуляторів, чи потрібна незалежна перевірка коду перед введенням у роботу.
  • Хто на вашому боці ухвалює рішення щодо логіки випуску і погоджує зміни.

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

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

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

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