Enum CatalogError 

pub enum CatalogError {
    Json(Error),
    UnsupportedSchemaVersion {
        found: u32,
        supported: u32,
    },
    NetworkMismatch {
        expected: String,
        actual: String,
    },
    RegistryCanisterMismatch {
        expected: String,
        actual: String,
    },
    InvalidRegistryVersion,
    EmptySubnets,
    EmptyRoutingRanges,
    InvalidPrincipal {
        field: &'static str,
        value: String,
        reason: String,
    },
    DuplicateSubnet {
        subnet_principal: String,
    },
    NonCanonicalSubnetOrder {
        previous: String,
        current: String,
    },
    UnknownRoutingSubnet {
        subnet_principal: String,
    },
    InvalidRoutingRange {
        subnet_principal: String,
        start_canister_id: String,
        end_canister_id: String,
    },
    OverlappingRoutingRanges {
        first: Box<RoutingRange>,
        second: Box<RoutingRange>,
    },
    NonCanonicalRoutingOrder {
        previous: Box<RoutingRange>,
        current: Box<RoutingRange>,
    },
    SubnetKindMismatch {
        subnet_principal: String,
        registry_subnet_type: i32,
        expected: String,
        actual: String,
    },
    ChargingPolicyMismatch {
        subnet_principal: String,
        expected: bool,
        actual: bool,
    },
    ClassificationMismatch {
        subnet_principal: String,
        field: &'static str,
        reason: String,
    },
    InvalidTimestamp {
        field: &'static str,
        value: String,
    },
    FutureTimestamp {
        field: &'static str,
        value: String,
        latest_allowed_unix_secs: u64,
    },
    InvalidSourceEndpoint {
        endpoint: String,
        reason: String,
    },
    InvalidProvenance {
        field: &'static str,
        reason: String,
    },
    UnsupportedAssurance {
        assurance: String,
    },
    ClassificationPolicyVersionMismatch {
        found: u32,
        supported: u32,
    },
    ClassificationPolicyDigestMismatch {
        expected: String,
        actual: String,
    },
    ResolverPolicyMismatch {
        expected_version: u32,
        actual_version: u32,
        expected_backend: String,
        actual_backend: String,
    },
    InvalidCatalogDigest {
        value: String,
    },
    InvalidAgreementDigest {
        value: String,
    },
    AgreementDigestMismatch {
        expected: String,
        actual: String,
    },
    CatalogDigestMismatch {
        expected: String,
        actual: String,
    },
    UnknownSubnet {
        subnet_principal: String,
    },
    PrincipalPrefixNotFound {
        prefix: String,
    },
    AmbiguousPrincipalPrefix {
        prefix: String,
        matches: Vec<String>,
    },
    RouteNotFound {
        canister_principal: String,
        registry_version: u64,
        catalog_schema_version: u32,
    },
}

CatalogError

Errors returned while parsing, validating, or resolving a subnet catalog.

Variants

Json(Error)

Catalog JSON could not be encoded or decoded.

UnsupportedSchemaVersion

The catalog uses a schema other than the current version-1 contract.

Fields

found: u32

Schema identifier found in the input.

supported: u32

Current supported schema identifier.

NetworkMismatch

Catalog network identity does not match the required authority.

Fields

expected: String

Required network identity.

actual: String

Catalog network identity.

RegistryCanisterMismatch

Catalog Registry canister identity does not match mainnet authority.

Fields

expected: String

Required Registry canister principal.

actual: String

Catalog Registry canister principal.

InvalidRegistryVersion

Registry version zero cannot identify an authority snapshot.

EmptySubnets

The catalog contains no Subnet records.

EmptyRoutingRanges

The catalog contains no routing authority ranges.

InvalidPrincipal

A catalog identity or routing boundary is not a valid IC principal.

Fields

field: &'static str

Catalog field containing the invalid identity.

value: String

Rejected principal text.

reason: String

Principal parsing diagnostic.

DuplicateSubnet

Multiple Subnet rows claim the same principal.

Fields

subnet_principal: String

Repeated Subnet principal.

NonCanonicalSubnetOrder

Subnet rows are not strictly ordered by canonical principal text.

Fields

previous: String

Previous Subnet principal.

current: String

Current Subnet principal.

UnknownRoutingSubnet

A routing range points to a Subnet absent from the catalog.

Fields

subnet_principal: String

Target Subnet principal missing its record.

InvalidRoutingRange

A routing range’s principal-byte boundaries are reversed.

Fields

subnet_principal: String

