Enum WebvhPathMode 

pub enum WebvhPathMode {
    WellKnown,
    Explicit(String),
    AutoAssign,
}

How the <path> segment of a server-managed did:webvh is chosen.

Only meaningful when a hosting server is selected (server_id is set). A serverless DID always resolves at <host>/.well-known/did.jsonl and ignores this — serverless mode is selected by the absence of server_id, not by this enum. The three variants map onto the hosting server’s check-name / create_did path contract:

• WebvhPathMode::WellKnown → the reserved .well-known root slot (<host>/.well-known/did.jsonl). Admin-gated on the host.
• WebvhPathMode::Explicit → an operator-chosen label (<host>/<path>/did.jsonl).
• WebvhPathMode::AutoAssign → the host allocates a path (it mints a fresh mnemonic). This is the default.

AutoAssign is the default because that is the long-standing “no path given → the server assigns one” contract: the setup wizard’s “leave blank → server-assigned” prompt maps a blank path here. An absent path has never meant the .well-known root on a hosting server — that is the serverless case (selected by the absence of a server_id, where the DID location comes from the URL itself).

Variants

WellKnown

Root DID at the host: resolves at <host>/.well-known/did.jsonl.

Explicit(String)

Operator-chosen path label: <host>/<path>/did.jsonl.

AutoAssign

Let the hosting server allocate the path.

Implementations

impl WebvhPathMode

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

The path string to hand the hosting server’s check-name / create_did call. Some(".well-known") / Some(label) reserve a specific slot; None tells the host to allocate one (the auto-assign contract — the host mints a mnemonic).

Returning None for AutoAssign is load-bearing: the DIDComm/REST clients must omit the path wire field for auto-assign. Sending an empty string instead makes the host reject it with e.p.did.path-invalid (“path must not be empty”), since the host validates a present-but-empty path.

pub fn resolve( path_mode: Option<WebvhPathMode>, legacy_path: Option<String>, ) -> Self

Resolve the effective mode from the new explicit path_mode field and the legacy path: Option<String> field. path_mode wins when present; otherwise the legacy path is interpreted (via From<Option<String>>) so pre-enum callers keep working.

Trait Implementations

impl Clone for WebvhPathMode

fn clone(&self) -> WebvhPathMode

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WebvhPathMode

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

Formats the value using the given formatter.

impl Default for WebvhPathMode

fn default() -> WebvhPathMode

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for WebvhPathMode

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for WebvhPathMode

impl From<Option<String>> for WebvhPathMode

fn from(path: Option<String>) -> Self

Converts to this type from the input type.

impl From<String> for WebvhPathMode

fn from(path: String) -> Self

Converts to this type from the input type.

impl PartialEq for WebvhPathMode

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for WebvhPathMode

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 WebvhPathMode