ffi_ec.cpp File Reference

#include <botan/ffi.h>
#include <botan/internal/ffi_ec.h>
#include <botan/internal/ffi_mp.h>
#include <botan/internal/ffi_oid.h>
#include <botan/internal/ffi_rng.h>
#include <botan/internal/ffi_util.h>
#include <functional>

Go to the source code of this file.

Functions
int	botan_ec_group_destroy (botan_ec_group_t ec_group)
int	botan_ec_group_equal (botan_ec_group_t curve1_w, botan_ec_group_t curve2_w)
int	botan_ec_group_from_ber (botan_ec_group_t *ec_group, const uint8_t *ber, size_t ber_len)
int	botan_ec_group_from_name (botan_ec_group_t *ec_group, const char *name)
int	botan_ec_group_from_oid (botan_ec_group_t *ec_group, botan_asn1_oid_t oid)
int	botan_ec_group_from_params (botan_ec_group_t *ec_group, botan_asn1_oid_t oid, botan_mp_t p, botan_mp_t a, botan_mp_t b, botan_mp_t base_x, botan_mp_t base_y, botan_mp_t order)
int	botan_ec_group_from_pem (botan_ec_group_t *ec_group, const char *pem)
int	botan_ec_group_get_a (botan_mp_t *a, botan_ec_group_t ec_group)
int	botan_ec_group_get_b (botan_mp_t *b, botan_ec_group_t ec_group)
int	botan_ec_group_get_curve_oid (botan_asn1_oid_t *oid, botan_ec_group_t ec_group)
int	botan_ec_group_get_g_x (botan_mp_t *g_x, botan_ec_group_t ec_group)
int	botan_ec_group_get_g_y (botan_mp_t *g_y, botan_ec_group_t ec_group)
int	botan_ec_group_get_order (botan_mp_t *order, botan_ec_group_t ec_group)
int	botan_ec_group_get_p (botan_mp_t *p, botan_ec_group_t ec_group)
int	botan_ec_group_supports_application_specific_group (int *out)
int	botan_ec_group_supports_named_group (const char *name, int *out)
int	botan_ec_group_unregister (botan_asn1_oid_t oid)
int	botan_ec_group_view_der (botan_ec_group_t ec_group, botan_view_ctx ctx, botan_view_bin_fn view)
int	botan_ec_group_view_pem (botan_ec_group_t ec_group, botan_view_ctx ctx, botan_view_str_fn view)
int	botan_ec_point_add (botan_ec_point_t *result, botan_ec_point_t x_w, botan_ec_point_t y_w)
int	botan_ec_point_destroy (botan_ec_point_t ec_point)
int	botan_ec_point_equal (botan_ec_point_t x_w, botan_ec_point_t y_w)
int	botan_ec_point_from_bytes (botan_ec_point_t *ec_point, botan_ec_group_t ec_group, const uint8_t *bytes, size_t bytes_len)
int	botan_ec_point_from_xy (botan_ec_point_t *ec_point, botan_ec_group_t ec_group, botan_mp_t x, botan_mp_t y)
int	botan_ec_point_generator (botan_ec_point_t *ec_point, botan_ec_group_t ec_group)
int	botan_ec_point_identity (botan_ec_point_t *ec_point, botan_ec_group_t ec_group)
int	botan_ec_point_is_identity (botan_ec_point_t ec_point)
int	botan_ec_point_mul (botan_ec_point_t *result, botan_ec_point_t ec_point, botan_ec_scalar_t ec_scalar, botan_rng_t rng)
int	botan_ec_point_negate (botan_ec_point_t *result, botan_ec_point_t ec_point)
int	botan_ec_point_view_compressed (botan_ec_point_t ec_point, botan_view_ctx ctx, botan_view_bin_fn view)
int	botan_ec_point_view_uncompressed (botan_ec_point_t ec_point, botan_view_ctx ctx, botan_view_bin_fn view)
int	botan_ec_point_view_x_bytes (botan_ec_point_t ec_point, botan_view_ctx ctx, botan_view_bin_fn view)
int	botan_ec_point_view_xy_bytes (botan_ec_point_t ec_point, botan_view_ctx ctx, botan_view_bin_fn view)
int	botan_ec_point_view_y_bytes (botan_ec_point_t ec_point, botan_view_ctx ctx, botan_view_bin_fn view)
int	botan_ec_scalar_destroy (botan_ec_scalar_t ec_scalar)
int	botan_ec_scalar_from_mp (botan_ec_scalar_t *ec_scalar, botan_ec_group_t ec_group, botan_mp_t mp)
int	botan_ec_scalar_random (botan_ec_scalar_t *ec_scalar, botan_ec_group_t ec_group, botan_rng_t rng)
int	botan_ec_scalar_to_mp (botan_ec_scalar_t ec_scalar, botan_mp_t *mp)

