#define CRM_D448_PT_SZ 57

Size in bytes of an encoded ED448 point

#define CRM_ED448_DGST_SZ  (57 * 2)

Size in bytes of a digest in ED448 operations

struct crm_ed448_pt {
    /** Bytes array representing encoded point for ED448 **/
    char encoded[CRM_ED448_PT_SZ];
};

An encoded ED448 point

struct crm_ed448_v {
    /** Bytes array representing scalar for ED448 **/
    char bytes[CRM_ED448_SZ];
};

A ED448 scalar value

struct crm_ed448_dgst {
    /** Bytes array of hash digest **/
    char bytes[CRM_ED448_DGST_SZ];
};

A hash digest used in the ED448 protocol

typedef int (*FUNC_CRM_ED448_PTMULT)(struct crm_pk_cnx *cnx, const struct crm_ed448_dgst *r, struct crm_ed448_pt *pt);
#define CRM_ED448_PTMULT         ((FUNC_CRM_ED448_PTMULT)(*(uint32_t *)(API_TABLE_BASE_ADDRESS + ATO_CRM_ED448_PTMULT)))

EDDSA point multiplication (ED448) Compute R = r * G, where r is a scalar which can be up to twice the size of the other operands. G is the generator point for the curve. The point R is encoded in pt. When computing the public key, the scalar 'r' is the secret scalar based on the clamped hash digest of the private key.

CRM_ASYNC_ED448_PTMULT_GO() and CRM_ASYNC_ED448_PTMULT_END() for an asynchronous version

CRM_OK CRM_ERR_OUT_OF_RANGE CRM_ERR_POINT_NOT_ON_CURVE CRM_ERR_INVALID_SIGNATURE CRM_ERR_INVALID_PARAM CRM_ERR_UNKNOWN_ERROR CRM_ERR_BUSY CRM_ERR_NOT_IMPLEMENTED CRM_ERR_OPERAND_TOO_LARGE CRM_ERR_PLATFORM_ERROR CRM_ERR_EXPIRED

typedef struct crm_pk_dreq (*FUNC_CRM_ASYNC_ED448_PTMULT_GO)(struct crm_pk_cnx *cnx, const struct crm_ed448_dgst *r);
#define CRM_ASYNC_ED448_PTMULT_GO         ((FUNC_CRM_ASYNC_ED448_PTMULT_GO)(*(uint32_t *)(API_TABLE_BASE_ADDRESS + ATO_CRM_ASYNC_ED448_PTMULT_GO)))

Asynchronous EDDSA point multiplication (ED448) Start an EDDSA point multiplication on the accelerator and return immediately. When the operation finishes on the accelerator, call CRM_ASYNC_ED448_PTMULT_END()

CRM_ASYNC_ED448_PTMULT_END() and CRM_ASYNC_ED448_PTMULT()

Acquired acceleration request for this operation

typedef void (*FUNC_CRM_ASYNC_ED448_PTMULT_END)(crm_pk_accel *req, struct crm_ed448_pt *pt);
#define CRM_ASYNC_ED448_PTMULT_END         ((FUNC_CRM_ASYNC_ED448_PTMULT_END)(*(uint32_t *)(API_TABLE_BASE_ADDRESS + ATO_CRM_ASYNC_ED448_PTMULT_END)))

Collect the result of asynchronous EDDSA point multiplication (ED448) Get the output operands of the EDDSA point multiplication and release the reserved resources. The operation on the accelerator must be finished before calling this function.

CRM_ASYNC_ED448_PTMULT_GO() and CRM_ED448_PTMULT()

None

typedef int (*FUNC_CRM_ED448_SIGN)(struct crm_pk_cnx *cnx, const struct crm_ed448_dgst *k, const struct crm_ed448_dgst *r, const struct crm_ed448_v *s, struct crm_ed448_v *sig_s);
#define CRM_ED448_SIGN         ((FUNC_CRM_ED448_SIGN)(*(uint32_t *)(API_TABLE_BASE_ADDRESS + ATO_CRM_ED448_SIGN))))))

Compute signature scalar s for pure EDDSA (ED448). This represents the second step in computing an EDDSA signature. This step computes sig_s : sig_s = (r + k * s) % l

