taler-docs

commit f37cc089a166663c9fe69d19341c645de12bcb53
parent 786e46d3e5eca9f808b04af56185705505ae3e14
Author: MS <ms@taler.net>
Date:   Tue,  6 Oct 2020 17:47:55 +0200

facade instructions

Diffstat:
M
libeufin/nexus-tutorial.rst
 | 
25
+++++++++++++++++++++++++

1 file changed, 25 insertions(+), 0 deletions(-)
diff --git a/libeufin/nexus-tutorial.rst b/libeufin/nexus-tutorial.rst
@@ -228,3 +228,28 @@ for the requesting user.
         --passphrase $SECRET \
         --outputfile $BACKUP_FILE \
         $CONNECTION_NAME
+
+Creating a Taler facade
+=======================
+
+Facades are a additional abstraction layers that can serve
+specific purposes.  For example, one application might need
+a filtered version of the transaction history, or it might
+want to refuse payments that do not conform to certain rules.
+
+At this moment, only the *Taler facade type* is implemented
+in the Nexus, and the command below will show how to instantiate
+one under an existing bank account.
+
+.. code-block:: shell
+
+  libeufin-cli \
+    taler-facade \
+      new-facade \
+        --facade-name $FACADE_NAME \
+        $CUSTOM_RENAMING_FOR_ACCOUNT \
+        $CONNECTION_NAME
+
+At this point, the additional *taler-wire-gateway* (link here) API
+becomes offered by the Nexus.  The purpose is to let a Taler exchange
+to rely on Nexus to manage its bank account.