TALER-MERCHANT-BENCHMARK(1)

📦 version 1.3.0, in nixos 26.05, nixpkgs unstable

💅 TALER-MERCHANT-BENCHMARK(1) 💅

ok so bestie, this one lives in the GNU Taler manual, and it's genuinely such a useful little gremlin of a tool. Let's get into it 💖

✨ NAME ✨

taler-merchant-benchmark — literally the tool that generates Taler-style benchmarking payments for you 🎀

🌸 SYNOPSIS 🌸

taler-merchant-benchmark [subcommand] [options]

🦋 DESCRIPTION 🦋

taler-merchant-benchmark is a command-line tool that populates your merchant database with payments, specifically for benchmarking. that's it, that's the whole job, and it does it so well 👑

🎀 SUBCOMMANDS 🎀

  • ordinary — generates normal payments: every single payment gets performed (by the default instance, no cap) and then aggregated by the exchange. takes this one option:
    • -p PN, --payments-number=PN — perform PN many payments. defaults to 1.
  • corner — drives the generator into unusual situations, like for example leaving payments unaggregated, or using a non-default merchant instance. this is the chaos-mode subcommand fr fr. takes these options:
    • -t TC, --two-coins=TC — perform TC many payments that use two coins (normally, all the payments use only one coin, so this is the spicy version 🌶️). TC defaults to 1.
    • -u UN, --unaggregated-number=UN — generate UN payments that will be left unaggregated.
⚠️ heads up bestie: note that subsequent invocations of the generator may pick those unaggregated payments and actually aggregate them. so like, they're not permanently unaggregated, they're just unaggregated for now, iykyk 😭

💜 COMMON OPTIONS 💜

  • -a APIKEY, --apikey=APIKEY — the HTTP Authorization header to send to the merchant. your little VIP pass 🎟️
  • -c FILENAME, --config=FILENAME — use the configuration and other resources for the merchant to operate from FILENAME.
  • -u SECTION, --exchange-account-section=SECTION — the configuration SECTION specifying the exchange account to use. (yes, -u shows up twice in this page with two totally different meanings — corner subcommand takes UN, this takes SECTION. iconic of them honestly 💀)
  • -h, --help — print short help on options. your safety net 🫶
  • -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.
  • -v, --version — print version information ⭐

🔥 SEE ALSO 🔥

taler-merchant-dbinit(1), taler-merchant.conf(5)

💀 BUGS 💀

report bugs by using https://bugs.taler.net/ or by sending electronic mail to <taler@gnu.org>. they genuinely want to hear from you, no gatekeeping 🌈

👑 AUTHOR 👑

GNU Taler contributors 🫶

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

ok and that's the whole thing, bestie — version 1.0, dated Dec 22, 2025, from the GNU Taler crew 💖 go benchmark something gorgeous, you've got this ✨🍓

📦 where this page comes from