/*
This file is part of TALER
Copyright (C) 2014--2019 Taler Systems SA
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
*/
/**
* @file taler-wire.c
* @brief Utility for performing wire transfers.
* @author Marcello Stanisci
* @author Christian Grothoff
*/
#include
#include
#include "taler_util.h"
#include "taler_bank_service.h"
/**
* If set to #GNUNET_YES, then we'll ask the bank for a list
* of transactions from the account mentioned in the config
* section.
*/
static int history;
/**
* If set to #GNUNET_YES, then we'll ask the bank to execute a
* wire transfer.
*/
static int transfer;
/**
* Global return code.
*/
static unsigned int global_ret = 1;
/**
* When a wire transfer is being performed, this value
* specifies the amount to transfer.
*/
static struct TALER_Amount amount;
/**
* Starting row.
*/
static unsigned long long start_row;
/**
* Which config section has the credentials to access the bank.
*/
static char *account_section;
/**
* URL identifying the account that is going to receive the
* wire transfer.
*/
static char *destination_account_url;
/**
* Handle for executing the wire transfer.
*/
static struct TALER_BANK_WireExecuteHandle *eh;
/**
* Handle to ongoing history operation.
*/
static struct TALER_BANK_CreditHistoryHandle *hh;
/**
* For authentication.
*/
static struct TALER_BANK_AuthenticationData auth;
/**
* Handle to the context for interacting with the bank.
*/
static struct GNUNET_CURL_Context *ctx;
/**
* Scheduler context for running the @e ctx.
*/
static struct GNUNET_CURL_RescheduleContext *rc;
/**
* Callback used to process ONE entry in the transaction
* history returned by the bank.
*
* @param cls closure
* @param http_status HTTP status code from server
* @param ec taler error code
* @param serial_id identification of the position at
* which we are returning data
* @param details details about the wire transfer
* @param json original full response from server
* @return #GNUNET_OK to continue, #GNUNET_SYSERR to
* abort iteration
*/
static int
history_cb (void *cls,
unsigned int http_status,
enum TALER_ErrorCode ec,
uint64_t serial_id,
const struct TALER_BANK_CreditDetails *details,
const json_t *json)
{
(void) cls;
(void) ec;
(void) http_status;
(void) json;
if (NULL == details)
{
fprintf (stdout,
"End of transactions list.\n");
global_ret = 0;
GNUNET_SCHEDULER_shutdown ();
return GNUNET_NO;
}
fprintf (stdout,
"%llu: %s->%s (%s) over %s at %s\n",
(unsigned long long) serial_id,
details->debit_account_url,
details->credit_account_url,
TALER_B2S (&details->reserve_pub),
TALER_amount2s (&details->amount),
GNUNET_STRINGS_absolute_time_to_string (details->execution_date));
return GNUNET_OK;
}
/**
* Callback that processes the outcome of a wire transfer
* execution.
*
* @param cls closure
* @param response_code HTTP status code
* @param ec taler error code
* @param row_id unique ID of the wire transfer in the bank's records
* @param timestamp when did the transaction go into effect
*/
static void
confirmation_cb (void *cls,
unsigned int response_code,
enum TALER_ErrorCode ec,
uint64_t row_id,
struct GNUNET_TIME_Absolute timestamp)
{
(void) cls;
if (MHD_HTTP_OK != response_code)
{
fprintf (stderr,
"The wire transfer didn't execute correctly (%d).\n",
ec);
GNUNET_SCHEDULER_shutdown ();
return;
}
fprintf (stdout,
"Wire transfer #%llu executed successfully at %s.\n",
(unsigned long long) row_id,
GNUNET_STRINGS_absolute_time_to_string (timestamp));
global_ret = 0;
GNUNET_SCHEDULER_shutdown ();
}
/**
* Ask the bank to execute a wire transfer.
*/
static void
execute_wire_transfer ()
{
struct TALER_WireTransferIdentifierRawP wtid;
void *buf;
size_t buf_size;
GNUNET_CRYPTO_random_block (GNUNET_CRYPTO_QUALITY_NONCE,
&wtid,
sizeof (wtid));
TALER_BANK_prepare_wire_transfer (destination_account_url,
&amount,
"http://exchange.example.com/",
&wtid,
&buf,
&buf_size);
eh = TALER_BANK_execute_wire_transfer (ctx,
&auth,
buf,
buf_size,
&confirmation_cb,
NULL);
if (NULL == eh)
{
fprintf (stderr,
"Could not execute the wire transfer\n");
GNUNET_SCHEDULER_shutdown ();
return;
}
}
/**
* Ask the bank the list of transactions for the bank account
* mentioned in the config section given by the user.
*/
static void
execute_history ()
{
hh = TALER_BANK_credit_history (ctx,
&auth,
start_row,
-10,
&history_cb,
NULL);
if (NULL == hh)
{
fprintf (stderr,
"Could not request the transaction history.\n");
GNUNET_SCHEDULER_shutdown ();
return;
}
}
/**
* Gets executed upon shutdown. Main duty is wire-plugin unloading.
*
* @param cls closure.
*/
static void
do_shutdown (void *cls)
{
(void) cls;
if (NULL != ctx)
{
GNUNET_CURL_fini (ctx);
ctx = NULL;
}
if (NULL != rc)
{
GNUNET_CURL_gnunet_rc_destroy (rc);
rc = NULL;
}
if (NULL != hh)
{
TALER_BANK_credit_history_cancel (hh);
hh = NULL;
}
if (NULL != eh)
{
TALER_BANK_execute_wire_transfer_cancel (eh);
eh = NULL;
}
TALER_BANK_auth_free (&auth);
}
/**
* Main function that will be run.
*
* @param cls closure
* @param args remaining command-line arguments
* @param cfgfile name of the configuration file used
* (for saving, can be NULL!)
* @param cfg configuration
*/
static void
run (void *cls,
char *const *args,
const char *cfgfile,
const struct GNUNET_CONFIGURATION_Handle *cfg)
{
(void) cls;
(void) args;
(void) cfgfile;
if (NULL == account_section)
{
fprintf (stderr,
"The option: -s ACCOUNT-SECTION, is mandatory.\n");
return;
}
if (GNUNET_OK !=
TALER_BANK_auth_parse_cfg (cfg,
account_section,
&auth))
{
fprintf (stderr,
"Authentication information not found in configuration section `%s'\n",
account_section);
GNUNET_SCHEDULER_shutdown ();
return;
}
if (GNUNET_YES == history)
execute_history ();
else if (GNUNET_YES == transfer)
execute_wire_transfer ();
else
fprintf (stderr,
"Please give either --history/-H or --transfer/t\n");
ctx = GNUNET_CURL_init (&GNUNET_CURL_gnunet_scheduler_reschedule,
&rc);
rc = GNUNET_CURL_gnunet_rc_create (ctx);
if (NULL == ctx)
{
GNUNET_break (0);
return;
}
GNUNET_SCHEDULER_add_shutdown (&do_shutdown,
NULL);
}
/**
* Main function of taler-wire. This tool is used to command the
* execution of wire transfers from the command line. Its main
* purpose is to test whether the bank and exchange can speak the
* same protocol of a certain wire plugin.
*
* @param argc number of arguments from the command line
* @param argv command line arguments
* @return 0 ok, 1 on error
*/
int
main (int argc,
char *const *argv)
{
struct GNUNET_GETOPT_CommandLineOption options[] = {
GNUNET_GETOPT_option_flag ('H',
"history",
"Ask to get a list of 10 transactions.",
&history),
GNUNET_GETOPT_option_flag ('t',
"transfer",
"Execute a wire transfer.",
&transfer),
GNUNET_GETOPT_option_ulong ('w',
"since-when",
"SW",
"When asking the bank for"
" transactions history, this"
" option commands that all the"
" results should have IDs settled"
" after SW. If not given, then"
" the 10 youngest transactions"
" are returned.",
&start_row),
GNUNET_GETOPT_option_mandatory
(GNUNET_GETOPT_option_string ('s',
"section",
"ACCOUNT-SECTION",
"Which config section has the credentials to access the bank. Mandatory.\n",
&account_section)),
GNUNET_GETOPT_option_mandatory
(TALER_getopt_get_amount ('a',
"amount",
"AMOUNT",
"Specify the amount to transfer.",
&amount)),
GNUNET_GETOPT_option_mandatory
(GNUNET_GETOPT_option_string ('d',
"destination",
"PAYTO-URL",
"Destination account for the wire transfer.",
&destination_account_url)),
GNUNET_GETOPT_OPTION_END
};
int ret;
GNUNET_assert
(GNUNET_OK == GNUNET_log_setup ("taler-wire",
"WARNING",
NULL)); /* filename */
ret = GNUNET_PROGRAM_run
(argc,
argv,
"taler-wire",
"CLI bank client.",
options,
&run,
NULL);
if (GNUNET_OK != ret)
return ret;
return global_ret;
}
/* end of taler-wire.c */