Enum AnchorValidationError 

pub enum AnchorValidationError {
    UnknownClass {
        got: Option<String>,
        allowed: &'static [&'static str],
    },
    UnknownGrain {
        got: Option<String>,
        allowed: &'static [&'static str],
    },
    UnknownHashStability {
        got: String,
        allowed: &'static [&'static str],
    },
    MissingArtifact,
    HashOnNonHashClass {
        class: &'static str,
    },
    EmptySource,
    SourceNotDeclared {
        got: String,
        declared: Vec<String>,
    },
    GrainNamespaceUnsupported {
        grain: &'static str,
        medium_type: String,
        anchor_namespace: &'static str,
    },
}

A typed INVALID_ANCHOR refusal. The whole mutation refuses and the entity is not written; Self::detail carries the recovery payload (offending value + allowed set) the agent fixes from.

Variants

UnknownClass

Provenance class is absent or not one of the allowed wire strings.

Fields

got: Option<String>

allowed: &'static [&'static str]

UnknownGrain

Grain is absent or not one of the allowed wire strings.

Fields

got: Option<String>

allowed: &'static [&'static str]

UnknownHashStability

Hash stability, when supplied, is not an allowed wire string.

Fields

got: String

allowed: &'static [&'static str]

MissingArtifact

The artifact reference is missing or empty.

HashOnNonHashClass

A content hash was supplied on a class that carries no hash semantics (authored / informed-by).

Fields

class: &'static str

EmptySource

A source was supplied but is empty after trimming — a source name, when present, must be one of the producing binding’s declared names, and an empty string can never be one.

SourceNotDeclared

The anchor’s source is not among the sources declared by its own (resolvable) producing binding. Carries the declared names as the recovery payload. Only fires when the binding hash still resolves in this workspace — an orphaned or since-edited binding accepts any non-empty name.

Fields

got: String

declared: Vec<String>

GrainNamespaceUnsupported

The grain cannot be expressed in the medium’s anchor namespace (per the E2 capability matrix), e.g. span on a non-path medium.

Fields

grain: &'static str

medium_type: String

anchor_namespace: &'static str

Implementations

impl AnchorValidationError

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

The stable typed code — always INVALID_ANCHOR_CODE.

pub fn detail(&self) -> BTreeMap<String, Value>

Structured recovery detail for the typed envelope: the offending field, its bad value, and the allowed set where one applies.

Trait Implementations

impl Clone for AnchorValidationError

fn clone(&self) -> AnchorValidationError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AnchorValidationError

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

Formats the value using the given formatter.

impl Display for AnchorValidationError

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

Formats the value using the given formatter.

impl Eq for AnchorValidationError

impl Error for AnchorValidationError

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<AnchorValidationError> for EngineError

fn from(source: AnchorValidationError) -> Self

Converts to this type from the input type.

impl PartialEq for AnchorValidationError

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for AnchorValidationError