Метаданные

Метаданные - это проверенная карта значения ключа, прикрепленная к объектам книги. Ключи являются значениями Name и значениями являются полезные нагрузки JSON (Json).

Следующие объекты могут содержать метаданные:

• домены
• счета
• активы
• определения активов
• NFTs
• RWAs
• триггеры
• транзакции

Используйте метаданные для небольших описательных или индексирующих полей, которые относятся к состоянию реестра. Большие полезные нагрузки должны храниться за пределами WSV и ссылаться на траекторию URI или SoraFS.

Для руководства по выбору метаданных, активов NFTs, RWAs или хранения вне цепочки см. Metadata and Ledger Storage Choices.

Попробуй на Taira

Метаданные видны через обычные чтения ресурсов. Эта команда перечисляет определения активов Taira, которые в настоящее время имеют метаданные:

curl -fsS 'https://taira.sora.org/v1/assets/definitions?limit=100' \
  | jq '.items[]
    | select((.metadata | length) > 0)
    | {id, name, metadata}'

Используйте один и тот же шаблон для доменов и учетных записей:

curl -fsS 'https://taira.sora.org/v1/domains?limit=20' \
  | jq '.items[] | select((.metadata // {} | length) > 0)'

curl -fsS 'https://taira.sora.org/v1/accounts?limit=20' \
  | jq '.items[] | select((.metadata // {} | length) > 0)'

Оценить пустой выход как действительный результат. Это означает, что текущая страница объектов Taira не содержит метаданные, а это не значит, что конечная точка потерпела неудачу.

Обновление метаданных

Метаданные изменяются посредством Iroha Специальных инструкций:

• Вставляет или заменяет ключ SetKeyValue
• RemoveKeyValue удаляет ключ

Орган, представляющий транзакцию, должен иметь разрешение, требуемое активным валидатором запуска. Для поверхности разрешений по умолчанию см. Токены разрешения.

События

Данные событий выделяются при изменениях метаданных. MetadataChanged<Id>:

Используйте фильтры событий данных для подписки только на события метаданных типа субъекта или объекта ID, которые имеют значение в интеграции.

Вопросы

Метаданные возвращаются в качестве части запрашиваемого объекта. Например, используйте FindAccountById, FindDomainById или FindAssetDefinitionById. Используйте FindNfts или FindNftsByAccountId для NFTs, и FindRwas для лотов RWA. Затем прочитайте поле метаданных объекта. Ответы на запрос NFT показывают карту NFT content как записи метаданные.

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