Token URI

Что такое Token URI?

Token URI — это ссылка или идентификатор, указывающий на метаданные криптотокена.

В большинстве обсуждений криптовалют Token URI используется для NFT, поскольку NFT часто требуют метаданных, таких как название, описание, изображение, анимация, атрибуты, характеристики и внешние файлы.

Официальный стандарт URI RFC 3986 определяет URI как компактную последовательность символов, идентифицирующую абстрактный или физический ресурс.

В контрактах NFT Token URI обычно идентифицирует ресурс метаданных, связанный с конкретным идентификатором токена.

Официальный стандарт ERC-721 определяет необязательную функцию метаданных

, которая может возвращать отдельный URI для конкретного невзаимозаменяемого токена.

Token URI может указывать на метаданные, хранящиеся в IPFS, Arweave, на обычном веб-сервере или непосредственно внутри смарт-контракта через data URI.

Token URI обычно не хранит саму работу в блокчейне.

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

Поэтому Token URI — одна из важнейших технических деталей, лежащих в основе отображения NFT.

В криптоглоссарии Token URI следует понимать как указатель на метаданные, который связывает идентификатор токена в блокчейне с офчейн или ончейн информацией, видимой пользователям.

Почему Token URI важен для криптоиндустрии

Token URI важны, поскольку блокчейны оптимизированы для владения, переводов и верификации, а не для дешевого хранения крупных медиафайлов.

NFT может представлять цифровое искусство, музыку, игровое снаряжение, пропуск членства, идентичность, аналогичную домену, билет, учетные данные или запись о реальном активе.

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

Эту связь обеспечивает Token URI.

Без работающего Token URI NFT может отображаться как пустой объект, поврежденное изображение или только адрес контракта и идентификатор токена.

Для коллекционеров качество Token URI может влиять на доверие, стоимость перепродажи и долгосрочную уверенность.

Для разработчиков дизайн Token URI влияет на совместимость с кошельками, отображение на маркетплейсах, обновления метаданных, механику раскрытия и пользовательский опыт.

Для трейдеров структура Token URI может показать, являются ли метаданные постоянными, изменяемыми, централизованными или контролируемыми администратором.

Для игровых проектов и проектов реальных активов дизайн Token URI может определять, остаются ли точными динамические данные предметов или ссылки на документы.

Таким образом, Token URI — не просто техническая ссылка, поскольку он формирует понимание токена пользователями.

Как работает Token URI

Token URI обычно работает через функцию смарт-контракта, принимающую идентификатор токена и возвращающую строку URI.

Для NFT ERC-721 кошелек или dApp может вызвать

, чтобы узнать у контракта расположение метаданных.

Контракт возвращает строку, например

, или .

Затем кошелек или dApp получает либо декодирует метаданные.

Метаданные обычно представлены в JSON и содержат такие поля, как

, , и .

Если метаданные содержат поле изображения, кошелек получает это изображение и показывает его пользователю.

Если метаданные содержат характеристики, маркетплейс или приложение может показать сведения о редкости, игровую статистику или фильтры категорий.

Этот процесс может проходить через прямой вызов контракта, индексатор, API, кэш или сервис метаданных кошелька.

Пользователь обычно видит только итоговое изображение и детали, а не весь процесс разрешения.

Однако понимание Token URI помогает пользователям оценить надежность метаданных NFT.

Token URI в ERC-721

ERC-721 — основной стандарт токенов для уникальных NFT в сетях типа Ethereum.

Расширение метаданных ERC-721 включает

, и .

Функция

необязательна в стандарте, но широко используется, поскольку пользователи ожидают отображения метаданных NFT.

Базовый проект ERC-721 может хранить базовый URI и объединять его с идентификатором токена.

Например, контракт может объединить

с , чтобы сформировать .

Официальная документация OpenZeppelin ERC-721 объясняет, что базовый URI может использоваться для вычисления

, а результирующий URI может состоять из базового URI и идентификатора токена.

