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 auto-descritivo 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 é o formato de codificação utilizados.

QmXk7VRz4qoG5Dg8sFL4bYWHpKe4F

CIDs que começam com Qm usam CIDv0 (SHA-256 codificado em base58). Identificadores CIDv1 mais recentes começam com bafy e suportam múltiplas funções de hash e codificacoes.

Propriedades principais

• Deterministico — O mesmo arquivo sempre produz o mesmo CID. Faça upload da mesma imagem duas vezes e você recebera o mesmo identificador.
• Único — Mesmo uma alteração de um byte produz um CID completamente diferente. Isso torna os CIDs a prova de adulteração.
• Auto-verificavel — 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 — eles podem verificar que o conteúdo corresponde

CIDv0 vs CIDv1

Propriedade	CIDv0	CIDv1
Prefixo	Qm...	bafy...
Função de hash	Apenas SHA-256	Multiplas (SHA-256, Blake2b, etc.)
Codificação	Base58	Multibase (base32, base58, etc.)
Auto-descritivo	Não	Sim (inclui codec + info de hash)