/*
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 performing wire transfers.
* @author Marcello Stanisci
* @author Christian Grothoff
*/
#include
#include
#include "taler_util.h"
#include "taler_wire_lib.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;
/**
* Name of the wire plugin to use with the bank.
*/
static char *plugin_name;
/**
* Global return code.
*/
static unsigned int global_ret = 1;
/**
* When a wire transfer is being performed, this value
* specifies the amount to wire-transfer. It's given in
* the usual CURRENCY:X[.Y] format.
*/
static char *amount;
/**
* Base32 encoding of a transaction ID. When asking the
* bank for a transaction history, all the results will
* have a transaction ID settled *after* this one.
*/
static char *since_when;
/**
* 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 the wire transfer preparation task.
*/
static struct TALER_WIRE_PrepareHandle *ph;
/**
* Wire plugin handle.
*/
static struct TALER_WIRE_Plugin *plugin_handle;
/**
* Handle to ongoing history operation.
*/
static struct TALER_WIRE_HistoryHandle *hh;
/**
* Callback used to process ONE entry in the transaction
* history returned by the bank.
*
* @param cls closure
* @param ec taler error code
* @param dir direction of the transfer
* @param row_off identification of the position at
* which we are querying
* @param row_off_size number of bytes in @a row_off
* @param details details about the wire transfer
* @return #GNUNET_OK to continue, #GNUNET_SYSERR to
* abort iteration
*/
static int
history_cb (void *cls,
enum TALER_ErrorCode ec,
enum TALER_BANK_Direction dir,
const void *row_off,
size_t row_off_size,
const struct TALER_WIRE_TransferDetails *details)
{
char *row_off_enc;
(void) cls;
if (TALER_BANK_DIRECTION_NONE == dir)
{
fprintf (stdout,
"End of transactions list.\n");
global_ret = 0;
GNUNET_SCHEDULER_shutdown ();
return GNUNET_NO;
}
row_off_enc = GNUNET_STRINGS_data_to_string_alloc (row_off,
row_off_size);
/* Give more details on screen (??) */
fprintf (stdout,
"%s\n",
row_off_enc);
GNUNET_free (row_off_enc);
return GNUNET_OK;
}
/**
* Callback that processes the outcome of a wire transfer
* execution.
*/
static void
confirmation_cb (void *cls,
int success,
const void *row_id,
size_t row_id_size,
const char *emsg)
{
if (GNUNET_YES != success)
{
fprintf (stderr,
"The wire transfer didn't execute correctly.\n");
GNUNET_assert (NULL != emsg);
fprintf (stderr,
"%s",
emsg);
GNUNET_SCHEDULER_shutdown ();
return;
}
fprintf (stdout,
"Wire transfer executed successfully.\n");
global_ret = 0;
GNUNET_SCHEDULER_shutdown ();
}
/**
* Takes prepared blob and executes the wire-transfer.
*
* @param cls NULL.
* @param buf prepared wire transfer data.
* @param buf_size size of the prepared wire transfer data.
*/
static void
prepare_cb (void *cls,
const char *buf,
size_t buf_size)
{
struct TALER_WIRE_ExecuteHandle *eh;
if (NULL == (eh = plugin_handle->execute_wire_transfer
(plugin_handle->cls,
buf,
buf_size,
confirmation_cb,
NULL)))
{
fprintf (stderr,
"Could not execute the wire transfer\n");
plugin_handle->prepare_wire_transfer_cancel
(plugin_handle->cls,
ph);
plugin_handle->execute_wire_transfer_cancel
(plugin_handle->cls,
eh);
GNUNET_SCHEDULER_shutdown ();
}
}
/**
* Ask the bank to execute a wire transfer.
*/
static void
execute_wire_transfer ()
{
struct TALER_Amount a;
struct TALER_WireTransferIdentifierRawP wtid;
if (NULL == amount)
{
fprintf (stderr,
"The option -a: AMOUNT, is mandatory.\n");
GNUNET_SCHEDULER_shutdown ();
return;
}
if (GNUNET_OK != TALER_string_to_amount (amount,
&a))
{
fprintf (stderr,
"Amount string incorrect.\n");
GNUNET_SCHEDULER_shutdown ();
return;
}
if (NULL == destination_account_url)
{
fprintf (stderr,
"Please give destination"
" account URL (--destination/-d)\n");
GNUNET_SCHEDULER_shutdown ();
return;
}
if (NULL == (ph = plugin_handle->prepare_wire_transfer
(plugin_handle->cls,
account_section,
destination_account_url,
&a,
"http://exchange.example.com/",
&wtid, /* Any value will do. */
prepare_cb,
NULL)))
{
fprintf (stderr,
"Could not prepare the wire transfer\n");
GNUNET_SCHEDULER_shutdown ();
}
}
/**
* Ask the bank the list of transactions for the bank account
* mentioned in the config section given by the user.
*/
static void
execute_history ()
{
size_t bin_len = 0;
void *since_when_bin = NULL;
if (NULL != since_when)
{
bin_len = (strlen (since_when) * 5) / 8;
since_when_bin = GNUNET_malloc (bin_len);
GNUNET_assert
(GNUNET_OK == GNUNET_STRINGS_string_to_data
(since_when,
strlen (since_when),
since_when_bin,
bin_len));
}
if (NULL == (hh = plugin_handle->get_history (plugin_handle->cls,
account_section,
TALER_BANK_DIRECTION_BOTH,
since_when_bin,
bin_len,
-10,
&history_cb,
NULL)))
{
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)
{
if (NULL != hh)
{
plugin_handle->get_history_cancel (plugin_handle->cls,
hh);
hh = NULL;
}
if (NULL != ph)
{
plugin_handle->prepare_wire_transfer_cancel (plugin_handle->cls,
ph);
ph = NULL;
}
TALER_WIRE_plugin_unload (plugin_handle);
}
/**
* 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)
{
if (NULL == account_section)
{
fprintf (stderr,
"The option: -s ACCOUNT-SECTION, is mandatory.\n");
return;
}
if (GNUNET_OK != GNUNET_CONFIGURATION_get_value_string
(cfg,
account_section,
"plugin",
&plugin_name))
{
fprintf (stderr,
"Could not find the 'plugin' value under %s\n",
account_section);
return;
}
plugin_handle = TALER_WIRE_plugin_load (cfg,
plugin_name);
if (NULL == plugin_handle)
{
fprintf (stderr,
"Could not load the wire plugin\n");
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");
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_string ('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.",
&since_when),
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_string ('a',
"amount",
"AMOUNT",
"Specify the amount to transfer.",
&amount),
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 */