Satura identifikatori (CID)

Unikālais pirkstu nospiedums, ko saņem katrs IPFS fails.

Kas ir CID?

Satura identifikators (CID) ir pašaprakstoša etiķete, kas unikāli identificē datu daļu IPFS. Tas tiek atvasināts no faila satura kriptogrāfiskā jaucējkoda, kombinēts ar metadatiem par izmantoto jaukšanas algoritmu un kodēšanas formātu.

bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi

CID, kas sākas ar bafy (vai bafk mazam, viena bloka saturam), izmanto CIDv1 — moderno, pašaprakstošo formātu. Vecmodīgie CID, kas sākas ar Qm, izmanto CIDv0 (base58 kodēts SHA-256) — joprojām derīgi, joprojām atrisināmi, bet vairs nav noklusējuma izvade jaunam saturam.

Galvenās īpašības

• Deterministisks — Tas pats fails vienmēr ražo to pašu CID. Augšupielādējiet to pašu attēlu divreiz, un jūs saņemsiet to pašu identifikatoru.
• Unikāls — Pat viena baita maiņa ražo pilnīgi atšķirīgu CID. Tas padara CID par manipulāciju pierādījumu.
• Pašpārbaudošs — Ikviens, kas saņem failu, var pārrēķināt jaucējkodu un apstiprināt, ka tas atbilst pieprasītajam CID.
• Nemainīgs — CID vienmēr norāda uz to pašu saturu. Jūs nevarat mainīt, uz ko CID norāda.

CID IPFS.NINJA

Katrs augšupielādētais fails atgriež CID API atbildē. Izmantojiet to, lai:

• Piekļūtu failam caur gateway: ipfs.ninja/ipfs/<CID>
• Izgūtu faila metadatus: GET /file/<CID>
• Atsauktos uz saturu blokķēdē (NFT, viedie līgumi)
• Kopīgotu ar jebkuru — viņi var pārbaudīt, ka saturs atbilst

CIDv0 vs CIDv1

Īpašība	CIDv0	CIDv1
Prefikss	Qm...	bafy... (dag-pb, direktorijas un vairāku gabalu faili), bafk... (raw, mazs viena bloka saturs), un citi atkarībā no kodeka
Jaukšanas funkcija	Tikai SHA-256	Vairākas (SHA-256, Blake2b utt.)
Kodējums	Base58 (jaukts reģistrs)	Multibase — pēc noklusējuma base32 (mazie burti, DNS droši)
Pašaprakstošs	Nē	Jā (ietver kodeka + jaukšanas informāciju)
Gabalu veidotājs	256 KiB vecmodīgais noklusējums	1 MiB saskaņā ar IPIP-0499
Lapu kodējums	Ietīts dag-pb	Neapstrādāti baiti (raw-leaves=true)

Ko izvada IPFS.NINJA

Augšupielādes un piespraušanas, kas veiktas pēc 2026-07-13, pēc noklusējuma atgriež CIDv1: CIDv1 base32 kodējums, 1 MiB gabali, raw leaves — IPIP-0499 unixfs-v1-2025 profils. Praktiskās sekas:

• Mazi faili (≤ 1 MiB) atgriežas kā bafk... (raw viena bloka CIDv1)
• Lielāki faili un direktorijas atgriežas kā bafy... (dag-pb CIDv1)
• Caur mums augšupielādēts fails iegūst to pašu CID, ko jebkurš mūsdienīgs rīks (Helia, jaunākais Kubo, ipfs-car) aprēķinātu tiem pašiem baitiem

Atpakaļejoša saderība

Vecmodīgie Qm... CID no iepriekšējām augšupielādēm joprojām pilnībā atrisinās — gateway, POST /pin, GET /file/:cid, IPNS atrisinātāji un katrs cits galapunkts pieņem abus formātus bezgalīgi. Ja jums ir Qm... CID no iepriekšējas augšupielādes, nekas, ko esat izveidojis, nepārstāj darboties.