Struct AllocationDeclaration 

pub struct AllocationDeclaration { /* private fields */ }

AllocationDeclaration

Checked runtime claim that a stable key should own an allocation slot.

Declarations are supplied by the current binary before opening storage. Constructors validate the stable key and label and accept already checked slots and schema metadata. A declaration becomes authoritative only after validation against the recovered ledger and commitment in a generation.

Implementations

impl AllocationDeclaration

pub fn new( stable_key: impl AsRef<str>, slot: MemoryManagerSlot, label: Option<String>, schema: SchemaMetadata, ) -> Result<Self, DeclarationSnapshotError>

Build a declaration from raw parts after validating diagnostic metadata.

pub fn memory_manager( stable_key: impl AsRef<str>, id: u8, label: impl Into<String>, ) -> Result<Self, DeclarationSnapshotError>

Build a MemoryManager declaration with a diagnostic label.

pub fn memory_manager_unlabeled( stable_key: impl AsRef<str>, id: u8, ) -> Result<Self, DeclarationSnapshotError>

Build an unlabeled MemoryManager declaration.

pub fn memory_manager_with_schema( stable_key: impl AsRef<str>, id: u8, label: impl Into<String>, schema: SchemaMetadata, ) -> Result<Self, DeclarationSnapshotError>

Build a MemoryManager declaration with a diagnostic label and schema metadata.

pub fn memory_manager_unlabeled_with_schema( stable_key: impl AsRef<str>, id: u8, schema: SchemaMetadata, ) -> Result<Self, DeclarationSnapshotError>

Build an unlabeled MemoryManager declaration with schema metadata.

pub const fn stable_key(&self) -> &StableKey

Return the durable stable key claimed by this declaration.

pub const fn slot(&self) -> &MemoryManagerSlot

Return the allocation slot claimed by this declaration.

pub fn label(&self) -> Option<&str>

Return the optional diagnostic label.

pub const fn schema(&self) -> &SchemaMetadata

Return the optional schema metadata.

pub fn validate(&self) -> Result<(), DeclarationSnapshotError>

Validate the label after decode or manual assembly. Key syntax, usable slot IDs and schema versions belong to checked types.

Trait Implementations

impl Clone for AllocationDeclaration

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AllocationDeclaration

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AllocationDeclaration

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for AllocationDeclaration

impl PartialEq for AllocationDeclaration

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for AllocationDeclaration

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for AllocationDeclaration