#include <xmss_hash.h>

Public Member Functions
void	f (secure_vector< uint8_t > &result, const secure_vector< uint8_t > &key, const secure_vector< uint8_t > &data)

void	h (secure_vector< uint8_t > &result, const secure_vector< uint8_t > &key, const secure_vector< uint8_t > &data)

secure_vector< uint8_t >	h_msg (const secure_vector< uint8_t > &randomness, const secure_vector< uint8_t > &root, const secure_vector< uint8_t > &index_bytes, const secure_vector< uint8_t > &data)

secure_vector< uint8_t >	h_msg_final ()

void	h_msg_init (const secure_vector< uint8_t > &randomness, const secure_vector< uint8_t > &root, const secure_vector< uint8_t > &index_bytes)

void	h_msg_update (const uint8_t data[], size_t size)

size_t	output_length () const

void	prf (secure_vector< uint8_t > &result, const secure_vector< uint8_t > &key, const secure_vector< uint8_t > &data)

secure_vector< uint8_t >	prf (const secure_vector< uint8_t > &key, const secure_vector< uint8_t > &data)

	XMSS_Hash (const std::string &h_func_name)

	XMSS_Hash (const XMSS_Hash &hash)

Detailed Description

A collection of pseudorandom hash functions required for XMSS and WOTS computations.

Definition at line 21 of file xmss_hash.h.

Constructor & Destructor Documentation

Botan::XMSS_Hash::XMSS_Hash ( const std::string & h_func_name )

Definition at line 20 of file xmss_hash.cpp.

References BOTAN_ASSERT.

                                                  :
    m_hash(HashFunction::create(h_func_name)),
    m_hash_func_name(h_func_name)
    {
    if(!m_hash)
       throw Lookup_Error("XMSS cannot use hash " + h_func_name +
                          " because it is unavailable");
 
    m_output_length = m_hash->output_length();
    BOTAN_ASSERT(m_output_length > 0, "Hash output length of zero is invalid.");
 
    m_zero_padding.resize(m_output_length - 1);
    m_msg_hash.reset(m_hash->clone());
    }

Botan::XMSS_Hash::XMSS_Hash ( const XMSS_Hash & hash )

Definition at line 15 of file xmss_hash.cpp.

    : XMSS_Hash(hash.m_hash_func_name)
    {
    }

Member Function Documentation

void Botan::XMSS_Hash::f	(	secure_vector< uint8_t > &	result,
		const secure_vector< uint8_t > &	key,
		const secure_vector< uint8_t > &	data
	)

inline

F is a keyed cryptographic hash function used by the WOTS+ algorithm.

Parameters

[out]	result	The hash calculated using key and data.
[in]	key	key of length n bytes.
[in]	data	string of arbitrary length.

Definition at line 71 of file xmss_hash.h.

Referenced by Botan::XMSS_WOTS_PublicKey::chain().

          {
          m_hash->update(m_zero_padding);
          m_hash->update(m_id_f);
          m_hash->update(key);
          m_hash->update(data);
          m_hash->final(result);
          }

void Botan::XMSS_Hash::h	(	secure_vector< uint8_t > &	result,
		const secure_vector< uint8_t > &	key,
		const secure_vector< uint8_t > &	data
	)

Cryptographic hash function h accepting n byte keys and 2n byte strings of data.

Parameters

[out]	result	The hash calculated using key and data.
[in]	key	key of length n bytes.
[in]	data	string of 2n bytes length.

Definition at line 36 of file xmss_hash.cpp.

Referenced by Botan::XMSS_WOTS_PrivateKey::at(), and Botan::XMSS_Common_Ops::randomize_tree_hash().

    {
    m_hash->update(m_zero_padding);
    m_hash->update(m_id_h);
    m_hash->update(key);
    m_hash->update(data);
    m_hash->final(result);
    }

secure_vector< uint8_t > Botan::XMSS_Hash::h_msg	(	const secure_vector< uint8_t > &	randomness,
		const secure_vector< uint8_t > &	root,
		const secure_vector< uint8_t > &	index_bytes,
		const secure_vector< uint8_t > &	data
	)

