Struct RawSubnetCatalog 

pub struct RawSubnetCatalog {
    pub catalog_schema_version: u32,
    pub provenance: SubnetCatalogProvenance,
    pub catalog_digest: String,
    pub subnets: Vec<SubnetInfo>,
    pub routing_ranges: Vec<RoutingRange>,
}

RawSubnetCatalog

Untrusted serialized subnet catalog representation from a source or cache.

Fields

catalog_schema_version: u32

Persisted catalog schema version.

provenance: SubnetCatalogProvenance

Registry and collection provenance supplied with the snapshot.

catalog_digest: String

Lowercase SHA-256 digest of the canonical authority payload.

subnets: Vec<SubnetInfo>

Canonically ordered Subnet rows.

routing_ranges: Vec<RoutingRange>

Canonically ordered inclusive routing ranges.

Implementations

impl RawSubnetCatalog

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

Validate schema, fixed mainnet identity, raw classifications, and routing structure.

pub fn subnet_by_principal(&self, subnet_principal: &str) -> Option<&SubnetInfo>

Find one raw Subnet row by canonical principal text.

pub fn routing_ranges_for_subnet( &self, subnet_principal: &str, ) -> Vec<&RoutingRange>

Return raw routing ranges assigned to one Subnet.

impl RawSubnetCatalog

pub fn resolve_canister( &self, input_principal: &str, ) -> Result<ResolvedSubnet, CatalogError>

Resolve a canister principal through cached routing ranges.

impl RawSubnetCatalog

pub fn resolve_principal_or_prefix( &self, input: &str, forced: Option<ResolveAs>, ) -> Result<ResolvedSubnet, CatalogError>

Resolve an exact principal or a unique cached subnet principal prefix.

pub fn resolve_principal_prefix( &self, input: &str, forced: Option<ResolveAs>, ) -> Result<ResolvedSubnet, CatalogError>

Resolve a unique prefix of a cached subnet principal.

impl RawSubnetCatalog

pub fn resolve_principal( &self, input: &str, forced: Option<ResolveAs>, ) -> Result<ResolvedSubnet, CatalogError>

Resolve a principal as a known subnet or as a canister covered by a cached range.

Trait Implementations

impl Clone for RawSubnetCatalog

fn clone(&self) -> RawSubnetCatalog

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RawSubnetCatalog

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for RawSubnetCatalog

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for RawSubnetCatalog

impl PartialEq for RawSubnetCatalog

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for RawSubnetCatalog

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 RawSubnetCatalog