Function Documentation

botan_ec_group_destroy()

int botan_ec_group_destroy

(

botan_ec_group_t

ec_group

)

Returns

negative number on error, or zero on success

Definition at line 21 of file ffi_ec.cpp.

                                                      {
   return BOTAN_FFI_CHECKED_DELETE(ec_group);
}

References BOTAN_FFI_CHECKED_DELETE.

botan_ec_group_equal()

int botan_ec_group_equal	(	botan_ec_group_t	curve1,
		botan_ec_group_t	curve2 )

Returns

0 if curve1 != curve2

1 if curve1 == curve2

negative number on error

Definition at line 190 of file ffi_ec.cpp.

                                                                               {
   return BOTAN_FFI_VISIT(curve1_w, [=](const auto& curve1) -> int { return curve1 == safe_get(curve2_w); });
}

References BOTAN_FFI_VISIT, and Botan_FFI::safe_get().

botan_ec_group_from_ber()

int botan_ec_group_from_ber	(	botan_ec_group_t *	ec_group,
		const uint8_t *	ber,
		size_t	ber_len )

Decode a BER encoded ECC domain parameter set

Parameters

ec_group	the new object will be placed here
ber	encoding
ber_len	size of the encoding in bytes

Returns

negative number on error, or zero on success

Definition at line 72 of file ffi_ec.cpp.

                                                                                            {
   return ffi_guard_thunk(__func__, [=]() -> int {
      if(ec_group == nullptr || ber == nullptr) {
         return BOTAN_FFI_ERROR_NULL_POINTER;
      }
 
      Botan::EC_Group group(ber, ber_len);
 
      auto group_ptr = std::make_unique<Botan::EC_Group>(std::move(group));
      return ffi_new_object(ec_group, std::move(group_ptr));
   });
}

References BOTAN_FFI_ERROR_NULL_POINTER, Botan_FFI::ffi_guard_thunk(), and Botan_FFI::ffi_new_object().

botan_ec_group_from_name()

int botan_ec_group_from_name	(	botan_ec_group_t *	ec_group,
		const char *	name )

Initialize an EC Group from a common group name (eg "secp256r1")

Parameters

ec_group	the new object will be placed here
name	a known group name

Returns

negative number on error, or zero on success

Definition at line 111 of file ffi_ec.cpp.

                                                                           {
   return ffi_guard_thunk(__func__, [=]() -> int {
      if(ec_group == nullptr || name == nullptr) {
         return BOTAN_FFI_ERROR_NULL_POINTER;
      }
 
      Botan::EC_Group group = Botan::EC_Group::from_name(name);
 
      auto group_ptr = std::make_unique<Botan::EC_Group>(std::move(group));
      return ffi_new_object(ec_group, std::move(group_ptr));
   });
}

References BOTAN_FFI_ERROR_NULL_POINTER, Botan_FFI::ffi_guard_thunk(), Botan_FFI::ffi_new_object(), and Botan::EC_Group::from_name().

botan_ec_group_from_oid()

int botan_ec_group_from_oid	(	botan_ec_group_t *	ec_group,
		botan_asn1_oid_t	oid )

Initialize an EC Group from a group named by an object identifier

Parameters

ec_group	the new object will be placed here
oid	a known OID

Returns

negative number on error, or zero on success

