ecc_edwards_dsa.h

Go to the documentation of this file.

/*
 * ecc_edwards_dsa.h
 *
 * Header for Edward's Curve Digital Signature (edDSA) operations.
 *
 * Copyright 2019-2024 DigiCert, Inc. All Rights Reserved.
 * Proprietary and Confidential Material.
 *
 */

/*------------------------------------------------------------------*/

#ifndef __ECC_EDWARDS_DSA_HEADER__
#define __ECC_EDWARDS_DSA_HEADER__

#include "../crypto/ecc_edwards_keys.h"

#ifdef __cplusplus
extern "C" {
#endif

/* verifyStatus bit positions for edDSA_VerifySignature */
#define MOCANA_EDDSA_VERIFY_FAIL             0x00000001
#define MOCANA_EDDSA_VERIFY_R_INVALID        0x00000002
#define MOCANA_EDDSA_VERIFY_S_INVALID        0x00000004
#define MOCANA_EDDSA_VERIFY_PUB_KEY_INVALID  0x00000008

typedef struct edDSA_CTX
{

    ubyte *pPubKey;
    union
    {
        ubyte *pPrivKey;   /* needed for sign only */
        ubyte *pSignature; /* needed for verify only */
    };
    ubyte *pCtx;
    ubyte4 ctxLen;
    edECCCurve curve;
    BulkHashAlgo shaSuite;
    union
    {
        void *pShaCtx;
        void *pECCKey;     /* access for alternative implementations */
    };
    ubyte4 verifyStatus;   /* needed for verify only */
    byteBoolean initialized;
    byteBoolean preHash;
    ubyte4 enabled;        /* flag for alternative implementations */

} edDSA_CTX;
  

MOC_EXTERN MSTATUS edDSA_Sign(MOC_ECC(hwAccelDescr hwAccelCtx) edECCKey *pKey, ubyte *pMessage, ubyte4 messageLen, ubyte *pSignature,
                              ubyte4 bufferSize, ubyte4 *pSignatureLen, BulkHashAlgo *pShaSuite, byteBoolean preHash, ubyte *pCtx, ubyte4 ctxLen, void *pExtCtx);

MOC_EXTERN MSTATUS edDSA_VerifySignature(MOC_ECC(hwAccelDescr hwAccelCtx) edECCKey *pKey, ubyte *pMessage, ubyte4 messageLen, ubyte *pSignature,
                                         ubyte4 signatureLen, ubyte4 *pVerifyStatus, BulkHashAlgo *pShaSuite, byteBoolean preHash, ubyte *pCtx, ubyte4 ctxLen, void *pExtCtx);


MOC_EXTERN MSTATUS edDSA_initSignPreHash(MOC_ECC(hwAccelDescr hwAccelCtx) edDSA_CTX *pEdDSA_ctx, edECCKey *pKey, BulkHashAlgo *pShaSuite, ubyte *pCtx, ubyte4 ctxLen, void *pExtCtx);

MOC_EXTERN MSTATUS edDSA_initVerify(MOC_ECC(hwAccelDescr hwAccelCtx) edDSA_CTX *pEdDSA_ctx, edECCKey *pKey, ubyte *pSignature,
                                    ubyte4 signatureLen, BulkHashAlgo *pShaSuite, byteBoolean preHash, ubyte *pCtx, ubyte4 ctxLen, void *pExtCtx);

MOC_EXTERN MSTATUS edDSA_update(MOC_ECC(hwAccelDescr hwAccelCtx) edDSA_CTX *pEdDSA_ctx, ubyte *pMessage, ubyte4 messageLen, void *pExtCtx);

MOC_EXTERN MSTATUS edDSA_finalSign(MOC_ECC(hwAccelDescr hwAccelCtx) edDSA_CTX *pEdDSA_ctx, ubyte *pSignature, ubyte4 bufferSize, ubyte4 *pSignatureLen, void *pExtCtx);

MOC_EXTERN MSTATUS edDSA_finalVerify(MOC_ECC(hwAccelDescr hwAccelCtx) edDSA_CTX *pEdDSA_ctx, ubyte4 *pVerifyStatus, void *pExtCtx);

#ifdef __cplusplus
}
#endif

#endif /* __ECC_EDWARDS_DSA_HEADER__ */