Другие проекты могут хранить отдельный URI для каждого идентификатора токена.

Некоторые проекты могут генерировать все метаданные непосредственно в блокчейне.

Некоторые проекты могут указывать на сервер, формирующий динамические метаданные по запросу.

Поскольку проекты ERC-721 могут реализовывать метаданные разными способами, пользователям следует проверять, как конкретная коллекция обрабатывает свой Token URI.

Token URI в ERC-1155

ERC-1155 — мульти-токеновый стандарт, способный обрабатывать взаимозаменяемые, полувзаимозаменяемые токены и NFT в одном контракте.

Официальный стандарт ERC-1155 определяет схему URI метаданных, в которой строка URI может включать заполнитель

.

Клиенты заменяют

фактическим идентификатором токена в требуемом шестнадцатеричном формате.

Это означает, что один шаблон URI может поддерживать множество идентификаторов токенов.

Например, контракт ERC-1155 может возвращать

.

Кошелек или dApp должны заменить

корректным идентификатором токена до получения метаданных.

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

Он также создает частую причину ошибок отображения, когда клиент неправильно обрабатывает подстановку идентификатора токена.

Официальная документация OpenZeppelin ERC-1155 Metadata URI объясняет, что расширение URI метаданных может указывать каждый токен на JSON-файл, соответствующий схеме метаданных ERC-1155.

Пользователю, который видит поврежденные метаданные ERC-1155, следует учитывать, что проблема может быть связана с контрактом, уровнем хранения, клиентом или процессом подстановки.

Token URI и метаданные

Token URI — это не то же самое, что метаданные.

Token URI — это указатель.

Метаданные — это информация, находящаяся по этому указателю.

Например,

— это Token URI.

JSON-файл, находящийся по этому URI, — это метаданные.

Метаданные могут включать название токена, описание, ссылку на изображение, ссылку на анимацию, атрибуты, цвет фона, внешнюю страницу, сведения о лицензии или другие поля.

Если Token URI меняется, расположение метаданных может измениться.

Если файл метаданных меняется, токен может отображать другой контент, даже если Token URI остается прежним.

Это различие важно, поскольку некоторые проекты заявляют, что метаданные фиксированы, когда фиксирован только формат Token URI.

Пользователям следует проверять и Token URI, и контент, который он возвращает.

Token URI и URI изображения

Token URI также не совпадает с URI изображения.

Token URI обычно указывает на JSON-файл метаданных.

В JSON-файле метаданных затем может быть поле

, указывающее на сам файл работы или медиа.

Например,

может вернуть .

Внутри

поле может указывать на .

Это создает два уровня надежности.

Файл метаданных должен оставаться доступным.

Изображение или медиафайл, указанный внутри метаданных, также должен оставаться доступным.

Токен может корректно загрузить метаданные, но все равно показывать поврежденное изображение при сбое URI изображения.

Качественная комплексная проверка NFT учитывает оба уровня.

Распространенные форматы Token URI

Наиболее распространенные форматы Token URI —

, , и .

Token URI

указывает на контент, адресуемый через IPFS.

Token URI

указывает на обычный веб-сервер или конечную точку API.

Token URI

может указывать на данные, размещенные в Arweave.

Token URI

содержит метаданные непосредственно внутри URI.

Каждый формат имеет разные компромиссы по постоянству, стоимости, удобству, изменяемости и совместимости.

Метаданные HTTP легко создавать и обновлять, но они могут быть централизованными и ненадежными.

Метаданные IPFS могут улучшить целостность контента, однако контент все равно должен быть закреплен и доступен для получения.

Data URI могут поддерживать полностью ончейн метаданные, но быть больше по размеру и сложнее в реализации.

Формат Token URI многое сообщает пользователям о том, как проект относится к долговечности и контролю.

Token URI и IPFS

IPFS — один из наиболее распространенных вариантов хранения метаданных NFT.

