xref: /openssh-portable/xmss_wots.h (revision 3b36bed3)
1 #ifdef WITH_XMSS
2 /* $OpenBSD: xmss_wots.h,v 1.3 2018/02/26 12:14:53 dtucker Exp $ */
3 /*
4 wots.h version 20160722
5 Andreas Hülsing
6 Joost Rijneveld
7 Public domain.
8 */
9 
10 #ifndef WOTS_H
11 #define WOTS_H
12 
13 #ifdef HAVE_STDINT_H
14 #include "stdint.h"
15 #endif
16 
17 /**
18  * WOTS parameter set
19  *
20  * Meaning as defined in draft-irtf-cfrg-xmss-hash-based-signatures-02
21  */
22 typedef struct {
23   uint32_t len_1;
24   uint32_t len_2;
25   uint32_t len;
26   uint32_t n;
27   uint32_t w;
28   uint32_t log_w;
29   uint32_t keysize;
30 } wots_params;
31 
32 /**
33  * Set the WOTS parameters,
34  * only m, n, w are required as inputs,
35  * len, len_1, and len_2 are computed from those.
36  *
37  * Assumes w is a power of 2
38  */
39 void wots_set_params(wots_params *params, int n, int w);
40 
41 /**
42  * WOTS key generation. Takes a 32byte seed for the secret key, expands it to a full WOTS secret key and computes the corresponding public key.
43  * For this it takes the seed pub_seed which is used to generate bitmasks and hash keys and the address of this WOTS key pair addr
44  *
45  * params, must have been initialized before using wots_set params for params ! This is not done in this function
46  *
47  * Places the computed public key at address pk.
48  */
49 void wots_pkgen(unsigned char *pk, const unsigned char *sk, const wots_params *params, const unsigned char *pub_seed, uint32_t addr[8]);
50 
51 /**
52  * Takes a m-byte message and the 32-byte seed for the secret key to compute a signature that is placed at "sig".
53  *
54  */
55 int wots_sign(unsigned char *sig, const unsigned char *msg, const unsigned char *sk, const wots_params *params, const unsigned char *pub_seed, uint32_t addr[8]);
56 
57 /**
58  * Takes a WOTS signature, a m-byte message and computes a WOTS public key that it places at pk.
59  *
60  */
61 int wots_pkFromSig(unsigned char *pk, const unsigned char *sig, const unsigned char *msg, const wots_params *params, const unsigned char *pub_seed, uint32_t addr[8]);
62 
63 #endif
64 #endif /* WITH_XMSS */
65