#define CRM_D448_PT_SZ 57

Size in bytes of an encoded ED25519 point

#define CRM_ED25519_DGST_SZ  (57 * 2)

Size in bytes of a digest in ED25519 operations

struct crm_ed25519_pt {
    /** Bytes array representing encoded point for ED25519 **/
    char encoded[CRM_ED25519_PT_SZ];
};

An encoded ED25519 point

struct crm_ed25519_v {
    /** Bytes array representing scalar for ED25519 **/
    char bytes[CRM_ED25519_SZ];
};

A ED25519 scalar value

struct crm_ed25519_dgst {
    /** Bytes array of hash digest **/
    char bytes[CRM_ED25519_DGST_SZ];
};

A hash digest used in the ED25519 protocol

typedef int (*FUNC_CRM_ED25519_PTMULT)(struct crm_pk_cnx *cnx, const struct crm_ed25519_dgst *r, struct crm_ed25519_pt *pt);
#define CRM_ED25519_PTMULT         ((FUNC_CRM_ED25519_PTMULT)(*(uint32_t *)(API_TABLE_BASE_ADDRESS + ATO_CRM_ED25519_PTMULT)))

EDDSA point multiplication (ED25519) 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_ED25519_PTMULT_GO() and CRM_ASYNC_ED25519_PTMULT_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_ASYNC_ED25519_PTMULT_GO)(struct crm_pk_cnx *cnx, const struct crm_ed25519_dgst *r);
#define CRM_ASYNC_ED25519_PTMULT_GO         ((FUNC_CRM_ASYNC_ED25519_PTMULT_GO)(*(uint32_t *)(API_TABLE_BASE_ADDRESS + ATO_CRM_ASYNC_ED25519_PTMULT_GO)))

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

CRM_ASYNC_ED25519_PTMULT_END() and CRM_ASYNC_ED25519_PTMULT()

Acquired acceleration request for this operation

typedef void (*FUNC_CRM_ASYNC_ED25519_PTMULT_END)(crm_pk_accel *req, struct crm_ed25519_pt *pt);
#define CRM_ASYNC_ED25519_PTMULT_END         ((FUNC_CRM_ASYNC_ED25519_PTMULT_END)(*(uint32_t *)(API_TABLE_BASE_ADDRESS + ATO_CRM_ASYNC_ED25519_PTMULT_END)))

Collect the result of asynchronous EDDSA point multiplication (ED25519) 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_ED25519_PTMULT_GO() and CRM_ED25519_PTMULT()

None

typedef int (*FUNC_CRM_ED25519_SIGN)(struct crm_pk_cnx *cnx, const struct crm_ed25519_dgst *k, const struct crm_ed25519_dgst *r, const struct crm_ed25519_v *s, struct crm_ed25519_v *sig_s);
#define CRM_ED25519_SIGN         ((FUNC_CRM_ED25519_SIGN)(*(uint32_t *)(API_TABLE_BASE_ADDRESS + ATO_CRM_ED25519_SIGN)))

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

CRM_PK_ASYNC_ED25519_SIGN_GO() and CRM_ASYNC_ED25519_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_ED25519_SIGN_GO)(struct crm_pk_cnx *cnx, const struct crm_ed25519_dgst *k, const struct crm_ed25519_dgst *r, const struct crm_ed25519_v *s);
#define CRM_PK_ASYNC_ED25519_SIGN_GO         ((FUNC_CRM_PK_ASYNC_ED25519_SIGN_GO)(*(uint32_t *)(API_TABLE_BASE_ADDRESS + ATO_CRM_PK_ASYNC_ED25519_SIGN_GO)))

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

CRM_ED25519_SIGN() and CRM_ASYNC_ED25519_SIGN_END()

Acquired acceleration request for this operation

typedef void (*FUNC_CRM_ASYNC_ED25519_SIGN_END)(crm_pk_accel *req, struct crm_ed25519_v *sig_s);
#define CRM_ASYNC_ED25519_SIGN_END         ((FUNC_CRM_ASYNC_ED25519_SIGN_END)(*(uint32_t *)(API_TABLE_BASE_ADDRESS + ATO_CRM_ASYNC_ED25519_SIGN_END)))

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

CRM_PK_ASYNC_ED25519_SIGN_GO() and CRM_ED25519_SIGN()

None

typedef int (*FUNC_CRM_ED25519_VERIFY)(struct crm_pk_cnx *cnx, const struct crm_ed25519_dgst *k, const struct crm_ed25519_pt *a, const struct crm_ed25519_v *sig_s, const struct crm_ed25519_pt *r);
#define CRM_ED25519_VERIFY         ((FUNC_CRM_ED25519_VERIFY)(*(uint32_t *)(API_TABLE_BASE_ADDRESS + ATO_CRM_ED25519_VERIFY)))

Verify an EDDSA signature (ED25519) 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_ED25519_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_ED25519_VERIFY_GO)(struct crm_pk_cnx *cnx, const struct crm_ed25519_dgst *k, const struct crm_ed25519_pt *a, const struct crm_ed25519_v *sig_s, const struct crm_ed25519_pt *r);
#define CRM_ASYNC_ED25519_VERIFY_GO         ((FUNC_CRM_ASYNC_ED25519_VERIFY_GO)(*(uint32_t *)(API_TABLE_BASE_ADDRESS + ATO_CRM_ASYNC_ED25519_VERIFY_GO)))

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

CRM_ED25519_VERIFY()

Acquired acceleration request for this operation