From d7686b1dea9f05e6192482cfb5ec047643f60425 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Hern=C3=A2ni=20Marques?= Date: Fri, 10 Jul 2026 20:13:00 +0200 Subject: [PATCH] bank landing: document community pool funding path --- configs/bank-landing/README.md | 21 ++++++++++++++++----- 1 file changed, 16 insertions(+), 5 deletions(-) diff --git a/configs/bank-landing/README.md b/configs/bank-landing/README.md index 3b4f960..7243b92 100644 --- a/configs/bank-landing/README.md +++ b/configs/bank-landing/README.md @@ -13,15 +13,26 @@ open your own bank account, and point merchants at `taler.hacktivism.ch`. ## 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`. -2. **One QR / link** — `taler://withdraw-exchange/exchange.hacktivism.ch/` - Adds the GOA exchange **and** starts withdrawal (accept ToS → enter amount). +2. **One QR / link** — live `taler://withdraw/…` from the **community-shared** bank pool (`explorer`). + 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)