crypto_interface_ecc.h

Go to the documentation of this file.

/*
 * crypto_interface_ecc.h
 *
 * Cryptographic Interface header file for declaring ECC functions
 * for the Crypto Interface.
 *
 * Copyright 2019-2024 DigiCert, Inc. All Rights Reserved.
 * Proprietary and Confidential Material.
 *
 */

#ifndef __CRYPTO_INTERFACE_ECC_HEADER__
#define __CRYPTO_INTERFACE_ECC_HEADER__

#include "../cap/capasym.h"

#ifdef __cplusplus
extern "C" {
#endif
    
MOC_EXTERN MSTATUS CRYPTO_INTERFACE_EC_newKeyEx (
  ubyte4 curveId,
  ECCKey** ppNewKey,
  ubyte4 keyType,
  void *pKeyAttributes
  );

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_EC_isKeyPrivate (
  ECCKey *pKey,
  intBoolean *pResult
  );

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_EC_generateKeyPairAlloc (
  MOC_ECC(hwAccelDescr hwAccelCtx)
  ubyte4 curveId,
  void **ppNewKey,
  RNGFun rngFun,
  void* rngArg,
  ubyte4 keyType,
  void *pKeyAttributes
  );

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_EC_newKeyAux (
  ubyte4 curveId,
  ECCKey** ppNewKey
  );

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_EC_deleteKeyAux (
  ECCKey **ppKey
  );

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_EC_cloneKeyAux (
  MOC_ECC(hwAccelDescr hwAccelCtx)
  ECCKey **ppNewKey,
  ECCKey *pSrc
  );

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_EC_equalKeyAux (
  MOC_ECC(hwAccelDescr hwAccelCtx)
  ECCKey *pKey1,
  ECCKey *pKey2,
  byteBoolean *pRes
  );

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_EC_verifyKeyPairAux (
  MOC_ECC(hwAccelDescr hwAccelCtx)
  ECCKey *pPrivateKey,
  ECCKey *pPublicKey,
  byteBoolean *pVfy
  );

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_EC_verifyPublicKeyAux (
  MOC_ECC(hwAccelDescr hwAccelCtx)
  ECCKey *pKey,
  byteBoolean *pIsValid
  );

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_EC_getElementByteStringLenAux (
  ECCKey *pKey,
  ubyte4 *pLen
  );

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_EC_getCurveIdFromKeyAux (
  ECCKey *pKey,
  ubyte4 *pCurveId
  );

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_EC_getPointByteStringLenByCurveId (
  ubyte4 curveId,
  ubyte4 *pLen
  );

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_EC_getPointByteStringLenAux (
  ECCKey *pKey,
  ubyte4 *pLen
  );

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_EC_getKeyParametersAllocAux (
  MOC_ECC(hwAccelDescr hwAccelCtx)
  ECCKey *pKey,
  MEccKeyTemplate *pTemplate,
  ubyte reqType
  );

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_EC_freeKeyTemplateAux (
  ECCKey *pKey,
  MEccKeyTemplate *pTemplate
  );

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_EC_setKeyParametersAux (
  MOC_ECC(hwAccelDescr hwAccelCtx)
  ECCKey *pKey,
  ubyte *pPoint,
  ubyte4 pointLen,
  ubyte *pScalar,
  ubyte4 scalarLen
  );
  
MOC_EXTERN MSTATUS CRYPTO_INTERFACE_EC_setPrivateKey(
  MOC_ECC(hwAccelDescr hwAccelCtx)
  ECCKey *pKey,
  ubyte *pScalar,
  ubyte4 scalarLen
  );

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_EC_writePublicKeyToBufferAux (
  MOC_ECC(hwAccelDescr hwAccelCtx)
  ECCKey *pKey,
  ubyte *pBuffer,
  ubyte4 bufferSize
  );

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_EC_writePublicKeyToBufferAllocAux (
  MOC_ECC(hwAccelDescr hwAccelCtx)
  ECCKey *pKey,
  ubyte **ppBuffer,
  ubyte4 *pBufferSize
  );

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_EC_newPublicKeyFromByteStringAux (
  MOC_ECC(hwAccelDescr hwAccelCtx)
  ubyte4 curveId,
  ECCKey **ppNewKey,
  ubyte *pByteString,
  ubyte4 byteStringLen
  );

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_EC_generateKeyPairAux (
  MOC_ECC(hwAccelDescr hwAccelCtx)
  ECCKey *pKey,
  RNGFun rngFun,
  void *pRngFunArg
  );

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_EC_generateKeyPairAllocAux (
  MOC_ECC(hwAccelDescr hwAccelCtx)
  ubyte4 curveId,
  ECCKey **ppKey,
  RNGFun rngFun,
  void *pRngFunArg
  );

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_ECDSA_signDigestAux (
  MOC_ECC(hwAccelDescr hwAccelCtx)
  ECCKey *pKey,
  RNGFun rngFun,
  void *rngArg,
  ubyte *pHash,
  ubyte4 hashLen,
  ubyte *pSignature,
  ubyte4 bufferSize,
  ubyte4 *pSignatureLen
  );

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_ECDSA_verifySignatureDigestAux (
  MOC_ECC(hwAccelDescr hwAccelCtx)
  ECCKey *pPublicKey,
  ubyte *pHash,
  ubyte4 hashLen,
  ubyte *pR,
  ubyte4 rLen,
  ubyte *pS,
  ubyte4 sLen,
  ubyte4 *pVerifyFailures
  );

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_ECDH_generateSharedSecretFromKeysAux (
  MOC_ECC(hwAccelDescr hwAccelCtx)
  ECCKey *pPrivateKey,
  ECCKey *pPublicKey,
  ubyte **ppSharedSecret,
  ubyte4 *pSharedSecretLen,
  sbyte4 flag,
  void *pKdfInfo
  );

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_ECDH_generateSharedSecretFromPublicByteStringAux (
  MOC_ECC(hwAccelDescr hwAccelCtx)
  ECCKey *pPrivateKey,
  ubyte *pPublicPointByteString,
  ubyte4 pointByteStringLen,
  ubyte **ppSharedSecret,
  ubyte4 *pSharedSecretLen,
  sbyte4 flag,
  void *pKdfInfo
  );

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_ECDH_keyAgreementScheme(
    MOC_ECC(hwAccelDescr hwAccelCtx)
    ubyte4 mode, 
    ECCKey *pStatic, 
    ECCKey *pEphemeral, 
    ubyte *pOtherPartysStatic, 
    ubyte4 otherStaticLen,
    ubyte *pOtherPartysEphemeral,
    ubyte4 otherEphemeralLen,
    ubyte **ppSharedSecret,
    ubyte4 *pSharedSecretLen);

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_ECDSA_signMessageExt (
  MOC_ECC(hwAccelDescr hwAccelCtx)
  ECCKey *pPrivateKey,
  RNGFun rngFUN,
  void *pRngArg,
  ubyte hashAlgo,
  ubyte *pMessage,
  ubyte4 messageLen,
  ubyte *pSignature,
  ubyte4 bufferSize,
  ubyte4 *pSignatureLen,
  void *pExtCtx
  );

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_ECDSA_verifyMessageExt (
  MOC_ECC(hwAccelDescr hwAccelCtx)
  ECCKey *pPublicKey,
  ubyte hashAlgo,
  ubyte *pMessage,
  ubyte4 messageLen,
  ubyte *pSignature,
  ubyte4 signatureLen,
  ubyte4 *pVerifyFailures,
  void *pExtCtx
  );

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_ECDSA_initVerifyExt (
  MOC_ECC(hwAccelDescr hwAccelCtx)
  ECDSA_CTX *pCtx,
  ECCKey *pPublicKey,
  ubyte hashAlgo,
  ubyte *pSignature,
  ubyte4 signatureLen,
  void *pExtCtx
  );

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_ECDSA_updateVerifyExt (
  MOC_ECC(hwAccelDescr hwAccelCtx)
  ECDSA_CTX *pCtx,
  ubyte *pMessage,
  ubyte4 messageLen,
  void *pExtCtx
  );

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_ECDSA_finalVerifyExt (
  MOC_ECC(hwAccelDescr hwAccelCtx)
  ECDSA_CTX *pCtx,
  ubyte4 *pVerifyFailures,
  void *pExtCtx
  );

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_EdDSA_signInput (
    MOC_ECC(hwAccelDescr hwAccelCtx)
    ECCKey *pKey,
    ubyte *pInput,
    ubyte4 inputLen,
    byteBoolean isPreHash,
    ubyte *pCtx,
    ubyte4 ctxLen,
    ubyte *pSignature,
    ubyte4 bufferSize,
    ubyte4 *pSignatureLen,
    void *pExtCtx
    );

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_EdDSA_verifyInput (
    MOC_ECC(hwAccelDescr hwAccelCtx)
    ECCKey *pKey,
    ubyte *pInput,
    ubyte4 inputLen,
    byteBoolean isPreHash,
    ubyte *pCtx,
    ubyte4 ctxLen,
    ubyte *pSignature,
    ubyte4 signatureLen,
    ubyte4 *pVerifyFailures,
    void *pExtCtx
    );

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_EC_createCombMutexes(void);


MOC_EXTERN MSTATUS CRYPTO_INTERFACE_EC_deleteAllCombsAndMutexes(void);

#ifdef __cplusplus
}
#endif

#endif /* __CRYPTO_INTERFACE_ECC_HEADER__ */