Enum Error 

pub enum Error {
    UnknownFormat,
    Malformed(String),
    NotFound,
    EmptySource,
    MalformedReference(String),
    MultipleManifests(Format),
    MalformedExclusion(String),
    HashMismatch,
    UnsupportedAlgorithm(String),
    Io(Error),
}

Errors returned by the crate.

Variants

UnknownFormat

The bytes did not match any supported ML model container format.

Malformed(String)

The container was structurally malformed for its detected format.

NotFound

No C2PA manifest was present in the model.

EmptySource

A manifest source carried neither an embedded store nor a remote URI.

MalformedReference(String)

A stored manifest reference could not be decoded (e.g. invalid Base64).

MultipleManifests(Format)

More than one c2pa:manifest entry was present.

Only one shall be present per file. The specification assigns a distinct failure code per format; see Error::code.

MalformedExclusion(String)

The exclusion ranges are malformed: out of order, overlapping, extending past the end of the file, or not matching the located manifest value.

For SafeTensors this also covers an 8-byte header length field that disagrees with the actual JSON header length, which the specification requires a validator to reject with assertion.dataHash.malformed.

HashMismatch

The recomputed data hash did not match the value in the assertion.

UnsupportedAlgorithm(String)

A hash algorithm identifier outside the C2PA allowed list was requested.

Io(Error)

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.

Reading, embedding, and format-detection errors are not validation outcomes and return None.

Trait Implementations

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 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 From<Error> for Error

fn from(e: Error) -> Self

Converts to this type from the input type.