Crypto.HashString

binary string types supporting constant-time base16 encoding and decoding, as well as constant time lexicographic comparisons. Note that the time required does depend linearly on length, but is otherwise data-independent.

Documentation

data HashString

Type intended to represent short-ish cryptographic values, say up to 128 bytes or so. Supports constant-time comparisons (i.e. run time depends on length of the inputs but is otherwise independent of content), as well as constant-time base16 and base64 conversions.

Instances

IsString HashString

Defined in Crypto.HashString.Implementation

Methods

fromString :: String -> HashString

Monoid HashString

Defined in Crypto.HashString.Implementation

Methods

mempty :: HashString

mappend :: HashString -> HashString -> HashString

mconcat :: [HashString] -> HashString

Semigroup HashString

Defined in Crypto.HashString.Implementation

Methods

(<>) :: HashString -> HashString -> HashString

sconcat :: NonEmpty HashString -> HashString

stimes :: Integral b => b -> HashString -> HashString

Show HashString

Defined in Crypto.HashString.Implementation

Methods

showsPrec :: Int -> HashString -> ShowS

show :: HashString -> String

showList :: [HashString] -> ShowS

Eq HashString

Defined in Crypto.HashString.Implementation

Methods

(==) :: HashString -> HashString -> Bool

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

Ord HashString

Defined in Crypto.HashString.Implementation

Methods

compare :: HashString -> HashString -> Ordering

(<) :: HashString -> HashString -> Bool

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

(>) :: HashString -> HashString -> Bool

(>=) :: HashString -> HashString -> Bool

max :: HashString -> HashString -> HashString

min :: HashString -> HashString -> HashString

fromShort :: ShortByteString -> HashString

fromShortBase16 :: ShortByteString -> Maybe HashString

toShort :: HashString -> ShortByteString

toShortBase16 :: HashString -> ShortByteString

fromByteString :: ByteString -> HashString

fromBase16 :: ByteString -> Maybe HashString

toByteString :: HashString -> ByteString

toBase16 :: HashString -> ByteString

toBase16Builder :: HashString -> Builder

xorLeft :: HashString -> HashString -> HashString

Xor two hashstrings. The length of the result is always the same as the length of the left argument; bytes are either removed from or added to the end of the right argument as needed to match length.

xorMin :: HashString -> HashString -> HashString

Xor two hashstrings. The length of the result is always the same as the length of the shorter argument, removing bytes from the end of the longer string as needed to match length.

xorMax :: HashString -> HashString -> HashString

Xor two hashstrings. The length of the result is always the same as the length of the longer argument, adding null bytes onto the end of the shorter string as needed to match length.

takeBytes :: Foldable f => Int -> f HashString -> [HashString]