Usage

Add as a package in the Makefile of your application:

USEPKG += libcose

The main consumers of libcose are other libraries or system components, for example SUIT.

The use of the library itself is described in the libcose documentation, and some example code can be found in tests/pkg_libcose/.

Backends

The libcose library does not implement cryptographic algorithms itself, but fans that out to other libraries (which are pulled into the dependency tree as packages) and exposes a consistent interface for the operations they provide.

Backends are selected by any of those pseudomodules:

USEMODULE += libcose_crypt_hacl
USEMODULE += libcose_crypt_monocypher
USEMODULE += libcose_crypt_c25519

The selection of pseudomodules determines the available algorithms:

HACL and Monocypher both provide ChaCha20-Poly1305 and Ed25519.
C25519 only provides the Ed25519 algorithm.