taler-docs

commit b3d425099a9c576571eb43758496ea83394c6ec4
parent c25366f79d0362cf96f61c88170378baf16ce3fb
Author: Özgür Kesim <oec-taler@kesim.org>
Date:   Fri,  3 Jan 2025 18:50:54 +0100

[reveal] mark transfer_pub and link_sigs as optional

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

1 file changed, 14 insertions(+), 9 deletions(-)
diff --git a/core/api-exchange.rst b/core/api-exchange.rst
@@ -2117,7 +2117,8 @@ This endpoint is called by the client
   .. warning:: TODO: be more specific about the calculation of $RCH here:
 
   #. In case of `melt`_:
-     $RCH is the hash over the refresh commitment from the ``/melt/`` step.
+     $RCH is the hash over the melt commitment from the ``/melt/`` step,
+     i.e. the value of ``h_melt_commitment`` from that request.
   #. In case of `Withdraw`_:
      $RCH is the running hash over all commitments from the former withdraw request.
 
@@ -2174,15 +2175,19 @@ This endpoint is called by the client
       // TODO: add details about the derivation.
       disclosed_batch_seeds: DisclosedBatchSeed[];
 
-       // Array of ``n`` entries of transfer public keys
-       // (ephemeral ECDHE keys), each for the ``noreveal_index``.
-       transfer_pubs: EddsaPublicKey[];
+      // If the prior request was ``/melt``,
+      // this parameter MUST be set and is
+      // the array of ``n`` entries of transfer public keys
+      // (ephemeral ECDHE keys), each for the ``noreveal_index``.
+      transfer_pubs?: EddsaPublicKey[];
 
-       // Array of ``n`` entries many signatures
-       // made by the wallet using the old coin's private key,
-       // used later to verify the /refresh/link response from the exchange.
-       // Signs over a `TALER_CoinLinkSignaturePS`.
-       link_sigs: EddsaSignature[];
+      // If the prior request was ``/melt``,
+      // this parameter MUST be set and is
+      // the array of ``n`` signatures
+      // made by the wallet using the old coin's private key,
+      // used later to verify the /refresh/link response from the exchange.
+      // Signs over a `TALER_CoinLinkSignaturePS`.
+      link_sigs?: EddsaSignature[];
 
     }