Struct Commit 

pub struct Commit {
    pub parents: Vec<CommitCid>,
    pub metadata_bundle: MetadataCid,
    pub timestamp: u64,
    pub message: String,
    pub author: Option<SigningPubKey>,
    pub signature: Option<CommitSignature>,
    pub manifest_cid: Option<ManifestCid>,
    pub stats: Option<CommitStats>,
    pub repo_manifest_cid: Option<RepoManifestCid>,
}

Commit object pointing to a metadata bundle.

Supports multiple parents for merge commits:

• Empty parents: initial commit
• One parent: normal commit
• Two+ parents: merge commit

Optionally signed with Ed25519 for author verification.

Fields

parents: Vec<CommitCid>

Parent commit CIDs (empty for initial, 1 for normal, 2+ for merge)

metadata_bundle: MetadataCid

Metadata bundle CID

timestamp: u64

Unix timestamp

message: String

Commit message

author: Option<SigningPubKey>

Ed25519 public key of the author (None for unsigned commits)

signature: Option<CommitSignature>

Ed25519 signature over signable_bytes() (None for unsigned commits)

manifest_cid: Option<ManifestCid>

CID of TreeManifest (None if not present)

stats: Option<CommitStats>

Quick stats for health verification (None if not present)

repo_manifest_cid: Option<RepoManifestCid>

CID of encrypted repo manifest JSON (None for non-collab repos)

Implementations

impl Commit

pub fn new( parent: Option<CommitCid>, metadata_bundle: MetadataCid, timestamp: u64, message: String, ) -> Self

Creates a new unsigned commit with a single parent.

pub fn new_merge( parents: Vec<CommitCid>, metadata_bundle: MetadataCid, timestamp: u64, message: String, ) -> Self

Creates a new unsigned merge commit with multiple parents.

pub fn is_initial(&self) -> bool

Returns true if this is the initial commit (no parents).

pub fn is_merge(&self) -> bool

Returns true if this is a merge commit (2+ parents).

pub fn first_parent(&self) -> Option<&CommitCid>

Returns the first parent CID, if any.

pub fn parent(&self) -> Option<&CommitCid>

Returns the single parent for non-merge commits.

pub fn referenced_object_cids(&self) -> Vec<VoidCid>

All non-parent object CIDs referenced by this commit.

Returns parsed VoidCid for each referenced object (metadata bundle, tree manifest, repo manifest). This is the canonical list of objects a commit depends on — use it for reachability tracking to avoid missing objects when new CID fields are added to Commit.

Parent commit CIDs are excluded since they serve a different purpose (graph traversal vs. object reachability).

CIDs that fail to parse are silently skipped.

pub fn is_signed(&self) -> bool

Returns true if this commit is signed.

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

Returns the bytes to sign (excludes signature field).

Format: parents || metadata_bundle || timestamp || message || author || manifest_cid || stats || repo_manifest_cid

pub fn sign(&mut self, signing_key: &SigningKey)

Sign the commit with an Ed25519 signing key.

Sets the author field to the public key and computes the signature.

pub fn verify(&self) -> Result<bool>

Verify the commit signature.

Returns:

• Ok(true) if the signature is valid
• Ok(false) if the commit is unsigned (both author and signature are None)
• Err(_) if the signature is invalid or malformed

Trait Implementations

impl Clone for Commit

fn clone(&self) -> Commit

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Commit

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Commit

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Commit

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

where __S: Serializer,

Serialize this value into the given Serde serializer.