From f37cc089a166663c9fe69d19341c645de12bcb53 Mon Sep 17 00:00:00 2001
From: MS <ms@taler.net>
Date: Tue, 6 Oct 2020 17:47:55 +0200
Subject: facade instructions

---
 libeufin/nexus-tutorial.rst | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)

(limited to 'libeufin')

diff --git a/libeufin/nexus-tutorial.rst b/libeufin/nexus-tutorial.rst
index 167afe35..cd93594f 100644
--- 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.
-- 
cgit v1.2.3