cryptographic primitives for GNUnet More...

#include <stdbool.h>
#include <sodium.h>
#include "gnunet_common.h"
#include <gcrypt.h>

Include dependency graph for gnunet_crypto_lib.h:

Data Structures
struct	GNUNET_CRYPTO_HashAsciiEncoded
	0-terminated ASCII encoding of a struct GNUNET_HashCode. More...

struct	GNUNET_CRYPTO_EccSignaturePurpose
	header of what an ECC signature signs this must be followed by "size - 8" bytes of the actual signed data More...

struct	GNUNET_CRYPTO_EddsaSignature
	an ECC signature using EdDSA. More...

struct	GNUNET_CRYPTO_EcdsaSignature
	an ECC signature using ECDSA More...

struct	GNUNET_CRYPTO_EddsaPublicKey
	Public ECC key (always for curve Ed25519) encoded in a format suitable for network transmission and EdDSA signatures. More...

struct	GNUNET_CRYPTO_EcdsaPublicKey
	Public ECC key (always for Curve25519) encoded in a format suitable for network transmission and ECDSA signatures. More...

struct	GNUNET_PeerIdentity
	The identity of the host (wraps the signing key of the peer). More...

struct	GNUNET_CRYPTO_EcdhePublicKey
	Public ECC key (always for Curve25519) encoded in a format suitable for network transmission and encryption (ECDH), See http://cr.yp.to/ecdh.html. More...

struct	GNUNET_CRYPTO_EcdhePrivateKey
	Private ECC key encoded for transmission. More...

struct	GNUNET_CRYPTO_EcdsaPrivateKey
	Private ECC key encoded for transmission. More...

struct	GNUNET_CRYPTO_EddsaPrivateKey
	Private ECC key encoded for transmission. More...

struct	GNUNET_CRYPTO_EddsaPrivateScalar
	Private ECC scalar encoded for transmission. More...

struct	GNUNET_CRYPTO_Edx25519PrivateKey
	Private ECC key material encoded for transmission. More...

struct	GNUNET_CRYPTO_Edx25519PublicKey
	Public ECC key (always for curve Ed25519) encoded in a format suitable for network transmission and Edx25519 (same as EdDSA) signatures. More...

struct	GNUNET_CRYPTO_Edx25519Signature
	an ECC signature using Edx25519 (same as in EdDSA). More...

struct	GNUNET_CRYPTO_SymmetricSessionKey
	type for session keys More...

struct	GNUNET_CRYPTO_ChallengeNonceP
	Type of a nonce used for challenges. More...

struct	GNUNET_CRYPTO_SymmetricInitializationVector
	IV for sym cipher. More...

struct	GNUNET_CRYPTO_AuthKey
	type for (message) authentication keys More...

struct	GNUNET_CRYPTO_PaillierPublicKey
	Paillier public key. More...

struct	GNUNET_CRYPTO_PaillierPrivateKey
	Paillier private key. More...

struct	GNUNET_CRYPTO_PaillierCiphertext
	Paillier ciphertext. More...

struct	GNUNET_CRYPTO_Cs25519Scalar
	Curve25519 Scalar. More...

struct	GNUNET_CRYPTO_Cs25519Point
	Curve25519 point. More...

struct	GNUNET_CRYPTO_CsPrivateKey
	The private information of an Schnorr key pair. More...

struct	GNUNET_CRYPTO_CsPublicKey
	The public information of an Schnorr key pair. More...

struct	GNUNET_CRYPTO_CsBlindingSecret
	Secret used for blinding (alpha and beta). More...

struct	GNUNET_CRYPTO_CsRSecret
	the private r used in the signature More...

struct	GNUNET_CRYPTO_CsRPublic
	the public R (derived from r) used in c More...

struct	GNUNET_CRYPTO_CsC
	Schnorr c to be signed. More...

struct	GNUNET_CRYPTO_CsS
	s in the signature More...

struct	GNUNET_CRYPTO_CsBlindS
	blinded s in the signature More...

struct	GNUNET_CRYPTO_CsSignature
	CS Signtature containing scalar s and point R. More...

struct	GNUNET_CRYPTO_CsNonce
	Nonce. More...

struct	GNUNET_CRYPTO_PowSalt
	Value for a salt for GNUNET_CRYPTO_pow_hash(). More...

struct	GNUNET_CRYPTO_EccPoint
	Point on a curve (always for Curve25519) encoded in a format suitable for network transmission (ECDH), see http://cr.yp.to/ecdh.html. More...

struct	GNUNET_CRYPTO_EccScalar
	A ECC scalar for use in point multiplications. More...

struct	GNUNET_CRYPTO_RsaBlindingKeySecret
	Constant-size pre-secret for blinding key generation. More...

Macros
#define	GNUNET_CRYPTO_ECC_SIGNATURE_DATA_ENCODING_LENGTH 126
	Maximum length of an ECC signature. More...

#define	GNUNET_CRYPTO_AES_KEY_LENGTH (256 / 8)
	length of the sessionkey in bytes (256 BIT sessionkey) More...

#define	GNUNET_CRYPTO_HASH_LENGTH (512 / 8)
	Length of a hash value. More...

#define	GNUNET_CRYPTO_PKEY_ASCII_LENGTH 52
	How many characters (without 0-terminator) are our ASCII-encoded public keys (ECDSA/EDDSA/ECDHE). More...

#define	GNUNET_CRYPTO_PAILLIER_BITS 2048
	Size of paillier plain texts and public keys. More...

