beaconcrypt 0.4.2

Cryptographic transport for C2 channels
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149

#ifndef _BEACON_CRYPT_H_
#define _BEACON_CRYPT_H_

/* Generated with cbindgen:0.29.4 */

// Do not modify manually.

#include <stdarg.h>
#include <stdbool.h>
#include <stdint.h>
#include <stdlib.h>

#define beaconcrypt_KEX_KDF_OUT_LEN 32

#define beaconcrypt_KDF_STATE_SIZE 32

/**
 * crypto_aead::chacha20poly1305_ietf::KEYBYTES
 */
#define beaconcrypt_AEAD_KEY_LEN 32

/**
 * crypto_aead::chacha20poly1305_ietf::NPUBBYTES
 */
#define beaconcrypt_AEAD_NONCE_LEN 12

/**
 * crypto_aead::chacha20poly1305_ietf::ABYTES
 */
#define beaconcrypt_AEAD_TAG_LEN 16

#define beaconcrypt_KDF_RATCHET_OUTPUT_LEN ((beaconcrypt_AEAD_KEY_LEN + beaconcrypt_KDF_STATE_SIZE) + beaconcrypt_AEAD_NONCE_LEN)

/**
 * crypto_scalarmult::BYTES
 */
#define beaconcrypt_DH_OUT_LEN 32

#define beaconcrypt_RATCHET_MAX_GAP 50

#define beaconcrypt_ED25519_SEED_SIZE 32

#define beaconcrypt_COMMITMENT_SIZE 64

#define beaconcrypt_MESSAGE_OVERHEAD (beaconcrypt_COMMITMENT_SIZE + beaconcrypt_AEAD_TAG_LEN)

typedef struct beaconcrypt_BeaconCryptPqxdh beaconcrypt_BeaconCryptPqxdh;

typedef struct beaconcrypt_Buffer {
  uint8_t *ptr;
  uintptr_t len;
  uintptr_t cap;
} beaconcrypt_Buffer;

typedef struct beaconcrypt_RegistrationResponse {
  struct beaconcrypt_Buffer response;
  uint64_t key_id;
} beaconcrypt_RegistrationResponse;

typedef struct beaconcrypt_EncryptState {
  struct beaconcrypt_Buffer data;
  /**
   * Complete RatchetManager serialized as JSON.
   */
  struct beaconcrypt_Buffer state;
  uint64_t key_id;
  uint64_t seq;
} beaconcrypt_EncryptState;

#ifdef __cplusplus
extern "C" {
#endif // __cplusplus

void beaconcrypt_free_buffer(struct beaconcrypt_Buffer buffer);

struct beaconcrypt_BeaconCryptPqxdh *beaconcrypt_server_new(uint64_t server_kid);

struct beaconcrypt_BeaconCryptPqxdh *beaconcrypt_server_new_from_seed(uint64_t server_kid,
                                                                      const uint8_t *seed_ptr,
                                                                      uintptr_t seed_len);

struct beaconcrypt_BeaconCryptPqxdh *beaconcrypt_server_new_from_state(uint64_t server_kid,
                                                                       const uint8_t *seed_ptr,
                                                                       uintptr_t seed_len,
                                                                       const uint8_t *state_ptr,
                                                                       uintptr_t state_len);

struct beaconcrypt_BeaconCryptPqxdh *beaconcrypt_beacon_new(uint64_t server_kid,
                                                            const uint8_t *server_pk_ptr,
                                                            uintptr_t server_pk_len);

void beaconcrypt_free(struct beaconcrypt_BeaconCryptPqxdh *handle);

struct beaconcrypt_Buffer beaconcrypt_identity_pk(const struct beaconcrypt_BeaconCryptPqxdh *handle);

struct beaconcrypt_Buffer beaconcrypt_generate_registration(struct beaconcrypt_BeaconCryptPqxdh *handle);

struct beaconcrypt_RegistrationResponse beaconcrypt_register_beacon(struct beaconcrypt_BeaconCryptPqxdh *handle,
                                                                    const uint8_t *reg_ptr,
                                                                    uintptr_t reg_len,
                                                                    const uint8_t *msg_ptr,
                                                                    uintptr_t msg_len);

struct beaconcrypt_Buffer beaconcrypt_process_initial_message(struct beaconcrypt_BeaconCryptPqxdh *handle,
                                                              const uint8_t *ptr,
                                                              uintptr_t len);

struct beaconcrypt_Buffer beaconcrypt_encrypt_to_beacon(struct beaconcrypt_BeaconCryptPqxdh *handle,
                                                        uint64_t key_id,
                                                        const uint8_t *ptr,
                                                        uintptr_t len);

struct beaconcrypt_Buffer beaconcrypt_decrypt_beacon_message(struct beaconcrypt_BeaconCryptPqxdh *handle,
                                                             const uint8_t *ptr,
                                                             uintptr_t len);

struct beaconcrypt_EncryptState beaconcrypt_encrypt_and_update(struct beaconcrypt_BeaconCryptPqxdh *handle,
                                                               uint64_t key_id,
                                                               const uint8_t *ptr,
                                                               uintptr_t len);

struct beaconcrypt_Buffer beaconcrypt_encrypt_and_update_json(struct beaconcrypt_BeaconCryptPqxdh *handle,
                                                              uint64_t key_id,
                                                              const uint8_t *ptr,
                                                              uintptr_t len);

struct beaconcrypt_EncryptState beaconcrypt_decrypt_and_update(struct beaconcrypt_BeaconCryptPqxdh *handle,
                                                               const uint8_t *ptr,
                                                               uintptr_t len);

struct beaconcrypt_Buffer beaconcrypt_decrypt_and_update_json(struct beaconcrypt_BeaconCryptPqxdh *handle,
                                                              const uint8_t *ptr,
                                                              uintptr_t len);

struct beaconcrypt_Buffer beaconcrypt_export_state(const struct beaconcrypt_BeaconCryptPqxdh *handle);

struct beaconcrypt_Buffer beaconcrypt_encrypt_to_server(struct beaconcrypt_BeaconCryptPqxdh *handle,
                                                        const uint8_t *ptr,
                                                        uintptr_t len);

struct beaconcrypt_Buffer beaconcrypt_decrypt_server_message(struct beaconcrypt_BeaconCryptPqxdh *handle,
                                                             const uint8_t *ptr,
                                                             uintptr_t len);

#ifdef __cplusplus
}  // extern "C"
#endif  // __cplusplus

#endif  /* _BEACON_CRYPT_H_ */