Struct Argon2

pub struct Argon2<const S: usize>
where
    Salt<S>: Argon2Compatible,
{ /* private fields */ }

Argon2 password hashing implementation

This struct provides methods for password hashing using the Argon2 algorithm, which is designed to be resistant against various attacks including GPU cracking and side-channel attacks.

Implementations

impl<const S: usize> Argon2<S>

where Salt<S>: Argon2Compatible,

pub fn new_with_params(params: Params<S>) -> Self

Creates a new Argon2 instance with the specified parameters

pub fn hash_password(&self, password: &[u8]) -> Result<Zeroizing<Vec<u8>>>

Hashes a password using the configured Argon2 parameters

Arguments

• password - The password to hash

Returns

• A Result containing the hashed password as a zeroizing byte vector

Trait Implementations

impl<const S: usize> Clone for Argon2<S>

where Salt<S>: Argon2Compatible,

fn clone(&self) -> Argon2<S>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<const S: usize> KeyDerivationFunction for Argon2<S>

where Salt<S>: Argon2Compatible + Clone + Zeroize + Send + Sync + 'static, Params<S>: Default + Clone + Zeroize + Send + Sync + 'static,

type Algorithm = Argon2Algorithm

The algorithm this KDF implements

type Salt = Salt<S>

Salt type with appropriate validation

fn new() -> Self

Creates a new instance of the KDF with default parameters

fn builder(&self) -> impl KdfOperation<'_, Self::Algorithm>

where Self: Sized,

Creates a builder for fluent API usage - FIXED: Elided lifetime

fn generate_salt<R: RngCore + CryptoRng>(rng: &mut R) -> Self::Salt

Generate a random salt with appropriate size

fn derive_key( &self, input: &[u8], salt_override: Option<&[u8]>, info_override: Option<&[u8]>, length_override: usize, ) -> Result<Vec<u8>>

Derives a key using the KDF parameters

fn security_level() -> SecurityLevel

Returns the security level of the KDF in bits

impl<const S: usize> ParamProvider for Argon2<S>

where Salt<S>: Argon2Compatible, Params<S>: Default + Clone + Zeroize + Send + Sync + 'static,

type Params = Params<S>

The parameter type associated with this algorithm

fn with_params(params: Self::Params) -> Self

Creates a new instance with the specified parameters

fn params(&self) -> &Self::Params

Returns the current parameters

fn set_params(&mut self, params: Self::Params)

Updates the parameters

impl<const S: usize> PasswordHashFunction for Argon2<S>

where Salt<S>: Argon2Compatible + Clone + Zeroize + Send + Sync + 'static, Params<S>: Default + Clone + Zeroize + Send + Sync + 'static,

type Password = SecretBytes<32>

Password type with zeroizing

fn hash_password(&self, password: &Self::Password) -> Result<PasswordHash>

Hashes a password with the configured parameters

fn verify( &self, password: &Self::Password, stored_hash: &PasswordHash, ) -> Result<bool>

Verifies a password against a hash

fn benchmark(&self) -> Duration

Benchmarks the current parameters on this system

fn recommended_params(_target_duration: Duration) -> Self::Params

Recommends parameters based on a target duration