Crypto.Saltine.Core.Hash

Hashing: Crypto.Saltine.Core.Hash

The hash function hashes a message ByteString and returns a hash. Hashes are always of length hash. The shorthash function hashes a message ByteString with respect to a secret key and returns a very short hash. Short hashes are always of length shorthash.

The hash function is designed to be usable as a strong component of DSA, RSA-PSS, key derivation, hash-based message-authentication codes, hash-based ciphers, and various other common applications. Strong means that the security of these applications, when instantiated with hash, is the same as the security of the applications against generic attacks. In particular, the hash function is designed to make finding collisions difficult.

hash is currently an implementation of SHA-512. shorthash is currently an implementation of SipHash-2-4 (https://131002.net/siphash/).

There has been considerable degradation of public confidence in the security conjectures for many hash functions, including SHA-512. However, for the moment, there do not appear to be alternatives that inspire satisfactory levels of confidence. One can hope that NIST's SHA-3 competition will improve the situation.

Sodium includes an implementation of the Blake2 hash (https://blake2.net/) but since this is not standard NaCl nor was Blake2 selected to be SHA-3 the library doesn't bind it.

This is version 2010.08.30 of the hash.html web page. Information about SipHash has been added.

Documentation

data ShorthashKey

An opaque shorthash cryptographic secret key.

Instances

Eq ShorthashKey

Defined in Crypto.Saltine.Core.Hash

Methods

(==) :: ShorthashKey -> ShorthashKey -> Bool

(/=) :: ShorthashKey -> ShorthashKey -> Bool

Ord ShorthashKey

Defined in Crypto.Saltine.Core.Hash

Methods

compare :: ShorthashKey -> ShorthashKey -> Ordering

(<) :: ShorthashKey -> ShorthashKey -> Bool

(<=) :: ShorthashKey -> ShorthashKey -> Bool

(>) :: ShorthashKey -> ShorthashKey -> Bool

(>=) :: ShorthashKey -> ShorthashKey -> Bool

max :: ShorthashKey -> ShorthashKey -> ShorthashKey

min :: ShorthashKey -> ShorthashKey -> ShorthashKey

IsEncoding ShorthashKey

Defined in Crypto.Saltine.Core.Hash

Methods

encode :: ShorthashKey -> ByteString

decode :: ByteString -> Maybe ShorthashKey

encoded :: (Choice p, Applicative f) => p ShorthashKey (f ShorthashKey) -> p ByteString (f ByteString)

hash

Arguments

:: ByteString

Message

-> ByteString

Hash

Computes a cryptographically collision-resistant hash making hash m == hash m' ==> m == m' highly likely even when under attack.

shorthash

Arguments

:: ShorthashKey

-> ByteString

Message

-> ByteString

Hash

Computes a very short, fast keyed hash.

newShorthashKey :: IO ShorthashKey

Randomly generates a new key for shorthash.