falcon_8h_source.html

#pragma once


#include "params.h"


#include <pqlr/common/pqlr.h>

#include <pqlr/common/api.h>


#include <stdint.h>


#ifdef __cplusplus

extern "C" {

#endif  // __cplusplus


typedef struct falcon_st* falcon_t;


PQLR_API falcon_t falcon_new(falcon_parameterset_t parameterset);


PQLR_API void falcon_free(falcon_t falcon);


PQLR_API falcon_t falcon_duplicate(const falcon_t src);


PQLR_API pqlr_t falcon_to_pqlr(falcon_t falcon);


PQLR_API size_t falcon_get_public_key_bytes_len(falcon_t falcon);


PQLR_API size_t falcon_get_secret_key_bytes_len(falcon_t falcon);


PQLR_API size_t falcon_get_signature_bytes_len(falcon_t falcon);


PQLR_API void falcon_generate_keys(

    const falcon_t falcon, uint8_t* result_sk, uint8_t* result_pk);


PQLR_API void falcon_sign(

    const falcon_t falcon,

    const uint8_t* sk,

    const uint8_t* msg,

    size_t msg_len,

    uint8_t* result_sig,

    size_t* result_sig_len);


PQLR_API int falcon_verify(

    const falcon_t falcon,

    const uint8_t* pk,

    const uint8_t* sig,

    size_t sig_len,

    const uint8_t* msg,

    size_t msg_len);


#ifdef __cplusplus

}  // extern "C"

#endif  // __cplusplus

api.h

PQLR_API
#define PQLR_API
Definition api.h:22

pqlr_t
struct pqlr_st * pqlr_t
Pqlr instance handle. Pqlr represents basic library and it's algorithms configuration....
Definition pqlr.h:26

falcon_generate_keys
PQLR_API void falcon_generate_keys(const falcon_t falcon, uint8_t *result_sk, uint8_t *result_pk)
Generates random secret key and public key for given context.

falcon_free
PQLR_API void falcon_free(falcon_t falcon)
Frees falcon instance and all corresponding resources.

falcon_t
struct falcon_st * falcon_t
Falcon algorithm instance handle.
Definition falcon.h:50

falcon_parameterset_t
falcon_parameterset_t
Parameter set.
Definition params.h:20

falcon_duplicate
PQLR_API falcon_t falcon_duplicate(const falcon_t src)
Duplicates context copying all related resources.

falcon_get_secret_key_bytes_len
PQLR_API size_t falcon_get_secret_key_bytes_len(falcon_t falcon)
Obtains secret key buffer length in bytes for current falcon instance.

falcon_verify
PQLR_API int falcon_verify(const falcon_t falcon, const uint8_t *pk, const uint8_t *sig, size_t sig_len, const uint8_t *msg, size_t msg_len)
Verifies that given signature is the signature of given message.

falcon_sign
PQLR_API void falcon_sign(const falcon_t falcon, const uint8_t *sk, const uint8_t *msg, size_t msg_len, uint8_t *result_sig, size_t *result_sig_len)
Generates signature for given message according to context and secret key. The signature is non-deter...

falcon_get_signature_bytes_len
PQLR_API size_t falcon_get_signature_bytes_len(falcon_t falcon)
Obtains signature buffer length in bytes for current falcon instance.

falcon_get_public_key_bytes_len
PQLR_API size_t falcon_get_public_key_bytes_len(falcon_t falcon)
Obtains public key buffer length in bytes for current falcon instance.

falcon_to_pqlr
PQLR_API pqlr_t falcon_to_pqlr(falcon_t falcon)
Gets pqlr instance linked to this falcon instance.

falcon_new
PQLR_API falcon_t falcon_new(falcon_parameterset_t parameterset)
Creates new falcon instance with selected parameter set.

pqlr.h

params.h