Subnet to which this range routes.

start_canister_id: String

Inclusive start principal of the rejected range.

end_canister_id: String

Inclusive end principal of the rejected range.

OverlappingRoutingRanges

Two inclusive routing ranges cover a common principal.

Fields

first: Box<RoutingRange>

Earlier range in canonical routing order.

second: Box<RoutingRange>

Later range that overlaps the earlier range.

NonCanonicalRoutingOrder

Routing ranges are not strictly ordered by principal bytes and target.

Fields

previous: Box<RoutingRange>

Previous routing range.

current: Box<RoutingRange>

Current routing range.

SubnetKindMismatch

Derived Subnet kind contradicts its raw Registry numeric code.

Fields

subnet_principal: String

Subnet principal.

registry_subnet_type: i32

Raw Registry numeric discriminant.

expected: String

Kind required by the raw discriminant.

actual: String

Kind supplied by the raw catalog.

ChargingPolicyMismatch

Charging default contradicts the raw Registry Subnet kind.

Fields

subnet_principal: String

Subnet principal.

expected: bool

Charging default required by the raw kind.

actual: bool

Charging default supplied by the raw catalog.

ClassificationMismatch

Classification metadata contradicts its policy or source.

Fields

subnet_principal: String

Subnet principal.

field: &'static str

Invalid classification field.

reason: String

Deterministic mismatch reason.

InvalidTimestamp

A provenance timestamp is not valid canonical UTC text.

Fields

field: &'static str

Timestamp field.

value: String

Invalid timestamp text.

FutureTimestamp

A provenance timestamp is beyond the caller’s future-skew policy.

Fields

field: &'static str

Timestamp field.

value: String

Future timestamp text.

latest_allowed_unix_secs: u64

Latest accepted Unix time.

InvalidSourceEndpoint

A source endpoint is not a clean credential-free HTTP(S) base URL.

Fields

endpoint: String

Invalid endpoint.

reason: String

Endpoint validation reason.

InvalidProvenance

Provenance evidence is internally inconsistent.

Fields

field: &'static str

Invalid provenance field.

reason: String

Deterministic validation reason.

UnsupportedAssurance

Serialized raw evidence cannot establish the claimed assurance level.

Fields

assurance: String

Unsupported assurance label.

ClassificationPolicyVersionMismatch

Classification policy schema is not supported by this build.

Fields

found: u32

Catalog policy schema.

supported: u32

Supported policy schema.

ClassificationPolicyDigestMismatch

Classification policy digest does not match this build.

Fields

expected: String

Expected policy digest.

actual: String

Catalog policy digest.

ResolverPolicyMismatch

Resolver implementation identity does not match this build.

Fields

expected_version: u32

Expected resolver schema.

actual_version: u32

Catalog resolver schema.

expected_backend: String

Expected resolver backend.

actual_backend: String

Catalog resolver backend.

InvalidCatalogDigest

Catalog digest is not exactly 32 lowercase hexadecimal bytes.

Fields

value: String

Invalid digest text.

InvalidAgreementDigest

Agreement digest is absent or not exactly 32 lowercase hexadecimal bytes.

Fields

value: String

Invalid digest text.

AgreementDigestMismatch

Stored agreement digest does not match the canonical Registry payload.

Fields

expected: String

Recomputed agreement digest.

actual: String

Stored agreement digest.

CatalogDigestMismatch

Stored catalog digest does not match the canonical authority payload.

Fields

expected: String

Recomputed digest.

actual: String

Stored digest.

UnknownSubnet

An exact Subnet lookup did not match a catalog row.

Fields

subnet_principal: String

Requested Subnet principal.

PrincipalPrefixNotFound

A Subnet principal prefix has no catalog match.

Fields

prefix: String

Requested principal prefix.

AmbiguousPrincipalPrefix

A Subnet principal prefix matches more than one catalog row.

Fields

prefix: String

Requested principal prefix.

matches: Vec<String>

Canonical Subnet principals matching the prefix.

RouteNotFound

No routing range covers the requested canister at this Registry version.

Fields

canister_principal: String

Canonical canister principal whose route was requested.

registry_version: u64

Registry version represented by the catalog.

catalog_schema_version: u32

Schema identifier retained by the catalog.

Trait Implementations

impl Debug for CatalogError

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

Formats the value using the given formatter.

impl Display for CatalogError

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

Formats the value using the given formatter.

impl Error for CatalogError

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.

impl From<Error> for CatalogError

fn from(source: Error) -> Self

Converts to this type from the input type.