bank landing: document community pool funding path

This commit is contained in:
Hernâni Marques 2026-07-10 20:13:00 +02:00
parent 31c8dcdb9c
commit d7686b1dea
No known key found for this signature in database

View file

@ -13,15 +13,26 @@ open your own bank account, and point merchants at `taler.hacktivism.ch`.
## User flow (documented on the page) ## User flow (documented on the page)
Same **one-step** pattern as [taler-ops.ch Android/iOS guides](https://taler-ops.ch/en/users-android.html): ### Primary path (works without your own bank account)
1. **Install wallet** — Android (Play Store / F-Droid) and iOS (App Store), plus hub `wallet.taler.net`. 1. **Install wallet** — Android (Play Store / F-Droid) and iOS (App Store), plus hub `wallet.taler.net`.
2. **One QR / link**`taler://withdraw-exchange/exchange.hacktivism.ch/` 2. **One QR / link** — live `taler://withdraw/…` from the **community-shared** bank pool (`explorer`).
Adds the GOA exchange **and** starts withdrawal (accept ToS → enter amount). Minted via `GET /intro/demo-withdraw.json` (or fallback `withdraw.uri`).
Auto-confirm finishes the bank side so coins reach the wallet.
The old two-step path (`taler://add-exchange/…` + demo `taler://withdraw/…` from `withdraw.uri`) is **removed** from the landing. ### Optional paths
Optional: bank UI (`/webui/`) and merchant (`taler.hacktivism.ch`) stay further down. - **Own bank account** — register in `/webui/`, then withdraw (private balance).
- **`taler://withdraw-exchange/…`** — only useful if you already have a bank balance to withdraw from.
### How it works (community pool)
1. Shared account `explorer` is pre-funded with GOA.
2. Each click creates a **one-shot** withdrawal from that pool (not a personal login).
3. Wallet accepts the URI; bank auto-confirm + exchange settle → coins in the app.
4. Balance is **shared**; demo amounts only.
Helpers: `scripts/taler-bank/demo-withdraw-api.py`, `refresh-demo-withdraw.sh`, `auto-confirm-withdrawals.sh`, `install-demo-withdraw-api.sh`.
### CLI sketch (fresh wallet DB) ### CLI sketch (fresh wallet DB)