Struct Assertion 

pub struct Assertion { /* private fields */ }

An author’s detached signature over a ContentId, with the certificate chain that lets any reader check who the author is.

Implementations

impl Assertion

pub fn sign(author: &AgentKey, cid: &ContentId) -> Self

author vouches for cid.

pub fn author(&self) -> &CertChain

The author’s certificate chain.

pub fn signature(&self) -> &SerdeSig

The detached signature alone, for a record that cites the author’s certificate instead of carrying it.

pub fn from_parts(author: CertChain, sig: SerdeSig) -> Self

An assertion from a certificate chain and a signature kept apart. The pair is not checked here: Assertion::verify is what says whether sig is author’s.

pub fn verify( &self, cid: &ContentId, trust_root: &[u8; 32], generation: u64, ) -> Result<()>

Check that the author signed cid and that the author’s chain passes is rooted at trust_root (the flock server’s agent public key) at epoch generation: the trust root must be the root agent, the certificate issued by the user. An intermediate or leaf key matching is refused. Two servers of one user share a user key but not an agent key.

Errors

MeshError::BadSignature if the signature does not match cid; MeshError::InvalidCertChain / generation / amplification errors if the chain is bad or its root agent is not trust_root.

pub fn verify_user( &self, cid: &ContentId, user: &UserPublic, generation: u64, ) -> Result<()>

Check that the author signed cid with a key the user user certified directly (a device key: the chain is one link, issued by that user) at epoch generation. Which devices count is the caller’s to decide.

Errors

MeshError::InvalidCertChain if the chain is not issued directly by user or fails verification; MeshError::BadSignature if the signature does not match cid.

Trait Implementations

impl Clone for Assertion

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Assertion

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Assertion

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for Assertion

impl PartialEq for Assertion

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Assertion

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Assertion