Официальная документация IPFS об адресации по содержимому объясняет, что IPFS использует Content Identifiers, или CID, для работы с данными, адресуемыми по содержимому.

Адресация по содержимому означает, что идентификатор привязан к самому контенту, а не только к расположению сервера.

Это помогает пользователям проверить, что метаданные или медиа не были незаметно изменены под тем же идентификатором.

Token URI вида

указывает на контент через CID.

Кошельки и dApp часто преобразуют ссылки

в URL шлюзов, чтобы браузеры могли загрузить контент.

Это преобразование является лишь способом получения данных и не меняет базовый идентификатор содержимого IPFS.

Контент IPFS все еще должен быть доступен на узлах, через сервисы пиннинга, шлюзы или другую инфраструктуру хранения.

Если никто не хранит или не раздает контент, CID может оставаться действительным, а получение метаданных — стать затруднительным.

Поэтому IPFS повышает целостность, но не гарантирует автоматически доступность навсегда.

Token URI и HTTP-ссылки

Многие NFT-проекты используют Token URI

, поскольку они просты и привычны.

Сервер может быстро генерировать метаданные, обновлять файлы, контролировать время раскрытия и поддерживать динамический контент.

Это полезно для игр, пропусков членства, билетов на живые мероприятия и проектов, которым необходимо менять метаданные.

Слабость состоит в том, что обычные веб-ссылки зависят от серверов, доменов, хостинг-аккаунтов и операционной деятельности проекта.

Если сервер отключится, NFT может перестать корректно отображаться.

Если срок действия домена истечет, другой человек впоследствии может получить контроль над конечной точкой метаданных.

Если проект изменит JSON, пользователи могут увидеть другие изображения или характеристики.

Это не означает, что все HTTP Token URI плохи.

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

Для дорогостоящих NFT зависимость от сервера должна быть частью оценки риска.

Token URI и data URI

Data URI может хранить метаданные непосредственно внутри возвращаемой строки.

Многие полностью ончейн NFT используют Token URI

.

Это означает, что контракт возвращает закодированный JSON, а не ссылку на внешний файл.

JSON может включать встроенное изображение SVG или другую ончейн-ссылку на медиа.

Этот подход может снизить зависимость от внешнего хранилища.

Он также может сделать контракт более дорогим и сложным.

Кошельки и dApp должны корректно декодировать data URI для отображения токена.

Data URI может быть эффективным для генеративного искусства, токенов идентичности, значков и простых медиа, создаваемых из кода.

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

Data URI показывают, что Token URI не всегда означает обычную веб-ссылку.

Token URI и базовый URI

Базовый URI — это общий начальный путь, используемый для формирования ссылок на метаданные конкретных токенов.

Например, контракт может хранить

как базовый URI.

Когда кто-то вызывает

, контракт может вернуть .

Такая схема экономит хранилище, поскольку контракту не нужно хранить полный URI для каждого токена.

Логика базового URI распространена в коллекциях ERC-721.

Она также распространена в проектах с раскрытием, где базовый URI может меняться с адреса заполнителя на адрес финальных метаданных.

Риск состоит в том, что администратор может иметь возможность изменить базовый URI после минта.

Если базовый URI может быть изменен, пользователи должны понимать, кто контролирует это разрешение и можно ли его заблокировать или отменить.

Фиксированный базовый URI может поддерживать доверие, тогда как неограниченный базовый URI может создавать риск изменения метаданных.

Поэтому дизайн базового URI — важная часть безопасности метаданных NFT.

Token URI и раскрытие NFT

Механика раскрытия NFT часто зависит от изменений Token URI.

До раскрытия каждый токен может указывать на одинаковые метаданные-заполнители.

После раскрытия контракт может обновить базовый URI, чтобы каждый токен указывал на свой финальный файл метаданных.

Это создает распространенный пользовательский сценарий, при котором покупатели видят загадочное изображение до появления финальной работы.

