Base URI

Что такое Base URI в криптовалютах?

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

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

Официальный стандарт ERC-721 определяет tokenURI как функцию, возвращающую уникальный унифицированный идентификатор ресурса (URI) для конкретного актива.

Чтобы получить полный tokenURI, Base URI часто объединяют с ID токена.

Например, Base URI может выглядеть так: ipfs://exampleCID/, а токен с ID 25 будет связан с адресом ipfs://exampleCID/25.

В другой схеме полный путь к метаданным может включать расширение файла, например ipfs://exampleCID/25.json.

Точный результат зависит от того, как смарт-контракт формирует tokenURI.

В документации OpenZeppelin по ERC-721 объясняется, что функция _baseURI используется для вычисления ERC721.tokenURI, который может быть результатом объединения baseURI и tokenId.

Base URI помогает экономить газ, упорядочивать метаданные и упрощать управление крупными NFT-коллекциями.

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

Почему Base URI важен

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

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

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

Base URI связывает ончейн-токен с офчейн-метаданными или их децентрализованным хранилищем.

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

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

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

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

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

Метаданные NFT-членства могут показывать его уровень и права доступа.

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

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

Обычно в контракте токена хранится общий префикс Base URI или функция возвращает его.

Затем контракт добавляет значение, относящееся к конкретному токену, чаще всего его ID, и формирует полный URI метаданных.

Например, если Base URI — ipfs://bafyExampleCollection/, а ID токена — 100, итоговый tokenURI может иметь вид ipfs://bafyExampleCollection/100.

Если контракт добавляет расширение JSON, итоговый tokenURI может выглядеть так: ipfs://bafyExampleCollection/100.json.

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

Другие контракты задают Base URI непосредственно в коде и навсегда фиксируют его при развертывании.

Некоторые контракты возвращают разные Base URI в зависимости от этапа раскрытия метаданных, типа токена, ID сети или пользовательской логики.

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

Base URI не является обязательным элементом каждого NFT-контракта.

Это распространенный способ эффективно формировать пути к метаданным токенов.

Base URI и tokenURI

tokenURI — это полный URI, возвращаемый для конкретного токена.

Base URI — это повторно используемый префикс, помогающий формировать множество tokenURI.

В контрактах ERC-721 tokenURI входит в необязательное расширение метаданных.

Согласно стандарту ERC-721, tokenURI может указывать на JSON-файл, соответствующий схеме метаданных ERC-721.

Обычно такой JSON-файл содержит поля name, description и image.

Base URI — не сами метаданные JSON.

Это путь, по которому кошелек или приложение находит соответствующий JSON-файл.

Простой контракт может формировать tokenURI, объединяя Base URI и ID токена.

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

Динамический NFT-контракт может формировать tokenURI на основе ончейн-состояния, а не фиксированного Base URI.

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

Base URI в NFT стандарта ERC-721

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

Каждый токен ERC-721 имеет уникальный ID в рамках конкретного контракта.

Адрес контракта вместе с ID токена однозначно идентифицируют NFT в соответствующем блокчейне.

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

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

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

Вместо хранения 10,000 полных ссылок на метаданные коллекция может использовать один Base URI, формируя отдельные ссылки на основе ID токенов.

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

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

Общий Base URI обеспечивает простую и предсказуемую структуру.

Base URI в токенах ERC-1155

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

В ERC-1155 метаданные обрабатываются иначе, чем во многих реализациях ERC-721.

Согласно официальному стандарту ERC-1155, если в URI есть строка {id}, клиент может подставить вместо нее ID токена.

Клиенты должны заменить {id} на фактический ID токена в нижнем регистре шестнадцатеричного формата, дополнив его до 64 символов при необходимости.

Благодаря этому множество ID токенов может использовать один общий шаблон URI.

Например, URI может выглядеть так: https://example.com/metadata/{id}.json.

Кошелек или приложение подставляет форматированный ID вместо {id}, чтобы найти нужный JSON-файл.

По назначению это похоже на Base URI: один общий шаблон позволяет сформировать множество ссылок на метаданные.

