taler-docs

commit fd436718a4ca5b8b7f4fd3da21e39cb8090a8929
parent 2462abef3a8235748d5c667df4d3196873630039
Author: Özgür Kesim <oec-taler@kesim.org>
Date:   Wed,  2 Apr 2025 10:26:13 +0200

[melt] update MeltRequest interface and history

Diffstat:
M
core/api-exchange.rst
 | 
26
++++++++++++++++----------

1 file changed, 16 insertions(+), 10 deletions(-)
diff --git a/core/api-exchange.rst b/core/api-exchange.rst
@@ -2777,6 +2777,9 @@ Coin History
       // that is important to fix the coin's denomination.
       h_denom_pub: HashCode;
 
+      // Date when the operation was made.
+      timestamp: Timestamp;
+
     }
 
  .. ts:def:: CoinRefundTransaction
@@ -3497,7 +3500,7 @@ the API during normal operation.
     }
 
 .. _melt:
-.. http:post:: /melt/$COIN_PUB
+.. http:post:: /melt
 
   .. note::
     This endpoint will become available starting with version v26 of the API.
@@ -3543,8 +3546,11 @@ the API during normal operation.
   .. ts:def:: MeltRequest
 
     interface MeltRequest {
+       // The old coin's public key
+       old_coin_pub: CoinPublicKey;
+
        // Hash of the denomination public key of the old coin, to determine total coin value.
-       old_denom_pub_hash: HashCode;
+       old_denom_pub_h: HashCode;
 
        // Signature over the old `coin public key <eddsa-coin-pub>` by the denomination.
        old_denom_sig: DenominationSignature;
@@ -3589,7 +3595,7 @@ the API during normal operation.
 
     interface MeltResponse {
       // Which of the ``kappa`` indices does the client not have to reveal
-      // by calling the ``/reveal-melt/`` endpoint.
+      // by calling the ``/reveal-melt`` endpoint.
       noreveal_index: Integer;
 
       // Signature of `TALER_RefreshMeltConfirmationPS` whereby the exchange
@@ -3654,7 +3660,7 @@ the API during normal operation.
   base URL if this is the case.
 
   :http:statuscode:`200 OK`:
-    The request was successful.  The response body is `Pre24MeltResponse` in this case.
+    The request was successful.  The response body is `Pre26MeltResponse` in this case.
   :http:statuscode:`403 Forbidden`:
     One of the signatures is invalid.
   :http:statuscode:`404 Not found`:
@@ -3679,9 +3685,9 @@ the API during normal operation.
 
   **Details:**
 
-  .. ts:def:: Pre24MeltRequest
+  .. ts:def:: Pre26MeltRequest
 
-    interface Pre24MeltRequest {
+    interface Pre26MeltRequest {
 
       // Hash of the denomination public key, to determine total coin value.
       denom_pub_hash: HashCode;
@@ -3718,9 +3724,9 @@ the API during normal operation.
   the private key of the melted coin, please refer to the
   implementation in ``libtalerutil``.
 
-  .. ts:def:: Pre24MeltResponse
+  .. ts:def:: Pre26MeltResponse
 
-    interface Pre24MeltResponse {
+    interface Pre26MeltResponse {
       // Which of the ``kappa`` indices does the client not have to reveal.
       noreveal_index: Integer;
 
@@ -3800,9 +3806,9 @@ the API during normal operation.
 
   Request body contains a JSON object with the following fields:
 
-  .. ts:def:: Pre24RevealRequest
+  .. ts:def:: Pre26RevealRequest
 
-    interface Pre24RevealRequest {
+    interface Pre26RevealRequest {
 
       // Array of ``n`` new hash codes of denomination public keys to order.
       new_denoms_h: HashCode[];