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 autodescriptiva 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.

bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi

Los CIDs que comienzan con bafy (o bafk para contenido pequeño de un solo bloque) usan CIDv1, el formato moderno autodescriptivo. Los CIDs heredados que comienzan con Qm usan CIDv0 (SHA-256 codificado en base58) — siguen siendo válidos, siguen siendo resolubles, pero ya no son la salida por defecto para contenido nuevo.

Propiedades clave

• Determinístico — El mismo archivo siempre produce el mismo CID. Sube la misma imagen dos veces y obtendrás 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.
• Autoverificable — Cualquiera que reciba un archivo puede recalcular el hash y confirmar que coincide con el CID que solicitó.
• Inmutable — Un CID siempre apunta al mismo contenido. No puedes cambiar a qué resuelve un CID.

CIDs en IPFS.NINJA

Cada archivo que subes devuelve un CID en la respuesta de la API. Úsalo 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... (dag-pb, directorios y archivos multi-bloque), bafk... (raw, contenido pequeño de un solo bloque), y otros según el codec
Función de hash	Solo SHA-256	Múltiple (SHA-256, Blake2b, etc.)
Codificación	Base58 (mayúsculas y minúsculas mezcladas)	Multibase — base32 por defecto (minúsculas, segura para DNS)
Autodescriptivo	No	Sí (incluye codec + info de hash)
Chunker	256 KiB por defecto heredado	1 MiB según IPIP-0499
Codificación de hojas	Envuelta en dag-pb	Bytes en crudo (raw-leaves=true)

Qué emite IPFS.NINJA

Las subidas y fijaciones realizadas después del 13-07-2026 devuelven CIDv1 por defecto: codificación CIDv1 en base32, fragmentos de 1 MiB, raw leaves — el perfil IPIP-0499 unixfs-v1-2025. Implicaciones prácticas:

• Los archivos pequeños (≤ 1 MiB) vuelven como bafk... (CIDv1 raw de un solo bloque)
• Los archivos y directorios más grandes vuelven como bafy... (CIDv1 dag-pb)
• Un archivo subido a través de nosotros obtiene el mismo CID que calcularía cualquier herramienta moderna (Helia, el último Kubo, ipfs-car) a partir de los mismos bytes

Compatibilidad con versiones anteriores

Los CIDs Qm... heredados de subidas anteriores siguen siendo totalmente resolubles — el gateway, POST /pin, GET /file/:cid, los resolutores de IPNS y todos los demás endpoints aceptan ambos formatos indefinidamente. Si tienes un CID Qm... de una subida anterior, nada de lo que construiste deja de funcionar.