1 /*        $NetBSD: sshkey-xmss.h,v 1.5 2023/07/26 17:58:16 christos Exp $       */
2 /* $OpenBSD: sshkey-xmss.h,v 1.4 2022/10/28 00:39:29 djm Exp $ */
3 /*
4  * Copyright (c) 2017 Markus Friedl.  All rights reserved.
5  *
6  * Redistribution and use in source and binary forms, with or without
7  * modification, are permitted provided that the following conditions
8  * are met:
9  * 1. Redistributions of source code must retain the above copyright
10  *    notice, this list of conditions and the following disclaimer.
11  * 2. Redistributions in binary form must reproduce the above copyright
12  *    notice, this list of conditions and the following disclaimer in the
13  *    documentation and/or other materials provided with the distribution.
14  *
15  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
16  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
17  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
18  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
19  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
20  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
21  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
22  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
23  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
24  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
25  */
26 #ifndef SSHKEY_XMSS_H
27 #define SSHKEY_XMSS_H
28 
29 #define XMSS_SHA2_256_W16_H10_NAME      "XMSS_SHA2-256_W16_H10"
30 #define XMSS_SHA2_256_W16_H16_NAME      "XMSS_SHA2-256_W16_H16"
31 #define XMSS_SHA2_256_W16_H20_NAME      "XMSS_SHA2-256_W16_H20"
32 #define XMSS_DEFAULT_NAME               XMSS_SHA2_256_W16_H10_NAME
33 
34 size_t     sshkey_xmss_pklen(const struct sshkey *);
35 size_t     sshkey_xmss_sklen(const struct sshkey *);
36 int        sshkey_xmss_init(struct sshkey *, const char *);
37 void       sshkey_xmss_free_state(struct sshkey *);
38 int        sshkey_xmss_generate_private_key(struct sshkey *, int);
39 int        sshkey_xmss_serialize_state(const struct sshkey *, struct sshbuf *);
40 int        sshkey_xmss_serialize_state_opt(const struct sshkey *, struct sshbuf *,
41               enum sshkey_serialize_rep);
42 int        sshkey_xmss_serialize_pk_info(const struct sshkey *, struct sshbuf *,
43               enum sshkey_serialize_rep);
44 int        sshkey_xmss_deserialize_state(struct sshkey *, struct sshbuf *);
45 int        sshkey_xmss_deserialize_state_opt(struct sshkey *, struct sshbuf *);
46 int        sshkey_xmss_deserialize_pk_info(struct sshkey *, struct sshbuf *);
47 
48 int        sshkey_xmss_siglen(const struct sshkey *, size_t *);
49 void      *sshkey_xmss_params(const struct sshkey *);
50 void      *sshkey_xmss_bds_state(const struct sshkey *);
51 int        sshkey_xmss_get_state(const struct sshkey *, int);
52 int        sshkey_xmss_enable_maxsign(struct sshkey *, u_int32_t);
53 int        sshkey_xmss_forward_state(const struct sshkey *, u_int32_t);
54 int        sshkey_xmss_update_state(const struct sshkey *, int);
55 u_int32_t sshkey_xmss_signatures_left(const struct sshkey *);
56 
57 #endif /* SSHKEY_XMSS_H */
58