#define	GNUNET_CRYPTO_hash_from_string(enc, result) GNUNET_CRYPTO_hash_from_string2 (enc, strlen (enc), result)
	Convert ASCII encoding back to `struct GNUNET_HashCode` More...

#define	GNUNET_CRYPTO_eddsa_sign(priv, ps, sig)
	EdDSA sign a given block. More...

#define	GNUNET_CRYPTO_ecdsa_sign(priv, ps, sig)
	ECDSA sign a given block. More...

#define	GNUNET_CRYPTO_edx25519_sign(priv, ps, sig)
	Edx25519 sign a given block. More...

#define	GNUNET_CRYPTO_eddsa_verify(purp, ps, sig, pub)
	Verify EdDSA signature. More...

#define	GNUNET_CRYPTO_ecdsa_verify(purp, ps, sig, pub)
	Verify ECDSA signature. More...

#define	GNUNET_CRYPTO_edx25519_verify(purp, ps, sig, pub)
	Verify Edx25519 signature. More...

Typedefs
typedef void(*	GNUNET_CRYPTO_HashCompletedCallback) (void cls, const struct GNUNET_HashCode res)
	Function called once the hash computation over the specified file has completed. More...

Enumerations
enum	GNUNET_CRYPTO_Quality { GNUNET_CRYPTO_QUALITY_WEAK , GNUNET_CRYPTO_QUALITY_STRONG , GNUNET_CRYPTO_QUALITY_NONCE }
	Desired quality level for random numbers. More...

Functions
void	GNUNET_CRYPTO_seed_weak_random (int32_t seed)
	Seed a weak random generator. More...

uint8_t	GNUNET_CRYPTO_crc8_n (const void *buf, size_t len)
	Calculate the checksum of a buffer in one step. More...

uint32_t	GNUNET_CRYPTO_crc16_step (uint32_t sum, const void *buf, size_t len)
	Perform an incremental step in a CRC16 (for TCP/IP) calculation. More...

uint16_t	GNUNET_CRYPTO_crc16_finish (uint32_t sum)
	Convert results from GNUNET_CRYPTO_crc16_step to final crc16. More...

uint16_t	GNUNET_CRYPTO_crc16_n (const void *buf, size_t len)
	Calculate the checksum of a buffer in one step. More...

int32_t	GNUNET_CRYPTO_crc32_n (const void *buf, size_t len)
	Compute the CRC32 checksum for the first len bytes of the buffer. More...

void	GNUNET_CRYPTO_zero_keys (void *buffer, size_t length)
	Zero out buffer, securely against compiler optimizations. More...

void	GNUNET_CRYPTO_random_block (enum GNUNET_CRYPTO_Quality mode, void *buffer, size_t length)
	Fill block with a random values. More...

void	GNUNET_CRYPTO_random_timeflake (enum GNUNET_CRYPTO_Quality mode, struct GNUNET_Uuid *uuid)
	Fill UUID with a timeflake pseudo-random value. More...

uint32_t	GNUNET_CRYPTO_random_u32 (enum GNUNET_CRYPTO_Quality mode, uint32_t i)
	Produce a random value. More...

uint64_t	GNUNET_CRYPTO_random_u64 (enum GNUNET_CRYPTO_Quality mode, uint64_t max)
	Generate a random unsigned 64-bit value. More...

unsigned int *	GNUNET_CRYPTO_random_permute (enum GNUNET_CRYPTO_Quality mode, unsigned int n)
	Get an array with a random permutation of the numbers 0...n-1. More...

void	GNUNET_CRYPTO_symmetric_create_session_key (struct GNUNET_CRYPTO_SymmetricSessionKey *key)
	Create a new random session key. More...

ssize_t	GNUNET_CRYPTO_symmetric_encrypt (const void block, size_t size, const struct GNUNET_CRYPTO_SymmetricSessionKey sessionkey, const struct GNUNET_CRYPTO_SymmetricInitializationVector iv, void result)
	Encrypt a block using a symmetric sessionkey. More...

ssize_t	GNUNET_CRYPTO_symmetric_decrypt (const void block, size_t size, const struct GNUNET_CRYPTO_SymmetricSessionKey sessionkey, const struct GNUNET_CRYPTO_SymmetricInitializationVector iv, void result)
	Decrypt a given block using a symmetric sessionkey. More...

void	GNUNET_CRYPTO_symmetric_derive_iv (struct GNUNET_CRYPTO_SymmetricInitializationVector iv, const struct GNUNET_CRYPTO_SymmetricSessionKey skey, const void *salt, size_t salt_len,...)
	Derive an IV. More...

void	GNUNET_CRYPTO_symmetric_derive_iv_v (struct GNUNET_CRYPTO_SymmetricInitializationVector iv, const struct GNUNET_CRYPTO_SymmetricSessionKey skey, const void *salt, size_t salt_len, va_list argp)
	Derive an IV. More...

void	GNUNET_CRYPTO_hash_to_enc (const struct GNUNET_HashCode block, struct GNUNET_CRYPTO_HashAsciiEncoded result)
	Convert hash to ASCII encoding. More...

enum GNUNET_GenericReturnValue	GNUNET_CRYPTO_hash_from_string2 (const char enc, size_t enclen, struct GNUNET_HashCode result)
	Convert ASCII encoding back to a 'struct GNUNET_HashCode'. More...

