Botan 3.14.1
Crypto and TLS for C&
ascon_aead128.h
Go to the documentation of this file.
1/*
2* Ascon-AEAD128 AEAD
3* (C) 2025 Jack Lloyd
4* 2025 René Meusel
5*
6* Botan is released under the Simplified BSD License (see license.txt)
7*/
8
9#ifndef BOTAN_ASCON_AEAD128_H_
10#define BOTAN_ASCON_AEAD128_H_
11
12#include <botan/aead.h>
13
14#include <botan/internal/ascon_perm.h>
15
16#include <optional>
17
18namespace Botan {
19
21 public:
22 void set_associated_data_n(size_t idx, std::span<const uint8_t> ad) final;
23
24 bool associated_data_requires_key() const final { return false; }
25
26 std::string name() const final { return "Ascon-AEAD128"; }
27
28 size_t update_granularity() const final { return 1; }
29
30 size_t ideal_granularity() const final { return 32; }
31
33
34 bool valid_nonce_length(size_t n) const final { return n == 16; }
35
36 size_t default_nonce_length() const final { return 16; }
37
38 size_t tag_size() const final { return 16; }
39
40 void clear() final;
41
42 void reset() final;
43
44 bool has_keying_material() const final { return m_key.has_value(); }
45
46 ~Ascon_AEAD128_Mode() override;
47
48 Ascon_AEAD128_Mode(const Ascon_AEAD128_Mode& other) = default;
50
53
54 protected:
56
57 void start_msg(const uint8_t nonce[], size_t nonce_len) final;
58 void key_schedule(std::span<const uint8_t> key) final;
59
61 std::array<uint8_t, 16> calculate_tag_and_finish();
62
63 protected:
64 std::optional<std::array<uint64_t, 2>> m_key; // NOLINT(*-non-private-member-*)
65 Ascon_p m_ascon_p; // NOLINT(*-non-private-member-*)
66 bool m_has_nonce = false; // NOLINT(*-non-private-member-*)
67
68 private:
69 std::vector<uint8_t> m_ad;
70 bool m_started = false;
71};
72
73/**
74* Ascon-AEAD128 Encryption
75*/
77 public:
78 size_t output_length(size_t input_length) const override;
79
80 size_t minimum_final_size() const override { return 0; }
81
82 private:
83 size_t process_msg(uint8_t buf[], size_t size) final;
84 void finish_msg(secure_vector<uint8_t>& final_block, size_t offset = 0) override;
85};
86
87/**
88* Ascon-AEAD128 Decryption
89*/
91 public:
92 size_t output_length(size_t input_length) const override;
93
94 size_t minimum_final_size() const override { return tag_size(); }
95
96 private:
97 size_t process_msg(uint8_t buf[], size_t size) final;
98 void finish_msg(secure_vector<uint8_t>& final_block, size_t offset = 0) override;
99};
100
101} // namespace Botan
102
103#endif
size_t output_length(size_t input_length) const override
size_t minimum_final_size() const override
size_t minimum_final_size() const override
size_t output_length(size_t input_length) const override
bool has_keying_material() const final
Key_Length_Specification key_spec() const final
size_t default_nonce_length() const final
Ascon_AEAD128_Mode & operator=(Ascon_AEAD128_Mode &&other)=delete
size_t update_granularity() const final
void key_schedule(std::span< const uint8_t > key) final
Ascon_AEAD128_Mode & operator=(const Ascon_AEAD128_Mode &other)=delete
size_t ideal_granularity() const final
bool associated_data_requires_key() const final
std::string name() const final
std::optional< std::array< uint64_t, 2 > > m_key
Ascon_AEAD128_Mode(const Ascon_AEAD128_Mode &other)=default
Ascon_AEAD128_Mode(Ascon_AEAD128_Mode &&other)=default
void set_associated_data_n(size_t idx, std::span< const uint8_t > ad) final
size_t tag_size() const final
bool valid_nonce_length(size_t n) const final
std::array< uint8_t, 16 > calculate_tag_and_finish()
void start_msg(const uint8_t nonce[], size_t nonce_len) final
std::vector< T, secure_allocator< T > > secure_vector
Definition secmem.h:128