Skip to main content

MemoryRegistry

Struct MemoryRegistry 

Source
pub struct MemoryRegistry;
Expand description

MemoryRegistry

Canonical substrate registry for stable memory IDs.

Implementations§

Source§

impl MemoryRegistry

Source

pub fn reserve_range( crate_name: &str, start: u8, end: u8, ) -> Result<(), MemoryRegistryError>

Reserve an inclusive memory ID range for one crate.

Exact duplicate reservations by the same crate are accepted so init and post-upgrade can share the same bootstrap path.

Source

pub fn register( id: u8, crate_name: &str, label: &str, ) -> Result<(), MemoryRegistryError>

Register one memory ID under an existing owner range.

Source

pub fn register_with_key( id: u8, crate_name: &str, label: &str, stable_key: &str, ) -> Result<(), MemoryRegistryError>

Register one memory ID under an existing owner range using an explicit ABI key.

Source

pub fn register_with_key_metadata( id: u8, crate_name: &str, label: &str, stable_key: &str, schema_version: Option<u32>, schema_fingerprint: Option<&str>, ) -> Result<(), MemoryRegistryError>

Register one memory ID with explicit ABI key and optional schema metadata.

Source

pub fn export() -> Vec<(u8, MemoryRegistryEntry)>

Export all registered entries (canonical snapshot).

Source

pub fn export_ranges() -> Vec<(String, MemoryRange)>

Export all reserved ranges.

Source

pub fn export_range_entries() -> Vec<MemoryRangeEntry>

Export all reserved ranges with explicit owners.

Source

pub fn export_ids_by_range() -> Vec<MemoryRangeSnapshot>

Export registry entries grouped by reserved range.

Source

pub fn get(id: u8) -> Option<MemoryRegistryEntry>

Retrieve a single registry entry.

Source

pub fn export_historical_ranges() -> Vec<(String, MemoryRange)>

Export all ranges ever recorded in the stable memory layout ledger.

Source

pub fn export_historical_authorities() -> Vec<MemoryRangeAuthority>

Export canonical allocation authorities recorded in the stable memory layout ledger.

Source

pub fn try_export_historical_ranges() -> Result<Vec<(String, MemoryRange)>, MemoryRegistryError>

Fallibly export all ranges ever recorded in the stable memory layout ledger.

Source

pub fn try_export_historical_authorities() -> Result<Vec<MemoryRangeAuthority>, MemoryRegistryError>

Fallibly export canonical allocation authorities recorded in the stable memory layout ledger.

Source

pub fn export_historical() -> Vec<(u8, MemoryRegistryEntry)>

Export all memory IDs ever recorded in the stable memory layout ledger.

Source

pub fn try_export_historical() -> Result<Vec<(u8, MemoryRegistryEntry)>, MemoryRegistryError>

Fallibly export all memory IDs ever recorded in the stable memory layout ledger.

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.