diff options
| author | Marcello Stanisci <marcello.stanisci@inria.fr> | 2016-09-21 11:21:14 +0200 |
|---|---|---|
| committer | Marcello Stanisci <marcello.stanisci@inria.fr> | 2016-09-21 11:21:14 +0200 |
| commit | 67bd2ba53ac5adfa89e17f6840c52364b26135c4 (patch) | |
| tree | 7b276cf8f708a9c2844751b7ca479a08e5027e4a | |
| parent | 480be98d54fae7045c01f112507c9ebcab7f230c (diff) | |
| download | docs-67bd2ba53ac5adfa89e17f6840c52364b26135c4.tar.gz docs-67bd2ba53ac5adfa89e17f6840c52364b26135c4.tar.bz2 docs-67bd2ba53ac5adfa89e17f6840c52364b26135c4.zip | |
adding chapter on keys duration
| -rw-r--r-- | dev-exchange.rst | 29 | ||||
| -rw-r--r-- | impl-exchange.rst | 8 |
2 files changed, 24 insertions, 13 deletions
diff --git a/dev-exchange.rst b/dev-exchange.rst index 4ca913ae..4d0de76a 100644 --- 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 index 7cd51ac7..1330f360 100644 --- 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 |