Struct MemoryManagerRangeAuthority 

pub struct MemoryManagerRangeAuthority { /* private fields */ }

MemoryManagerRangeAuthority

Substrate-specific range authority policy helper for MemoryManager IDs.

This helper records policy and diagnostic authority ranges only. It never mutates the allocation ledger, and it does not allocate or reserve durable stable-memory slots. Durable allocation remains the generic ledger mapping from stable key to allocation slot.

When used through the default runtime registry, registered ranges are authoritative generic policy and are checked before caller-supplied crate::AllocationPolicy. Frameworks that want their own policy to own application space should avoid registering ranges for that space.

Implementations

impl MemoryManagerRangeAuthority

pub const fn new() -> Self

Create an empty MemoryManager range authority policy.

pub fn from_records( records: Vec<MemoryManagerAuthorityRecord>, ) -> Result<Self, MemoryManagerRangeAuthorityError>

Build a range authority from diagnostic records.

Records are validated with the same rules as the builder methods and stored in ascending range order.

pub fn reserve( self, range: MemoryManagerIdRange, authority: impl Into<String>, ) -> Result<Self, MemoryManagerRangeAuthorityError>

Add a reserved authority range.

Reserved is a policy authority mode. It does not allocate every ID in the range and does not write to the allocation ledger.

pub fn reserve_ids( self, start: u8, end: u8, authority: impl Into<String>, ) -> Result<Self, MemoryManagerRangeAuthorityError>

Add a reserved authority range from inclusive ID bounds.

Reserved is a policy authority mode. It does not allocate every ID in the range and does not write to the allocation ledger.

pub fn reserve_with_purpose( self, range: MemoryManagerIdRange, authority: impl Into<String>, purpose: Option<String>, ) -> Result<Self, MemoryManagerRangeAuthorityError>

Add a reserved authority range with a diagnostic purpose.

Reserved is a policy authority mode. It does not allocate every ID in the range and does not write to the allocation ledger.

pub fn reserve_ids_with_purpose( self, start: u8, end: u8, authority: impl Into<String>, purpose: Option<String>, ) -> Result<Self, MemoryManagerRangeAuthorityError>

Add a reserved authority range from inclusive ID bounds with a diagnostic purpose.

Reserved is a policy authority mode. It does not allocate every ID in the range and does not write to the allocation ledger.

pub fn allow( self, range: MemoryManagerIdRange, authority: impl Into<String>, ) -> Result<Self, MemoryManagerRangeAuthorityError>

Add an allowed authority range.

Allowed is a policy authority mode. It does not allocate any ID in the range and does not write to the allocation ledger.

pub fn allow_ids( self, start: u8, end: u8, authority: impl Into<String>, ) -> Result<Self, MemoryManagerRangeAuthorityError>

Add an allowed authority range from inclusive ID bounds.

Allowed is a policy authority mode. It does not allocate any ID in the range and does not write to the allocation ledger.

pub fn allow_with_purpose( self, range: MemoryManagerIdRange, authority: impl Into<String>, purpose: Option<String>, ) -> Result<Self, MemoryManagerRangeAuthorityError>

Add an allowed authority range with a diagnostic purpose.

Allowed is a policy authority mode. It does not allocate any ID in the range and does not write to the allocation ledger.

pub fn allow_ids_with_purpose( self, start: u8, end: u8, authority: impl Into<String>, purpose: Option<String>, ) -> Result<Self, MemoryManagerRangeAuthorityError>

Add an allowed authority range from inclusive ID bounds with a diagnostic purpose.

Allowed is a policy authority mode. It does not allocate any ID in the range and does not write to the allocation ledger.

pub fn validate_slot_authority( &self, slot: &AllocationSlotDescriptor, expected_authority: &str, ) -> Result<&MemoryManagerAuthorityRecord, MemoryManagerRangeAuthorityError>

Validate that slot belongs to expected_authority.

pub fn validate_slot_authority_mode( &self, slot: &AllocationSlotDescriptor, expected_authority: &str, expected_mode: MemoryManagerRangeMode, ) -> Result<&MemoryManagerAuthorityRecord, MemoryManagerRangeAuthorityError>

Validate that slot belongs to expected_authority with expected_mode.

pub fn validate_id_authority( &self, id: u8, expected_authority: &str, ) -> Result<&MemoryManagerAuthorityRecord, MemoryManagerRangeAuthorityError>

Validate that id belongs to expected_authority.

pub fn validate_id_authority_mode( &self, id: u8, expected_authority: &str, expected_mode: MemoryManagerRangeMode, ) -> Result<&MemoryManagerAuthorityRecord, MemoryManagerRangeAuthorityError>

Validate that id belongs to expected_authority with expected_mode.

pub fn authority_for_id( &self, id: u8, ) -> Result<Option<&MemoryManagerAuthorityRecord>, MemoryManagerRangeAuthorityError>

Return the authority record that governs id, if any.

pub fn authorities(&self) -> &[MemoryManagerAuthorityRecord]

Ordered non-overlapping authority records.

This is the stable diagnostic/export surface for the authority table. Records are returned in ascending range order and do not imply ledger allocation state.

pub fn validate_complete_coverage( &self, target: MemoryManagerIdRange, ) -> Result<(), MemoryManagerRangeAuthorityError>

Validate that authority records exactly and contiguously cover target.

All records must be inside target, and together they must form a gap-free partition. This checks policy table coverage only and never changes allocation ledger state.

Trait Implementations

impl Clone for MemoryManagerRangeAuthority

fn clone(&self) -> MemoryManagerRangeAuthority

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MemoryManagerRangeAuthority

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

Formats the value using the given formatter.

impl Default for MemoryManagerRangeAuthority

fn default() -> MemoryManagerRangeAuthority

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for MemoryManagerRangeAuthority

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for MemoryManagerRangeAuthority

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for MemoryManagerRangeAuthority

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for MemoryManagerRangeAuthority

impl StructuralPartialEq for MemoryManagerRangeAuthority