Αναγνωριστικά Περιεχομένου (CIDs)

Το μοναδικό αποτύπωμα που λαμβάνει κάθε αρχείο IPFS.

Τι είναι ένα CID;

Ένα Content Identifier (CID) είναι μια αυτο-περιγραφόμενη ετικέτα που προσδιορίζει μοναδικά ένα κομμάτι δεδομένων στο IPFS. Προκύπτει από το κρυπτογραφικό hash του περιεχομένου του αρχείου, σε συνδυασμό με μεταδεδομένα σχετικά με τον αλγόριθμο κατακερματισμού (hashing) και τη μορφή κωδικοποίησης που χρησιμοποιήθηκαν.

bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi

Τα CID που ξεκινούν με bafy (ή bafk για μικρό περιεχόμενο ενός block) χρησιμοποιούν το CIDv1, τη σύγχρονη αυτο-περιγραφόμενη μορφή. Τα παλαιά CID που ξεκινούν με Qm χρησιμοποιούν το CIDv0 (SHA-256 κωδικοποιημένο σε base58) — παραμένουν έγκυρα και επιλύσιμα, αλλά δεν αποτελούν πλέον την προεπιλεγμένη έξοδο για νέο περιεχόμενο.

Βασικά χαρακτηριστικά

• Ντετερμινιστικό — Το ίδιο αρχείο παράγει πάντα το ίδιο CID. Ανεβάστε την ίδια εικόνα δύο φορές και θα λάβετε το ίδιο αναγνωριστικό.
• Μοναδικό — Ακόμα και μια αλλαγή ενός byte παράγει ένα εντελώς διαφορετικό CID. Αυτό καθιστά τα CID ανθεκτικά σε παραποίηση.
• Αυτο-επαληθεύσιμο — Όποιος λάβει ένα αρχείο μπορεί να υπολογίσει ξανά το hash και να επιβεβαιώσει ότι ταιριάζει με το CID που ζήτησε.
• Αμετάβλητο — Ένα CID δείχνει πάντα στο ίδιο περιεχόμενο. Δεν μπορείτε να αλλάξετε σε τι αντιστοιχεί ένα CID.

CIDs στο IPFS.NINJA

Κάθε αρχείο που ανεβάζετε επιστρέφει ένα CID στην απάντηση του API. Χρησιμοποιήστε το για να:

• Αποκτήσετε πρόσβαση στο αρχείο μέσω gateway: ipfs.ninja/ipfs/<CID>
• Ανακτήσετε μεταδεδομένα αρχείου: GET /file/<CID>
• Αναφέρετε περιεχόμενο on-chain (NFTs, smart contracts)
• Το μοιραστείτε με οποιονδήποτε — μπορεί να επαληθεύσει ότι το περιεχόμενο ταιριάζει

CIDv0 έναντι CIDv1

Ιδιότητα	CIDv0	CIDv1
Πρόθεμα	Qm...	bafy... (dag-pb, κατάλογοι & αρχεία πολλαπλών τμημάτων), bafk... (raw, μικρό περιεχόμενο ενός block), συν άλλα ανά codec
Συνάρτηση hash	Μόνο SHA-256	Πολλαπλές (SHA-256, Blake2b, κ.λπ.)
Κωδικοποίηση	Base58 (μικτά κεφαλαία/πεζά)	Multibase — base32 από προεπιλογή (πεζά, ασφαλές για DNS)
Αυτο-περιγραφόμενο	Όχι	Ναι (περιλαμβάνει πληροφορίες codec + hash)
Τμηματοποιητής (Chunker)	256 KiB παλαιά προεπιλογή	1 MiB σύμφωνα με το IPIP-0499
Κωδικοποίηση φύλλων	Τυλιγμένο σε dag-pb	Ακατέργαστα bytes (raw-leaves=true)

Τι εκπέμπει το IPFS.NINJA

Τα uploads και τα pins που γίνονται μετά τις 2026-07-13 επιστρέφουν CIDv1 από προεπιλογή: κωδικοποίηση CIDv1 base32, τμήματα (chunks) του 1 MiB, raw leaves — το προφίλ IPIP-0499 unixfs-v1-2025. Πρακτικές επιπτώσεις:

• Τα μικρά αρχεία (≤ 1 MiB) επιστρέφουν ως bafk... (raw CIDv1 ενός block)
• Τα μεγαλύτερα αρχεία και οι κατάλογοι επιστρέφουν ως bafy... (dag-pb CIDv1)
• Ένα αρχείο που ανεβαίνει μέσω εμάς λαμβάνει το ίδιο CID που θα υπολόγιζε οποιοδήποτε σύγχρονο εργαλείο (Helia, το πιο πρόσφατο Kubo, ipfs-car) από τα ίδια bytes

Συμβατότητα με παλαιότερες εκδόσεις

Τα παλαιά CID Qm... από προηγούμενα uploads παραμένουν πλήρως επιλύσιμα — το gateway, το POST /pin, το GET /file/:cid, οι IPNS resolvers και κάθε άλλο endpoint δέχονται και τις δύο μορφές επ' αόριστον. Αν έχετε ένα CID Qm... από παλαιότερο upload, τίποτα από όσα έχετε φτιάξει δεν σταματά να λειτουργεί.