Struct Identity 

pub struct Identity {
    pub peer_id: PeerId,
    pub libp2p_keypair: Keypair,
    pub hpke_context: HpkeContext,
}

Represents the user’s identity, including their libp2p and HPKE keypairs.

Fields

peer_id: PeerId

The user’s peer ID, derived from the libp2p public key.

libp2p_keypair: Keypair

The libp2p keypair.

hpke_context: HpkeContext

The HPKE context, containing the HPKE keypair.

Implementations

impl Identity

pub fn generate() -> Result<Self>

Generates a new identity.

This will create a new Identity with a randomly generated libp2p Ed25519 keypair and an HPKE X25519 keypair.

Errors

This function will return an error if key generation fails.

pub fn load_or_generate(path: &str) -> Result<Self>

Loads an identity from a file, or generates a new one if the file doesn’t exist.

Arguments

• path - The path to the identity file.

Errors

This function will return an error if loading or generating the identity fails.

pub fn load(path: &str) -> Result<Self>

Loads an identity from a file.

Arguments

• path - The path to the identity file.

Errors

This function will return an error if the file cannot be read or if the keypair data is invalid.

pub fn save(&self, path: &str) -> Result<()>

Saves the identity to a file.

Arguments

• path - The path to the identity file.

Errors

This function will return an error if the identity cannot be saved.

pub fn hpke_public_key(&self) -> Vec<u8>

Returns the HPKE public key bytes.

pub fn encrypt_for( &self, recipient_public_key: &[u8], plaintext: &[u8], ) -> Result<Vec<u8>>

Encrypts a message for a recipient using their public key.

Arguments

• recipient_public_key - The public key of the recipient.
• plaintext - The data to encrypt. This function will return an error if encryption fails.

pub fn decrypt_from( &self, sender_public_key: &[u8], ciphertext: &[u8], ) -> Result<Vec<u8>>

Decrypts a message from a sender using their public key.

Arguments

• sender_public_key - The public key of the sender.
• ciphertext - The data to decrypt.

Errors

This function will return an error if decryption fails.