taler-docs

commit d42b291f6e2f460de80b03d2e544d5635a864f80
parent 0524afc73f0f286cc39b3e2a2f7c12689c9fb052
Author: Özgür Kesim <oec@codeblau.de>
Date:   Mon, 14 Sep 2026 17:20:35 +0200

exchange API: rename recoup blinding secret field, drop DenominationBlindingKeyP

Use `coin_blinding_secret` as the JSON field name for the disclosed
blinding secret both in the /recoup-withdraw request and in the
RECOUP-WITHDRAW and RECOUP-REFRESH coin history entries.

The `DenominationBlindingKeyP` type no longer exists in libtalerutil
(the blinding secret is a `union GNUNET_CRYPTO_BlindingSecretP` for
both ciphers) and had no remaining users in the API specification,
so remove it and let the TALER_RecoupRequestPS listing mirror the
actual C struct.

Diffstat:
M
core/api-common.rst
 | 
12
++----------
M
core/exchange/get-coins-COIN_PUB-history.rst
 | 
4
++--
M
core/exchange/post-recoup-withdraw.rst
 | 
4
++--

3 files changed, 6 insertions(+), 14 deletions(-)
diff --git a/core/api-common.rst b/core/api-common.rst
@@ -773,14 +773,6 @@ Blinded coin
     cs_blinded_c1: string; // Crockford `Base32` encoded
   }
 
-.. ts:def:: DenominationBlindingKeyP
-
-   // Secret for blinding/unblinding.
-   // An RSA blinding secret, which is basically
-   // a 256-bit nonce, converted to Crockford `Base32`.
-   type DenominationBlindingKeyP = string;
-
-
 .. _unblinded-coin:
 
 Unblinded coin
@@ -1911,8 +1903,8 @@ within the
      * or TALER_SIGNATURE_WALLET_COIN_RECOUP_REFRESH
      */
     struct GNUNET_CRYPTO_EccSignaturePurpose purpose;
-    struct TALER_DenominationHash h_denom_pub;
-    struct TALER_DenominationBlindingKeyP coin_blind;
+    struct TALER_DenominationHashP h_denom_pub;
+    union GNUNET_CRYPTO_BlindingSecretP coin_blind;
   };
 
 .. _TALER_RecoupRefreshConfirmationPS:
diff --git a/core/exchange/get-coins-COIN_PUB-history.rst b/core/exchange/get-coins-COIN_PUB-history.rst
@@ -292,7 +292,7 @@
 
       // Coin blinding secret that was used in the original withdraw
       // request and disclosed in the recoup request.
-      coin_blind: DenominationBlindingKeySecret;
+      coin_blinding_secret: DenominationBlindingKeySecret;
 
       // The commitment ``planchets_h`` of the original withdraw
       // request that this coin was part of, see `RecoupWithdrawRequest`.
@@ -356,7 +356,7 @@
 
       // Coin blinding secret that was used in the original melt
       // request and disclosed in the recoup request.
-      coin_blind: DenominationBlindingKeySecret;
+      coin_blinding_secret: DenominationBlindingKeySecret;
 
       // The refresh commitment ``rc`` of the original melt request
       // that this coin was derived from, see `RecoupRefreshRequest`.
diff --git a/core/exchange/post-recoup-withdraw.rst b/core/exchange/post-recoup-withdraw.rst
@@ -195,7 +195,7 @@
 
       // The blinding secret that was used to blind the coin
       // in the original withdraw request.
-      coin_blind_key_secret: DenominationBlindingKeySecret;
+      coin_blinding_secret: DenominationBlindingKeySecret;
 
       // The hash of the coin's age commitment.  MUST be present
       // if and only if the denomination supports age restriction.
@@ -224,7 +224,7 @@
   2. For each `RecoupedCoin` at position ``i``, it checks that the
      denomination is eligible for recoup and equals the one recorded at
      position ``i``, verifies ``denom_sig`` and ``coin_sig``, recomputes the
-     blinded envelope from ``coin_pub``, ``coin_blind_key_secret``,
+     blinded envelope from ``coin_pub``, ``coin_blinding_secret``,
      ``h_age_commitment`` and the stored cipher-specific values, and hashes
      it into a `BlindedCoinEnvelopeHash`.  For each `NonRecoupedCoin`
      it uses the ``h_coin_ev`` provided.