TALER-EXCHANGE...GATEWAY-CLIENT(1)

📦 version 1.3.0, in nixos 26.05, nixpkgs unstable

🎀 taler-exchange-wire-gateway-client(1) 🎀

okay so bestie, buckle up — this is the manual page for taler-exchange-wire-gateway-client from the GNU Taler fam. yes it's a long name, no we're not shortening it, it's iconic like that 💅

✨ NAME ✨

taler-exchange-wire-gateway-client — trigger a transfer at the bank 🏦💸

🌸 SYNOPSIS 🌸

taler-exchange-wire-gateway-client [-a VALUE | --amount=VALUE]
[-b URL | --bank=URL] [-C ACCOUNT | --credit=ACCOUNT]
[-c FILENAME | --config=FILENAME] [-D ACCOUNT | --debit=ACCOUNT]
[-h | --help] [-i | --credit-history]
[-L LOGLEVEL | --loglevel=LOGLEVEL] [-l FILENAME | --logfile=FILENAME]
[-o | --debit-history] [-p PASSPHRASE | --pass=PASSPHRASE]
[-S STRING | --subject=STRING]
[-s ACCOUNT-SECTION | --section=ACCOUNT-SECTION]
[-u USERNAME | --user=USERNAME] [-v | --version]
[-w ROW | --since-when=ROW]

💖 DESCRIPTION 💖

taler-exchange-wire-gateway-client is a command-line tool that lets you trigger bank transfers or inspect wire transfers for exchange accounts, all through the wire API. ngl, the manpage is very upfront about it: the tool is "expected to be used during testing or for diagnostics." so like… a lil experimental bestie, not your production main character. 🧪

the way this works: in one invocation you can do one of these four operations, periodt:

  1. Execute a wire transfer from the exchange to a consumer account (-C). 💸
  2. Execute a wire transfer from a consumer account to the exchange (-D). 💸
  3. Inspect the credit history of the exchange (-i). 🔍
  4. Inspect the debit history of the exchange (-o). 🔍
⚠️ doing more than one of these at a time will result in an error. no multitasking, it's giving "one thing at a time" energy 😭

but wait — plot twist: the -C and -D options can also be used as filters on transaction history operations. so they double as vibes-check tools, iykyk. ✨

👑 OPTIONS 👑

  • -a VALUE, --amount=VALUE — the amount to transfer, given in the Taler-typical format of CURRENCY:VALUE.FRACTION. 🪙
  • -b URL, --bank=URL — the URL at which the bank is operation. Conflicts with -s. 🏦
  • -C ACCOUNT, --credit=ACCOUNT — when doing a wire transfer from the exchange, the money should be credited to ACCOUNT. specifies the payto:// URI of the account. also usable as a filter by credit account when you're looking at transaction histories. 💖
  • -c FILENAME, --config=FILENAME — use the given configuration file. 📄
  • -D ACCOUNT, --debit=ACCOUNT — when doing a wire transfer to the exchange, ACCOUNT is the one being debited. specifies the payto:// URI of the account. also usable as a filter by debit account when you're looking at transaction histories. 💜
  • -h, --help — print short help on options. 🫶
  • -i, --credit-history — obtain the credit history of the exchange. Conflicts with -o. 🔍
  • -L LOGLEVEL, --loglevel=LOGLEVEL — specifies the log level to use. accepted values are: DEBUG, INFO, WARNING, ERROR. 🪵
  • -l FILENAME, --logfile=FILENAME — send logging output to FILENAME. 📝
  • -o, --debit-history — obtain the debit history of the exchange. Conflicts with -i. 🔍
  • -p PASSPHRASE, --pass=PASSPHRASE — specifies the pass phrase for authentication. Conflicts with -s. 🔑
  • -S SUBJECT, --subject=SUBJECT — use SUBJECT for the wire transfer subject. must be a reserve public key for credit operations and a wire transfer identifier for debit operations. if not specified, a random value will be generated instead. 🎲
  • -s ACCOUNT_SECTION, --section=ACCOUNT-SECTION — obtain exchange account information from the ACCOUNT-SECTION of the configuration. the argument must be a [exchange-accountcredentials-$NAME] section name and thus start with the exchange-accountcredentials- prefix. Conflicts with -u, -p and -b. note that either -b or -s must be specified. 🗂️
  • -u USERNAME, --user=USERNAME — specifies the username for authentication. optional, and conflicts with -s. if neither -u nor -s are used, we will attempt to talk to the bank without authentication. 🙈
  • -v, --version — print version information. 💫
  • -w ROW, --since-when=ROW — specifies a ROW from which the history should be obtained. if not given, the 10 youngest transactions are returned. 🕰️

🦋 SEE ALSO 🦋

💀 BUGS 💀

report bugs by using https://bugs.taler.net/ or by sending electronic mail to <taler@gnu.org> 📬

🌸 AUTHOR 🌸

GNU Taler contributors 🫶

2014-2025 Taler Systems SA (GPLv3+ or GFDL 1.3+) 👑

alright bestie, that's the whole page, no notes, nothing skipped, we ate and left no crumbs 🍓✨ this was version 1.0, dated Dec 22, 202… (the year got cut off in my copy, sobbing 😭), and it's brought to you by the GNU Taler girlies. mwah 💋🎀🦋

📦 where this page comes from