7#ifndef BOTAN_BLS12_381_FIELDS_H_
8#define BOTAN_BLS12_381_FIELDS_H_
10#include <botan/types.h>
11#include <botan/internal/ct_utils.h>
12#include <botan/internal/mp_core.h>
26 static constexpr size_t BITS = 381;
35 static FieldElement from_u32(uint32_t v);
41 static std::optional<FieldElement> deserialize(std::span<const uint8_t> bytes);
43 static FieldElement from_bytes_wide(std::span<const uint8_t, 96> bytes);
47 void serialize_to(std::span<uint8_t, FieldElement::BYTES> bytes)
const;
49 std::array<uint8_t, FieldElement::BYTES>
serialize()
const {
50 std::array<uint8_t, FieldElement::BYTES> buf{};
62 (*this) = this->
add(x);
67 (*this) = this->
sub(x);
72 (*this) = this->
mul(x);
105 CT::Choice _is_lexicographically_largest()
const;
117 constexpr const std::array<word, N>&
_words()
const {
return m_val; }
126 void square_n(
size_t n);
128 constexpr const std::array<word, N>& value()
const {
return m_val; }
130 constexpr const word* data()
const {
return m_val.data(); }
132 static FieldElement from_words(std::array<word, FieldElement::N> v);
134 explicit constexpr FieldElement(std::array<word, FieldElement::N> v) : m_val(v) {}
136 std::array<word, FieldElement::N> m_val;
173 static std::optional<FieldElement2> deserialize(std::span<const uint8_t> bytes);
175 void serialize_to(std::span<uint8_t, FieldElement2::BYTES> bytes)
const;
177 std::array<uint8_t, FieldElement2::BYTES>
serialize()
const {
178 std::array<uint8_t, FieldElement2::BYTES> buf{};
196 (*this) = this->
add(x);
201 (*this) = this->
sub(x);
206 (*this) = this->
mul(x);
220 void square_n(
size_t n);
254 CT::Choice _is_lexicographically_largest()
const;
260 std::array<word, FieldElement::N>
c1) {
296template <
typename FE,
size_t N>
297FE
pow_msb(
const FE& x,
const std::array<word, N>& exp) {
299 for(
size_t i = 0; i != N; ++i) {
300 const word w = exp[N - 1 - i];
FieldElement2 add(const FieldElement2 &x) const
static FieldElement2 one()
CT::Choice operator!=(const FieldElement2 &other) const
constexpr FieldElement2()=default
std::array< uint8_t, FieldElement2::BYTES > serialize() const
FieldElement2 mul(const FieldElement2 &x) const
static FieldElement2 zero()
FieldElement2 & operator+=(const FieldElement2 &x)
static constexpr FieldElement2 _unchecked_from_words(std::array< word, FieldElement::N > c0, std::array< word, FieldElement::N > c1)
FieldElement2 sub(const FieldElement2 &x) const
static constexpr size_t BYTES
const FieldElement & c0() const
const FieldElement & c1() const
void serialize_to(std::span< uint8_t, FieldElement2::BYTES > bytes) const
constexpr FieldElement2(const FieldElement &c0, const FieldElement &c1)
FieldElement2 & operator-=(const FieldElement2 &x)
FieldElement2 & operator*=(const FieldElement2 &x)
static constexpr size_t BITS
static constexpr FieldElement _unchecked_from_words(std::array< word, FieldElement::N > v)
FieldElement add(const FieldElement &x) const
std::array< uint8_t, FieldElement::BYTES > serialize() const
static FieldElement one()
FieldElement & operator-=(const FieldElement &x)
static constexpr size_t BYTES
constexpr const std::array< word, N > & _words() const
FieldElement & operator*=(const FieldElement &x)
FieldElement & operator+=(const FieldElement &x)
void serialize_to(std::span< uint8_t, FieldElement::BYTES > bytes) const
FieldElement mul(const FieldElement &x) const
CT::Choice operator!=(const FieldElement &other) const
FieldElement sub(const FieldElement &x) const
static constexpr size_t N
static FieldElement zero()
Scalar operator-(const Scalar &a, const Scalar &b)
FieldElement2 pow_p2_minus_9_over_16(const FieldElement2 &x)
FE pow_msb(const FE &x, const std::array< word, N > &exp)
Scalar operator+(const Scalar &a, const Scalar &b)
Scalar operator*(const Scalar &a, const Scalar &b)
BigInt square(const BigInt &x)
bool operator==(const AlgorithmIdentifier &x, const AlgorithmIdentifier &y)
std::conditional_t< HasNative64BitRegisters, std::uint64_t, uint32_t > word
The native machine word, used as the limb type for multiprecision integers.