EDDSA\_PK\_NEW(3) Library Functions Manual EDDSA\_PK\_NEW(3)

# [NAME](#NAME)

`eddsa_pk_new`, `eddsa_pk_free`, `eddsa_pk_from_EVP_PKEY`, `eddsa_pk_from_ptr`, `eddsa_pk_to_EVP_PKEY` — FIDO2 COSE EDDSA API

# [SYNOPSIS](#SYNOPSIS)

`#include <openssl/evp.h>`  
`#include <fido/eddsa.h>`

`eddsa_pk_t *`  
`eddsa_pk_new`(`void`);

`void`  
`eddsa_pk_free`(`eddsa_pk_t **pkp`);

`int`  
`eddsa_pk_from_EVP_PKEY`(`eddsa_pk_t *pk`, `const EVP_PKEY *pkey`);

`int`  
`eddsa_pk_from_ptr`(`eddsa_pk_t *pk`, `const void *ptr`, `size_t len`);

`EVP_PKEY *`  
`eddsa_pk_to_EVP_PKEY`(`const eddsa_pk_t *pk`);

# [DESCRIPTION](#DESCRIPTION)

EDDSA is the name given in the CBOR Object Signing and Encryption (COSE) RFC to EDDSA over Curve25519 with SHA-512. The COSE EDDSA API of *libfido2* is an auxiliary API with routines to convert between the different EDDSA public key types used in *libfido2* and [*OpenSSL*](#OpenSSL).

In *libfido2*, EDDSA public keys are abstracted by the `eddsa_pk_t` type.

The [`eddsa_pk_new`](#eddsa_pk_new)() function returns a pointer to a newly allocated, empty `eddsa_pk_t` type. If memory cannot be allocated, NULL is returned.

The [`eddsa_pk_free`](#eddsa_pk_free)() function releases the memory backing `*pkp`, where `*pkp` must have been previously allocated by `eddsa_pk_new`(). On return, `*pkp` is set to NULL. Either `pkp` or `*pkp` may be NULL, in which case `eddsa_pk_free`() is a NOP.

The [`eddsa_pk_from_EVP_PKEY`](#eddsa_pk_from_EVP_PKEY)() function fills `pk` with the contents of `pkey`. No references to `pkey` are kept.

The [`eddsa_pk_from_ptr`](#eddsa_pk_from_ptr)() function fills `pk` with the contents of `ptr`, where `ptr` points to `len` bytes. No references to `ptr` are kept.

The [`eddsa_pk_to_EVP_PKEY`](#eddsa_pk_to_EVP_PKEY)() function converts `pk` to a newly allocated `EVP_PKEY` type with a reference count of 1. No internal references to the returned pointer are kept. If an error occurs, `eddsa_pk_to_EVP_PKEY`() returns NULL.

# [RETURN VALUES](#RETURN_VALUES)

The `eddsa_pk_from_EVP_PKEY`() and `eddsa_pk_from_ptr`() functions return `FIDO_OK` on success. On error, a different error code defined in `<fido/err.h>` is returned.

# [SEE ALSO](#SEE_ALSO)

[es256\_pk\_new(3)](/man/os/libfido2/es256_pk_new.3), [es384\_pk\_new(3)](/man/os/libfido2/es384_pk_new.3), [fido\_assert\_verify(3)](/man/os/libfido2/fido_assert_verify.3), [fido\_cred\_pubkey\_ptr(3)](/man/os/libfido2/fido_cred_pubkey_ptr.3), [rs256\_pk\_new(3)](/man/os/libfido2/rs256_pk_new.3)

July 15, 2022 Linux 4.19.0-gvisor

---

Document: eddsa_pk_from_ptr(3) from libfido2 1.17.0-r5 (Chainguard OS)
Source: https://github.com/Yubico/libfido2