Identificatori de conținut (CID-uri)

Amprenta unică pe care fiecare fișier IPFS o primește.

Ce este un CID?

Un identificator de conținut (CID) este o etichetă auto-descriptivă care identifică în mod unic o bucată de date pe IPFS. Este derivat din hash-ul criptografic al conținutului fișierului, combinat cu metadate despre algoritmul de hashing și formatul de codificare folosite.

bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi

CID-urile care încep cu bafy (sau bafk pentru conținut mic, cu un singur bloc) folosesc CIDv1, formatul modern auto-descriptiv. CID-urile vechi care încep cu Qm folosesc CIDv0 (SHA-256 codificat base58) — încă valide, încă rezolvabile, dar nu mai sunt formatul implicit pentru conținut nou.

Proprietăți cheie

• Determinist — Același fișier produce întotdeauna același CID. Încărcați aceeași imagine de două ori și obțineți același identificator.
• Unic — Chiar și o modificare de un octet produce un CID complet diferit. Aceasta face CID-urile rezistente la falsificare.
• Auto-verificabil — Oricine primește un fișier poate recalcula hash-ul și confirma că se potrivește cu CID-ul solicitat.
• Imuabil — Un CID arată întotdeauna spre același conținut. Nu puteți schimba spre ce rezolvă un CID.

CID-uri în IPFS.NINJA

Fiecare fișier pe care îl încărcați returnează un CID în răspunsul API. Folosiți-l pentru:

• Accesarea fișierului prin gateway: ipfs.ninja/ipfs/<CID>
• Obținerea metadatelor fișierului: GET /file/<CID>
• Referirea conținutului on-chain (NFT-uri, contracte inteligente)
• Partajarea cu oricine — pot verifica dacă conținutul se potrivește

CIDv0 vs CIDv1

Proprietate	CIDv0	CIDv1
Prefix	Qm...	bafy... (dag-pb, directoare & fișiere multi-bloc), bafk... (raw, conținut mic cu un singur bloc), plus altele per codec
Funcție hash	Doar SHA-256	Multiple (SHA-256, Blake2b etc.)
Codificare	Base58 (litere mari și mici)	Multibase — base32 implicit (litere mici, sigur pentru DNS)
Auto-descriptiv	Nu	Da (include codec + info hash)
Chunker	Implicit vechi de 256 KiB	1 MiB conform IPIP-0499
Codificarea frunzelor	Împachetat în dag-pb	Octeți bruți (raw-leaves=true)

Ce emite IPFS.NINJA

Încărcările și fixările făcute după 2026-07-13 returnează CIDv1 în mod implicit: codificare base32 CIDv1, bucăți de 1 MiB, frunze brute — profilul IPIP-0499 unixfs-v1-2025. Implicații practice:

• Fișierele mici (≤ 1 MiB) revin ca bafk... (CIDv1 raw, un singur bloc)
• Fișierele mai mari și directoarele revin ca bafy... (CIDv1 dag-pb)
• Un fișier încărcat prin serviciul nostru primește același CID pe care l-ar calcula orice unealtă modernă (Helia, ultimul Kubo, ipfs-car) din aceiași octeți

Compatibilitate retroactivă

CID-urile vechi Qm... din încărcările anterioare rămân complet rezolvabile — gateway-ul, POST /pin, GET /file/:cid, resolverele IPNS și fiecare alt endpoint acceptă ambele formate pe termen nelimitat. Dacă aveți un CID Qm... dintr-o încărcare anterioară, nimic din ce ați construit nu încetează să funcționeze.