Struct Argon2 

pub struct Argon2 {
    pub m_cost: u32,
    pub t_cost: u32,
    pub p_cost: u32,
    pub hash_length: u64,
    pub algorithm: Algorithm,
    pub version: Version,
}

Argon2 instance

Parameters

• m_cost - The memory cost in kibibytes
• t_cost - Iteration cost
• p_cost - Parallelization
• hash_length - The length of the hash in bytes
• algorithm - The algorithm to use
• version - The version of the algorithm to use

By default it will use the Argon2id with a 64 byte hash length (maximum).

It is not recomended to change them, the default values are fine for most use cases.

Generally speaking you don’t want to mess with the t_cost and p_cost parameters a lot. For max security the p_cost should be set to 1 and the t_cost could be anything between 8 and 30. That also depends on the m_cost which is the most important parameter. The higher the m_cost the more secure the hash is but the time it takes to compute it increases linearly.

Presets

There are some presets for the Argon2 struct that you can use.

• Argon2::very_fast()
• Argon2::fast()
• Argon2::balanced()
• Argon2::slow()
• Argon2::very_slow()

Fields

m_cost: u32

t_cost: u32

p_cost: u32

hash_length: u64

algorithm: Algorithm

By default we use the Argon2id

version: Version

By default we use the version 0x13

Implementations

impl Argon2

pub fn new(m_cost: u32, t_cost: u32, p_cost: u32) -> Self

Create a new Argon2 instance with the given parameters.

By default it will use the Argon2id with a 64 byte hash length.

Arguments

• m_cost - The memory cost in kibibytes
• t_cost - Iteration cost
• p_cost - Parallelization

pub fn with_algorithm(self, algorithm: Algorithm) -> Self

pub fn with_version(self, version: Version) -> Self

pub fn with_hash_length(self, hash_length: u64) -> Self

pub fn hash_password( &self, password: &str, salt: Vec<u8>, ) -> Result<Vec<u8>, Error>

Hashes the given password

Arguments

• password - The password to hash
• salt - The salt to use for hashing

Returns

The hash of the password in its raw byte form

impl Argon2

pub fn very_fast() -> Self

pub fn fast() -> Self

pub fn balanced() -> Self

pub fn slow() -> Self

pub fn very_slow() -> Self

Trait Implementations

impl Clone for Argon2

fn clone(&self) -> Argon2

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Argon2

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

Formats the value using the given formatter.

impl Default for Argon2

fn default() -> Argon2

Returns the “default value” for a type.