Definition at line 98 of file ffi_ec.cpp.

                                                                              {
   return ffi_guard_thunk(__func__, [=]() -> int {
      if(ec_group == nullptr) {
         return BOTAN_FFI_ERROR_NULL_POINTER;
      }
 
      Botan::EC_Group group = Botan::EC_Group::from_OID(safe_get(oid));
 
      auto group_ptr = std::make_unique<Botan::EC_Group>(std::move(group));
      return ffi_new_object(ec_group, std::move(group_ptr));
   });
}

References BOTAN_FFI_ERROR_NULL_POINTER, Botan_FFI::ffi_guard_thunk(), Botan_FFI::ffi_new_object(), Botan::EC_Group::from_OID(), and Botan_FFI::safe_get().

botan_ec_group_from_params()

int botan_ec_group_from_params	(	botan_ec_group_t *	ec_group,
		botan_asn1_oid_t	oid,
		botan_mp_t	p,
		botan_mp_t	a,
		botan_mp_t	b,
		botan_mp_t	base_x,
		botan_mp_t	base_y,
		botan_mp_t	order )

Create a new EC Group from parameters

Warning

use only elliptic curve parameters that you trust

Parameters

ec_group	the new object will be placed here
p	the elliptic curve prime (at most 521 bits)
a	the elliptic curve a param
b	the elliptic curve b param
base_x	the x coordinate of the group generator
base_y	the y coordinate of the group generator
order	the order of the group

Returns

negative number on error, or zero on success

Definition at line 51 of file ffi_ec.cpp.

                                                 {
   return ffi_guard_thunk(__func__, [=]() -> int {
      if(ec_group == nullptr) {
         return BOTAN_FFI_ERROR_NULL_POINTER;
      }
 
      Botan::EC_Group group(
         safe_get(oid), safe_get(p), safe_get(a), safe_get(b), safe_get(base_x), safe_get(base_y), safe_get(order));
 
      auto group_ptr = std::make_unique<Botan::EC_Group>(std::move(group));
      return ffi_new_object(ec_group, std::move(group_ptr));
   });
}

References BOTAN_FFI_ERROR_NULL_POINTER, Botan_FFI::ffi_guard_thunk(), Botan_FFI::ffi_new_object(), and Botan_FFI::safe_get().

botan_ec_group_from_pem()

int botan_ec_group_from_pem	(	botan_ec_group_t *	ec_group,
		const char *	pem )

Initialize an EC Group from the PEM/ASN.1 encoding

Parameters

ec_group	the new object will be placed here
pem	encoding

Returns

negative number on error, or zero on success

Definition at line 85 of file ffi_ec.cpp.

                                                                         {
   return ffi_guard_thunk(__func__, [=]() -> int {
      if(ec_group == nullptr || pem == nullptr) {
         return BOTAN_FFI_ERROR_NULL_POINTER;
      }
 
      Botan::EC_Group group = Botan::EC_Group::from_PEM(pem);
 
      auto group_ptr = std::make_unique<Botan::EC_Group>(std::move(group));
      return ffi_new_object(ec_group, std::move(group_ptr));
   });
}

References BOTAN_FFI_ERROR_NULL_POINTER, Botan_FFI::ffi_guard_thunk(), Botan_FFI::ffi_new_object(), and Botan::EC_Group::from_PEM().

botan_ec_group_get_a()

int botan_ec_group_get_a	(	botan_mp_t *	a,
		botan_ec_group_t	ec_group )

Get the a parameter of the elliptic curve equation

Definition at line 167 of file ffi_ec.cpp.

                                                                   {
   return botan_ec_group_get_component(a, ec_group, [](const auto& g) -> const Botan::BigInt& { return g.get_a(); });
}

botan_ec_group_get_b()

int botan_ec_group_get_b	(	botan_mp_t *	b,
		botan_ec_group_t	ec_group )

Get the b parameter of the elliptic curve equation

Definition at line 171 of file ffi_ec.cpp.

                                                                   {
   return botan_ec_group_get_component(b, ec_group, [](const auto& g) -> const Botan::BigInt& { return g.get_b(); });
}

botan_ec_group_get_curve_oid()

int botan_ec_group_get_curve_oid	(	botan_asn1_oid_t *	oid,
		botan_ec_group_t	ec_group )

Get the curve OID of an EC Group

Definition at line 139 of file ffi_ec.cpp.

                                                                                   {
   return BOTAN_FFI_VISIT(ec_group, [=](const auto& g) -> int {
      if(oid == nullptr) {
         return BOTAN_FFI_ERROR_NULL_POINTER;
      }
      auto oid_ptr = std::make_unique<Botan::OID>(g.get_curve_oid());
      return ffi_new_object(oid, std::move(oid_ptr));
   });
}

References BOTAN_FFI_ERROR_NULL_POINTER, BOTAN_FFI_VISIT, and Botan_FFI::ffi_new_object().

botan_ec_group_get_g_x()

int botan_ec_group_get_g_x	(	botan_mp_t *	g_x,
		botan_ec_group_t	ec_group )

Get the x coordinate of the base point

Definition at line 175 of file ffi_ec.cpp.

                                                                       {
   return botan_ec_group_get_component(
      g_x, ec_group, [](const auto& g) -> const Botan::BigInt& { return g.get_g_x(); });
}

botan_ec_group_get_g_y()

int botan_ec_group_get_g_y	(	botan_mp_t *	g_y,
		botan_ec_group_t	ec_group )

Get the y coordinate of the base point

Definition at line 180 of file ffi_ec.cpp.

                                                                       {
   return botan_ec_group_get_component(
      g_y, ec_group, [](const auto& g) -> const Botan::BigInt& { return g.get_g_y(); });
}

botan_ec_group_get_order()

int botan_ec_group_get_order	(	botan_mp_t *	order,
		botan_ec_group_t	ec_group )

Get the order of the base point

Definition at line 185 of file ffi_ec.cpp.

                                                                           {
   return botan_ec_group_get_component(
      order, ec_group, [](const auto& g) -> const Botan::BigInt& { return g.get_order(); });
}

botan_ec_group_get_p()

int botan_ec_group_get_p	(	botan_mp_t *	p,
		botan_ec_group_t	ec_group )

Get the prime modulus of the field

Definition at line 163 of file ffi_ec.cpp.

                                                                   {
   return botan_ec_group_get_component(p, ec_group, [](const auto& g) -> const Botan::BigInt& { return g.get_p(); });
}

botan_ec_group_supports_application_specific_group()

int botan_ec_group_supports_application_specific_group

(

int *

out

)

Checks if in this build configuration it is possible to register an application specific elliptic curve and sets

Parameters

out	to 1 if so, 0 otherwise

Returns

0 on success, a negative value on failure

Definition at line 25 of file ffi_ec.cpp.

                                                                 {
   if(out == nullptr) {
      return BOTAN_FFI_ERROR_NULL_POINTER;
   }
   if(Botan::EC_Group::supports_application_specific_group()) {
      *out = 1;
   } else {
      *out = 0;
   }
   return BOTAN_FFI_SUCCESS;
}

References BOTAN_FFI_ERROR_NULL_POINTER, BOTAN_FFI_SUCCESS, and Botan::EC_Group::supports_application_specific_group().

botan_ec_group_supports_named_group()

int botan_ec_group_supports_named_group	(	const char *	name,
		int *	out )

Checks if in this build configuration botan_ec_group_from_name(group_ptr, name) will succeed and sets

Parameters

out	to 1 if so, 0 otherwise.

Returns

negative number on error, or zero on success

Definition at line 37 of file ffi_ec.cpp.

                                                                    {
   return ffi_guard_thunk(__func__, [=]() -> int {
      if(name == nullptr || out == nullptr) {
         return BOTAN_FFI_ERROR_NULL_POINTER;
      }
      if(Botan::EC_Group::supports_named_group(name)) {
         *out = 1;
      } else {
         *out = 0;
      }
      return BOTAN_FFI_SUCCESS;
   });
}

References BOTAN_FFI_ERROR_NULL_POINTER, BOTAN_FFI_SUCCESS, Botan_FFI::ffi_guard_thunk(), and Botan::EC_Group::supports_named_group().

botan_ec_group_unregister()

int botan_ec_group_unregister

(

botan_asn1_oid_t

oid

)

Unregister a previously registered group.

Parameters

oid	the oid associated with the group to unregister

Returns

1 if the group was found and unregistered, else 0

Using this is discouraged for normal use. This is only useful or necessary if you are registering a very large number of distinct groups, and need to worry about memory constraints.

Definition at line 124 of file ffi_ec.cpp.

                                                    {
   return BOTAN_FFI_VISIT(oid, [=](const auto& o) -> int { return Botan::EC_Group::unregister(o) ? 1 : 0; });
}

References BOTAN_FFI_VISIT, and Botan::EC_Group::unregister().

botan_ec_group_view_der()

int botan_ec_group_view_der	(	botan_ec_group_t	ec_group,
		botan_view_ctx	ctx,
		botan_view_bin_fn	view )

View an EC Group in DER encoding

Definition at line 128 of file ffi_ec.cpp.

                                                                                                   {
   return BOTAN_FFI_VISIT(ec_group,
                          [=](const auto& g) -> int { return invoke_view_callback(view, ctx, g.DER_encode()); });
}

References BOTAN_FFI_VISIT, and Botan_FFI::invoke_view_callback().

botan_ec_group_view_pem()

int botan_ec_group_view_pem	(	botan_ec_group_t	ec_group,
		botan_view_ctx	ctx,
		botan_view_str_fn	view )

View an EC Group in PEM encoding

Definition at line 133 of file ffi_ec.cpp.

                                                                                                   {
   return BOTAN_FFI_VISIT(ec_group, [=](const auto& g) -> int {
      return invoke_view_callback(view, ctx, g.PEM_encode(Botan::EC_Group_Encoding::NamedCurve));
   });
}

References BOTAN_FFI_VISIT, Botan_FFI::invoke_view_callback(), and Botan::NamedCurve.

botan_ec_point_add()

int botan_ec_point_add	(	botan_ec_point_t *	result,
		botan_ec_point_t	x_w,
		botan_ec_point_t	y_w )

Definition at line 346 of file ffi_ec.cpp.

                                                                                             {
   if(Botan::any_null_pointers(result)) {
      return BOTAN_FFI_ERROR_NULL_POINTER;
   }
   return BOTAN_FFI_VISIT(x_w, [=](auto& x) -> int {
      Botan::EC_AffinePoint res = x.add(safe_get(y_w));
      return ffi_new_object(result, std::make_unique<Botan::EC_AffinePoint>(std::move(res)));
   });
}

References Botan::EC_AffinePoint::add(), Botan::any_null_pointers(), BOTAN_FFI_ERROR_NULL_POINTER, BOTAN_FFI_VISIT, Botan_FFI::ffi_new_object(), and Botan_FFI::safe_get().

botan_ec_point_destroy()

int botan_ec_point_destroy

(

botan_ec_point_t

ec_point

)

Definition at line 230 of file ffi_ec.cpp.

                                                      {
   return BOTAN_FFI_CHECKED_DELETE(ec_point);
}

References BOTAN_FFI_CHECKED_DELETE.

botan_ec_point_equal()

int botan_ec_point_equal	(	botan_ec_point_t	x,
		botan_ec_point_t	y )

Returns

1 if

Parameters

x	==
y	else 0 otherwise

Returns

negative number on error

Definition at line 319 of file ffi_ec.cpp.

                                                                     {
   return BOTAN_FFI_VISIT(x_w, [=](const auto& x) -> int { return x == safe_get(y_w) ? 1 : 0; });
}

References BOTAN_FFI_VISIT, and Botan_FFI::safe_get().

botan_ec_point_from_bytes()

int botan_ec_point_from_bytes	(	botan_ec_point_t *	ec_point,
		botan_ec_group_t	ec_group,
		const uint8_t *	bytes,
		size_t	bytes_len )

Create a point from a SEC1 compressed or uncompressed format.

Returns

negative number on error

Definition at line 267 of file ffi_ec.cpp.

                                                {
   if(Botan::any_null_pointers(ec_point, bytes)) {
      return BOTAN_FFI_ERROR_NULL_POINTER;
   }
   return BOTAN_FFI_VISIT(ec_group, [=](const auto& g) -> int {
      Botan::EC_AffinePoint pt(g, std::span{bytes, bytes_len});
      return ffi_new_object(ec_point, std::make_unique<Botan::EC_AffinePoint>(std::move(pt)));
   });
}

References Botan::any_null_pointers(), BOTAN_FFI_ERROR_NULL_POINTER, BOTAN_FFI_VISIT, and Botan_FFI::ffi_new_object().

botan_ec_point_from_xy()

int botan_ec_point_from_xy	(	botan_ec_point_t *	ec_point,
		botan_ec_group_t	ec_group,
		botan_mp_t	x,
		botan_mp_t	y )

Create a point from a pair (x,y) of integers The integers must be within the field and must satisfy the curve equation

Definition at line 252 of file ffi_ec.cpp.

                                                                                                              {
   if(Botan::any_null_pointers(ec_point)) {
      return BOTAN_FFI_ERROR_NULL_POINTER;
   }
   return ffi_guard_thunk(__func__, [=]() -> int {
      std::optional<Botan::EC_AffinePoint> pt =
         Botan::EC_AffinePoint::from_bigint_xy(safe_get(ec_group), safe_get(x), safe_get(y));
      if(!pt.has_value()) {
         return BOTAN_FFI_ERROR_BAD_PARAMETER;
      }
 
      return ffi_new_object(ec_point, std::make_unique<Botan::EC_AffinePoint>(pt.value()));
   });
}

References Botan::any_null_pointers(), BOTAN_FFI_ERROR_BAD_PARAMETER, BOTAN_FFI_ERROR_NULL_POINTER, Botan_FFI::ffi_guard_thunk(), Botan_FFI::ffi_new_object(), Botan::EC_AffinePoint::from_bigint_xy(), and Botan_FFI::safe_get().

botan_ec_point_generator()

int botan_ec_point_generator	(	botan_ec_point_t *	ec_point,
		botan_ec_group_t	ec_group )

Create a point set to the standard group generator

Definition at line 243 of file ffi_ec.cpp.

                                                                                    {
   if(Botan::any_null_pointers(ec_point)) {
      return BOTAN_FFI_ERROR_NULL_POINTER;
   }
   return BOTAN_FFI_VISIT(ec_group, [=](const auto& g) -> int {
      return ffi_new_object(ec_point, std::make_unique<Botan::EC_AffinePoint>(Botan::EC_AffinePoint::generator(g)));
   });
}

References Botan::any_null_pointers(), BOTAN_FFI_ERROR_NULL_POINTER, BOTAN_FFI_VISIT, Botan_FFI::ffi_new_object(), and Botan::EC_AffinePoint::generator().

botan_ec_point_identity()

int botan_ec_point_identity	(	botan_ec_point_t *	ec_point,
		botan_ec_group_t	ec_group )

Create a point set to the identity element of the group

Definition at line 234 of file ffi_ec.cpp.

                                                                                   {
   if(Botan::any_null_pointers(ec_point)) {
      return BOTAN_FFI_ERROR_NULL_POINTER;
   }
   return BOTAN_FFI_VISIT(ec_group, [=](const auto& g) -> int {
      return ffi_new_object(ec_point, std::make_unique<Botan::EC_AffinePoint>(Botan::EC_AffinePoint::identity(g)));
   });
}

References Botan::any_null_pointers(), BOTAN_FFI_ERROR_NULL_POINTER, BOTAN_FFI_VISIT, Botan_FFI::ffi_new_object(), and Botan::EC_AffinePoint::identity().

botan_ec_point_is_identity()

int botan_ec_point_is_identity

(

botan_ec_point_t

ec_point

)

Returns

1 if

Parameters

ec_point

is the identity element, else 0

Returns

negative number on error

Definition at line 315 of file ffi_ec.cpp.

                                                          {
   return BOTAN_FFI_VISIT(ec_point, [=](const auto& p) -> int { return p.is_identity() ? 1 : 0; });
}

References BOTAN_FFI_VISIT.

botan_ec_point_mul()

