ml_dsa.h

Go to the documentation of this file.

#pragma once
 
#include "pqlr/common/pqlr.h"
#include "pqlr/common/api.h"
 
#include "stdint.h"
#include "stddef.h"
 
#ifdef __cplusplus
extern "C" {
#endif  // __cplusplus
 
typedef enum {
    ml_dsa_44,
    ml_dsa_65,
    ml_dsa_87,
    ml_dsa_44_r,
    ml_dsa_65_r,
    ml_dsa_87_r,
    ml_dsa_last
} ml_dsa_parameterset_t;
 
typedef struct ml_dsa_st* ml_dsa_t;
 
PQLR_API ml_dsa_t ml_dsa_new(ml_dsa_parameterset_t parameterset);
 
PQLR_API void ml_dsa_free(ml_dsa_t ml_dsa);
 
PQLR_API ml_dsa_t ml_dsa_duplicate(const ml_dsa_t ml_dsa);
 
PQLR_API pqlr_t ml_dsa_to_pqlr(ml_dsa_t ml_dsa);
 
PQLR_API size_t ml_dsa_get_public_key_bytes_len(const ml_dsa_t ml_dsa);
 
PQLR_API size_t ml_dsa_get_secret_key_bytes_len(const ml_dsa_t ml_dsa);
 
PQLR_API size_t ml_dsa_get_signature_bytes_len(ml_dsa_t ml_dsa);
 
PQLR_API void ml_dsa_generate_keys(
    const ml_dsa_t ml_dsa, uint8_t* result_sk, uint8_t* result_pk);
 
PQLR_API void ml_dsa_sign(
    const ml_dsa_t ml_dsa,
    const uint8_t* sk,
    const uint8_t* msg,
    size_t msg_len,
    uint8_t* result_sig,
    size_t* result_sig_len);
 
PQLR_API void ml_dsa_sign_ex(
    const ml_dsa_t ml_dsa,
    const uint8_t* sk,
    const uint8_t* ctx,
    size_t ctx_len,
    const uint8_t* msg,
    size_t msg_len,
    uint8_t* result_sig,
    size_t* result_sig_len);
 
 
PQLR_API int ml_dsa_verify(
    const ml_dsa_t ml_dsa,
    const uint8_t* pk,
    const uint8_t* sig,
    size_t sig_len,
    const uint8_t* msg,
    size_t msg_len);
 
PQLR_API int ml_dsa_verify_ex(
    const ml_dsa_t ml_dsa,
    const uint8_t* pk,
    const uint8_t* sig,
    size_t sig_len,
    const uint8_t* ctx,
    size_t ctx_len,
    const uint8_t* msg,
    size_t msg_len);
  // Close the group
 
#ifdef __cplusplus
}  // extern "C"
#endif  //__cplusplus