Разработка 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 держит несколько типов активов с разными правилами: билеты, доли, внутренние баллы, права доступа. Это упрощает развёртывание, но часть логики переезжает в идентификаторы и проверки — поэтому на приёмке всплывают вопросы, которые дешевле закрыть до запуска, чем после первого крупного перевода.
Можно ли добавить новый тип актива после запуска?
Да, если контракт спроектирован под расширение: тип задаётся идентификатором и набором правил, а выпуск вынесен в отдельную роль. Добавление нового типа — это операция выпуска, а не перевыпуск контракта. Если типы однотипны и меняются редко, дешевле зафиксировать их на старте — меньше поверхности для ошибок.
Как разграничить права подразделений?
Права делим по уровням: выпуск, заморозка, перевод, изменение правил. Выпуск отдаём бизнес-подразделению, заморозку — службе контроля, изменение логики — только администратору. Каждое действие пишется событием, поэтому видно, кто и когда изменил состояние актива.
Как ограничить переводы по статусу актива?
Пока актив в статусе «на проверке» или «заблокирован», перевод отклоняется на уровне контракта, а не интерфейса. Правило задаётся набором условий — статус, получатель, лимит по типу, и обойти его прямым обращением к контракту нельзя.
Как убедиться, что логика верна до запуска?
Прогоняем сценарии: выпуск всех типов, пакетные переводы, попытка перевода заблокированного актива, смена прав, повторный выпуск. Отдельно смотрим поведение при сбое — откат не должен оставлять актив в промежуточном статусе.
Обсудим задачу и вернёмся с оценкой и планом
Чтобы вернуться не с общими словами, а со схемой решения, составом работ и сроками, нам хватает короткого описания задачи. Ниже — что стоит указать в заявке: по этим вводным мы разложим проект на этапы и покажем, что и в какой последовательности делаем.
- Какие типы активов нужны и сколько их: взаимозаменяемые, уникальные, выпускаемые ограниченным тиражом — от этого зависит разбиение на идентификаторы и логика эмиссии.
- Экономика токена: кто и на каких условиях выпускает и погашает активы, есть ли лимиты, отчисления правообладателю, заморозка отдельных держателей.
- Роли и права: кто выступает администратором, какие действия требуют подтверждения нескольких сторон, нужен ли журнал изменений.
- Где токен будет обращаться: собственный реестр, публичная сеть или закрытый контур — это определяет требования к доступам и порядку подтверждения операций.
- Требования к метаданным: где хранятся описания и изображения, допускается ли обновление после выпуска, нужна ли привязка к внешним справочникам.
- Точки интеграции: личный кабинет, интернет-магазин, учётная система, обмен с внешними площадками — что уже работает и с чем нужно состыковаться.
- Ограничения: желаемое окно запуска, требования внутренней безопасности и регуляторов, необходима ли независимая проверка кода перед вводом в работу.
- Кто на вашей стороне принимает решения по логике выпуска и согласует изменения.
Опишите задачу в свободной форме — вернёмся со схемой решения, составом работ, планом внедрения и сроками.







