TALER-EXCHANGE-AGGREGATOR(1)

📦 version 1.3.0, in nixos 26.05, nixpkgs unstable

💸 TALER-EXCHANGE-AGGREGATOR(1) 💸

okay so bestie, welcome to the GNU Taler corner of the manual-verse — this one's the taler-exchange-aggregator page and honestly it's kind of a vibe ✨

🌸 NAME 🌸

taler-exchange-aggregator — the little tool that aggregates deposits into wire transfers, no cap 🫶

🦋 SYNOPSIS 🦋

taler-exchange-aggregator [-c FILENAME | --config=FILENAME]
[-h | --help] [-L LOGLEVEL | --loglevel=LOGLEVEL]
[-l FILENAME | --logfile=FILENAME] [-T USEC | --timetravelUSEC]
[-t | --test] [-v | --version] [-y | --kyc-off]

👑 DESCRIPTION 👑

taler-exchange-aggregator is a command-line tool, and its whole main character job is to run aggregate deposits to the same merchant into larger wire transfers. So like, all those tiny deposits from the same person? They get bundled up into one big glow-up wire transfer 💅. The actual transfers themselves are then done by taler-exchange-transfer — that's a whole other tool, she's got her own page, iykyk.

The AGGREGATOR_SHARD_SIZE option can be used to allow multiple aggregator processes to run in parallel and share the load. That's only recommended if a single aggregator is insufficient for the workload — like, pls don't overcomplicate it if one is doing fine fr fr.

⚠️ okay this part matters, listen up: the aggregator uses a special table to lock shards it is working on. If an aggregator process dies (say due to a power failure), these shard locks may prevent the aggregator from resuming normally. And in that case? You must run taler-exchange-dbinit -s to release the shard locks before restarting the aggregator. Not optional, bestie 😭

✨ the options, let's get into it ✨

  • -c FILENAME, --config=FILENAME — Use the configuration and other resources for the exchange to operate from FILENAME. That's the whole personality right there 🎀
  • -h, --help — Print short help on options. Short and sweet, we love a low-effort icon 🫶
  • -L LOGLEVEL, --loglevel=LOGLEVEL — Specifies the log level to use. Accepted values are: DEBUG, INFO, WARNING, ERROR. Pick your era 💜
  • -l FILENAME, --logfile=FILENAME — Send logging output to FILENAME. Diary entries, but make it sysadmin 📓
  • -T USEC, --timetravel=USEC — Modify the system time by USEC microseconds. USEC may be prefixed with + or - (e.g. -T +300). This option is intended for debugging/testing only. It literally time travels, we stan a dramatic queen 🕰️✨
  • -t, --test — Run in test mode and exit when idle. Like, she does her little tasks and then she's out 💀
  • -v, --version — Print version information. Identity check! 🪞
  • -y, --kyc-off — Run without KYC checks. Talk with your regulator before using this option. Like actually, this is a "call your lawyer first" situation, not a "yolo" situation 🙈

🌈 SEE ALSO 🌈

the whole friend group, go read their pages too 💖

💀 BUGS 💀

Report bugs by using https://bugs.taler.net/ or by sending electronic mail to taler@gnu.org. Found a bug? Tell on it, gently, with receipts 🧚

⭐ AUTHOR ⭐

GNU Taler contributors — a whole collective of icons 👑

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

and that's the page!! 💅 tiny lil sign-off from me to you: this is version 1.0, dated Dec 22, 2025, and it's TALER-EXCHANGE-AGGREGATOR(1) all day long. go aggregate those deposits, bestie — slay 🔥🦋🎀

📦 where this page comes from