exchange

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

get_purse_by_merge_pub.h (3189B)

      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/get_purse_by_merge_pub.h
     18  * @brief implementation of the get_purse_by_merge_pub function for Postgres
     19  * @author Christian Grothoff
     20  */
     21 #ifndef EXCHANGE_DATABASE_GET_PURSE_BY_MERGE_PUB_H
     22 #define EXCHANGE_DATABASE_GET_PURSE_BY_MERGE_PUB_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 to return meta data about a purse by the
     31  * merge capability key.
     32  *
     33  * Primary test table: `purse_requests` (see test_purse_requests.c).
     34  *
     35  * @param pg the database context
     36  * @param merge_pub public key representing the merge capability
     37  * @param[out] purse_pub public key of the purse
     38  * @param[out] purse_expiration when would an unmerged purse expire
     39  * @param[out] h_contract_terms contract associated with the purse
     40  * @param[out] age_limit the age limit for deposits into the purse
     41  * @param[out] target_amount amount to be put into the purse
     42  * @param[out] balance amount put so far into the purse
     43  * @param[out] purse_sig signature of the purse over the initialization data
     44  * @return transaction status code
     45  */
     46 enum GNUNET_DB_QueryStatus
     47 TALER_EXCHANGEDB_get_purse_by_merge_pub (struct
     48                                          TALER_EXCHANGEDB_PostgresContext
     49                                          *pg,
     50                                          const struct
     51                                          TALER_PurseMergePublicKeyP *
     52                                          merge_pub,
     53                                          struct
     54                                          TALER_PurseContractPublicKeyP
     55                                          *
     56                                          purse_pub,
     57                                          struct GNUNET_TIME_Timestamp *
     58                                          purse_expiration,
     59                                          struct
     60                                          TALER_PrivateContractHashP *
     61                                          h_contract_terms,
     62                                          uint32_t *age_limit,
     63                                          struct TALER_Amount *
     64                                          target_amount,
     65                                          struct TALER_Amount *balance,
     66                                          struct
     67                                          TALER_PurseContractSignatureP
     68                                          *
     69                                          purse_sig);
     70 
     71 #endif