Content Identifiers (CIDs)

Der einzigartige Fingerabdruck, den jede IPFS-Datei erhält.

Was ist ein CID?

Ein Content Identifier (CID) ist ein selbstbeschreibendes Label, das ein Datenstück auf IPFS eindeutig identifiziert. Er wird aus dem kryptographischen Hash des Dateiinhalts abgeleitet, kombiniert mit Metadaten über den verwendeten Hash-Algorithmus und das Kodierungsformat.

QmXk7VRz4qoG5Dg8sFL4bYWHpKe4F

CIDs, die mit Qm beginnen, verwenden CIDv0 (base58-kodierter SHA-256). Neuere CIDv1-Identifier beginnen mit bafy und unterstützen mehrere Hash-Funktionen und Kodierungen.

Schlüsseleigenschaften

• Deterministisch — Dieselbe Datei erzeugt immer denselben CID. Laden Sie dasselbe Bild zweimal hoch und Sie erhalten denselben Identifier.
• Einzigartig — Selbst eine Änderung von einem Byte erzeugt einen völlig anderen CID. Das macht CIDs manipulationssicher.
• Selbstverifizierend — Jeder, der eine Datei empfängt, kann den Hash neu berechnen und bestätigen, dass er mit dem angeforderten CID übereinstimmt.
• Unveränderlich — Ein CID verweist immer auf denselben Inhalt. Sie können nicht ändern, worauf ein CID auflöst.

CIDs bei IPFS.NINJA

Jede hochgeladene Datei gibt einen CID in der API-Antwort zurück. Verwenden Sie ihn, um:

• Auf die Datei über das Gateway zuzugreifen: ipfs.ninja/ipfs/<CID>
• Datei-Metadaten abzurufen: GET /file/<CID>
• Inhalte on-chain zu referenzieren (NFTs, Smart Contracts)
• Mit anderen zu teilen — sie können überprüfen, ob der Inhalt übereinstimmt

CIDv0 vs CIDv1

Eigenschaft	CIDv0	CIDv1
Präfix	Qm...	bafy...
Hash-Funktion	Nur SHA-256	Mehrere (SHA-256, Blake2b usw.)
Kodierung	Base58	Multibase (base32, base58 usw.)
Selbstbeschreibend	Nein	Ja (enthält Codec- + Hash-Informationen)