Однако ERC-1155 использует специальное правило подстановки, а не простую схему «Base URI + ID токена», распространенную во многих контрактах ERC-721.

Разработчикам не следует считать, что пути к метаданным ERC-721 и ERC-1155 формируются одинаково.

Base URI и метаданные NFT

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

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

Схема метаданных ERC-721 включает базовые поля, например name, description и image.

Схема ERC-1155 также содержит распространенные описательные поля и поддерживает данные отображения для отдельных токенов.

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

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

При динамических метаданных Base URI может указывать на API, который со временем возвращает разные JSON-данные.

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

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

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

Base URI и IPFS

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

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

URI IPFS обычно начинается с ipfs:// и содержит идентификатор контента, или CID.

Base URI с IPFS может выглядеть так: ipfs://bafyExampleCID/.

Затем файлы метаданных токенов можно разместить в этом каталоге IPFS.

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

Если содержимое изменится, изменится и CID.

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

Однако, чтобы пользователям было удобно получать данные IPFS, они должны оставаться доступными как минимум на одном узле или у одного провайдера закрепления (pinning).

Base URI на IPFS повышает целостность данных, но не отменяет необходимости планировать долгосрочное хранение.

Base URI и HTTP URL

В качестве Base URI можно использовать и обычный HTTPS URL.

Например, коллекция может использовать в качестве Base URI адрес https://example.com/metadata/.

Тогда tokenURI токена 100 может иметь вид https://example.com/metadata/100.json.

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

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

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

Если срок регистрации домена истечет или хостинг перестанет работать, NFT может отображаться некорректно.

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

Централизованные HTTP-метаданные удобны, но могут снижать долговременную доступность данных.

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

Base URI и хранилища типа Arweave

Некоторые NFT-проекты используют постоянные хранилища метаданных и медиафайлов.

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

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

Такой подход может снизить риск недоступности обычного веб-сервера.

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

Тем не менее пользователям следует понимать точный формат URI и принцип работы шлюза.

URL шлюза не всегда совпадает с лежащим в его основе постоянным идентификатором содержимого.

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

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

Конструкция Base URI должна упрощать проверку долгосрочного местоположения данных.

Base URI и ончейн-метаданные

Некоторые токены не используют внешний Base URI: их метаданные полностью хранятся в блокчейне или формируются там же.

Ончейн-метаданные могут возвращаться в виде data URI, который содержит закодированный JSON непосредственно из смарт-контракта.

В такой схеме tokenURI может начинаться с data:application/json, а не с ipfs:// или https://.

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

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

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

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

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

Единой оптимальной модели для всех проектов нет.

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

Base URI и раскрытие метаданных

Многие NFT-коллекции используют Base URI в процессе раскрытия метаданных.

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

В заглушке может отображаться загадочное изображение или общее описание коллекции.

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

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

Однако такая схема требует доверия.

Если проект контролирует Base URI, он может менять метаданные и после выпуска токенов.

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

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

Пользователям важно понимать, является ли Base URI коллекции временным, раскрытым, изменяемым или окончательно заблокированным.

Изменяемый Base URI

Изменяемый Base URI можно обновить после развертывания контракта.

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

Но это также опасно: лицо, контролирующее функцию обновления, может изменить отображение всех токенов.

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

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

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

Пользователям следует выяснить, можно ли еще изменить Base URI.

Также важно проверить, кто имеет такие полномочия.

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

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

Неизменяемый Base URI

Неизменяемый Base URI нельзя поменять после развертывания контракта или выполнения окончательной блокировки.

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

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

Особенно надежным такой подход становится в сочетании с адресуемым по содержимому хранилищем, например CID IPFS.

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

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

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

Перед блокировкой Base URI разработчикам следует тщательно проверить пути к метаданным.

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

Постоянная ошибка остается постоянной.

Base URI и обновления метаданных ERC-4906

ERC-4906 — расширение стандарта ERC-721 для обновления метаданных.

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

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

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

ERC-4906 дает контрактам стандартный способ сообщать сторонним системам об изменении метаданных токенов.

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

Однако сам стандарт не делает изменения метаданных безопасными.

