[taler-docs] branch master updated (a47232f -> f3a21a5)

[gnunet]

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

ms pushed a change to branch master
in repository docs.

    from a47232f  clarify KYC options for oauth2.0 some more
     new bb748c5  circuit API
     new f3a21a5  circuit tutorial

The 2 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:
 libeufin/api-sandbox.rst    | 14 +++++++++++++-
 libeufin/nexus-tutorial.rst | 42 ++++++++----------------------------------
 2 files changed, 21 insertions(+), 35 deletions(-)

diff --git a/libeufin/api-sandbox.rst b/libeufin/api-sandbox.rst
index 6afcac7..96ca0e0 100644
--- a/libeufin/api-sandbox.rst
+++ b/libeufin/api-sandbox.rst
@@ -251,6 +251,17 @@ Cashouts
      Consult the `cashout rates call <cashout-rates_>`_ to learn
      about any applicable fee or exchange rate.
 
+   To test this operation without relying on any SMS/E-mail provider,
+   Libeufin offers two methods: defining an environment variable called
+   ``LIBEUFIN_CASHOUT_TEST_TAN`` or specifying the value ``file`` to
+   the ``tan_channel`` field of the `request object <cashout-request_>`_.
+   Assuming ``LIBEUFIN_CASHOUT_TEST_TAN`` is set to *T*, every */confirm*
+   operation can use *T* as the TAN.  Setting instead the ``tan_channel``
+   field to ``file`` will cause the server to (over)write every TAN to
+   ``/tmp/libeufin-cashout-tan.txt``.  If both are used, the environment
+   variable takes the precedence.
+
+
    **Request:**
 
    `CashoutRequest <cashout-request_>`_
@@ -259,7 +270,8 @@ Cashouts
 
      enum TanChannel {
        SMS = "sms",
-       EMAIL = "email"
+       EMAIL = "email",
+       FILE = "file"
      }
 
    .. _cashout-request:
diff --git a/libeufin/nexus-tutorial.rst b/libeufin/nexus-tutorial.rst
index 482b0f9..70f0b14 100644
--- a/libeufin/nexus-tutorial.rst
+++ b/libeufin/nexus-tutorial.rst
@@ -94,6 +94,9 @@ Unpack the ``libeufin-$version.zip`` file to
 your desired location (typically ``/opt`` or ``~/opt``) and make sure that 
your ``PATH``
 environment variable contains the ``bin/`` directory of the unpacked archive.
 
+
+.. _building-from-source:
+
 Building from source
 --------------------
 
@@ -103,7 +106,8 @@ Nexus belongs to the LibEuFin project, and can be 
downloaded via Git:
 
   $ git clone git://git.taler.net/libeufin
 
-Note that Kotlin and Gradle should already work on the host system.
+Note that Kotlin and Gradle should already work on the host system,
+and that 
 
 Navigate into the *libeufin* local repository, and from top-level run:
 
@@ -111,7 +115,7 @@ Navigate into the *libeufin* local repository, and from 
top-level run:
 
   $ ./bootstrap
   $ ./configure --prefix=$PREFIX
-  $ make install
+  $ make install # Note: This may require Java=18; Java=17 had errors, 
Java>=19 is unsupported by Gradle
 
 Verifying your installation
 ---------------------------
@@ -441,6 +445,8 @@ To reduce the frequency to every five seconds, use the 
cronspec ``"*/5 * *"``
 
    The sandbox is intended as a testing tool and thus not stable.
 
+.. _disable-registrations:
+
 Disable registrations (experimental)
 ------------------------------------
 
@@ -452,38 +458,6 @@ For more information on the available commands, use the 
built-in ``--help`` flag
 The full functionality of the sandbox is available via
 the :ref:`Sandbox API <sandbox-api>`.
 
-Register merchants for local currencies (experimental)
-------------------------------------------------------
-
-This feature allows to register merchants to participate
-in a local currency circuit.  After having installed the
-Sandbox with the steps described above, the administrator
-can now register new merchant accounts with the following
-command.  The main difference with ordinary registrations
-is that this API offers to associate a `cash-out` address
-to the account, so that merchants can convert the local
-currency back to their fiat bank account.
-
-.. note::
-   Disable ordinary registrations as described in the previous section,
-   to make sure that only the administrator can add new accounts.
-
-.. code-block:: console
-
-   $ export LIBEUFIN_SANDBOX_USERNAME=admin
-   $ export LIBEUFIN_SANDBOX_PASSWORD=$password
-   $ export LIBEUFIN_NEW_CIRCUIT_ACCOUNT_PASSWORD=$circuit-account-password
-   $ libeufin-cli sandbox demobank circuit-register \
-     --username=example-shop \
-     --email=example-shop@example.com \
-     --cashout-address=payto://iban/EXAMPLESHOP-FIAT-IBAN \
-     --name="Example Shop"
-
-
-If the command exited successfully, the new user should be
-able to login with the ``$circuit-account-username`` and
-``$circuit-account-password`` credentials.  Run ``libeufin-cli sandbox 
demobank circuit-register --help``, for additional information about the other 
options.
-
 Connect Nexus with an EBICS account
 ===================================
 

-- 
To stop receiving notification emails like this one, please contact
gnunet@gnunet.org.