uint32_t	GNUNET_CRYPTO_hash_distance_u32 (const struct GNUNET_HashCode a, const struct GNUNET_HashCode b)
	Compute the distance between 2 hashcodes. More...

void	GNUNET_CRYPTO_hash (const void block, size_t size, struct GNUNET_HashCode ret)
	Compute hash of a given block. More...

void	GNUNET_CRYPTO_pow_hash (const struct GNUNET_CRYPTO_PowSalt salt, const void buf, size_t buf_len, struct GNUNET_HashCode *result)
	Calculate the 'proof-of-work' hash (an expensive hash). More...

struct GNUNET_HashContext *	GNUNET_CRYPTO_hash_context_start (void)
	Start incremental hashing operation. More...

struct GNUNET_HashContext *	GNUNET_CRYPTO_hash_context_copy (const struct GNUNET_HashContext *hc)
	Make a copy of the hash computation. More...

void	GNUNET_CRYPTO_hash_context_read (struct GNUNET_HashContext hc, const void buf, size_t size)
	Add data to be hashed. More...

void	GNUNET_CRYPTO_hash_context_finish (struct GNUNET_HashContext hc, struct GNUNET_HashCode r_hash)
	Finish the hash computation. More...

void	GNUNET_CRYPTO_hash_context_abort (struct GNUNET_HashContext *hc)
	Abort hashing, do not bother calculating final result. More...

void	GNUNET_CRYPTO_hmac_raw (const void key, size_t key_len, const void plaintext, size_t plaintext_len, struct GNUNET_HashCode *hmac)
	Calculate HMAC of a message (RFC 2104) TODO: Shouldn't this be the standard hmac function and the above be renamed? More...

void	GNUNET_CRYPTO_hmac (const struct GNUNET_CRYPTO_AuthKey key, const void plaintext, size_t plaintext_len, struct GNUNET_HashCode *hmac)
	Calculate HMAC of a message (RFC 2104) More...

struct GNUNET_CRYPTO_FileHashContext *	GNUNET_CRYPTO_hash_file (enum GNUNET_SCHEDULER_Priority priority, const char filename, size_t blocksize, GNUNET_CRYPTO_HashCompletedCallback callback, void callback_cls)
	Compute the hash of an entire file. More...

void	GNUNET_CRYPTO_hash_file_cancel (struct GNUNET_CRYPTO_FileHashContext *fhc)
	Cancel a file hashing operation. More...

void	GNUNET_CRYPTO_hash_create_random (enum GNUNET_CRYPTO_Quality mode, struct GNUNET_HashCode *result)
	Create a random hash code. More...

void	GNUNET_CRYPTO_hash_difference (const struct GNUNET_HashCode a, const struct GNUNET_HashCode b, struct GNUNET_HashCode *result)
	compute result = b - a More...

void	GNUNET_CRYPTO_hash_sum (const struct GNUNET_HashCode a, const struct GNUNET_HashCode delta, struct GNUNET_HashCode *result)
	compute result = a + delta More...

void	GNUNET_CRYPTO_hash_xor (const struct GNUNET_HashCode a, const struct GNUNET_HashCode b, struct GNUNET_HashCode *result)
	compute result = a ^ b More...

unsigned int	GNUNET_CRYPTO_hash_count_leading_zeros (const struct GNUNET_HashCode *h)
	Count the number of leading 0 bits in h. More...

unsigned int	GNUNET_CRYPTO_hash_count_tailing_zeros (const struct GNUNET_HashCode *h)
	Count the number of tailing 0 bits in h. More...

void	GNUNET_CRYPTO_hash_to_aes_key (const struct GNUNET_HashCode hc, struct GNUNET_CRYPTO_SymmetricSessionKey skey, struct GNUNET_CRYPTO_SymmetricInitializationVector *iv)
	Convert a hashcode into a key. More...

int	GNUNET_CRYPTO_hash_cmp (const struct GNUNET_HashCode h1, const struct GNUNET_HashCode h2)
	Compare function for HashCodes, producing a total ordering of all hashcodes. More...

int	GNUNET_CRYPTO_hash_xorcmp (const struct GNUNET_HashCode h1, const struct GNUNET_HashCode h2, const struct GNUNET_HashCode *target)
	Find out which of the two GNUNET_CRYPTO_hash codes is closer to target in the XOR metric (Kademlia). More...

void	GNUNET_CRYPTO_hmac_derive_key_v (struct GNUNET_CRYPTO_AuthKey key, const struct GNUNET_CRYPTO_SymmetricSessionKey rkey, const void *salt, size_t salt_len, va_list argp)
	Derive an authentication key. More...

void	GNUNET_CRYPTO_hmac_derive_key (struct GNUNET_CRYPTO_AuthKey key, const struct GNUNET_CRYPTO_SymmetricSessionKey rkey, const void *salt, size_t salt_len,...)
	Derive an authentication key. More...

enum GNUNET_GenericReturnValue	GNUNET_CRYPTO_hkdf (void result, size_t out_len, int xtr_algo, int prf_algo, const void xts, size_t xts_len, const void *skm, size_t skm_len,...)
	Derive key. More...

enum GNUNET_GenericReturnValue	GNUNET_CRYPTO_hkdf_v (void result, size_t out_len, int xtr_algo, int prf_algo, const void xts, size_t xts_len, const void *skm, size_t skm_len, va_list argp)
	Derive key. More...

enum GNUNET_GenericReturnValue	GNUNET_CRYPTO_kdf_v (void result, size_t out_len, const void xts, size_t xts_len, const void *skm, size_t skm_len, va_list argp)
	Derive key. More...

