aboutsummaryrefslogtreecommitdiffstats
path: root/serve/seal.h
diff options
context:
space:
mode:
Diffstat (limited to 'serve/seal.h')
-rw-r--r--serve/seal.h80
1 files changed, 0 insertions, 80 deletions
diff --git a/serve/seal.h b/serve/seal.h
deleted file mode 100644
index 18e3e5f..0000000
--- a/serve/seal.h
+++ /dev/null
@@ -1,80 +0,0 @@
-#ifndef PURE_SEAL_H
-#define PURE_SEAL_H
-#include <stdbool.h>
-#include <stddef.h>
-#include <stdint.h>
-
-/* Sends sealed end to end (docs/research/086-sealed-sends.md, 088): a
- * receiving node's key opens what a sender sealed to its public key, and
- * nothing between them (a relay, a proxy, a mailbox) can read or change it.
- * HPKE (RFC 9180): X25519, HKDF-SHA256, and AES-128-GCM where the CPU has AES
- * instructions, else ChaCha20-Poly1305; auth mode when the sender has a key
- * of its own, so the receiver knows who sealed. A sender keeps one session
- * (one encapsulation) and numbers its seals in it; a receiver opens a
- * session once and then each seal by its number. A private key lives in
- * OpenSSL's secure heap: locked in memory, out of core dumps, cleared when
- * freed. OpenSSL comes with pure-crypto.so (serve/crypto.c), mapped the
- * first time a key is read or a session made. */
-enum { PURE_SEAL_KEY = 32, PURE_SEAL_OVERHEAD = 16 }; /* a public key; a seal's tag */
-
-typedef struct PureSealKey PureSealKey;
-typedef struct PureSealer PureSealer; /* a sender's session */
-typedef struct PureOpener PureOpener; /* a receiver's session */
-
-/* Whether this machine can seal (pure-crypto.so maps), with why not in error. */
-bool pure_seal_ready(char *error, size_t size);
-/* A node's key: read from path, or made and written there (0600) when there
- * is none; its public half in hex. NULL with why in error. */
-PureSealKey *pure_seal_key(const char *path, char public_hex[2 * PURE_SEAL_KEY + 1], char *error, size_t size);
-void pure_seal_key_free(PureSealKey *);
-/* A public key from its hex. */
-bool pure_seal_peer(const char *hex, unsigned char out[PURE_SEAL_KEY]);
-/* The suite this machine seals with, as the X-Pure-Seal header names it. */
-const char *pure_seal_suite(void);
-
-/* A session sealing to peer, authenticated by own when given: its
- * encapsulated key into enc (what a receiver opens the session with). */
-PureSealer *pure_sealer(const unsigned char peer[PURE_SEAL_KEY], const PureSealKey *own,
- unsigned char enc[PURE_SEAL_KEY]);
-/* plain sealed as the session's next seal, bound to aad: size +
- * PURE_SEAL_OVERHEAD bytes into out, and its number into n. */
-bool pure_seal(PureSealer *, const char *aad, const unsigned char *plain, size_t size, unsigned char *out,
- uint64_t *n);
-void pure_sealer_free(PureSealer *);
-
-/* A session a sender made to key's public half, in suite (this machine's or
- * the other known one), from its enc; from is the sender's public key when
- * it sealed with its own (NULL otherwise). NULL when it does not open. */
-PureOpener *pure_opener(const PureSealKey *key, const char *suite, const unsigned char enc[PURE_SEAL_KEY],
- const unsigned char *from);
-/* The session's seal number n: size - PURE_SEAL_OVERHEAD bytes into plain;
- * false when it does not open (another session, another aad, or changed on
- * the way). */
-bool pure_unseal(PureOpener *, uint64_t n, const char *aad, const unsigned char *sealed, size_t size,
- unsigned char *plain);
-void pure_opener_free(PureOpener *);
-
-/* Links (serve/link.h): the secret two nodes share (X25519 of this node's
- * private key and the other's public key: the same on both sides, and
- * never all zeros), keys from it (HKDF-SHA256 with the info given), and
- * AES-128-GCM under such a key with the nonce the caller gives (sealing may
- * be in place: out may be plain). A context is used by one thread at a time;
- * sealing or opening with a key given uses that key from then on, so one
- * context serves many links (a key costs about as much as a small packet),
- * and NULL keeps the key it has. */
-typedef struct PureAead PureAead;
-enum { PURE_AEAD_KEY = 16, PURE_AEAD_NONCE = 12, PURE_AEAD_TAG = 16 };
-bool pure_link_secret(const PureSealKey *own, const unsigned char peer[PURE_SEAL_KEY], unsigned char out[32]);
-bool pure_link_derive(const unsigned char secret[32], const unsigned char *info, size_t info_size, unsigned char *out,
- size_t out_size);
-PureAead *pure_aead(const unsigned char key[PURE_AEAD_KEY]);
-/* size + PURE_AEAD_TAG bytes into out. */
-bool pure_aead_seal(PureAead *, const unsigned char *key, const unsigned char nonce[PURE_AEAD_NONCE],
- const unsigned char *aad, size_t aad_size, const unsigned char *plain, size_t size,
- unsigned char *out);
-/* size - PURE_AEAD_TAG bytes into plain; false when it does not open. */
-bool pure_aead_open(PureAead *, const unsigned char *key, const unsigned char nonce[PURE_AEAD_NONCE],
- const unsigned char *aad, size_t aad_size, const unsigned char *sealed, size_t size,
- unsigned char *plain);
-void pure_aead_free(PureAead *);
-#endif