2 This file is part of GNUnet
3 Copyright (C) 2017 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.
15 You should have received a copy of the GNU Affero General Public License
16 along with this program. If not, see <http://www.gnu.org/licenses/>.
18 SPDX-License-Identifier: AGPL3.0-or-later
22 * @file block/plugin_block_revocation.c
23 * @brief revocation for a block plugin
24 * @author Christian Grothoff
28 #include "gnunet_signatures.h"
29 #include "gnunet_block_plugin.h"
30 #include "gnunet_block_group_lib.h"
31 #include "revocation.h"
32 #include "gnunet_revocation_service.h"
34 #define DEBUG_REVOCATION GNUNET_EXTRA_LOGGING
37 * Number of bits we set per entry in the bloomfilter.
40 #define BLOOMFILTER_K 16
44 * How big is the BF we use for DHT blocks?
46 #define REVOCATION_BF_SIZE 8
50 * Context used inside the plugin.
52 struct InternalContext
54 unsigned int matching_bits;
55 struct GNUNET_TIME_Relative epoch_duration;
60 * Create a new block group.
62 * @param ctx block context in which the block group is created
63 * @param type type of the block for which we are creating the group
64 * @param nonce random value used to seed the group creation
65 * @param raw_data optional serialized prior state of the group, NULL if unavailable/fresh
66 * @param raw_data_size number of bytes in @a raw_data, 0 if unavailable/fresh
67 * @param va variable arguments specific to @a type
68 * @return block group handle, NULL if block groups are not supported
69 * by this @a type of block (this is not an error)
71 static struct GNUNET_BLOCK_Group *
72 block_plugin_revocation_create_group (void *cls,
73 enum GNUNET_BLOCK_Type type,
82 guard = va_arg (va, const char *);
83 if (0 == strcmp (guard,
85 bf_size = GNUNET_BLOCK_GROUP_compute_bloomfilter_size (va_arg (va, unsigned
88 else if (0 == strcmp (guard,
90 bf_size = va_arg (va, unsigned int);
94 bf_size = REVOCATION_BF_SIZE;
96 GNUNET_break (NULL == va_arg (va, const char *));
97 return GNUNET_BLOCK_GROUP_bf_create (cls,
108 * Function called to validate a reply or a request. For
109 * request evaluation, simply pass "NULL" for the reply_block.
111 * @param cls our `struct InternalContext`
113 * @param type block type
114 * @param group block group to use
115 * @param eo control flags
116 * @param query original query (hash)
117 * @param xquery extrended query data (can be NULL, depending on type)
118 * @param xquery_size number of bytes in xquery
119 * @param reply_block response to validate
120 * @param reply_block_size number of bytes in reply block
121 * @return characterization of result
123 static enum GNUNET_BLOCK_EvaluationResult
124 block_plugin_revocation_evaluate (void *cls,
125 struct GNUNET_BLOCK_Context *ctx,
126 enum GNUNET_BLOCK_Type type,
127 struct GNUNET_BLOCK_Group *group,
128 enum GNUNET_BLOCK_EvaluationOptions eo,
129 const struct GNUNET_HashCode *query,
132 const void *reply_block,
133 size_t reply_block_size)
135 struct InternalContext *ic = cls;
136 struct GNUNET_HashCode chash;
137 const struct RevokeMessage *rm = reply_block;
139 if (NULL == reply_block)
140 return GNUNET_BLOCK_EVALUATION_REQUEST_VALID;
141 if (reply_block_size != sizeof(*rm))
144 return GNUNET_BLOCK_EVALUATION_RESULT_INVALID;
147 GNUNET_REVOCATION_check_pow (&rm->proof_of_work,
152 return GNUNET_BLOCK_EVALUATION_RESULT_INVALID;
154 GNUNET_CRYPTO_hash (&rm->proof_of_work.key,
155 sizeof(struct GNUNET_CRYPTO_EcdsaPublicKey),
158 GNUNET_BLOCK_GROUP_bf_test_and_set (group,
160 return GNUNET_BLOCK_EVALUATION_OK_DUPLICATE;
161 return GNUNET_BLOCK_EVALUATION_TYPE_NOT_SUPPORTED;
166 * Function called to obtain the key for a block.
169 * @param type block type
170 * @param block block to get the key for
171 * @param block_size number of bytes in block
172 * @param key set to the key (query) for the given block
173 * @return #GNUNET_OK on success, #GNUNET_SYSERR if type not supported
174 * (or if extracting a key from a block of this type does not work)
177 block_plugin_revocation_get_key (void *cls,
178 enum GNUNET_BLOCK_Type type,
181 struct GNUNET_HashCode *key)
183 const struct RevokeMessage *rm = block;
185 if (block_size != sizeof(*rm))
188 return GNUNET_SYSERR;
190 GNUNET_CRYPTO_hash (&rm->proof_of_work.key,
191 sizeof(struct GNUNET_CRYPTO_EcdsaPublicKey),
198 * Entry point for the plugin.
200 * @param cls the configuration to use
203 libgnunet_plugin_block_revocation_init (void *cls)
205 static enum GNUNET_BLOCK_Type types[] = {
206 GNUNET_BLOCK_TYPE_REVOCATION,
207 GNUNET_BLOCK_TYPE_ANY /* end of list */
209 const struct GNUNET_CONFIGURATION_Handle *cfg = cls;
210 struct GNUNET_BLOCK_PluginFunctions *api;
211 struct InternalContext *ic;
212 unsigned long long matching_bits;
213 struct GNUNET_TIME_Relative epoch_duration;
216 GNUNET_CONFIGURATION_get_value_number (cfg,
222 GNUNET_CONFIGURATION_get_value_time (cfg,
228 api = GNUNET_new (struct GNUNET_BLOCK_PluginFunctions);
229 api->evaluate = &block_plugin_revocation_evaluate;
230 api->get_key = &block_plugin_revocation_get_key;
231 api->create_group = &block_plugin_revocation_create_group;
233 ic = GNUNET_new (struct InternalContext);
234 ic->matching_bits = (unsigned int) matching_bits;
235 ic->epoch_duration = epoch_duration;
242 * Exit point from the plugin.
245 libgnunet_plugin_block_revocation_done (void *cls)
247 struct GNUNET_BLOCK_PluginFunctions *api = cls;
248 struct InternalContext *ic = api->cls;
256 /* end of plugin_block_revocation.c */