summaryrefslogtreecommitdiff
path: root/man/taler-exchange-offline.1
diff options
context:
space:
mode:
authorChristian Grothoff <christian@grothoff.org>2022-11-03 23:37:59 +0100
committerChristian Grothoff <christian@grothoff.org>2022-11-03 23:37:59 +0100
commit8452f991dd967328207fab52a99beb19e2cb4dff (patch)
tree5d28f2ab91b64a13ab22f5d9a12de3c2fa3c02e3 /man/taler-exchange-offline.1
parentb988d98d4856758484eb23c27bfdc9e602d4235a (diff)
downloaddocs-8452f991dd967328207fab52a99beb19e2cb4dff.tar.gz
docs-8452f991dd967328207fab52a99beb19e2cb4dff.tar.bz2
docs-8452f991dd967328207fab52a99beb19e2cb4dff.zip
update prebuilt from source
Diffstat (limited to 'man/taler-exchange-offline.1')
-rw-r--r--man/taler-exchange-offline.132
1 files changed, 26 insertions, 6 deletions
diff --git a/man/taler-exchange-offline.1 b/man/taler-exchange-offline.1
index b6e17644..bc02e1cc 100644
--- a/man/taler-exchange-offline.1
+++ b/man/taler-exchange-offline.1
@@ -1,6 +1,6 @@
.\" Man page generated from reStructuredText.
.
-.TH "TALER-EXCHANGE-OFFLINE" "1" "Jul 06, 2022" "0.9" "GNU Taler"
+.TH "TALER-EXCHANGE-OFFLINE" "1" "Nov 03, 2022" "0.9" "GNU Taler"
.SH NAME
taler-exchange-offline \- operations using the offline key of a Taler exchange
.
@@ -166,6 +166,26 @@ subcommand.
Note that an extension on the exchange will only become activated at runtime
\fIafter\fP the extension\(aqs configurations has been signed by the offline tool with
the signing key and the signed configuration been uploaded to the exchange.
+.SS drain
+.sp
+This subcommand allows an exchange operator to transfer the
+profits made from transaction fees to a regular (non\-escrowed) bank
+account. Using this command, draining profits from the
+escrow account can be done in such a way that the auditor
+is aware of the special transaction and does not flag the
+resulting balance as fundamentally problematic. Note that
+the drained amounts must still total up to less than the fees
+earned by the exchange.
+.sp
+Arguments to the \fBdrain\fP command are the amount to be drained (in the usual
+Taler amount format), the section of the exchange configuration specifying the
+account to be debited (this argument is currently ignored, and the account is
+purely derived from the wire method and the account being set for debiting),
+and finally the payto://\-URI to wire the funds to.
+.sp
+Note that to actually wire the funds, the exchange administrator must run
+\fBtaler\-exchange\-drain\fP manually and confirm the operation after the
+\fBupload\fP was completed.
.SS revoke\-denomination
.sp
This subcommand signs a revocation message for a denomination key.
@@ -233,7 +253,7 @@ the exchange on its \fB/wire\fP endpoint. Note that this does \fInot\fP ensure
the exchange will use this bank account for incoming or outgoing wire
transfers! For this, the \fBtaler\-exchange\-transfer\fP and
\fBtaler\-exchange\-wirewatch\fP tools must be configured. Furthermore, the bank
-account information advertized could theoretically differ from that which
+account information advertised could theoretically differ from that which
these tool actually use, for example if the public bank account is only a
front for the actual internal business accounts.
.sp
@@ -259,13 +279,13 @@ It outputs the signature affirming the deletion of the wire account, in a
format suitable for the \fBupload\fP subcommand.
.SS wire\-fee
.sp
-This subcommand informs an exchange about the desired wire fee structure (that is, wire, closing and wad fees)
+This subcommand informs an exchange about the desired wire fee structure (that is, wire, and closing fees)
for particular wire method and a calendar year (!). The tool does not
permit changing wire fees during a calendar year. Also, once the wire fee has been
set for a calendar year, it cannot be changed.
.sp
The subcommand takes the year, wire\-method (see RFC 8905, examples include
-\fBx\-taler\-bank\fP or \fBiban\fP), wire fee, closing fee and wad fee as arguments.
+\fBx\-taler\-bank\fP or \fBiban\fP), wire fee, and closing fee as arguments.
Instead of a year, the string \fBnow\fP can be given for the current year
(this is mostly useful for test cases). The wire\-method should follow the
GANA registry as given in RFC 8905. The fees must be given in the usual
@@ -282,8 +302,8 @@ related global configuration options for a calendar year (!). The tool does
not permit changing global fees during a calendar year. Also, once the global
fee structure has been set for a calendar year, it cannot be changed.
.sp
-The subcommand takes the year, history fee, kyc fee, account fee, purse fee,
-purse timeout, kyc timeout, history expiration and the (free) purse (per)
+The subcommand takes the year, history fee, account fee, purse fee,
+purse timeout, history expiration and the (free) purse (per)
account limit as arguments. Instead of a year, the string \fBnow\fP can be
given for the current year (this is mostly useful for test cases). The fees
must be given in the usual Taler format of \fBCURRENCY:NUMBER.FRACTION\fP\&.