Identifikátory obsahu (CID)

Jedinečný otisk, který každý soubor na IPFS obdrží.

CIDv0 vs CIDv1: Srovnání formátů IPFS

Vlastnost	CIDv0	CIDv1
Prefix	Qm...	bafy... (dag-pb, adresáře a víceblokové soubory), bafk... (raw, malý jednoblokový obsah), a další podle kodeku
Hashovací funkce	Pouze SHA-256	Více (SHA-256, Blake2b atd.)
Kódování	Base58 (smíšená velikost písmen)	Multibase — výchozí base32 (malá písmena, bezpečné pro DNS)
Samopopisný	Ne	Ano (zahrnuje kodek + info o hashi)
Chunker	Starší výchozí 256 KiB	1 MiB podle IPIP-0499
Kódování listů	Zabaleno v dag-pb	Surové bajty (raw-leaves=true)

Co produkuje IPFS.NINJA

Nahrání a připnutí provedená po 13. 7. 2026 vrací CIDv1 jako výchozí: base32 kódování CIDv1, bloky po 1 MiB, surové listy — profil IPIP-0499 unixfs-v1-2025. Praktické dopady:

• Malé soubory (≤ 1 MiB) se vrací jako bafk... (raw jednoblokové CIDv1)
• Větší soubory a adresáře se vrací jako bafy... (dag-pb CIDv1)
• Soubor nahraný přes nás dostane stejné CID, jaké by pro stejná data vypočítal jakýkoli moderní nástroj (Helia, nejnovější Kubo, ipfs-car)

Zpětná kompatibilita

Starší CID Qm... z dřívějších nahrání zůstávají plně přeložitelná — gateway, POST /pin, GET /file/:cid, IPNS resolvery a každý další endpoint přijímá oba formáty neomezeně dlouho. Pokud máte CID Qm... z dřívějšího nahrání, nic z toho, co jste postavili, nepřestane fungovat.

Co je CID?

Identifikátor obsahu (CID) je samopopisný štítek, který jednoznačně identifikuje kus dat na IPFS. Je odvozen z kryptografického hashe obsahu souboru, kombinovaného s metadaty o použitém hashovacím algoritmu a formátu kódování.

bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi

CID začínající na bafy (nebo bafk pro malý jednoblokový obsah) používají CIDv1, moderní samopopisný formát. Starší CID začínající na Qm používají CIDv0 (SHA-256 kódovaný v base58) — stále platná, stále rozřešitelná, ale už nejsou výchozím výstupem pro nový obsah.

Klíčové vlastnosti

• Deterministický — Stejný soubor vždy produkuje stejný CID. Nahrajte stejný obrázek dvakrát a dostanete stejný identifikátor.
• Jedinečný — I změna jednoho bajtu produkuje zcela jiný CID. To činí CID odolnými proti manipulaci.
• Samoověřitelný — Kdokoli, kdo obdrží soubor, může přepočítat hash a potvrdit, že odpovídá požadovanému CID.
• Neměnný — CID vždy odkazuje na stejný obsah. Nelze změnit, na co CID odkazuje.

CID v IPFS.NINJA

Každý soubor, který nahrajete, vrátí CID v odpovědi API. Použijte ho k:

• Přístupu k souboru přes gateway: ipfs.ninja/ipfs/<CID>
• Získání metadat souboru: GET /file/<CID>
• Referencování obsahu on-chain (NFT, chytré kontrakty)
• Sdílení s kýmkoli — mohou ověřit, že obsah odpovídá

Podívejte se na přehled IPFS.NINJA, kde zjistíte, jak CID zapadají do procesu nahrávání. Zjistěte, jak připnout obsah podle CID, aby zůstal trvale dostupný.