Innholdsidentifikatorer (CID-er)

Det unike fingeravtrykket hver IPFS-fil mottar.

CIDv0 vs CIDv1: Sammenligning av IPFS-formater

Egenskap	CIDv0	CIDv1
Prefiks	Qm...	bafy... (dag-pb, kataloger og filer med flere biter), bafk... (raw, lite innhold i én blokk), pluss andre per codec
Hashfunksjon	Kun SHA-256	Flere (SHA-256, Blake2b, osv.)
Koding	Base58 (blandet store/små bokstaver)	Multibase — base32 som standard (små bokstaver, DNS-trygt)
Selvbeskrivende	Nei	Ja (inkluderer codec + hashinfo)
Chunker	256 KiB, eldre standard	1 MiB per IPIP-0499
Bladkoding	Pakket inn i dag-pb	Rå bytes (raw-leaves=true)

Hva IPFS.NINJA sender ut

Opplastinger og festinger gjort etter 2026-07-13 returnerer CIDv1 som standard: CIDv1 base32-koding, 1 MiB-biter, rå blader — IPIP-0499 unixfs-v1-2025-profilen. Praktiske konsekvenser:

• Små filer (≤ 1 MiB) kommer tilbake som bafk... (rå CIDv1 i én blokk)
• Større filer og kataloger kommer tilbake som bafy... (dag-pb CIDv1)
• En fil lastet opp gjennom oss får samme CID som ethvert moderne verktøy (Helia, nyeste Kubo, ipfs-car) ville beregnet fra de samme bytene

Bakoverkompatibilitet

Eldre Qm...-CID-er fra tidligere opplastinger forblir fullt oppløselige — gatewayen, POST /pin, GET /file/:cid, IPNS-resolvere og alle andre endepunkter godtar begge formatene på ubestemt tid. Hvis du har en Qm...-CID fra en tidligere opplasting, slutter ingenting du har bygget å fungere.

Hva er et CID?

En innholdsidentifikator (CID) er en selvbeskrivende etikett som unikt identifiserer en dataenhet på IPFS. Den er utledet fra den kryptografiske hashen av filens innhold, kombinert med metadata om hashalgoritmen og kodingsformatet som brukes.

bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi

CID-er som starter med bafy (eller bafk for lite innhold i én blokk) bruker CIDv1, det moderne selvbeskrivende formatet. Eldre CID-er som starter med Qm bruker CIDv0 (base58-kodet SHA-256) — fortsatt gyldig, fortsatt oppløselig, men ikke lenger standardutdataen for nytt innhold.

Nøkkelegenskaper

• Deterministisk — Samme fil produserer alltid samme CID. Last opp samme bilde to ganger, og du får samme identifikator.
• Unik — Selv en enkelt byte-endring produserer et helt annet CID. Dette gjør CID-er manipulasjonssikre.
• Selvverifiserende — Alle som mottar en fil kan beregne hashen på nytt og bekrefte at den matcher det forespurte CID-et.
• Uforanderlig — Et CID peker alltid på det samme innholdet. Du kan ikke endre hva et CID løser til.

CID-er i IPFS.NINJA

Hver fil du laster opp returnerer et CID i API-svaret. Bruk det til å:

• Få tilgang til filen via gateway: ipfs.ninja/ipfs/<CID>
• Hente filmetadata: GET /file/<CID>
• Referere til innhold on-chain (NFT-er, smarte kontrakter)
• Dele med hvem som helst — de kan verifisere at innholdet stemmer

Se oversikten over IPFS.NINJA for å forstå hvordan CID-er passer inn i opplastingsflyten. Lær hvordan du fester innhold basert på CID slik at det forblir permanent tilgjengelig.