oqs-sys 0.11.0+liboqs-0.13.0

Bindings to liboqs
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

// SPDX-License-Identifier: MIT
#if !defined( LM_OTS_H_ )
#define LM_OTS_H_

#include "common_defs.h"
#include <stddef.h>
#include "lms_namespace.h"

/*
 * These are routines that implement the OTS signature scheme.  These routines
 * never actually form a "private key"; instead, the signer passes the 'seed'
 * (and public data) to form the public key and to do the actual signature.
 * We do this because the LM routines are actually better suited for doing
 * seed management.
 */
struct seed_derive;

/*
 * Compute the public key.  Note that it doesn't compute a 'private key';
 * the signature algorithm gets that data when we pass the parameters again
 * Parameters:
 * lm_ots_type - The parameter set
 * I - The I public identifier to use
 * q - The diversification string, passed as a 4 byte integer
 * seed - The structure used to generate seeds
 * public_key - Where to place the public key
 * public_key_len - The length of the above buffer
 * This returns true on success
 */
bool lm_ots_generate_public_key(
    param_set_t lm_ots_type,
    const unsigned char *I, /* Public key identifier */
    merkle_index_t q,       /* Diversification string, 4 bytes value */
    struct seed_derive *seed,
    unsigned char *public_key, size_t public_key_len);

/*
 * Sign a message.  Warning: the caller is expected to make sure that it signs
 * only one message with a given seed/I/q set
 * Parameters:
 * lm_ots_type - The parameter set
 * I - The I public identifier to use
 * q - The diversification string, passed as a 4 byte integer
 * seed - The structure used to generate seeds
 * message - Message to sign
 * message_len - Length of the message
 * prehashed - Set if the message hashing has already taken place
 * signature - Where to place the signature
 * signature_len - The length of the above buffer
 * This returns true on success
 */
bool lm_ots_generate_signature(
    param_set_t lm_ots_type,
    const unsigned char *I,
    merkle_index_t q,
    struct seed_derive *seed,
    const void *message, size_t message_len, bool prehashed,
    unsigned char *signature, size_t signature_len);

/* The include file for the verification routine */
#include "lm_ots_verify.h"

/* The include file for the common access routines */
#include "lm_ots_common.h"

#endif /* LM_OTS_H_ */