Struct ContactEntry 

pub struct ContactEntry {
    pub id: String,
    pub entry_type: String,
    pub value: String,
    pub label: Option<String>,
    pub platform: Option<String>,
    pub handle: Option<String>,
    pub visibility: Visibility,
    pub verified: Option<bool>,
}

A single contact entry in an entity’s contact directory.

Each entry represents one reachable channel (phone, email, social profile, etc.) with its own visibility level for access control.

DHT Behavior

For entries where visibility is not public, the DHT-stored copy contains:

{
  "id": "phone-1",
  "entryType": "phone",
  "label": "Support",
  "visibility": "organization",
  "available": true,
  "value": null
}

The actual value is only served via the authenticated OASPrivateEndpointService.

Examples

use oas_document::contact::ContactEntry;
use oas_document::visibility::Visibility;

let phone = ContactEntry {
    id: "phone-1".to_string(),
    entry_type: "phone".to_string(),
    value: "tel:+15551234567".to_string(),
    label: Some("Primary".to_string()),
    platform: None,
    handle: None,
    visibility: Visibility::Public,
    verified: Some(true),
};
assert_eq!(phone.entry_type, "phone");

Fields

id: String

Fragment identifier (e.g., “phone-1”, “email-2”, “social-x”).

entry_type: String

Entry type: "phone", "email", "social", "website", "messaging".

value: String

The contact value. Format depends on type:

• phone: tel:+15551234567
• email: mailto:agent@example.com
• social: https://x.com/agent
• website: https://example.com/agent
• messaging: https://t.me/agent_bot

label: Option<String>

Human-readable label (e.g., “Primary”, “Support”, “Sales”, “Personal”).

platform: Option<String>

Platform name for social/messaging entries (e.g., “x”, “linkedin”, “discord”, “telegram”, “github”, “slack”, “whatsapp”, “signal”).

handle: Option<String>

Handle/username for social/messaging entries (e.g., “@agent42”).

visibility: Visibility

Who can see this entry’s actual value. Non-public entries show only the capability flag on the DHT.

verified: Option<bool>

Whether this contact channel has been verified by the entity.

Trait Implementations

impl Clone for ContactEntry

fn clone(&self) -> ContactEntry

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ContactEntry

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ContactEntry

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for ContactEntry

impl PartialEq for ContactEntry

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for ContactEntry

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 ContactEntry