Tartalomazonosítók (CID)

Az egyedi ujjlenyomat, amelyet minden IPFS fájl kap.

Mi az a CID?

A tartalomazonosító (CID) egy önleíró címke, amely egyedileg azonosít egy adatot az IPFS-en. A fájl tartalmának kriptográfiai hash-éből származik, kombinálva a használt hash-algoritmus és kódolási formátum metaadataival.

bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi

A bafy-vel kezdődő CID-ek (vagy bafk-val kis, egyblokkos tartalomhoz) a CIDv1-et, a modern önleíró formátumot használják. A Qm-mel kezdődő örökölt CID-ek a CIDv0-t (base58-kódolt SHA-256) használják — továbbra is érvényesek, továbbra is feloldhatók, de már nem az alapértelmezett kimenet az új tartalomhoz.

Főbb tulajdonságok

• Determinisztikus — Ugyanaz a fájl mindig ugyanazt a CID-et eredményezi. Töltse fel ugyanazt a képet kétszer, és ugyanazt az azonosítót kapja.
• Egyedi — Egyetlen bájt változása is teljesen más CID-et eredményez. Ez teszi a CID-eket hamisítás-ellenállóvá.
• Önigazoló — Bárki, aki megkapja a fájlt, újraszámíthatja a hash-t, és megerősítheti, hogy megegyezik a kért CID-del.
• Megváltoztathatatlan — Egy CID mindig ugyanarra a tartalomra mutat. Nem változtatható meg, mire mutat egy CID.

CID-ek az IPFS.NINJA-ban

Minden feltöltött fájl CID-et ad vissza az API válaszban. Használja a következőkre:

• Fájl elérése gateway-en keresztül: ipfs.ninja/ipfs/<CID>
• Fájl metaadatok lekérése: GET /file/<CID>
• Tartalom hivatkozása a láncon (NFT-k, okosszerződések)
• Megosztás bárkivel — ellenőrizhetik, hogy a tartalom megegyezik

CIDv0 vs CIDv1

Tulajdonság	CIDv0	CIDv1
Előtag	Qm...	bafy... (dag-pb, könyvtárak és több darabból álló fájlok), bafk... (raw, kis egyblokkos tartalom), és mások codec-enként
Hash függvény	Csak SHA-256	Több (SHA-256, Blake2b stb.)
Kódolás	Base58 (vegyes kis- és nagybetű)	Multibase — alapértelmezetten base32 (kisbetűs, DNS-biztos)
Önleíró	Nem	Igen (tartalmazza a codec + hash információt)
Darabolás	256 KiB örökölt alapérték	1 MiB az IPIP-0499 szerint
Leaf kódolás	dag-pb-be csomagolva	Nyers byte-ok (raw-leaves=true)

Amit az IPFS.NINJA kibocsát

A 2026-07-13 után készült feltöltések és rögzítések alapértelmezetten CIDv1-et adnak vissza: CIDv1 base32 kódolás, 1 MiB darabok, raw leaf-ek — az IPIP-0499 unixfs-v1-2025 profil. Gyakorlati következmények:

• A kis fájlok (≤ 1 MiB) bafk...-ként térnek vissza (raw egyblokkos CIDv1)
• A nagyobb fájlok és könyvtárak bafy...-ként térnek vissza (dag-pb CIDv1)
• A nálunk feltöltött fájl ugyanazt a CID-et kapja, amit bármely modern eszköz (Helia, legújabb Kubo, ipfs-car) ugyanazokból a byte-okból számítana

Visszafelé kompatibilitás

A korábbi feltöltésekből származó örökölt Qm... CID-ek mindenhol teljes mértékben feloldhatók maradnak — a gateway, a POST /pin, a GET /file/:cid, az IPNS feloldók és minden más végpont mindkét formátumot korlátlan ideig elfogadja. Ha van egy Qm... CID-je egy korábbi feltöltésből, semmi, amit épített, nem szűnik meg működni.