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

Уникальный отпечаток, который получает каждый файл IPFS.

Что такое CID?

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

QmXk7VRz4qoG5Dg8sFL4bYWHpKe4F

CID, начинающиеся с Qm, используют CIDv0 (SHA-256 в кодировке base58). Более новые идентификаторы CIDv1 начинаются с bafy и поддерживают несколько хеш-функций и кодировок.

Ключевые свойства

• Детерминированный — Один и тот же файл всегда даёт один и тот же CID. Загрузите одно и то же изображение дважды — получите одинаковый идентификатор.
• Уникальный — Даже изменение одного байта даёт совершенно другой CID. Это делает CID защищённым от подделки.
• Самоверифицирующий — Любой получатель файла может пересчитать хеш и подтвердить, что он совпадает с запрошенным CID.
• Неизменяемый — CID всегда указывает на одно и то же содержимое. Вы не можете изменить, на что разрешается CID.

CID в IPFS.NINJA

Каждый загруженный файл возвращает CID в ответе API. Используйте его для:

• Доступа к файлу через шлюз: ipfs.ninja/ipfs/<CID>
• Получения метаданных файла: GET /file/<CID>
• Ссылки на контент в блокчейне (NFT, смарт-контракты)
• Обмена с другими — они могут проверить, что содержимое совпадает

CIDv0 и CIDv1

Свойство	CIDv0	CIDv1
Префикс	Qm...	bafy...
Хеш-функция	Только SHA-256	Несколько (SHA-256, Blake2b и др.)
Кодирование	Base58	Multibase (base32, base58 и др.)
Самоописывающий	Нет	Да (включает информацию о кодеке и хеше)