Enum MemoryRegistryError 

pub enum MemoryRegistryError {
    Overlap {
        existing_crate: String,
        existing_start: u8,
        existing_end: u8,
        new_crate: String,
        new_start: u8,
        new_end: u8,
    },
    InvalidRange {
        start: u8,
        end: u8,
    },
    DuplicateId(u8),
    DuplicateStableKey(String),
    NoReservedRange {
        crate_name: String,
        id: u8,
    },
    IdOwnedByOther {
        crate_name: String,
        id: u8,
        owner: String,
        owner_start: u8,
        owner_end: u8,
    },
    IdOutOfRange {
        crate_name: String,
        id: u8,
    },
    ReservedInternalId {
        id: u8,
    },
    HistoricalRangeConflict {
        existing_crate: String,
        existing_start: u8,
        existing_end: u8,
        new_crate: String,
        new_start: u8,
        new_end: u8,
    },
    HistoricalIdConflict {
        id: u8,
        existing_crate: String,
        existing_label: String,
        new_crate: String,
        new_label: String,
        new_stable_key: String,
    },
    HistoricalStableKeyConflict {
        stable_key: String,
        existing_id: u8,
        new_id: u8,
    },
    InvalidStableKey {
        stable_key: String,
        reason: &'static str,
    },
    InvalidSchemaMetadata {
        stable_key: String,
        reason: &'static str,
    },
    RangeAuthorityViolation {
        stable_key: String,
        id: u8,
        reason: &'static str,
    },
    RegistrationAfterBootstrap {
        ranges: usize,
        registrations: usize,
    },
    RegistryNotBootstrapped,
    LedgerCorrupt {
        reason: &'static str,
    },
}

MemoryRegistryError

Errors returned when a memory range or ID registration is invalid.

Variants

Overlap

A requested owner range overlaps an already reserved range.

Fields

existing_crate: String

Crate that already owns the conflicting range.

existing_start: u8

First ID in the existing range.

existing_end: u8

Last ID in the existing range.

new_crate: String

Crate requesting the new range.

new_start: u8

First ID in the requested range.

new_end: u8

Last ID in the requested range.

InvalidRange

The requested range has start > end.

Fields

start: u8

First ID in the requested range.

end: u8

Last ID in the requested range.

DuplicateId(u8)

The memory ID is already registered.

DuplicateStableKey(String)

The stable key is declared more than once in one runtime snapshot.

NoReservedRange

The crate attempted to register an ID before reserving any range.

Fields

crate_name: String

Crate attempting to register the ID.

id: u8

Stable-memory ID being registered.

IdOwnedByOther

The ID falls inside a range reserved by another crate.

Fields

crate_name: String

Crate attempting to register the ID.

id: u8

Stable-memory ID being registered.

owner: String

Crate that owns the range containing id.

owner_start: u8

First ID in the owning range.

owner_end: u8

Last ID in the owning range.

IdOutOfRange

The crate has reserved ranges, but none contain the requested ID.

Fields

crate_name: String

Crate attempting to register the ID.

id: u8

Stable-memory ID being registered.

ReservedInternalId

The ID is the unallocated-bucket sentinel and is not usable.

Fields

id: u8

Invalid sentinel stable-memory ID.

HistoricalRangeConflict

A requested range conflicts with a range recorded in the stable layout ledger.

Fields

existing_crate: String

Crate that historically owns the conflicting range.

existing_start: u8

First ID in the historical range.

existing_end: u8

Last ID in the historical range.

new_crate: String

Crate requesting the new range.

new_start: u8

First ID in the requested range.

new_end: u8

Last ID in the requested range.

HistoricalIdConflict

A requested ID conflicts with an ID recorded in the stable layout ledger.

Fields

id: u8

Stable-memory ID being registered.

existing_crate: String

Crate that historically registered the ID.

existing_label: String

Historical label for the ID.

new_crate: String

Crate requesting the ID now.

new_label: String

Requested label for the ID now.

new_stable_key: String

Requested stable key for the ID now.

HistoricalStableKeyConflict

A requested stable key conflicts with a different historical ID.

Fields

stable_key: String

Stable key being registered.

existing_id: u8

Historical ID for the stable key.

new_id: u8

Requested ID for the stable key now.

InvalidStableKey

The stable key is not canonical.

Fields

stable_key: String

Rejected stable key.

reason: &'static str

Human-readable reason for the rejection.

InvalidSchemaMetadata

The schema metadata is not canonical.

Fields

stable_key: String

Stable key whose schema metadata was rejected.

reason: &'static str

Human-readable reason for the rejection.

RangeAuthorityViolation

The stable key namespace and memory ID range do not match.

Fields

stable_key: String

Stable key being registered.

id: u8

Stable-memory ID being registered.

reason: &'static str

Human-readable reason for the rejection.

RegistrationAfterBootstrap

Registration was attempted after the bootstrap declaration snapshot was sealed.

Fields

ranges: usize

Number of late range declarations.

registrations: usize

Number of late memory ID declarations.

RegistryNotBootstrapped

A memory handle was requested before bootstrap validated the declaration snapshot.

LedgerCorrupt

The persisted ABI ledger cannot be validated.

Fields

reason: &'static str

Human-readable corruption reason.

Trait Implementations

impl Debug for MemoryRegistryError

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

Formats the value using the given formatter.

impl Display for MemoryRegistryError

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

Formats the value using the given formatter.

impl Error for MemoryRegistryError

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.