Cryptographic hash function h accepting 3n byte keys and data strings of arbitrary length.

Parameters

randomness	n-byte value.
root	n-byte root node.
index_bytes	Index value padded with leading zeros.
data	string of arbitrary length.

Returns: hash value of n-bytes length.

Definition at line 70 of file xmss_hash.cpp.

References h_msg_init().

    {
    h_msg_init(randomness, root, index_bytes);
    m_msg_hash->update(data);
    return m_msg_hash->final();
    }

secure_vector< uint8_t > Botan::XMSS_Hash::h_msg_final ( )

Finalizes buffered h_msg computation and retrieves the result.

Returns: Hash calculated using the prefix set by h_msg_init() and message blocks provided through calls to h_msg_update().

Definition at line 64 of file xmss_hash.cpp.

Referenced by Botan::XMSS_Signature_Operation::sign().

    {
    return m_msg_hash->final();
    }

void Botan::XMSS_Hash::h_msg_init	(	const secure_vector< uint8_t > &	randomness,
		const secure_vector< uint8_t > &	root,
		const secure_vector< uint8_t > &	index_bytes
	)

Initializes buffered h_msg computation with prefix data.

Parameters

randomness	random n-byte value.
root	n-byte root node.
index_bytes	Index value padded with leading zeros.

Definition at line 47 of file xmss_hash.cpp.

Referenced by h_msg().

    {
    m_msg_hash->clear();
    m_msg_hash->update(m_zero_padding);
    m_msg_hash->update(m_id_hmsg);
    m_msg_hash->update(randomness);
    m_msg_hash->update(root);
    m_msg_hash->update(index_bytes);
    }

void Botan::XMSS_Hash::h_msg_update	(	const uint8_t	data[],
		size_t	size
	)

Adds a message block to buffered h_msg computation.

Parameters

data	A message block
size	Length of the message block in bytes.

Definition at line 59 of file xmss_hash.cpp.

Referenced by Botan::XMSS_Signature_Operation::update().

    {
    m_msg_hash->update(data, size);
    }

size_t Botan::XMSS_Hash::output_length ( ) const

inline

Definition at line 137 of file xmss_hash.h.

Referenced by Botan::XMSS_WOTS_PublicKey::chain().

137 { return m_output_length; }

void Botan::XMSS_Hash::prf	(	secure_vector< uint8_t > &	result,
		const secure_vector< uint8_t > &	key,
		const secure_vector< uint8_t > &	data
	)

inline

Pseudoranom function creating a hash out of a key and data using a cryptographic hash function.

Parameters

[out]	result	The hash calculated using key and data.
[in]	key	An n-byte key value.
[in]	data	A 32-byte XMSS_Address data value

Definition at line 35 of file xmss_hash.h.

Referenced by Botan::XMSS_WOTS_PrivateKey::at(), Botan::XMSS_WOTS_PublicKey::chain(), and Botan::XMSS_Common_Ops::randomize_tree_hash().

          {
          m_hash->update(m_zero_padding);
          m_hash->update(m_id_prf);
          m_hash->update(key);
          m_hash->update(data);
          m_hash->final(result);
          }

secure_vector<uint8_t> Botan::XMSS_Hash::prf	(	const secure_vector< uint8_t > &	key,
		const secure_vector< uint8_t > &	data
	)

inline

Pseudoranom function creating a hash out of a key and data using a cryptographic hash function.

Parameters

[in]	key	An n-byte key value.
[in]	data	A 32-byte XMSS_Address data value

Returns: result The hash calculated using key and data.

Definition at line 54 of file xmss_hash.h.

          {
          m_hash->update(m_zero_padding);
          m_hash->update(m_id_prf);
          m_hash->update(key);
          m_hash->update(data);
          return m_hash->final();
          }

The documentation for this class was generated from the following files:

src/lib/pubkey/xmss/xmss_hash.h
src/lib/pubkey/xmss/xmss_hash.cpp

Public Member Functions

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation