Skip to content

Identyfikatory treści (CID)

Unikalny odcisk palca, który otrzymuje każdy plik IPFS.

Czym jest CID?

Identyfikator treści (CID) to samoopisowa etykieta, która jednoznacznie identyfikuje dane na IPFS. Pochodzi z kryptograficznego hasha zawartości pliku, w połączeniu z metadanymi o algorytmie hashowania i formacie kodowania.

QmXk7VRz4qoG5Dg8sFL4bYWHpKe4F

CID zaczynające się od Qm używają CIDv0 (SHA-256 zakodowany w base58). Nowsze identyfikatory CIDv1 zaczynają się od bafy i obsługują wiele funkcji hashujących i kodowań.

Kluczowe właściwości

  • Deterministyczny — Ten sam plik zawsze tworzy ten sam CID. Prześlij ten sam obraz dwa razy i otrzymasz ten sam identyfikator.
  • Unikalny — Nawet zmiana jednego bajtu tworzy zupełnie inny CID. To czyni CID odpornymi na manipulację.
  • Samoweryfikujący — Każdy, kto otrzyma plik, może ponownie obliczyć hash i potwierdzić, że pasuje do żądanego CID.
  • Niezmienny — CID zawsze wskazuje na tę samą treść. Nie możesz zmienić, na co CID rozwiązuje.

CID w IPFS.NINJA

Każdy przesłany plik zwraca CID w odpowiedzi API. Użyj go do:

  • Dostępu do pliku przez bramkę: ipfs.ninja/ipfs/<CID>
  • Pobrania metadanych pliku: GET /file/<CID>
  • Odwołania do treści on-chain (NFT, smart kontrakty)
  • Udostępniania komukolwiek — mogą zweryfikować, że treść się zgadza

CIDv0 vs CIDv1

WłaściwośćCIDv0CIDv1
PrefiksQm...bafy...
Funkcja hashującaTylko SHA-256Wiele (SHA-256, Blake2b, itp.)
KodowanieBase58Multibase (base32, base58, itp.)
SamoopisowyNieTak (zawiera codec + info o hashu)