CRM_PK_ASYNC_ED448_SIGN_GO() and CRM_ASYNC_ED448_SIGN_END() for an asynchronous version

CRM_OK CRM_ERR_INVALID_PARAM CRM_ERR_UNKNOWN_ERROR CRM_ERR_BUSY CRM_ERR_NOT_IMPLEMENTED CRM_ERR_OPERAND_TOO_LARGE CRM_ERR_PLATFORM_ERROR CRM_ERR_EXPIRED

typedef struct crm_pk_dreq  (*FUNC_CRM_PK_ASYNC_ED448_SIGN_GO)(struct crm_pk_cnx *cnx, const struct crm_ed448_dgst *k, const struct crm_ed448_dgst *r, const struct crm_ed448_v *s);
#define CRM_PK_ASYNC_ED448_SIGN_GO         ((FUNC_CRM_PK_ASYNC_ED448_SIGN_GO)(*(uint32_t *)(API_TABLE_BASE_ADDRESS + ATO_CRM_PK_ASYNC_ED448_SIGN_GO)))

Asynchronous second part signature generation for pure EDDSA (ED448). Start an ED448 signature generation on the accelerator and return immediately. When the operation finishes on the accelerator, call CRM_ASYNC_ED448_SIGN_END()

CRM_ED448_SIGN() and CRM_ASYNC_ED448_SIGN_END()

Acquired acceleration request for this operation

typedef void (*FUNC_CRM_ASYNC_ED448_SIGN_END)(crm_pk_accel *req, struct crm_ed448_v *sig_s);
#define CRM_ASYNC_ED448_SIGN_END         ((FUNC_CRM_ASYNC_ED448_SIGN_END)(*(uint32_t *)(API_TABLE_BASE_ADDRESS + ATO_CRM_ASYNC_ED448_SIGN_END)))

Collect the result of asynchronous computation of ED448 signature scalar Get the output operands of the ED448 signature generation and release the reserved resources. The operation on the accelerator must be finished before calling this function.

CRM_PK_ASYNC_ED448_SIGN_GO() and CRM_ED448_SIGN()

None

typedef int (*FUNC_CRM_ED448_VERIFY)(struct crm_pk_cnx *cnx, const struct crm_ed448_dgst *k, const struct crm_ed448_pt *a, const struct crm_ed448_v *sig_s, const struct crm_ed448_pt *r);
#define CRM_ED448_VERIFY         ((FUNC_CRM_ED448_VERIFY)(*(uint32_t *)(API_TABLE_BASE_ADDRESS + ATO_CRM_ED448_VERIFY)))

Verify an EDDSA signature (ED448) It checks if sig_s * G - k * A matches R. sig_s and the encoded point R form the signature. The points A and R are passed in their encoded form via 'a' and 'r'.

CRM_ASYNC_ED448_VERIFY_GO() for an asynchronous version

CRM_OK CRM_ERR_INVALID_PARAM CRM_ERR_UNKNOWN_ERROR CRM_ERR_BUSY CRM_ERR_NOT_IMPLEMENTED CRM_ERR_OPERAND_TOO_LARGE CRM_ERR_PLATFORM_ERROR CRM_ERR_EXPIRED

typedef struct crm_pk_dreq (*FUNC_CRM_ASYNC_ED448_VERIFY_GO)(struct crm_pk_cnx *cnx, const struct crm_ed448_dgst *k, const struct crm_ed448_pt *a, const struct crm_ed448_v *sig_s, const struct crm_ed448_pt *r);
#define CRM_ASYNC_ED448_VERIFY_GO         ((FUNC_CRM_ASYNC_ED448_VERIFY_GO)(*(uint32_t *)(API_TABLE_BASE_ADDRESS + ATO_CRM_ASYNC_ED448_VERIFY_GO)))

Asynchronous (non-blocking) verify an ED448 signature. Start an ED448 signature generation on the accelerator and return immediately. When the operation finishes on the accelerator, call CRM_PK_RELEASE_REQ()

CRM_ED448_VERIFY()

Acquired acceleration request for this operation