libdecaf

2.0.0
2.1.1 2.1.0 2.0.0 1.0.0 0.0.4 0.0.3 0.0.2 0.0.1
libdecaf NIF for ECDH (X25519, X448), EdDSA (Ed25519, Ed25519ctx, Ed25519ph, Ed448, Ed448ph), curve25519, curve448, spongerng
HexDocs
Current section
Files
Jump to
Readme 8 Versions 0 Dependencies Dependants Files Activity
libdecaf src libdecaf.erl
Raw
src/libdecaf.erl

%% -*- mode: erlang; tab-width: 4; indent-tabs-mode: 1; st-rulers: [70] -*-
%% vim: ts=4 sw=4 ft=erlang noet
%%%-------------------------------------------------------------------
%%% @author Andrew Bennett <potatosaladx@gmail.com>
%%% @copyright 2015-2022, Andrew Bennett
%%% @doc
%%%
%%% @end
%%% Created :  06 Feb 2016 by Andrew Bennett <potatosaladx@gmail.com>
%%%-------------------------------------------------------------------
-module(libdecaf).

%% API
-export([start/0]).
%% decaf/ed255.h
-export([ed25519_derive_public_key/1]).
-export([ed25519_sign/5]).
-export([ed25519_sign_prehash/4]).
-export([ed25519_verify/5]).
-export([ed25519_verify_prehash/4]).
-export([ed25519_convert_public_key_to_x25519/1]).
-export([ed25519_convert_private_key_to_x25519/1]).
%% decaf/ed448.h
-export([ed448_derive_public_key/1]).
-export([ed448_sign/5]).
-export([ed448_sign_prehash/4]).
-export([ed448_verify/5]).
-export([ed448_verify_prehash/4]).
-export([ed448_convert_public_key_to_x448/1]).
-export([ed448_convert_private_key_to_x448/1]).
%% decaf/point_255.h
-export([x25519_derive_public_key/1]).
-export([x25519_generate_key/1]).
-export([x25519/2]).
%% decaf/point_448.h
-export([x448_derive_public_key/1]).
-export([x448_generate_key/1]).
-export([x448/2]).
%% decaf/sha512.h
-export([sha2_512/1]).
-export([sha2_512/2]).
-export([sha2_512_init/0]).
-export([sha2_512_update/2]).
-export([sha2_512_final/1]).
-export([sha2_512_final/2]).
%% decaf/shake.h
% SHA-3 API
-export([sha3_224/1]).
-export([sha3_224/2]).
-export([sha3_224_init/0]).
-export([sha3_224_update/2]).
-export([sha3_224_final/1]).
-export([sha3_224_final/2]).
-export([sha3_256/1]).
-export([sha3_256/2]).
-export([sha3_256_init/0]).
-export([sha3_256_update/2]).
-export([sha3_256_final/1]).
-export([sha3_256_final/2]).
-export([sha3_384/1]).
-export([sha3_384/2]).
-export([sha3_384_init/0]).
-export([sha3_384_update/2]).
-export([sha3_384_final/1]).
-export([sha3_384_final/2]).
-export([sha3_512/1]).
-export([sha3_512/2]).
-export([sha3_512_init/0]).
-export([sha3_512_update/2]).
-export([sha3_512_final/1]).
-export([sha3_512_final/2]).
% SHAKE API
-export([shake128/2]).
-export([shake128_init/0]).
-export([shake128_update/2]).
-export([shake128_final/2]).
-export([shake256/2]).
-export([shake256_init/0]).
-export([shake256_update/2]).
-export([shake256_final/2]).
%% decaf/spongerng.h
-export([spongerng_init_from_buffer/2]).
-export([spongerng_init_from_file/3]).
-export([spongerng_init_from_dev_urandom/0]).
-export([spongerng_next/2]).
-export([spongerng_stir/2]).
%% Internal API
-export([priv_dir/0]).

%%%===================================================================
%%% API functions
%%%===================================================================

start() ->
	application:ensure_all_started(?MODULE).

%%%===================================================================
%%% decaf/ed255.h
%%%===================================================================

ed25519_derive_public_key(Privkey) ->
	libdecaf_nif:ed25519_derive_public_key(Privkey).