void	GNUNET_CRYPTO_kdf_mod_mpi (gcry_mpi_t r, gcry_mpi_t n, const void xts, size_t xts_len, const void skm, size_t skm_len, const char ctx)
	Deterministically generate a pseudo-random number uniformly from the integers modulo a libgcrypt mpi. More...

enum GNUNET_GenericReturnValue	GNUNET_CRYPTO_kdf (void result, size_t out_len, const void xts, size_t xts_len, const void *skm, size_t skm_len,...)
	Derive key. More...

void	GNUNET_CRYPTO_ecdsa_key_get_public (const struct GNUNET_CRYPTO_EcdsaPrivateKey priv, struct GNUNET_CRYPTO_EcdsaPublicKey pub)
	Extract the public key for the given private key. More...

void	GNUNET_CRYPTO_eddsa_key_get_public (const struct GNUNET_CRYPTO_EddsaPrivateKey priv, struct GNUNET_CRYPTO_EddsaPublicKey pub)
	Extract the public key for the given private key. More...

void	GNUNET_CRYPTO_edx25519_key_get_public (const struct GNUNET_CRYPTO_Edx25519PrivateKey priv, struct GNUNET_CRYPTO_Edx25519PublicKey pub)
	Extract the public key for the given private key. More...

void	GNUNET_CRYPTO_ecdhe_key_get_public (const struct GNUNET_CRYPTO_EcdhePrivateKey priv, struct GNUNET_CRYPTO_EcdhePublicKey pub)
	Extract the public key for the given private key. More...

char *	GNUNET_CRYPTO_ecdsa_public_key_to_string (const struct GNUNET_CRYPTO_EcdsaPublicKey *pub)
	Convert a public key to a string. More...

char *	GNUNET_CRYPTO_ecdsa_private_key_to_string (const struct GNUNET_CRYPTO_EcdsaPrivateKey *priv)
	Convert a private key to a string. More...

char *	GNUNET_CRYPTO_eddsa_private_key_to_string (const struct GNUNET_CRYPTO_EddsaPrivateKey *priv)
	Convert a private key to a string. More...

char *	GNUNET_CRYPTO_eddsa_public_key_to_string (const struct GNUNET_CRYPTO_EddsaPublicKey *pub)
	Convert a public key to a string. More...

enum GNUNET_GenericReturnValue	GNUNET_CRYPTO_ecdsa_public_key_from_string (const char enc, size_t enclen, struct GNUNET_CRYPTO_EcdsaPublicKey pub)
	Convert a string representing a public key to a public key. More...

enum GNUNET_GenericReturnValue	GNUNET_CRYPTO_eddsa_private_key_from_string (const char enc, size_t enclen, struct GNUNET_CRYPTO_EddsaPrivateKey pub)
	Convert a string representing a private key to a private key. More...

enum GNUNET_GenericReturnValue	GNUNET_CRYPTO_eddsa_public_key_from_string (const char enc, size_t enclen, struct GNUNET_CRYPTO_EddsaPublicKey pub)
	Convert a string representing a public key to a public key. More...

enum GNUNET_GenericReturnValue	GNUNET_CRYPTO_ecdsa_key_from_file (const char filename, int do_create, struct GNUNET_CRYPTO_EcdsaPrivateKey pkey)
	Create a new private key by reading it from a file. More...

enum GNUNET_GenericReturnValue	GNUNET_CRYPTO_eddsa_key_from_file (const char filename, int do_create, struct GNUNET_CRYPTO_EddsaPrivateKey pkey)
	Create a new private key by reading it from a file. More...

struct GNUNET_CRYPTO_EddsaPrivateKey *	GNUNET_CRYPTO_eddsa_key_create_from_configuration (const struct GNUNET_CONFIGURATION_Handle *cfg)
	Create a new private key by reading our peer's key from the file specified in the configuration. More...

void	GNUNET_CRYPTO_ecdsa_key_create (struct GNUNET_CRYPTO_EcdsaPrivateKey *pk)
	Create a new private key. More...

void	GNUNET_CRYPTO_eddsa_key_create (struct GNUNET_CRYPTO_EddsaPrivateKey *pk)
	Create a new private key. More...

void	GNUNET_CRYPTO_edx25519_key_create (struct GNUNET_CRYPTO_Edx25519PrivateKey *pk)
	Create a new private key. More...

void	GNUNET_CRYPTO_edx25519_key_create_from_seed (const void seed, size_t seedsize, struct GNUNET_CRYPTO_Edx25519PrivateKey pk)
	Create a new private key for Edx25519 from a given seed. More...

void	GNUNET_CRYPTO_ecdhe_key_create (struct GNUNET_CRYPTO_EcdhePrivateKey *pk)
	Create a new private key. More...

void	GNUNET_CRYPTO_eddsa_key_clear (struct GNUNET_CRYPTO_EddsaPrivateKey *pk)
	Clear memory that was used to store a private key. More...

void	GNUNET_CRYPTO_ecdsa_key_clear (struct GNUNET_CRYPTO_EcdsaPrivateKey *pk)
	Clear memory that was used to store a private key. More...

void	GNUNET_CRYPTO_edx25519_key_clear (struct GNUNET_CRYPTO_Edx25519PrivateKey *pk)
	Clear memory that was used to store a private key. More...

