Sisuidentifikaatorid (CID)

Unikaalne sõrmejälg, mille iga IPFS-fail saab.

Mis on CID?

Sisuidentifikaator (CID) on ennastkirjeldav silt, mis identifitseerib unikaalselt andmete osa IPFS-is. See tuleneb faili sisu krüptograafilisest räsist, kombineerituna metaandmetega kasutatud räsialgoritmi ja kodeerimisformaadi kohta.

bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi

CID-d, mis algavad bafy-ga (või bafk-ga väikese üheplokilise sisu jaoks), kasutavad CIDv1-i, kaasaegset ennastkirjeldavat formaati. Varasemad CID-d, mis algavad Qm-ga, kasutavad CIDv0-d (base58-kodeeritud SHA-256) — ikka kehtivad, ikka lahendatavad, kuid pole enam vaikimisi väljund uue sisu jaoks.

Põhiomadused

• Deterministlik — Sama fail toodab alati sama CID. Laadige sama pilt kaks korda üles ja saate sama identifikaatori.
• Unikaalne — Isegi ühebaidiline muudatus toodab täiesti erineva CID. See muudab CID-d võltsimiskindlaks.
• Isekontrolliv — Igaüks, kes faili vastu võtab, saab räsi uuesti arvutada ja kinnitada, et see vastab küsitud CID-le.
• Muutumatu — CID osutab alati samale sisule. Te ei saa muuta, millele CID viitab.

CID-d IPFS.NINJA-s

Iga üleslaaditud fail tagastab CID API vastuses. Kasutage seda, et:

• Pääseda failile ligi gateway kaudu: ipfs.ninja/ipfs/<CID>
• Hankida faili metaandmeid: GET /file/<CID>
• Viidata sisule plokiahelas (NFT-d, nutikad lepingud)
• Jagada kellegagi — nad saavad kontrollida, et sisu vastab

CIDv0 vs CIDv1

Omadus	CIDv0	CIDv1
Eesliide	Qm...	bafy... (dag-pb, kataloogid ja mitmeplokilised failid), bafk... (raw, väike üheplokiline sisu), pluss teised vastavalt koodekile
Räsifunktsioon	Ainult SHA-256	Mitu (SHA-256, Blake2b jne)
Kodeering	Base58 (segatud tõstuga)	Multibase — vaikimisi base32 (väiketähed, DNS-turvaline)
Ennastkirjeldav	Ei	Jah (sisaldab codec + räsiinfot)
Tükeldaja	256 KiB vanapärane vaikeväärtus	1 MiB vastavalt IPIP-0499-le
Lehe kodeering	Mähitud dag-pb-sse	Toorbaidid (raw-leaves=true)

Mida IPFS.NINJA väljastab

Üleslaadimised ja kinnitused, mis on tehtud pärast 2026-07-13, tagastavad vaikimisi CIDv1: CIDv1 base32 kodeering, 1 MiB tükid, toorlehed — IPIP-0499 unixfs-v1-2025 profiil. Praktilised tagajärjed:

• Väikesed failid (≤ 1 MiB) tulevad tagasi kui bafk... (toor üheplokiline CIDv1)
• Suuremad failid ja kataloogid tulevad tagasi kui bafy... (dag-pb CIDv1)
• Meie kaudu üles laaditud fail saab sama CID-i, mille iga kaasaegne tööriist (Helia, uusim Kubo, ipfs-car) samadest baitidest arvutaks

Tagasiühilduvus

Varasemate üleslaadimiste vanapärased Qm... CID-d jäävad täielikult lahendatavaks — gateway, POST /pin, GET /file/:cid, IPNS lahendajad ja iga muu lõpp-punkt aktsepteerivad mõlemat formaati määramatult kaua. Kui teil on Qm... CID varasemast üleslaadimisest, ei lakka miski, mille te ehitasite, töötamast.