Struct Passport 

pub struct Passport { /* private fields */ }

The traveler’s held Passport: the token, its claims, and (once fetched) the descriptor. Fetching runs on a background thread; call Passport::poll once per frame, like the other Loom clients.

Implementations

impl Passport

pub fn from_token(token: impl Into<String>) -> Option<Self>

Hold a token. Claims decode best-effort — an opaque (non-JWT) dev token still carries, it just has no readable claims. Empty tokens are None: no passport is a valid, anonymous way to walk.

pub fn from_env() -> Option<Self>

The traveler’s passport from INFINITE_PASSPORT (unset/empty → anonymous).

pub fn token(&self) -> &str

The raw token, as presented on presence join / portal handoff.

pub fn claims(&self) -> &Claims

pub fn sub(&self) -> Option<&str>

The stable identity, if the token’s claims were readable.

pub fn display_name(&self) -> Option<&str>

Best display name: descriptor (freshest) → token claim → the sub itself.

pub fn descriptor(&self) -> Option<&Descriptor>

The fetched descriptor, once Passport::poll has collected it.

pub fn avatar_spec(&self) -> Option<&AvatarSpec>

The traveler’s own AvatarSpec (the shared avatar model), once the descriptor has landed and if the issuer provided one.

pub fn descriptor_error(&self) -> Option<&str>

Why the last descriptor fetch failed, if it did (e.g. 410 Gone after erasure — spec §6 — in which case the traveler renders anonymous).

pub fn fetch_descriptor(&mut self)

Start fetching the descriptor from the token’s avatar claim on a background thread. No-op without a claim URL, while a fetch is in flight, or once loaded (the descriptor is session-cached; spec §3).

pub fn poll(&mut self) -> bool

Collect a finished background fetch, if any. Call once per frame. Returns true on the frame the descriptor arrives.