void	GNUNET_CRYPTO_ecdhe_key_clear (struct GNUNET_CRYPTO_EcdhePrivateKey *pk)
	Clear memory that was used to store a private key. More...

const struct GNUNET_CRYPTO_EcdsaPrivateKey *	GNUNET_CRYPTO_ecdsa_key_get_anonymous (void)
	Get the shared private key we use for anonymous users. More...

void	GNUNET_CRYPTO_eddsa_setup_hostkey (const char *cfg_name)
	Setup a hostkey file for a peer given the name of the configuration file (!). More...

enum GNUNET_GenericReturnValue	GNUNET_CRYPTO_get_peer_identity (const struct GNUNET_CONFIGURATION_Handle cfg, struct GNUNET_PeerIdentity dst)
	Retrieve the identity of the host's peer. More...

struct GNUNET_CRYPTO_EccDlogContext *	GNUNET_CRYPTO_ecc_dlog_prepare (unsigned int max, unsigned int mem)
	Do pre-calculation for ECC discrete logarithm for small factors. More...

int	GNUNET_CRYPTO_ecc_dlog (struct GNUNET_CRYPTO_EccDlogContext edc, const struct GNUNET_CRYPTO_EccPoint input)
	Calculate ECC discrete logarithm for small factors. More...

void	GNUNET_CRYPTO_ecc_dexp (int val, struct GNUNET_CRYPTO_EccPoint *r)
	Multiply the generator g of the elliptic curve by val to obtain the point on the curve representing val. More...

enum GNUNET_GenericReturnValue	GNUNET_CRYPTO_ecc_dexp_mpi (const struct GNUNET_CRYPTO_EccScalar val, struct GNUNET_CRYPTO_EccPoint r)
	Multiply the generator g of the elliptic curve by val to obtain the point on the curve representing val. More...

enum GNUNET_GenericReturnValue	GNUNET_CRYPTO_ecc_pmul_mpi (const struct GNUNET_CRYPTO_EccPoint p, const struct GNUNET_CRYPTO_EccScalar val, struct GNUNET_CRYPTO_EccPoint *r)
	Multiply the point p on the elliptic curve by val. More...

enum GNUNET_GenericReturnValue	GNUNET_CRYPTO_ecc_add (const struct GNUNET_CRYPTO_EccPoint a, const struct GNUNET_CRYPTO_EccPoint b, struct GNUNET_CRYPTO_EccPoint *r)
	Add two points on the elliptic curve. More...

enum GNUNET_GenericReturnValue	GNUNET_CRYPTO_ecc_rnd (struct GNUNET_CRYPTO_EccPoint r, struct GNUNET_CRYPTO_EccPoint r_inv)
	Obtain a random point on the curve and its additive inverse. More...

void	GNUNET_CRYPTO_ecc_rnd_mpi (struct GNUNET_CRYPTO_EccScalar r, struct GNUNET_CRYPTO_EccScalar r_neg)
	Obtain a random scalar for point multiplication on the curve and its additive inverse. More...

void	GNUNET_CRYPTO_ecc_random_mod_n (struct GNUNET_CRYPTO_EccScalar *r)
	Generate a random value mod n. More...

void	GNUNET_CRYPTO_ecc_dlog_release (struct GNUNET_CRYPTO_EccDlogContext *dlc)
	Release precalculated values. More...

void	GNUNET_CRYPTO_ecc_scalar_from_int (int64_t val, struct GNUNET_CRYPTO_EccScalar *r)
	Create a scalar from int value. More...

enum GNUNET_GenericReturnValue	GNUNET_CRYPTO_ecc_ecdh (const struct GNUNET_CRYPTO_EcdhePrivateKey priv, const struct GNUNET_CRYPTO_EcdhePublicKey pub, struct GNUNET_HashCode *key_material)
	Derive key material from a public and a private ECC key. More...

enum GNUNET_GenericReturnValue	GNUNET_CRYPTO_eddsa_ecdh (const struct GNUNET_CRYPTO_EddsaPrivateKey priv, const struct GNUNET_CRYPTO_EcdhePublicKey pub, struct GNUNET_HashCode *key_material)
	Derive key material from a ECDH public key and a private EdDSA key. More...

enum GNUNET_GenericReturnValue	GNUNET_CRYPTO_ecdsa_ecdh (const struct GNUNET_CRYPTO_EcdsaPrivateKey priv, const struct GNUNET_CRYPTO_EcdhePublicKey pub, struct GNUNET_HashCode *key_material)
	Derive key material from a ECDH public key and a private ECDSA key. More...

enum GNUNET_GenericReturnValue	GNUNET_CRYPTO_ecdh_eddsa (const struct GNUNET_CRYPTO_EcdhePrivateKey priv, const struct GNUNET_CRYPTO_EddsaPublicKey pub, struct GNUNET_HashCode *key_material)
	Derive key material from a EdDSA public key and a private ECDH key. More...

enum GNUNET_GenericReturnValue	GNUNET_CRYPTO_ecdh_ecdsa (const struct GNUNET_CRYPTO_EcdhePrivateKey priv, const struct GNUNET_CRYPTO_EcdsaPublicKey pub, struct GNUNET_HashCode *key_material)
	Derive key material from a EcDSA public key and a private ECDH key. More...

enum GNUNET_GenericReturnValue	GNUNET_CRYPTO_eddsa_sign_ (const struct GNUNET_CRYPTO_EddsaPrivateKey priv, const struct GNUNET_CRYPTO_EccSignaturePurpose purpose, struct GNUNET_CRYPTO_EddsaSignature *sig)
	EdDSA sign a given block. More...

enum GNUNET_GenericReturnValue	GNUNET_CRYPTO_ecdsa_sign_ (const struct GNUNET_CRYPTO_EcdsaPrivateKey priv, const struct GNUNET_CRYPTO_EccSignaturePurpose purpose, struct GNUNET_CRYPTO_EcdsaSignature *sig)
	ECDSA Sign a given block. More...

enum GNUNET_GenericReturnValue	GNUNET_CRYPTO_eddsa_sign_raw (const struct GNUNET_CRYPTO_EddsaPrivateKey priv, void data, size_t size, struct GNUNET_CRYPTO_EddsaSignature *sig)

enum GNUNET_GenericReturnValue	GNUNET_CRYPTO_edx25519_sign_ (const struct GNUNET_CRYPTO_Edx25519PrivateKey priv, const struct GNUNET_CRYPTO_EccSignaturePurpose purpose, struct GNUNET_CRYPTO_Edx25519Signature *sig)
	Edx25519 sign a given block. More...

enum GNUNET_GenericReturnValue	GNUNET_CRYPTO_eddsa_verify_ (uint32_t purpose, const struct GNUNET_CRYPTO_EccSignaturePurpose validate, const struct GNUNET_CRYPTO_EddsaSignature sig, const struct GNUNET_CRYPTO_EddsaPublicKey *pub)
	Verify EdDSA signature. More...

enum GNUNET_GenericReturnValue	GNUNET_CRYPTO_ecdsa_verify_ (uint32_t purpose, const struct GNUNET_CRYPTO_EccSignaturePurpose validate, const struct GNUNET_CRYPTO_EcdsaSignature sig, const struct GNUNET_CRYPTO_EcdsaPublicKey *pub)
	Verify ECDSA signature. More...

enum GNUNET_GenericReturnValue	GNUNET_CRYPTO_edx25519_verify_ (uint32_t purpose, const struct GNUNET_CRYPTO_EccSignaturePurpose validate, const struct GNUNET_CRYPTO_Edx25519Signature sig, const struct GNUNET_CRYPTO_Edx25519PublicKey *pub)
	Verify Edx25519 signature. More...

struct GNUNET_CRYPTO_EcdsaPrivateKey *	GNUNET_CRYPTO_ecdsa_private_key_derive (const struct GNUNET_CRYPTO_EcdsaPrivateKey priv, const char label, const char *context)
	Derive a private key from a given private key and a label. More...

void	GNUNET_CRYPTO_ecdsa_public_key_derive (const struct GNUNET_CRYPTO_EcdsaPublicKey pub, const char label, const char context, struct GNUNET_CRYPTO_EcdsaPublicKey result)
	Derive a public key from a given public key and a label. More...

enum GNUNET_GenericReturnValue	GNUNET_CRYPTO_ecdsa_sign_derived (const struct GNUNET_CRYPTO_EcdsaPrivateKey pkey, const char label, const char context, const struct GNUNET_CRYPTO_EccSignaturePurpose purpose, struct GNUNET_CRYPTO_EcdsaSignature *sig)
	This is a signature function for ECDSA which takes a private key, derives/blinds it and signs the message. More...

void	GNUNET_CRYPTO_eddsa_private_key_derive (const struct GNUNET_CRYPTO_EddsaPrivateKey priv, const char label, const char context, struct GNUNET_CRYPTO_EddsaPrivateScalar result)
	Derive a private scalar from a given private key and a label. More...

void	GNUNET_CRYPTO_eddsa_public_key_derive (const struct GNUNET_CRYPTO_EddsaPublicKey pub, const char label, const char context, struct GNUNET_CRYPTO_EddsaPublicKey result)
	Derive a public key from a given public key and a label. More...

enum GNUNET_GenericReturnValue	GNUNET_CRYPTO_eddsa_sign_derived (const struct GNUNET_CRYPTO_EddsaPrivateKey pkey, const char label, const char context, const struct GNUNET_CRYPTO_EccSignaturePurpose purpose, struct GNUNET_CRYPTO_EddsaSignature *sig)
	This is a signature function for EdDSA which takes a private key and derives it using the label and context before signing. More...

void	GNUNET_CRYPTO_eddsa_key_get_public_from_scalar (const struct GNUNET_CRYPTO_EddsaPrivateScalar s, struct GNUNET_CRYPTO_EddsaPublicKey pkey)
	Extract the public key of the given private scalar. More...

void	GNUNET_CRYPTO_edx25519_private_key_derive (const struct GNUNET_CRYPTO_Edx25519PrivateKey priv, const void seed, size_t seedsize, struct GNUNET_CRYPTO_Edx25519PrivateKey *result)
	Derive a private scalar from a given private key and a label. More...

void	GNUNET_CRYPTO_edx25519_public_key_derive (const struct GNUNET_CRYPTO_Edx25519PublicKey pub, const void seed, size_t seedsize, struct GNUNET_CRYPTO_Edx25519PublicKey *result)
	Derive a public key from a given public key and a label. More...

void	GNUNET_CRYPTO_mpi_print_unsigned (void *buf, size_t size, gcry_mpi_t val)
	Output the given MPI value to the given buffer in network byte order. More...

void	GNUNET_CRYPTO_mpi_scan_unsigned (gcry_mpi_t result, const void data, size_t size)
	Convert data buffer into MPI value. More...

void	GNUNET_CRYPTO_paillier_create (struct GNUNET_CRYPTO_PaillierPublicKey public_key, struct GNUNET_CRYPTO_PaillierPrivateKey private_key)
	Create a freshly generated paillier public key. More...

int	GNUNET_CRYPTO_paillier_encrypt (const struct GNUNET_CRYPTO_PaillierPublicKey public_key, const gcry_mpi_t m, int desired_ops, struct GNUNET_CRYPTO_PaillierCiphertext ciphertext)
	Encrypt a plaintext with a paillier public key. More...

void	GNUNET_CRYPTO_paillier_decrypt (const struct GNUNET_CRYPTO_PaillierPrivateKey private_key, const struct GNUNET_CRYPTO_PaillierPublicKey public_key, const struct GNUNET_CRYPTO_PaillierCiphertext *ciphertext, gcry_mpi_t m)
	Decrypt a paillier ciphertext with a private key. More...

int	GNUNET_CRYPTO_paillier_hom_add (const struct GNUNET_CRYPTO_PaillierPublicKey public_key, const struct GNUNET_CRYPTO_PaillierCiphertext c1, const struct GNUNET_CRYPTO_PaillierCiphertext c2, struct GNUNET_CRYPTO_PaillierCiphertext result)
	Compute a ciphertext that represents the sum of the plaintext in c1 and c2. More...

int	GNUNET_CRYPTO_paillier_hom_get_remaining (const struct GNUNET_CRYPTO_PaillierCiphertext *c)
	Get the number of remaining supported homomorphic operations. More...

struct GNUNET_CRYPTO_RsaPrivateKey *	GNUNET_CRYPTO_rsa_private_key_create (unsigned int len)
	Create a new private key. More...

void	GNUNET_CRYPTO_rsa_private_key_free (struct GNUNET_CRYPTO_RsaPrivateKey *key)
	Free memory occupied by the private key. More...

size_t	GNUNET_CRYPTO_rsa_private_key_encode (const struct GNUNET_CRYPTO_RsaPrivateKey key, void *buffer)
	Encode the private key in a format suitable for storing it into a file. More...

struct GNUNET_CRYPTO_RsaPrivateKey *	GNUNET_CRYPTO_rsa_private_key_decode (const void *buf, size_t buf_size)
	Decode the private key from the data-format back to the "normal", internal format. More...

struct GNUNET_CRYPTO_RsaPrivateKey *	GNUNET_CRYPTO_rsa_private_key_dup (const struct GNUNET_CRYPTO_RsaPrivateKey *key)
	Duplicate the given private key. More...

struct GNUNET_CRYPTO_RsaPublicKey *	GNUNET_CRYPTO_rsa_private_key_get_public (const struct GNUNET_CRYPTO_RsaPrivateKey *priv)
	Extract the public key of the given private key. More...

void	GNUNET_CRYPTO_rsa_public_key_hash (const struct GNUNET_CRYPTO_RsaPublicKey key, struct GNUNET_HashCode hc)
	Compute hash over the public key. More...

bool	GNUNET_CRYPTO_rsa_public_key_check (const struct GNUNET_CRYPTO_RsaPublicKey *key)
	Check if key is well-formed. More...

unsigned int	GNUNET_CRYPTO_rsa_public_key_len (const struct GNUNET_CRYPTO_RsaPublicKey *key)
	Obtain the length of the RSA key in bits. More...

void	GNUNET_CRYPTO_rsa_public_key_free (struct GNUNET_CRYPTO_RsaPublicKey *key)
	Free memory occupied by the public key. More...

size_t	GNUNET_CRYPTO_rsa_public_key_encode (const struct GNUNET_CRYPTO_RsaPublicKey key, void *buffer)
	Encode the public key in a format suitable for storing it into a file. More...

struct GNUNET_CRYPTO_RsaPublicKey *	GNUNET_CRYPTO_rsa_public_key_decode (const char *buf, size_t len)
	Decode the public key from the data-format back to the "normal", internal format. More...

struct GNUNET_CRYPTO_RsaPublicKey *	GNUNET_CRYPTO_rsa_public_key_dup (const struct GNUNET_CRYPTO_RsaPublicKey *key)
	Duplicate the given public key. More...

int	GNUNET_CRYPTO_rsa_signature_cmp (const struct GNUNET_CRYPTO_RsaSignature s1, const struct GNUNET_CRYPTO_RsaSignature s2)
	Compare the values of two signatures. More...

int	GNUNET_CRYPTO_rsa_private_key_cmp (const struct GNUNET_CRYPTO_RsaPrivateKey p1, const struct GNUNET_CRYPTO_RsaPrivateKey p2)
	Compare the values of two private keys. More...

int	GNUNET_CRYPTO_rsa_public_key_cmp (const struct GNUNET_CRYPTO_RsaPublicKey p1, const struct GNUNET_CRYPTO_RsaPublicKey p2)
	Compare the values of two public keys. More...

int	GNUNET_CRYPTO_rsa_blind (const struct GNUNET_HashCode hash, const struct GNUNET_CRYPTO_RsaBlindingKeySecret bks, struct GNUNET_CRYPTO_RsaPublicKey pkey, void buf, size_t buf_size)
	Blinds the given message with the given blinding key. More...

struct GNUNET_CRYPTO_RsaSignature *	GNUNET_CRYPTO_rsa_sign_blinded (const struct GNUNET_CRYPTO_RsaPrivateKey key, const void msg, size_t msg_len)
	Sign a blinded value, which must be a full domain hash of a message. More...

struct GNUNET_CRYPTO_RsaSignature *	GNUNET_CRYPTO_rsa_sign_fdh (const struct GNUNET_CRYPTO_RsaPrivateKey key, const struct GNUNET_HashCode hash)
	Create and sign a full domain hash of a message. More...

void	GNUNET_CRYPTO_rsa_signature_free (struct GNUNET_CRYPTO_RsaSignature *sig)
	Free memory occupied by signature. More...

size_t	GNUNET_CRYPTO_rsa_signature_encode (const struct GNUNET_CRYPTO_RsaSignature sig, void *buffer)
	Encode the given signature in a format suitable for storing it into a file. More...

struct GNUNET_CRYPTO_RsaSignature *	GNUNET_CRYPTO_rsa_signature_decode (const void *buf, size_t buf_size)
	Decode the signature from the data-format back to the "normal", internal format. More...

struct GNUNET_CRYPTO_RsaSignature *	GNUNET_CRYPTO_rsa_signature_dup (const struct GNUNET_CRYPTO_RsaSignature *sig)
	Duplicate the given rsa signature. More...

struct GNUNET_CRYPTO_RsaSignature *	GNUNET_CRYPTO_rsa_unblind (const struct GNUNET_CRYPTO_RsaSignature sig, const struct GNUNET_CRYPTO_RsaBlindingKeySecret bks, struct GNUNET_CRYPTO_RsaPublicKey *pkey)
	Unblind a blind-signed signature. More...

enum GNUNET_GenericReturnValue	GNUNET_CRYPTO_rsa_verify (const struct GNUNET_HashCode hash, const struct GNUNET_CRYPTO_RsaSignature sig, const struct GNUNET_CRYPTO_RsaPublicKey *public_key)
	Verify whether the given hash corresponds to the given signature and the signature is valid with respect to the given public key. More...

void	GNUNET_CRYPTO_cs_private_key_generate (struct GNUNET_CRYPTO_CsPrivateKey *priv)
	Create a new random private key. More...

void	GNUNET_CRYPTO_cs_private_key_get_public (const struct GNUNET_CRYPTO_CsPrivateKey priv, struct GNUNET_CRYPTO_CsPublicKey pub)
	Extract the public key of the given private key. More...

void	GNUNET_CRYPTO_cs_r_derive (const struct GNUNET_CRYPTO_CsNonce nonce, const char seed, const struct GNUNET_CRYPTO_CsPrivateKey *lts, struct GNUNET_CRYPTO_CsRSecret r[2])
	Derive a new secret r pair r0 and r1. More...

void	GNUNET_CRYPTO_cs_r_get_public (const struct GNUNET_CRYPTO_CsRSecret r_priv, struct GNUNET_CRYPTO_CsRPublic r_pub)
	Extract the public R of the given secret r. More...

void	GNUNET_CRYPTO_cs_blinding_secrets_derive (const struct GNUNET_CRYPTO_CsNonce *blind_seed, struct GNUNET_CRYPTO_CsBlindingSecret bs[2])
	Derives new random blinding factors. More...

void	GNUNET_CRYPTO_cs_calc_blinded_c (const struct GNUNET_CRYPTO_CsBlindingSecret bs[2], const struct GNUNET_CRYPTO_CsRPublic r_pub[2], const struct GNUNET_CRYPTO_CsPublicKey pub, const void msg, size_t msg_len, struct GNUNET_CRYPTO_CsC blinded_c[2], struct GNUNET_CRYPTO_CsRPublic blinded_r_pub[2])
	Calculate two blinded c's Comment: One would be insecure due to Wagner's algorithm solving ROS. More...

unsigned int	GNUNET_CRYPTO_cs_sign_derive (const struct GNUNET_CRYPTO_CsPrivateKey priv, const struct GNUNET_CRYPTO_CsRSecret r[2], const struct GNUNET_CRYPTO_CsC c[2], const struct GNUNET_CRYPTO_CsNonce nonce, struct GNUNET_CRYPTO_CsBlindS *blinded_signature_scalar)
	Sign a blinded c This function derives b from a nonce and a longterm secret In original papers b is generated randomly To provide abort-idempotency, b needs to be derived but still need to be UNPREDICTABLE. More...

void	GNUNET_CRYPTO_cs_unblind (const struct GNUNET_CRYPTO_CsBlindS blinded_signature_scalar, const struct GNUNET_CRYPTO_CsBlindingSecret bs, struct GNUNET_CRYPTO_CsS *signature_scalar)
	Unblind a blind-signed signature using a c that was blinded. More...

enum GNUNET_GenericReturnValue	GNUNET_CRYPTO_cs_verify (const struct GNUNET_CRYPTO_CsSignature sig, const struct GNUNET_CRYPTO_CsPublicKey pub, const void *msg, size_t msg_len)
	Verify whether the given message corresponds to the given signature and the signature is valid with respect to the given public key. More...

Detailed Description

cryptographic primitives for GNUnet

Author: Christian Grothoff; Krista Bennett; Gerd Knorr kraxe.nosp@m.l@by.nosp@m.tesex.nosp@m..org; Ioana Patrascu; Tzvetan Horozov; Jeffrey Burdges burdg.nosp@m.es@g.nosp@m.nunet.nosp@m..org

Definition in file gnunet_crypto_lib.h.

Data Structures

Macros

Typedefs

Enumerations

Functions

Detailed Description