Enum NameSource 

pub enum NameSource {
    AgentName {
        verified: bool,
    },
    AclLabel,
    DeviceName,
    LocalAlias,
    ServerLabel,
    ContextName,
}

Where a display name came from.

Kept as a distinct type rather than folding everything into a String because the sources are not equally trustworthy, and the difference has to survive all the way to the pixel — see the module-level note on trust.

Variants

AgentName

An alsoKnownAs entry on the DID’s own document.

verified means the name was resolved forward and led back to this same DID. verified == false is a bare self-assertion and is the least trustworthy source there is.

Fields

verified: bool

AclLabel

AclEntry.label / VtcAclEntry.label — operator-typed, our store.

DeviceName

A DeviceBinding.display_name from an agent device registration.

LocalAlias

The name of a locally-configured VTA / community (~/.config/{pnm,cnm}).

ServerLabel

WebvhServerRecord.label — names a DID-hosting server.

ContextName

ContextRecord.name — names a context, used for the context’s own DID.

Implementations

impl NameSource

pub fn rank(self) -> u8

Precedence when two sources name the same DID. Higher wins.

A verified agent name outranks everything: it is globally meaningful and cryptographically bound to the DID, where a local label is one operator’s private note. An unverified agent name ranks below every local source for the reason in the module docs — the operator’s own data must never be displaced by a stranger’s unchecked claim.

pub fn as_str(self) -> &'static str

Stable machine-readable tag, used for the nameSource field in --json output. Kebab-case so it reads well through jq.

pub fn is_trusted(self) -> bool

Whether a name from this source may be shown without qualification.

False only for an unverified agent name.

Trait Implementations

impl Clone for NameSource

fn clone(&self) -> NameSource

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for NameSource

impl Debug for NameSource

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

Formats the value using the given formatter.

impl Eq for NameSource

impl PartialEq for NameSource

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for NameSource

fn serialize<S>( &self, s: S, ) -> Result<<S as Serializer>::Ok, <S as Serializer>::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for NameSource