exchange-coin.rst (2699B)
1 .. 2 This file is part of GNU TALER. 3 Copyright (C) 2014-2024 Taler Systems SA 4 5 TALER is free software; you can redistribute it and/or modify it under the 6 terms of the GNU Affero General Public License as published by the Free Software 7 Foundation; either version 2.1, or (at your option) any later version. 8 9 TALER is distributed in the hope that it will be useful, but WITHOUT ANY 10 WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR 11 A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details. 12 13 You should have received a copy of the GNU Affero General Public License along with 14 TALER; see the file COPYING. If not, see <http://www.gnu.org/licenses/> 15 16 @author Florian Dold 17 @author Benedikt Muller 18 @author Sree Harsha Totakura 19 @author Marcello Stanisci 20 @author Christian Grothoff 21 @author Javier Sepulveda 22 23 EXCHANGE COIN OPTIONS 24 --------------------- 25 26 The following options must be in sections starting with ``"[coin_]"`` and are 27 largely used by **taler-exchange-httpd** to determine the meta data for the 28 denomination keys. Some of the options are used by the 29 **taler-exchange-secmod-rsa** to determine which RSA keys to create (and of 30 what key length). Note that the section names must match, so this part of the 31 configuration MUST be shared between the RSA helper and the exchange. 32 Configuration values MUST NOT be changed in a running setup. Instead, if 33 parameters for a denomination type are to change, a fresh *section name* should 34 be introduced (and the existing section should be deleted). 35 36 37 VALUE 38 Value of the coin, e.g. “EUR:1.50” for 1 Euro and 50 Cents (per 39 coin). 40 41 DURATION_WITHDRAW 42 How long should the same key be used for clients to withdraw coins of 43 this value? 44 45 DURATION_SPEND 46 How long do clients have to spend these coins? 47 48 DURATION_LEGAL 49 How long does the exchange have to keep records for this denomination? 50 51 FEE_WITHDRAW 52 What fee is charged for withdrawal? 53 54 FEE_DEPOSIT 55 What fee is charged for depositing? 56 57 FEE_REFRESH 58 What fee is charged for refreshing? 59 60 FEE_REFUND 61 What fee is charged for refunds? When a coin is refunded, the deposit 62 fee is returned. Instead, the refund fee is charged to the customer. 63 64 CIPHER 65 What cryptosystem should be used? Must be set to either "CS" or "RSA". 66 The respective crypto-helper will then generate the keys for this 67 denomination. 68 69 RSA_KEYSIZE 70 What is the RSA keysize modulos (in bits)? Only used if "CIPHER=RSA". 71 72 AGE_RESTRICTED 73 Setting this option to ``YES`` marks the denomination as age restricted 74 (default is ``NO``). For this option to be accepted the extension for age 75 restriction MUST be enabled.