taler-docs

commit b864feead778b0f6a4c23af4f1f970b50efcadfc
parent cefce8c998893ad8b2e53a1a9f5b01bbec8fdc7d
Author: Mikolai Gütschow <mikolai.guetschow@tu-dresden.de>
Date:   Thu,  8 Feb 2024 16:41:24 +0100

api-{common,exchange,merchant}: fix some API types

Diffstat:
M
core/api-common.rst
 | 
21
++++++++++++++++++++-
M
core/api-exchange.rst
 | 
7
++-----
M
core/api-merchant.rst
 | 
2
+-

3 files changed, 23 insertions(+), 7 deletions(-)
diff --git a/core/api-common.rst b/core/api-common.rst
@@ -543,7 +543,7 @@ Blinded coin
   // coin's `public EdDSA key <eddsa-coin-pub>`.
   interface RSACoinEnvelope {
     cipher: "RSA" | "RSA+age_restricted";
-    rsa_blinded_planchet: string;          // Crockford `Base32` encoded
+    rsa_blinded_planchet: BlindedRsaSignature;
   }
 
 .. ts:def:: CSCoinEnvelope
@@ -567,6 +567,25 @@ Blinded coin
    type DenominationBlindingKeyP = string;
 
 
+. _unblinded-coin:
+
+Unblinded coin
+^^^^^^^^^^^^^^
+
+.. ts:def:: UnblindedSignature
+
+  // The type of a coin's unblinded signature depends on the cipher that was used
+  // for signing with a denomination key.
+  // Note that for now, only RSA is supported.
+  type UnblindedSignature = RsaUnblindedSignature;
+
+.. ts:def:: RsaUnblindedSignature
+
+  interface RsaUnblindedSignature {
+    cipher: "RSA";
+    rsa_signature: RsaSignature;
+  }
+
 
 .. _signature:
 
diff --git a/core/api-exchange.rst b/core/api-exchange.rst
@@ -3398,7 +3398,7 @@ the API during normal operation.
 
       // Melt commitment.  Hash over the various coins to be withdrawn.
       // See also ``TALER_refresh_get_commitment()``.
-      rc: TALER_RefreshCommitmentP;
+      rc: HashCode;
 
       // Master seed for the Clause-schnorr R-value
       // creation. Must match the /csr-melt request.
@@ -3545,10 +3545,7 @@ the API during normal operation.
 
   .. ts:def:: RevealResponse
 
-    interface RevealResponse {
-      // List of the exchange's blinded RSA signatures on the new coins.
-      ev_sigs : Array<{ ev_sig: BlindedDenominationSignature }>;
-    }
+    type RevealResponse = BatchWithdrawResponse;
 
 
   .. ts:def:: RevealConflictResponse
diff --git a/core/api-merchant.rst b/core/api-merchant.rst
@@ -368,7 +368,7 @@ Making the payment
       coin_pub: EddsaPublicKey;
 
       // Signature made by the denomination public key.
-      ub_sig: RsaSignature;
+      ub_sig: UnblindedSignature;
 
       // The hash of the denomination public key associated with this coin.
       h_denom: HashCode;