IPFS CID (идентификатор содержимого)

Что такое IPFS CID?

IPFS CID (Content Identifier) — это уникальная метка, формируемая на основе содержимого и используемая для идентификации файлов, папок, блоков, метаданных и других данных, хранящихся в IPFS или связанных с этой системой.

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

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

Поэтому IPFS CID отличается от обычного URL сайта: стандартный URL обычно указывает на местоположение, а CID — на сам контент.

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

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

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

IPFS CID — это не токен, адрес кошелька, адрес смарт-контракта или хеш транзакции в блокчейне.

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

Почему IPFS CID важен в криптовалютной сфере

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

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

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

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

Затем метаданные могут содержать ссылку на другой CID с изображением, анимацией, аудиофайлом или другим медиафайлом.

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

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

Пользователям CID позволяют проще проверить, ссылается ли NFT или dApp на тот же контент, который был опубликован изначально.

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

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

Как работает IPFS CID

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

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

Криптографический хеш можно представить как цифровой отпечаток данных.

Если данные изменятся, изменится и отпечаток.

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

В спецификации CID этот идентификатор описывается как самоописывающийся идентификатор, адресуемый по содержимому и использующий multihash, multicodec и иногда multibase.

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

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

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

IPFS CID и обычный URL: сравнение

Обычный URL, как правило, сообщает браузеру, где найти данные.

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

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

IPFS CID работает иначе: он определяет содержимое по тому, что оно собой представляет.

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

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

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

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

Адресация по местоположению отвечает на вопрос: где находится файл?

Адресация по содержимому отвечает на вопрос: что это за файл?

Этот принцип — одна из главных причин, по которым IPFS относится к инфраструктуре Web3.

Структура IPFS CID

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

Обычно основные компоненты — это версия, кодек содержимого и multihash.

Версия CID сообщает программному обеспечению, какой формат CID используется.

Кодек содержимого указывает, какая структура данных идентифицируется.

В multihash указана использованная хеш-функция и содержится хеш-дайджест.

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

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

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

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

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

CIDv0 и CIDv1

Пользователи криптовалют могут встретить две распространенные версии CID — CIDv0 и CIDv1.

CIDv0 — более старый формат. Его часто узнают по начальным символам Qm.

Формат CIDv0 ограничен и обычно связан с кодировкой base58btc, данными DAG-PB и хеш-функцией sha2-256.

CIDv1 — более новая и гибкая версия.

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

В документации IPFS версии CID и способы их преобразования описаны в руководстве по форматам идентификаторов CID.

В NFT и Web3 до сих пор встречаются обе версии — CIDv0 и CIDv1.

Проект может использовать CIDv0, поскольку этот формат знаком многим и широко распространен.

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

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

Разница может объясняться версией или кодировкой CID.

IPFS CID и метаданные NFT

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

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

Смарт-контракт может возвращать URI, начинающийся с ipfs:// и содержащий CID.

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

Поле изображения в метаданных также может содержать еще один IPFS CID.

Так NFT ссылается на контент, который можно проверить с помощью CID.

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

Если изменится файл изображения, должен измениться и его CID.

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

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

IPFS CID и децентрализованные приложения

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

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

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

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

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

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

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

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

IPFS CID и смарт-контракты

Смарт-контракты могут хранить IPFS CID напрямую или содержать строки с IPFS URI.

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

Поэтому CID служат связующим звеном между ончейн-логикой и контентом вне блокчейна.

Блокчейн может хранить ссылку, а IPFS — помогать распространять указанный контент.

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

Пользователь может получить контент по CID и проверить его соответствие идентификатору.

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

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

Форматы IPFS URI

Пользователи криптовалют часто встречают CID в форматах IPFS URI.

Один из распространенных форматов — ipfs://CID.

Другой распространенный формат — ipfs://CID/path/to/file.

Первый формат указывает на корневой контент, идентифицируемый CID.

Второй — на файл или объект внутри каталога, представленного этим CID.

Некоторые сайты и кошельки преобразуют IPFS URI в URL шлюза, чтобы открывать их в обычном веб-браузере.

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

URL шлюза может выглядеть иначе, чем URI ipfs://, но под ним может использоваться тот же CID.

При проверке контента обращайте внимание прежде всего на сам CID, а не только на домен шлюза.

Шлюз — это способ доступа к контенту, а CID — его идентификатор.

IPFS CID и шлюзы

Шлюз IPFS позволяет обычным веб-браузерам получать контент IPFS.

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

При открытии ссылки на шлюз тот запрашивает контент IPFS и передает его по HTTP или HTTPS.

Это упрощает доступ к контенту IPFS, но может привести и к путанице.

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

На самом деле шлюз — лишь один из способов доступа к контенту, идентифицируемому CID.

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

Поэтому неработающая ссылка на шлюз не всегда означает, что CID недействителен.

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

IPFS CID и закрепление контента

CID идентифицирует контент, но не гарантирует, что тот будет доступен всегда.

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

Закрепление — это указание узлу IPFS хранить определенный контент.

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

Это крайне важно для криптопроектов, использующих IPFS CID.

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

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

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

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

Неизменяемость IPFS CID

IPFS CID часто называют неизменяемыми, но важно правильно понимать, что это означает.

CID указывает на конкретную версию контента, поэтому изменение содержимого создает другой CID.

Таким образом, сам CID остается стабильной ссылкой на конкретный контент.

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

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

Если сайт меняет URL шлюза или перенаправляет пользователей, они могут увидеть другой CID.

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

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

