/*
This file is part of TALER
Copyright (C) 2017-2023 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-exchange-wire-gateway-client.c
* @brief Execute wire transfer.
* @author Christian Grothoff
*/
#include "platform.h"
#include
#include
#include
#include "taler_bank_service.h"
/**
* If set to #GNUNET_YES, then we'll ask the bank for a list
* of incoming transactions from the account.
*/
static int incoming_history;
/**
* If set to #GNUNET_YES, then we'll ask the bank for a list
* of outgoing transactions from the account.
*/
static int outgoing_history;
/**
* Amount to transfer.
*/
static struct TALER_Amount amount;
/**
* Credit account payto://-URI.
*/
static char *credit_account;
/**
* Debit account payto://-URI.
*/
static char *debit_account;
/**
* Wire transfer subject.
*/
static char *subject;
/**
* Which config section has the credentials to access the bank.
*/
static char *account_section;
/**
* Starting row.
*/
static unsigned long long start_row = UINT64_MAX;
/**
* Authentication data.
*/
static struct TALER_BANK_AuthenticationData auth;
/**
* Return value from main().
*/
static int global_ret = 1;
/**
* Main execution context for the main loop.
*/
static struct GNUNET_CURL_Context *ctx;
/**
* Handle to ongoing credit history operation.
*/
static struct TALER_BANK_CreditHistoryHandle *chh;
/**
* Handle to ongoing debit history operation.
*/
static struct TALER_BANK_DebitHistoryHandle *dhh;
/**
* Handle for executing the wire transfer.
*/
static struct TALER_BANK_TransferHandle *eh;
/**
* Handle to access the exchange.
*/
static struct TALER_BANK_AdminAddIncomingHandle *op;
/**
* Context for running the CURL event loop.
*/
static struct GNUNET_CURL_RescheduleContext *rc;
/**
* Function run when the test terminates (good or bad).
* Cleans up our state.
*
* @param cls NULL
*/
static void
do_shutdown (void *cls)
{
(void) cls;
if (NULL != op)
{
TALER_BANK_admin_add_incoming_cancel (op);
op = NULL;
}
if (NULL != chh)
{
TALER_BANK_credit_history_cancel (chh);
chh = NULL;
}
if (NULL != dhh)
{
TALER_BANK_debit_history_cancel (dhh);
dhh = NULL;
}
if (NULL != eh)
{
TALER_BANK_transfer_cancel (eh);
eh = NULL;
}
if (NULL != ctx)
{
GNUNET_CURL_fini (ctx);
ctx = NULL;
}
if (NULL != rc)
{
GNUNET_CURL_gnunet_rc_destroy (rc);
rc = NULL;
}
TALER_BANK_auth_free (&auth);
}
/**
* Callback used to process the transaction
* history returned by the bank.
*
* @param cls closure
* @param reply response we got from the bank
*/
static void
credit_history_cb (void *cls,
const struct TALER_BANK_CreditHistoryResponse *reply)
{
(void) cls;
chh = NULL;
switch (reply->http_status)
{
case 0:
fprintf (stderr,
"Failed to obtain HTTP reply from `%s'\n",
auth.wire_gateway_url);
global_ret = 2;
break;
case MHD_HTTP_NO_CONTENT:
fprintf (stdout,
"No transactions.\n");
global_ret = 0;
break;
case MHD_HTTP_OK:
for (unsigned int i = 0; idetails.ok.details_length; i++)
{
const struct TALER_BANK_CreditDetails *cd =
&reply->details.ok.details[i];
/* If credit/debit accounts were specified, use as a filter */
if ( (NULL != credit_account) &&
(0 != strcasecmp (credit_account,
reply->details.ok.credit_account_uri) ) )
continue;
if ( (NULL != debit_account) &&
(0 != strcasecmp (debit_account,
cd->debit_account_uri) ) )
continue;
fprintf (stdout,
"%llu: %s->%s (%s) over %s at %s\n",
(unsigned long long) cd->serial_id,
cd->debit_account_uri,
reply->details.ok.credit_account_uri,
TALER_B2S (&cd->reserve_pub),
TALER_amount2s (&cd->amount),
GNUNET_TIME_timestamp2s (cd->execution_date));
}
global_ret = 0;
break;
default:
fprintf (stderr,
"Failed to obtain credit history from `%s': HTTP status %u (%s)\n",
auth.wire_gateway_url,
reply->http_status,
TALER_ErrorCode_get_hint (reply->ec));
if (NULL != reply->response)
json_dumpf (reply->response,
stderr,
JSON_INDENT (2));
global_ret = 2;
break;
}
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_credit_history (void)
{
if (NULL != subject)
{
fprintf (stderr,
"Specifying subject is not supported when inspecting credit history\n");
GNUNET_SCHEDULER_shutdown ();
return;
}
chh = TALER_BANK_credit_history (ctx,
&auth,
start_row,
-10,
GNUNET_TIME_UNIT_ZERO,
&credit_history_cb,
NULL);
if (NULL == chh)
{
fprintf (stderr,
"Could not request the credit transaction history.\n");
GNUNET_SCHEDULER_shutdown ();
return;
}
}
/**
* Function with the debit transaction history.
*
* @param cls closure
* @param reply response details
*/
static void
debit_history_cb (void *cls,
const struct TALER_BANK_DebitHistoryResponse *reply)
{
(void) cls;
dhh = NULL;
switch (reply->http_status)
{
case 0:
fprintf (stderr,
"Failed to obtain HTTP reply from `%s'\n",
auth.wire_gateway_url);
global_ret = 2;
break;
case MHD_HTTP_NO_CONTENT:
fprintf (stdout,
"No transactions.\n");
global_ret = 0;
break;
case MHD_HTTP_OK:
for (unsigned int i = 0; idetails.ok.details_length; i++)
{
const struct TALER_BANK_DebitDetails *dd =
&reply->details.ok.details[i];
/* If credit/debit accounts were specified, use as a filter */
if ( (NULL != credit_account) &&
(0 != strcasecmp (credit_account,
dd->credit_account_uri) ) )
continue;
if ( (NULL != debit_account) &&
(0 != strcasecmp (debit_account,
reply->details.ok.debit_account_uri) ) )
continue;
fprintf (stdout,
"%llu: %s->%s (%s) over %s at %s\n",
(unsigned long long) dd->serial_id,
reply->details.ok.debit_account_uri,
dd->credit_account_uri,
TALER_B2S (&dd->wtid),
TALER_amount2s (&dd->amount),
GNUNET_TIME_timestamp2s (dd->execution_date));
}
global_ret = 0;
break;
default:
fprintf (stderr,
"Failed to obtain debit history from `%s': HTTP status %u (%s)\n",
auth.wire_gateway_url,
reply->http_status,
TALER_ErrorCode_get_hint (reply->ec));
if (NULL != reply->response)
json_dumpf (reply->response,
stderr,
JSON_INDENT (2));
global_ret = 2;
break;
}
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_debit_history (void)
{
if (NULL != subject)
{
fprintf (stderr,
"Specifying subject is not supported when inspecting debit history\n");
GNUNET_SCHEDULER_shutdown ();
return;
}
dhh = TALER_BANK_debit_history (ctx,
&auth,
start_row,
-10,
GNUNET_TIME_UNIT_ZERO,
&debit_history_cb,
NULL);
if (NULL == dhh)
{
fprintf (stderr,
"Could not request the debit transaction history.\n");
GNUNET_SCHEDULER_shutdown ();
return;
}
}
/**
* Callback that processes the outcome of a wire transfer
* execution.
*
* @param cls closure
* @param tr response details
*/
static void
confirmation_cb (void *cls,
const struct TALER_BANK_TransferResponse *tr)
{
(void) cls;
eh = NULL;
if (MHD_HTTP_OK != tr->http_status)
{
fprintf (stderr,
"The wire transfer didn't execute correctly (%u/%d).\n",
tr->http_status,
tr->ec);
GNUNET_SCHEDULER_shutdown ();
return;
}
fprintf (stdout,
"Wire transfer #%llu executed successfully at %s.\n",
(unsigned long long) tr->details.ok.row_id,
GNUNET_TIME_timestamp2s (tr->details.ok.timestamp));
global_ret = 0;
GNUNET_SCHEDULER_shutdown ();
}
/**
* Ask the bank to execute a wire transfer.
*/
static void
execute_wire_transfer (void)
{
struct TALER_WireTransferIdentifierRawP wtid;
void *buf;
size_t buf_size;
char *params;
if (NULL != debit_account)
{
fprintf (stderr,
"Invalid option -C specified, conflicts with -D\n");
GNUNET_SCHEDULER_shutdown ();
return;
}
/* See if subject was given as a payto-parameter. */
if (NULL == subject)
subject = TALER_payto_get_subject (credit_account);
if (NULL != subject)
{
if (GNUNET_OK !=
GNUNET_STRINGS_string_to_data (subject,
strlen (subject),
&wtid,
sizeof (wtid)))
{
fprintf (stderr,
"Error: wire transfer subject must be a WTID\n");
GNUNET_SCHEDULER_shutdown ();
return;
}
}
else
{
/* pick one at random */
GNUNET_CRYPTO_random_block (GNUNET_CRYPTO_QUALITY_NONCE,
&wtid,
sizeof (wtid));
}
params = strchr (credit_account,
(unsigned char) '&');
if (NULL != params)
*params = '\0';
TALER_BANK_prepare_transfer (credit_account,
&amount,
"http://exchange.example.com/",
&wtid,
&buf,
&buf_size);
eh = TALER_BANK_transfer (ctx,
&auth,
buf,
buf_size,
&confirmation_cb,
NULL);
GNUNET_free (buf);
if (NULL == eh)
{
fprintf (stderr,
"Could not execute the wire transfer\n");
GNUNET_SCHEDULER_shutdown ();
return;
}
}
/**
* Function called with the result of the operation.
*
* @param cls closure
* @param air response details
*/
static void
res_cb (void *cls,
const struct TALER_BANK_AdminAddIncomingResponse *air)
{
(void) cls;
op = NULL;
switch (air->http_status)
{
case MHD_HTTP_OK:
global_ret = 0;
fprintf (stdout,
"%llu\n",
(unsigned long long) air->details.ok.serial_id);
break;
default:
fprintf (stderr,
"Operation failed with status code %u/%u\n",
(unsigned int) air->ec,
air->http_status);
if (NULL != air->response)
json_dumpf (air->response,
stderr,
JSON_INDENT (2));
break;
}
GNUNET_SCHEDULER_shutdown ();
}
/**
* Ask the bank to execute a wire transfer to the exchange.
*/
static void
execute_admin_transfer (void)
{
struct TALER_ReservePublicKeyP reserve_pub;
if (NULL != subject)
{
if (GNUNET_OK !=
GNUNET_STRINGS_string_to_data (subject,
strlen (subject),
&reserve_pub,
sizeof (reserve_pub)))
{
fprintf (stderr,
"Error: wire transfer subject must be a reserve public key\n");
return;
}
}
else
{
/* pick one that is kind-of well-formed at random */
GNUNET_CRYPTO_random_block (GNUNET_CRYPTO_QUALITY_NONCE,
&reserve_pub,
sizeof (reserve_pub));
}
op = TALER_BANK_admin_add_incoming (ctx,
&auth,
&reserve_pub,
&amount,
debit_account,
&res_cb,
NULL);
if (NULL == op)
{
fprintf (stderr,
"Could not execute the wire transfer to the exchange\n");
GNUNET_SCHEDULER_shutdown ();
return;
}
}
/**
* 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;
(void) cfg;
GNUNET_SCHEDULER_add_shutdown (&do_shutdown,
NULL);
ctx = GNUNET_CURL_init (&GNUNET_CURL_gnunet_scheduler_reschedule,
&rc);
GNUNET_assert (NULL != ctx);
rc = GNUNET_CURL_gnunet_rc_create (ctx);
if (NULL != account_section)
{
if (0 != strncasecmp ("exchange-accountcredentials-",
account_section,
strlen ("exchange-accountcredentials-")))
{
fprintf (stderr,
"Error: invalid section specified, must begin with `%s`\n",
"exchange-accountcredentials-");
GNUNET_SCHEDULER_shutdown ();
return;
}
if ( (NULL != auth.wire_gateway_url) ||
(NULL != auth.details.basic.username) ||
(NULL != auth.details.basic.password) )
{
fprintf (stderr,
"Error: Conflicting authentication options provided. Please only use one method.\n");
GNUNET_SCHEDULER_shutdown ();
return;
}
if (GNUNET_OK !=
TALER_BANK_auth_parse_cfg (cfg,
account_section,
&auth))
{
fprintf (stderr,
"Error: Authentication information not found in configuration section `%s'\n",
account_section);
GNUNET_SCHEDULER_shutdown ();
return;
}
}
else
{
if ( (NULL != auth.wire_gateway_url) &&
(NULL != auth.details.basic.username) &&
(NULL != auth.details.basic.password) )
{
auth.method = TALER_BANK_AUTH_BASIC;
}
else if (NULL == auth.wire_gateway_url)
{
fprintf (stderr,
"Error: No account specified (use -b or -s options).\n");
GNUNET_SCHEDULER_shutdown ();
return;
}
}
if ( (NULL == auth.wire_gateway_url) ||
(0 == strlen (auth.wire_gateway_url)) ||
(0 != strncasecmp ("http",
auth.wire_gateway_url,
strlen ("http"))) )
{
fprintf (stderr,
"Error: Invalid wire gateway URL `%s' configured.\n",
auth.wire_gateway_url);
GNUNET_SCHEDULER_shutdown ();
return;
}
if ( (GNUNET_YES == incoming_history) &&
(GNUNET_YES == outgoing_history) )
{
fprintf (stderr,
"Error: Please specify only -i or -o, but not both.\n");
GNUNET_SCHEDULER_shutdown ();
return;
}
if (GNUNET_YES == incoming_history)
{
execute_credit_history ();
return;
}
if (GNUNET_YES == outgoing_history)
{
execute_debit_history ();
return;
}
if (NULL != credit_account)
{
execute_wire_transfer ();
return;
}
if (NULL != debit_account)
{
execute_admin_transfer ();
return;
}
GNUNET_log (GNUNET_ERROR_TYPE_WARNING,
"No operation specified.\n");
global_ret = 0;
GNUNET_SCHEDULER_shutdown ();
}
/**
* The main function of the taler-exchange-wire-gateway-client
*
* @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)
{
const struct GNUNET_GETOPT_CommandLineOption options[] = {
TALER_getopt_get_amount ('a',
"amount",
"VALUE",
"value to transfer",
&amount),
GNUNET_GETOPT_option_string ('b',
"bank",
"URL",
"Wire gateway URL to use to talk to the bank",
&auth.wire_gateway_url),
GNUNET_GETOPT_option_string ('C',
"credit",
"ACCOUNT",
"payto URI of the bank account to credit (when making outgoing transfers)",
&credit_account),
GNUNET_GETOPT_option_string ('D',
"debit",
"PAYTO-URL",
"payto URI of the bank account to debit (when making incoming transfers)",
&debit_account),
GNUNET_GETOPT_option_flag ('i',
"credit-history",
"Ask to get a list of 10 incoming transactions.",
&incoming_history),
GNUNET_GETOPT_option_flag ('o',
"debit-history",
"Ask to get a list of 10 outgoing transactions.",
&outgoing_history),
GNUNET_GETOPT_option_string ('p',
"pass",
"PASSPHRASE",
"passphrase to use for authentication",
&auth.details.basic.password),
GNUNET_GETOPT_option_string ('s',
"section",
"ACCOUNT-SECTION",
"Which config section has the credentials to access the bank. Conflicts with -b -u and -p options.\n",
&account_section),
GNUNET_GETOPT_option_string ('S',
"subject",
"SUBJECT",
"specifies the wire transfer subject",
&subject),
GNUNET_GETOPT_option_string ('u',
"user",
"USERNAME",
"username to use for authentication",
&auth.details.basic.username),
GNUNET_GETOPT_option_ulong ('w',
"since-when",
"ROW",
"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_END
};
enum GNUNET_GenericReturnValue ret;
/* force linker to link against libtalerutil; if we do
not do this, the linker may "optimize" libtalerutil
away and skip #TALER_OS_init(), which we do need */
(void) TALER_project_data_default ();
if (GNUNET_OK !=
GNUNET_STRINGS_get_utf8_args (argc, argv,
&argc, &argv))
return 4;
global_ret = 1;
ret = GNUNET_PROGRAM_run (
argc, argv,
"taler-wire-gateway-client",
gettext_noop ("Client tool of the Taler Wire Gateway"),
options,
&run, NULL);
GNUNET_free_nz ((void *) argv);
if (GNUNET_SYSERR == ret)
return 3;
if (GNUNET_NO == ret)
return 0;
return global_ret;
}
/* end taler-wire-gateway-client.c */