taler-docs

commit e4c7785eba4122ff2a841c3fbc2b4ad95ff228c4
parent cc2d4aa96753b7cbf63175a06ae1c493a3e60466
Author: Florian Dold <florian@dold.me>
Date:   Mon,  7 Sep 2026 15:55:25 +0200

DD103: add /link path

Diffstat:
M
design-documents/103-https-wallet-links.rst
 | 
17
++++++++++-------

1 file changed, 10 insertions(+), 7 deletions(-)
diff --git a/design-documents/103-https-wallet-links.rst b/design-documents/103-https-wallet-links.rst
@@ -31,15 +31,15 @@ Proposed Solution
 =================
 
 In addition to ``taler://`` URIs, wallets also register themselves as handlers
-for ``https://wallet.taler.net/#``. The taler action is provided
+for ``https://wallet.taler.net/link/#``. The taler action is provided
 after the ``#``. These ``https://`` URLs are directly
 mapped to ``taler://`` URIs and interpreted by the wallet:
 
 The following URLs
 
-* ``https://wallet.taler.net/#taler://${action}/${rest}``
-* ``https://wallet.taler.net/#/${action}/${rest}``
-* ``https://wallet.taler.net/#${action}/${rest}``
+* ``https://wallet.taler.net/link#taler://${action}/${rest}``
+* ``https://wallet.taler.net/link#/${action}/${rest}``
+* ``https://wallet.taler.net/link#${action}/${rest}``
 
 are all mapped to ``taler://${action}/${rest}``.
 
@@ -53,7 +53,7 @@ Security Considerations
 * If ``https:/wallet.taler.net/`` is compromised, an attacker
   can intercept ``taler://`` URIs on a devices that does **not**
   already have a wallet installed.
-* Using ``https://wallet.taler.net/`` links consistently on Websites would
+* Using ``https://wallet.taler.net/link#...`` links consistently on Websites would
   allow the WebExtension wallet to run with considerably less broad
   permissions.
 
@@ -63,7 +63,7 @@ Ecosystem Considerations
 * We can allow developers of alternative Taler wallets
   to register themselves on Android / iOS.
 * For F-Droid, packages are signed with the F-Droid key anyway, so allowing
-  this key to handle ``https://wallet.taler.net/`` would allow alternative
+  this key to handle ``https://wallet.taler.net/link`` would allow alternative
   Taler wallet implementations on F-Droid automatically.
 
 Alternatives
@@ -84,10 +84,13 @@ Alternatives
 Discussion / Q&A
 ================
 
-* Why use ``https://wallet.taler.net/``?
+* Why use ``https://wallet.taler.net/link``?
   
   * The link is easily recognizeable as a link for the Taler wallet.
 
+  * The words ``link``, ``wallet``, ``taler`` and ``net`` are relatively
+    well-known even in other languages.
+
   * When no wallet is installed, this is exactly the location we want the user
     to be navigated to, as it asks the user to install a wallet