int botan_ec_point_mul	(	botan_ec_point_t *	result,
		botan_ec_point_t	ec_point,
		botan_ec_scalar_t	ec_scalar,
		botan_rng_t	rng )

Definition at line 323 of file ffi_ec.cpp.

                                        {
   if(Botan::any_null_pointers(result)) {
      return BOTAN_FFI_ERROR_NULL_POINTER;
   }
   return BOTAN_FFI_VISIT(ec_point, [=](auto& pt) -> int {
      Botan::EC_AffinePoint res = pt.mul(safe_get(ec_scalar), safe_get(rng));
      return ffi_new_object(result, std::make_unique<Botan::EC_AffinePoint>(std::move(res)));
   });
}

References Botan::any_null_pointers(), BOTAN_FFI_ERROR_NULL_POINTER, BOTAN_FFI_VISIT, Botan_FFI::ffi_new_object(), Botan::EC_AffinePoint::mul(), and Botan_FFI::safe_get().

botan_ec_point_negate()

int botan_ec_point_negate	(	botan_ec_point_t *	result,
		botan_ec_point_t	ec_point )

Parameters

ec_point	point to negate
result	contains the result

Definition at line 336 of file ffi_ec.cpp.

                                                                               {
   if(Botan::any_null_pointers(result)) {
      return BOTAN_FFI_ERROR_NULL_POINTER;
   }
   return BOTAN_FFI_VISIT(ec_point, [=](auto& pt) -> int {
      Botan::EC_AffinePoint res = pt.negate();
      return ffi_new_object(result, std::make_unique<Botan::EC_AffinePoint>(std::move(res)));
   });
}

References Botan::any_null_pointers(), BOTAN_FFI_ERROR_NULL_POINTER, BOTAN_FFI_VISIT, Botan_FFI::ffi_new_object(), and Botan::EC_AffinePoint::negate().

botan_ec_point_view_compressed()

int botan_ec_point_view_compressed	(	botan_ec_point_t	ec_point,
		botan_view_ctx	ctx,
		botan_view_bin_fn	view )

View the fixed length SEC1 compressed encoding

Returns

negative number on error

Definition at line 308 of file ffi_ec.cpp.

                                                                                                          {
   return BOTAN_FFI_VISIT(ec_point, [=](const auto& p) -> int {
      auto bytes = p.serialize_compressed();
      return invoke_view_callback(view, ctx, bytes);
   });
}

References BOTAN_FFI_VISIT, and Botan_FFI::invoke_view_callback().

botan_ec_point_view_uncompressed()

int botan_ec_point_view_uncompressed	(	botan_ec_point_t	ec_point,
		botan_view_ctx	ctx,
		botan_view_bin_fn	view )

View the fixed length SEC1 uncompressed encoding

Returns

negative number on error

Definition at line 301 of file ffi_ec.cpp.

                                                                                                            {
   return BOTAN_FFI_VISIT(ec_point, [=](const auto& p) -> int {
      auto bytes = p.serialize_uncompressed();
      return invoke_view_callback(view, ctx, bytes);
   });
}

References BOTAN_FFI_VISIT, and Botan_FFI::invoke_view_callback().

botan_ec_point_view_x_bytes()

int botan_ec_point_view_x_bytes	(	botan_ec_point_t	ec_point,
		botan_view_ctx	ctx,
		botan_view_bin_fn	view )

View the fixed length encoding of the affine x coordinate

Returns

negative number on error

Definition at line 280 of file ffi_ec.cpp.

                                                                                                       {
   return BOTAN_FFI_VISIT(ec_point, [=](const auto& p) -> int {
      auto bytes = p.x_bytes();
      return invoke_view_callback(view, ctx, bytes);
   });
}

References BOTAN_FFI_VISIT, and Botan_FFI::invoke_view_callback().

botan_ec_point_view_xy_bytes()

int botan_ec_point_view_xy_bytes	(	botan_ec_point_t	ec_point,
		botan_view_ctx	ctx,
		botan_view_bin_fn	view )

View the fixed length encoding of the affine x and y coordinates

Returns

negative number on error

