summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMS <ms@taler.net>2020-10-06 17:47:55 +0200
committerMS <ms@taler.net>2020-10-06 17:47:55 +0200
commitf37cc089a166663c9fe69d19341c645de12bcb53 (patch)
treea12f50ee49b7aaa6f26e4c12fab2f561a4d5d147
parent786e46d3e5eca9f808b04af56185705505ae3e14 (diff)
downloaddocs-f37cc089a166663c9fe69d19341c645de12bcb53.tar.gz
docs-f37cc089a166663c9fe69d19341c645de12bcb53.tar.bz2
docs-f37cc089a166663c9fe69d19341c645de12bcb53.zip
facade instructions
-rw-r--r--libeufin/nexus-tutorial.rst25
1 files changed, 25 insertions, 0 deletions
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.