[taler-docs] 01/03: errors WIP

[gnunet]

This is an automated email from the git hooks/post-receive script.

dold pushed a commit to branch master
in repository docs.

commit 19c2f3476dfbf51f8141ff81fd773c70d3ba29f1
Author: Florian Dold <address@hidden>
AuthorDate: Thu Nov 21 18:05:19 2019 +0100

    errors WIP
---
 core/errors.rst | 68 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 core/index.rst  |  1 +
 2 files changed, 69 insertions(+)

diff --git a/core/errors.rst b/core/errors.rst
new file mode 100644
index 0000000..4fe6583
--- /dev/null
+++ b/core/errors.rst
@@ -0,0 +1,68 @@
+Errors and Testing
+##################
+
+This page lists errors that occur during the operation of GNU Taler.
+
+
+Error Conditions
+================
+
+``EXCHANGE_KEYS_INFO_UNAVAILABLE``
+  An exchange does not return an HTTP 200 response for the ``/keys`` request.
+
+``EXCHANGE_KEYS_INFO_MALFORMED``
+  The exchange returned an HTTP 200 response, but the body
+  did not confirm the schema for ``/keys``.
+
+``EXCHANGE_KEYS_INFO_OUTDATED``
+  The exchange returned a response for ``/keys`` with an issuing date
+  earlier than the previous one.
+
+  **Type**: Warning
+  **Handling**:  The wallet should ignore the response and try again later.
+
+``EXCHANGE_WIRE_INFO_UNAVAILABLE``
+  An exchange does not return an HTTP 200 response for the ``/wire`` request.
+
+``EXCHANGE_WIRE_INFO_MALFORMED``
+  The exchange returned an HTTP 200 response, but the body
+  did not confirm the schema for ``/wire``.
+
+``EXCHANGE_PROTOCOL_VERSION_UNSUPPORTED``
+  An exchanges ``/keys`` response indicates a version number that
+  is not compatible with the client.
+
+``EXCHANGE_MASTER_PUB_CHANGED``
+  An exchange returns a /keys response with a master public key that differs
+  from a previous response.
+
+``EXCHANGE_DENOM_MISSING``
+  A denomination that has been previously offered by the exchange is not 
offered anymore,
+  even though it hasn't expired yet.
+
+``EXCHANGE_DENOM_SIGNATURE_INVALID``
+  The signature by the exchange's master key on a denomination is invalid.
+
+``EXCHANGE_DENOM_CHANGED``
+  A denomination offered by the exchange is valid (syntax, content, signature),
+  but has different information (fees, expiry) for the same public key compared
+  to a previous keys response.
+
+``EXCHANGE_DENOM_CONTENT_INVALID``
+  A denomination offered by the exchange is syntactically correct, but
+  semantically malformed.  For example, the expiration dates are not in the
+  correct temporal order or the denomination public key can't be decoded.
+
+``EXCHANGE_WIRE_FEE_SIGNATURE_INVALID``
+  The signature by the exchange's master key on a wire fee is invalid.
+
+``EXCHANGE_DENOMS_INADEQUATE``
+  The denominations currently offered are inadequate for withdrawing digital 
cash.
+  This can happen when all offered denominations are past their withdrawal 
expiry date.
+
+``EXCHANGE_RESERVE_STATUS_UNAVAILABLE``
+
+``WALLET_BUG``
+  The wallet encountered a programming bug that should be reported to the 
developers.
+
+  **Handling**:  The wallet should allow the user to report this bug to the 
wallet developers.
diff --git a/core/index.rst b/core/index.rst
index 76b7790..9e770c7 100644
--- a/core/index.rst
+++ b/core/index.rst
@@ -38,3 +38,4 @@ interfaces between the core components of Taler.
   wireformats
   api-sync
   taler-uri
+  errors

-- 
To stop receiving notification emails like this one, please contact
address@hidden.