diff options
author | Christian Grothoff <christian@grothoff.org> | 2016-06-08 22:14:24 +0200 |
---|---|---|
committer | Christian Grothoff <christian@grothoff.org> | 2016-06-08 22:14:24 +0200 |
commit | 3b9248e9c6d0abb3311dd7db25b5a227609b9bd1 (patch) | |
tree | d66bb39a27104507557c78ba6deae45ac95fff7f /src/include/taler_fakebank_lib.h | |
parent | 536163746e81e15cb5cb87c61e13907385460b4d (diff) | |
parent | f50d4b0f359064c15087b9d7b8b1bba84b9e7e89 (diff) | |
download | exchange-3b9248e9c6d0abb3311dd7db25b5a227609b9bd1.tar.xz |
Merge branch 'master' of git+ssh://taler.net/var/git/exchange
Diffstat (limited to 'src/include/taler_fakebank_lib.h')
-rw-r--r-- | src/include/taler_fakebank_lib.h | 94 |
1 files changed, 94 insertions, 0 deletions
diff --git a/src/include/taler_fakebank_lib.h b/src/include/taler_fakebank_lib.h new file mode 100644 index 000000000..38b996f0e --- /dev/null +++ b/src/include/taler_fakebank_lib.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 TALER_FAKEBANK_H +#define TALER_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 TALER_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 #TALER_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 TALER_FAKEBANK_Handle * +TALER_FAKEBANK_start (uint16_t port); + + +/** + * Check that no wire transfers were ordered (or at least none + * that have not been taken care of via #TALER_FAKEBANK_check()). + * If any transactions are onrecord, return #GNUNET_SYSERR. + * + * @param h bank instance + * @return #GNUNET_OK on success + */ +int +TALER_FAKEBANK_check_empty (struct TALER_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 +TALER_FAKEBANK_check (struct TALER_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 +TALER_FAKEBANK_stop (struct TALER_FAKEBANK_Handle *h); + + +#endif |