Identifikátory obsahu (CID)

Jedinečný odtlačok, ktorý každý súbor na IPFS obdrží.

Čo je CID?

Identifikátor obsahu (CID) je samopopisný štítok, ktorý jednoznačne identifikuje kus dát na IPFS. Je odvodený z kryptografického hashu obsahu súboru, kombinovaného s metadátami o použitom hashovacom algoritme a formáte kódovania.

bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi

CID, ktoré začínajú na bafy (alebo bafk pre malý jednoblokový obsah), používajú CIDv1, moderný samopopisný formát. Staršie CID, ktoré začínajú na Qm, používajú CIDv0 (base58-kódovaný SHA-256) — stále platný, stále rozpoznateľný, ale už nie je predvoleným výstupom pre nový obsah.

Kľúčové vlastnosti

• Deterministický — Rovnaký súbor vždy produkuje rovnaký CID. Nahrajte rovnaký obrázok dvakrát a dostanete rovnaký identifikátor.
• Jedinečný — Aj zmena jedného bajtu produkuje úplne iný CID. To robí CID odolnými voči manipulácii.
• Samooveriteľný — Ktokoľvek, kto obdrží súbor, môže prepočítať hash a potvrdiť, že zodpovedá požadovanému CID.
• Nemenný — CID vždy odkazuje na rovnaký obsah. Nedá sa zmeniť, na čo CID odkazuje.

CID v IPFS.NINJA

Každý súbor, ktorý nahráte, vráti CID v odpovedi API. Použite ho na:

• Prístup k súboru cez gateway: ipfs.ninja/ipfs/<CID>
• Získanie metadát súboru: GET /file/<CID>
• Referencovanie obsahu on-chain (NFT, smart kontrakty)
• Zdieľanie s kýmkoľvek — môžu overiť, že obsah zodpovedá

CIDv0 vs CIDv1

Vlastnosť	CIDv0	CIDv1
Prefix	Qm...	bafy... (dag-pb, priečinky a viacblokové súbory), bafk... (raw, malý jednoblokový obsah), a ďalšie podľa kodeku
Hashovacia funkcia	Iba SHA-256	Viaceré (SHA-256, Blake2b atď.)
Kódovanie	Base58 (zmiešané veľké/malé písmená)	Multibase — predvolene base32 (malé písmená, bezpečné pre DNS)
Samopopisný	Nie	Áno (zahŕňa kodek + info o hashi)
Chunker	Starší predvolený 256 KiB	1 MiB podľa IPIP-0499
Kódovanie listov	Zabalené v dag-pb	Raw bajty (raw-leaves=true)

Čo IPFS.NINJA generuje

Nahrávania a pripnutia vykonané po 2026-07-13 vracajú predvolene CIDv1: kódovanie CIDv1 base32, 1 MiB chunky, raw leaves — profil IPIP-0499 unixfs-v1-2025. Praktické dôsledky:

• Malé súbory (≤ 1 MiB) sa vracajú ako bafk... (raw jednoblokové CIDv1)
• Väčšie súbory a priečinky sa vracajú ako bafy... (dag-pb CIDv1)
• Súbor nahraný cez nás dostane rovnaké CID, aké by pre rovnaké bajty vypočítal akýkoľvek moderný nástroj (Helia, najnovší Kubo, ipfs-car)

Spätná kompatibilita

Staršie CID Qm... z predchádzajúcich nahrávaní zostávajú plne rozpoznateľné — gateway, POST /pin, GET /file/:cid, IPNS rozpoznávače a každý ďalší endpoint prijímajú oba formáty natrvalo. Ak máte CID Qm... z predchádzajúceho nahrávania, nič, čo ste postavili, neprestáva fungovať.