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
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
|
/*
This file is part of TALER
(C) 2014-2023 Taler Systems SA
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, see <http://www.gnu.org/licenses/>
*/
/**
* @file taler-merchant-httpd_exchanges.h
* @brief logic this HTTPD keeps for each exchange we interact with
* @author Marcello Stanisci
* @author Christian Grothoff
*/
#ifndef TALER_MERCHANT_HTTPD_EXCHANGES_H
#define TALER_MERCHANT_HTTPD_EXCHANGES_H
#include <jansson.h>
#include <gnunet/gnunet_util_lib.h>
#include <curl/curl.h>
#include <taler/taler_util.h>
#include <taler/taler_exchange_service.h>
#include "taler-merchant-httpd.h"
/**
* Exchange
*/
struct TMH_Exchange;
/**
* Parses "trusted" exchanges listed in the configuration.
*
* @param cfg the configuration
* @return number of trusted exchanges on success; #GNUNET_SYSERR upon error in
* parsing.
*/
enum GNUNET_GenericReturnValue
TMH_EXCHANGES_init (const struct GNUNET_CONFIGURATION_Handle *cfg);
/**
* Function called to shutdown the exchanges subsystem.
*/
void
TMH_EXCHANGES_done (void);
/**
* Function called with the result of a #TMH_EXCHANGES_keys4exchange()
* operation.
*
* @param cls closure
* @param keys the keys of the exchange
* @param exchange representation of the exchange
*/
typedef void
(*TMH_EXCHANGES_Find2Continuation)(
void *cls,
struct TALER_EXCHANGE_Keys *keys,
struct TMH_Exchange *exchange);
/**
* Information we keep for a pending #MMH_EXCHANGES_keys4exchange() operation.
*/
struct TMH_EXCHANGES_KeysOperation;
/**
* Get /keys of the given @a exchange.
*
* @param exchange URL of the exchange we would like to talk to
* @param force_download force /keys download now
* @param fc function to call with the handles for the exchange
* @param fc_cls closure for @a fc
*/
struct TMH_EXCHANGES_KeysOperation *
TMH_EXCHANGES_keys4exchange (
const char *exchange,
bool force_download,
TMH_EXCHANGES_Find2Continuation fc,
void *fc_cls);
/**
* Abort pending keys details lookup operation.
*
* @param fo handle to operation to abort
*/
void
TMH_EXCHANGES_keys4exchange_cancel (struct TMH_EXCHANGES_KeysOperation *fo);
/**
* Callback on an exchange known to us. Does not warrant
* that the "keys" information is actually available for
* @a exchange.
*
* @param cls closure
* @param url base URL of the exchange
* @param exchange internal handle for the exchange
*/
typedef void
(*TMH_ExchangeCallback)(void *cls,
const char *url,
const struct TMH_Exchange *exchange);
/**
* Return all trusted exchanges to @a cb.
*
* @param cb function to call
* @param cb_cls closure for @a cb
*/
void
TMH_exchange_get_trusted (TMH_ExchangeCallback cb,
void *cb_cls);
/**
* Return the master public key of the given @a exchange.
* Will be returned from configuration for trusted
* exchanges.
*
* @param exchange exchange to get master public key for
* @return the master public key of @a exchange
*/
const struct TALER_MasterPublicKeyP *
TMH_EXCHANGES_get_master_pub (
const struct TMH_Exchange *exchange);
/**
* Return the currency of the given @a exchange.
* Will be returned from configuration for trusted
* exchanges.
*
* @param exchange exchange to get master public key for
* @return the currency of @a exchange
*/
const char *
TMH_EXCHANGES_get_currency (
const struct TMH_Exchange *exchange);
/**
* Check if the given operation and amount would
* violate any hard limits of the exchange.
* Only useful for transaction and refund limits.
*
* @param keys the keys of the exchange to check limit for
* @param operation_type the kind of operation we perform
* @param amount the amount we want to transact
* @return true if this is allowed
*/
bool
TMH_EXCHANGES_is_below_limit (
const struct TALER_EXCHANGE_Keys *keys,
enum TALER_KYCLOGIC_KycTriggerEvent operation_type,
const struct TALER_Amount *amount);
/**
* Lookup current wire fee by @a exchange_url and @a wire_method.
*
* @param exchange the exchange to check
* @param wire_method wire method to lookup fee by
* @param[out] wire_fee set to the wire fee
* @return #GNUNET_OK on success
* #GNUNET_NO if @a wire_method is not supported
* #GNUNET_SYSERR if @a exchange_url did not yet respond properly to our /wire request
*/
enum GNUNET_GenericReturnValue
TMH_EXCHANGES_lookup_wire_fee (
const struct TMH_Exchange *exchange,
const char *wire_method,
struct TALER_Amount *wire_fee);
/**
* Check if we would trust @a ex to deposit funds into our account @a
* wm. Checks that both @a ex is trusted and that @a ex allows wire transfers
* into the account given in @a wm.
*
* @param instance_id the instance to check for
* @param exchange the exchange to check
* @param wm the wire method to check with
* @param[in,out] max_amount maximum amount we may deposit at this
* exchange; input is an existing maximum, that
* can be lowered by this function due to transaction
* limits and deposit limits of the exchange
* @return #GNUNET_OK if such a debit can happen
*/
enum GNUNET_GenericReturnValue
TMH_exchange_check_debit (
const char *instance_id,
const struct TMH_Exchange *exchange,
const struct TMH_WireMethod *wm,
struct TALER_Amount *max_amount);
/**
* Check if we support the given currency (by having an
* exchange configured with it).
*
* @param currency currency to check
* @return true if the currency is supported
*/
bool
TMH_test_exchange_configured_for_currency (
const char *currency);
/**
* Determines the legal limit for a given @a operation_type
* at a given @a exchange_url.
*
* @param exchange_url base URL of the exchange to get
* the refund limit for
* @param operation_type type of operation
* @param[in,out] amount lowered to the maximum
* allowed at the exchange
*/
void
TMH_EXCHANGES_get_limit (
const char *exchange_url,
enum TALER_KYCLOGIC_KycTriggerEvent operation_type,
struct TALER_Amount *amount);
#endif
|
