2 This file is part of GNUnet.
3 Copyright (C) 2013 GNUnet e.V.
5 GNUnet is free software: you can redistribute it and/or modify it
6 under the terms of the GNU Affero General Public License as published
7 by the Free Software Foundation, either version 3 of the License,
8 or (at your option) any later version.
10 GNUnet is distributed in the hope that it will be useful, but
11 WITHOUT ANY WARRANTY; without even the implied warranty of
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 Affero General Public License for more details.
17 * @author Florian Dold
18 * @file secretsharing/secretsharing.h
19 * @brief messages used for the secretsharing api
21 #ifndef SECRETSHARING_H
22 #define SECRETSHARING_H
25 #include "gnunet_util_lib.h"
26 #include "gnunet_time_lib.h"
27 #include "gnunet_common.h"
28 #include "gnunet_secretsharing_service.h"
31 GNUNET_NETWORK_STRUCT_BEGIN
33 struct GNUNET_SECRETSHARING_FieldElement
36 * Value of an element in <elgamal_g>.
38 unsigned char bits[GNUNET_SECRETSHARING_ELGAMAL_BITS / 8];
42 struct GNUNET_SECRETSHARING_CreateMessage
45 * Type: GNUNET_MESSAGE_TYPE_SECRETSHARING_CLIENT_GENERATE
47 struct GNUNET_MessageHeader header;
50 * Session ID, will be used for consensus.
52 struct GNUNET_HashCode session_id GNUNET_PACKED;
55 * Start time for communication with the other peers.
57 struct GNUNET_TIME_AbsoluteNBO start;
60 * Deadline for the establishment of the crypto system.
62 struct GNUNET_TIME_AbsoluteNBO deadline;
65 * Mininum number of cooperating peers to decrypt a
68 uint16_t threshold GNUNET_PACKED;
71 * Number of peers at the end of this message.
73 uint16_t num_peers GNUNET_PACKED;
75 /* struct GNUNET_PeerIdentity[num_peers]; */
80 struct GNUNET_SECRETSHARING_ShareHeaderNBO
83 * Threshold for the key this share belongs to.
88 * Peers that have the share.
93 * Index of our peer in the list.
98 * Public key. Must correspond to the product of
99 * the homomorphic share commitments.
101 struct GNUNET_SECRETSHARING_PublicKey public_key;
106 struct GNUNET_SECRETSHARING_FieldElement my_share;
111 * Notify the client that then threshold secret has been
114 struct GNUNET_SECRETSHARING_SecretReadyMessage
117 * Type: GNUNET_MESSAGE_TYPE_SECRETSHARING_CLIENT_SECRET_READY
119 struct GNUNET_MessageHeader header;
121 /* rest: the serialized share */
126 struct GNUNET_SECRETSHARING_DecryptRequestMessage
129 * Type: GNUNET_MESSAGE_TYPE_SECRETSHARING_CLIENT_DECRYPT_REQUEST
131 struct GNUNET_MessageHeader header;
134 * Until when should the decryption start?
136 struct GNUNET_TIME_AbsoluteNBO start;
139 * Until when should the decryption be finished?
141 struct GNUNET_TIME_AbsoluteNBO deadline;
144 * Ciphertext we want to decrypt.
146 struct GNUNET_SECRETSHARING_Ciphertext ciphertext;
148 /* the share with payload */
152 struct GNUNET_SECRETSHARING_DecryptResponseMessage
155 * Type: #GNUNET_MESSAGE_TYPE_SECRETSHARING_CLIENT_DECRYPT_DONE
157 struct GNUNET_MessageHeader header;
160 * Zero if decryption failed, non-zero if decryption succeeded.
161 * If the decryption failed, plaintext is also zero.
163 uint32_t success GNUNET_PACKED;
166 * Decrypted plaintext.
168 struct GNUNET_SECRETSHARING_FieldElement plaintext;
172 GNUNET_NETWORK_STRUCT_END
176 * A share, with all values in in host byte order.
178 struct GNUNET_SECRETSHARING_Share
181 * Threshold for the key this share belongs to.
186 * Peers that have the share.
191 * Index of our peer in the list.
196 * Public key. Computed from the
197 * exponentiated coefficients.
199 struct GNUNET_SECRETSHARING_PublicKey public_key;
204 struct GNUNET_SECRETSHARING_FieldElement my_share;
207 * Peer identities (includes 'my_peer')
209 struct GNUNET_PeerIdentity *peers;
212 * For each peer, store elgamal_g to the peer's
215 struct GNUNET_SECRETSHARING_FieldElement *sigmas;
218 * Original indices of peers from the DKG round.
220 uint16_t *original_indices;