specification update for #8000 / exchange protocol v19

1 files changed, 25 insertions, 4 deletions

diff --git a/core/api-exchange.rst b/core/api-exchange.rst
index 429170ce..b8979520 100644
--- a/core/api-exchange.rst
+++ b/core/api-exchange.rst
@@ -62,7 +62,7 @@ possibly by using HTTPS.
   as well as the list of possible KYC requirements.  This endpoint is largely
   for the SPA for AML officers. Merchants should use ``/keys`` which also
   contains the protocol version and currency.
-  This specification corresponds to ``current`` protocol being version **18**.
+  This specification corresponds to ``current`` protocol being **v19**.
 
   **Response:**
 
@@ -81,7 +81,7 @@ possibly by using HTTPS.
       name: "taler-exchange";
 
       // URN of the implementation (needed to interpret 'revision' in version).
-      // @since v18, may become mandatory in the future.
+      // @since **v18**, may become mandatory in the future.
       implementation?: string;
 
       // Currency supported by this exchange, given
@@ -103,7 +103,7 @@ possibly by using HTTPS.
       name: string;
 
       // Code of the currency.
-      // Deprecated in protocol v18 for the exchange
+      // Deprecated in protocol **v18** for the exchange
       // and in protocol v6 for the merchant.
       currency: string;
 
@@ -197,7 +197,7 @@ possibly by using HTTPS.
 
       // Set to true if this exchange allows the use
       // of reserves for rewards.
-      // @deprecated in protocol v18.
+      // @deprecated in protocol **v18**.
       rewards_allowed: false;
 
       // EdDSA master public key of the exchange, used to sign entries
@@ -282,6 +282,17 @@ possibly by using HTTPS.
       // a `TALER_MasterWireDetailsPS`
       // with purpose ``TALER_SIGNATURE_MASTER_WIRE_DETAILS``.
       master_sig: EddsaSignature;
+
+      // Display label wallets should use to show this
+      // bank account.
+      // Since protocol **v19**.
+      bank_label?: string;
+
+      // *Signed* integer with the display priority for
+      // this bank account. Optional, 0 if missing.
+      // Since protocol **v19**.
+      priority?: Integer;
+
     }
 
   .. ts:def:: AccountRestriction
@@ -1102,6 +1113,16 @@ Management operations authorized by master key
       // become active immediately! Used ONLY to detect replay attacks.
       validity_start: Timestamp;
 
+      // Display label wallets should use to show this
+      // bank account.
+      // Since protocol **v19**.
+      bank_label?: string;
+
+      // *Signed* integer with the display priority for
+      // this bank account.
+      // Since protocol **v19**.
+      priority?: Integer;
+
     }
 
 .. http:post:: /management/wire/disable