Content-identifiers (CID's)

De unieke vingerafdruk die elk IPFS-bestand ontvangt.

Wat is een CID?

Een Content Identifier (CID) is een zelfbeschrijvend label dat een stuk data op IPFS uniek identificeert. Het is afgeleid van de cryptografische hash van de bestandsinhoud, gecombineerd met metadata over het gebruikte hash-algoritme en coderingsformaat.

bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi

CID's die beginnen met bafy (of bafk voor kleine content in één blok) gebruiken CIDv1, het moderne zelfbeschrijvende formaat. Legacy CID's die beginnen met Qm gebruiken CIDv0 (base58-gecodeerde SHA-256) — nog steeds geldig, nog steeds oplosbaar, maar niet langer de standaarduitvoer voor nieuwe content.

Belangrijke eigenschappen

• Deterministisch — Hetzelfde bestand produceert altijd dezelfde CID. Upload dezelfde afbeelding twee keer en je krijgt dezelfde identifier.
• Uniek — Zelfs een wijziging van één byte produceert een volledig andere CID. Dit maakt CID's manipulatie-detecterend.
• Zelfverifiërend — Iedereen die een bestand ontvangt kan de hash opnieuw berekenen en bevestigen dat deze overeenkomt met de opgevraagde CID.
• Onveranderlijk — Een CID wijst altijd naar dezelfde content. Je kunt niet veranderen waar een CID naar oplost.

CID's in IPFS.NINJA

Elk bestand dat je uploadt, retourneert een CID in de API-respons. Gebruik het om:

• Het bestand te benaderen via de gateway: ipfs.ninja/ipfs/<CID>
• Bestandsmetadata op te halen: GET /file/<CID>
• Content on-chain te refereren (NFT's, smart contracts)
• Te delen met iedereen — zij kunnen verifiëren dat de content overeenkomt

CIDv0 vs CIDv1

Eigenschap	CIDv0	CIDv1
Prefix	Qm...	bafy... (dag-pb, directory's & meerdere-chunks-bestanden), bafk... (raw, kleine content in één blok), plus andere per codec
Hashfunctie	Alleen SHA-256	Meerdere (SHA-256, Blake2b, enz.)
Codering	Base58 (gemengde hoofdletters/kleine letters)	Multibase — standaard base32 (kleine letters, DNS-veilig)
Zelfbeschrijvend	Nee	Ja (bevat codec- en hash-info)
Chunker	256 KiB legacy-standaard	1 MiB per IPIP-0499
Leaf-codering	Verpakt in dag-pb	Raw bytes (raw-leaves=true)

Wat IPFS.NINJA uitgeeft

Uploads en pins gemaakt na 13-07-2026 retourneren standaard CIDv1: CIDv1 base32-codering, 1 MiB-chunks, raw leaves — het IPIP-0499 unixfs-v1-2025-profiel. Praktische implicaties:

• Kleine bestanden (≤ 1 MiB) komen terug als bafk... (raw single-block CIDv1)
• Grotere bestanden en directory's komen terug als bafy... (dag-pb CIDv1)
• Een bestand dat via ons wordt geüpload krijgt dezelfde CID die elke moderne tool (Helia, de nieuwste Kubo, ipfs-car) zou berekenen vanuit dezelfde bytes

Achterwaartse compatibiliteit

Legacy Qm...-CID's van eerdere uploads blijven volledig oplosbaar — de gateway, POST /pin, GET /file/:cid, IPNS-resolvers, en elk ander endpoint accepteren beide formaten voor onbepaalde tijd. Als je een Qm...-CID hebt van een eerdere upload, blijft alles wat je hebt gebouwd werken.