Системы раскрытия могут быть легитимными, если они прозрачны и справедливы.

Они также могут вызывать вопросы доверия, если команда проекта может манипулировать метаданными после того, как увидит результаты минта.

Пользователям следует выяснить, были ли метаданные подготовлены до минта и можно ли проверить процесс раскрытия.

Разработчикам следует использовать понятные события и публичную документацию при обновлении метаданных.

Раскрытие не должно быть скрытой возможностью для инсайдеров несправедливо назначать редкие характеристики.

Поведение Token URI играет центральную роль в том, насколько заслуживающим доверия выглядит раскрытие NFT.

Token URI и обновления метаданных

Некоторые NFT предназначены для изменения со временем.

Игровой предмет может повысить уровень.

Пропуск членства может быть продлен или истечь.

Токен реального актива может обновить ссылки на документы.

Токен динамического искусства может меняться на основе ончейн или офчейн данных.

Официальное расширение обновления метаданных ERC-4906 определяет события обновления метаданных, помогающие сторонним платформам узнать, когда метаданные токена изменились.

Это важно, поскольку кошельки и маркетплейсы часто кэшируют метаданные для скорости.

Если метаданные меняются без четкого сигнала обновления, пользователи могут продолжать видеть устаревшую информацию.

Обновления метаданных полезны, когда они ожидаемы и документированы.

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

Token URI и метаданные уровня контракта

Token URI обычно описывает конкретный идентификатор токена.

Метаданные уровня контракта описывают всю коллекцию или контракт.

Официальный стандарт метаданных уровня контракта ERC-7572 стандартизирует

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

Это различие важно, поскольку коллекции нужны метаданные как уровня токена, так и уровня коллекции.

Token URI отвечает на вопрос, что представляет один токен.

URI контракта отвечает на вопрос, что представляет вся коллекция или контракт.

Кошелек может использовать Token URI для показа конкретного изображения NFT.

Маркетплейс может использовать метаданные уровня контракта для показа логотипа, баннера и описания коллекции.

Оба уровня метаданных должны быть точными, долговечными и прозрачными.

Полный дизайн метаданных NFT не должен сосредотачиваться только на файле отдельного токена.

Token URI и ERC-1046

Token URI не ограничивается NFT во всех обсуждениях стандартов.

Официальное предложение по совместимости ERC-1046 tokenURI добавляет функцию

в ERC-20 и расширяет совместимость метаданных для токенов ERC-20, ERC-721 и ERC-1155.

Это важно, поскольку взаимозаменяемые токены также могут выигрывать от более полных метаданных.

Взаимозаменяемому токену могут потребоваться логотип, описание, сайт проекта, сведения об эмитенте, документация актива или информация о комплаенсе.

На практике поддержка ERC-1046 может различаться между кошельками и приложениями.

Тем не менее предложение показывает, что метаданные токенов — более широкая тема проектирования, чем только работы NFT.

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

Пользователям по-прежнему следует проверять контракты токенов и официальные источники, а не доверять только полям метаданных.

Метаданные могут помогать отображать информацию, но сами по себе не доказывают легитимность.

Token URI полезен только тогда, когда возвращаемая им информация точна и заслуживает доверия.

Token URI и кэширование

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

Кошельки, обозреватели, маркетплейсы и индексаторы часто кэшируют результаты Token URI и файлы метаданных.

Это повышает производительность, поскольку повторное получение тысяч файлов метаданных было бы медленным.

Недостаток состоит в том, что кэшированные метаданные могут устареть.

Токен может раскрыть новую работу, но кошелек все еще будет показывать старое изображение-заполнитель.

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

События обновления метаданных и кнопки обновления могут помочь решить эту проблему.

Пользователям следует помнить, что проблема отображения может быть связана с кэшированием, а не с самим NFT-контрактом.

Разработчикам следует использовать предсказуемые структуры метаданных и стандартные события обновления для упрощения кэширования.

