Content Identifier (CID)

L'impronta digitale unica che ogni file IPFS riceve.

Cos'e' un CID?

Un Content Identifier (CID) e' un'etichetta auto-descrittiva che identifica univocamente un dato su IPFS. Deriva dall'hash crittografico del contenuto del file, combinato con metadati sull'algoritmo di hashing e il formato di codifica utilizzati.

QmXk7VRz4qoG5Dg8sFL4bYWHpKe4F

I CID che iniziano con Qm usano CIDv0 (SHA-256 codificato in base58). I piu' recenti identificatori CIDv1 iniziano con bafy e supportano molteplici funzioni hash e codifiche.

Proprieta' chiave

• Deterministico — Lo stesso file produce sempre lo stesso CID. Carica la stessa immagine due volte e ottieni lo stesso identificatore.
• Unico — Anche una modifica di un singolo byte produce un CID completamente diverso. Questo rende i CID a prova di manomissione.
• Auto-verificabile — Chiunque riceva un file puo' ricalcolare l'hash e confermare che corrisponde al CID richiesto.
• Immutabile — Un CID punta sempre allo stesso contenuto. Non puoi cambiare a cosa un CID si risolve.

CID in IPFS.NINJA

Ogni file che carichi restituisce un CID nella risposta API. Usalo per:

• Accedere al file tramite gateway: ipfs.ninja/ipfs/<CID>
• Recuperare i metadati del file: GET /file/<CID>
• Fare riferimento al contenuto on-chain (NFT, smart contract)
• Condividere con chiunque — possono verificare che il contenuto corrisponda

CIDv0 vs CIDv1

Proprieta'	CIDv0	CIDv1
Prefisso	Qm...	bafy...
Funzione hash	Solo SHA-256	Multiple (SHA-256, Blake2b, ecc.)
Codifica	Base58	Multibase (base32, base58, ecc.)
Auto-descrittivo	No	Si' (include codec + info hash)