Struct ContentHash 

pub struct ContentHash {
    pub codec: u8,
    pub digest: Vec<u8>,
}

Self-describing content address (multihash-style envelope).

Fields

codec: u8

Hash-function identifier; 0x1e = BLAKE3-256, following the multicodec table.

digest: Vec<u8>

Raw digest bytes for codec.

Implementations

impl ContentHash

pub fn blake3(data: &[u8]) -> Self

Hashes data with BLAKE3-256 and wraps it in the envelope.

pub fn from_git_oid(hex: &str) -> Option<Self>

Wraps a git object id (hex) in the envelope: codec 0x11 for SHA-1 (40 hex chars) or 0x12 for SHA-256 (64), per the multicodec table. None for anything else. This is how git ref updates enter the op log without pretending to be BLAKE3.

pub fn git_oid(&self) -> Option<String>

The git object id this envelope carries, or None if it is not a git hash. The inverse of ContentHash::from_git_oid, for the paths that have to hand an oid back to git itself.

pub fn from_hex(text: &str) -> Option<Self>

Parses what ContentHash::to_hex produced. None for anything else, including a bare digest with no codec prefix.

Its only caller is a lookup that reads a key id back out of a hex-keyed map and has to put it in a persisted record. That is also the reason it refuses an unprefixed digest rather than guessing a codec: inventing the byte that says which hash function this is would defeat the envelope (D6).

pub fn to_hex(&self) -> String

Lowercase hex of the digest, prefixed with the codec byte (e.g. 1e-ab12…); used for filesystem sharding and display.

Trait Implementations

impl Clone for ContentHash

fn clone(&self) -> ContentHash

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ContentHash

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ContentHash

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Hash for ContentHash

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 PartialEq for ContentHash

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for ContentHash

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for ContentHash

impl StructuralPartialEq for ContentHash