ed25519_sign(Privkey, Pubkey, Message, Prehashed, Context) ->
	libdecaf_nif:ed25519_sign(Privkey, Pubkey, Message, Prehashed, Context).

ed25519_sign_prehash(Privkey, Pubkey, Message, Context) ->
	libdecaf_nif:ed25519_sign_prehash(Privkey, Pubkey, Message, Context).

ed25519_verify(Signature, Pubkey, Message, Prehashed, Context) ->
	libdecaf_nif:ed25519_verify(Signature, Pubkey, Message, Prehashed, Context).

ed25519_verify_prehash(Signature, Pubkey, Message, Context) ->
	libdecaf_nif:ed25519_verify_prehash(Signature, Pubkey, Message, Context).

ed25519_convert_public_key_to_x25519(Pubkey) ->
	libdecaf_nif:ed25519_convert_public_key_to_x25519(Pubkey).

ed25519_convert_private_key_to_x25519(Privkey) ->
	libdecaf_nif:ed25519_convert_private_key_to_x25519(Privkey).

%%%===================================================================
%%% decaf/ed448.h
%%%===================================================================

ed448_derive_public_key(Privkey) ->
	libdecaf_nif:ed448_derive_public_key(Privkey).

ed448_sign(Privkey, Pubkey, Message, Prehashed, Context) ->
	libdecaf_nif:ed448_sign(Privkey, Pubkey, Message, Prehashed, Context).

ed448_sign_prehash(Privkey, Pubkey, Message, Context) ->
	libdecaf_nif:ed448_sign_prehash(Privkey, Pubkey, Message, Context).

ed448_verify(Signature, Pubkey, Message, Prehashed, Context) ->
	libdecaf_nif:ed448_verify(Signature, Pubkey, Message, Prehashed, Context).

ed448_verify_prehash(Signature, Pubkey, Message, Context) ->
	libdecaf_nif:ed448_verify_prehash(Signature, Pubkey, Message, Context).

ed448_convert_public_key_to_x448(Pubkey) ->
	libdecaf_nif:ed448_convert_public_key_to_x448(Pubkey).

ed448_convert_private_key_to_x448(Privkey) ->
	libdecaf_nif:ed448_convert_private_key_to_x448(Privkey).

%%%===================================================================
%%% decaf/point_255.h
%%%===================================================================

x25519_derive_public_key(Scalar) ->
	libdecaf_nif:x25519_derive_public_key(Scalar).

%% @deprecated Please use the function {@link libdecaf:x25519_derive_public_key/1} instead.
x25519_generate_key(Scalar) ->
	x25519_derive_public_key(Scalar).

x25519(Base, Scalar) ->
	libdecaf_nif:x25519(Base, Scalar).

%%%===================================================================
%%% decaf/point_448.h
%%%===================================================================

x448_derive_public_key(Scalar) ->
	libdecaf_nif:x448_derive_public_key(Scalar).

%% @deprecated Please use the function {@link libdecaf:x448_derive_public_key/1} instead.
x448_generate_key(Scalar) ->
	x448_derive_public_key(Scalar).

x448(Base, Scalar) ->
	libdecaf_nif:x448(Base, Scalar).

%%%===================================================================
%%% decaf/sha512.h
%%%===================================================================

sha2_512(In) ->
	sha2_512(In, 64).

sha2_512(In, Outlen) ->
	libdecaf_nif:sha2_512(In, Outlen).

sha2_512_init() ->
	libdecaf_nif:sha2_512_init().

sha2_512_update(State, In) ->
	libdecaf_nif:sha2_512_update(State, In).

sha2_512_final(State) ->
	sha2_512_final(State, 64).

sha2_512_final(State, Outlen) ->
	libdecaf_nif:sha2_512_final(State, Outlen).

%%%===================================================================
%%% decaf/shake.h
%%%===================================================================

%% SHA-3 API functions

sha3_224(In) ->
	sha3_224(In, 28).

sha3_224(In, Outlen) ->
	libdecaf_nif:sha3_224(In, Outlen).

sha3_224_init() ->
	libdecaf_nif:sha3_224_init().

sha3_224_update(State, In) ->
	libdecaf_nif:sha3_224_update(State, In).

