aboutsummaryrefslogtreecommitdiff
path: root/src/include/gnunet_zklaim_lib.h
blob: a1fd1f017fda6a1fab10a04b1b66210e43ef49cc (plain) (blame)
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
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
/*
     This file is part of GNUnet.
     Copyright (C) 2001-2018 GNUnet e.V.

     GNUnet is free software; you can redistribute it and/or modify
     it under the terms of the GNU General Public License as published
     by the Free Software Foundation; either version 3, or (at your
     option) any later version.

     GNUnet is distributed in the hope that it will be useful, but
     WITHOUT ANY WARRANTY; without even the implied warranty of
     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
     General Public License for more details.

     You should have received a copy of the GNU General Public License
     along with GNUnet; see the file COPYING.  If not, write to the
     Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
     Boston, MA 02110-1301, USA.
*/

/**
 * @file include/gnunet_zklaim_lib.h
 * @brief ZKlaim functions for GNUnet
 *
 * @author Martin Schanzenbach
 *
 * @defgroup zklaim ZKlaim library: Zero-Knowledge Credentials
 *
 */
#ifndef GNUNET_ZKLAIM_LIB_H
#define GNUNET_ZKLAIM_LIB_H

#ifdef __cplusplus
extern "C"
{
#if 0                           /* keep Emacsens' auto-indent happy */
}
#endif
#endif

#include "gnunet_common.h"

/**
 * @brief type for ZKlaim context
 */
struct GNUNET_ZKLAIM_Context;

/**
 * @brief type for ZKlaim payload
 */
struct GNUNET_ZKLAIM_Payload;


/**
 * @ingroup zklaim
 * Create a new ZKlaim context. Caller must free return value.
 * TODO: parameters: keys etc.
 *
 * @return fresh context; free using #GNUNET_free
 */
struct GNUNET_ZKLAIM_Context *
GNUNET_ZKLAIM_context_create (void);

/**
 * @ingroup zklaim
 * Create a payload.
 * TODO: parameters, attributes etc.
 *
 * @return fresh payload; free using #GNUNET_free
 */
void
GNUNET_ZKLAIM_payload_create (void);

/**
 * @ingroup zklaim
 * Create a payload.
 * TODO: parameters, attributes etc.
 *
 * @return GNUNET_OK is successful
 */
int
GNUNET_ZKLAIM_context_add_payload (struct GNUNET_ZKLAIM_Context *ctx,
                                   struct GNUNET_ZKLAIM_Payload* pl);


/**
 * @ingroup zklaim
 * Create a payload.
 * TODO: parameters, attributes etc.
 *
 * @return size needed for serialized context, -1 on error
 */
ssize_t
GNUNET_ZKLAIM_context_serialize_get_size (struct GNUNET_ZKLAIM_Context *ctx);


/**
 * @ingroup zklaim
 * Create a payload.
 * TODO: parameters, attributes etc.
 *
 */
void
GNUNET_ZKLAIM_context_serialize (struct GNUNET_ZKLAIM_Context *ctx,
                                 char* buf);


/**
 * @ingroup zklaim
 * Create a payload.
 * TODO: parameters, attributes etc.
 *
 * @return fresh payload; free using #GNUNET_free
 */
char *
GNUNET_ZKLAIM_context_to_string (struct GNUNET_ZKLAIM_Context *ctx);




#if 0                           /* keep Emacsens' auto-indent happy */
{
#endif
#ifdef __cplusplus
}
#endif


/* ifndef GNUNET_ZKLAIM_LIB_H */
#endif
/* end of gnunet_zklaim_lib.h */