[taler-docs] 23/36: hw

[gnunet]

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

grothoff pushed a commit to branch master
in repository docs.

commit 17d2d92487f398aa95f8a55224eb26ebda2e1ada
Author: Christian Grothoff <christian@grothoff.org>
AuthorDate: Tue May 18 19:20:52 2021 +0200

    hw
---
 core/api-common.rst   |  1 +
 core/api-exchange.rst | 16 +++++++++++++++-
 2 files changed, 16 insertions(+), 1 deletion(-)

diff --git a/core/api-common.rst b/core/api-common.rst
index 41e3b8f..45e24dd 100644
--- a/core/api-common.rst
+++ b/core/api-common.rst
@@ -1064,6 +1064,7 @@ within the
      * purpose.purpose = TALER_SIGNATURE_RESERVE_STATUS_REQUEST
      */
     struct GNUNET_CRYPTO_EccSignaturePurpose purpose;
+    struct GNUNET_TIME_AbsoluteNBO request_timestamp;
   };
 
 
diff --git a/core/api-exchange.rst b/core/api-exchange.rst
index abb90c7..23365ef 100644
--- a/core/api-exchange.rst
+++ b/core/api-exchange.rst
@@ -1055,6 +1055,8 @@ exchange.
   :http:statuscode:`401 Unauthorized`:
     The *Account-Request-Signature* is invalid.
     This response comes with a standard `ErrorDetail` response.
+  :http:statuscode:`403 Forbidden`:
+    The provided timestamp is not close to the current time.
   :http:statuscode:`404 Not found`:
     The reserve key does not belong to a reserve known to the exchange.
 
@@ -1067,6 +1069,12 @@ exchange.
       // ``TALER_SIGNATURE_RESERVE_STATUS_REQUEST`` over
       // a `TALER_ReserveStatusRequestSignaturePS`.
       reserve_sig: EddsaSignature;
+
+      // Time when the client made the request.
+      // Timestamp must be reasonably close to the time of
+      // the exchange, otherwise the exchange may reject
+      // the request.
+      request_timestamp: Timestamp;
     }
 
   .. ts:def:: ReserveStatus
@@ -1300,6 +1308,8 @@ exchange.
   :http:statuscode:`401 Unauthorized`:
     The *Account-Request-Signature* is invalid.
     This response comes with a standard `ErrorDetail` response.
+  :http:statuscode:`403 Forbidden`:
+    The provided timestamp is not close to the current time.
   :http:statuscode:`404 Not found`:
     The reserve key does not belong to a reserve known to the exchange.
   :http:statuscode:`412 Precondition failed`:
@@ -2406,7 +2416,7 @@ typically also view the balance.)
     merchant should come back later and ask again.
     The response body is a `TrackTransactionAcceptedResponse`.
   :http:statuscode:`401 Unauthorized`:
-    The signature is invalid.
+    A signature is invalid.
   :http:statuscode:`404 Not found`:
     The deposit operation is unknown to the exchange.
 
@@ -2663,6 +2673,9 @@ Wallet-to-wallet transfers
     The response will include a `PurseDepositAccepted` object.
   :http:statuscode:`401 Unauthorized`:
     A coin signature is invalid.
+    FIXME: add message that tells the client
+    which coin signature(s) were valid. ErrorDetail is not enough
+    to identify the problematic coin.
     This response comes with a standard `ErrorDetail` response.
   :http:statuscode:`403 Forbidden`:
     The server is denying the operation as a purse with a
@@ -2731,6 +2744,7 @@ Wallet-to-wallet transfers
       contract?: EncryptedContract;
 
       // Array of coins being deposited into the purse.
+      // Maximum length is 128.
       deposits: PurseDeposit[];
     }
 

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