Struct Identity 

pub struct Identity {
    pub keypair: Keypair,
    pub peer_id: PeerId,
    pub fingerprint: String,
    pub profile: UserProfile,
}

In-memory identity: the loaded keypair and all derived or persisted metadata.

Constructed either by Identity::generate (first login) or Identity::load (subsequent daemon starts).

Identity does not implement Debug because libp2p::identity::Keypair does not expose a Debug impl (the bytes are considered secret).

Fields

keypair: Keypair

The Ed25519 keypair. Treat as secret — never log or serialise directly.

peer_id: PeerId

libp2p peer identifier derived deterministically from the public key.

fingerprint: String

Hex-encoded SHA-256(pubkey)[0..8] — 16 characters, immutable for this identity.

profile: UserProfile

Persisted profile (alias, creation timestamp, etc.).

Implementations

impl Identity

pub fn generate( alias: Option<String>, passphrase: Option<&str>, ) -> BpResult<Self>

Generate a brand-new Ed25519 identity and persist it.

If passphrase is Some, the keypair is encrypted with Argon2id + ChaCha20-Poly1305 and written to identity.key.enc. If None, the raw protobuf bytes are written to identity.key (backwards-compatible).

pub fn load(passphrase: Option<&str>) -> BpResult<Self>

Load existing identity from disk.

• If identity.key.enc exists, passphrase is required. Passing None returns BpError::Identity with a descriptive message.
• If identity.key exists (plaintext), the passphrase argument is ignored.
• If neither file exists, returns BpError::NotAuthenticated.

pub fn remove() -> BpResult<()>

Remove identity from disk (logout). Removes both plaintext and encrypted key files if present, plus the profile.

pub fn exists() -> BpResult<bool>

Returns true if any identity (plaintext or encrypted) is stored on disk.

pub fn secret_material(&self) -> [u8; 32]

Derive 32 bytes of secret material from the keypair.

Used as the master input for per-file Content Encryption Key (CEK) derivation. The output is deterministic for a given keypair but must never be stored or logged — treat it like the private key itself.

pub fn export_to_file(dest: &Path) -> BpResult<()>

Export this identity to a portable JSON file at dest.

The on-disk key files are copied verbatim: passphrase-protected identities export the encrypted form (no passphrase needed here); plaintext identities hex-encode the raw protobuf bytes. The output file is safe to transfer to another machine; use Identity::import_from_file on the receiving end.

pub fn import_from_file(src: &Path, overwrite: bool) -> BpResult<UserProfile>

Import an identity from a portable export file created by Identity::export_to_file.

Installs the keypair and profile to the XDG data directory. Returns the imported UserProfile on success.

If an identity already exists and overwrite is false, returns BpError::Config with a message asking the user to bp logout first.

Trait Implementations

impl Clone for Identity

fn clone(&self) -> Identity

Returns a duplicate of the value.

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

Performs copy-assignment from source.