taler-docs

Documentation for GNU Taler components, APIs and protocols
Log | Files | Refs | README | LICENSE

commit 4abe6e614e86ccae3e5484cfa9bb12d469473480
parent 90e67fe49256d506b8d25de7baf88b7e51998f8c
Author: Christian Grothoff <christian@grothoff.org>
Date:   Sun, 31 May 2026 21:39:50 +0200

add missing file, and remove policy/extension details that were purged

Diffstat:
Mmanpages/taler-exchange-offline.1.rst | 18------------------
Mmanpages/taler-exchange.conf.5.rst | 50++++++++++++++------------------------------------
2 files changed, 14 insertions(+), 54 deletions(-)

diff --git a/manpages/taler-exchange-offline.1.rst b/manpages/taler-exchange-offline.1.rst @@ -142,24 +142,6 @@ It outputs the signatures over *all* denomination and signing keys present in the input, in a format suitable for the ``upload`` subcommand. -extensions ----------- - -This subcommand is responsible for the management of available extensions in -the exchange. - -It consumes the output of the ``download`` subcommand, either from ``stdin`` or -directly. - -It provides the sub-subcommand ``extensions show`` to show the configuration -for extensions and the ``extensions sign`` command to sign the current -configuration of extensions, in a format suitable for the ``upload`` -subcommand. - -Note that an extension on the exchange will only become activated at runtime -*after* the extension's configurations has been signed by the offline tool with -the signing key and the signed configuration been uploaded to the exchange. - drain ----- diff --git a/manpages/taler-exchange.conf.5.rst b/manpages/taler-exchange.conf.5.rst @@ -534,46 +534,24 @@ VOLUNTARY -EXCHANGE EXTENSIONS OPTIONS ---------------------------- - -The functionality of the exchange can be extended by extensions. Those are -shared libraries which implement the extension-API of the exchange and are -located under ``$LIBDIR``, starting with prefix ``libtaler_extension_``. Each -extension can be enabled by adding a dedicated section -"[exchange-extension-<extensionname>]" and the following option: - -ENABLED - If set to ``YES`` the extension ``<extensionsname>`` is enabled. Extension-specific - options might be set in the same section. - - -EXCHANGE EXTENSION FOR AGE RESTRICTION -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -The extension for age restriction support can be enabled by adding a section -"[exchange-extension-age_restriction]" with the following options: - -ENABLE - Must be set to ``YES`` in order to activate the extension. +AGE_RESTRICTION_ENABLED + Set to ``YES`` to enable age restriction on coins. When age restriction is + active, certain denominations can be marked with ``AGE_RESTRICTED = YES`` + (see `EXCHANGE COIN OPTIONS`_) and wallets must include an age commitment + when withdrawing or spending such coins. Default is ``NO``. AGE_GROUPS - A colon-seperated string of increasing non-negative integers, defining the - buckets of age groups supported by the exchange. Each integer marks the - beginning of the next age group. The zero'th age group implicitly starts - with 0. For example, the string "10:18" would define three age groups: - - 1. Group 0: ages 0 through 9 (including) - 2. Group 1: ages 10 through 17 (including) + Only meaningful when ``AGE_RESTRICTION_ENABLED = YES``. + A colon-separated string of increasing non-negative integers defining the + age-group boundaries. Each integer marks the start of the next group; the + zero'th group begins implicitly at 0. For example ``"10:18"`` defines three + groups: + + 1. Group 0: ages 0 through 9 (inclusive) + 2. Group 1: ages 10 through 17 (inclusive) 3. Group 2: ages 18 and above - If not provided, the default value is "8:10:12:14:16:18:21". - -**Note**: Age restriction is bound to specific denominations and must be -enabled for each selected denomination in the corresponding section by adding -the option ``AGE_RESTRICTED = YES``, see `EXCHANGE COIN OPTIONS`_. However, the -age groups are defined globally for all denominations. - + If not given the default value ``"8:10:12:14:16:18:21"`` is used. EXCHANGE OFFLINE SIGNING OPTIONS