[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[taler-docs] branch master updated: [exchange] added /blinding-prepare e
From: |
gnunet |
Subject: |
[taler-docs] branch master updated: [exchange] added /blinding-prepare endpoint |
Date: |
Tue, 21 Jan 2025 16:22:00 +0100 |
This is an automated email from the git hooks/post-receive script.
oec pushed a commit to branch master
in repository taler-docs.
The following commit(s) were added to refs/heads/master by this push:
new ffdda009 [exchange] added /blinding-prepare endpoint
ffdda009 is described below
commit ffdda0098dcb0c7fa01065f456566344338703ef
Author: Özgür Kesim <oec@kesim.org>
AuthorDate: Tue Jan 21 16:21:56 2025 +0100
[exchange] added /blinding-prepare endpoint
---
core/api-exchange.rst | 84 +++++++++++++++++++++++++++++++++++++++++++++++++++
1 file changed, 84 insertions(+)
diff --git a/core/api-exchange.rst b/core/api-exchange.rst
index 172563ba..dc2de06a 100644
--- a/core/api-exchange.rst
+++ b/core/api-exchange.rst
@@ -1549,9 +1549,93 @@ exchange.
}
+Blinding Prepare
+~~~~~~~~~~~~~~~~
+
+.. note:: This endpoint is available since v24 of the API and is a substitute
+ for ``/csr-withdraw``.
+
+
+.. http:post:: /blinding-prepare
+
+ Obtain exchange-side input values in preparation for a
+ blinding step of multiple coins for certain denomination
+ cipher types, specifically at this point for Clause-Schnorr
+ blind signatures.
+
+ **Request:** The request body must be a `BlindingPrepareRequest` object.
+
+ **Response:**
+
+ :http:statuscode:`200 OK`:
+ The request was successful, and the response is a
+ `BlindingPrepareResponse`. Note that repeating exactly the same request
+ will again yield the same response (assuming none of the denominations is
+ expired).
+ :http:statuscode:`404 Not found`:
+ A denomination key is not known to the exchange. The response is a
+ `DenominationUnknownMessage`.
+ :http:statuscode:`410 Gone`:
+ A requested denomination key is not yet or no longer valid.
+ It either before the validity start, past the expiration or was revoked.
+ The response is a `DenominationExpiredMessage`. Clients must evaluate the
+ error code provided to understand which of the cases this is and handle it
+ accordingly.
+
+ **Details:**
+
+ .. ts:def:: BlindingPrepareRequest
+
+ interface BlindingPrepareRequest {
+
+ // Nonces to be used by the exchange to derive
+ // its private inputs from. Must not have ever
+ // been used before.
+ nonces: CSNonce[];
+
+ // Hashes of the public keys of denominations the
+ // request relates to. Must be of the same length
+ // as ``nonces``.
+ denom_pub_hs: HashCode[];
+
+ }
+
+ .. ts:def:: BlindingPrepareResponse
+
+ type BlindingPrepareResponse = BlindingPrepareValue[];
+
+ .. ts:def:: BlindingPrepareValue
+
+ type BlindingPrepareValue =
+ | BlindingPrepareRSAValue
+ | BlindingPrepareCSValue;
+
+ .. ts:def:: BlindingPrepareRSAValue
+
+ interface BlindingPrepareRSAValue{
+ cipher: "RSA";
+ }
+
+ .. ts:def:: BlindingPrepareCSValue
+
+ interface BlindingPrepareCSValue {
+ cipher: "CS";
+
+ // CSR R0 value
+ r_pub_0: CsRPublic;
+
+ // CSR R1 value
+ r_pub_1: CsRPublic;
+ }
+
+
+
CSR-Withdraw
~~~~~~~~~~~~
+.. note:: This endpoint is deprecated starting with API version v24.
+ Use ``/blinding-prepare`` instead.
+
.. http:post:: /csr-withdraw
Obtain exchange-side input values in preparation for a
--
To stop receiving notification emails like this one, please contact
gnunet@gnunet.org.
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [taler-docs] branch master updated: [exchange] added /blinding-prepare endpoint,
gnunet <=