get_reserve_close_request_info.h (2304B)
1 /* 2 This file is part of TALER 3 Copyright (C) 2022, 2026 Taler Systems SA 4 5 TALER is free software; you can redistribute it and/or modify it under the 6 terms of the GNU General Public License as published by the Free Software 7 Foundation; either version 3, or (at your option) any later version. 8 9 TALER is distributed in the hope that it will be useful, but WITHOUT ANY 10 WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR 11 A PARTICULAR PURPOSE. See the GNU General Public License for more details. 12 13 You should have received a copy of the GNU General Public License along with 14 TALER; see the file COPYING. If not, see <http://www.gnu.org/licenses/> 15 */ 16 /** 17 * @file get_reserve_close_request_info.h 18 * @brief implementation of the select_reserve_close_request_info function 19 * @author Christian Grothoff 20 */ 21 #ifndef EXCHANGE_DATABASE_GET_RESERVE_CLOSE_REQUEST_INFO_H 22 #define EXCHANGE_DATABASE_GET_RESERVE_CLOSE_REQUEST_INFO_H 23 24 #include "taler/taler_util.h" 25 #include "taler/taler_json_lib.h" 26 #include "exchangedb_lib.h" 27 28 29 /** 30 * Select information about reserve close requests. 31 * 32 * Primary test table: `close_requests` (see test_close_requests.c). 33 * 34 * @param pg the database context 35 * @param reserve_pub which reserve is this about? 36 * @param rowid row ID of the close request 37 * @param[out] reserve_sig reserve signature affirming 38 * @param[out] request_timestamp when was the request made 39 * @param[out] close_balance reserve balance at close time 40 * @param[out] close_fee closing fee to be charged 41 * @param[out] payto_uri set to URL of the account that should receive the 42 * money; never NULL, the column is NOT NULL and the /close 43 * handler resolves the origin account before storing the 44 * request. To be freed by the caller. 45 * @return transaction status code, 0 if the request is unknown 46 */ 47 enum GNUNET_DB_QueryStatus 48 TALER_EXCHANGEDB_get_reserve_close_request_info ( 49 struct TALER_EXCHANGEDB_PostgresContext *pg, 50 const struct TALER_ReservePublicKeyP *reserve_pub, 51 uint64_t rowid, 52 struct TALER_ReserveSignatureP *reserve_sig, 53 struct GNUNET_TIME_Timestamp *request_timestamp, 54 struct TALER_Amount *close_balance, 55 struct TALER_Amount *close_fee, 56 struct TALER_FullPayto *payto_uri); 57 58 #endif