Identificadores de Contenido (CIDs)

La huella digital única que recibe cada archivo en IPFS.

¿Qué es un CID?

Un Identificador de Contenido (CID) es una etiqueta auto-descriptiva que identifica de manera única un dato en IPFS. Se deriva del hash criptográfico del contenido del archivo, combinado con metadatos sobre el algoritmo de hash y el formato de codificación utilizados.

QmXk7VRz4qoG5Dg8sFL4bYWHpKe4F

Los CIDs que comienzan con Qm usan CIDv0 (SHA-256 codificado en base58). Los identificadores CIDv1 más nuevos comienzan con bafy y soportan múltiples funciones de hash y codificaciones.

Propiedades clave

• Determinístico — El mismo archivo siempre produce el mismo CID. Sube la misma imagen dos veces y obtendras el mismo identificador.
• Único — Incluso un cambio de un solo byte produce un CID completamente diferente. Esto hace que los CIDs sean a prueba de manipulación.
• Auto-verificable — Cualquiera que reciba un archivo puede recalcular el hash y confirmar que coincide con el CID que solicito.
• Inmutable — Un CID siempre apunta al mismo contenido. No puedes cambiar a que resuelve un CID.

CIDs en IPFS.NINJA

Cada archivo que subes devuelve un CID en la respuesta de la API. Usalo para:

• Acceder al archivo vía gateway: ipfs.ninja/ipfs/<CID>
• Recuperar metadatos del archivo: GET /file/<CID>
• Referenciar contenido on-chain (NFTs, contratos inteligentes)
• Compartir con cualquiera — pueden verificar que el contenido coincide

CIDv0 vs CIDv1

Propiedad	CIDv0	CIDv1
Prefijo	Qm...	bafy...
Función de hash	Solo SHA-256	Multiple (SHA-256, Blake2b, etc.)
Codificación	Base58	Multibase (base32, base58, etc.)
Auto-descriptivo	No	Si (incluye codec + info de hash)