exchange

Base system with REST service to issue digital coins, run by the payment service provider
Log | Files | Refs | Submodules | README | LICENSE

select_purse_deposits_by_purse.h (3640B)

      1 /*
      2    This file is part of TALER
      3    Copyright (C) 2022 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 src/include/exchange-database/select_purse_deposits_by_purse.h
     18  * @brief implementation of the select_purse_deposits_by_purse function for Postgres
     19  * @author Christian Grothoff
     20  */
     21 #ifndef EXCHANGE_DATABASE_SELECT_PURSE_DEPOSITS_BY_PURSE_H
     22 #define EXCHANGE_DATABASE_SELECT_PURSE_DEPOSITS_BY_PURSE_H
     23 
     24 #include "taler/taler_util.h"
     25 #include "taler/taler_json_lib.h"
     26 #include "exchangedb_lib.h"
     27 
     28 
     29 /**
     30  * Function called with details about purse refunds that have been made, with
     31  * the goal of auditing the purse refund's execution.
     32  *
     33  * @param cls closure
     34  * @param rowid row of the refund event
     35  * @param amount_with_fee amount of the deposit into the purse
     36  * @param coin_pub coin that is to be refunded the @a given amount_with_fee
     37  * @param denom_pub denomination of @a coin_pub
     38  * @return #GNUNET_OK to continue to iterate, #GNUNET_SYSERR to stop
     39  */
     40 typedef enum GNUNET_GenericReturnValue
     41 (*TALER_EXCHANGEDB_PurseRefundCoinCallback)(
     42   void *cls,
     43   uint64_t rowid,
     44   const struct TALER_Amount *amount_with_fee,
     45   const struct TALER_CoinSpendPublicKeyP *coin_pub,
     46   const struct TALER_DenominationPublicKey *denom_pub);
     47 
     48 
     49 /* Callback typedefs */
     50 /**
     51  * Function called with details about purse refunds that have been made, with
     52  * the goal of auditing the purse refund's execution.
     53  *
     54  * @param cls closure
     55  * @param rowid row of the refund event
     56  * @param amount_with_fee amount of the deposit into the purse
     57  * @param coin_pub coin that is to be refunded the @a given amount_with_fee
     58  * @param denom_pub denomination of @a coin_pub
     59  * @return #GNUNET_OK to continue to iterate, #GNUNET_SYSERR to stop
     60  */
     61 typedef enum GNUNET_GenericReturnValue
     62 (*TALER_EXCHANGEDB_PurseRefundCoinCallback)(
     63   void *cls,
     64   uint64_t rowid,
     65   const struct TALER_Amount *amount_with_fee,
     66   const struct TALER_CoinSpendPublicKeyP *coin_pub,
     67   const struct TALER_DenominationPublicKey *denom_pub);
     68 
     69 /**
     70  * Select coin affected by purse refund.
     71  *
     72  * @param pg the database context
     73  * @param purse_pub purse that was refunded
     74  * @param cb function to call on each result
     75  * @param cb_cls closure for @a cb
     76  * @return transaction status code
     77  */
     78 enum GNUNET_DB_QueryStatus
     79 TALER_TALER_EXCHANGEDB_select_purse_deposits_by_purse (struct
     80                                                        TALER_EXCHANGEDB_PostgresContext
     81                                                        *
     82                                                        pg,
     83                                                        const struct
     84                                                        TALER_PurseContractPublicKeyP
     85                                                        *
     86                                                        purse_pub,
     87                                                        TALER_EXCHANGEDB_PurseRefundCoinCallback
     88                                                        cb,
     89                                                        void *cb_cls);
     90 
     91 #endif