diff options
author | Christian Grothoff <christian@grothoff.org> | 2016-04-17 23:14:23 +0200 |
---|---|---|
committer | Christian Grothoff <christian@grothoff.org> | 2016-04-17 23:14:23 +0200 |
commit | 8d503b17e3bd2f1ee4d54c13bb7c4221e4b6068b (patch) | |
tree | 0c73d67b6456ea3dfebd258ce3a690c563389394 /src/bank-lib/fakebank.h | |
parent | 4dcd70ac2bcf2642e1725f55cc26739bd91e4d1e (diff) |
move fake bank implementation to new library to re-use the code in upcoming testcases in preparation of fixing #4399
Diffstat (limited to 'src/bank-lib/fakebank.h')
-rw-r--r-- | src/bank-lib/fakebank.h | 94 |
1 files changed, 94 insertions, 0 deletions
diff --git a/src/bank-lib/fakebank.h b/src/bank-lib/fakebank.h new file mode 100644 index 000000000..5a4c13cd1 --- /dev/null +++ b/src/bank-lib/fakebank.h @@ -0,0 +1,94 @@ +/* + This file is part of TALER + (C) 2016 Inria and GNUnet e.V. + + 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, If not, see <http://www.gnu.org/licenses/> +*/ + +/** + * @file bank-lib/fakebank.h + * @brief API for a library that fakes being a Taler bank + * @author Christian Grothoff <christian@grothoff.org> + */ +#ifndef FAKEBANK_H +#define FAKEBANK_H + +#include "taler_util.h" +#include <gnunet/gnunet_json_lib.h> +#include "taler_json_lib.h" +#include <microhttpd.h> + +/** + * Handle for the fake bank. + */ +struct FAKEBANK_Handle; + + +/** + * Start the fake bank. The fake bank will, like the normal bank, + * listen for requests for /admin/add/incoming. However, instead of + * executing or storing those requests, it will simply allow querying + * whether such a request has been made via #FAKEBANK_check(). + * + * This is useful for writing testcases to check whether the exchange + * would have issued the correct wire transfer orders. + * + * @param port port to listen to + * @return NULL on error + */ +struct FAKEBANK_Handle * +FAKEBANK_start (uint16_t port); + + +/** + * Check that no wire transfers were ordered (or at least none + * that have not been taken care of via #FAKEBANK_check()). + * If any transactions are onrecord, return #GNUNET_SYSERR. + * + * @param h bank instance + * @return #GNUNET_OK on success + */ +int +FAKEBANK_check_empty (struct FAKEBANK_Handle *h); + + +/** + * Check that the @a want_amount was transferred from the @a + * want_debit to the @a want_credit account. If so, set the @a wtid + * to the transfer identifier and remove the transaction from the + * list. If the transaction was not recorded, return #GNUNET_SYSERR. + * + * @param h bank instance + * @param want_amount transfer amount desired + * @param want_debit account that should have been debited + * @param want_debit account that should have been credited + * @param[out] wtid set to the wire transfer identifier + * @return #GNUNET_OK on success + */ +int +FAKEBANK_check (struct FAKEBANK_Handle *h, + const struct TALER_Amount *want_amount, + uint64_t want_debit, + uint64_t want_credit, + struct TALER_WireTransferIdentifierRawP *wtid); + + +/** + * Stop running the fake bank. + * + * @param h bank to stop + */ +void +FAKEBANK_stop (struct FAKEBANK_Handle *h); + + +#endif |