Он лишь помогает сообщить об изменении.

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

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

Base URI и несколько наборов метаданных ERC-7160

ERC-7160 — расширение ERC-721, поддерживающее несколько URI метаданных для одного токена.

В официальном стандарте ERC-7160 описана система, в которой у токена может быть несколько URI метаданных и закрепленный основной URI.

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

У токена может быть несколько версий, форматов, редакций или вариантов отображения.

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

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

В совместном NFT могут объединяться метаданные нескольких создателей.

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

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

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

Base URI и экономия газа

Base URI часто используют для снижения затрат на газ.

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

Общий Base URI позволяет контракту хранить меньше данных.

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

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

Например, коллекция из 10,000 токенов может использовать один Base URI и 10,000 JSON-файлов с именами, соответствующими ID токенов.

Контракту потребуется лишь логика для объединения Base URI и ID токена.

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

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

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

Base URI и именование файлов

Имена файлов важны: при формировании tokenURI путь должен соответствовать фактическим файлам метаданных.

Если контракт возвращает ipfs://CID/1, в хранилище должен быть файл или объект с именем 1.

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

Метаданные могут не загрузиться и в том случае, если контракт возвращает 0001.json, а файлы названы 1.json.

В ERC-1155 добавляется еще одно условие: ID токена подставляется в шестнадцатеричном формате с дополнением нулями и буквами нижнего регистра.

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

Нужно проверять результаты tokenURI на тестовых сетях и сопоставлять их с реальными файлами метаданных.

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

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

Небольшая ошибка в имени файла может привести к проблемам отображения всей коллекции.

Base URI и завершающий слеш

Завершающий слеш — это слеш в конце Base URI.

От него может зависеть корректность итогового tokenURI.

Например, ipfs://CID/ и ID токена 1 дают ipfs://CID/1.

Без слеша ipfs://CID и ID токена 1 дадут ipfs://CID1, что может быть неверным.

Та же проблема возникает и с HTTPS-путями.

https://example.com/metadata/ и 1.json дают понятный путь к файлу.

https://example.com/metadata и 1.json превращаются в https://example.com/metadata1.json, которого может не существовать.

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

По отображению на маркетплейсе пользователи не всегда могут заметить эту проблему.

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

Base URI и кэширование метаданных

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

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

Однако после изменения Base URI кэш может вызывать путаницу.

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

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

ERC-4906 был создан, чтобы предоставить контрактам стандартный способ сообщать об изменениях метаданных.

Тем не менее не каждое приложение обновляет данные мгновенно или поддерживает все события метаданных.

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

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

Возможно, кэш метаданных просто еще не обновился.

Base URI и риск централизации

Base URI создает риск централизации, если указывает на сервер или домен под контролем одной стороны.

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

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

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

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

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

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

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

Тем не менее каждому проекту необходим план долгосрочного хранения.

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

Base URI и адресация по содержимому

При адресации по содержимому идентификатор определяется самим содержимым.

CID IPFS — распространенный пример в сфере криптометаданных.

При изменении метаданных, адресуемых по содержимому, меняется и идентификатор.

Это упрощает обнаружение подмены.

Поэтому Base URI с CID может повысить уверенность пользователей в том, что связанные файлы не менялись незаметно.

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

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

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

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

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

Base URI и динамические NFT

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

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

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

Динамический Base URI может сделать NFT более интерактивным и функциональным.

Например, игровой персонаж-NFT может повышать уровень и отображать новые атрибуты.

NFT-членство может менять внешний вид, когда пользователь достигает нового статуса.

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

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

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

Динамические метаданные эффективны только при прозрачных правилах.

Base URI и безопасность

Безопасность Base URI зависит от хранилища, контроля доступа, логики контракта и ожиданий пользователей.

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

Если Base URI контролируется одним приватным ключом, этот ключ становится привлекательной целью для злоумышленников.

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

Если Base URI контролирует система управления, безопасность зависит от распределения голосов и процесса обновления.

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

Если Base URI ведет на IPFS, важны закрепление данных и их доступность.

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

