[taler-docs] branch master updated: editing

[gnunet]

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

grothoff pushed a commit to branch master
in repository docs.

The following commit(s) were added to refs/heads/master by this push:
     new e618178f editing
e618178f is described below

commit e618178f186995aa111a607ffe262541f2acd7f6
Author: Christian Grothoff <grothoff@gnunet.org>
AuthorDate: Tue Oct 3 15:29:28 2023 +0200

    editing
---
 core/api-donau.rst | 135 ++---------------------------------------------------
 1 file changed, 4 insertions(+), 131 deletions(-)

diff --git a/core/api-donau.rst b/core/api-donau.rst
index f1f84de1..d299122c 100644
--- a/core/api-donau.rst
+++ b/core/api-donau.rst
@@ -254,29 +254,12 @@ should cache.
       // given here (like on gas stations).
       currency_fraction_digits: Integer;
 
-      // EdDSA master public key of the donau, used to sign entries
-      // in ``denoms`` and ``signkeys``.
-      master_public_key: EddsaPublicKey;
-
       // Donation Units offered by this donau
       donation_units: DonationUnitKeyGroup[];
 
-      // The date when the denomination keys were last updated.
-      list_issue_date: Timestamp;
-
       // The Donau's signing keys.
       signkeys: SignKey[];
 
-      // Compact EdDSA `signature` (binary-only) over the list "donation 
units".
-      // Signature of `TALER_DonauKeySetPS`
-      exchange_sig: EddsaSignature;
-
-      // Public EdDSA key of the Donau that was used to generate the 
exchange_sig.
-      // Should match one of the Donau's signing keys from ``/keys``.  It is 
given
-      // explicitly as the client might otherwise be confused by clock skew as 
to
-      // which signing key was used.
-      exchange_pub: EddsaPublicKey;
-
     }
 
   .. ts:def:: DonauDonationUnitKeyGroup
@@ -309,32 +292,17 @@ should cache.
 
     // Common attributes for all denomination groups
     interface DonauDonationUnitKeyGroupCommon {
-      // How much are receipts of this denomination worth?
+      // How much was donated based on this donation receipt.
       value: Amount;
 
-      // XOR of all the SHA-512 hash values of the denominations' public keys
-      // in this group.  Note that for hashing, the binary format of the
-      // public keys is used, and not their base32 encoding.
-      hash: HashCode;
     }
 
   .. ts:def:: DonauDonationUnitKeyCommon
 
     interface DonauDonationUnitKeyCommon {
-      // Signature of `TALER_DonauDonationUnitKeyValidityPS`.
-      master_sig: EddsaSignature;
-
-      // When does the denomination key become valid?
-      stamp_start: Timestamp;
 
-      // When is it no longer possible to deposit receipts
-      // of this denomination?
-      stamp_expire_withdraw: Timestamp;
-
-      // Timestamp indicating by when legal disputes relating to these 
receipts must
-      // be settled, as the Donau will afterwards destroy its evidence 
relating to
-      // transactions involving this receipt.
-      stamp_expire_legal: Timestamp;
+      // For which year is this denomination unit key valid.
+      year: Integer;
 
       // Set to 'true' if the Donau somehow "lost" the private key. The 
donation unit was not
       // revoked, but still cannot be used to withdraw receipts at this time 
(theoretically,
@@ -343,31 +311,6 @@ should cache.
       lost?: boolean;
     }
 
-  .. ts:def:: DonauDonationUnit
-
-    interface DonauDonationUnit {
-      // How much are donation receipts of this denomination worth?
-      value: Amount;
-
-      // When does the denomination key become valid?
-      stamp_start: Timestamp;
-
-      // When is it no longer possible to deposit receipts
-      // of this denomination?
-      stamp_expire_withdraw: Timestamp;
-
-      // Timestamp indicating by when legal disputes relating to these 
receipts must
-      // be settled, as the donau will afterwards destroy its evidence 
relating to
-      // transactions involving this receipt.
-      stamp_expire_legal: Timestamp;
-
-      // Public key for the denomination.
-      denom_pub: DonauDonationUnitKey;
-
-      // Signature of `TALER_DonauDonationUnitKeyValidityPS`.
-      master_sig: EddsaSignature;
-    }
-
   .. ts:def:: DonauDonationUnitKey
 
     type DonauDonationUnitKey =
@@ -402,20 +345,8 @@ should cache.
       key: EddsaPublicKey;
 
       // Initial validity date for the signing key.
-      stamp_start: Timestamp;
+      year: Integer;
 
-      // Date when the donau will stop using the signing key, allowed to 
overlap
-      // slightly with the next signing key's validity to allow for clock skew.
-      stamp_expire: Timestamp;
-
-      // Date when all signatures made by the signing key expire and should
-      // henceforth no longer be considered valid in legal disputes.
-      stamp_end: Timestamp;
-
-      // Signature over ``key`` and ``stamp_expire`` by the donau master key.
-      // Signature of `TALER_DonauSigningKeyValidityPS`.
-      // Must have purpose ``TALER_SIGNATURE_MASTER_SIGNING_KEY_VALIDITY``.
-      master_sig: EddsaSignature;
     }
 
 
@@ -425,64 +356,6 @@ should cache.
     allowing customers to prove that they received an inconsistent list.
 
 
-
-
-
-  Provide master signatures for future public keys to be used by the Donau.
-  Only to be used by the Donau's offline key management team. Not useful
-  for anyone else.
-
-  **Request:** The request body must be a `MasterSignatures` object.
-
-  **Response:**
-
-  :http:statuscode:`204 No content`:
-    The request was successfully processed.
-  :http:statuscode:`403 Forbidden`:
-    A provided signature is invalid.
-  :http:statuscode:`404 Not found`:
-    One of the keys for which a signature was provided is unknown to the Donau.
-
-  **Details:**
-
-  .. ts:def:: MasterSignatures
-
-    interface MasterSignatures {
-
-      // Provided master signatures for future denomination keys.
-      denom_sigs: DonationUnitSignature[];
-
-      // Provided master signatures for future online signing keys.
-      signkey_sigs: SignKeySignature[];
-
-    }
-
-  .. ts:def:: DonationUnitSignature
-
-    interface DonationUnitSignature {
-
-      // Hash of the public key of the donation unit key.
-      h_denom_pub: HashCode;
-
-      // Signature over `TALER_DonationUnitKeyValidityPS`.
-      // Must have purpose ``TALER_SIGNATURE_MASTER_DENOMINATION_KEY_VALIDITY``
-      master_sig: EddsaSignature;
-
-    }
-
-  .. ts:def:: SignKeySignature
-
-    interface SignKeySignature {
-      // The actual donau's EdDSA signing public key.
-      key: EddsaPublicKey;
-
-      // Signature by the donau master key over
-      // `TALER_DonauSigningKeyValidityPS`.
-      // Must have purpose ``TALER_SIGNATURE_MASTER_SIGNING_KEY_VALIDITY``.
-      master_sig: EddsaSignature;
-
-    }
-
 .. _donau_attest:
 
 ----------------------------------------

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