crypto_interface_qs.h

Go to the documentation of this file.

/*
 * crypto_interface_qs.h
 *
 * Cryptographic Interface header file for declaring common Quantum Safe methods.
 *
 * Copyright 2019-2024 DigiCert, Inc. All Rights Reserved.
 * Proprietary and Confidential Material.
 *
 */

#ifndef __CRYPTO_INTERFACE_QS_HEADER__
#define __CRYPTO_INTERFACE_QS_HEADER__

#include "../common/random.h"
#include "../cap/capdecl.h"

#ifdef __cplusplus
extern "C" {
#endif

/* leave 0 to use as a flag for uninitialied */
#define MOC_QS_KEM           1
#define MOC_QS_SIG           2

#ifndef MOC_QS_KEM_DEFAULT_ALG
#define MOC_QS_KEM_DEFAULT_ALG cid_QS_KEM_KYBER_512
#endif

#ifndef MOC_QS_SIG_DEFAULT_ALG
#define MOC_QS_SIG_DEFAULT_ALG cid_QS_SIG_DILITHIUM_2
#endif


typedef struct
{
    MocAsymKey pSecretKey;
    MocAsymKey pPublicKey;
    ubyte4 enabled;
    ubyte4 isPrivate;
    ubyte4 type;
    ubyte4 alg;

} QS_CTX;

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_QS_newCtx(QS_CTX **ppNewCtx, ubyte4 algo);

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_QS_getAlg(QS_CTX *pCtx, ubyte4 *pAlg);

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_QS_cloneCtx(QS_CTX **ppNewCtx, QS_CTX *pCtx);

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_QS_generateKeyPair(QS_CTX *pCtx, RNGFun rngFun, void *pRngFunArg);

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_QS_getPublicKeyLenFromAlgo(ubyte4 algo, ubyte4 *pPubLen);

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_QS_getPublicKeyLen(QS_CTX *pCtx, ubyte4 *pPubLen);

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_QS_getPublicKey(QS_CTX *pCtx, ubyte *pPublicKey, ubyte4 pubLen);

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_QS_getPublicKeyAlloc(QS_CTX *pCtx, ubyte **ppPublicKey, ubyte4 *pPubLen);

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_QS_setPublicKey(QS_CTX *pCtx, ubyte *pPublicKey, ubyte4 pubLen);

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_QS_equalKey(QS_CTX *pCtx1, QS_CTX *pCtx2, byteBoolean *pRes);

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_QS_deleteCtx(QS_CTX **ppCtx);

#ifdef __cplusplus
}
#endif

#endif /* __CRYPTO_INTERFACE_QS_HEADER__ */