aboutsummaryrefslogtreecommitdiff
path: root/src/hkdf.h
blob: 50ee6e899110b60f4ba7496a516fa7b8610a0fb6 (plain)
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
/*
* Copyright (c) 2024 Vaughn Nugent
*
* Package: noscrypt
* File: hkdf.h
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public License
* as published by the Free Software Foundation; either version 2.1
* of the License, or  (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with noscrypt. If not, see http://www.gnu.org/licenses/.
*/

#pragma once

#ifndef _NC_HKDF_H
#define _NC_HKDF_H

#include "nc-util.h"
#include "nc-crypto.h"

/*
* IMPORTANT:
*	The HKDF_IN_BUF_SIZE defintion sets the internal stack buffer size to use
*	during fallback HKDF_Expand operations.
*
*	128 bytes should be more than enough for most use cases, without going 
*	overboard. Could be dialed in better for specific use cases later.
*/

#ifndef HKDF_IN_BUF_SIZE
	#define HKDF_IN_BUF_SIZE	0x80	
#endif


/* typedefs for hdkf callback functions */

typedef cstatus_t (*hmac_hash_fn)(void* ctx, cspan_t data);
typedef cstatus_t (*hmac_finish_fn)(void* ctx, sha256_t hmacOut32);

struct nc_hkdf_fn_cb_struct
{
	hmac_hash_fn update;
	hmac_finish_fn finish;
};

cstatus_t hkdfExpandProcess(
	const struct nc_hkdf_fn_cb_struct* handler,
	void* ctx,
	cspan_t info,
	span_t okm
);

#endif /* !_NC_HKDF_H */