Identifikatori sadržaja (CID)

Jedinstveni otisak koji svaka IPFS datoteka prima.

Što je CID?

Identifikator sadržaja (CID) je samoopisujuća oznaka koja jedinstveno identificira dio podataka na IPFS-u. Izveden je iz kriptografskog hasha sadržaja datoteke, kombiniranog s metapodacima o korištenom algoritmu hashiranja i formatu kodiranja.

bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi

CID-ovi koji počinju s bafy (ili bafk za mali sadržaj u jednom bloku) koriste CIDv1, moderni samoopisujući format. Stariji CID-ovi koji počinju s Qm koriste CIDv0 (SHA-256 kodiran u base58) — i dalje su valjani i razrješivi, ali više nisu zadani izlaz za novi sadržaj.

Ključna svojstva

• Deterministički — Ista datoteka uvijek proizvodi isti CID. Prenesite istu sliku dvaput i dobivate isti identifikator.
• Jedinstven — Čak i promjena jednog bajta proizvodi potpuno drugačiji CID. To čini CID-ove otpornima na manipulaciju.
• Samoovjeravajući — Svatko tko primi datoteku može ponovo izračunati hash i potvrditi da odgovara traženom CID-u.
• Nepromjenjiv — CID uvijek upućuje na isti sadržaj. Ne možete promijeniti na što CID upućuje.

CID-ovi u IPFS.NINJA

Svaka datoteka koju prenesete vraća CID u API odgovoru. Koristite ga za:

• Pristup datoteci putem gatewaya: ipfs.ninja/ipfs/<CID>
• Dohvat metapodataka datoteke: GET /file/<CID>
• Referenciranje sadržaja on-chain (NFT-ovi, pametni ugovori)
• Dijeljenje s bilo kime — mogu provjeriti da sadržaj odgovara

CIDv0 vs CIDv1

Svojstvo	CIDv0	CIDv1
Prefiks	Qm...	bafy... (dag-pb, direktoriji i višedijelne datoteke), bafk... (raw, mali sadržaj u jednom bloku), te drugi ovisno o kodeku
Hash funkcija	Samo SHA-256	Više (SHA-256, Blake2b itd.)
Kodiranje	Base58 (mješovita velika/mala slova)	Multibase — zadano base32 (mala slova, sigurno za DNS)
Samoopisujući	Ne	Da (uključuje kodek + info o hashu)
Djeljenje na blokove	Zadano 256 KiB (stariji format)	1 MiB prema IPIP-0499
Kodiranje listova	Omotano u dag-pb	Raw bajtovi (raw-leaves=true)

Što IPFS.NINJA vraća

Prijenosi i prikvačivanja izvršeni nakon 2026-07-13 prema zadanim postavkama vraćaju CIDv1: CIDv1 base32 kodiranje, 1 MiB blokovi, raw listovi — profil IPIP-0499 unixfs-v1-2025. Praktične posljedice:

• Male datoteke (≤ 1 MiB) vraćaju se kao bafk... (raw CIDv1 u jednom bloku)
• Veće datoteke i direktoriji vraćaju se kao bafy... (dag-pb CIDv1)
• Datoteka prenesena putem nas dobiva isti CID koji bi izračunao bilo koji moderni alat (Helia, najnoviji Kubo, ipfs-car) iz istih bajtova

Unatražna kompatibilnost

Stariji Qm... CID-ovi iz ranijih prijenosa ostaju u potpunosti razrješivi — gateway, POST /pin, GET /file/:cid, IPNS razrješivači i svi ostali endpointi trajno prihvaćaju oba formata. Ako imate Qm... CID iz ranijeg prijenosa, ništa što ste izgradili neće prestati raditi.