153 lines
4.0 KiB
C
153 lines
4.0 KiB
C
/*
|
|
This file is part of TALER
|
|
Copyright (C) 2014, 2015 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, see
|
|
<http://www.gnu.org/licenses/>
|
|
*/
|
|
/**
|
|
* @file exchange-lib/exchange_api_handle.h
|
|
* @brief Internal interface to the handle part of the exchange's HTTP API
|
|
* @author Christian Grothoff
|
|
*/
|
|
#include "platform.h"
|
|
#include <gnunet/gnunet_curl_lib.h>
|
|
#include "taler_auditor_service.h"
|
|
#include "taler_exchange_service.h"
|
|
#include "taler_crypto_lib.h"
|
|
#include "taler_curl_lib.h"
|
|
|
|
/**
|
|
* Entry in DLL of auditors used by an exchange.
|
|
*/
|
|
struct TEAH_AuditorListEntry;
|
|
|
|
|
|
/**
|
|
* Entry in list of ongoing interactions with an auditor.
|
|
*/
|
|
struct TEAH_AuditorInteractionEntry
|
|
{
|
|
/**
|
|
* DLL entry.
|
|
*/
|
|
struct TEAH_AuditorInteractionEntry *next;
|
|
|
|
/**
|
|
* DLL entry.
|
|
*/
|
|
struct TEAH_AuditorInteractionEntry *prev;
|
|
|
|
/**
|
|
* Which auditor is this action associated with?
|
|
*/
|
|
struct TEAH_AuditorListEntry *ale;
|
|
|
|
/**
|
|
* Interaction state.
|
|
*/
|
|
struct TALER_AUDITOR_DepositConfirmationHandle *dch;
|
|
};
|
|
|
|
|
|
/**
|
|
* Function called for each auditor to give us a chance to possibly
|
|
* launch a deposit confirmation interaction.
|
|
*
|
|
* @param cls closure
|
|
* @param ah handle to the auditor
|
|
* @param auditor_pub public key of the auditor
|
|
* @return NULL if no deposit confirmation interaction was launched
|
|
*/
|
|
typedef struct TEAH_AuditorInteractionEntry *
|
|
(*TEAH_AuditorCallback)(void *cls,
|
|
struct TALER_AUDITOR_Handle *ah,
|
|
const struct TALER_AuditorPublicKeyP *auditor_pub);
|
|
|
|
|
|
/**
|
|
* Signature of functions called with the result from our call to the
|
|
* auditor's /deposit-confirmation handler.
|
|
*
|
|
* @param cls closure of type `struct TEAH_AuditorInteractionEntry *`
|
|
* @param http_status HTTP status code, 200 on success
|
|
* @param ec taler protocol error status code, 0 on success
|
|
* @param json raw json response
|
|
*/
|
|
void
|
|
TEAH_acc_confirmation_cb (void *cls,
|
|
unsigned int http_status,
|
|
enum TALER_ErrorCode ec,
|
|
const json_t *json);
|
|
|
|
|
|
/**
|
|
* Iterate over all available auditors for @a h, calling
|
|
* @param ah and giving it a chance to start a deposit
|
|
* confirmation interaction.
|
|
*
|
|
* @param h exchange to go over auditors for
|
|
* @param ac function to call per auditor
|
|
* @param ac_cls closure for @a ac
|
|
*/
|
|
void
|
|
TEAH_get_auditors_for_dc (struct TALER_EXCHANGE_Handle *h,
|
|
TEAH_AuditorCallback ac,
|
|
void *ac_cls);
|
|
|
|
|
|
/**
|
|
* Get the context of a exchange.
|
|
*
|
|
* @param h the exchange handle to query
|
|
* @return ctx context to execute jobs in
|
|
*/
|
|
struct GNUNET_CURL_Context *
|
|
TEAH_handle_to_context (struct TALER_EXCHANGE_Handle *h);
|
|
|
|
|
|
/**
|
|
* Check if the handle is ready to process requests.
|
|
*
|
|
* @param h the exchange handle to query
|
|
* @return #GNUNET_YES if we are ready, #GNUNET_NO if not
|
|
*/
|
|
int
|
|
TEAH_handle_is_ready (struct TALER_EXCHANGE_Handle *h);
|
|
|
|
|
|
/**
|
|
* Obtain the URL to use for an API request.
|
|
*
|
|
* @param h the exchange handle to query
|
|
* @param path Taler API path (i.e. "/reserve/withdraw")
|
|
* @return the full URL to use with cURL
|
|
*/
|
|
char *
|
|
TEAH_path_to_url (struct TALER_EXCHANGE_Handle *h,
|
|
const char *path);
|
|
|
|
|
|
/**
|
|
* Obtain the URL to use for an API request.
|
|
*
|
|
* @param base_url base URL of the exchange (i.e. "http://exchange/")
|
|
* @param path Taler API path (i.e. "/reserve/withdraw")
|
|
* @return the full URL to use with cURL
|
|
*/
|
|
char *
|
|
TEAH_path_to_url2 (const char *base_url,
|
|
const char *path);
|
|
|
|
|
|
/* end of exchange_api_handle.h */
|