Enum Error 

pub enum Error {
    ContentTooShort,
    GenerationFailed(String),
    MatchFailed(String),
    Coding(String),
    TagMismatch,
    WatermarkUnrecoverable,
    InvalidInput(String),
}

Errors produced by the text soft-binding algorithms.

Variants

ContentTooShort

Input has too little content for the requested algorithm (e.g. not enough word boundaries to place a watermark payload).

GenerationFailed(String)

A fingerprint value could not be produced.

MatchFailed(String)

A fingerprint comparison failed.

Coding(String)

Reed-Solomon erasure coding/decoding failed.

TagMismatch

The watermark payload was present but its content-binding HMAC did not verify against the recomputed content hash (transfer or tamper).

WatermarkUnrecoverable

The watermark could not be recovered (too many stripped positions).

InvalidInput(String)

A caller-supplied argument was malformed.

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.

Always None. This crate implements soft binding — fingerprinting and watermarking — whose failures are not hard-binding validation outcomes. A soft binding that does not match means the recovery path found no candidate, not that a located manifest failed to validate, and the specification registers no status code for that.

Every crate in this family exposes this method, so a dispatcher handling several embedding methods can ask the same question of any of them.

pub fn is_no_manifest_located(&self) -> bool

Whether this error means the asset carries no provenance at all.

Always false: soft binding is a recovery mechanism used after the hard binding has already failed to locate a manifest, so it is never the thing that decides whether an asset is unsigned.

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