/src/botan/src/lib/hash/blake2/blake2b.cpp

Source
/*
* BLAKE2b
* (C) 2016 cynecx
* (C) 2017 Jack Lloyd
*
* Botan is released under the Simplified BSD License (see license.txt)
*/

#include <botan/internal/blake2b.h>

#include <botan/exceptn.h>
#include <botan/mem_ops.h>
#include <botan/internal/fmt.h>
#include <botan/internal/loadstor.h>
#include <botan/internal/rotate.h>
#include <botan/internal/stl_util.h>
#include <array>

namespace Botan {

namespace {

constexpr std::array<uint64_t, 8> blake2b_IV{0x6a09e667f3bcc908,
                                             0xbb67ae8584caa73b,
                                             0x3c6ef372fe94f82b,
                                             0xa54ff53a5f1d36f1,
                                             0x510e527fade682d1,
                                             0x9b05688c2b3e6c1f,
                                             0x1f83d9abfb41bd6b,
                                             0x5be0cd19137e2179};

}  // namespace

BLAKE2b::BLAKE2b(size_t output_bits) : m_output_bits(output_bits), m_H(blake2b_IV.size()), m_T(), m_F(), m_key_size(0) {
   if(output_bits == 0 || output_bits > 512 || output_bits % 8 != 0) {
      throw Invalid_Argument("Bad output bits size for BLAKE2b");
   }

   state_init();
}

void BLAKE2b::state_init() {
   copy_mem(m_H.data(), blake2b_IV.data(), blake2b_IV.size());
   m_H[0] ^= (0x01010000 | (static_cast<uint8_t>(m_key_size) << 8) | static_cast<uint8_t>(output_length()));
   m_T[0] = m_T[1] = 0;
   m_F = 0;

   m_buffer.clear();
   if(m_key_size > 0) {
      m_buffer.append(m_padded_key_buffer);
   }
}

namespace {

BOTAN_FORCE_INLINE void G(uint64_t& a, uint64_t& b, uint64_t& c, uint64_t& d, uint64_t M0, uint64_t M1) {
   a = a + b + M0;
   d = rotr<32>(d ^ a);
   c = c + d;
   b = rotr<24>(b ^ c);
   a = a + b + M1;
   d = rotr<16>(d ^ a);
   c = c + d;
   b = rotr<63>(b ^ c);
}

template <size_t i0,
          size_t i1,
          size_t i2,
          size_t i3,
          size_t i4,
          size_t i5,
          size_t i6,
          size_t i7,
          size_t i8,
          size_t i9,
          size_t iA,
          size_t iB,
          size_t iC,
          size_t iD,
          size_t iE,
          size_t iF>
BOTAN_FORCE_INLINE void ROUND(uint64_t* v, const uint64_t* M) {
   G(v[0], v[4], v[8], v[12], M[i0], M[i1]);
   G(v[1], v[5], v[9], v[13], M[i2], M[i3]);
   G(v[2], v[6], v[10], v[14], M[i4], M[i5]);
   G(v[3], v[7], v[11], v[15], M[i6], M[i7]);
   G(v[0], v[5], v[10], v[15], M[i8], M[i9]);
   G(v[1], v[6], v[11], v[12], M[iA], M[iB]);
   G(v[2], v[7], v[8], v[13], M[iC], M[iD]);
   G(v[3], v[4], v[9], v[14], M[iE], M[iF]);
}

}  // namespace

void BLAKE2b::compress(const uint8_t* input, size_t blocks, uint64_t increment) {
   for(size_t b = 0; b != blocks; ++b) {
      m_T[0] += increment;
      if(m_T[0] < increment) {
         m_T[1]++;
      }

      uint64_t M[16];
      uint64_t v[16];
      load_le(M, input, 16);

      input += BLAKE2B_BLOCKBYTES;

      for(size_t i = 0; i < 8; i++) {
         v[i] = m_H[i];
      }
      for(size_t i = 0; i != 8; ++i) {
         v[i + 8] = blake2b_IV[i];
      }

      v[12] ^= m_T[0];
      v[13] ^= m_T[1];
      v[14] ^= m_F;

      ROUND<0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15>(v, M);
      ROUND<14, 10, 4, 8, 9, 15, 13, 6, 1, 12, 0, 2, 11, 7, 5, 3>(v, M);
      ROUND<11, 8, 12, 0, 5, 2, 15, 13, 10, 14, 3, 6, 7, 1, 9, 4>(v, M);
      ROUND<7, 9, 3, 1, 13, 12, 11, 14, 2, 6, 5, 10, 4, 0, 15, 8>(v, M);
      ROUND<9, 0, 5, 7, 2, 4, 10, 15, 14, 1, 11, 12, 6, 8, 3, 13>(v, M);
      ROUND<2, 12, 6, 10, 0, 11, 8, 3, 4, 13, 7, 5, 15, 14, 1, 9>(v, M);
      ROUND<12, 5, 1, 15, 14, 13, 4, 10, 0, 7, 6, 3, 9, 2, 8, 11>(v, M);
      ROUND<13, 11, 7, 14, 12, 1, 3, 9, 5, 0, 15, 4, 8, 6, 2, 10>(v, M);
      ROUND<6, 15, 14, 9, 11, 3, 0, 8, 12, 2, 13, 7, 1, 4, 10, 5>(v, M);
      ROUND<10, 2, 8, 4, 7, 6, 1, 5, 15, 11, 9, 14, 3, 12, 13, 0>(v, M);
      ROUND<0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15>(v, M);
      ROUND<14, 10, 4, 8, 9, 15, 13, 6, 1, 12, 0, 2, 11, 7, 5, 3>(v, M);

      for(size_t i = 0; i < 8; i++) {
         m_H[i] ^= v[i] ^ v[i + 8];
      }
   }
}

void BLAKE2b::add_data(std::span<const uint8_t> input) {
   BufferSlicer in(input);

   while(!in.empty()) {
      if(const auto one_block = m_buffer.handle_unaligned_data(in)) {
         compress(one_block->data(), 1, BLAKE2B_BLOCKBYTES);
      }

      if(m_buffer.in_alignment()) {
         const auto [aligned_data, full_blocks] = m_buffer.aligned_data_to_process(in);
         if(full_blocks > 0) {
            compress(aligned_data.data(), full_blocks, BLAKE2B_BLOCKBYTES);
         }
      }
   }
}

void BLAKE2b::final_result(std::span<uint8_t> output) {
   const auto pos = m_buffer.elements_in_buffer();
   m_buffer.fill_up_with_zeros();

   m_F = 0xFFFFFFFFFFFFFFFF;
   compress(m_buffer.consume().data(), 1, pos);
   copy_out_le(output.first(output_length()), m_H);
   state_init();
}

Key_Length_Specification BLAKE2b::key_spec() const {
   return Key_Length_Specification(1, 64);
}

std::string BLAKE2b::name() const {
   return fmt("BLAKE2b({})", m_output_bits);
}

std::unique_ptr<HashFunction> BLAKE2b::new_object() const {
   return std::make_unique<BLAKE2b>(m_output_bits);
}

std::unique_ptr<HashFunction> BLAKE2b::copy_state() const {
   return std::make_unique<BLAKE2b>(*this);
}

bool BLAKE2b::has_keying_material() const {
   return m_key_size > 0;
}

void BLAKE2b::key_schedule(std::span<const uint8_t> key) {
   BOTAN_ASSERT_NOMSG(key.size() <= m_buffer.size());

   m_key_size = key.size();
   m_padded_key_buffer.resize(m_buffer.size());

   if(m_padded_key_buffer.size() > m_key_size) {
      size_t padding = m_padded_key_buffer.size() - m_key_size;
      clear_mem(m_padded_key_buffer.data() + m_key_size, padding);
   }

   copy_mem(m_padded_key_buffer.data(), key.data(), key.size());
   state_init();
}

void BLAKE2b::clear() {
   zeroise(m_H);
   m_buffer.clear();
   zeroise(m_padded_key_buffer);
   m_key_size = 0;
   state_init();
}

}  // namespace Botan

