Sisältötunnisteet (CID)

Ainutlaatuinen sormenjälki, jonka jokainen IPFS-tiedosto saa.

Mikä on CID?

Sisältötunniste (CID) on itseään kuvaava tunniste, joka yksilöi tietyn datan IPFS:ssä. Se johdetaan tiedoston sisällön kryptografisesta tiivisteestä yhdistettynä metatietoihin käytetystä tiivistealgoritmista ja koodausmuodosta.

bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi

CID:t, jotka alkavat bafy:llä (tai bafk:lla pienelle yksilohkoiselle sisällölle), käyttävät CIDv1-tunnistetta, nykyaikaista itseään kuvaavaa muotoa. Vanhat CID:t, jotka alkavat Qm:llä, käyttävät CIDv0:aa (base58-koodattu SHA-256) — edelleen kelvollisia, edelleen ratkaistavissa, mutta eivät enää oletustulos uudelle sisällölle.

Avainominaisuudet

• Deterministinen — Sama tiedosto tuottaa aina saman CID:n. Lataa sama kuva kahdesti ja saat saman tunnisteen.
• Ainutlaatuinen — Jopa yhden tavun muutos tuottaa täysin erilaisen CID:n. Tämä tekee CID:eistä väärentämisen paljastavia.
• Itseverifioiva — Kuka tahansa, joka vastaanottaa tiedoston, voi laskea tiivisteen uudelleen ja vahvistaa, että se vastaa pyydettyä CID:tä.
• Muuttumaton — CID osoittaa aina samaan sisältöön. Et voi muuttaa, mihin CID viittaa.

CID:t IPFS.NINJA:ssa

Jokainen lataamasi tiedosto palauttaa CID:n API-vastauksessa. Käytä sitä:

• Tiedoston käyttämiseen gatewayn kautta: ipfs.ninja/ipfs/<CID>
• Tiedoston metatietojen hakemiseen: GET /file/<CID>
• Sisällön viittaamiseen lohkoketjussa (NFT:t, älysopimukset)
• Jakamiseen kenelle tahansa — he voivat varmistaa, että sisältö täsmää

CIDv0 vs CIDv1

Ominaisuus	CIDv0	CIDv1
Etuliite	Qm...	bafy... (dag-pb, hakemistot & moniosaiset tiedostot), bafk... (raw, pieni yksilohkoinen sisältö), sekä muita koodekin mukaan
Tiivistefunktio	Vain SHA-256	Useita (SHA-256, Blake2b jne.)
Koodaus	Base58 (sekoitetut kirjainkoot)	Multibase — base32 oletuksena (pienet kirjaimet, DNS-turvallinen)
Itseään kuvaava	Ei	Kyllä (sisältää codec + tiivistetiedot)
Lohkotin	256 KiB vanha oletus	1 MiB per IPIP-0499
Lehden koodaus	Kääritty dag-pb:hen	Raakatavut (raw-leaves=true)

Mitä IPFS.NINJA tuottaa

2026-07-13 jälkeen tehdyt lataukset ja kiinnitykset palauttavat CIDv1-tunnisteen oletuksena: CIDv1 base32-koodaus, 1 MiB:n lohkot, raakalehdet — IPIP-0499 unixfs-v1-2025 -profiili. Käytännön vaikutukset:

• Pienet tiedostot (≤ 1 MiB) palautuvat muodossa bafk... (raaka yksilohkoinen CIDv1)
• Suuremmat tiedostot ja hakemistot palautuvat muodossa bafy... (dag-pb CIDv1)
• Meidän kauttamme ladattu tiedosto saa saman CID:n, jonka mikä tahansa nykyaikainen työkalu (Helia, uusin Kubo, ipfs-car) laskisi samoista tavuista

Taaksepäin yhteensopivuus

Aiempien latausten vanhat Qm...-CID:t pysyvät täysin ratkaistavissa — gateway, POST /pin, GET /file/:cid, IPNS-ratkaisijat ja jokainen muu päätepiste hyväksyvät molempia muotoja toistaiseksi. Jos sinulla on Qm...-CID aiemmasta latauksesta, mikään rakentamasi ei lakkaa toimimasta.