Enum Error 

pub enum Error {
    NotFound,
    MultipleLinks,
    Malformed(&'static str),
    Inaccessible,
}

Errors from locating a C2PA Manifest Store via an HTTP Link header.

What carries a status code

Locating a manifest by reference is a prerequisite to validation. A response with no c2pa-manifest link simply has no provenance to check, which is not a failure.

The one registered code that belongs to this crate is manifest.inaccessible: the specification requires it when a manifest “was documented to exist in a remote location, but is not present there, or the location is not currently available (such as in an offline scenario)”. This crate performs no network I/O, so it never raises that itself — it is exposed as Error::Inaccessible for the caller that does the fetching to report through the same type.

Variants

NotFound

No Link header with rel="c2pa-manifest" was present.

MultipleLinks

More than one distinct c2pa-manifest target was advertised.

The specification describes retrieving “a” Manifest Store from “that URI reference” and defines no precedence between competing links, so picking one would be inventing a rule. Duplicate links naming the same target are not an error.

Malformed(&'static str)

A Link field value could not be parsed as RFC 8288.

Inaccessible

A manifest was advertised but could not be retrieved.

Reported as manifest.inaccessible. Raised by the caller performing the fetch, not by this crate.

Implementations

impl Error

pub fn code(&self) -> Option<&'static str>

The registered C2PA validation status code for this error, or None when the condition carries no status code.

pub fn is_no_manifest_located(&self) -> bool

Whether this means the response advertised no provenance at all, as opposed to provenance that was advertised and could not be used.

Trait Implementations

impl Clone for Error

fn clone(&self) -> Error

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Eq for Error

impl Error for Error

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl PartialEq for Error

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Error