#define SX_D448_PT_SZ 57

Size in bytes of an encoded ED448 point

#define SX_ED448_DGST_SZ  (57 * 2)

Size in bytes of a digest in ED448 operations

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

An encoded ED448 point

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

A ED448 scalar value

struct sx_ed448_dgst {
    /** Bytes array of hash digest **/
    char bytes[SX_ED448_DGST_SZ];
};

A hash digest used in the ED448 protocol

typedef int (*FUNC_SX_ED448_PTMULT)(struct sx_pk_cnx *cnx, const struct sx_ed448_dgst *r, struct sx_ed448_pt *pt);
#define SX_ED448_PTMULT         ((FUNC_SX_ED448_PTMULT)(*(uint32_t *)(API_TABLE_BASE_ADDRESS + ATO_SX_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.

SX_ASYNC_ED448_PTMULT_GO() and SX_ASYNC_ED448_PTMULT_END() for an asynchronous version

SX_OK SX_ERR_OUT_OF_RANGE SX_ERR_POINT_NOT_ON_CURVE SX_ERR_INVALID_SIGNATURE SX_ERR_INVALID_PARAM SX_ERR_UNKNOWN_ERROR SX_ERR_BUSY SX_ERR_NOT_IMPLEMENTED SX_ERR_OPERAND_TOO_LARGE SX_ERR_PLATFORM_ERROR SX_ERR_EXPIRED

typedef struct sx_pk_dreq (*FUNC_SX_ASYNC_ED448_PTMULT_GO)(struct sx_pk_cnx *cnx, const struct sx_ed448_dgst *r);
#define SX_ASYNC_ED448_PTMULT_GO         ((FUNC_SX_ASYNC_ED448_PTMULT_GO)(*(uint32_t *)(API_TABLE_BASE_ADDRESS + ATO_SX_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 SX_ASYNC_ED448_PTMULT_END()

SX_ASYNC_ED448_PTMULT_END() and SX_ASYNC_ED448_PTMULT()

Acquired acceleration request for this operation

typedef void (*FUNC_SX_ASYNC_ED448_PTMULT_END)(sx_pk_accel *req, struct sx_ed448_pt *pt);
#define SX_ASYNC_ED448_PTMULT_END         ((FUNC_SX_ASYNC_ED448_PTMULT_END)(*(uint32_t *)(API_TABLE_BASE_ADDRESS + ATO_SX_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.

SX_ASYNC_ED448_PTMULT_GO() and SX_ED448_PTMULT()

None

typedef int (*FUNC_SX_ED448_SIGN)(struct sx_pk_cnx *cnx, const struct sx_ed448_dgst *k, const struct sx_ed448_dgst *r, const struct sx_ed448_v *s, struct sx_ed448_v *sig_s);
#define SX_ED448_SIGN         ((FUNC_SX_ED448_SIGN)(*(uint32_t *)(API_TABLE_BASE_ADDRESS + ATO_SX_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

SX_PK_ASYNC_ED448_SIGN_GO() and SX_ASYNC_ED448_SIGN_END() for an asynchronous version

SX_OK SX_ERR_INVALID_PARAM SX_ERR_UNKNOWN_ERROR SX_ERR_BUSY SX_ERR_NOT_IMPLEMENTED SX_ERR_OPERAND_TOO_LARGE SX_ERR_PLATFORM_ERROR SX_ERR_EXPIRED

typedef struct sx_pk_dreq  (*FUNC_SX_PK_ASYNC_ED448_SIGN_GO)(struct sx_pk_cnx *cnx, const struct sx_ed448_dgst *k, const struct sx_ed448_dgst *r, const struct sx_ed448_v *s);
#define SX_PK_ASYNC_ED448_SIGN_GO         ((FUNC_SX_PK_ASYNC_ED448_SIGN_GO)(*(uint32_t *)(API_TABLE_BASE_ADDRESS + ATO_SX_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 SX_ASYNC_ED448_SIGN_END()

SX_ED448_SIGN() and SX_ASYNC_ED448_SIGN_END()

Acquired acceleration request for this operation

typedef void (*FUNC_SX_ASYNC_ED448_SIGN_END)(sx_pk_accel *req, struct sx_ed448_v *sig_s);
#define SX_ASYNC_ED448_SIGN_END         ((FUNC_SX_ASYNC_ED448_SIGN_END)(*(uint32_t *)(API_TABLE_BASE_ADDRESS + ATO_SX_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.

SX_PK_ASYNC_ED448_SIGN_GO() and SX_ED448_SIGN()

None

typedef int (*FUNC_SX_ED448_VERIFY)(struct sx_pk_cnx *cnx, const struct sx_ed448_dgst *k, const struct sx_ed448_pt *a, const struct sx_ed448_v *sig_s, const struct sx_ed448_pt *r);
#define SX_ED448_VERIFY         ((FUNC_SX_ED448_VERIFY)(*(uint32_t *)(API_TABLE_BASE_ADDRESS + ATO_SX_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'.

SX_ASYNC_ED448_VERIFY_GO() for an asynchronous version

SX_OK SX_ERR_INVALID_PARAM SX_ERR_UNKNOWN_ERROR SX_ERR_BUSY SX_ERR_NOT_IMPLEMENTED SX_ERR_OPERAND_TOO_LARGE SX_ERR_PLATFORM_ERROR SX_ERR_EXPIRED

typedef struct sx_pk_dreq (*FUNC_SX_ASYNC_ED448_VERIFY_GO)(struct sx_pk_cnx *cnx, const struct sx_ed448_dgst *k, const struct sx_ed448_pt *a, const struct sx_ed448_v *sig_s, const struct sx_ed448_pt *r);
#define SX_ASYNC_ED448_VERIFY_GO         ((FUNC_SX_ASYNC_ED448_VERIFY_GO)(*(uint32_t *)(API_TABLE_BASE_ADDRESS + ATO_SX_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 SX_PK_RELEASE_REQ()

SX_ED448_VERIFY()

Acquired acceleration request for this operation