Content Identifiers (CIDs)

Det unikke fingeraftryk, som hver IPFS-fil modtager.

Hvad er et CID?

En Content Identifier (CID) er en selvbeskrivende label, der entydigt identificerer et stykke data på IPFS. Den er afledt af den kryptografiske hash af filens indhold, kombineret med metadata om den anvendte hashalgoritme og kodningsformat.

bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi

CID'er, der starter med bafy (eller bafk for lille indhold i én blok), bruger CIDv1, det moderne selvbeskrivende format. Ældre CID'er, der starter med Qm, bruger CIDv0 (base58-kodet SHA-256) — stadig gyldige, stadig opløselige, men ikke længere standardoutputtet for nyt indhold.

Nøgleegenskaber

• Deterministisk — Den samme fil producerer altid det samme CID. Upload det samme billede to gange, og du får den samme identifikator.
• Unik — Selv en enkelt byte-ændring producerer et helt andet CID. Dette gør CID'er manipulationssikre.
• Selvverificerende — Enhver, der modtager en fil, kan genberegne hashen og bekræfte, at den matcher det anmodede CID.
• Uforanderlig — Et CID peger altid på det samme indhold. Du kan ikke ændre, hvad et CID opløser til.

CID'er i IPFS.NINJA

Hver fil, du uploader, returnerer et CID i API-svaret. Brug det til at:

• Tilgå filen via gateway: ipfs.ninja/ipfs/<CID>
• Hente filmetadata: GET /file/<CID>
• Referere til indhold on-chain (NFT'er, smarte kontrakter)
• Dele med alle — de kan verificere, at indholdet stemmer

CIDv0 vs CIDv1

Egenskab	CIDv0	CIDv1
Præfiks	Qm...	bafy... (dag-pb, mapper & filer i flere chunks), bafk... (raw, lille indhold i én blok), samt andre per codec
Hashfunktion	Kun SHA-256	Flere (SHA-256, Blake2b, osv.)
Kodning	Base58 (blandet store/små bogstaver)	Multibase — base32 som standard (små bogstaver, DNS-sikker)
Selvbeskrivende	Nej	Ja (inkluderer codec + hashinfo)
Chunker	256 KiB legacy standard	1 MiB per IPIP-0499
Leaf-kodning	Indpakket i dag-pb	Raw bytes (raw-leaves=true)

Hvad IPFS.NINJA udsender

Uploads og fastgørelser foretaget efter 2026-07-13 returnerer CIDv1 som standard: CIDv1 base32-kodning, 1 MiB-chunks, raw leaves — IPIP-0499 unixfs-v1-2025-profilen. Praktiske konsekvenser:

• Små filer (≤ 1 MiB) kommer tilbage som bafk... (raw CIDv1 i én blok)
• Større filer og mapper kommer tilbage som bafy... (dag-pb CIDv1)
• En fil uploadet via os får det samme CID, som ethvert moderne værktøj (Helia, seneste Kubo, ipfs-car) ville beregne ud fra de samme bytes

Bagudkompatibilitet

Ældre Qm...-CID'er fra tidligere uploads forbliver fuldt opløselige — gatewayen, POST /pin, GET /file/:cid, IPNS-resolvere og ethvert andet endpoint accepterer begge formater på ubestemt tid. Hvis du har et Qm...-CID fra en tidligere upload, holder intet, du har bygget, op med at virke.