Качественный дизайн Token URI снижает ненужную путаницу с метаданными.

Token URI и изменяемость

Изменяемость означает, что Token URI или метаданные, на которые он указывает, могут меняться.

Некоторая изменяемость полезна для динамических NFT, игр, билетов, учетных данных и развивающихся программ членства.

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

Token URI может быть неизменяемым, тогда как сервер метаданных остается изменяемым.

Token URI также может быть изменяемым, если владелец смарт-контракта способен менять базовый URI.

Проект может зафиксировать метаданные, заблокировав базовый URI, закрепив финальный контент IPFS или удалив права администратора на обновление.

Пользователям следует выяснить, являются ли метаданные зафиксированными, динамическими, контролируемыми администратором или полностью ончейн.

Разработчикам следует ясно объяснять изменяемость до минта.

Скрытая изменяемость может подорвать доверие и снизить уверенность рынка.

Ожидаемая изменяемость может создавать полезный и увлекательный опыт использования токенов.

Token URI и риски безопасности

Token URI могут создавать риски безопасности, поскольку кошельки и dApp получают и отображают внешний контент.

Вредоносные метаданные могут включать фишинговые ссылки, поддельные сообщения о вознаграждениях, вводящие в заблуждение изображения или небезопасные внешние URL.

Спам-NFT может появиться в кошельке и через метаданные предложить пользователю посетить фальшивую страницу получения вознаграждения.

Поддельная коллекция может копировать названия и изображения реальной коллекции.

Скомпрометированный сервер может изменить метаданные, чтобы направлять пользователей на вредоносный сайт.

Кошельки и dApp должны рассматривать метаданные как недоверенный ввод.

Пользователям не следует переходить по ссылкам внутри неизвестных метаданных NFT.

Пользователи никогда не должны вводить сид-фразы, приватные ключи или резервные копии кошелька только потому, что изображение или описание NFT предлагает это сделать.

Token URI помогает отображать данные, но также может отображать данные, контролируемые злоумышленником.

Безопасное поведение в криптоиндустрии требует скептически относиться к непрошенным токенам и подозрительным метаданным.

Token URI и постоянство NFT

Постоянство NFT частично зависит от дизайна Token URI.

Токен может оставаться в блокчейне, тогда как его метаданные исчезают.

Если Token URI указывает на неработающий сервер, NFT может перестать отображаться корректно.

Если Token URI указывает на незакрепленный контент IPFS, метаданные может стать трудно получить.

Если Token URI указывает на ончейн-данные, постоянство может быть выше, однако стоимость и гибкость могут быть ограничены.

Коллекционерам следует понимать это до покупки дорогостоящих NFT.

Разработчикам следует проектировать хранение метаданных с учетом ожидаемого срока существования актива.

Проектам следует объяснять, являются ли метаданные постоянными, изменяемыми, децентрализованными, централизованными или зависимыми от сервера компании.

NFT не становится автоматически постоянным только потому, что владение зафиксировано в блокчейне.

Token URI и план хранения определяют, останется ли токен полезным визуально и информационно.

Token URI и токены реальных активов

Токены реальных активов могут использовать Token URI для ссылок на документы, сертификаты, изображения, аудиты, оценки стоимости, юридические условия или записи верификации.

Это может сделать дизайн Token URI более чувствительным, чем метаданные обычных коллекционных предметов.

Token URI реального актива может требовать контроля версий, ограничений доступа, хешей документов, сведений об эмитенте и четкого юридического контекста.

Поврежденный или устаревший Token URI может ввести пользователей в заблуждение относительно представляемого актива.

Один лишь Token URI не доказывает юридическое право собственности на физический актив.

Юридическое соглашение, эмитент, хранитель, юрисдикция, процесс погашения и документация по-прежнему имеют значение.

Пользователям следует читать официальные документы актива, а не полагаться только на метаданные, отображаемые в кошельке.

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

Для реальных активов качество Token URI является частью качества раскрытия информации.

