TALER-EXCHANGE-BENCHMARK(1)

💅 taler-exchange-benchmark — measure exchange performance ✨

okay so this page is TALER-EXCHANGE-BENCHMARK(1) from the GNU Taler fam — and it's literally the stopwatch of the exchange world, no cap 🫶

---

🌸 NAME 🌸

taler-exchange-benchmark — measure exchange performance ⏱️

---

✨ SYNOPSIS ✨

taler-exchange-benchmark
[-c CONFIG_FILENAME | --config=CONFIG_FILENAME] [-F | --reserves-first]
[-f | --fakebank] [-h | --help] [-L LOGLEVEL | --log-level=LOGLEVEL]
[-l FILENAME | --logfile=FILENAME]
[-n HOWMANY_COINS | --coins-number=HOWMANY_COINS]
[-p NPROCS | --parallelism=NPROCS] [-R RATE | --refresh-rate=RATE]
[-r N | --reserves=N] [-u SECTION | --exchange-account-section=SECTION]
[-v | --version]

---

🦋 DESCRIPTION 🦋

taler-exchange-benchmark is a command-line tool that measures the time spent to serve withdrawals/deposits/refreshes 💸 — like a vibe check but for performance, iykyk.

⚠️ Real talk before you start: the GNU Taler services must already be running at the configured addresses. The benchmark doesn't spin them up for you, bestie. It just shows up and starts timing. 😭

• -c CONFIG_FILENAME, --config=CONFIG_FILENAME — (Mandatory 💀) use CONFIG_FILENAME.
• -F, --reserves-first — create all reserves first, before starting normal operations.
• -f, --fakebank — expect to interact with a fakebank instead of libeufin.
• -h, --help — prints a compiled-in help text.
• -L LOGLEVEL, --log-level=LOGLEVEL — specifies the log level to use. Accepted values are: DEBUG, INFO, WARNING, ERROR.
• -l FILENAME, --logfile=FILENAME — send logging output to FILENAME.
• -n HOWMANY_COINS, --coins-number=HOWMANY_COINS — defaults to 1. Specifies how many coins this benchmark should withdraw and spend. After being spent, each coin will be refreshed with a probability RATE (see option --refresh-rate).
• -p NPROCS, --parallelism=NPROCS — run with NPROCS client processes.
• -R RATE, --refresh-rate=RATE — defaults to 10. Probability of refresh per coin (0-100).
• -r N, --reserves=N — create N reserves per client.
• -u SECTION, --exchange-account-section=SECTION — which configuration section should be used for the bank account of the exchange.
• -v, --version — print version information.

---

👑 SEE ALSO 👑

taler-exchange-dbinit(1), taler-exchange-offline(1), taler-merchant-benchmark(1), taler-exchange-httpd(1), taler-unified-setup(1), taler-exchange.conf(5)

---

💀 BUGS 💀

found a bug? don't suffer in silence 🫶 report it at https://bugs.taler.net/ or send electronic mail to <taler@gnu.org>.

---

🎀 AUTHOR 🎀

GNU Taler contributors — iconic behavior only 💅

---

🌈 COPYRIGHT 🌈

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

---

and that's the whole page, bestie ✨ this version is 1.0 from Dec 22, 2025, straight from TALER-EXCHANGE-BENCHMARK(1) — go benchmark something and slay 🦋💖 periodt.