콘텐츠 식별자 (CID)

모든 IPFS 파일이 받는 고유한 핑거프린트입니다.

CID란 무엇인가요?

콘텐츠 식별자(CID)는 IPFS에서 데이터를 고유하게 식별하는 자기 기술형 라벨입니다. 파일 내용의 암호학적 해시와 사용된 해싱 알고리즘 및 인코딩 형식에 대한 메타데이터를 결합하여 파생됩니다.

QmXk7VRz4qoG5Dg8sFL4bYWHpKe4F

Qm으로 시작하는 CID는 CIDv0(base58 인코딩 SHA-256)을 사용합니다. 최신 CIDv1 식별자는 bafy로 시작하며 여러 해시 함수와 인코딩을 지원합니다.

핵심 속성

• 결정론적 — 동일한 파일은 항상 동일한 CID를 생성합니다. 같은 이미지를 두 번 업로드해도 동일한 식별자를 받습니다.
• 고유성 — 1바이트의 변경만으로도 완전히 다른 CID가 생성됩니다. 이는 CID를 변조 방지 가능하게 합니다.
• 자체 검증 — 파일을 받은 누구나 해시를 다시 계산하여 요청한 CID와 일치하는지 확인할 수 있습니다.
• 불변성 — CID는 항상 동일한 콘텐츠를 가리킵니다. CID가 해석하는 대상을 변경할 수 없습니다.

IPFS.NINJA에서의 CID

업로드한 모든 파일은 API 응답에서 CID를 반환합니다. 이를 사용하여:

• 게이트웨이를 통해 파일에 접근: ipfs.ninja/ipfs/<CID>
• 파일 메타데이터 조회: GET /file/<CID>
• 온체인에서 콘텐츠 참조 (NFT, 스마트 컨트랙트)
• 누구와든 공유 — 콘텐츠가 일치하는지 검증 가능

CIDv0 vs CIDv1

속성	CIDv0	CIDv1
접두사	Qm...	bafy...
해시 함수	SHA-256만	다중 (SHA-256, Blake2b 등)
인코딩	Base58	Multibase (base32, base58 등)
자기 기술형	아니요	예 (코덱 + 해시 정보 포함)