#include <xmss_wots.h>

Inheritance diagram for Botan::XMSS_WOTS_PublicKey:

Public Member Functions
const wots_keysig_t &	key_data () const

	XMSS_WOTS_PublicKey (XMSS_WOTS_Parameters params, std::span< const uint8_t > public_seed, const XMSS_WOTS_PrivateKey &private_key, XMSS_Address &adrs, XMSS_Hash &hash)

	XMSS_WOTS_PublicKey (XMSS_WOTS_Parameters params, std::span< const uint8_t > public_seed, wots_keysig_t signature, const secure_vector< uint8_t > &msg, XMSS_Address &adrs, XMSS_Hash &hash)

Protected Attributes
wots_keysig_t	m_key_data

XMSS_WOTS_Parameters	m_params

Detailed Description

A Winternitz One Time Signature public key for use with Extended Hash-Based Signatures.

Definition at line 49 of file xmss_wots.h.

Constructor & Destructor Documentation

◆ XMSS_WOTS_PublicKey() [1/2]

Botan::XMSS_WOTS_PublicKey::XMSS_WOTS_PublicKey	(	XMSS_WOTS_Parameters	params,
		std::span< const uint8_t >	public_seed,
		const XMSS_WOTS_PrivateKey &	private_key,
		XMSS_Address &	adrs,
		XMSS_Hash &	hash )

Algorithm 4: "WOTS_genPK" Initializes a Winternitz One Time Signature+ (WOTS+) Public Key's key data, with passed-in private key data using the WOTS chaining function.

This overload is used in multithreaded scenarios, where it is required to provide seperate instances of XMSS_Hash to each thread.

Parameters

params	The WOTS parameters to use
public_seed	The public seed for the public key generation
private_key	The private key to derive the public key from
adrs	The address of the key to retrieve.
hash	Instance of XMSS_Hash, that may only be used by the thread executing at.

Definition at line 79 of file xmss_wots.cpp.

                                                          :
      XMSS_WOTS_Base(std::move(params), private_key.key_data()) {
   for(size_t i = 0; i < m_params.len(); ++i) {
      adrs.set_chain_address(static_cast<uint32_t>(i));
      chain(m_params, m_key_data[i], 0, m_params.wots_parameter() - 1, adrs, public_seed, hash);
   }
}

References Botan::XMSS_WOTS_Parameters::len(), Botan::XMSS_WOTS_Base::m_key_data, Botan::XMSS_WOTS_Base::m_params, Botan::XMSS_Address::set_chain_address(), and Botan::XMSS_WOTS_Parameters::wots_parameter().

◆ XMSS_WOTS_PublicKey() [2/2]

Botan::XMSS_WOTS_PublicKey::XMSS_WOTS_PublicKey	(	XMSS_WOTS_Parameters	params,
		std::span< const uint8_t >	public_seed,
		wots_keysig_t	signature,
		const secure_vector< uint8_t > &	msg,
		XMSS_Address &	adrs,
		XMSS_Hash &	hash )

Creates a XMSS_WOTS_PublicKey from a message and signature using Algorithm 6 WOTS_pkFromSig defined in the XMSS standard. This overload is used to verify a message using a public key.

Parameters

params	The WOTS parameters to use
public_seed	The public seed to derive the key with
signature	A WOTS signature for msg.
msg	A message.
adrs	The address of the key to retrieve.
hash	Instance of XMSS_Hash, that may only be used by the thread executing at.

Definition at line 91 of file xmss_wots.cpp.

                                                          :
      XMSS_WOTS_Base(std::move(params), std::move(signature)) {
   secure_vector<uint8_t> msg_digest{m_params.base_w(msg, m_params.len_1())};
 
   m_params.append_checksum(msg_digest);
 
   for(size_t i = 0; i < m_params.len(); i++) {
      adrs.set_chain_address(static_cast<uint32_t>(i));
      chain(m_params,
            m_key_data[i],
            msg_digest[i],
            m_params.wots_parameter() - 1 - msg_digest[i],
            adrs,
            public_seed,
            hash);
   }
}