Enum ClassifiedCid 

pub enum ClassifiedCid {
    Content(ContentId),
    Raw(RawContentId),
    Foreign(ForeignCid),
}

A CID classified by profile. See the module docs for the canonical form invariant.

Variants

Content(ContentId)

This crate’s dag-cbor profile: the identity of a canonical structured value. Mintable.

Raw(RawContentId)

This crate’s raw profile: the identity of an opaque byte string. Mintable.

Foreign(ForeignCid)

A well-formed CID of any other profile (another codec, another hash such as sha2-256 0x12, another digest length, or CIDv0), validated by ForeignCid so it can never alias a recognized profile.

Implementations

impl ClassifiedCid

pub fn from_cid(cid: Cid) -> Self

Classify an already-parsed Cid. Infallible: every well-formed CID is exactly one of the three kinds.

pub fn from_bytes(bytes: &[u8]) -> Result<Self, ContentError>

Parse the CID binary envelope and classify.

Errors

ContentError::InvalidCid if the bytes are not a CID at all. A CID of a foreign profile is not an error — it is Foreign.

pub fn as_cid(&self) -> &Cid

Borrow the underlying Cid, whichever variant.

pub fn to_bytes(&self) -> Vec<u8>

The full CID binary envelope, whichever variant.

pub fn is_mintable(&self) -> bool

true for the two profiles this crate mints (Content, Raw).

pub fn codec(&self) -> u64

The multicodec code of the CID (0x71 dag-cbor, 0x55 raw, or whatever a foreign CID declares).

pub fn hash_code(&self) -> u64

The multihash code of the CID (0x1e BLAKE3, 0x12 sha2-256, …).

pub fn as_content(&self) -> Option<&ContentId>

The ContentId if this is the dag-cbor profile.

pub fn as_raw(&self) -> Option<&RawContentId>

The RawContentId if this is the raw profile.

pub fn as_foreign(&self) -> Option<&ForeignCid>

The ForeignCid if this is neither mintable profile.

Trait Implementations

impl Clone for ClassifiedCid

fn clone(&self) -> ClassifiedCid

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for ClassifiedCid

impl Debug for ClassifiedCid

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ClassifiedCid

fn deserialize<D: Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error>

Re-classifies from the wire bytes, so the variant is derived rather than trusted — a crafted link cannot land in the wrong variant.

impl Display for ClassifiedCid

fn fmt(&self, f: &mut Formatter<'_>) -> Result

The inner CID’s canonical multibase string (base32-lower for CIDv1; a foreign CIDv0 renders as its base58btc form, per the CID spec).

impl Eq for ClassifiedCid

impl From<ClassifiedCid> for Cid

fn from(v: ClassifiedCid) -> Self

Converts to this type from the input type.

impl From<ContentId> for ClassifiedCid

fn from(id: ContentId) -> Self

Converts to this type from the input type.

impl From<ForeignCid> for ClassifiedCid

fn from(id: ForeignCid) -> Self

Converts to this type from the input type.

impl From<RawContentId> for ClassifiedCid

fn from(id: RawContentId) -> Self

Converts to this type from the input type.

impl FromStr for ClassifiedCid

fn from_str(s: &str) -> Result<Self, Self::Err>

Parse any multibase CID string and classify. Legacy dialects (kyln envelope-hex, blake3:<hex>, bare digest hex) are not accepted — use the explicit legacy adapters.

type Err = ContentError

The associated error which can be returned from parsing.

impl Hash for ClassifiedCid

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for ClassifiedCid

fn cmp(&self, other: &ClassifiedCid) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for ClassifiedCid

fn eq(&self, other: &ClassifiedCid) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl PartialOrd for ClassifiedCid

fn partial_cmp(&self, other: &ClassifiedCid) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Serialize for ClassifiedCid

fn serialize<S: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ClassifiedCid