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
|
/*
This file is part of TALER
Copyright (C) 2021 Taler Systems SA
TALER is free software; you can redistribute it and/or modify it under the
terms of the GNU Affero 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 Affero General Public License for more details.
You should have received a copy of the GNU Affero General Public License along with
TALER; see the file COPYING. If not, see <http://www.gnu.org/licenses/>
*/
/**
* @file taler-merchant-httpd_helper.h
* @brief helpers for shared logic
* @author Florian Dold
* @author Benedikt Mueller
* @author Christian Grothoff
*/
#ifndef TALER_EXCHANGE_HTTPD_HELPER_H
#define TALER_EXCHANGE_HTTPD_HELPER_H
#include "taler-merchant-httpd.h"
/**
* check @a payto_uris for well-formedness
*
* @param payto_uris JSON array of payto URIs (presumably)
* @return true if they are all valid URIs (and this is an array of strings)
*/
bool
TMH_payto_uri_array_valid (const json_t *payto_uris);
/**
* Check if @a taxes is an array of valid Taxes in the sense of
* Taler's API definition.
*
* @param taxes array to check
* @return true if @a taxes is an array and all
* entries are valid Taxes.
*/
bool
TMH_taxes_array_valid (const json_t *taxes);
/**
* Check if @a location is a valid Location object in the sense of Taler's API
* definition.
*
* @param location object to check
* @return true if @a location is an object
* representing a Location.
*/
bool
TMH_location_object_valid (const json_t *location);
/**
* Check if @a products is an array of valid Product(s) in the sense of
* Taler's API definition.
*
* @param products array to check
* @return true if @a products is an array and all
* entries are valid Products.
*/
bool
TMH_products_array_valid (const json_t *products);
/**
* Check if @a image_data_url is a valid image
* data URL. Does not validate the actual payload,
* only the syntax and that it properly claims to
* be an image.
*
* @param image_data_url string to check
* @return true if @a image_data_url is a data
* URL with an "image/" mime-type
*/
bool
TMH_image_data_url_valid (const char *image_data_url);
/**
* Check if @a template_contract is a valid template_contract object in the sense of Taler's API
* definition.
*
* @param template_contract object to check
* @return true if @a template_location is an object
* representing a template_location.
*/
bool
TMH_template_contract_valid (const json_t *template_contract);
/**
* Setup new wire method for the given @ payto_uri.
*
* @param payto_uri already validated payto URI
* @return new wire method object, never fails
*/
struct TMH_WireMethod *
TMH_setup_wire_account (const char *payto_uri);
/**
* FIXME: document
*/
enum GNUNET_GenericReturnValue
TMH_check_auth_config (struct MHD_Connection *connection,
const json_t *jauth,
const char **auth_token);
/**
* Generate binary UUID from client-provided UUID-string.
*
* @param uuids string intpu
* @param[out] uuid set to binary UUID
*/
void
TMH_uuid_from_string (const char *uuids,
struct GNUNET_Uuid *uuid);
/**
* Put data from an exchange's HTTP response into
* a JSON reply
*
* @param hr a `TALER_EXCHANGE_HttpResponse`
*/
#define TMH_pack_exchange_reply(hr) \
GNUNET_JSON_pack_uint64 ("exchange_code", (hr)->ec), \
GNUNET_JSON_pack_uint64 ("exchange_http_status", (hr)->http_status), \
GNUNET_JSON_pack_uint64 ("exchange_ec", (hr)->ec), /* LEGACY */ \
GNUNET_JSON_pack_uint64 ("exchange_hc", (hr)->http_status), /* LEGACY */ \
GNUNET_JSON_pack_allow_null ( \
GNUNET_JSON_pack_object_incref ("exchange_reply", (json_t *) (hr)->reply))
/**
* TMH_trigger_webhook is a function that need to be use when someone
* pay. Merchant need to have a notification.
*
* @param instance that we need to send the webhook as a notification
* @param event of the webhook
* @param args argument of the function
*/
enum GNUNET_DB_QueryStatus
TMH_trigger_webhook (const char *instance,
const char *action,
const json_t *args);
#endif
|