Definition at line 294 of file ffi_ec.cpp.

                                                                                                        {
   return BOTAN_FFI_VISIT(ec_point, [=](const auto& p) -> int {
      auto bytes = p.xy_bytes();
      return invoke_view_callback(view, ctx, bytes);
   });
}

References BOTAN_FFI_VISIT, and Botan_FFI::invoke_view_callback().

botan_ec_point_view_y_bytes()

int botan_ec_point_view_y_bytes	(	botan_ec_point_t	ec_point,
		botan_view_ctx	ctx,
		botan_view_bin_fn	view )

View the fixed length encoding of the affine y coordinate

Returns

negative number on error

Definition at line 287 of file ffi_ec.cpp.

                                                                                                       {
   return BOTAN_FFI_VISIT(ec_point, [=](const auto& p) -> int {
      auto bytes = p.y_bytes();
      return invoke_view_callback(view, ctx, bytes);
   });
}

References BOTAN_FFI_VISIT, and Botan_FFI::invoke_view_callback().

botan_ec_scalar_destroy()

int botan_ec_scalar_destroy

(

botan_ec_scalar_t

ec_scalar

)

Definition at line 196 of file ffi_ec.cpp.

                                                         {
   return BOTAN_FFI_CHECKED_DELETE(ec_scalar);
}

References BOTAN_FFI_CHECKED_DELETE.

botan_ec_scalar_from_mp()

int botan_ec_scalar_from_mp	(	botan_ec_scalar_t *	ec_scalar,
		botan_ec_group_t	ec_group,
		botan_mp_t	mp )

Convert from an MPI to a scalar

Returns

a negative number if the provided MPI is negative or too large, 0 on success

Definition at line 209 of file ffi_ec.cpp.

                                                                                                    {
   if(Botan::any_null_pointers(ec_scalar)) {
      return BOTAN_FFI_ERROR_NULL_POINTER;
   }
   return BOTAN_FFI_VISIT(ec_group, [=](const auto& g) -> int {
      return ffi_new_object(ec_scalar,
                            std::make_unique<Botan::EC_Scalar>(Botan::EC_Scalar::from_bigint(g, safe_get(mp))));
   });
}

References Botan::any_null_pointers(), BOTAN_FFI_ERROR_NULL_POINTER, BOTAN_FFI_VISIT, Botan_FFI::ffi_new_object(), Botan::EC_Scalar::from_bigint(), and Botan_FFI::safe_get().

botan_ec_scalar_random()

int botan_ec_scalar_random	(	botan_ec_scalar_t *	ec_scalar,
		botan_ec_group_t	ec_group,
		botan_rng_t	rng )

Create a new random scalar value

Definition at line 200 of file ffi_ec.cpp.

                                                                                                     {
   if(Botan::any_null_pointers(ec_scalar)) {
      return BOTAN_FFI_ERROR_NULL_POINTER;
   }
   return BOTAN_FFI_VISIT(ec_group, [=](const auto& g) -> int {
      return ffi_new_object(ec_scalar, std::make_unique<Botan::EC_Scalar>(Botan::EC_Scalar::random(g, safe_get(rng))));
   });
}

References Botan::any_null_pointers(), BOTAN_FFI_ERROR_NULL_POINTER, BOTAN_FFI_VISIT, Botan_FFI::ffi_new_object(), Botan::EC_Scalar::random(), and Botan_FFI::safe_get().

botan_ec_scalar_to_mp()

int botan_ec_scalar_to_mp	(	botan_ec_scalar_t	ec_scalar,
		botan_mp_t *	mp )

Convert from a scalar to an MPI

Returns

a negative number on failure, 0 on success

Definition at line 219 of file ffi_ec.cpp.

                                                                       {
   if(Botan::any_null_pointers(mp)) {
      return BOTAN_FFI_ERROR_NULL_POINTER;
   }
   return BOTAN_FFI_VISIT(ec_scalar, [=](const auto& sc) -> int {
      return ffi_new_object(mp, std::make_unique<Botan::BigInt>(sc.to_bigint()));
   });
}

References Botan::any_null_pointers(), BOTAN_FFI_ERROR_NULL_POINTER, BOTAN_FFI_VISIT, and Botan_FFI::ffi_new_object().