[taler-docs] 02/02: document auditor API changes

[gnunet]

This is an automated email from the git hooks/post-receive script.

grothoff pushed a commit to branch master
in repository docs.

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

    document auditor API changes
---
 core/api-auditor.rst      | 7 ++++++-
 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
index 7aae2df5..dcb39864 100644
--- 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
index 09b993e0..191c7e59 100644
--- 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

-- 
To stop receiving notification emails like this one, please contact
gnunet@gnunet.org.