ГЛАВНАЯ / ИНСТРУКЦИИ / NFT TOKENURI И METADATA: ГДЕ РАЗМЕЩЕНО ОПИСАНИЕ ТОКЕНА
NFT tokenURI и metadata: где размещено описание токена
В ERC-721 tokenURI связывает конкретный tokenId с URI, по которому приложение может получить метаданные. Это может быть HTTP-адрес, IPFS-ссылка или другой поддерживаемый формат. Само поле не подтверждает подлинность NFT, а ссылка не гарантирует, что файл останется доступным.
Проверяйте tokenId вместе с адресом контракта и сетью
Число tokenId само по себе не уникально во всех блокчейнах. Для точной идентификации нужны сеть, адрес контракта и tokenId. Название коллекции или картинка в кошельке не заменяют эти три значения.
В ERC-721 расширение метаданных необязательно. Контракт может не реализовывать tokenURI, а кошелёк или маркетплейс могут дополнять карточку внешним индексатором. Если функция отсутствует или обозреватель не показывает результат, это ещё не доказывает, что отображаемые данные ложны – проверьте реализацию контракта и используемый клиент.
- сеть совпадает с сетью коллекции;
- адрес контракта взят из проверенного источника;
- tokenId относится к этому контракту.
URI может указывать на JSON, а JSON – на отдельные медиафайлы
Стандарт ERC-721 определяет tokenURI как URI для конкретного NFT. Часто он ведёт к JSON с полями name, description, image и атрибутами. Поля и точная схема зависят от применяемого стандарта и проекта.
В самом JSON поле image или animation_url может содержать другой URI. Поэтому изображение и описание могут храниться отдельно, а смена одного звена влияет на то, что покажет клиент. Проверьте всю цепочку адресов и расширения файлов, не переходя по подозрительным ссылкам из неизвестного NFT.
| Уровень | Что получить | Что проверить |
|---|---|---|
| Контракт | tokenURI(tokenId) | Адрес контракта и tokenId |
| Метаданные | JSON-документ | Имя, описание, атрибуты и URI медиа |
| Медиа | image или animation_url | Конечный файл и его доступность |
HTTP, IPFS и onchain URI имеют разные свойства
HTTP URI обращается к серверу по доменному имени. Владелец сайта или оператор сервера может менять ответ, а доступность зависит от домена и инфраструктуры. IPFS URI использует content identifier для обращения к содержимому; HTTP gateway только помогает получить его обычному браузеру.
Onchain metadata может быть встроена в данные контракта или возвращаться из его состояния. Это способ хранения, но не автоматическая гарантия правильности описания, полноты прав на произведение или независимой проверки коллекции. Сверяйте, что именно закодировано и кто вправе менять связанное состояние.
- не смешивайте постоянство CID с доступностью провайдера;
- не считайте наличие onchain поля подтверждением авторства;
- проверьте, не ведут ли поля JSON к изменяемому HTTP-ресурсу.
URI и содержимое могут иметь разные правила обновления
EIP-721 прямо допускает, что URI может меняться. Контракт может строить tokenURI из базового URI и tokenId, хранить значения отдельно или применять иной механизм. Внешний JSON также может меняться, если он размещён по изменяемому адресу.
EIP-4906 добавляет события, которыми совместимый контракт сообщает об изменении метаданных. Это помогает индексаторам обновить карточку, но само событие не замораживает URI. Для оценки прав ищите функции обновления, административные роли и документацию контракта, а затем сопоставляйте её с доступным состоянием и историей транзакций.
Пройдите путь от контракта до изображения без доверия к карточке
Откройте контракт в обозревателе нужной сети, найдите tokenURI для точного tokenId и получите документ по этому URI. При IPFS преобразуйте ipfs:// в адрес поддерживаемого gateway, сохраняя CID и остаток пути. Если браузер показывает ошибку, проверьте CID другим способом: сбой одного gateway не доказывает, что содержимое отсутствует.
Сравните результат с официальными каналами коллекции, изучите поля JSON и не подписывайте транзакции ради «разблокировки» или «обновления» изображения. Доступность файла, его целостность и подлинность проекта – отдельные вопросы.
- контракт и tokenId проверены;
- tokenURI записан полностью;
- JSON и вложенные файлы загружаются;
- изменяемые ссылки отделены от content-addressed;
- подлинность коллекции проверена независимо.
Частые вопросы
tokenURI всегда содержит ссылку на JSON?
Стандарт описывает URI, который может указывать на JSON; конкретная реализация и формат URI различаются.
Если tokenURI начинается с ipfs://, файл навсегда доступен?
Нет. CID адресует содержимое, но наличие хотя бы одного узла, который его предоставляет, отдельно влияет на доступность.
Можно ли проверить NFT только по картинке?
Нет. Идентифицируйте актив по сети, контракту и tokenId, затем проверяйте источник коллекции.
Событие MetadataUpdate означает, что метаданные заморожены?
Нет. EIP-4906 помогает сообщать об изменениях, а не запрещает их.
Чек-лист: nft tokenuri и metadata: где размещено описание токена
- сеть, адрес контракта и tokenId сверены;
- tokenURI получен из нужного контракта;
- JSON и вложенные URI просмотрены;
- тип хранилища указан корректно;
- доступность отделена от целостности;
- изменяемость проверена по контракту и истории;
- подлинность сверена с независимым официальным каналом;
- неожиданные подписи не подтверждались.
Материал подготовлен редакцией сайта и проверен 22 октября 2026 года. Условия бирж, кошельков и блокчейн-сетей могут меняться. Перед операцией сверяйте данные в интерфейсе выбранного сервиса.