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

Јединствени отисак који сваки IPFS фајл добија.

Шта је CID?

Идентификатор садржаја (CID) је самоописујућа ознака која јединствено идентификује део података на IPFS-у. Изведен је из криптографског хеша садржаја фајла, комбинованог са метаподацима о коришћеном алгоритму хеширања и формату кодирања.

bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi

CID-ови који почињу са bafy (или bafk за мали садржај у једном блоку) користе CIDv1, модерни самоописујући формат. Стари CID-ови који почињу са Qm користе CIDv0 (base58-кодирани SHA-256) — и даље важећи, и даље разрешиви, али више нису подразумевани излаз за нови садржај.

Кључне особине

• Детерминистички — Исти фајл увек производи исти CID. Отпремите исту слику двапут и добићете исти идентификатор.
• Јединствен — Чак и промена једног бајта производи потпуно другачији CID. То чини CID-ове отпорним на манипулацију.
• Самоверификујући — Свако ко прими фајл може поново израчунати хеш и потврдити да одговара траженом CID.
• Непроменљив — CID увек показује на исти садржај. Не можете променити на шта CID показује.

CID-ови у IPFS.NINJA

Сваки фајл који отпремите враћа CID у API одговору. Користите га за:

• Приступ фајлу преко gateway-а: ipfs.ninja/ipfs/<CID>
• Преузимање метаподатака фајла: GET /file/<CID>
• Референцирање садржаја на блокчејну (NFT, паметни уговори)
• Дељење са било ким — могу проверити да садржај одговара

CIDv0 у односу на CIDv1

Особина	CIDv0	CIDv1
Префикс	Qm...	bafy... (dag-pb, директоријуми и вишеделни фајлови), bafk... (raw, мали садржај у једном блоку), плус други по кодеку
Хеш функција	Само SHA-256	Више (SHA-256, Blake2b итд.)
Кодирање	Base58 (мешана велика/мала слова)	Multibase — подразумевано base32 (мала слова, DNS-безбедно)
Самоописујући	Не	Да (укључује кодек + хеш информације)
Chunker	Стари подразумевани од 256 KiB	1 MiB по IPIP-0499
Кодирање листова	Умотано у dag-pb	Сирови бајтови (raw-leaves=true)

Шта IPFS.NINJA емитује

Отпремања и качења направљена после 2026-07-13 враћају CIDv1 подразумевано: CIDv1 base32 кодирање, делови од 1 MiB, сирови листови — профил IPIP-0499 unixfs-v1-2025. Практичне последице:

• Мали фајлови (≤ 1 MiB) враћају се као bafk... (сирови CIDv1 у једном блоку)
• Већи фајлови и директоријуми враћају се као bafy... (dag-pb CIDv1)
• Фајл отпремљен преко нас добија исти CID који би израчунао сваки модерни алат (Helia, најновији Kubo, ipfs-car) за исте бајтове

Уназадна компатибилност

Стари Qm... CID-ови са ранијих отпремања остају потпуно разрешиви — gateway, POST /pin, GET /file/:cid, IPNS разрешавачи и свака друга крајња тачка прихватају оба формата неограничено. Ако имате Qm... CID са ранијег отпремања, ништа што сте направили не престаје да ради.