/*
This file is part of TALER
(C) 2014, 2015 Christian Grothoff (and other contributing authors)
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
*/
/**
* @file merchant/backend/taler-merchant-httpd.h
* @brief HTTP serving layer mainly intended to communicate with the frontend
* @author Marcello Stanisci
*/
#ifndef TALER_MERCHANT_HTTPD_H
#define TALER_MERCHANT_HTTPD_H
#include "platform.h"
#include "taler_merchantdb_lib.h"
#include
/**
* Shorthand for exit jumps.
*/
#define EXITIF(cond) \
do { \
if (cond) { GNUNET_break (0); goto EXITIF_exit; } \
} while (0)
/**
* @brief Struct describing an URL and the handler for it.
*/
struct TMH_RequestHandler
{
/**
* URL the handler is for.
*/
const char *url;
/**
* Method the handler is for, NULL for "all".
*/
const char *method;
/**
* Mime type to use in reply (hint, can be NULL).
*/
const char *mime_type;
/**
* Raw data for the @e handler
*/
const void *data;
/**
* Number of bytes in @e data, 0 for 0-terminated.
*/
size_t data_size;
/**
* Function to call to handle the request.
*
* @param rh this struct
* @param mime_type the @e mime_type for the reply (hint, can be NULL)
* @param connection the MHD connection to handle
* @param[in,out] connection_cls the connection's closure (can be updated)
* @param upload_data upload data
* @param[in,out] upload_data_size number of bytes (left) in @a upload_data
* @return MHD result code
*/
int (*handler)(struct TMH_RequestHandler *rh,
struct MHD_Connection *connection,
void **connection_cls,
const char *upload_data,
size_t *upload_data_size);
/**
* Default response code.
*/
int response_code;
};
/**
* Mint
*/
struct MERCHANT_Mint
{
/**
* Hostname
*/
char *hostname;
/**
* A connection to this mint
*/
struct TALER_MINT_Handle *conn;
/**
* This mint's context (useful to the event loop)
*/
struct TALER_MINT_Context *ctx;
/**
* Task we use to drive the interaction with this mint.
*/
struct GNUNET_SCHEDULER_Task *poller_task;
/**
* Flag which indicates whether some HTTP transfer between
* this merchant and the mint is still ongoing
*/
int pending;
};
struct MERCHANT_WIREFORMAT_Sepa
{
/**
* The international bank account number
*/
char *iban;
/**
* Name of the bank account holder
*/
char *name;
/**
*The bank identification code
*/
char *bic;
/**
* The latest payout date when the payment corresponding to this account has
* to take place. A value of 0 indicates a transfer as soon as possible.
*/
struct GNUNET_TIME_AbsoluteNBO payout;
};
struct MERCHANT_Auditor
{
/**
* Auditor's legal name
*/
char *name;
};
struct TM_HandlerContext;
/**
* Signature of a function used to clean up the context
* we keep in the "connection_cls" of MHD when handling
* a request.
*
* @param hc header of the context to clean up.
*/
typedef void
(*TM_ContextCleanup)(struct TM_HandlerContext *hc);
struct TM_HandlerContext
{
TM_ContextCleanup cc;
};
/**
* Our wire format details in JSON format (with salt).
*/
extern json_t *j_wire;
/**
* Hash of our wire format details as given in #j_wire.
*/
extern struct GNUNET_HashCode h_wire;
extern struct MERCHANT_Auditor *auditors;
extern unsigned int nauditors;
extern struct MERCHANT_Mint **mints;
extern struct GNUNET_CRYPTO_EddsaPrivateKey *privkey;
extern PGconn *db_conn;
extern unsigned int nmints;
extern struct GNUNET_TIME_Relative edate_delay;
void
context_task (void *cls,
const struct GNUNET_SCHEDULER_TaskContext *tc);
/**
* Take the global wire details and return a JSON containing them,
* compliantly with the Taler's API.
*
* @param wire the merchant's wire details
* @param salt the nounce for hashing the wire details with
* @return JSON representation of the wire details, NULL upon errors
*/
json_t *
MERCHANT_get_wire_json (const struct MERCHANT_WIREFORMAT_Sepa *wire,
uint64_t salt);
/**
* Kick MHD to run now, to be called after MHD_resume_connection().
*/
void
TM_trigger_daemon (void);
#endif