Enum Principal 

#[non_exhaustive]
pub enum Principal {
    Unauthenticated,
    External(ExternalId),
    System,
}

Authority principal. Three states, exhaustively type-checked.

• Unauthenticated: caller identity has not been verified by L2 (pre-auth lobby, anonymous submit path). Authorization paths must treat this distinctly from External(_).
• External: L2-verified external identity.
• System: kernel-internal origin (init, signal-relay, cleanup cascade, replay re-injection). Ships as a payloadless variant; a SystemOrigin payload widening is reserved (deferred).

#[non_exhaustive] protects the ABI: external consumers cannot match exhaustively, so adding variants is not a breaking change for them. Within-crate consumers see every variant and are forced by the linter to match exhaustively.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Unauthenticated

Caller identity has not been verified by L2 (pre-auth lobby, anonymous submit path).

External(ExternalId)

L2-verified external identity.

System

Kernel-internal origin (init, signal-relay, cleanup cascade, replay re-injection).

Trait Implementations

impl Clone for Principal

fn clone(&self) -> Principal

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Principal

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Principal

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Principal

fn eq(&self, other: &Principal) -> 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 Principal

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 Principal

impl StructuralPartialEq for Principal