taler-docs

Documentation for GNU Taler components, APIs and protocols
Log | Files | Refs | README | LICENSE

commit 2e86cc7c3f7dc56d9f43f883526bdd90e45234de
parent bacd4d8dd84b1e32ee27d264214e0685dff8b1c5
Author: Özgür Kesim <oec-taler@kesim.org>
Date:   Thu, 23 Jan 2025 10:45:04 +0100

[exchange] cleanup some error codes

Diffstat:
Mcore/api-exchange.rst | 16+++++++---------
1 file changed, 7 insertions(+), 9 deletions(-)

diff --git a/core/api-exchange.rst b/core/api-exchange.rst @@ -1455,7 +1455,8 @@ This part of the API is for the use by auditors interacting with the exchange. interface DenominationUnknownMessage { - // Taler error code. + // Taler error code + // ``TALER_EC_EXCHANGE_GENERIC_DENOMINATION_KEY_UNKNOWN`` code: number; // Signature by the exchange over a @@ -1573,15 +1574,12 @@ Blinding Prepare 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` with error ``TALER_EC_EXCHANGE_GENERIC_DENOMINATION_KEY_UNKNOWN``. + 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 `DenominationGoneMessage` with error - ``TALER_EC_EXCHANGE_GENERIC_DENOMINATION_VALIDITY_IN_FUTURE``, - ``TALER_EC_EXCHANGE_GENERIC_DENOMINATION_EXPIRED`` or - ``TALER_EC_EXCHANGE_GENERIC_DENOMINATION_REVOKED``. + The response is a `DenominationGoneMessage`. Clients must evaluate the error code provided to understand which of the cases this is and handle it accordingly. @@ -1876,7 +1874,7 @@ Withdraw .. ts:def:: CSBlindedDenominationSignature interface CSBlindedDenominationSignature { - type: "CS"; + cipher: "CS"; // Signer chosen bit value, 0 or 1, used // in Clause Blind Schnorr to make the @@ -3162,7 +3160,7 @@ proof to the seller for the escrow of sufficient fund. .. ts:def:: CSDenominationSignature interface CSDenominationSignature { - type: "CS"; + cipher: "CS"; // R value component of the signature. cs_signature_r: Cs25519Point;