commit 4198ebf8a5a9f2ab7c8e85bee839eaf21add4770
parent 680d497494e2ceb9fe8b74390b5434d07c930f17
Author: Christian Grothoff <christian@grothoff.org>
Date: Wed, 27 Mar 2024 20:01:33 +0100
Fix #8666
Diffstat:
1 file changed, 30 insertions(+), 1 deletion(-)
diff --git a/draft-grothoff-taler.xml b/draft-grothoff-taler.xml
@@ -437,9 +437,37 @@ also <xref target="taler-registry" />).
</t>
</section>
+<section anchor="registry-entry-add-exchange" title="Action: add-exchange">
+ <t>
+ An "add-exchange" action instructs the wallet to add an exchange to its list of
+ exchanges, download its meta data ("/config"), check that it is compatible with
+ the wallet, and if it is a new exchange, ask the user to agree to the
+ terms of service of the exchange. If the user agrees to the terms,
+ the currency of the exchange should be added to the list of currencies.
+ </t>
+ <t>
+ The specific arguments of an "add-exchange" action are:
+ <list style="symbols">
+ <t>exchange_host: hostname of the exchange (possibly including a port number)</t>
+ <t>exchange_prefix_path (optional): list of path components that identifies the path prefix of the exchange base URL</t>
+ </list>
+</t>
+<t>
+<list style="symbols">
+<t>Name: add-exchange</t>
+<t>Syntax: taler://add-exchange/{exchange_host}{/exchange_prefix_path*}/</t>
+<t>Example: taler://add-exchange/exchange.example.com/</t>
+<t>Example: taler://add-exchange/exchanges.example.com/api/</t>
+<t>Contact: N/A</t>
+<t>References: [this.I-D]</t>
+</list>
+</t>
+</section>
+
+
<section anchor="registry-entry-withdraw-exchange" title="Action: withdraw-exchange">
<t>
- An "withdraw-exchange" action instructs the wallet to display a prompt to the user, asking
+ A "withdraw-exchange" action instructs the wallet to display a prompt to the user, asking
the user to confirm/decline withdrawing from the exchange. The amount to be withdraw MAY be
specified in the URI with the "amount" parameter and this SHOULD be used as suggested input
for the withdraw. The user MUST accept the ToS and select the correct amount before starting
@@ -531,6 +559,7 @@ dots and dashes)</t>
pay-template | N/A | [This.I-D]
restore | N/A | [This.I-D]
dev-experiment | N/A | [This.I-D]
+ add-exchange | N/A | [This.I-D]
withdraw-exchange | N/A | [This.I-D]
</artwork>
</figure>