Проверка IPFS CID

Возможность проверки — одно из главных преимуществ IPFS CID.

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

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

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

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

Разработчикам она помогает подтвердить, что сборка dApp соответствует известной версии.

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

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

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

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

Как прочитать IPFS CID

Большинству пользователей не нужно вручную разбирать все компоненты CID.

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

CID, начинающийся с Qm, обычно относится к версии CIDv0.

CID, начинающийся с b, часто представляет собой CIDv1 в кодировке base32.

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

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

Длина и вид зависят от версии CID, кодировки, хеш-функции и формата данных.

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

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

IPFS CID и хеш транзакции в блокчейне: сравнение

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

Но это разные вещи.

Хеш транзакции в блокчейне идентифицирует транзакцию, записанную в блокчейне.

IPFS CID идентифицирует контент, адресуемый через IPFS.

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

С помощью CID можно получить файл, папку, объект метаданных или другой контент и проверить его.

Не вставляйте CID в обозреватель блокчейна в надежде, что он сработает как хеш транзакции.

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

IPFS CID и адрес кошелька: сравнение

IPFS CID также отличается от адреса кошелька.

Адрес кошелька — это идентификатор назначения или аккаунта в блокчейн-сети.

CID идентифицирует контент в системе адресации по содержимому.

Отправка криптоактивов на CID — не то же самое, что отправка средств на адрес кошелька.

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

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

Перед копированием строки в кошелек, dApp или поле транзакции выясните, что это: CID, адрес кошелька, хеш транзакции, адрес смарт-контракта или URI.

Распространенные способы использования IPFS CID в криптовалютной сфере

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

Другой — хранение медиафайлов NFT.

Третий — размещение интерфейсов децентрализованных приложений.

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

Пятый — хранение документации к предложениям по управлению проектом.

Шестой — распространение списков токенов или информации об активах.

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

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

Эти сценарии показывают, почему CID — базовая концепция для всех, кто изучает инфраструктуру Web3.

Преимущества IPFS CID

Первое преимущество IPFS CID — возможность проверки.

С помощью CID можно проверить, соответствует ли полученный контент ожидаемому.

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

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

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

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

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

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

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

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

Шестое преимущество — прозрачность.

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

Ограничения и риски IPFS CID

IPFS CID не гарантирует постоянного хранения.

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

IPFS CID не гарантирует конфиденциальности.

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

IPFS CID не гарантирует безопасность контента.

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

IPFS CID не подтверждает легитимность проекта.

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

Если конструкция смарт-контракта допускает обновление ссылок на метаданные, IPFS CID не помешает владельцам контракта изменить эти ссылки.

IPFS CID не заменяет тщательную защиту кошелька, проверку транзакций или изучение проекта.

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

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

При проверке важных метаданных NFT, релизов dApp или документов по управлению проектом сравнивайте CID целиком.

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

Помните: проблема со шлюзом не всегда означает, что проблема связана с CID.

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

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

Храните резервные копии важных файлов за пределами IPFS.

При публикации файлов криптопроекта четко указывайте официальные CID.

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

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

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

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

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

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

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

Для современной совместимости рассмотрите использование CIDv1, особенно при работе со шлюзами с субдоменами.

Проверяйте IPFS URI в разных кошельках, браузерах, шлюзах и конфигурациях локальных узлов.

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

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

Не меняйте файлы незаметно: даже небольшие изменения создают новые CID и могут снизить доверие пользователей.

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

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

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

CID идентифицирует контент, а не отдельное место хранения.

Другое заблуждение — считать, что CID гарантирует постоянную доступность контента.

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

Третья ошибка — считать, что все ссылки IPFS постоянны и не требуют закрепления.

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

Четвертая ошибка — считать URL шлюза и CID одним и тем же.

Шлюз — лишь способ доступа, а CID — идентификатор контента.

Пятая ошибка — считать, что контент по CID всегда безопасен.

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

FAQ

Что означает IPFS CID?

IPFS CID означает InterPlanetary File System Content Identifier — идентификатор содержимого, используемый для данных в IPFS.

IPFS CID — это то же самое, что URL?

Нет. IPFS CID идентифицирует само содержимое, а обычный URL обычно указывает на местоположение, например сервер и путь к файлу.

Может ли измениться IPFS CID?

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

Хранит ли IPFS CID данные в блокчейне?

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

Зачем NFT используют IPFS CID?

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

Обеспечивает ли CID постоянное хранение контента IPFS?

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

Является ли IPFS CID конфиденциальным?

Нет, CID не следует считать конфиденциальным: любой, у кого он есть, может получить контент, если тот доступен в IPFS.

Чем отличаются CIDv0 и CIDv1?

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

Почему некоторые IPFS CID начинаются с Qm?

Многие CID, начинающиеся с Qm, относятся к CIDv0 и используют знакомый старый формат.

Могут ли два разных файла иметь один и тот же CID?

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

Как открыть IPFS CID?

Открыть IPFS CID можно через совместимый кошелек, шлюз IPFS, локальный узел IPFS, IPFS Desktop или другой инструмент, поддерживающий получение контента IPFS.

Может ли смарт-контракт обновить IPFS CID?

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

Заключение

IPFS CID — один из ключевых компонентов децентрализованного хранения данных в криптовалютной сфере и Web3.

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

Для NFT CID связывают ончейн-токены с медиафайлами и метаданными вне блокчейна.

Для dApp CID помогают публиковать и проверять статические файлы интерфейса и публичные ресурсы.

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

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

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

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

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

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