Enum RegistryMergeError 

#[non_exhaustive]
pub enum RegistryMergeError {
    InvalidPrefix {
        id: String,
        reason: String,
    },
    SourceKel {
        prefix: Prefix,
        source: KelResolveError,
    },
    MissingSignature {
        prefix: Prefix,
        sequence: u128,
    },
    Unauthenticated {
        prefix: Prefix,
        reason: String,
    },
    Forked {
        prefix: Prefix,
        sequence: u128,
        destination: Said,
        incoming: Said,
    },
    Storage(RegistryError),
    CredentialRefused {
        issuer: Prefix,
        credential: Said,
        reason: String,
    },
    CredentialOrphan {
        issuer: Prefix,
        credential: Said,
    },
    TelRefused {
        issuer: Prefix,
        registry: Said,
        credential: Said,
        reason: String,
    },
}

Why a registry merge was refused. Any error aborts the whole merge — a pull never partially trusts a source that failed one identity’s checks.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

InvalidPrefix

The source listed an identity whose id is not a valid prefix.

Fields

id: String

The offending identity id.

reason: String

Why it failed to parse.

SourceKel

Reading the source KEL failed the untrusted-read guards (not-found / oversized / truncated / prefix-binding).

Fields

prefix: Prefix

The identity prefix.

source: KelResolveError

The guard that refused it.

MissingSignature

An event in the source KEL has no signature attachment — it cannot be authenticated, so it is never persisted.

Fields

prefix: Prefix

The identity prefix.

sequence: u128

The unsigned event’s sequence.

Unauthenticated

The source KEL failed authenticated replay (bad signature, broken chain, unauthorized delegation, …).

Fields

prefix: Prefix

The identity prefix.

reason: String

The validation failure.

Forked

Source and destination disagree at a shared sequence — a fork. Refused outright; a merge never picks a side of a fork.

Fields

prefix: Prefix

The identity prefix.

sequence: u128

The diverging sequence number.

destination: Said

The destination’s event SAID at that sequence.

incoming: Said

The source’s event SAID at that sequence.

Storage(RegistryError)

A backend read/write failed.

CredentialRefused

A source credential blob did not parse as a stored ACDC envelope, or its recomputed SAID did not match the SAID it was filed under — a tampered or malformed credential body is refused rather than copied onto the cold machine.

Fields

issuer: Prefix

The issuer the credential was filed under.

credential: Said

The credential SAID (the on-disk filename).

reason: String

Why it was refused.

CredentialOrphan

A source credential names an issuer whose KEL was not authenticated in this merge — a credential with no anchoring identity is never imported.

Fields

issuer: Prefix

The unanchored issuer.

credential: Said

The orphaned credential SAID.

TelRefused

A source TEL chain failed structural validation (a recomputed event SAID did not match, or the vcp → iss… → rev… shape was broken) — a tampered TEL is refused rather than copied.

Fields

issuer: Prefix

The issuer the TEL was filed under.

registry: Said

The registry SAID.

credential: Said

The credential SAID the TEL belongs to.

reason: String

Why it was refused.

Trait Implementations

impl Debug for RegistryMergeError

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

Formats the value using the given formatter.

impl Display for RegistryMergeError

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

Formats the value using the given formatter.

impl Error for RegistryMergeError

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<RegistryError> for RegistryMergeError

fn from(source: RegistryError) -> Self

Converts to this type from the input type.