#define SX_D448_PT_SZ 57

Size in bytes of an encoded ED25519 point

#define SX_ED25519_DGST_SZ  (57 * 2)

Size in bytes of a digest in ED25519 operations

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

An encoded ED25519 point

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

A ED25519 scalar value

struct sx_ed25519_dgst {
    /** Bytes array of hash digest **/
    char bytes[SX_ED25519_DGST_SZ];
};

A hash digest used in the ED25519 protocol

typedef int (*FUNC_SX_ED25519_PTMULT)(struct sx_pk_cnx *cnx, const struct sx_ed25519_dgst *r, struct sx_ed25519_pt *pt);
#define SX_ED25519_PTMULT         ((FUNC_SX_ED25519_PTMULT)(*(uint32_t *)(API_TABLE_BASE_ADDRESS + ATO_SX_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.

SX_ASYNC_ED25519_PTMULT_GO() and SX_ASYNC_ED25519_PTMULT_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_ASYNC_ED25519_PTMULT_GO)(struct sx_pk_cnx *cnx, const struct sx_ed25519_dgst *r);
#define SX_ASYNC_ED25519_PTMULT_GO         ((FUNC_SX_ASYNC_ED25519_PTMULT_GO)(*(uint32_t *)(API_TABLE_BASE_ADDRESS + ATO_SX_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 SX_ASYNC_ED25519_PTMULT_END()

SX_ASYNC_ED25519_PTMULT_END() and SX_ASYNC_ED25519_PTMULT()

Acquired acceleration request for this operation

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

SX_ASYNC_ED25519_PTMULT_GO() and SX_ED25519_PTMULT()

None

typedef int (*FUNC_SX_ED25519_SIGN)(struct sx_pk_cnx *cnx, const struct sx_ed25519_dgst *k, const struct sx_ed25519_dgst *r, const struct sx_ed25519_v *s, struct sx_ed25519_v *sig_s);
#define SX_ED25519_SIGN         ((FUNC_SX_ED25519_SIGN)(*(uint32_t *)(API_TABLE_BASE_ADDRESS + ATO_SX_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

SX_PK_ASYNC_ED25519_SIGN_GO() and SX_ASYNC_ED25519_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_ED25519_SIGN_GO)(struct sx_pk_cnx *cnx, const struct sx_ed25519_dgst *k, const struct sx_ed25519_dgst *r, const struct sx_ed25519_v *s);
#define SX_PK_ASYNC_ED25519_SIGN_GO         ((FUNC_SX_PK_ASYNC_ED25519_SIGN_GO)(*(uint32_t *)(API_TABLE_BASE_ADDRESS + ATO_SX_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 SX_ASYNC_ED25519_SIGN_END()

SX_ED25519_SIGN() and SX_ASYNC_ED25519_SIGN_END()

Acquired acceleration request for this operation

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

SX_PK_ASYNC_ED25519_SIGN_GO() and SX_ED25519_SIGN()

None

typedef int (*FUNC_SX_ED25519_VERIFY)(struct sx_pk_cnx *cnx, const struct sx_ed25519_dgst *k, const struct sx_ed25519_pt *a, const struct sx_ed25519_v *sig_s, const struct sx_ed25519_pt *r);
#define SX_ED25519_VERIFY         ((FUNC_SX_ED25519_VERIFY)(*(uint32_t *)(API_TABLE_BASE_ADDRESS + ATO_SX_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'.

SX_ASYNC_ED25519_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_ED25519_VERIFY_GO)(struct sx_pk_cnx *cnx, const struct sx_ed25519_dgst *k, const struct sx_ed25519_pt *a, const struct sx_ed25519_v *sig_s, const struct sx_ed25519_pt *r);
#define SX_ASYNC_ED25519_VERIFY_GO         ((FUNC_SX_ASYNC_ED25519_VERIFY_GO)(*(uint32_t *)(API_TABLE_BASE_ADDRESS + ATO_SX_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 SX_PK_RELEASE_REQ()

SX_ED25519_VERIFY()

Acquired acceleration request for this operation