Struct UserIdentity 

pub struct UserIdentity {
    pub user_id: UserId,
    pub public_key: Vec<u8>,
    pub display_name_hint: String,
    pub three_word_address: String,
    pub created_at: SystemTime,
    pub version: u32,
    pub verification_level: VerificationLevel,
}

Basic user identity containing core identification information

This struct represents the fundamental identity of a user in the P2P system. It contains cryptographic proof of identity, addressing information, and verification status. The identity is designed to be lightweight and can be shared publicly without revealing sensitive personal information.

Fields

user_id: UserId

Unique identifier derived from the user’s public key

public_key: Vec<u8>

ML-DSA public key bytes

display_name_hint: String

Truncated display name (first 20 chars) for privacy protection

three_word_address: String

Human-readable three-word address for easy network identification

created_at: SystemTime

Timestamp when this identity was created

version: u32

Version number for identity updates and compatibility

verification_level: VerificationLevel

Current verification status of this identity

Implementations

impl UserIdentity

pub fn new(display_name: String, three_word_address: String) -> Result<Self>

Create new user identity with cryptographic keypair

Generates a new ML-DSA keypair and creates a corresponding user identity. The user ID is derived from the public key to ensure uniqueness.

Arguments

• display_name - Full display name (will be truncated for hint)
• three_word_address - Human-readable three-word network address

Returns

A tuple containing the new identity and its associated keypair

Errors

Returns error if cryptographic key generation fails

pub fn derive_user_id(public_key_bytes: &[u8]) -> UserId

Derive deterministic user ID from public key

Uses SHA-256 hash of the public key to create a unique, deterministic user identifier. This ensures the same public key always produces the same user ID.

Arguments

• public_key - ML-DSA public key to derive ID from

Returns

Hexadecimal string representation of the SHA-256 hash

pub fn create_display_name_hint(display_name: &str) -> String

Create privacy-preserving display name hint

Truncates the full display name to the first 20 characters to provide a hint for identification while preserving privacy. This prevents full name disclosure in public identity records.

Arguments

• display_name - Full display name to create hint from

Returns

Truncated display name (max 20 characters)

pub fn get_profile_dht_key(&self) -> Key

Get DHT storage key for this identity’s profile

Creates a deterministic DHT key based on the user ID for storing and retrieving the encrypted user profile from the distributed hash table.

Returns

DHT key for profile storage location

Trait Implementations

impl Clone for UserIdentity

fn clone(&self) -> UserIdentity

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for UserIdentity

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for UserIdentity

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for UserIdentity

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

where __S: Serializer,

Serialize this value into the given Serde serializer.