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
|
/*
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);
/**
* 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 exchange the exchange to check
* @param wm the wire method to check with
* @return #GNUNET_OK if such a debit can happen
*/
enum GNUNET_GenericReturnValue
TMH_exchange_check_debit (
const struct TMH_Exchange *exchange,
const struct TMH_WireMethod *wm);
/**
* 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);
#endif
|