Единой модели безопасности Base URI не существует.

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

Base URI и обновление смарт-контракта

Обновляемые смарт-контракты могут менять способ вычисления tokenURI.

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

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

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

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

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

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

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

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

Оценивая постоянство метаданных, пользователям не следует учитывать только Base URI.

Base URI и проверка токенов

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

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

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

Настоящие идентификаторы — это адрес контракта и ID токена в правильном блокчейне.

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

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

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

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

Понятная конструкция Base URI помогает проверке, но не заменяет проверку контракта.

Подлинность зависит и от идентификатора токена, и от целостности метаданных.

Base URI и метаданные коллекции

Обычно Base URI относится к путям к метаданным отдельных токенов.

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

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

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

Base URI токена не следует путать с URI метаданных коллекции.

Base URI токена помогает формировать метаданные для отдельных ID.

URI метаданных коллекции описывает коллекцию в целом.

Оба типа данных влияют на отображение проекта в кошельках и приложениях.

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

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

Заморозка Base URI и метаданных

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

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

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

Некоторые проекты объявляют о заморозке метаданных после их раскрытия.

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

Обещание слабее блокировки на уровне контракта.

Но и блокировка на уровне контракта менее надежна, если контракт все еще можно обновить.

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

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

Однако преждевременная заморозка может навсегда сохранить ошибки.

Base URI и пользовательский опыт

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

Если Base URI быстро загружается, NFT отображаются без задержек.

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

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

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

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

Пользователи часто оценивают коллекции по тому, что видят в кошельке.

Поэтому разработчикам следует считать проектирование Base URI частью качества продукта.

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

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

Примеры Base URI

Простой Base URI для IPFS может выглядеть так: ipfs://bafyExampleCID/.

Если контракт добавляет ID токена 7 и суффикс .json, полный tokenURI может стать таким: ipfs://bafyExampleCID/7.json.

Простой HTTPS Base URI может выглядеть так: https://example.com/api/token/.

Если контракт добавляет ID токена 7, полный tokenURI будет иметь вид https://example.com/api/token/7.

Шаблон URI для ERC-1155 может выглядеть так: https://example.com/metadata/{id}.json.

В этом случае совместимые клиенты заменяют {id} форматированным ID токена.

Ончейн data URI может начинаться с data:application/json;base64, а не использовать Base URI.

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

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

Base URI полезен только тогда, когда он формирует корректные и доступные результаты tokenURI.

Преимущества использования Base URI

Первое преимущество Base URI — экономия газа.

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

Второе преимущество — упрощение организации коллекции.

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

Третье преимущество — упрощение выпуска крупных коллекций.

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

Четвертое преимущество — более простое управление раскрытием метаданных.

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

Пятое преимущество — совместимость.

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

Шестое преимущество — гибкость.

Base URI может поддерживать IPFS, HTTPS, ссылки на постоянные хранилища, конечные точки API и гибридные схемы.

Риски использования Base URI

Первый риск — неработающие метаданные.

Неверный Base URI может нарушить отображение всех токенов коллекции.

Второй риск — централизация.

Base URI, указывающий на обычный сервер, зависит от сервера, домена и оператора.

Третий риск — вредоносные обновления.

Если администратор может изменить Base URI, он потенциально может изменить отображение каждого токена.

Четвертый риск — скрытая изменяемость.

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

Пятый риск — путаница из-за кэширования.

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

Шестой риск — доступность хранилища.

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

Седьмой риск — обновляемая логика.

Обновление контракта может изменить работу tokenURI, даже если Base URI кажется заблокированным.

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

Пользователи могут проверить работу Base URI, вызвав функцию tokenURI для конкретного ID токена.

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

Нужно проверить, начинается ли URI с ipfs://, https://, data:, ar:// или другой схемы.

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

Нужно проверить, есть ли в JSON ожидаемые поля: image, description, attributes и другие.

Также следует убедиться, что ссылки на изображения внутри JSON стабильны и доступны.

Нужно изучить контракт и выяснить, можно ли изменить Base URI.

Следует проверить, можно ли обновить сам контракт.

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

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

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

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

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

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

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

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

