Mga Content Identifier (CID)

Ang natatanging fingerprint na natatanggap ng bawat IPFS file.

Ano ang CID?

Ang Content Identifier (CID) ay isang self-describing na label na natatanging nagpapakilala sa isang piraso ng data sa IPFS. Nagmula ito sa cryptographic hash ng nilalaman ng file, kasama ang metadata tungkol sa hashing algorithm at encoding format na ginamit.

QmXk7VRz4qoG5Dg8sFL4bYWHpKe4F

Ang mga CID na nagsisimula sa Qm ay gumagamit ng CIDv0 (base58-encoded SHA-256). Ang mas bagong CIDv1 identifier ay nagsisimula sa bafy at sumusuporta ng maraming hash function at encoding.

Mga pangunahing katangian

• Deterministic — Ang parehong file ay palaging gumagawa ng parehong CID. Mag-upload ng parehong imahe nang dalawang beses at makakakuha ka ng parehong identifier.
• Natatangi — Kahit isang byte na pagbabago ay gumagawa ng ganap na kaibang CID. Ginagawa nitong tamper-evident ang mga CID.
• Self-verifying — Sinumang makatanggap ng file ay maaaring i-recompute ang hash at kumpirmahing tumutugma ito sa CID na hiniling nila.
• Immutable — Ang CID ay palaging nakaturo sa parehong nilalaman. Hindi mo mababago kung ano ang nire-resolve ng CID.

Mga CID sa IPFS.NINJA

Bawat file na ina-upload mo ay nagbabalik ng CID sa API response. Gamitin ito para:

• I-access ang file sa pamamagitan ng gateway: ipfs.ninja/ipfs/<CID>
• Kunin ang file metadata: GET /file/<CID>
• I-reference ang nilalaman on-chain (mga NFT, smart contract)
• Ibahagi sa kahit sino — ma-verify nila na tumutugma ang nilalaman

CIDv0 vs CIDv1

Katangian	CIDv0	CIDv1
Prefix	Qm...	bafy...
Hash function	SHA-256 lang	Marami (SHA-256, Blake2b, atbp.)
Encoding	Base58	Multibase (base32, base58, atbp.)
Self-describing	Hindi	Oo (kasama ang codec + hash info)