Identificadores de Conteúdo (CIDs)

A impressão digital única que cada arquivo IPFS recebe.

O que é um CID?

Um Identificador de Conteúdo (CID) é um rótulo autodescritivo que identifica de forma única um dado no IPFS. Ele é derivado do hash criptográfico do conteúdo do arquivo, combinado com metadados sobre o algoritmo de hash e o formato de codificação usados.

bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi

CIDs que começam com bafy (ou bafk para conteúdo pequeno de bloco único) usam CIDv1, o formato moderno e autodescritivo. CIDs legados que começam com Qm usam CIDv0 (SHA-256 codificado em base58) — ainda válidos, ainda resolvíveis, mas não são mais a saída padrão para conteúdo novo.

Propriedades principais

• Determinístico — O mesmo arquivo sempre produz o mesmo CID. Envie a mesma imagem duas vezes e você obterá o mesmo identificador.
• Único — Mesmo uma alteração de um único byte produz um CID completamente diferente. Isso torna os CIDs à prova de adulteração.
• Autoverificável — Qualquer pessoa que receba um arquivo pode recalcular o hash e confirmar que ele corresponde ao CID solicitado.
• Imutável — Um CID sempre aponta para o mesmo conteúdo. Você não pode alterar para o que um CID resolve.

CIDs no IPFS.NINJA

Cada arquivo que você envia retorna um CID na resposta da API. Use-o para:

• Acessar o arquivo via gateway: ipfs.ninja/ipfs/<CID>
• Recuperar metadados do arquivo: GET /file/<CID>
• Referenciar conteúdo on-chain (NFTs, contratos inteligentes)
• Compartilhar com qualquer pessoa — ela poderá verificar que o conteúdo corresponde

CIDv0 vs CIDv1

Propriedade	CIDv0	CIDv1
Prefixo	Qm...	bafy... (dag-pb, diretórios e arquivos multi-bloco), bafk... (raw, conteúdo pequeno de bloco único), entre outros por codec
Função de hash	Apenas SHA-256	Múltiplas (SHA-256, Blake2b, etc.)
Codificação	Base58 (maiúsculas e minúsculas misturadas)	Multibase — base32 por padrão (minúsculas, seguro para DNS)
Autodescritivo	Não	Sim (inclui codec + informações de hash)
Chunker	256 KiB (padrão legado)	1 MiB conforme o IPIP-0499
Codificação de folhas	Envolvida em dag-pb	Bytes crus (raw-leaves=true)

O que o IPFS.NINJA emite

Uploads e fixações feitos após 13/07/2026 retornam CIDv1 por padrão: codificação CIDv1 em base32, blocos de 1 MiB, raw leaves — o perfil IPIP-0499 unixfs-v1-2025. Implicações práticas:

• Arquivos pequenos (≤ 1 MiB) voltam como bafk... (CIDv1 raw de bloco único)
• Arquivos e diretórios maiores voltam como bafy... (CIDv1 dag-pb)
• Um arquivo enviado através de nós recebe o mesmo CID que qualquer ferramenta moderna (Helia, o Kubo mais recente, ipfs-car) computaria a partir dos mesmos bytes

Compatibilidade retroativa

CIDs Qm... legados de uploads anteriores continuam totalmente resolvíveis — o gateway, POST /pin, GET /file/:cid, os resolvedores IPNS e todos os outros endpoints aceitam ambos os formatos indefinidamente. Se você tem um CID Qm... de um upload anterior, nada do que você construiu deixa de funcionar.