SDK для метаданных ARC-89 готов в Testnet, реестр в MainNet пока не развёрнут

Разработчик, которому нужно хранить описание актива Algorand в самой сети, а не в файле на хостинге, теперь может воспользоваться пакетом на TypeScript. SDK asa-metadata-registry-ts¹ — это клиент для ARC-89², реестра метаданных ASA: одного приложения, в box-хранилище которого хранится по одной записи на каждый актив, с ключом из восьмибайтового ID актива. Стандарт поддерживает и публикует SDK Фонд Algorand³.

Согласно документации, пакет читает запись одним вызовом к ноде или через симуляцию, которая возвращает то, что видит смарт-контракт. Он создаёт, заменяет и удаляет записи, разбивает большие метаданные на части и переносит активы, описанные по более старым стандартам ARC-3, ARC-19 и ARC-69. Релиз, который довёл пакет до этого состояния, невелик: v1.0.0-beta.10⁴, опубликованный 21 октября, содержит одно исправление ошибки и обновление инструмента сборки, которое закрыло уязвимость высокой серьёзности из аудита. Существенное изменение вышло днём раньше: несовместимый v1.0.0-beta.9⁵, который, судя по его примечаниям к релизу, ориентирован на контракты реестра v1.0.0 под AVM 13.

Как запись хранится в сети

Описательные поля Algorand Standard Asset фиксируются при создании: название, единица измерения, общее предложение, количество знаков после запятой и URL. Всё, что видит покупатель — изображение, описание, атрибуты, — приходилось хранить в другом месте: в файле IPFS за URL или в JSON-заметке в транзакции конфигурации. Реестр переносит в состояние сети меньшую, структурированную часть. Каждая запись содержит фиксированный заголовок из 51⁶ байт с флагами обратимости и необратимости и хешем, который связывает содержимое. Чтение идёт через algod, API ноды, либо напрямую из другого смарт-контракта на AVM.

Последний путь заслуживает отдельного внимания. Контракт, который может прочитать запись актива в той же группе, что и перевод этого актива, может учитывать его атрибуты в момент расчётов, а не полагаться на внешний источник данных. AVM 13⁷, вышедшая вместе с Go-Algorand 5.0.0⁸ в августе, добавила опкоды «foreign» для чтения box-ов другого приложения.

Сколько это стоит

Речь идёт не о комиссии, а о депозите. В кулинарной книге SDK создание записи размером 117 байт выводит платёж минимального баланса 72 900⁹ microALGO, или 0,0729 ALGO. В примере удаления для записи меньшего размера возвращается 37 700¹⁰ microALGO. Спецификация рассчитывает сумму как фиксированный сбор плюс ставку за байт, умноженную на размер изменения, по ключу box-а, заголовку и метаданным. Оба параметра доступны клиентам для чтения. Депозит возвращается при удалении записи.

Пробел на месте MainNet

Три места должны были бы указывать на реестр в MainNet, и все три пусты. В таблице развёртывания из спецификации для MainNet стоит «TBD». В файле развёртывания SDK идентификатор приложения для mainnet равен null, с комментарием «mainnet app id is TBD». Открытый issue¹¹, в котором перечислены шаги после развёртывания, заканчивается строкой «Блокируется развёртыванием реестра в MainNet.¹²»

Автор описывает это как близкое событие. Козимо Басси, публикующий под именем @cusma_b, написал 20 октября, что ARC-89 «приближается к MainNet», а SDK на Python и TypeScript «обновлены до v1.0.0¹³ и близки к релизу». Слитый им pull request к спецификации говорит, что он «закрывает последние пробелы в ARC-89 перед развёртыванием в MainNet¹⁴».

Два реестра в Testnet, один из них актуальный

SDK указывает на приложение 772968354¹⁵ в Testnet. Это приложение существует в Testnet, не удалено, а его box-хранилище содержало 20 записей метаданных при чтении 27 октября. Страница ARC-89 на Портале разработчика Algorand по-прежнему называет приложение 753324084¹⁶¹⁷ и называет поле версии записи «Last Modified Round». Спецификация и SDK используют 772968354 и название «Revision». Оба приложения существуют в Testnet, и ни одно не удалено. Разработчик, который следует порталу, пишет код под более старое из них.

Lora¹⁸, обозреватель, поставляемый с AlgoKit, как сообщил PXke в августе, читал запись реестра по состоянию на 2.4.0¹⁹-beta.

Установка по умолчанию — заглушка

При упаковке пакета есть нюанс, который стоит знать до установки. В npm запись пакета в реестре²⁰ показывает, что теги «latest» и «beta» указывают на 0.0.1-beta.0 — релиз от 27 марта, который описывает себя как «asa-metadata-registry-sdk placeholder for Algorand». Рабочий код находится под тегом «main», версия 1.0.0-beta.10. По данным времени публикации npm, между 27 апреля и 20 октября новых версий не появлялось. Репозиторий при этом развивался: на странице релиза beta.5 указано 115²¹ коммитов в main с момента этого релиза.

Что запись гарантирует, а что нет

Реестр определяет, кто может писать, каким может быть размер записи и можно ли её менять. Право на запись принадлежит адресу менеджера актива, а не его создателю. Менеджер может объявить запись неизменяемой, а спецификация гласит, что сам реестр после развёртывания никогда не должен обновляться. Реестр рассматривает тело метаданных как непрозрачные байты, поэтому потребители должны проверять запись и заявленные в ней флаги, прежде чем им доверять. Ни в спецификации, ни в справочном репозитории, ни в репозитории TypeScript не упоминается аудит безопасности.

Насколько это используется

Использование скромное, но поддаётся измерению. По состоянию на 27 октября npm-пакет зафиксировал 36 загрузок за последнюю неделю и 96 за последний месяц.

В файле внедрения²² самого стандарта пока не указано ни одного кошелька, инструмента, инфраструктуры или dapp, а один обозреватель находится в разработке. В заголовке спецификации по-прежнему стоит статус «Last Call» с крайним сроком 1 февраля 2026 года.²³

Разработчик, который пробует SDK сегодня, фиксирует тег main, указывает приложение 772968354 и работает в Testnet.

Источники

• Release v1.0.0-beta.10 · algorandfoundation/asa-metadata-registry-ts · GitHub⁴
• github.com¹
• ARCs/ARCs/arc-0089.md at main · algorandfoundation/ARCs · GitHub²
• Release v1.0.0-beta.9 · algorandfoundation/asa-metadata-registry-ts · GitHub⁵
• registry.npmjs.org²⁰
• feat(deployments): add the MainNet registry deployment · Issue #133 · algorandfoundation/asa-metadata-registry-ts¹¹²⁴
• raw.githubusercontent.com: /algorandfoundation/ARCs/main/adoption/arc-0089.yaml²²
• ARC-89: AVM 13, global revision tracker, content-only metadata hash, canonical discovery by cusma · Pull Request #481 ·²⁵
• raw.githubusercontent.com: /algorandfoundation/asa-metadata-registry-ts/main/docs/cookbook.md²⁶
• Release v1.0.0 · algorandfoundation/arc89 · GitHub²⁷
• MainNet and TestNet Update: Go-Algorand 5.0.0 - Announcements - Algorand²⁸
• x.com²⁹
• Release v1.0.0-beta.5 · algorandfoundation/asa-metadata-registry-ts · GitHub³⁰
• Issues · algorandfoundation/asa-metadata-registry-ts · GitHub³¹