kyber_encaps_base.h

Go to the documentation of this file.

/*
 * Key encapsulation base operations for Kyber
 * (C) 2024 Jack Lloyd
 * (C) 2024 René Meusel, Rohde & Schwarz Cybersecurity
 *
 * Botan is released under the Simplified BSD License (see license.txt)
 */
 
#ifndef BOTAN_KYBER_KEY_ENCAPSULATION_BASE_H_
#define BOTAN_KYBER_KEY_ENCAPSULATION_BASE_H_
 
#include <botan/internal/kyber_constants.h>
#include <botan/internal/kyber_structures.h>
#include <botan/internal/kyber_types.h>
#include <botan/internal/pk_ops_impl.h>
 
namespace Botan {
 
class Kyber_KEM_Encryptor_Base : public PK_Ops::KEM_Encryption_with_KDF {
   public:
      size_t raw_kem_shared_key_length() const override { return mode().shared_key_length(); }
 
      size_t encapsulated_key_length() const override { return mode().encapsulated_key_length(); }
 
      void raw_kem_encrypt(std::span<uint8_t> out_encapsulated_key,
                           std::span<uint8_t> out_shared_key,
                           RandomNumberGenerator& rng) final {
         encapsulate(StrongSpan<KyberCompressedCiphertext>(out_encapsulated_key),
                     StrongSpan<KyberSharedSecret>(out_shared_key),
                     rng);
      }
 
   protected:
      Kyber_KEM_Encryptor_Base(std::string_view kdf) : PK_Ops::KEM_Encryption_with_KDF(kdf) {}
 
      virtual void encapsulate(StrongSpan<KyberCompressedCiphertext> out_encapsulated_key,
                               StrongSpan<KyberSharedSecret> out_shared_key,
                               RandomNumberGenerator& rng) = 0;
 
      virtual const KyberConstants& mode() const = 0;
};
 
class Kyber_KEM_Decryptor_Base : public PK_Ops::KEM_Decryption_with_KDF {
   public:
      size_t raw_kem_shared_key_length() const override { return mode().shared_key_length(); }
 
      size_t encapsulated_key_length() const override { return mode().encapsulated_key_length(); }
 
      void raw_kem_decrypt(std::span<uint8_t> out_shared_key, std::span<const uint8_t> encapsulated_key) final {
         decapsulate(StrongSpan<KyberSharedSecret>(out_shared_key),
                     StrongSpan<const KyberCompressedCiphertext>(encapsulated_key));
      }
 
   protected:
      Kyber_KEM_Decryptor_Base(std::string_view kdf) : PK_Ops::KEM_Decryption_with_KDF(kdf) {}
 
      virtual void decapsulate(StrongSpan<KyberSharedSecret> out_shared_key,
                               StrongSpan<const KyberCompressedCiphertext> encapsulated_key) = 0;
 
      virtual const KyberConstants& mode() const = 0;
};
 
}  // namespace Botan
 
#endif