hemlock_lib 0.1.0

A secret-sharing service
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

#ifndef C_API
#define C_API

#include <stdint.h>

// MARK: Cryptographic Constants

const int ENCRYPTED_SECRET_KEY_LEN;
const int PUBLIC_KEY_LEN;
const int SECRET_KEY_LEN;
const int SPECK_KEY_LEN;
const int SHA512_DIGEST_LEN;

const int SHARE_LEN;
const int SECRET_LEN;

// MARK: Error Codes

const int SUCCESS;
const int EMAIL_TAKEN;
const int CONNECTION_ERROR;
const int DATA_ERROR;
const int USER_DOES_NOT_EXIST;
const int EMAIL_DOES_NOT_EXIST;

typedef struct {
	const char *file_owner_email;
	uint64_t share_owner_id;
	uint64_t file_owner_id;
	uint64_t file_id;
	const uint8_t *share;
	const uint8_t *group_key;
} CPlaintextShare;

int capi_hash_bytes(const uint8_t *pt, int pt_len, uint8_t *digest);
int capi_hash_str(const char *pt, uint8_t *digest);
uint8_t *capi_enc(const uint8_t *pt, int pt_len, const uint8_t *key, int *ct_len);
uint8_t *capi_dec(const uint8_t *ct, int ct_len, const uint8_t *key, int *pt_len);

// MARK: Asynchronicity 

void *capi_create_runtime();
int capi_test_async(void *rt, void (*callback)(int));
void capi_destroy_runtime(void *rt);

// MARK: Users

void capi_create_user(const void *rt, const char* email_ptr, void (*callback)(int, unsigned long long, uint8_t *));
void capi_download_user(
	const void *rt, 
	uint64_t user_id, 
	void (*callback)(
		int,
		uint64_t,
		const char *,
		const uint8_t *,
		const uint8_t *,
		const uint8_t *
	)
);
void capi_download_user_email(
	const void *rt, 
	const char* email, 
	void (*callback)(
		int,
		uint64_t,
		const char *,
		const uint8_t *,
		const uint8_t *,
		const uint8_t *
	)
);
void capi_process_inbox(
	const void *rt,
	uint64_t share_owner,
	uint8_t *master_key_pointer,
	void (*completion)(int)
);
void capi_download_shares(
	const void *rt, 
	uint64_t share_owner, 
	uint8_t *master_key_pointer,
	void (*completion)(
		int,
		int,
		CPlaintextShare *
	)
);

#endif