sha3_224_final(State) ->
	sha3_224_final(State, 28).

sha3_224_final(State, Outlen) ->
	libdecaf_nif:sha3_224_final(State, Outlen).

sha3_256(In) ->
	sha3_256(In, 32).

sha3_256(In, Outlen) ->
	libdecaf_nif:sha3_256(In, Outlen).

sha3_256_init() ->
	libdecaf_nif:sha3_256_init().

sha3_256_update(State, In) ->
	libdecaf_nif:sha3_256_update(State, In).

sha3_256_final(State) ->
	sha3_256_final(State, 32).

sha3_256_final(State, Outlen) ->
	libdecaf_nif:sha3_256_final(State, Outlen).

sha3_384(In) ->
	sha3_384(In, 48).

sha3_384(In, Outlen) ->
	libdecaf_nif:sha3_384(In, Outlen).

sha3_384_init() ->
	libdecaf_nif:sha3_384_init().

sha3_384_update(State, In) ->
	libdecaf_nif:sha3_384_update(State, In).

sha3_384_final(State) ->
	sha3_384_final(State, 48).

sha3_384_final(State, Outlen) ->
	libdecaf_nif:sha3_384_final(State, Outlen).

sha3_512(In) ->
	sha3_512(In, 64).

sha3_512(In, Outlen) ->
	libdecaf_nif:sha3_512(In, Outlen).

sha3_512_init() ->
	libdecaf_nif:sha3_512_init().

sha3_512_update(State, In) ->
	libdecaf_nif:sha3_512_update(State, In).

sha3_512_final(State) ->
	sha3_512_final(State, 64).

sha3_512_final(State, Outlen) ->
	libdecaf_nif:sha3_512_final(State, Outlen).

%% SHAKE API functions

shake128(In, Outlen) ->
	libdecaf_nif:shake128(In, Outlen).

shake128_init() ->
	libdecaf_nif:shake128_init().

shake128_update(State, In) ->
	libdecaf_nif:shake128_update(State, In).

shake128_final(State, Outlen) ->
	libdecaf_nif:shake128_final(State, Outlen).

shake256(In, Outlen) ->
	libdecaf_nif:shake256(In, Outlen).

shake256_init() ->
	libdecaf_nif:shake256_init().

shake256_update(State, In) ->
	libdecaf_nif:shake256_update(State, In).

shake256_final(State, Outlen) ->
	libdecaf_nif:shake256_final(State, Outlen).

%%%===================================================================
%%% decaf/spongerng.h
%%%===================================================================

spongerng_init_from_buffer(In, Deterministic) ->
	libdecaf_nif:spongerng_init_from_buffer(In, Deterministic).

spongerng_init_from_file(File, Inlen, Deterministic) ->
	libdecaf_nif:spongerng_init_from_file(File, Inlen, Deterministic).

spongerng_init_from_dev_urandom() ->
	libdecaf_nif:spongerng_init_from_dev_urandom().

spongerng_next(State, Outlen) ->
	libdecaf_nif:spongerng_next(State, Outlen).

spongerng_stir(State, In) ->
	libdecaf_nif:spongerng_stir(State, In).

%%%===================================================================
%%% Internal API Functions
%%%===================================================================

-spec priv_dir() -> file:filename_all().
priv_dir() ->
	case code:priv_dir(?MODULE) of
		{error, bad_name} ->
			case code:which(?MODULE) of
				Filename when is_list(Filename) ->
					filename:join([filename:dirname(Filename), "../priv"]);
				_ ->
					"../priv"
			end;
		Dir ->
			Dir
	end.

%%%-------------------------------------------------------------------
%%% Internal functions
%%%-------------------------------------------------------------------
Operator	Description	Example
name:	Match package name. Supports * wildcards and repo/package form	name:phx* or name:hexpm/phoenix
description:	Full-text search of package descriptions	description:auth
depends:	Packages depending on a given package. Supports repo:package form	depends:ecto or depends:hexpm:ecto
build_tool:	Filter by build tool	build_tool:mix
updated_after:	Packages updated after an ISO8601 datetime	updated_after:2025-01-01T00:00:00Z
extra:	Match custom metadata (key,value). Nested keys are separated by commas	extra:license,MIT