Skip to content

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

Уникалният пръстов отпечатък, който всеки IPFS файл получава.

Какво е CID?

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

QmXk7VRz4qoG5Dg8sFL4bYWHpKe4F

CIDs that start with Qm use CIDv0 (base58-encoded SHA-256). Newer CIDv1 identifiers start with bafy and support multiple hash functions and encodings.

Ключови свойства

  • Детерминистичен — Един и същ файл винаги произвежда един и същ CID. Качете едно и също изображение два пъти и получавате същия идентификатор.
  • Уникален — Дори промяна на един байт произвежда напълно различен CID. Това прави CID устойчив на подправяне.
  • Самоверифициращ — Всеки, който получи файл, може да преизчисли хеша и да потвърди, че съвпада с поискания CID.
  • Неизменяем — CID винаги сочи към едно и също съдържание. Не можете да промените към какво CID сочи.

CID в IPFS.NINJA

Всеки файл, който качите, връща CID в API отговора. Използвайте го за:

  • Достъп до файла чрез gateway: ipfs.ninja/ipfs/<CID>
  • Извличане на метаданни на файла: GET /file/<CID>
  • Референция на съдържание на веригата (NFT, смарт контракти)
  • Споделяне с всеки — могат да проверят дали съдържанието съвпада

CIDv0 vs CIDv1

CIDv0CIDv1
ПрефиксQm...bafy...
Хеш функцияСамо SHA-256Множество (SHA-256, Blake2b и др.)
КодиранеBase58Multibase (base32, base58 и др.)
СамоописващНеДа (включва кодек + хеш информация)