gnunet-svn
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[taler-docs] branch master updated (566c5c9 -> 8bbe248)


From: gnunet
Subject: [taler-docs] branch master updated (566c5c9 -> 8bbe248)
Date: Thu, 21 Nov 2019 18:06:11 +0100

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

dold pushed a change to branch master
in repository docs.

    from 566c5c9  missing step
     new 19c2f34  errors WIP
     new 2749465  libeufin WIP
     new 8bbe248  wallet WIP

The 3 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails.  The revisions
listed as "add" were already present in the repository and have only
been added to this reference.


Summary of changes:
 core/errors.rst          | 68 ++++++++++++++++++++++++++++++++++++++++++++++++
 core/index.rst           |  1 +
 libeufin/api-sandbox.rst |  8 +++---
 libeufin/iso20022.rst    | 39 +++++++++++++++++++++++++++
 taler-wallet.rst         | 18 +++++++++++++
 5 files changed, 130 insertions(+), 4 deletions(-)
 create mode 100644 core/errors.rst
 create mode 100644 libeufin/iso20022.rst

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
diff --git a/libeufin/api-sandbox.rst b/libeufin/api-sandbox.rst
index 5188a19..ee298d8 100644
--- a/libeufin/api-sandbox.rst
+++ b/libeufin/api-sandbox.rst
@@ -5,17 +5,17 @@ Sandbox API
 Entities
 ========
 
-Customer
-  ...
-
 Bank Account
   ...
 
+EBICS Host
+
 EBICS Subscriber
   ...
 
+EBICS Partner
+  ...
 
-Assumption for sandbox:  One customer corresponds to exactly one EBICS 
subscriber.
 
 
 HTTP API
diff --git a/libeufin/iso20022.rst b/libeufin/iso20022.rst
new file mode 100644
index 0000000..a7d9058
--- /dev/null
+++ b/libeufin/iso20022.rst
@@ -0,0 +1,39 @@
+ISO 20022
+#########
+
+ISO 20022 is the standard that defines many XML messages for FinTech.  It is
+very general, and often countries/orgs define subsets (TVS, technical
+validation subset) of the schema.
+
+
+Cash Management (camt)
+======================
+
+camt.052: Bank to Customer Account Report
+-----------------------------------------
+
+* pending and booked transaction
+
+Schema versions:
+
+* GLS uses camt.052.001.02
+
+.. code-block:: none
+
+  + Document/BkToCstmrAcctRpt
+  ++ GroupHeader [1..1]
+  ++ Report [1..*]
+  +++ Account [1..1]
+  +++ Balance [1..*]
+  +++ Entry [1..*]
+  ++++ Amount [1..1]
+  ++++ Status [1..1]
+  ++++ EntryDetails [1..1]
+
+
+camt.053: Bank to Customer Statement
+------------------------------------
+
+* only booked transactions
+* only for the last day (?)
+
diff --git a/taler-wallet.rst b/taler-wallet.rst
index 21ff250..1b63f2d 100644
--- a/taler-wallet.rst
+++ b/taler-wallet.rst
@@ -112,6 +112,15 @@ verbosity level ``<=`` the queried level are returned.
 
 The following event types are available:
 
+``exchange-added``
+  Emitted when an exchange has ben added to the wallet.
+
+``exchange-update-started``
+  Emitted when updating an exchange has started.
+
+``exchange-update-finished``
+  Emitted when updating an exchange has started.
+
 ``reserve-created`` (Level 1)
   A reserve has been created.  Contains the following detail fields:
 
@@ -199,6 +208,10 @@ The following event types are available:
 Pending Operations
 ------------------
 
+
+``exchange-update``:
+  Shown when exchange information (``/keys`` and ``/wire``) is being updated.
+
 ``reserve``:
   Shown when a reserve has been created (manually or via dereferencing a 
``taler://withdraw`` URI),
   but the reserve has not been confirmed yet.
@@ -267,3 +280,8 @@ Pending Operations
   **Rendering**: The pending operation is rendered as "fetching change", 
optionally
   with "(after manual request)", "(after payment") or "(after refund)".
 
+``refund``
+  Shown when a merchant's refund permission is handed to the exchange.
+
+``tip``
+  Shown when a tip is being picked up from the merchant

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



reply via email to

[Prev in Thread] Current Thread [Next in Thread]