#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 80 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_Base::key_data(), Botan::XMSS_WOTS_Base::m_key_data, Botan::XMSS_WOTS_Base::m_params, Botan::XMSS_Address::set_chain_address(), and Botan::XMSS_WOTS_Base::XMSS_WOTS_Base().

◆ 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 92 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);
   }
}

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

Member Function Documentation

◆ key_data()

const wots_keysig_t & Botan::XMSS_WOTS_Base::key_data ( ) const

inlineinherited

Definition at line 38 of file xmss_wots.h.

38{ return m_key_data; }

References m_key_data.

Referenced by Botan::XMSS_WOTS_PrivateKey::sign(), XMSS_WOTS_Base(), and Botan::XMSS_WOTS_PublicKey::XMSS_WOTS_PublicKey().

Member Data Documentation

◆ m_key_data

wots_keysig_t Botan::XMSS_WOTS_Base::m_key_data

protectedinherited

Definition at line 42 of file xmss_wots.h.

Referenced by key_data(), XMSS_WOTS_Base(), Botan::XMSS_WOTS_PrivateKey::XMSS_WOTS_PrivateKey(), Botan::XMSS_WOTS_PrivateKey::XMSS_WOTS_PrivateKey(), Botan::XMSS_WOTS_PublicKey::XMSS_WOTS_PublicKey(), and Botan::XMSS_WOTS_PublicKey::XMSS_WOTS_PublicKey().

◆ m_params

XMSS_WOTS_Parameters Botan::XMSS_WOTS_Base::m_params

protectedinherited

Definition at line 41 of file xmss_wots.h.

Referenced by Botan::XMSS_WOTS_PrivateKey::sign(), XMSS_WOTS_Base(), XMSS_WOTS_Base(), Botan::XMSS_WOTS_PrivateKey::XMSS_WOTS_PrivateKey(), Botan::XMSS_WOTS_PrivateKey::XMSS_WOTS_PrivateKey(), Botan::XMSS_WOTS_PublicKey::XMSS_WOTS_PublicKey(), and Botan::XMSS_WOTS_PublicKey::XMSS_WOTS_PublicKey().

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

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

Public Member Functions

Protected Attributes