Content Identifiers (CID)

Sidik jari unik yang diterima setiap file IPFS.

CIDv0 vs CIDv1: Pilih Format yang Tepat untuk Unggahan Anda

Properti	CIDv0	CIDv1
Prefix	Qm...	bafy... (dag-pb, direktori & file multi-chunk), bafk... (raw, konten satu-blok kecil), plus lainnya sesuai codec
Fungsi hash	Hanya SHA-256	Beragam (SHA-256, Blake2b, dll.)
Encoding	Base58 (huruf campuran)	Multibase — base32 secara default (huruf kecil, aman untuk DNS)
Self-describing	Tidak	Ya (mencakup info codec + hash)
Chunker	Default lama 256 KiB	1 MiB sesuai IPIP-0499
Encoding leaf	Dibungkus dalam dag-pb	Byte mentah (raw-leaves=true)

Apa yang dihasilkan IPFS.NINJA

Unggahan dan pin yang dibuat setelah 13-07-2026 mengembalikan CIDv1 secara default: pengkodean base32 CIDv1, chunk 1 MiB, raw leaves — profil IPIP-0499 unixfs-v1-2025. Implikasi praktisnya:

• File kecil (≤ 1 MiB) kembali sebagai bafk... (CIDv1 raw satu-blok)
• File dan direktori yang lebih besar kembali sebagai bafy... (CIDv1 dag-pb)
• File yang diunggah melalui kami mendapatkan CID yang sama seperti yang akan dihitung oleh alat modern mana pun (Helia, Kubo terbaru, ipfs-car) dari byte yang sama

Kompatibilitas mundur

CID Qm... lama dari unggahan sebelumnya tetap sepenuhnya dapat diresolusi — gateway, POST /pin, GET /file/:cid, resolver IPNS, dan setiap endpoint lainnya menerima kedua format tanpa batas waktu. Jika Anda memiliki CID Qm... dari unggahan sebelumnya, tidak ada yang sudah Anda buat berhenti berfungsi.

Apa itu CID?

Content Identifier (CID) adalah label yang mendeskripsikan dirinya sendiri (self-describing) yang secara unik mengidentifikasi sepotong data di IPFS. CID diturunkan dari hash kriptografis konten file, dikombinasikan dengan metadata tentang algoritma hashing dan format encoding yang digunakan.

bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi

CID yang dimulai dengan bafy (atau bafk untuk konten satu-blok kecil) menggunakan CIDv1, format self-describing modern. CID lama yang dimulai dengan Qm menggunakan CIDv0 (SHA-256 yang dienkode base58) — masih valid, masih dapat diresolusi, tetapi bukan lagi output default untuk konten baru.

Properti utama

• Deterministik — File yang sama selalu menghasilkan CID yang sama. Unggah gambar yang sama dua kali dan Anda mendapatkan identifier yang sama.
• Unik — Bahkan perubahan satu byte menghasilkan CID yang sepenuhnya berbeda. Ini membuat CID tamper-evident.
• Self-verifying — Siapa pun yang menerima file dapat menghitung ulang hash-nya dan mengonfirmasi bahwa hash tersebut cocok dengan CID yang mereka minta.
• Immutable — CID selalu menunjuk ke konten yang sama. Anda tidak dapat mengubah apa yang diresolusi oleh sebuah CID.

CID di IPFS.NINJA

Setiap file yang Anda unggah mengembalikan CID dalam respons API. Gunakan CID untuk:

• Mengakses file melalui gateway: ipfs.ninja/ipfs/<CID>
• Mengambil metadata file: GET /file/<CID>
• Mereferensikan konten on-chain (NFT, smart contract)
• Membagikan ke siapa pun — mereka dapat memverifikasi bahwa kontennya cocok

Lihat ikhtisar IPFS.NINJA untuk memahami bagaimana CID berperan dalam alur unggah. Pelajari cara nge-pin konten berdasarkan CID agar tetap dapat diakses secara permanen.