Struct AgentCard 

pub struct AgentCard {
    pub display_name: String,
    pub agent_id: String,
    pub machine_id: String,
    pub user_id: Option<String>,
    pub addresses: Vec<String>,
    pub groups: Vec<CardGroup>,
    pub stores: Vec<CardStore>,
    pub created_at: u64,
    pub dm_capabilities: Option<DmCapabilities>,
}

A shareable identity card for an x0x agent.

Contains everything someone needs to find and trust you on the network.

Fields

display_name: String

Human-readable display name (e.g., “David”, “alice-bot”).

agent_id: String

Agent ID (hex-encoded, 64 chars).

machine_id: String

Machine ID (hex-encoded, 64 chars). The ant-quic raw public key hash.

user_id: Option<String>

User ID (hex-encoded, 64 chars). Only present if the agent has a human identity and chose to include it.

addresses: Vec<String>

Network addresses where this agent can be reached (IP:port). May be empty if the agent hasn’t announced yet.

groups: Vec<CardGroup>

Groups this agent belongs to, with invite links. Allows one-click “add me AND join my groups”.

stores: Vec<CardStore>

KvStore topics this agent wants to share.

created_at: u64

Unix seconds when this card was generated.

dm_capabilities: Option<DmCapabilities>

Direct-messaging transport capabilities advertised by this agent. Added in x0x 0.18 (C — DM over gossip). Cards predating 0.18 carry None, interpreted by senders as “raw-QUIC / legacy only”.

Implementations

impl AgentCard

pub fn new(display_name: String, agent_id: &AgentId, machine_id: &str) -> Self

Create a new agent card.

pub fn to_link(&self) -> String

Encode this card as a shareable link.

Format: x0x://agent/<base64url(json)>

pub fn from_link(link: &str) -> Result<Self, String>

Parse a card from a link string.

Accepts x0x://agent/<base64> or raw base64.

Errors

Returns an error if the link is malformed.

pub fn short_display(&self) -> String

Get a short display string for this card.

Trait Implementations

impl Clone for AgentCard

fn clone(&self) -> AgentCard

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AgentCard

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AgentCard

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for AgentCard

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.