[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[taler-docs] branch master updated: migrate old glossary, minor fixes
From: |
gnunet |
Subject: |
[taler-docs] branch master updated: migrate old glossary, minor fixes |
Date: |
Wed, 15 Jan 2020 23:00:25 +0100 |
This is an automated email from the git hooks/post-receive script.
dold pushed a commit to branch master
in repository docs.
The following commit(s) were added to refs/heads/master by this push:
new 55b8c08 migrate old glossary, minor fixes
55b8c08 is described below
commit 55b8c088909d26a31549f72b803109096106f5a6
Author: Florian Dold <address@hidden>
AuthorDate: Wed Jan 15 23:00:20 2020 +0100
migrate old glossary, minor fixes
---
core/api-common.rst | 18 +++---
developers-manual.rst | 155 ++++++++++++++++++++++++++++++++++++++++++++++++++
2 files changed, 164 insertions(+), 9 deletions(-)
diff --git a/core/api-common.rst b/core/api-common.rst
index f084c45..3ea0ec4 100644
--- a/core/api-common.rst
+++ b/core/api-common.rst
@@ -321,18 +321,18 @@ Internally, amounts are parsed into the following object:
Binary Formats
--------------
- .. note::
+.. note::
- Due to the way of handling "big" numbers by some platforms (such as
- JavaScript, for example), wherever the following specification mentions
- a 64-bit value, the actual implementations are strongly advised to rely on
- arithmetic up to 53 bits.
+ Due to the way of handling "big" numbers by some platforms (such as
+ JavaScript, for example), wherever the following specification mentions
+ a 64-bit value, the actual implementations are strongly advised to rely on
+ arithmetic up to 53 bits.
- .. note::
+.. note::
- Taler uses ``libgnunetutil`` for interfacing itself with the operating
system,
- doing crypto work, and other "low level" actions, therefore it is strongly
- connected with the `GNUnet project <https://gnunet.org>`_.
+ Taler uses ``libgnunetutil`` for interfacing itself with the operating
system,
+ doing crypto work, and other "low level" actions, therefore it is strongly
+ connected with the `GNUnet project <https://gnunet.org>`_.
This section specifies the binary representation of messages used in Taler's
protocols. The message formats are given in a C-style pseudocode notation.
diff --git a/developers-manual.rst b/developers-manual.rst
index fe1037a..7e44771 100644
--- a/developers-manual.rst
+++ b/developers-manual.rst
@@ -888,3 +888,158 @@ Merchant
Wallet
Also "Taler Wallet". Software component that manages the user's digital cash
and payments.
+
+
+Developer Glossary
+==================
+
+This glossary is meant for developers. It contains some terms that we usually
do not
+use when talking to end users or even system administrators.
+
+.. glossary::
+ :sorted:
+
+ auditor
+ trusted third party that verifies that the :term:`exchange` is operating
correctly
+
+ bank
+ traditional financial service provider who offers wire :term:`transfers
<transfer>` between accounts
+
+ coin
+ coins are individual token representing a certain amount of value, also
known as the :term:`denomination` of the coin
+
+ contract
+ the proposal signed by the wallet.
+
+ FIXME: this one is totally wrong!
+
+ denomination
+ unit of currency, specifies both the currency and the face value of a
:term:`coin`,
+ as well as associated fees and validity periods
+
+ denomination key
+ RSA key used by the exchange to certify that a given :term:`coin` is valid
and of a
+ particular denomination
+
+ deposit
+ operation by which a merchant passes coins to an exchange, expecting the
+ exchange to credit his bank account in the future using a wire transfer
+
+ dirty
+ a coin is dirty if its public key may be known to an entity other than
+ the customer, thereby creating the danger of some entity being able to
+ link multiple transactions of coin's owner if the coin is not refreshed
+
+ exchange
+ Taler's payment service provider. Issues electronic coins during
+ withdrawal and redeems them when they are deposited by merchants.
+
+ expired
+ Various operations come with time limits. In particular, denomination keys
+ come with strict time limits for the various operations involving the
+ coin issued under the denomination. The most important limit is the
+ deposit expiration, which specifies until when wallets are allowed to
+ use the coin in deposit or refreshing operations. There is also a "legal"
+ expiration, which specifies how long the exchange keeps records beyond the
+ deposit expiration time. This latter expiration matters for legal disputes
+ in courts and also creates an upper limit for refreshing operations on
+ special zombie coin.
+
+ WebExtension
+ Cross-browser API used to implement the GNU Taler wallet browser extension.
+
+ fresh
+ fresh coin
+ a coin is fresh if its public key is only known to the customer
+
+ master key
+ offline key used by the exchange to certify denomination keys and
+ message signing keys
+
+ message signing key
+ key used by the exchange to sign online messages, other than coins
+
+ offer
+ specification of the details of a transaction, specifies the payment
obligations
+ for the customer (i.e. the amount), the deliverables of the merchant and
other
+ related information, such as deadlines or locations; However, it lacks some
+ information that the backend is supposed to provide.
+ In other words, after the backend adds the missing information to the
offer and
+ signs it, it becomes a proposal.
+
+ FIXME: completely wrong
+
+ owner
+ a coin is owned by the entity that knows the private key of the coin
+
+ payback
+ Operation by which an exchange returns the value of coins affected
+ by a :term:`revocation` to their :term:`owner`, either by allowing the
owner to
+ withdraw new coins or wiring funds back to the bank account of the
:term:`owner`.
+
+ Also called "recoup".
+
+ proof
+ Message that cryptographically demonstrates that a particular claim is
correct.
+
+ proposal
+ a sketch that has been completed and signed by the merchant backend.
+
+ FIXME: completely wrong
+
+ reserve
+ Funds set aside for future use; either the balance of a customer at the
+ exchange ready for withdrawal, or the funds kept in the exchange;s bank
+ account to cover obligations from coins in circulation.
+
+ refreshing
+ operation by which a :term:`dirty` :term:`coin` is converted into one or
more
+ :term:`fresh` coins
+
+ refund
+ operation by which a merchant steps back from the right to funds that he
+ obtained from a :term:`deposit` operation, giving the right to the funds
back
+ to the customer
+
+ revocation
+ exceptional operation by which an exchange withdraws a denomination from
+ circulation, either because the signing key was compromised or because
+ the exchange is going out of operation; unspent coins of a revoked
+ denomination are subjected to payback.
+
+ sharing
+ users can share ownership of a :term:`coin` by sharing access to the
coin's
+ private key, thereby allowing all co-owners to spend the coin at any
+ time.
+
+ spending
+ operation by which a customer gives a merchant the right to deposit
+ coins in return for merchandise
+
+ transfer
+ wire transfer
+ transfer
+ method of sending funds between :term:`bank` accounts
+
+ wtid
+ wire transfer identifier
+ Subject of a wire transfer; usually a random string to uniquely
+ identify the transfer.
+
+ FIXME: inaccurate
+
+ transaction
+ method by which ownership is exclusively transferred from one entity
+
+ transaction id
+ unique number by which a merchant identifies a :term:`transaction`
+
+ FIXME: completely obsolete by now
+
+ wallet
+ software running on a customer's computer; withdraws, stores and
+ spends coins
+
+ withdrawal
+ operation by which a :term:`wallet` can convert funds from a reserve to
+ fresh coins
--
To stop receiving notification emails like this one, please contact
address@hidden.
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [taler-docs] branch master updated: migrate old glossary, minor fixes,
gnunet <=