taler-docs

commit cea05d8bd8e7c39a7e909463d4dd840d4dd3d2e3
parent cdcbf16507936e91b5649957ecaaf27032c501f6
Author: Christian Grothoff <christian@grothoff.org>
Date:   Thu,  8 Feb 2024 16:32:54 +0100

document auditor API changes

Diffstat:
M
core/api-auditor.rst
 | 
7
++++++-
M
manpages/taler.conf.5.rst
 | 
4
+++-

2 files changed, 9 insertions(+), 2 deletions(-)
diff --git a/core/api-auditor.rst b/core/api-auditor.rst
@@ -56,7 +56,7 @@ know-your-customer (KYC) registration before issuing contracts.
 .. http:get:: /config
 
   Get the protocol version and some meta data about the auditor.
-  This specification corresponds to ``current`` protocol being version **0**.
+  This specification corresponds to ``current`` protocol being version **1**.
 
   **Response:**
 
@@ -85,6 +85,10 @@ know-your-customer (KYC) registration before issuing contracts.
 
       // EdDSA master public key of the auditor.
       auditor_public_key: EddsaPublicKey;
+
+      // EdDSA master public key of the exchange.
+      // Added in protocol v1.
+      exchange_master_public_key: EddsaPublicKey;
     }
 
   .. note::
@@ -231,6 +235,7 @@ paid out first.
 
       // Master public key of the exchange corresponding to ``master_sig``.
       // Identifies the exchange this is about.
+      // @deprecated since v1 (now ignored, global per auditor)
       master_pub: EddsaPublicKey;
 
       // When does the validity of the exchange_pub end?
diff --git a/manpages/taler.conf.5.rst b/manpages/taler.conf.5.rst
@@ -151,7 +151,9 @@ BIND_TO
 
 MASTER_PUBLIC_KEY
   Crockford Base32-encoded master public key, public version of the
-  exchange's long-time offline signing key.
+  exchange's long-time offline signing key.  This configuration option
+  is also used by the **auditor** to determine the public key of the
+  exchange which it is auditing.
 
 AML_THRESHOLD
   Largest amount in this currency that can be transferred per month without