summaryrefslogtreecommitdiff
path: root/texinfo/taler-developer-manual.texi
diff options
context:
space:
mode:
Diffstat (limited to 'texinfo/taler-developer-manual.texi')
-rw-r--r--texinfo/taler-developer-manual.texi485
1 files changed, 253 insertions, 232 deletions
diff --git a/texinfo/taler-developer-manual.texi b/texinfo/taler-developer-manual.texi
index 5b4efdd2..6ee92df6 100644
--- a/texinfo/taler-developer-manual.texi
+++ b/texinfo/taler-developer-manual.texi
@@ -19,7 +19,7 @@
@copying
@quotation
-GNU Taler 0.9.0, Feb 10, 2024
+GNU Taler 0.9.0, Jan 06, 2024
GNU Taler team
@@ -178,7 +178,8 @@ sending invoices or payments to other wallets.
@item
taler-merchant-demos: various demonstration services operated at
-'demo.taler.net', including a simple shop and a donation page.
+'demo.taler.net', including a simple shop, donation page and a
+survey with reward functionality.
@end itemize
@end quotation
@@ -691,6 +692,7 @@ SS = serial
* Blog demo::
* Donation demo::
* Merchant SPA::
+* Survey/Rewards::
* P2P payments::
* Shutdown::
@@ -934,7 +936,7 @@ that the payment is requested again, instead of showing the previous
fulfillment page.
@end itemize
-@node Merchant SPA,P2P payments,Donation demo,GNU Taler Demo Upgrade Checklist
+@node Merchant SPA,Survey/Rewards,Donation demo,GNU Taler Demo Upgrade Checklist
@anchor{taler-developer-manual merchant-spa}@anchor{1f}
@subsection Merchant SPA
@@ -1015,6 +1017,9 @@ fulfillment page.
check displayed TOTP code matches TOTP app
@item
+ create reserve for rewards
+
+@item
do manual wire transfer in bank to establish reserve funding
@item
@@ -1042,8 +1047,24 @@ fulfillment page.
check that orders are marked as completed
@end itemize
-@node P2P payments,Shutdown,Merchant SPA,GNU Taler Demo Upgrade Checklist
-@anchor{taler-developer-manual p2p-payments}@anchor{20}
+@node Survey/Rewards,P2P payments,Merchant SPA,GNU Taler Demo Upgrade Checklist
+@anchor{taler-developer-manual survey-rewards}@anchor{20}
+@subsection Survey/Rewards
+
+
+
+@itemize -
+
+@item
+ Visit @indicateurl{https://survey.demo.taler.net/} and receive a reward.
+
+@item
+ Verify that the survey stats page (@indicateurl{https://survey.demo.taler.net/survey-stats}) is working,
+and that the survey reserve has sufficient funds.
+@end itemize
+
+@node P2P payments,Shutdown,Survey/Rewards,GNU Taler Demo Upgrade Checklist
+@anchor{taler-developer-manual p2p-payments}@anchor{21}
@subsection P2P payments
@@ -1073,7 +1094,7 @@ fulfillment page.
@end itemize
@node Shutdown,,P2P payments,GNU Taler Demo Upgrade Checklist
-@anchor{taler-developer-manual shutdown}@anchor{21}
+@anchor{taler-developer-manual shutdown}@anchor{22}
@subsection Shutdown
@@ -1109,7 +1130,7 @@ fulfillment page.
@end itemize
@node Environments and Builders on taler net,Releases,Demo Upgrade Procedure,Top
-@anchor{taler-developer-manual environments-and-builders-on-taler-net}@anchor{22}
+@anchor{taler-developer-manual environments-and-builders-on-taler-net}@anchor{23}
@chapter Environments and Builders on taler.net
@@ -1126,7 +1147,7 @@ fulfillment page.
@end menu
@node Buildbot implementation,Test builder,,Environments and Builders on taler net
-@anchor{taler-developer-manual buildbot-implementation}@anchor{23}
+@anchor{taler-developer-manual buildbot-implementation}@anchor{24}
@section Buildbot implementation
@@ -1171,7 +1192,7 @@ Create a worker from a shell account with this command: @code{buildbot-worker cr
Then make sure there is a WORKER defined in master.cfg like: @code{worker.Worker("<username>", "<password>")}
@node Test builder,Wallet builder,Buildbot implementation,Environments and Builders on taler net
-@anchor{taler-developer-manual test-builder}@anchor{24}
+@anchor{taler-developer-manual test-builder}@anchor{25}
@section Test builder
@@ -1193,7 +1214,7 @@ the mentioned unit file can be found at @code{deployment.git/systemd-services/}
@end cartouche
@node Wallet builder,Documentation Builder,Test builder,Environments and Builders on taler net
-@anchor{taler-developer-manual wallet-builder}@anchor{25}
+@anchor{taler-developer-manual wallet-builder}@anchor{26}
@section Wallet builder
@@ -1215,7 +1236,7 @@ the mentioned unit file can be found at @code{deployment.git/systemd-services/}
@end cartouche
@node Documentation Builder,Website Builder,Wallet builder,Environments and Builders on taler net
-@anchor{taler-developer-manual documentation-builder}@anchor{26}
+@anchor{taler-developer-manual documentation-builder}@anchor{27}
@section Documentation Builder
@@ -1237,7 +1258,7 @@ $ buildbot-worker start worker/
@end example
@node Website Builder,Code coverage,Documentation Builder,Environments and Builders on taler net
-@anchor{taler-developer-manual website-builder}@anchor{27}
+@anchor{taler-developer-manual website-builder}@anchor{28}
@section Website Builder
@@ -1259,7 +1280,7 @@ $ buildbot-worker start worker/
@end example
@node Code coverage,Producing auditor reports,Website Builder,Environments and Builders on taler net
-@anchor{taler-developer-manual code-coverage}@anchor{28}
+@anchor{taler-developer-manual code-coverage}@anchor{29}
@section Code coverage
@@ -1282,7 +1303,7 @@ $ buildbot-worker start worker/
The results are then published at @code{https://lcov.taler.net/}.
@node Producing auditor reports,Database schema versioning,Code coverage,Environments and Builders on taler net
-@anchor{taler-developer-manual producing-auditor-reports}@anchor{29}
+@anchor{taler-developer-manual producing-auditor-reports}@anchor{2a}
@section Producing auditor reports
@@ -1303,7 +1324,7 @@ $ buildbot-worker start worker/
@end example
@node Database schema versioning,,Producing auditor reports,Environments and Builders on taler net
-@anchor{taler-developer-manual database-schema-versioning}@anchor{2a}@anchor{taler-developer-manual databaseversioning}@anchor{5}
+@anchor{taler-developer-manual database-schema-versioning}@anchor{2b}@anchor{taler-developer-manual databaseversioning}@anchor{5}
@section Database schema versioning
@@ -1319,7 +1340,7 @@ Developers and operators MUST NOT make changes to database schema
outside of this versioning. All tables of a GNU Taler component should live in their own schema.
@node Releases,Continuous integration,Environments and Builders on taler net,Top
-@anchor{taler-developer-manual releases}@anchor{2b}
+@anchor{taler-developer-manual releases}@anchor{2c}
@chapter Releases
@@ -1336,7 +1357,7 @@ outside of this versioning. All tables of a GNU Taler component should live in
@end menu
@node GNU Taler Release Checklist,Release Process,,Releases
-@anchor{taler-developer-manual gnu-taler-release-checklist}@anchor{2c}
+@anchor{taler-developer-manual gnu-taler-release-checklist}@anchor{2d}
@section GNU Taler Release Checklist
@@ -1713,7 +1734,7 @@ Release announcement:
@end itemize
@node Release Process,Tagging,GNU Taler Release Checklist,Releases
-@anchor{taler-developer-manual release-process}@anchor{2d}
+@anchor{taler-developer-manual release-process}@anchor{2e}
@section Release Process
@@ -1748,7 +1769,7 @@ wallet-core (wallet-core.git)
@end itemize
@node Tagging,Database for tests,Release Process,Releases
-@anchor{taler-developer-manual tagging}@anchor{2e}
+@anchor{taler-developer-manual tagging}@anchor{2f}
@section Tagging
@@ -1760,7 +1781,7 @@ $ git push origin v0.1.0
@end example
@node Database for tests,Exchange merchant,Tagging,Releases
-@anchor{taler-developer-manual database-for-tests}@anchor{2f}
+@anchor{taler-developer-manual database-for-tests}@anchor{30}
@section Database for tests
@@ -1777,7 +1798,7 @@ secured from unauthorized access.
@end cartouche
@node Exchange merchant,Wallet WebExtension,Database for tests,Releases
-@anchor{taler-developer-manual exchange-merchant}@anchor{30}
+@anchor{taler-developer-manual exchange-merchant}@anchor{31}
@section Exchange, merchant
@@ -1836,7 +1857,7 @@ $ make install check
@end example
@node Wallet WebExtension,Upload to GNU mirrors,Exchange merchant,Releases
-@anchor{taler-developer-manual wallet-webextension}@anchor{31}
+@anchor{taler-developer-manual wallet-webextension}@anchor{32}
@section Wallet WebExtension
@@ -1850,7 +1871,7 @@ $ make dist
@end example
@node Upload to GNU mirrors,Creating Debian packages,Wallet WebExtension,Releases
-@anchor{taler-developer-manual upload-to-gnu-mirrors}@anchor{32}
+@anchor{taler-developer-manual upload-to-gnu-mirrors}@anchor{33}
@section Upload to GNU mirrors
@@ -1868,7 +1889,7 @@ symlink: taler-exchange-0.1.0.tar.gz taler-exchange-latest.tar.gz
Upload the files in `binary mode' to the ftp servers.
@node Creating Debian packages,,Upload to GNU mirrors,Releases
-@anchor{taler-developer-manual creating-debian-packages}@anchor{33}
+@anchor{taler-developer-manual creating-debian-packages}@anchor{34}
@section Creating Debian packages
@@ -1907,7 +1928,7 @@ Finally, make sure to clean up @code{~/incoming/} (by deleting the
now imported @code{*.deb} files).
@node Continuous integration,Internationalization,Releases,Top
-@anchor{taler-developer-manual continuous-integration}@anchor{34}
+@anchor{taler-developer-manual continuous-integration}@anchor{35}
@chapter Continuous integration
@@ -1925,7 +1946,7 @@ There is also the possibility to trigger builds manually, but this is
only reserved to "admin" users.
@node Internationalization,iOS Apps,Continuous integration,Top
-@anchor{taler-developer-manual internationalization}@anchor{35}
+@anchor{taler-developer-manual internationalization}@anchor{36}
@chapter Internationalization
@@ -1946,14 +1967,14 @@ At this time, this system is still very new for Taler.net and this documentation
@end menu
@node Who can Register,About Privilege Levels,,Internationalization
-@anchor{taler-developer-manual who-can-register}@anchor{36}
+@anchor{taler-developer-manual who-can-register}@anchor{37}
@section Who can Register
At this time, anyone can register an account at @indicateurl{https://weblate.taler.net/} to create translations. Registered users default to the `Users' and `Viewers' privilege level.
@node About Privilege Levels,Upgrading Privileges,Who can Register,Internationalization
-@anchor{taler-developer-manual about-privilege-levels}@anchor{37}
+@anchor{taler-developer-manual about-privilege-levels}@anchor{38}
@section About Privilege Levels
@@ -1976,21 +1997,21 @@ This is the breakdown of privilege levels in Weblate:
@end itemize
@node Upgrading Privileges,How to Create a Project,About Privilege Levels,Internationalization
-@anchor{taler-developer-manual upgrading-privileges}@anchor{38}
+@anchor{taler-developer-manual upgrading-privileges}@anchor{39}
@section Upgrading Privileges
To upgrade from `Users'/`Viewers', a superuser must manually augment your privileges. At this time, superusers are Christian, Florian, and Buck.
@node How to Create a Project,How to Create a Component,Upgrading Privileges,Internationalization
-@anchor{taler-developer-manual how-to-create-a-project}@anchor{39}
+@anchor{taler-developer-manual how-to-create-a-project}@anchor{3a}
@section How to Create a Project
The `GNU Taler' project is probably the correct project for most Components and Translations falling under this guide. Please contact a superuser if you need another Project created.
@node How to Create a Component,How to Create a Translation,How to Create a Project,Internationalization
-@anchor{taler-developer-manual how-to-create-a-component}@anchor{3a}
+@anchor{taler-developer-manual how-to-create-a-component}@anchor{3b}
@section How to Create a Component
@@ -2030,7 +2051,7 @@ Under `https://weblate.taler.net/create/component/vcs/':
@end itemize
@node How to Create a Translation,Translation Standards and Practices,How to Create a Component,Internationalization
-@anchor{taler-developer-manual how-to-create-a-translation}@anchor{3b}
+@anchor{taler-developer-manual how-to-create-a-translation}@anchor{3c}
@section How to Create a Translation
@@ -2049,7 +2070,7 @@ Under `https://weblate.taler.net/create/component/vcs/':
You may also wish to refer to @indicateurl{https://docs.weblate.org/} .
@node Translation Standards and Practices,GPG Signing of Translations,How to Create a Translation,Internationalization
-@anchor{taler-developer-manual translation-standards-and-practices}@anchor{3c}
+@anchor{taler-developer-manual translation-standards-and-practices}@anchor{3d}
@section Translation Standards and Practices
@@ -2060,7 +2081,7 @@ When asked, set the license to GPLv3 or later.
Set commit/push to manual only.
@node GPG Signing of Translations,,Translation Standards and Practices,Internationalization
-@anchor{taler-developer-manual gpg-signing-of-translations}@anchor{3d}
+@anchor{taler-developer-manual gpg-signing-of-translations}@anchor{3e}
@section GPG Signing of Translations
@@ -2069,7 +2090,7 @@ weblate.taler.net signs GPG commits with the GPG key CD33CE35801462FA5EB0B695F26
This means that contributions made through weblate will not be signed with the individual contributor's key when they are checked into the Git repository, but with the weblate key.
@node iOS Apps,Android Apps,Internationalization,Top
-@anchor{taler-developer-manual ios-apps}@anchor{3e}
+@anchor{taler-developer-manual ios-apps}@anchor{3f}
@chapter iOS Apps
@@ -2079,7 +2100,7 @@ This means that contributions made through weblate will not be signed with the i
@end menu
@node Building Taler Wallet for iOS from source,,,iOS Apps
-@anchor{taler-developer-manual build-ios-from-source}@anchor{3f}@anchor{taler-developer-manual building-taler-wallet-for-ios-from-source}@anchor{40}
+@anchor{taler-developer-manual build-ios-from-source}@anchor{40}@anchor{taler-developer-manual building-taler-wallet-for-ios-from-source}@anchor{41}
@section Building Taler Wallet for iOS from source
@@ -2093,7 +2114,7 @@ the official Git repository@footnote{https://git.taler.net/taler-ios.git}.
@end menu
@node Compatibility,Building,,Building Taler Wallet for iOS from source
-@anchor{taler-developer-manual compatibility}@anchor{41}
+@anchor{taler-developer-manual compatibility}@anchor{42}
@subsection Compatibility
@@ -2101,7 +2122,7 @@ The minimum version of iOS supported is 15.0.
This app runs on all iPhone models at least as new as the iPhone 6S.
@node Building,,Compatibility,Building Taler Wallet for iOS from source
-@anchor{taler-developer-manual building}@anchor{42}
+@anchor{taler-developer-manual building}@anchor{43}
@subsection Building
@@ -2133,7 +2154,7 @@ there - all needed libraries and frameworks will be built automatically from
Taler.xcworkspace.
@node Android Apps,Code Coverage,iOS Apps,Top
-@anchor{taler-developer-manual android-apps}@anchor{43}
+@anchor{taler-developer-manual android-apps}@anchor{44}
@chapter Android Apps
@@ -2146,7 +2167,7 @@ Taler.xcworkspace.
@end menu
@node Android App Nightly Builds,Building apps from source,,Android Apps
-@anchor{taler-developer-manual android-app-nightly-builds}@anchor{44}
+@anchor{taler-developer-manual android-app-nightly-builds}@anchor{45}
@section Android App Nightly Builds
@@ -2197,7 +2218,7 @@ Use at your own risk!
@end cartouche
@node Building apps from source,Update translations,Android App Nightly Builds,Android Apps
-@anchor{taler-developer-manual build-apps-from-source}@anchor{45}@anchor{taler-developer-manual building-apps-from-source}@anchor{46}
+@anchor{taler-developer-manual build-apps-from-source}@anchor{46}@anchor{taler-developer-manual building-apps-from-source}@anchor{47}
@section Building apps from source
@@ -2283,7 +2304,7 @@ After the build finished successfully,
you will find your APK in @code{merchant-terminal/build/outputs/apk/release/}.
@node Update translations,Release process,Building apps from source,Android Apps
-@anchor{taler-developer-manual update-translations}@anchor{47}
+@anchor{taler-developer-manual update-translations}@anchor{48}
@section Update translations
@@ -2317,7 +2338,7 @@ Afterwards, build the entire project from source and test the UI
to ensure that no erroneous translations (missing placeholders) are breaking things.
@node Release process,,Update translations,Android Apps
-@anchor{taler-developer-manual id1}@anchor{48}
+@anchor{taler-developer-manual id1}@anchor{49}
@section Release process
@@ -2348,7 +2369,7 @@ $ git tag -s $APP-$VERSION
@end menu
@node F-Droid,Google Play,,Release process
-@anchor{taler-developer-manual id2}@anchor{49}
+@anchor{taler-developer-manual id2}@anchor{4a}
@subsection F-Droid
@@ -2372,7 +2393,7 @@ PoS: [metadata@footnote{https://gitlab.com/fdroid/fdroiddata/-/blob/master/metad
@end itemize
@node Google Play,,F-Droid,Release process
-@anchor{taler-developer-manual google-play}@anchor{4a}
+@anchor{taler-developer-manual google-play}@anchor{4b}
@subsection Google Play
@@ -2394,7 +2415,7 @@ All uploads are going to the beta track by default.
These can be promoted to production later or immediately after upload if you feel daring.
@node Code Coverage,Coding Conventions,Android Apps,Top
-@anchor{taler-developer-manual id3}@anchor{4b}@anchor{taler-developer-manual id4}@anchor{4c}
+@anchor{taler-developer-manual id3}@anchor{4c}@anchor{taler-developer-manual id4}@anchor{4d}
@chapter Code Coverage
@@ -2404,7 +2425,7 @@ nightly (once a day) by a Buildbot worker. The coverage results are
then published at @indicateurl{https://lcov.taler.net/} .
@node Coding Conventions,Testing library,Code Coverage,Top
-@anchor{taler-developer-manual coding-conventions}@anchor{4d}
+@anchor{taler-developer-manual coding-conventions}@anchor{4e}
@chapter Coding Conventions
@@ -2421,7 +2442,7 @@ GNU Taler is developed primarily in C, Kotlin, Python, Swift and TypeScript.
@end menu
@node Components written in C,Shell Scripts,,Coding Conventions
-@anchor{taler-developer-manual components-written-in-c}@anchor{4e}
+@anchor{taler-developer-manual components-written-in-c}@anchor{4f}
@section Components written in C
@@ -2441,7 +2462,7 @@ by the GNUnet style: @indicateurl{https://docs.gnunet.org/handbook/gnunet.html#C
@end menu
@node Naming conventions,,,Components written in C
-@anchor{taler-developer-manual naming-conventions}@anchor{4f}
+@anchor{taler-developer-manual naming-conventions}@anchor{50}
@subsection Naming conventions
@@ -2602,7 +2623,7 @@ must be called "perf_module-under-test_case-description.c"
@end itemize
@node Shell Scripts,Kotlin,Components written in C,Coding Conventions
-@anchor{taler-developer-manual shell-scripts}@anchor{50}
+@anchor{taler-developer-manual shell-scripts}@anchor{51}
@section Shell Scripts
@@ -2629,7 +2650,7 @@ $ set -eu
@end example
@node Kotlin,Python,Shell Scripts,Coding Conventions
-@anchor{taler-developer-manual kotlin}@anchor{51}
+@anchor{taler-developer-manual kotlin}@anchor{52}
@section Kotlin
@@ -2637,7 +2658,7 @@ We so far have no specific guidelines, please follow best practices
for the language.
@node Python,Swift,Kotlin,Coding Conventions
-@anchor{taler-developer-manual python}@anchor{52}
+@anchor{taler-developer-manual python}@anchor{53}
@section Python
@@ -2649,14 +2670,14 @@ for the language.
@end menu
@node Supported Python Versions,Style,,Python
-@anchor{taler-developer-manual supported-python-versions}@anchor{53}
+@anchor{taler-developer-manual supported-python-versions}@anchor{54}
@subsection Supported Python Versions
Python code should be written and build against version 3.7 of Python.
@node Style,Python for Scripting,Supported Python Versions,Python
-@anchor{taler-developer-manual style}@anchor{54}
+@anchor{taler-developer-manual style}@anchor{55}
@subsection Style
@@ -2666,7 +2687,7 @@ A reusable yapf style file can be found in @code{build-common},
which is intended to be used as a git submodule.
@node Python for Scripting,,Style,Python
-@anchor{taler-developer-manual python-for-scripting}@anchor{55}
+@anchor{taler-developer-manual python-for-scripting}@anchor{56}
@subsection Python for Scripting
@@ -2688,21 +2709,21 @@ over the older APIs.
@end itemize
@node Swift,TypeScript,Python,Coding Conventions
-@anchor{taler-developer-manual swift}@anchor{56}
+@anchor{taler-developer-manual swift}@anchor{57}
@section Swift
Please follow best practices for the language.
@node TypeScript,,Swift,Coding Conventions
-@anchor{taler-developer-manual typescript}@anchor{57}
+@anchor{taler-developer-manual typescript}@anchor{58}
@section TypeScript
Please follow best practices for the language.
@node Testing library,User-Facing Terminology,Coding Conventions,Top
-@anchor{taler-developer-manual testing-library}@anchor{58}
+@anchor{taler-developer-manual testing-library}@anchor{59}
@chapter Testing library
@@ -2775,7 +2796,7 @@ Please refer to the Twister codebase (under the @code{test} directory) in
order to see how to configure it.
@node User-Facing Terminology,Developer Glossary,Testing library,Top
-@anchor{taler-developer-manual user-facing-terminology}@anchor{59}
+@anchor{taler-developer-manual user-facing-terminology}@anchor{5a}
@chapter User-Facing Terminology
@@ -2789,7 +2810,7 @@ used in the user interface and help materials.
@end menu
@node Terms to Avoid,Terms to Use,,User-Facing Terminology
-@anchor{taler-developer-manual terms-to-avoid}@anchor{5a}
+@anchor{taler-developer-manual terms-to-avoid}@anchor{5b}
@section Terms to Avoid
@@ -2865,7 +2886,7 @@ with their payment. Can also be something like a donation receipt.
@end table
@node Terms to Use,,Terms to Avoid,User-Facing Terminology
-@anchor{taler-developer-manual terms-to-use}@anchor{5b}
+@anchor{taler-developer-manual terms-to-use}@anchor{5c}
@section Terms to Use
@@ -2917,7 +2938,7 @@ and payments.
@end table
@node Developer Glossary,Developer Tools,User-Facing Terminology,Top
-@anchor{taler-developer-manual developer-glossary}@anchor{5c}
+@anchor{taler-developer-manual developer-glossary}@anchor{5d}
@chapter Developer Glossary
@@ -2926,137 +2947,137 @@ use when talking to end users or even system administrators.
@table @asis
-@anchor{taler-developer-manual term-absolute-time}@anchor{5d}
+@anchor{taler-developer-manual term-absolute-time}@anchor{5e}
@geindex absolute time
@item absolute time
-method of keeping time in @ref{5e,,GNUnet} where the time is represented
+method of keeping time in @ref{5f,,GNUnet} where the time is represented
as the number of microseconds since 1.1.1970 (UNIX epoch). Called
-absolute time in contrast to @ref{5f,,relative time}.
-@anchor{taler-developer-manual term-aggregate}@anchor{60}
+absolute time in contrast to @ref{60,,relative time}.
+@anchor{taler-developer-manual term-aggregate}@anchor{61}
@geindex aggregate
@item aggregate
-the @ref{61,,exchange} combines multiple payments received by the
-same @ref{62,,merchant} into one larger @ref{63,,wire transfer} to
-the respective merchant's @ref{64,,bank} account
-@anchor{taler-developer-manual term-auditor}@anchor{65}
+the @ref{62,,exchange} combines multiple payments received by the
+same @ref{63,,merchant} into one larger @ref{64,,wire transfer} to
+the respective merchant's @ref{65,,bank} account
+@anchor{taler-developer-manual term-auditor}@anchor{66}
@geindex auditor
@item auditor
-trusted third party that verifies that the @ref{61,,exchange} is operating correctly
-@anchor{taler-developer-manual term-bank}@anchor{64}
+trusted third party that verifies that the @ref{62,,exchange} is operating correctly
+@anchor{taler-developer-manual term-bank}@anchor{65}
@geindex bank
@item bank
-traditional financial service provider who offers wire @ref{66,,transfers} between accounts
-@anchor{taler-developer-manual term-buyer}@anchor{67}
+traditional financial service provider who offers wire @ref{67,,transfers} between accounts
+@anchor{taler-developer-manual term-buyer}@anchor{68}
@geindex buyer
@item buyer
-individual in control of a Taler @ref{68,,wallet}, usually using it to
-@ref{69,,spend} the @ref{6a,,coins} on @ref{6b,,contracts} (see also @ref{6c,,customer}).
-@anchor{taler-developer-manual term-close}@anchor{6d}
+individual in control of a Taler @ref{69,,wallet}, usually using it to
+@ref{6a,,spend} the @ref{6b,,coins} on @ref{6c,,contracts} (see also @ref{6d,,customer}).
+@anchor{taler-developer-manual term-close}@anchor{6e}
@geindex close
-@item close@anchor{taler-developer-manual term-closes}@anchor{6e}
+@item close@anchor{taler-developer-manual term-closes}@anchor{6f}
@geindex closes
-@itemx closes@anchor{taler-developer-manual term-closed}@anchor{6f}
+@itemx closes@anchor{taler-developer-manual term-closed}@anchor{70}
@geindex closed
-@itemx closed@anchor{taler-developer-manual term-closing}@anchor{70}
+@itemx closed@anchor{taler-developer-manual term-closing}@anchor{71}
@geindex closing
@itemx closing
-operation an @ref{61,,exchange} performs on a @ref{71,,reserve} that has not been
-@ref{72,,drained} by @ref{73,,withdraw} operations. When closing a reserve, the
-exchange wires the remaining funds back to the customer, minus a @ref{74,,fee}
+operation an @ref{62,,exchange} performs on a @ref{72,,reserve} that has not been
+@ref{73,,drained} by @ref{74,,withdraw} operations. When closing a reserve, the
+exchange wires the remaining funds back to the customer, minus a @ref{75,,fee}
for closing
-@anchor{taler-developer-manual term-coin}@anchor{75}
+@anchor{taler-developer-manual term-coin}@anchor{76}
@geindex coin
-@item coin@anchor{taler-developer-manual term-coins}@anchor{6a}
+@item coin@anchor{taler-developer-manual term-coins}@anchor{6b}
@geindex coins
@itemx coins
-coins are individual token representing a certain amount of value, also known as the @ref{76,,denomination} of the coin
-@anchor{taler-developer-manual term-commitment}@anchor{77}
+coins are individual token representing a certain amount of value, also known as the @ref{77,,denomination} of the coin
+@anchor{taler-developer-manual term-commitment}@anchor{78}
@geindex commitment
-@item commitment@anchor{taler-developer-manual term-refresh-commitment}@anchor{78}
+@item commitment@anchor{taler-developer-manual term-refresh-commitment}@anchor{79}
@geindex refresh commitment
@itemx refresh commitment
-data that the wallet commits to during the @ref{79,,melt} stage of the
-@ref{7a,,refresh} protocol where it
-has to prove to the @ref{61,,exchange} that it is deriving the @ref{7b,,fresh}
+data that the wallet commits to during the @ref{7a,,melt} stage of the
+@ref{7b,,refresh} protocol where it
+has to prove to the @ref{62,,exchange} that it is deriving the @ref{7c,,fresh}
coins as specified by the Taler protocol. The commitment is verified
-probabilistically (see: @ref{7c,,kappa}) during the @ref{7d,,reveal} stage.
-@anchor{taler-developer-manual term-contract}@anchor{7e}
+probabilistically (see: @ref{7d,,kappa}) during the @ref{7e,,reveal} stage.
+@anchor{taler-developer-manual term-contract}@anchor{7f}
@geindex contract
-@item contract@anchor{taler-developer-manual term-contracts}@anchor{6b}
+@item contract@anchor{taler-developer-manual term-contracts}@anchor{6c}
@geindex contracts
@itemx contracts
-formal agreement between @ref{62,,merchant} and @ref{6c,,customer} specifying the
-@ref{7f,,contract terms} and signed by the merchant and the @ref{6a,,coins} of the
+formal agreement between @ref{63,,merchant} and @ref{6d,,customer} specifying the
+@ref{80,,contract terms} and signed by the merchant and the @ref{6b,,coins} of the
customer
-@anchor{taler-developer-manual term-contract-terms}@anchor{7f}
+@anchor{taler-developer-manual term-contract-terms}@anchor{80}
@geindex contract terms
@item contract terms
the individual clauses specifying what the buyer is purchasing from the
-@ref{62,,merchant}
-@anchor{taler-developer-manual term-customer}@anchor{6c}
+@ref{63,,merchant}
+@anchor{taler-developer-manual term-customer}@anchor{6d}
@geindex customer
@item customer
individual that directs the buyer (perhaps the same individual) to make a purchase
-@anchor{taler-developer-manual term-denomination}@anchor{76}
+@anchor{taler-developer-manual term-denomination}@anchor{77}
@geindex denomination
@item denomination
-unit of currency, specifies both the currency and the face value of a @ref{75,,coin},
+unit of currency, specifies both the currency and the face value of a @ref{76,,coin},
as well as associated fees and validity periods
-@anchor{taler-developer-manual term-denomination-key}@anchor{80}
+@anchor{taler-developer-manual term-denomination-key}@anchor{81}
@geindex denomination key
@item denomination key
-(RSA) key used by the exchange to certify that a given @ref{75,,coin} is valid and of a
-particular @ref{76,,denomination}
-@anchor{taler-developer-manual term-deposit}@anchor{81}
+(RSA) key used by the exchange to certify that a given @ref{76,,coin} is valid and of a
+particular @ref{77,,denomination}
+@anchor{taler-developer-manual term-deposit}@anchor{82}
@geindex deposit
-@item deposit@anchor{taler-developer-manual term-deposits}@anchor{82}
+@item deposit@anchor{taler-developer-manual term-deposits}@anchor{83}
@geindex deposits
-@itemx deposits@anchor{taler-developer-manual term-depositing}@anchor{83}
+@itemx deposits@anchor{taler-developer-manual term-depositing}@anchor{84}
@geindex depositing
@itemx depositing
operation by which a merchant passes coins to an exchange, expecting the
exchange to credit his bank account in the future using an
-@ref{60,,aggregate} @ref{63,,wire transfer}
-@anchor{taler-developer-manual term-dirty}@anchor{84}
+@ref{61,,aggregate} @ref{64,,wire transfer}
+@anchor{taler-developer-manual term-dirty}@anchor{85}
@geindex dirty
-@item dirty@anchor{taler-developer-manual term-dirty-coin}@anchor{85}
+@item dirty@anchor{taler-developer-manual term-dirty-coin}@anchor{86}
@geindex dirty coin
@itemx dirty coin
@@ -3064,30 +3085,30 @@ exchange to credit his bank account in the future using an
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
-@anchor{taler-developer-manual term-drain}@anchor{86}
+@anchor{taler-developer-manual term-drain}@anchor{87}
@geindex drain
-@item drain@anchor{taler-developer-manual term-drained}@anchor{72}
+@item drain@anchor{taler-developer-manual term-drained}@anchor{73}
@geindex drained
@itemx drained
-a @ref{71,,reserve} is being drained when a @ref{68,,wallet} is using the
-reserve's private key to @ref{73,,withdraw} coins from it. This reduces
+a @ref{72,,reserve} is being drained when a @ref{69,,wallet} is using the
+reserve's private key to @ref{74,,withdraw} coins from it. This reduces
the balance of the reserve. Once the balance reaches zero, we say that
the reserve has been (fully) drained. Reserves that are not drained
-(which is the normal process) are @ref{6f,,closed} by the exchange.
-@anchor{taler-developer-manual term-exchange}@anchor{61}
+(which is the normal process) are @ref{70,,closed} by the exchange.
+@anchor{taler-developer-manual term-exchange}@anchor{62}
@geindex exchange
@item exchange
Taler's payment service operator. Issues electronic coins during
withdrawal and redeems them when they are deposited by merchants
-@anchor{taler-developer-manual term-expired}@anchor{87}
+@anchor{taler-developer-manual term-expired}@anchor{88}
@geindex expired
-@item expired@anchor{taler-developer-manual term-expiration}@anchor{88}
+@item expired@anchor{taler-developer-manual term-expiration}@anchor{89}
@geindex expiration
@itemx expiration
@@ -3101,47 +3122,47 @@ 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
-@anchor{taler-developer-manual term-fakebank}@anchor{89}
+@anchor{taler-developer-manual term-fakebank}@anchor{8a}
@geindex fakebank
@item fakebank
-implementation of the @ref{64,,bank} API in memory to be used only for test
+implementation of the @ref{65,,bank} API in memory to be used only for test
cases.
-@anchor{taler-developer-manual term-fee}@anchor{74}
+@anchor{taler-developer-manual term-fee}@anchor{75}
@geindex fee
@item fee
-an @ref{61,,exchange} charges various fees for its service. The different
+an @ref{62,,exchange} charges various fees for its service. The different
fees are specified in the protocol. There are fees per coin for
-@ref{8a,,withdrawing}, @ref{83,,depositing}, @ref{8b,,melting}, and
-@ref{8c,,refunding}. Furthermore, there are fees per wire transfer
-for @ref{70,,closing} a @ref{71,,reserve}: and for
-@ref{60,,aggregate} @ref{8d,,wire transfers} to the @ref{62,,merchant}.
-@anchor{taler-developer-manual term-fresh}@anchor{7b}
+@ref{8b,,withdrawing}, @ref{84,,depositing}, @ref{8c,,melting}, and
+@ref{8d,,refunding}. Furthermore, there are fees per wire transfer
+for @ref{71,,closing} a @ref{72,,reserve}: and for
+@ref{61,,aggregate} @ref{8e,,wire transfers} to the @ref{63,,merchant}.
+@anchor{taler-developer-manual term-fresh}@anchor{7c}
@geindex fresh
-@item fresh@anchor{taler-developer-manual term-fresh-coin}@anchor{8e}
+@item fresh@anchor{taler-developer-manual term-fresh-coin}@anchor{8f}
@geindex fresh coin
@itemx fresh coin
a coin is fresh if its public key is only known to the customer
-@anchor{taler-developer-manual term-GNUnet}@anchor{5e}
+@anchor{taler-developer-manual term-GNUnet}@anchor{5f}
@geindex GNUnet
@item GNUnet
Codebase of various libraries for a better Internet, some of which
GNU Taler depends upon.
-@anchor{taler-developer-manual term-json}@anchor{8f}
+@anchor{taler-developer-manual term-json}@anchor{90}
@geindex json
-@item json@anchor{taler-developer-manual term-JSON}@anchor{90}
+@item json@anchor{taler-developer-manual term-JSON}@anchor{91}
@geindex JSON
-@itemx JSON@anchor{taler-developer-manual term-JavaScript-Object-Notation}@anchor{91}
+@itemx JSON@anchor{taler-developer-manual term-JavaScript-Object-Notation}@anchor{92}
@geindex JavaScript Object Notation
@itemx JavaScript Object Notation
@@ -3149,192 +3170,192 @@ GNU Taler depends upon.
serialization format derived from the JavaScript language which is
commonly used in the Taler protocol as the payload of HTTP requests
and responses.
-@anchor{taler-developer-manual term-kappa}@anchor{7c}
+@anchor{taler-developer-manual term-kappa}@anchor{7d}
@geindex kappa
@item kappa
-security parameter used in the @ref{7a,,refresh} protocol. Defined to be 3.
+security parameter used in the @ref{7b,,refresh} protocol. Defined to be 3.
The probability of successfully evading the income transparency with the
refresh protocol is 1:kappa.
-@anchor{taler-developer-manual term-LibEuFin}@anchor{92}
+@anchor{taler-developer-manual term-LibEuFin}@anchor{93}
@geindex LibEuFin
@item LibEuFin
FIXME: explain
-@anchor{taler-developer-manual term-link}@anchor{93}
+@anchor{taler-developer-manual term-link}@anchor{94}
@geindex link
-@item link@anchor{taler-developer-manual term-linking}@anchor{94}
+@item link@anchor{taler-developer-manual term-linking}@anchor{95}
@geindex linking
@itemx linking
-specific step in the @ref{7a,,refresh} protocol that an exchange must offer
-to prevent abuse of the @ref{7a,,refresh} mechanism. The link step is
+specific step in the @ref{7b,,refresh} protocol that an exchange must offer
+to prevent abuse of the @ref{7b,,refresh} mechanism. The link step is
not needed in normal operation, it just must be offered.
-@anchor{taler-developer-manual term-master-key}@anchor{95}
+@anchor{taler-developer-manual term-master-key}@anchor{96}
@geindex master key
@item master key
offline key used by the exchange to certify denomination keys and
message signing keys
-@anchor{taler-developer-manual term-melt}@anchor{79}
+@anchor{taler-developer-manual term-melt}@anchor{7a}
@geindex melt
-@item melt@anchor{taler-developer-manual term-melted}@anchor{96}
+@item melt@anchor{taler-developer-manual term-melted}@anchor{97}
@geindex melted
-@itemx melted@anchor{taler-developer-manual term-melting}@anchor{8b}
+@itemx melted@anchor{taler-developer-manual term-melting}@anchor{8c}
@geindex melting
@itemx melting
-step of the @ref{7a,,refresh} protocol where a @ref{85,,dirty coin}
-is invalidated to be reborn @ref{7b,,fresh} in a subsequent
-@ref{7d,,reveal} step.
-@anchor{taler-developer-manual term-merchant}@anchor{62}
+step of the @ref{7b,,refresh} protocol where a @ref{86,,dirty coin}
+is invalidated to be reborn @ref{7c,,fresh} in a subsequent
+@ref{7e,,reveal} step.
+@anchor{taler-developer-manual term-merchant}@anchor{63}
@geindex merchant
@item merchant
party receiving payments (usually in return for goods or services)
-@anchor{taler-developer-manual term-message-signing-key}@anchor{97}
+@anchor{taler-developer-manual term-message-signing-key}@anchor{98}
@geindex message signing key
@item message signing key
key used by the exchange to sign online messages, other than coins
-@anchor{taler-developer-manual term-order}@anchor{98}
+@anchor{taler-developer-manual term-order}@anchor{99}
@geindex order
@item order
offer made by the merchant to a wallet; pre-cursor to
a contract where the wallet is not yet fixed. Turns
-into a @ref{7e,,contract} when a wallet claims the order.
-@anchor{taler-developer-manual term-owner}@anchor{99}
+into a @ref{7f,,contract} when a wallet claims the order.
+@anchor{taler-developer-manual term-owner}@anchor{9a}
@geindex owner
@item owner
a coin is owned by the entity that knows the private key of the coin
-@anchor{taler-developer-manual term-planchet}@anchor{9a}
+@anchor{taler-developer-manual term-planchet}@anchor{9b}
@geindex planchet
@item planchet
-precursor data for a @ref{75,,coin}. A planchet includes the coin's internal
+precursor data for a @ref{76,,coin}. A planchet includes the coin's internal
secrets (coin private key, blinding factor), but lacks the RSA signature
-of the @ref{61,,exchange}. When @ref{8a,,withdrawing}, a @ref{68,,wallet}
+of the @ref{62,,exchange}. When @ref{8b,,withdrawing}, a @ref{69,,wallet}
creates and persists a planchet before asking the exchange to sign it to
get the coin.
-@anchor{taler-developer-manual term-privacy-policy}@anchor{9b}
+@anchor{taler-developer-manual term-privacy-policy}@anchor{9c}
@geindex privacy policy
@item privacy policy
Statement of an operator how they will protect the privacy of users.
-@anchor{taler-developer-manual term-proof}@anchor{9c}
+@anchor{taler-developer-manual term-proof}@anchor{9d}
@geindex proof
@item proof
Message that cryptographically demonstrates that a particular claim is correct.
-@anchor{taler-developer-manual term-proposal}@anchor{9d}
+@anchor{taler-developer-manual term-proposal}@anchor{9e}
@geindex proposal
@item proposal
-a list of @ref{7f,,contract terms} that has been completed and signed by the
+a list of @ref{80,,contract terms} that has been completed and signed by the
merchant backend.
-@anchor{taler-developer-manual term-purchase}@anchor{9e}
+@anchor{taler-developer-manual term-purchase}@anchor{9f}
@geindex purchase
@item purchase
-Refers to the overall process of negotiating a @ref{7e,,contract} and then
-making a payment with @ref{6a,,coins} to a @ref{62,,merchant}.
-@anchor{taler-developer-manual term-recoup}@anchor{9f}
+Refers to the overall process of negotiating a @ref{7f,,contract} and then
+making a payment with @ref{6b,,coins} to a @ref{63,,merchant}.
+@anchor{taler-developer-manual term-recoup}@anchor{a0}
@geindex recoup
@item recoup
Operation by which an exchange returns the value of coins affected
-by a @ref{a0,,revocation} to their @ref{99,,owner}, either by allowing the owner to
-withdraw new coins or wiring funds back to the bank account of the @ref{99,,owner}.
-@anchor{taler-developer-manual term-refresh}@anchor{7a}
+by a @ref{a1,,revocation} to their @ref{9a,,owner}, either by allowing the owner to
+withdraw new coins or wiring funds back to the bank account of the @ref{9a,,owner}.
+@anchor{taler-developer-manual term-refresh}@anchor{7b}
@geindex refresh
-@item refresh@anchor{taler-developer-manual term-refreshing}@anchor{a1}
+@item refresh@anchor{taler-developer-manual term-refreshing}@anchor{a2}
@geindex refreshing
@itemx refreshing
-operation by which a @ref{85,,dirty coin} is converted into one or more
-@ref{7b,,fresh} coins. Involves @ref{8b,,melting} the @ref{85,,dirty coin} and
-then @ref{a2,,revealing} so-called @ref{a3,,transfer keys}.
-@anchor{taler-developer-manual term-refund}@anchor{a4}
+operation by which a @ref{86,,dirty coin} is converted into one or more
+@ref{7c,,fresh} coins. Involves @ref{8c,,melting} the @ref{86,,dirty coin} and
+then @ref{a3,,revealing} so-called @ref{a4,,transfer keys}.
+@anchor{taler-developer-manual term-refund}@anchor{a5}
@geindex refund
-@item refund@anchor{taler-developer-manual term-refunding}@anchor{8c}
+@item refund@anchor{taler-developer-manual term-refunding}@anchor{8d}
@geindex refunding
@itemx refunding
operation by which a merchant steps back from the right to funds that he
-obtained from a @ref{81,,deposit} operation, giving the right to the funds back
+obtained from a @ref{82,,deposit} operation, giving the right to the funds back
to the customer
-@anchor{taler-developer-manual term-refund-transaction-id}@anchor{a5}
+@anchor{taler-developer-manual term-refund-transaction-id}@anchor{a6}
@geindex refund transaction id
@item refund transaction id
-unique number by which a merchant identifies a @ref{a4,,refund}. Needed
+unique number by which a merchant identifies a @ref{a5,,refund}. Needed
as refunds can be partial and thus there could be multiple refunds for
-the same @ref{9e,,purchase}.
-@anchor{taler-developer-manual term-relative-time}@anchor{5f}
+the same @ref{9f,,purchase}.
+@anchor{taler-developer-manual term-relative-time}@anchor{60}
@geindex relative time
@item relative time
-method of keeping time in @ref{5e,,GNUnet} where the time is represented
+method of keeping time in @ref{5f,,GNUnet} where the time is represented
as a relative number of microseconds. Thus, a relative time specifies
an offset or a duration, but not a date. Called relative time in
-contrast to @ref{5d,,absolute time}.
-@anchor{taler-developer-manual term-reserve}@anchor{71}
+contrast to @ref{5e,,absolute time}.
+@anchor{taler-developer-manual term-reserve}@anchor{72}
@geindex reserve
@item reserve
accounting mechanism used by the exchange to track customer funds
-from incoming @ref{8d,,wire transfers}. A reserve is created whenever
+from incoming @ref{8e,,wire transfers}. A reserve is created whenever
a customer wires money to the exchange using a well-formed public key
-in the subject. The exchange then allows the customer's @ref{68,,wallet}
-to @ref{73,,withdraw} up to the amount received in @ref{7b,,fresh}
-@ref{6a,,coins} from the reserve, thereby draining the reserve. If a
-reserve is not drained, the exchange eventually @ref{6e,,closes} it.
+in the subject. The exchange then allows the customer's @ref{69,,wallet}
+to @ref{74,,withdraw} up to the amount received in @ref{7c,,fresh}
+@ref{6b,,coins} from the reserve, thereby draining the reserve. If a
+reserve is not drained, the exchange eventually @ref{6f,,closes} it.
Other definition: 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.
-@anchor{taler-developer-manual term-reveal}@anchor{7d}
+@anchor{taler-developer-manual term-reveal}@anchor{7e}
@geindex reveal
-@item reveal@anchor{taler-developer-manual term-revealing}@anchor{a2}
+@item reveal@anchor{taler-developer-manual term-revealing}@anchor{a3}
@geindex revealing
@itemx revealing
-step in the @ref{7a,,refresh} protocol where some of the transfer private
+step in the @ref{7b,,refresh} protocol where some of the transfer private
keys are revealed to prove honest behavior on the part of the wallet.
-In the reveal step, the exchange returns the signed @ref{7b,,fresh} coins.
-@anchor{taler-developer-manual term-revoke}@anchor{a6}
+In the reveal step, the exchange returns the signed @ref{7c,,fresh} coins.
+@anchor{taler-developer-manual term-revoke}@anchor{a7}
@geindex revoke
-@item revoke@anchor{taler-developer-manual term-revocation}@anchor{a0}
+@item revoke@anchor{taler-developer-manual term-revocation}@anchor{a1}
@geindex revocation
@itemx revocation
@@ -3343,109 +3364,109 @@ 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 recoup.
-@anchor{taler-developer-manual term-sharing}@anchor{a7}
+@anchor{taler-developer-manual term-sharing}@anchor{a8}
@geindex sharing
@item sharing
-users can share ownership of a @ref{75,,coin} by sharing access to the coin&#39;s
+users can share ownership of a @ref{76,,coin} by sharing access to the coin&#39;s
private key, thereby allowing all co-owners to spend the coin at any
time.
-@anchor{taler-developer-manual term-spend}@anchor{69}
+@anchor{taler-developer-manual term-spend}@anchor{6a}
@geindex spend
-@item spend@anchor{taler-developer-manual term-spending}@anchor{a8}
+@item spend@anchor{taler-developer-manual term-spending}@anchor{a9}
@geindex spending
@itemx spending
operation by which a customer gives a merchant the right to deposit
coins in return for merchandise
-@anchor{taler-developer-manual term-terms}@anchor{a9}
+@anchor{taler-developer-manual term-terms}@anchor{aa}
@geindex terms
@item terms
the general terms of service of an operator, possibly including
-the @ref{9b,,privacy policy}. Not to be confused with the
-@ref{7f,,contract terms} which are about the specific purchase.
-@anchor{taler-developer-manual term-transaction}@anchor{aa}
+the @ref{9c,,privacy policy}. Not to be confused with the
+@ref{80,,contract terms} which are about the specific purchase.
+@anchor{taler-developer-manual term-transaction}@anchor{ab}
@geindex transaction
@item transaction
method by which ownership is exclusively transferred from one entity
-@anchor{taler-developer-manual term-transfer}@anchor{66}
+@anchor{taler-developer-manual term-transfer}@anchor{67}
@geindex transfer
-@item transfer@anchor{taler-developer-manual term-transfers}@anchor{ab}
+@item transfer@anchor{taler-developer-manual term-transfers}@anchor{ac}
@geindex transfers
-@itemx transfers@anchor{taler-developer-manual term-wire-transfer}@anchor{63}
+@itemx transfers@anchor{taler-developer-manual term-wire-transfer}@anchor{64}
@geindex wire transfer
-@itemx wire transfer@anchor{taler-developer-manual term-wire-transfers}@anchor{8d}
+@itemx wire transfer@anchor{taler-developer-manual term-wire-transfers}@anchor{8e}
@geindex wire transfers
@itemx wire transfers
-method of sending funds between @ref{64,,bank} accounts
-@anchor{taler-developer-manual term-transfer-key}@anchor{ac}
+method of sending funds between @ref{65,,bank} accounts
+@anchor{taler-developer-manual term-transfer-key}@anchor{ad}
@geindex transfer key
-@item transfer key@anchor{taler-developer-manual term-transfer-keys}@anchor{a3}
+@item transfer key@anchor{taler-developer-manual term-transfer-keys}@anchor{a4}
@geindex transfer keys
@itemx transfer keys
-special cryptographic key used in the @ref{7a,,refresh} protocol, some of which
-are revealed during the @ref{7d,,reveal} step. Note that transfer keys have,
-despite the name, no relationship to @ref{8d,,wire transfers}. They merely
-help to transfer the value from a @ref{85,,dirty coin} to a @ref{8e,,fresh coin}
-@anchor{taler-developer-manual term-user}@anchor{ad}
+special cryptographic key used in the @ref{7b,,refresh} protocol, some of which
+are revealed during the @ref{7e,,reveal} step. Note that transfer keys have,
+despite the name, no relationship to @ref{8e,,wire transfers}. They merely
+help to transfer the value from a @ref{86,,dirty coin} to a @ref{8f,,fresh coin}
+@anchor{taler-developer-manual term-user}@anchor{ae}
@geindex user
@item user
any individual using the Taler payment system
-(see @ref{6c,,customer}, @ref{67,,buyer}, @ref{62,,merchant}).
-@anchor{taler-developer-manual term-version}@anchor{ae}
+(see @ref{6d,,customer}, @ref{68,,buyer}, @ref{63,,merchant}).
+@anchor{taler-developer-manual term-version}@anchor{af}
@geindex version
@item version
Taler uses various forms of versioning. There is a database
schema version (stored itself in the database, see *-0000.sql) describing
-the state of the table structure in the database of an @ref{61,,exchange},
-@ref{65,,auditor} or @ref{62,,merchant}. There is a protocol
+the state of the table structure in the database of an @ref{62,,exchange},
+@ref{66,,auditor} or @ref{63,,merchant}. There is a protocol
version (CURRENT:REVISION:AGE, see GNU libtool) which specifies
-the network protocol spoken by an @ref{61,,exchange} or @ref{62,,merchant}
+the network protocol spoken by an @ref{62,,exchange} or @ref{63,,merchant}
including backwards-compatibility. And finally there is the software
release version (MAJOR.MINOR.PATCH, see @indicateurl{https://semver.org/}) of
the respective code base.
-@anchor{taler-developer-manual term-wallet}@anchor{68}
+@anchor{taler-developer-manual term-wallet}@anchor{69}
@geindex wallet
@item wallet
software running on a customer's computer; withdraws, stores and
spends coins
-@anchor{taler-developer-manual term-WebExtension}@anchor{af}
+@anchor{taler-developer-manual term-WebExtension}@anchor{b0}
@geindex WebExtension
@item WebExtension
Cross-browser API used to implement the GNU Taler wallet browser extension.
-@anchor{taler-developer-manual term-wire-gateway}@anchor{b0}
+@anchor{taler-developer-manual term-wire-gateway}@anchor{b1}
@geindex wire gateway
@item wire gateway
FIXME: explain
-@anchor{taler-developer-manual term-wire-transfer-identifier}@anchor{b1}
+@anchor{taler-developer-manual term-wire-transfer-identifier}@anchor{b2}
@geindex wire transfer identifier
-@item wire transfer identifier@anchor{taler-developer-manual term-wtid}@anchor{b2}
+@item wire transfer identifier@anchor{taler-developer-manual term-wtid}@anchor{b3}
@geindex wtid
@itemx wtid
@@ -3453,35 +3474,35 @@ FIXME: explain
Subject of a wire transfer from the exchange to a merchant;
set by the aggregator to a random nonce which uniquely
identifies the transfer.
-@anchor{taler-developer-manual term-withdraw}@anchor{73}
+@anchor{taler-developer-manual term-withdraw}@anchor{74}
@geindex withdraw
-@item withdraw@anchor{taler-developer-manual term-withdrawing}@anchor{8a}
+@item withdraw@anchor{taler-developer-manual term-withdrawing}@anchor{8b}
@geindex withdrawing
-@itemx withdrawing@anchor{taler-developer-manual term-withdrawal}@anchor{b3}
+@itemx withdrawing@anchor{taler-developer-manual term-withdrawal}@anchor{b4}
@geindex withdrawal
@itemx withdrawal
-operation by which a @ref{68,,wallet} can convert funds from a @ref{71,,reserve} to
+operation by which a @ref{69,,wallet} can convert funds from a @ref{72,,reserve} to
fresh coins
-@anchor{taler-developer-manual term-zombie}@anchor{b4}
+@anchor{taler-developer-manual term-zombie}@anchor{b5}
@geindex zombie
-@item zombie@anchor{taler-developer-manual term-zombie-coin}@anchor{b5}
+@item zombie@anchor{taler-developer-manual term-zombie-coin}@anchor{b6}
@geindex zombie coin
@itemx zombie coin
-coin where the respective @ref{80,,denomination key} is past its
-@ref{81,,deposit} @ref{88,,expiration} time, but which is still (again) valid
-for an operation because it was @ref{96,,melted} while it was still
-valid, and then later again credited during a @ref{9f,,recoup} process
+coin where the respective @ref{81,,denomination key} is past its
+@ref{82,,deposit} @ref{89,,expiration} time, but which is still (again) valid
+for an operation because it was @ref{97,,melted} while it was still
+valid, and then later again credited during a @ref{a0,,recoup} process
@end table
@node Developer Tools,Index,Developer Glossary,Top
-@anchor{taler-developer-manual developer-tools}@anchor{b6}
+@anchor{taler-developer-manual developer-tools}@anchor{b7}
@chapter Developer Tools
@@ -3494,7 +3515,7 @@ developer.
@end menu
@node taler-harness,,,Developer Tools
-@anchor{taler-developer-manual taler-harness}@anchor{b7}
+@anchor{taler-developer-manual taler-harness}@anchor{b8}
@section taler-harness