tor  0.4.2.0-alpha-dev
crypto_ed25519.h
Go to the documentation of this file.
1 /* Copyright (c) 2012-2019, The Tor Project, Inc. */
2 /* See LICENSE for licensing information */
3 
9 #ifndef TOR_CRYPTO_ED25519_H
10 #define TOR_CRYPTO_ED25519_H
11 
13 #include "lib/cc/torint.h"
15 #include "lib/defs/x25519_sizes.h"
16 
18 typedef struct ed25519_signature_t {
19  uint8_t sig[ED25519_SIG_LEN];
21 
23 typedef struct ed25519_public_key_t {
24  uint8_t pubkey[ED25519_PUBKEY_LEN];
26 
28 typedef struct ed25519_secret_key_t {
35  uint8_t seckey[ED25519_SECKEY_LEN];
37 
39 typedef struct ed25519_keypair_t {
40  ed25519_public_key_t pubkey;
41  ed25519_secret_key_t seckey;
43 
45  int extra_strong);
47  const uint8_t *seed);
48 
50  const ed25519_secret_key_t *seckey);
51 int ed25519_keypair_generate(ed25519_keypair_t *keypair_out, int extra_strong);
52 int ed25519_sign(ed25519_signature_t *signature_out,
53  const uint8_t *msg, size_t len,
54  const ed25519_keypair_t *key);
55 MOCK_DECL(int,ed25519_checksig,(const ed25519_signature_t *signature,
56  const uint8_t *msg, size_t len,
57  const ed25519_public_key_t *pubkey));
58 
59 MOCK_DECL(int,
60 ed25519_sign_prefixed,(ed25519_signature_t *signature_out,
61  const uint8_t *msg, size_t len,
62  const char *prefix_str,
63  const ed25519_keypair_t *keypair));
64 
65 int
67  const uint8_t *msg, size_t len,
68  const char *prefix_str,
69  const ed25519_public_key_t *pubkey);
70 
72 
77 typedef struct {
83  const uint8_t *msg;
85  size_t len;
87 
88 MOCK_DECL(int, ed25519_checksig_batch,(int *okay_out,
89  const ed25519_checkable_t *checkable,
90  int n_checkable));
91 
93  int *signbit_out,
94  const curve25519_keypair_t *inp);
95 
97  const curve25519_public_key_t *pubkey_in,
98  int signbit);
100  const ed25519_keypair_t *inp,
101  const uint8_t *param);
103  const ed25519_public_key_t *inp,
104  const uint8_t *param);
105 
106 /* XXXX read encrypted, write encrypted. */
107 
109  const char *filename,
110  const char *tag);
112  char **tag_out,
113  const char *filename);
115  const char *filename,
116  const char *tag);
118  char **tag_out,
119  const char *filename);
120 
122 #define ed25519_keypair_free(kp) \
123  FREE_AND_NULL(ed25519_keypair_t, ed25519_keypair_free_, (kp))
124 
126  const ed25519_public_key_t *key2);
128  const ed25519_public_key_t *src);
129 
130 void ed25519_set_impl_params(int use_donna);
131 void ed25519_init(void);
132 
134 
135 #ifdef TOR_UNIT_TESTS
136 void crypto_ed25519_testing_force_impl(const char *name);
137 void crypto_ed25519_testing_restore_impl(void);
138 #endif
139 
140 #ifdef CRYPTO_ED25519_PRIVATE
141 MOCK_DECL(STATIC int, ed25519_impl_spot_check, (void));
142 #endif
143 
144 #endif /* !defined(TOR_CRYPTO_ED25519_H) */
int ed25519_keypair_blind(ed25519_keypair_t *out, const ed25519_keypair_t *inp, const uint8_t *param)
int ed25519_pubkey_eq(const ed25519_public_key_t *key1, const ed25519_public_key_t *key2)
int ed25519_public_key_is_zero(const ed25519_public_key_t *pubkey)
const ed25519_public_key_t * pubkey
void ed25519_keypair_free_(ed25519_keypair_t *kp)
struct ed25519_secret_key_t ed25519_secret_key_t
int ed25519_keypair_generate(ed25519_keypair_t *keypair_out, int extra_strong)
int ed25519_seckey_write_to_file(const ed25519_secret_key_t *seckey, const char *filename, const char *tag)
int ed25519_checksig_prefixed(const ed25519_signature_t *signature, const uint8_t *msg, size_t len, const char *prefix_str, const ed25519_public_key_t *pubkey)
Integer definitions used throughout Tor.
int ed25519_pubkey_write_to_file(const ed25519_public_key_t *pubkey, const char *filename, const char *tag)
int ed25519_secret_key_generate(ed25519_secret_key_t *seckey_out, int extra_strong)
Definitions for sizes of x25519 keys and elements.
struct ed25519_keypair_t ed25519_keypair_t
uint8_t seckey[ED25519_SECKEY_LEN]
int ed25519_pubkey_read_from_file(ed25519_public_key_t *pubkey_out, char **tag_out, const char *filename)
ed25519_signature_t signature
struct ed25519_public_key_t ed25519_public_key_t
int ed25519_sign(ed25519_signature_t *signature_out, const uint8_t *msg, size_t len, const ed25519_keypair_t *key)
int ed25519_secret_key_from_seed(ed25519_secret_key_t *seckey_out, const uint8_t *seed)
int ed25519_seckey_read_from_file(ed25519_secret_key_t *seckey_out, char **tag_out, const char *filename)
void ed25519_pubkey_copy(ed25519_public_key_t *dest, const ed25519_public_key_t *src)
int ed25519_validate_pubkey(const ed25519_public_key_t *pubkey)
int ed25519_public_key_generate(ed25519_public_key_t *pubkey_out, const ed25519_secret_key_t *seckey)
int ed25519_public_blind(ed25519_public_key_t *out, const ed25519_public_key_t *inp, const uint8_t *param)
Macros to implement mocking and selective exposure for the test code.
int ed25519_keypair_from_curve25519_keypair(ed25519_keypair_t *out, int *signbit_out, const curve25519_keypair_t *inp)
#define MOCK_DECL(rv, funcname, arglist)
Definition: testsupport.h:94
void ed25519_set_impl_params(int use_donna)
struct ed25519_signature_t ed25519_signature_t
Header for crypto_curve25519.c.
const uint8_t * msg
int ed25519_public_key_from_curve25519_public_key(ed25519_public_key_t *pubkey, const curve25519_public_key_t *pubkey_in, int signbit)