Coverage Report

Created: 2026-10-28 06:31

Line	Count	Source
1		/*
2		* BLAKE2b
3		* (C) 2016 cynecx
4		* (C) 2017 Jack Lloyd
5		*
6		* Botan is released under the Simplified BSD License (see license.txt)
7		*/
8
9		#include <botan/internal/blake2b.h>
10
11		#include <botan/exceptn.h>
12		#include <botan/mem_ops.h>
13		#include <botan/internal/fmt.h>
14		#include <botan/internal/loadstor.h>
15		#include <botan/internal/rotate.h>
16		#include <botan/internal/stl_util.h>
17		#include <array>
18
19		namespace Botan {
20
21		namespace {
22
23		constexpr std::array<uint64_t, 8> blake2b_IV{0x6a09e667f3bcc908,
24		0xbb67ae8584caa73b,
25		0x3c6ef372fe94f82b,
26		0xa54ff53a5f1d36f1,
27		0x510e527fade682d1,
28		0x9b05688c2b3e6c1f,
29		0x1f83d9abfb41bd6b,
30		0x5be0cd19137e2179};
31
32		} // namespace
33
34	0	BLAKE2b::BLAKE2b(size_t output_bits) : m_output_bits(output_bits), m_H(blake2b_IV.size()), m_T(), m_F(), m_key_size(0) {
35	0	if(output_bits == 0 \|\| output_bits > 512 \|\| output_bits % 8 != 0) {
36	0	throw Invalid_Argument("Bad output bits size for BLAKE2b");
37	0	}
38
39	0	state_init();
40	0	}
41
42	0	void BLAKE2b::state_init() {
43	0	copy_mem(m_H.data(), blake2b_IV.data(), blake2b_IV.size());
44	0	m_H[0] ^= (0x01010000 \| (static_cast<uint8_t>(m_key_size) << 8) \| static_cast<uint8_t>(output_length()));
45	0	m_T[0] = m_T[1] = 0;
46	0	m_F = 0;
47
48	0	m_buffer.clear();
49	0	if(m_key_size > 0) {
50	0	m_buffer.append(m_padded_key_buffer);
51	0	}
52	0	}
53
54		namespace {
55
56	0	BOTAN_FORCE_INLINE void G(uint64_t& a, uint64_t& b, uint64_t& c, uint64_t& d, uint64_t M0, uint64_t M1) {
57	0	a = a + b + M0;
58	0	d = rotr<32>(d ^ a);
59	0	c = c + d;
60	0	b = rotr<24>(b ^ c);
61	0	a = a + b + M1;
62	0	d = rotr<16>(d ^ a);
63	0	c = c + d;
64	0	b = rotr<63>(b ^ c);
65	0	}
66
67		template <size_t i0,
68		size_t i1,
69		size_t i2,
70		size_t i3,
71		size_t i4,
72		size_t i5,
73		size_t i6,
74		size_t i7,
75		size_t i8,
76		size_t i9,
77		size_t iA,
78		size_t iB,
79		size_t iC,
80		size_t iD,
81		size_t iE,
82		size_t iF>
83	0	BOTAN_FORCE_INLINE void ROUND(uint64_t* v, const uint64_t* M) {
84	0	G(v[0], v[4], v[8], v[12], M[i0], M[i1]);
85	0	G(v[1], v[5], v[9], v[13], M[i2], M[i3]);
86	0	G(v[2], v[6], v[10], v[14], M[i4], M[i5]);
87	0	G(v[3], v[7], v[11], v[15], M[i6], M[i7]);
88	0	G(v[0], v[5], v[10], v[15], M[i8], M[i9]);
89	0	G(v[1], v[6], v[11], v[12], M[iA], M[iB]);
90	0	G(v[2], v[7], v[8], v[13], M[iC], M[iD]);
91	0	G(v[3], v[4], v[9], v[14], M[iE], M[iF]);
92	0	} Unexecuted instantiation: blake2b.cpp:void Botan::(anonymous namespace)::ROUND<0ul, 1ul, 2ul, 3ul, 4ul, 5ul, 6ul, 7ul, 8ul, 9ul, 10ul, 11ul, 12ul, 13ul, 14ul, 15ul>(unsigned long, unsigned long const) Unexecuted instantiation: blake2b.cpp:void Botan::(anonymous namespace)::ROUND<14ul, 10ul, 4ul, 8ul, 9ul, 15ul, 13ul, 6ul, 1ul, 12ul, 0ul, 2ul, 11ul, 7ul, 5ul, 3ul>(unsigned long, unsigned long const) Unexecuted instantiation: blake2b.cpp:void Botan::(anonymous namespace)::ROUND<11ul, 8ul, 12ul, 0ul, 5ul, 2ul, 15ul, 13ul, 10ul, 14ul, 3ul, 6ul, 7ul, 1ul, 9ul, 4ul>(unsigned long, unsigned long const) Unexecuted instantiation: blake2b.cpp:void Botan::(anonymous namespace)::ROUND<7ul, 9ul, 3ul, 1ul, 13ul, 12ul, 11ul, 14ul, 2ul, 6ul, 5ul, 10ul, 4ul, 0ul, 15ul, 8ul>(unsigned long, unsigned long const) Unexecuted instantiation: blake2b.cpp:void Botan::(anonymous namespace)::ROUND<9ul, 0ul, 5ul, 7ul, 2ul, 4ul, 10ul, 15ul, 14ul, 1ul, 11ul, 12ul, 6ul, 8ul, 3ul, 13ul>(unsigned long, unsigned long const) Unexecuted instantiation: blake2b.cpp:void Botan::(anonymous namespace)::ROUND<2ul, 12ul, 6ul, 10ul, 0ul, 11ul, 8ul, 3ul, 4ul, 13ul, 7ul, 5ul, 15ul, 14ul, 1ul, 9ul>(unsigned long, unsigned long const) Unexecuted instantiation: blake2b.cpp:void Botan::(anonymous namespace)::ROUND<12ul, 5ul, 1ul, 15ul, 14ul, 13ul, 4ul, 10ul, 0ul, 7ul, 6ul, 3ul, 9ul, 2ul, 8ul, 11ul>(unsigned long, unsigned long const) Unexecuted instantiation: blake2b.cpp:void Botan::(anonymous namespace)::ROUND<13ul, 11ul, 7ul, 14ul, 12ul, 1ul, 3ul, 9ul, 5ul, 0ul, 15ul, 4ul, 8ul, 6ul, 2ul, 10ul>(unsigned long, unsigned long const) Unexecuted instantiation: blake2b.cpp:void Botan::(anonymous namespace)::ROUND<6ul, 15ul, 14ul, 9ul, 11ul, 3ul, 0ul, 8ul, 12ul, 2ul, 13ul, 7ul, 1ul, 4ul, 10ul, 5ul>(unsigned long, unsigned long const) Unexecuted instantiation: blake2b.cpp:void Botan::(anonymous namespace)::ROUND<10ul, 2ul, 8ul, 4ul, 7ul, 6ul, 1ul, 5ul, 15ul, 11ul, 9ul, 14ul, 3ul, 12ul, 13ul, 0ul>(unsigned long, unsigned long const)
93
94		} // namespace
95
96	0	void BLAKE2b::compress(const uint8_t* input, size_t blocks, uint64_t increment) {
97	0	for(size_t b = 0; b != blocks; ++b) {
98	0	m_T[0] += increment;
99	0	if(m_T[0] < increment) {
100	0	m_T[1]++;
101	0	}
102
103	0	uint64_t M[16];
104	0	uint64_t v[16];
105	0	load_le(M, input, 16);
106
107	0	input += BLAKE2B_BLOCKBYTES;
108
109	0	for(size_t i = 0; i < 8; i++) {
110	0	v[i] = m_H[i];
111	0	}
112	0	for(size_t i = 0; i != 8; ++i) {
113	0	v[i + 8] = blake2b_IV[i];
114	0	}
115
116	0	v[12] ^= m_T[0];
117	0	v[13] ^= m_T[1];
118	0	v[14] ^= m_F;
119
120	0	ROUND<0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15>(v, M);
121	0	ROUND<14, 10, 4, 8, 9, 15, 13, 6, 1, 12, 0, 2, 11, 7, 5, 3>(v, M);
122	0	ROUND<11, 8, 12, 0, 5, 2, 15, 13, 10, 14, 3, 6, 7, 1, 9, 4>(v, M);
123	0	ROUND<7, 9, 3, 1, 13, 12, 11, 14, 2, 6, 5, 10, 4, 0, 15, 8>(v, M);
124	0	ROUND<9, 0, 5, 7, 2, 4, 10, 15, 14, 1, 11, 12, 6, 8, 3, 13>(v, M);
125	0	ROUND<2, 12, 6, 10, 0, 11, 8, 3, 4, 13, 7, 5, 15, 14, 1, 9>(v, M);
126	0	ROUND<12, 5, 1, 15, 14, 13, 4, 10, 0, 7, 6, 3, 9, 2, 8, 11>(v, M);
127	0	ROUND<13, 11, 7, 14, 12, 1, 3, 9, 5, 0, 15, 4, 8, 6, 2, 10>(v, M);
128	0	ROUND<6, 15, 14, 9, 11, 3, 0, 8, 12, 2, 13, 7, 1, 4, 10, 5>(v, M);
129	0	ROUND<10, 2, 8, 4, 7, 6, 1, 5, 15, 11, 9, 14, 3, 12, 13, 0>(v, M);
130	0	ROUND<0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15>(v, M);
131	0	ROUND<14, 10, 4, 8, 9, 15, 13, 6, 1, 12, 0, 2, 11, 7, 5, 3>(v, M);
132
133	0	for(size_t i = 0; i < 8; i++) {
134	0	m_H[i] ^= v[i] ^ v[i + 8];
135	0	}
136	0	}
137	0	}
138
139	0	void BLAKE2b::add_data(std::span<const uint8_t> input) {
140	0	BufferSlicer in(input);
141
142	0	while(!in.empty()) {
143	0	if(const auto one_block = m_buffer.handle_unaligned_data(in)) {
144	0	compress(one_block->data(), 1, BLAKE2B_BLOCKBYTES);
145	0	}
146
147	0	if(m_buffer.in_alignment()) {
148	0	const auto [aligned_data, full_blocks] = m_buffer.aligned_data_to_process(in);
149	0	if(full_blocks > 0) {
150	0	compress(aligned_data.data(), full_blocks, BLAKE2B_BLOCKBYTES);
151	0	}
152	0	}
153	0	}
154	0	}
155
156	0	void BLAKE2b::final_result(std::span<uint8_t> output) {
157	0	const auto pos = m_buffer.elements_in_buffer();
158	0	m_buffer.fill_up_with_zeros();
159
160	0	m_F = 0xFFFFFFFFFFFFFFFF;
161	0	compress(m_buffer.consume().data(), 1, pos);
162	0	copy_out_le(output.first(output_length()), m_H);
163	0	state_init();
164	0	}
165
166	0	Key_Length_Specification BLAKE2b::key_spec() const {
167	0	return Key_Length_Specification(1, 64);
168	0	}
169
170	0	std::string BLAKE2b::name() const {
171	0	return fmt("BLAKE2b({})", m_output_bits);
172	0	}
173
174	0	std::unique_ptr<HashFunction> BLAKE2b::new_object() const {
175	0	return std::make_unique<BLAKE2b>(m_output_bits);
176	0	}
177
178	0	std::unique_ptr<HashFunction> BLAKE2b::copy_state() const {
179	0	return std::make_unique<BLAKE2b>(*this);
180	0	}
181
182	0	bool BLAKE2b::has_keying_material() const {
183	0	return m_key_size > 0;
184	0	}
185
186	0	void BLAKE2b::key_schedule(std::span<const uint8_t> key) {
187	0	BOTAN_ASSERT_NOMSG(key.size() <= m_buffer.size());
188
189	0	m_key_size = key.size();
190	0	m_padded_key_buffer.resize(m_buffer.size());
191
192	0	if(m_padded_key_buffer.size() > m_key_size) {
193	0	size_t padding = m_padded_key_buffer.size() - m_key_size;
194	0	clear_mem(m_padded_key_buffer.data() + m_key_size, padding);
195	0	}
196
197	0	copy_mem(m_padded_key_buffer.data(), key.data(), key.size());
198	0	state_init();
199	0	}
200
201	0	void BLAKE2b::clear() {
202	0	zeroise(m_H);
203	0	m_buffer.clear();
204	0	zeroise(m_padded_key_buffer);
205	0	m_key_size = 0;
206	0	state_init();
207	0	}
208
209		} // namespace Botan