Struct PasswordHasher 

pub struct PasswordHasher { /* private fields */ }

Stateless hasher — owns one Argon2 context preconfigured with the active parameters. Cheap to clone (the inner Argon2<'static> holds borrowed references to the static parameter struct only).

Implementations

impl PasswordHasher

pub fn with_params(params: Params) -> Self

Construct with explicit Argon2id parameters. Use the Default impl for the standard cost; reach for this only when tuning to non-standard hardware (e.g. a mobile-only deployment).

pub fn hash(&self, plaintext: &str) -> Result<String>

Hash a plaintext password. The returned PHC string is what crate::store::UserStore::set_password_hash persists.

The salt is sourced from rand::rng() (which delegates to the OS getrandom under the hood) so we don’t need to depend on password-hash’s rand_core 0.6 + getrandom feature pair just for the salt — rand 0.9 is already a direct dependency.

pub fn verify(&self, plaintext: &str, phc: &str) -> Result<bool>

Verify a plaintext password against a stored PHC hash.

Returns:

• Ok(true) if the password matches.
• Ok(false) if the password is wrong (but the stored hash parsed cleanly).
• Err(Error::Backend(_)) if the stored hash is malformed.

pub fn needs_rehash(&self, phc: &str) -> Result<bool>

Returns true when the stored hash was produced with parameters that differ from the current configuration. Callers should re-hash on the next successful login so the user’s stored hash drifts forward as we ratchet the cost.

Trait Implementations

impl Clone for PasswordHasher

fn clone(&self) -> PasswordHasher

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for PasswordHasher

fn default() -> Self

Returns the “default value” for a type.