History

Hernâni Marques 6a212d14c6 docs: bank shared withdraw, auto-account, merchant shop landing Document bank landing layout, demo-withdraw + auto-account APIs (goa-bank-acc-*, balance 0), explorer-only auto-confirm, QR_Taler, and merchant shop/stats behaviour. Refresh taler-bank script index.		2026-07-10 20:50:36 +02:00
..
auto-confirm-withdrawals.sh	bank: full-scale money inflation for auto-confirm the explorer bank account	2026-07-10 20:08:44 +02:00
check_bank-health.sh	bank: merchant-model start scripts + configs for taler-bank-hacktivism	2026-07-01 15:58:30 +02:00
credit-account.sh	bank: demo withdraw/credit helpers (container; no public landing yet)	2026-07-02 15:29:03 +02:00
demo-withdraw-api.py	bank: auto-account username prefix goa-bank-acc-<id>	2026-07-10 20:43:45 +02:00
install-demo-withdraw-api.sh	bank: API for auto-created personal accounts (balance zero)	2026-07-10 20:42:20 +02:00
landing-stats-install.sh	bank: landing-stats + install helpers; health/start	2026-07-09 14:25:35 +02:00
landing-stats.sh	bank: landing-stats + install helpers; health/start	2026-07-09 14:25:35 +02:00
make-demo-withdraw-qr.sh	bank: demo withdraw/credit helpers (container; no public landing yet)	2026-07-02 15:29:03 +02:00
README.md	docs: bank shared withdraw, auto-account, merchant shop landing	2026-07-10 20:50:36 +02:00
refresh-demo-withdraw.sh	bank: demo withdraw/credit helpers (container; no public landing yet)	2026-07-02 15:29:03 +02:00
start_bank.sh	bank: merchant-model start scripts + configs for taler-bank-hacktivism	2026-07-01 15:58:30 +02:00
start_base_services_for_taler_bank.sh	bank: merchant-model start scripts + configs for taler-bank-hacktivism	2026-07-01 15:58:30 +02:00

README.md

taler-bank scripts

Container: taler-hacktivism-bank (libeufin-bank, GOA, no IBAN).

File	Container path	User
`start_base_services_for_taler_bank.sh`	`/root/`	root
`start_bank.sh`	`/usr/local/bin/`	libeufin-bank
`check_bank-health.sh`	`/usr/local/bin/`	libeufin-bank / any
`landing-stats.sh`	`/usr/local/bin/`	root (in container) — writes `/var/www/bank-landing/stats.json`
`landing-stats-install.sh`	host only	root/podman — copies + runs + optional cron
`demo-withdraw-api.py`	`/usr/local/bin/`	root — loopback :19096
`install-demo-withdraw-api.sh`	host only	installs API + nginx + auto-confirm
`auto-confirm-withdrawals.sh`	`/usr/local/bin/`	root — explorer-only confirm loop
`refresh-demo-withdraw.sh`	`/usr/local/bin/`	refresh static `withdraw.uri`
`credit-account.sh`	host/ops	admin → user credit

Usage

# root in container
./start_base_services_for_taler_bank.sh
# then as libeufin-bank in /usr/local/bin:
./start_bank.sh --restart

Landing stats (inside container)

# on koopa host — copy + run (writes /var/www/bank-landing/stats.json)
./landing-stats-install.sh
./landing-stats-install.sh --cron     # every minute inside container (* * * * *)
./landing-stats-install.sh --run-only

Details + JSON schema: configs/bank-landing/README.md.

Demo withdraw + auto-account API

demo-withdraw-api.py listens on 127.0.0.1:19096 (proxied by nginx on the landing):

Path	Behaviour
`GET /demo-withdraw.json`	Mint one-shot withdraw from shared `explorer` pool; write `withdraw.uri` + watch ids
`GET /auto-account.json`	Public `POST /accounts` with generated `goa-bank-acc-<hex>` user + password; balance GOA:0; return credentials once

Install / restart:

./install-demo-withdraw-api.sh
# Public checks:
curl -sS https://bank.hacktivism.ch/intro/demo-withdraw.json | head
curl -sS https://bank.hacktivism.ch/intro/auto-account.json | head   # creates a real account

Requires python3 in the bank container. Env: BANK_URL, BANK_USER/BANK_PASS (or /root/bank-explorer-password.txt), AMOUNT (default GOA:10 for shared withdraws).

Auto-confirm (explorer only)

# loop inside container — refuses non-explorer unless ALLOW_NON_EXPLORER=1
auto-confirm-withdrawals.sh --loop 4

Only confirms withdrawals owned by explorer when status is selected (community demo path). Does not confirm arbitrary customer withdraws.

Config

See configs/taler-hacktivism-bank/ and configs/bank-landing/.