blob: eb430360e1ebc03539042486b75c579dab938fb0 (
plain)
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
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
|
/*
This file is part of TALER
(C) 2014 Christian Grothoff (and other contributing authors)
TALER 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.
TALER 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
TALER; see the file COPYING. If not, If not, see <http://www.gnu.org/licenses/>
*/
/**
* @file include/merchant.h
* @brief Common utility functions for merchant
* @author Sree Harsha Totakura <sreeharsha@totakura.in>
*/
#ifndef MERCHANT_H
#define MERCHANT_H
#include <gnunet/gnunet_util_lib.h>
#include <taler/taler_mint_service.h>
#include "merchant.h"
/**
* Macro to round microseconds to seconds in GNUNET_TIME_* structs.
*/
#define ROUND_TO_SECS(name,us_field) name.us_field -= name.us_field % (1000 * 1000)
/**
* Shorthand for exit jumps.
*/
#define EXITIF(cond) \
do { \
if (cond) { GNUNET_break (0); goto EXITIF_exit; } \
} while (0)
/**
* Outcome of a /deposit request for a coin. Typically forming an array enclosed
* into the unique PayContext
*/
struct MERCHANT_DepositConfirmation
{
/**
* Reference to the per-deposit-handler Context. Needed by the
* cleanup function to get it freed
*/
struct DepositCallbackContext *dcc;
/**
* True if this coin's outcome has been read from
* its cb
*/
unsigned int ackd;
/**
* The mint's response to this /deposit
*/
unsigned int exit_status;
/**
* The mint's response body (JSON). Mainly useful in case
* some callback needs to send back to the to the wallet the
* outcome of an erroneous coin
*/
json_t *proof;
};
/**
* Mint
*/
struct MERCHANT_Mint
{
/**
* Hostname
*/
char *hostname;
/**
* Flag which indicates whether some HTTP transfer between
* this merchant and the mint is still ongoing
*/
int pending;
/**
* A connection to this mint
*/
struct TALER_MINT_Handle *conn;
/**
* This mint's context (useful to the event loop)
*/
struct TALER_MINT_Context *ctx;
};
struct MERCHANT_Auditor
{
/**
* Auditor's legal name
*/
char *name;
};
/**
* The contract sent by the merchant to the wallet
*/
struct MERCHANT_Contract
{
/**
* Purpose header for the signature over contract
*/
struct GNUNET_CRYPTO_EccSignaturePurpose purpose;
/**
* Hash of the JSON contract in UTF-8 including 0-termination,
* using JSON_COMPACT | JSON_SORT_KEYS
*/
struct GNUNET_HashCode h_contract;
};
/**
* Parses mints from the configuration.
*
* @param cfg the configuration
* @param mints the array of mints upon successful parsing. Will be NULL upon
* error.
* @return the number of mints in the above array; GNUNET_SYSERR upon error in
* parsing.
*/
int
TALER_MERCHANT_parse_mints (const struct GNUNET_CONFIGURATION_Handle *cfg,
struct MERCHANT_Mint **mints);
/**
* Parses auditors from the configuration.
*
* @param cfg the configuration
* @param mints the array of auditors upon successful parsing. Will be NULL upon
* error.
* @return the number of auditors in the above array; GNUNET_SYSERR upon error in
* parsing.
*/
int
TALER_MERCHANT_parse_auditors (const struct GNUNET_CONFIGURATION_Handle *cfg,
struct MERCHANT_Auditor **auditors);
GNUNET_NETWORK_STRUCT_BEGIN
struct MERCHANT_WIREFORMAT_Sepa
{
/**
* The international bank account number
*/
char *iban;
/**
* Name of the bank account holder
*/
char *name;
/**
*The bank identification code
*/
char *bic;
/**
* The latest payout date when the payment corresponding to this account has
* to take place. A value of 0 indicates a transfer as soon as possible.
*/
struct GNUNET_TIME_AbsoluteNBO payout;
};
GNUNET_NETWORK_STRUCT_END
/**
* Parse the SEPA information from the configuration. If any of the required
* fileds is missing return NULL.
*
* @param cfg the configuration
* @return Sepa details as a structure; NULL upon error
*/
struct MERCHANT_WIREFORMAT_Sepa *
TALER_MERCHANT_parse_wireformat_sepa (const struct GNUNET_CONFIGURATION_Handle *cfg);
/**
* Destroy and free resouces occupied by the wireformat structure
*
* @param wf the wireformat structure
*/
void
TALER_MERCHANT_destroy_wireformat_sepa (struct MERCHANT_WIREFORMAT_Sepa *wf);
#endif /* MERCHANT_H */
|
