commit 67bd2ba53ac5adfa89e17f6840c52364b26135c4
parent 480be98d54fae7045c01f112507c9ebcab7f230c
Author: Marcello Stanisci <marcello.stanisci@inria.fr>
Date: Wed, 21 Sep 2016 11:21:14 +0200
adding chapter on keys duration
Diffstat:
2 files changed, 24 insertions(+), 13 deletions(-)
diff --git a/dev-exchange.rst b/dev-exchange.rst
@@ -11,22 +11,33 @@
TALER; see the file COPYING. If not, see <http://www.gnu.org/licenses/>
@author Christian Grothoff
+ @author Marcello Stanisci
========
Exchange
========
-------------
-Introduction
-------------
-TBD
+.. _keys-duration:
+
+-------------
+Keys duration
+-------------
+
+`signkeys`. The option `lookahead_sign` is such that, being `t` the time when `taler-exchange-keyup`
+is run, `taler-exchange-keyup` will generate `n` `signkeys`, where `t + (n * signkey_duration) = t +
+lookahead_sign`. In other words, we generate a number of keys which is sufficient to cover a period of
+`lookahead_sign`. As for the starting date, the first generated key will get a starting time of `t`,
+and the `j`-th key will get a starting time of `x + signkey_duration`, where `x` is the starting time
+of the `(j-1)`-th key.
+
+`denom keys`. The option `lookahead_sign` is such that, being `t` the time when `taler-exchange-keyup`
+is run, `taler-exchange-keyup` will generate `n` `denom keys` for each denomination, where
+`t + (n * duration_withdraw) = t + lookahead_sign`. In other words, for each denomination, we generate a
+number of keys which is sufficient to cover a period of `lookahead_sign`. As for the starting date, the
+first generated key will get a starting time of `t`, and the `j`-th key will get a starting time of
+`x + duration_withdraw`, where `x` is the starting time of the `(j-1)`-th key.
-.. _keys:
-----
-Keys
-----
-TBD (do mention "starting date")
---------------
Database Scheme
diff --git a/impl-exchange.rst b/impl-exchange.rst
@@ -131,12 +131,12 @@ Sections specifying denomination (coin) information start with "coin\_". By con
* `rsa_keysize`: How many bits should the RSA modulus (product of the two primes) have for this type of coin.
-----------------------
-Univarsal keys duration
+Keys duration
-----------------------
-Each key, regardless of whether it is a `signkey` or a `denom key`, has a :ref:`starting date <keys>`.
-The option `lookahead_provide`, under section `[exchange_keys]`, is such that only keys whose starting date is younger than
-`lookahead_provide` will be issued by the exchange.
+Both `signkeys` and `denom keys` have a :ref:`starting date <keys>` (see :ref:`how <keys-duration>` this date is calculated).
+The option `lookahead_provide`, under section `[exchange_keys]`, is such that only keys whose starting date is
+younger than `lookahead_provide` will be issued by the exchange.
+++++++++
Utilities