Метаданные должны поддерживать верификацию, а не заменять юридическую комплексную проверку.

Token URI и игровые активы

Игровые активы часто используют Token URI для описания предметов, персонажей, скинов, земельных участков, оружия, значков и достижений.

Игровому NFT могут требоваться динамические метаданные, поскольку характеристики предмета могут меняться в ходе игры.

Меч может повысить уровень.

Персонаж может получить новые характеристики.

Земельный участок может отображать улучшенные здания.

Token URI может возвращать метаданные, отражающие эти изменения.

Это делает активы блокчейн-игр более интерактивными.

Это также означает, что игровой сервер или движок метаданных может стать важным для полезности актива.

Если игра прекратит работу, некоторые динамические метаданные могут перестать обновляться.

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

Как проверить Token URI

Пользователи могут проверить Token URI, открыв контракт токена в обозревателе блокчейна и просмотрев функцию

, если она доступна.

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

Для токенов ERC-1155 пользователям следует помнить, что URI может включать заполнитель

.

После нахождения URI пользователи могут проверить, использует ли он IPFS, HTTP, Arweave или data URI.

Если URI указывает на JSON, пользователи могут открыть или получить JSON через безопасное средство просмотра.

Им следует проверить, указывают ли поля изображения и атрибутов на надежные расположения.

Им следует сопоставить адрес контракта с официальным адресом проекта.

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

Проверка Token URI полезна для комплексной проверки, однако пользователям следует избегать небезопасных сайтов и недоверенных инструментов.

При сомнениях используйте инструменты только для чтения и никогда не подписывайте транзакции лишь для просмотра метаданных.

Распространенные проблемы Token URI

Первая распространенная проблема — отсутствующий или пустой Token URI.

Вторая распространенная проблема — некорректные JSON-метаданные.

Третья распространенная проблема — неработающая ссылка на изображение внутри метаданных.

Четвертая распространенная проблема — CID IPFS, недоступный через любой шлюз.

Пятая распространенная проблема — отключение централизованного сервера.

Шестая распространенная проблема — устаревшие кэшированные метаданные после раскрытия.

Седьмая распространенная проблема — некорректная обработка заполнителя ERC-1155

.

Восьмая распространенная проблема — изменение метаданных без предупреждения.

Девятая распространенная проблема — Token URI, контролируемый ключом администратора без четких ограничений.

Десятая распространенная проблема — вредоносные метаданные, предназначенные для обмана пользователей и перехода на фишинговые сайты.

Рекомендации для разработчиков

Используйте стандартные функции метаданных при создании токенов ERC-721 или ERC-1155.

Возвращайте валидные строки URI, которые кошельки и приложения смогут надежно разрешать.

Используйте понятные JSON-метаданные, соответствующие распространенным ожиданиям маркетплейсов и кошельков.

Для долгосрочных активов выбирайте долговечное хранилище.

Используйте хранилище с адресацией по содержимому, когда важна целостность метаданных.

Закрепляйте метаданные и медиа IPFS, а не предполагаете, что контент автоматически останется доступным.

Документируйте, являются ли метаданные изменяемыми, зафиксированными, динамическими или контролируемыми администратором.

Публикуйте стандартные события обновления метаданных при их изменении.

Проверяйте поведение Token URI в нескольких кошельках, обозревателях и dApp до публичного минта.

Не полагайтесь на скрытые механизмы контроля метаданных, которые пользователи не могут понять или проверить.

Рекомендации для пользователей

Проверяйте Token URI перед покупкой дорогостоящих NFT.

Проверяйте, хранятся ли метаданные в IPFS, Arweave, HTTP или ончейн-данных.

Изучайте, может ли проект изменить базовый URI или метаданные после минта.

Соблюдайте осторожность с NFT, зависящими только от централизованного сервера.

Не переходите по подозрительным ссылкам внутри метаданных NFT.

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