Функции обновления Base URI необходимо защищать надежным контролем доступа.

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

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

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

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

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

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

Нужно проверять tokenURI реального токена, а не полагаться на скриншоты.

Стоит отдавать предпочтение проектам, которые ясно объясняют, где хранятся метаданные.

Нужно выяснить, можно ли еще изменить Base URI.

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

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

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

Важно помнить, что владение NFT не всегда означает владение медиафайлом, авторскими правами или правами на офчейн-активы.

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

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

Распространенные заблуждения о Base URI

Одно из распространенных заблуждений состоит в том, что Base URI хранит сам NFT.

Обычно Base URI указывает на метаданные, а право владения отслеживается смарт-контрактом.

Еще одно заблуждение — будто изображение NFT всегда хранится в блокчейне.

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

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

IPFS повышает целостность данных, но кто-то все равно должен обеспечивать их доступность.

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

Постоянство метаданных и юридические права — разные вопросы.

Пятое заблуждение состоит в том, что любое изменение Base URI — это плохо.

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

Шестое заблуждение — будто корректное отображение доказывает безопасность Base URI.

Кэш может скрывать проблемы; по возможности пользователям следует проверять фактический tokenURI.

Связанные криптотермины

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

tokenURI — функция ERC-721, возвращающая URI метаданных для конкретного ID токена.

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

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

Метаданные NFT — JSON или другая структурированная информация с названием токена, изображением, характеристиками и другими свойствами.

IPFS — межпланетная файловая система, сеть хранения данных с адресацией по содержимому, часто используемая для данных NFT.

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

Data URI — URI, который содержит данные непосредственно в своей строке.

Раскрытие метаданных — процесс замены метаданных-заглушек токена на итоговые метаданные.

Заморозка метаданных — фиксация метаданных токена или путей к ним, исключающая дальнейшие изменения.

FAQ

Что означает Base URI в NFT?

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

Base URI и tokenURI — одно и то же?

Нет. Base URI обычно является общим префиксом, а tokenURI — полным URI метаданных конкретного токена.

Как Base URI работает в ERC-721?

Во многих контрактах ERC-721 Base URI объединяется с ID токена, формируя итоговый tokenURI NFT.

Как Base URI работает в ERC-1155?

В ERC-1155 часто используется шаблон URI с подстановкой {id}: клиенты заменяют {id} форматированным ID токена.

Можно ли изменить Base URI?

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

Опасен ли изменяемый Base URI?

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

Неизменяемый Base URI всегда лучше?

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

Зачем NFT-проекты используют IPFS для Base URI?

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

Гарантирует ли IPFS, что метаданные NFT навсегда останутся доступными?

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

Почему не отображается изображение моего NFT, хотя токен принадлежит мне?

Изображение может отсутствовать из-за неверного Base URI, недоступного файла метаданных, неработающей ссылки на изображение или необновленного кэша приложения.

Что такое раскрытие метаданных?

Раскрытие метаданных — это замена метаданных-заглушек итоговыми, часто посредством обновления Base URI или логики tokenURI.

Как проверить безопасность Base URI NFT?

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

Заключение

Base URI — важное понятие, связанное с метаданными в контрактах NFT и криптотокенов.

Это общий путь, с помощью которого контракт формирует полный URI метаданных отдельных токенов.

Во многих коллекциях ERC-721 Base URI объединяется с ID токена для формирования tokenURI.

В ERC-1155 похожую задачу часто выполняет шаблон URI с подстановкой {id}.

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

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

Если Base URI указывает на централизованные серверы, пользователи зависят от этих серверов и их операторов.

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

Если Base URI можно изменить, пользователям приходится доверять лицу, уполномоченному на обновление, и мерам защиты.

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

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

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

Главный вывод: владение NFT и метаданные NFT связаны, но не являются одним и тем же.

Смарт-контракт подтверждает право владения токеном, а Base URI помогает приложениям находить данные о том, что этот токен представляет.

Надежная конструкция Base URI делает эту связь стабильной, прозрачной и удобной для проверки.

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