Проверяйте, совпадает ли адрес контракта токена с официальными источниками проекта.

Используйте небольшие тестовые транзакции при взаимодействии с незнакомыми NFT-контрактами или инструментами.

Понимайте, что изображение токена в кошельке не является доказательством официальности коллекции.

Считайте проверку Token URI частью комплексной проверки NFT.

FAQ

Что означает Token URI?

Token URI — это URI, указывающий на метаданные криптотокена, особенно NFT.

Что делает tokenURI?

Функция

обычно возвращает URI метаданных для конкретного идентификатора токена ERC-721.

Token URI — это то же самое, что метаданные NFT?

Нет, Token URI — это указатель, а метаданные — информация, находящаяся по этому указателю.

Token URI — это то же самое, что изображение NFT?

Нет, Token URI обычно указывает на JSON-файл метаданных, а этот JSON-файл может содержать отдельный URI изображения.

Что такое Token URI ERC-721?

Token URI ERC-721 — это URI, возвращаемый

для уникального NFT.

Что такое Token URI ERC-1155?

Token URI ERC-1155 — это URI метаданных, который может использовать заполнитель

для разных идентификаторов токенов.

Что означает Token URI IPFS?

Token URI IPFS означает, что метаданные доступны по идентификатору содержимого IPFS.

Может ли Token URI меняться?

Да, Token URI может меняться, если контракт допускает обновления метаданных, изменения базового URI, динамические метаданные или ответы, контролируемые сервером.

Могут ли метаданные NFT меняться без изменения Token URI?

Да, метаданные могут меняться, если Token URI указывает на изменяемый сервер или файл, который может быть заменен по тому же веб-адресу.

Является ли ончейн Token URI безопаснее?

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

Почему не отображаются метаданные моего NFT?

Метаданные могут не отображаться, потому что Token URI отсутствует, JSON некорректен, хранилище недоступно, ссылка на изображение не работает или кэш приложения устарел.

Что такое базовый URI?

Базовый URI — это общий префикс, который контракт токена может объединять с идентификаторами токенов для формирования полных Token URI.

Что такое раскрытие в дизайне Token URI?

Раскрытие — это обновление метаданных, при котором Token URI-заполнители заменяются или перенаправляются на финальные метаданные токенов.

Могут ли метаданные Token URI быть вредоносными?

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

Что пользователям следует проверить перед доверием к Token URI?

Пользователям следует проверить тип хранения, разрешения контракта, официальный адрес контракта, доступность метаданных, ссылку на изображение, правила изменяемости и подозрительные внешние ссылки.

Заключение

Token URI — это указатель на метаданные, связывающий блокчейн-токен с информацией, которую пользователи видят в кошельках, обозревателях, маркетплейсах и dApp.

Для NFT ERC-721 он обычно возвращается функцией

.

Для токенов ERC-1155 он может возвращаться через шаблон URI с заполнителем

.

Token URI может указывать на IPFS, Arweave, серверы HTTPS или данные, хранящиеся непосредственно внутри смарт-контракта.

Каждый формат имеет разные компромиссы с точки зрения постоянства, гибкости, стоимости, совместимости и доверия.

Дизайн Token URI влияет на корректность отображения NFT, возможность изменения метаданных, доступность изображений и способность пользователей проверить, чем они владеют.

Разработчикам следует использовать стандартные функции, валидные метаданные, долговечное хранилище, понятные события обновления и прозрачные правила изменяемости.

Пользователям следует проверять структуру Token URI до того, как доверять дорогостоящим NFT, динамическим активам, игровым предметам или токенам реальных активов.

Им также следует избегать подозрительных ссылок в метаданных и помнить, что отображение в кошельке не доказывает подлинность.

Token URI — одна из скрытых технических основ ценности и применимости NFT.

В криптоглоссарии Token URI следует понимать как URI, возвращаемый или используемый контрактом токена для идентификации ресурса метаданных, описывающего конкретный токен.