[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[taler-docs] branch master updated (dbd8c24 -> e82c810)
|
From: |
gnunet |
|
Subject: |
[taler-docs] branch master updated (dbd8c24 -> e82c810) |
|
Date: |
Fri, 19 Mar 2021 08:11:30 +0100 |
This is an automated email from the git hooks/post-receive script.
ttn pushed a change to branch master
in repository docs.
from dbd8c24 set ‘total_stock’ to be "infinite" (-1) for product ‘f001’
new cfc23a5 fix typo: s/obtian/obtain/
new abd53c4 capitalize first word in sentence
new 935dcf5 change markup of ‘stamp_start’ and ‘/keys’ from " to ``
new 3d86774 fold long line; change markup of ‘denoms’ and ‘signkeys’ from
' to ``; add period at end of sentence
new f6c8f00 capitalize first word in sentence
new d64d450 fix typo: s/a/an/
new d610dcb mark up ‘/keys’
new 745cc17 add period at end of sentence (five instances)
new 9101ad9 capitalize first word in sentence; mark up ‘/recoup’
new e18a801 mark up ‘/recoup’
new ec09e39 mark up ‘TALER_SIGNATURE_MASTER_SIGNING_KEY_VALIDITY’
new 3e42770 add period at end of sentence
new a7f1fdc capitalize first word in sentence
new 319640d add period at end of sentence
new bb68c2f mark up ‘/keys’
new 221836f mark up ‘payto://’
new 8d32c56 mark up ‘TALER_SIGNATURE_MASTER_WIRE_DETAILS’
new 60e6d8e fold long line; mark up ‘TALER_SIGNATURE_MASTER_WIRE_FEES’;
add period at end of sentence
new f1eab8c add period at end of sentence (four instances)
new ab800c1 fix typo: s/pbulic/public/
new f564666 add period at end of sentence
new 3bcb03f mark up ‘TALER_SIGNATURE_MASTER_SIGNING_KEY_VALIDITY’
new 0e750df fix typo: s/prevending/preventing/
new 07c4721 mark up ‘TALER_SIGNATURE_MASTER_DENOMINATION_KEY_REVOKED’;
add period at end of sentence
new 86df5ec fix typo: s/prevending/preventing/
new f25fc5a mark up ‘TALER_SIGNATURE_MASTER_SIGN_KEY_REVOKED’; add period
at end of sentence
new fd58df0 capitalize first word in sentence; add period at end of
sentence (two instances)
new 3ad9612 mark up ‘TALER_SIGNATURE_MASTER_AUDITOR_ADD’
new de47ed2 mark up ‘TALER_SIGNATURE_MASTER_AUDITOR_DEL’
new 83c85cf fix typo: s/setup/set up/
new a48332b capitalize first word in sentence; add period at end of
sentence
new 7095e00 mark up ‘TALER_SIGNATURE_MASTER_WIRE_FEES’
new 6820a87 mark up ‘payto://’
new 04c39cb mark up ‘TALER_SIGNATURE_MASTER_WIRE_DETAILS’
new 7e26dd4 mark up ‘TALER_SIGNATURE_MASTER_WIRE_ADD’
new bb520c2 mark up ‘payto://’
new 99ce3a8 mark up ‘TALER_SIGNATURE_MASTER_WIRE_DEL’
new 3395b59 mark up ‘TALER_SIGNATURE_AUDITOR_XXX’
new 94971ca add article "the"
new 7240987 remove spurious space; change end-of-sentence punctuation
from comma to period
new 1b4edb9 add period at end of sentence
new af08501 add period at end of sentence
new 54e2e7c change markup of ‘TALER_WithdrawRequestPS’ from ' to ``
new d29b988 fix typo: s/reserves's/reserve's/
new 25cf8a9 mark up ‘payto://’; add period at end of sentence
new 2f2d029 mark up ‘payto://’
new dd051cb mark up ‘TALER_ReserveCloseConfirmationPS’,
‘TALER_SIGNATURE_EXCHANGE_RESERVE_CLOSED’
new 5ac9511 mark up ‘exchange_sig’
new 8dcecb1 mark up ‘TALER_PaybackConfirmationPS’,
‘TALER_SIGNATURE_EXCHANGE_CONFIRM_PAYBACK’
new ed39ec1 mark up ‘exchange_sig’
new 904514d capitalize first word in sentence; add period at end of
sentence
new 5b9aaff fold long line; add period at end of sentence
new 5e19af7 add period at end of sentence (three instances)
new 63733c6 fold long line; mark up ‘/reserve/status’
new 038bb44 fix typo: s/merchants/merchant's/
new 0c3ebf7 change markup of ‘/coins/’ from " to ``
new e464776 mark up ‘payto_uri’, ‘h_wire’
new 7e2a7c7 fix typo: s/contact/contract/
new 70f224c add period at end of sentence
new de1a7d8 capitalize first word in sentence; add period at end of
sentence
new ee9e4f7 capitalize first word in sentence (three instances)
new 74f8f31 add period at end of sentence
new 12a66ec mark up ‘/transactions/’, ‘/coins/’, ‘transaction_base_url’
new be80321 capitalize first word in sentence (three instances)
new 420e328 mark up ‘/keys’
new ef10257 add period at end of sentence (two instances)
new b5d5d61 add period at end of sentence
new 8dc4cc6 capitalize first word in sentence (three instances)
new 94c431f add period at end of sentence (five instances)
new ecc93f0 capitalize first word in sentence (two instances)
new 540e123 mark up ‘/refresh/link’ (two instances)
new 5983881 fix typo: s/exchangeing/exchanging/
new 1ff469f change markup of ‘/coins/’ from " to ``
new 5219ba3 capitalize first word in sentence; add period at end of
sentence
new a339c00 add period at end of sentence
new aa833ae add period at end of sentence
new 3d2e6aa capitalize first word in sentence
new 01443b8 mark up ‘/keys’
new 456c624 mark up ‘/refreshes/’, ‘/coins/’, ‘refresh_base_url’
new 40fb808 add period at end of sentence
new c7abf3f capitalize first word in sentence; add period at end of
sentence (four instances)
new 1e279e9 mark up ‘/coins/’
new 0f25dcc mark up ‘/coins/’
new f254899 change markup for ‘/refreshes/’ from " to ``
new c2f0105 change markup for ‘refresh_base_url’ from " to `` (two
instances)
new 873db27 add period at end of sentence
new bf0315a add period at end of sentence
new f0268a2 capitalize first word in sentence
new 1bf6ccf add period at end of sentence
new ca41545 add period at end of sentence (two instances)
new 7044892 fix typo: s/exchangeed/exchanged/
new b5acd29 capitalize first word in sentence (two instances)
new d674097 add period at end of sentence
new c2f489f mark up ‘/keys’
new e21b7a5 change markup of ‘/coins/’ from " to ``
new c3b049b capitalize first word in sentence; add period at end of
sentence
new 4d5519f fold long line; add period at end of sentence
new d338e77 change markup of ‘false’ from " to ``; add period at end of
sentence
new e28c823 mark up ‘RecoupConfirmation’ (two instances)
new e5e88e2 add period at end of sentence (two instances)
new 4742894 capitalize first word in sentence; add period at end of
sentence (two instances)
new dee8128 fix typo: s/least/lest/
new c81ba6f add period at end of sentence
new 1f6f6e3 capitalize first word in sentence; add period at end of
sentence (four instances)
new ab205f9 add period at end of sentence
new 65d9a83 capitalize first word in sentence
new d06b653 mark up ‘/keys’
new be94174 capitalize first word in sentence
new 7874307 capitalize first word in sentence; add period at end of
sentence
new 66420c2 remove spurious space
new a71e5ee add period at end of sentence
new e903b80 capitalize first word in sentence (four instances)
new 00f8698 add period at end of sentence
new ff2fba5 capitalize first word in sentence
new 6174911 add period at end of sentence
new 06db6d1 capitalize first word in sentence; add period at end of
sentence
new 4d0d922 capitalize first word in sentence
new c3bbe75 mark up ‘/keys’
new e82c810 add period at end of sentence
The 119 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails. The revisions
listed as "add" were already present in the repository and have only
been added to this reference.
Summary of changes:
core/api-exchange.rst | 335 +++++++++++++++++++++++++-------------------------
1 file changed, 170 insertions(+), 165 deletions(-)
diff --git a/core/api-exchange.rst b/core/api-exchange.rst
index 7d951a6..1e9db1d 100644
--- a/core/api-exchange.rst
+++ b/core/api-exchange.rst
@@ -30,7 +30,7 @@ defines all specific terms used in this section.
Terms of service API
--------------------
-These APIs allow merchants and wallets to obtian the terms of service
+These APIs allow merchants and wallets to obtain the terms of service
and the privacy policy of an exchange.
@@ -101,7 +101,7 @@ possibly by using HTTPS.
**Request:**
- :query last_issue_date: optional argument specifying the maximum value of
any of the "stamp_start" members of the denomination keys of a "/keys" response
that is already known to the client. Allows the exchange to only return keys
that have changed since that timestamp. The given value must be an unsigned
64-bit integer representing seconds after 1970. If the timestamp does not
exactly match the "stamp_start" of one of the denomination keys, all keys are
returned.
+ :query last_issue_date: Optional argument specifying the maximum value of
any of the ``stamp_start`` members of the denomination keys of a ``/keys``
response that is already known to the client. Allows the exchange to only
return keys that have changed since that timestamp. The given value must be an
unsigned 64-bit integer representing seconds after 1970. If the timestamp does
not exactly match the ``stamp_start`` of one of the denomination keys, all keys
are returned.
**Response:**
@@ -123,7 +123,8 @@ possibly by using HTTPS.
// The exchange's currency.
currency: string;
- // EdDSA master public key of the exchange, used to sign entries in
'denoms' and 'signkeys'
+ // EdDSA master public key of the exchange, used to sign entries
+ // in ``denoms`` and ``signkeys``.
master_public_key: EddsaPublicKey;
// Relative duration until inactive reserves are closed; not signed,
expressed as
@@ -145,19 +146,19 @@ possibly by using HTTPS.
// The exchange's signing keys.
signkeys: SignKey[];
- // compact EdDSA `signature` (binary-only) over the SHA-512 hash of the
+ // Compact EdDSA `signature` (binary-only) over the SHA-512 hash of the
// concatenation of all SHA-512 hashes of the RSA denomination public
keys
// in ``denoms`` in the same order as they were in ``denoms``. Note
that for
// hashing, the binary format of the RSA public keys is used, and not
their
// `base32 encoding <base32>`. Wallets cannot do much with this
signature by itself;
// it is only useful when multiple clients need to establish that the
exchange
// is sabotaging end-user anonymity by giving disjoint denomination keys
to
- // different users. If a exchange were to do this, this signature
allows the
+ // different users. If an exchange were to do this, this signature
allows the
// clients to demonstrate to the public that the exchange is dishonest.
eddsa_sig: EddsaSignature;
// Public EdDSA key of the exchange that was used to generate the
signature.
- // Should match one of the exchange's signing keys from /keys. It is
given
+ // Should match one of the exchange's signing keys from ``/keys``. It
is given
// explicitly as the client might otherwise be confused by clock skew as
to
// which signing key was used.
eddsa_pub: EddsaPublicKey;
@@ -184,19 +185,19 @@ possibly by using HTTPS.
// Public (RSA) key for the denomination.
denom_pub: RsaPublicKey;
- // Fee charged by the exchange for withdrawing a coin of this
denomination
+ // Fee charged by the exchange for withdrawing a coin of this
denomination.
fee_withdraw: Amount;
- // Fee charged by the exchange for depositing a coin of this denomination
+ // Fee charged by the exchange for depositing a coin of this
denomination.
fee_deposit: Amount;
- // Fee charged by the exchange for refreshing a coin of this denomination
+ // Fee charged by the exchange for refreshing a coin of this
denomination.
fee_refresh: Amount;
- // Fee charged by the exchange for refunding a coin of this denomination
+ // Fee charged by the exchange for refunding a coin of this denomination.
fee_refund: Amount;
- // Signature of `TALER_DenominationKeyValidityPS`
+ // Signature of `TALER_DenominationKeyValidityPS`.
master_sig: EddsaSignature;
}
@@ -209,14 +210,14 @@ possibly by using HTTPS.
.. ts:def:: Recoup
interface Recoup {
- // hash of the public key of the denomination that is being revoked under
- // emergency protocol (see /recoup).
+ // Hash of the public key of the denomination that is being revoked under
+ // emergency protocol (see ``/recoup``).
h_denom_pub: HashCode;
// We do not include any signature here, as the primary use-case for
// this emergency involves the exchange having lost its signing keys,
// so such a signature here would be pretty worthless. However, the
- // exchange will not honor /recoup requests unless they are for
+ // exchange will not honor ``/recoup`` requests unless they are for
// denomination keys listed here.
}
@@ -240,7 +241,7 @@ possibly by using HTTPS.
stamp_end: Timestamp;
// Signature over ``key`` and ``stamp_expire`` by the exchange master
key.
- // Must have purpose TALER_SIGNATURE_MASTER_SIGNING_KEY_VALIDITY.
+ // Must have purpose ``TALER_SIGNATURE_MASTER_SIGNING_KEY_VALIDITY``.
master_sig: EddsaSignature;
}
@@ -255,7 +256,7 @@ possibly by using HTTPS.
// The auditor's URL.
auditor_url: string;
- // The auditor's name (for humans)
+ // The auditor's name (for humans).
auditor_name: string;
// An array of denomination keys the auditor affirms with its signature.
@@ -268,13 +269,13 @@ possibly by using HTTPS.
.. ts:def:: AuditorDenominationKey
interface AuditorDenominationKey {
- // hash of the public RSA key used to sign coins of the respective
+ // Hash of the public RSA key used to sign coins of the respective
// denomination. Note that the auditor's signature covers more than just
// the hash, but this other information is already provided in
``denoms`` and
// thus not repeated here.
denom_pub_h: HashCode;
- // Signature of `TALER_ExchangeKeyValidityPS`
+ // Signature of `TALER_ExchangeKeyValidityPS`.
auditor_sig: EddsaSignature;
}
@@ -306,7 +307,7 @@ possibly by using HTTPS.
interface WireResponse {
- // Master public key of the exchange, must match the key returned in
/keys.
+ // Master public key of the exchange, must match the key returned in
``/keys``.
master_public_key: EddsaPublicKey;
// Array of wire accounts operated by the exchange for
@@ -323,11 +324,11 @@ possibly by using HTTPS.
.. ts:def:: WireAccount
interface WireAccount {
- // payto:// URI identifying the account and wire method
+ // ``payto://`` URI identifying the account and wire method
payto_uri: string;
// Signature using the exchange's offline key
- // with purpose TALER_SIGNATURE_MASTER_WIRE_DETAILS.
+ // with purpose ``TALER_SIGNATURE_MASTER_WIRE_DETAILS``.
master_sig: EddsaSignature;
}
@@ -355,7 +356,8 @@ possibly by using HTTPS.
// any of the denomination keys are valid without overlap.
end_date: Timestamp;
- // Signature of `TALER_MasterWireFeePS` with purpose
TALER_SIGNATURE_MASTER_WIRE_FEES
+ // Signature of `TALER_MasterWireFeePS` with
+ // purpose ``TALER_SIGNATURE_MASTER_WIRE_FEES``.
sig: EddsaSignature;
}
@@ -429,16 +431,16 @@ Management operations authorized by master key
// Public (RSA) key for the denomination.
denom_pub: RsaPublicKey;
- // Fee charged by the exchange for withdrawing a coin of this
denomination
+ // Fee charged by the exchange for withdrawing a coin of this
denomination.
fee_withdraw: Amount;
- // Fee charged by the exchange for depositing a coin of this denomination
+ // Fee charged by the exchange for depositing a coin of this
denomination.
fee_deposit: Amount;
- // Fee charged by the exchange for refreshing a coin of this denomination
+ // Fee charged by the exchange for refreshing a coin of this
denomination.
fee_refresh: Amount;
- // Fee charged by the exchange for refunding a coin of this denomination
+ // Fee charged by the exchange for refunding a coin of this denomination.
fee_refund: Amount;
// Signature over this denomination by the denomination security module.
@@ -503,10 +505,10 @@ Management operations authorized by master key
interface DenomSignature {
- // Hash of the pbulic (RSA) key of the denomination.
+ // Hash of the public (RSA) key of the denomination.
h_denom_pub: HashCode;
- // Signature of `TALER_DenominationKeyValidityPS`
+ // Signature of `TALER_DenominationKeyValidityPS`.
master_sig: EddsaSignature;
}
@@ -518,7 +520,7 @@ Management operations authorized by master key
key: EddsaPublicKey;
// Signature by the exchange master key.
- // Must have purpose TALER_SIGNATURE_MASTER_SIGNING_KEY_VALIDITY.
+ // Must have purpose ``TALER_SIGNATURE_MASTER_SIGNING_KEY_VALIDITY``.
master_sig: EddsaSignature;
}
@@ -526,7 +528,7 @@ Management operations authorized by master key
.. http:post:: /management/denominations/$H_DENOM_PUB/revoke
- Revoke denomination key, prevending further use by the exchange.
+ Revoke denomination key, preventing further use by the exchange.
Only to be used by the exchange's offline key management team. Not useful
for anyone else.
@@ -546,14 +548,14 @@ Management operations authorized by master key
interface DenomRevocationSignature {
// Signature by the exchange master key.
- // Must have purpose TALER_SIGNATURE_MASTER_DENOMINATION_KEY_REVOKED
+ // Must have purpose ``TALER_SIGNATURE_MASTER_DENOMINATION_KEY_REVOKED``.
master_sig: EddsaSignature;
}
.. http:post:: /management/signkeys/$EXCHANGE_PUB/revoke
- Revoke exchange online signing key, prevending further use by the exchange.
+ Revoke exchange online signing key, preventing further use by the exchange.
Only to be used by the exchange's offline key management team. Not useful
for anyone else.
@@ -573,7 +575,7 @@ Management operations authorized by master key
interface SignkeyRevocationSignature {
// Signature by the exchange master key.
- // Must have purpose TALER_SIGNATURE_MASTER_SIGN_KEY_REVOKED
+ // Must have purpose ``TALER_SIGNATURE_MASTER_SIGN_KEY_REVOKED``.
master_sig: EddsaSignature;
}
@@ -602,17 +604,17 @@ Management operations authorized by master key
interface AuditorSetupMessage {
- // base URL of the auditor
+ // Base URL of the auditor.
auditor_url: string;
- // human-readable name of the auditor
+ // Human-readable name of the auditor.
auditor_name: string;
// The auditor's EdDSA signing public key.
auditor_pub: EddsaPublicKey;
// Signature by the exchange master key.
- // Must have purpose TALER_SIGNATURE_MASTER_AUDITOR_ADD.
+ // Must have purpose ``TALER_SIGNATURE_MASTER_AUDITOR_ADD``.
master_sig: EddsaSignature;
// When does the auditor become active?
@@ -656,7 +658,7 @@ Management operations authorized by master key
interface AuditorTeardownMessage {
// Signature by the exchange master key.
- // Must have purpose TALER_SIGNATURE_MASTER_AUDITOR_DEL.
+ // Must have purpose ``TALER_SIGNATURE_MASTER_AUDITOR_DEL``.
master_sig: EddsaSignature;
// When does the auditor become inactive?
@@ -685,7 +687,7 @@ Management operations authorized by master key
:http:statuscode:`403 Forbidden`:
The master signature is invalid.
:http:statuscode:`409 Conflict`:
- The exchange has a conflicting wire fee already setup.
+ The exchange has a conflicting wire fee already set up.
:http:statuscode:`412 Precondition failed`:
The currency used is different from the currency of the exchange.
@@ -695,11 +697,11 @@ Management operations authorized by master key
interface WireFeeSetupMessage {
- // wire method the fee applies to
+ // Wire method the fee applies to.
wire_method: string;
// Signature using the exchange's offline key
- // with purpose TALER_SIGNATURE_MASTER_WIRE_FEES.
+ // with purpose ``TALER_SIGNATURE_MASTER_WIRE_FEES``.
master_sig_wire: EddsaSignature;
// When does the wire fee validity period start?
@@ -741,15 +743,15 @@ Management operations authorized by master key
interface WireSetupMessage {
- // payto:// URL identifying the account and wire method
+ // ``payto://`` URL identifying the account and wire method
payto_uri: string;
// Signature using the exchange's offline key
- // with purpose TALER_SIGNATURE_MASTER_WIRE_DETAILS.
+ // with purpose ``TALER_SIGNATURE_MASTER_WIRE_DETAILS``.
master_sig_wire: EddsaSignature;
// Signature using the exchange's offline key
- // with purpose TALER_SIGNATURE_MASTER_WIRE_ADD.
+ // with purpose ``TALER_SIGNATURE_MASTER_WIRE_ADD``.
master_sig_add: EddsaSignature;
// When does the wire method become active?
@@ -792,11 +794,11 @@ Management operations authorized by master key
interface WireTeardownMessage {
- // payto:// URL identifying the account and wire method
+ // ``payto://`` URL identifying the account and wire method
payto_uri: string;
// Signature using the exchange's offline key
- // with purpose TALER_SIGNATURE_MASTER_WIRE_DEL.
+ // with purpose ``TALER_SIGNATURE_MASTER_WIRE_DEL``.
master_sig_del: EddsaSignature;
// Should be the time when the signature was created,
@@ -850,7 +852,7 @@ This part of the API is for the use by auditors interacting
with the exchange.
interface AuditorSignatureAddMessage {
// Signature by the auditor.
- // Must have purpose TALER_SIGNATURE_AUDITOR_XXX.
+ // Must have purpose ``TALER_SIGNATURE_AUDITOR_XXX``.
auditor_sig: EddsaSignature;
}
@@ -885,7 +887,7 @@ exchange.
The client currently does not have to demonstrate knowledge of the private
key of the reserve to make this request, which makes the reserve's public
key privileged information known only to the client, their bank, and the
- exchange. In future, we might wish to revisit this decision to improve
+ exchange. In the future, we might wish to revisit this decision to improve
security, such as by having the client EdDSA-sign an ECDHE key to be used
to derive a symmetric key to encrypt the response. This would be useful if
for example HTTPS were not used for communication with the exchange.
@@ -895,7 +897,7 @@ exchange.
**Response:**
:http:statuscode:`200 OK`:
- The exchange responds with a `ReserveStatus` object; the reserve was
known to the exchange,
+ The exchange responds with a `ReserveStatus` object; the reserve was known
to the exchange.
:http:statuscode:`404 Not found`:
The reserve key does not belong to a reserve known to the exchange.
@@ -907,7 +909,7 @@ exchange.
// Balance left in the reserve.
balance: Amount;
- // Transaction history for this reserve
+ // Transaction history for this reserve.
history: TransactionHistoryItem[];
}
@@ -933,10 +935,10 @@ exchange.
// Hash of the denomination public key of the coin.
h_denom_pub: HashCode;
- // Hash of the blinded coin to be signed
+ // Hash of the blinded coin to be signed.
h_coin_envelope: HashCode;
- // Signature of 'TALER_WithdrawRequestPS' created with the reserves's
+ // Signature of ``TALER_WithdrawRequestPS`` created with the reserve's
// private key.
reserve_sig: EddsaSignature;
@@ -953,7 +955,7 @@ exchange.
// Amount deposited.
amount: Amount;
- // Sender account payto://-URL
+ // Sender account ``payto://`` URL.
sender_account_url: string;
// Opaque identifier internal to the exchange that
@@ -979,15 +981,15 @@ exchange.
// Wire transfer subject.
wtid: string;
- // payto:// URI of the wire account into which the funds were returned
to.
+ // ``payto://`` URI of the wire account into which the funds were
returned to.
receiver_account_details: string;
// This is a signature over a
- // struct TALER_ReserveCloseConfirmationPS with purpose
- // TALER_SIGNATURE_EXCHANGE_RESERVE_CLOSED.
+ // struct ``TALER_ReserveCloseConfirmationPS`` with purpose
+ // ``TALER_SIGNATURE_EXCHANGE_RESERVE_CLOSED``.
exchange_sig: EddsaSignature;
- // Public key used to create exchange_sig.
+ // Public key used to create ``exchange_sig``.
exchange_pub: EddsaPublicKey;
// Time when the reserve was closed.
@@ -1004,11 +1006,11 @@ exchange.
amount: Amount;
// This is a signature over
- // a struct TALER_PaybackConfirmationPS with purpose
- // TALER_SIGNATURE_EXCHANGE_CONFIRM_PAYBACK.
+ // a struct ``TALER_PaybackConfirmationPS`` with purpose
+ // ``TALER_SIGNATURE_EXCHANGE_CONFIRM_PAYBACK``.
exchange_sig: EddsaSignature;
- // Public key used to create exchange_sig.
+ // Public key used to create ``exchange_sig``.
exchange_pub: EddsaPublicKey;
// Time when the funds were paid back into the reserve.
@@ -1063,11 +1065,12 @@ exchange.
// would like the exchange to create.
denom_pub_hash: HashCode;
- // coin's blinded public key, should be (blindly) signed by the
exchange's
- // denomination private key
+ // Coin's blinded public key, should be (blindly) signed by the
exchange's
+ // denomination private key.
coin_ev: CoinEnvelope;
- // Signature of `TALER_WithdrawRequestPS` created with the `reserves's
private key <reserve-priv>`
+ // Signature of `TALER_WithdrawRequestPS` created with
+ // the `reserves's private key <reserve-priv>`.
reserve_sig: EddsaSignature;
}
@@ -1085,16 +1088,17 @@ exchange.
.. ts:def:: WithdrawError
interface WithdrawError {
- // Text describing the error
+ // Text describing the error.
hint: string;
- // Detailed error code
+ // Detailed error code.
code: Integer;
- // Amount left in the reserve
+ // Amount left in the reserve.
balance: Amount;
- // History of the reserve's activity, in the same format as returned by
/reserve/status.
+ // History of the reserve's activity, in the same format
+ // as returned by ``/reserve/status``.
history: TransactionHistoryItem[]
}
@@ -1117,10 +1121,10 @@ denomination.
.. http:POST:: /coins/$COIN_PUB/deposit
Deposit the given coin and ask the exchange to transfer the given
:ref:`amount`
- to the merchants bank account. This API is used by the merchant to redeem
+ to the merchant's bank account. This API is used by the merchant to redeem
the digital coins.
- The base URL for "/coins/"-requests may differ from the main base URL of the
+ The base URL for ``/coins/``-requests may differ from the main base URL of
the
exchange. The exchange MUST return a 307 or 308 redirection to the correct
base URL if this is the case.
@@ -1159,8 +1163,8 @@ denomination.
contribution: Amount;
// The merchant's account details.
- // The salt is used to hide the payto_uri from customers
- // that learn the h_wire of the merchant.
+ // The salt is used to hide the ``payto_uri`` from customers
+ // that learn the ``h_wire`` of the merchant.
wire: {
payto_uri: string;
salt: HashCode;
@@ -1170,20 +1174,20 @@ denomination.
// strictly speaking redundant, this helps detect inconsistencies.
h_wire: HashCode;
- // SHA-512 hash of the contact of the merchant with the customer.
Further
+ // SHA-512 hash of the contract of the merchant with the customer.
Further
// details are never disclosed to the exchange.
h_contract_terms: HashCode;
- // Hash of denomination RSA key with which the coin is signed
+ // Hash of denomination RSA key with which the coin is signed.
denom_pub_hash: HashCode;
- // exchange's unblinded RSA signature of the coin
+ // Exchange's unblinded RSA signature of the coin.
ub_sig: RsaSignature;
- // timestamp when the contract was finalized.
+ // Timestamp when the contract was finalized.
timestamp: Timestamp;
- // indicative time by which the exchange undertakes to transfer the
funds to
+ // Indicative time by which the exchange undertakes to transfer the
funds to
// the merchant, in case of successful payment.
wire_transfer_deadline: Timestamp;
@@ -1191,12 +1195,12 @@ denomination.
// merchant for refund requests.
merchant_pub: EddsaPublicKey;
- // date until which the merchant can issue a refund to the customer via
the
+ // Date until which the merchant can issue a refund to the customer via
the
// exchange, possibly zero if refunds are not allowed.
refund_deadline: Timestamp;
// Signature of `TALER_DepositRequestPS`, made by the customer with the
- // `coin's private key <coin-priv>`
+ // `coin's private key <coin-priv>`.
coin_sig: EddsaSignature;
}
@@ -1209,26 +1213,26 @@ denomination.
// Optional base URL of the exchange for looking up wire transfers
// associated with this transaction. If not given,
// the base URL is the same as the one used for this request.
- // Can be used if the base URL for /transactions/ differs from that
- // for /coins/, i.e. for load balancing. Clients SHOULD
- // respect the transaction_base_url if provided. Any HTTP server
+ // Can be used if the base URL for ``/transactions/`` differs from that
+ // for ``/coins/``, i.e. for load balancing. Clients SHOULD
+ // respect the ``transaction_base_url`` if provided. Any HTTP server
// belonging to an exchange MUST generate a 307 or 308 redirection
// to the correct base URL should a client uses the wrong base
// URL, or if the base URL has changed since the deposit.
transaction_base_url?: string;
- // timestamp when the deposit was received by the exchange.
+ // Timestamp when the deposit was received by the exchange.
exchange_timestamp: Timestamp;
- // the EdDSA signature of `TALER_DepositConfirmationPS` using a current
+ // The EdDSA signature of `TALER_DepositConfirmationPS` using a current
// `signing key of the exchange <sign-key-priv>` affirming the successful
// deposit and that the exchange will transfer the funds after the refund
// deadline, or as soon as possible if the refund deadline is zero.
exchange_sig: EddsaSignature;
- // `public EdDSA key of the exchange <sign-key-pub>` that was used to
+ // `Public EdDSA key of the exchange <sign-key-pub>` that was used to
// generate the signature.
- // Should match one of the exchange's signing keys from /keys. It is
given
+ // Should match one of the exchange's signing keys from ``/keys``. It
is given
// explicitly as the client might otherwise be confused by clock skew as
to
// which signing key was used.
exchange_pub: EddsaPublicKey;
@@ -1237,11 +1241,11 @@ denomination.
.. ts:def:: DepositDoubleSpendError
interface DepositDoubleSpendError {
- // The string constant "insufficient funds"
+ // The string constant "insufficient funds".
hint: string;
// Transaction history for the coin that is
- // being double-spended
+ // being double-spended.
history: CoinSpendHistoryItem[];
}
@@ -1249,7 +1253,7 @@ denomination.
interface CoinSpendHistoryItem {
// Either "DEPOSIT", "MELT", "REFUND", "RECOUP",
- // "OLD-COIN-RECOUP" or "RECOUP-REFRESH"
+ // "OLD-COIN-RECOUP" or "RECOUP-REFRESH".
type: string;
// The total amount of the coin's value absorbed (or restored in the
@@ -1264,20 +1268,20 @@ denomination.
// Deposit fee in case of type "DEPOSIT".
deposit_fee: Amount;
- // public key of the merchant, for "DEPOSIT" operations.
+ // Public key of the merchant, for "DEPOSIT" operations.
merchant_pub?: EddsaPublicKey;
- // date when the operation was made.
+ // Date when the operation was made.
// Only for "DEPOSIT", "RECOUP", "OLD-COIN-RECOUP" and
// "RECOUP-REFRESH" operations.
timestamp?: Timestamp;
- // date until which the merchant can issue a refund to the customer via
the
+ // Date until which the merchant can issue a refund to the customer via
the
// exchange, possibly zero if refunds are not allowed. Only for
"DEPOSIT" operations.
refund_deadline?: Timestamp;
// Signature by the coin, only present if ``type`` is "DEPOSIT", "MELT",
"RECOUP",
- // or "RECOUP-REFRESH"
+ // or "RECOUP-REFRESH".
coin_sig?: EddsaSignature;
// Deposit fee in case of type "MELT".
@@ -1287,7 +1291,7 @@ denomination.
rc?: TALER_RefreshCommitmentP;
// Hash of the bank account from where we received the funds,
- // only present if ``type`` is "DEPOSIT"
+ // only present if ``type`` is "DEPOSIT".
h_wire?: HashCode;
// Hash of the public denomination key used to sign the coin.
@@ -1304,23 +1308,23 @@ denomination.
h_contract_terms?: HashCode;
// Refund transaction ID. Only present if ``type`` is
- // "REFUND"
+ // "REFUND".
rtransaction_id?: Integer;
// Coin blinding key. Only present if ``type`` is
- // "RECOUP" or "RECOUP-REFRESH"
+ // "RECOUP" or "RECOUP-REFRESH".
coin_blind?: DenominationBlindingKeyP;
// Reserve receiving the recoup. Only present if ``type`` is
- // "RECOUP"
+ // "RECOUP".
reserve_pub?: EddsaPublicKey;
// `EdDSA Signature <eddsa-sig>` authorizing the REFUND. Made with
// the `public key of the merchant <merchant-pub>`.
- // Only present if ``type`` is "REFUND"
+ // Only present if ``type`` is "REFUND".
merchant_sig?: EddsaSignature;
- // public key of the reserve that will receive the funds, for "RECOUP"
operations.
+ // Public key of the reserve that will receive the funds, for "RECOUP"
operations.
reserve_pub?: EddsaPublicKey;
// Signature by the exchange, only present if ``type`` is "RECOUP",
@@ -1329,7 +1333,7 @@ denomination.
// and of type TALER_SIGNATURE_EXCHANGE_CONFIRM_RECOUP_REFRESH otherwise.
exchange_sig?: EddsaSignature;
- // public key used to sign ``exchange_sig``,
+ // Public key used to sign ``exchange_sig``,
// only present if ``exchange_sig`` present.
exchange_pub?: EddsaPublicKey;
@@ -1354,20 +1358,20 @@ transactions with the freshly exchangeed coins
unlinkabe to previous transaction
by anyone except the wallet itself.
However, the new coins are linkable from the private keys of all old coins
-using the /refresh/link request. While /refresh/link must be implemented by
+using the ``/refresh/link`` request. While ``/refresh/link`` must be
implemented by
the exchange to achieve taxability, wallets do not really ever need that part
of
the API during normal operation.
.. _refresh:
.. http:post:: /coins/$COIN_PUB/melt
- "Melts" a coin. Invalidates the coins and prepares for exchangeing of fresh
+ "Melts" a coin. Invalidates the coins and prepares for exchanging of fresh
coins. Taler uses a global parameter ``kappa`` for the cut-and-choose
component of the protocol, for which this request is the commitment. Thus,
various arguments are given ``kappa``-times in this step. At present
``kappa``
is always 3.
- The base URL for "/coins/"-requests may differ from the main base URL of the
+ The base URL for ``/coins/``-requests may differ from the main base URL of
the
exchange. The exchange MUST return a 307 or 308 redirection to the correct
base URL if this is the case.
@@ -1376,8 +1380,8 @@ the API during normal operation.
:http:statuscode:`403 Forbidden`:
One of the signatures is invalid.
:http:statuscode:`404 Not found`:
- the exchange does not recognize the denomination key as belonging to the
exchange,
- or it has expired
+ The exchange does not recognize the denomination key as belonging to the
exchange,
+ or it has expired.
:http:statuscode:`409 Conflict`:
The operation is not allowed as the coin has insufficient
residual value, or because the same public key of the coin has been
@@ -1407,7 +1411,7 @@ the API during normal operation.
value_with_fee: Amount;
// Melt commitment. Hash over the various coins to be withdrawn.
- // See also ``TALER_refresh_get_commitment()``
+ // See also ``TALER_refresh_get_commitment()``.
rc: TALER_RefreshCommitmentP;
}
@@ -1424,11 +1428,11 @@ the API during normal operation.
noreveal_index: Integer;
// Signature of `TALER_RefreshMeltConfirmationPS` whereby the exchange
- // affirms the successful melt and confirming the ``noreveal_index``
+ // affirms the successful melt and confirming the ``noreveal_index``.
exchange_sig: EddsaSignature;
- // `public EdDSA key <sign-key-pub>` of the exchange that was used to
generate the signature.
- // Should match one of the exchange's signing keys from /keys. Again
given
+ // `Public EdDSA key <sign-key-pub>` of the exchange that was used to
generate the signature.
+ // Should match one of the exchange's signing keys from ``/keys``.
Again given
// explicitly as the client might otherwise be confused by clock skew as
to
// which signing key was used.
exchange_pub: EddsaPublicKey;
@@ -1436,8 +1440,8 @@ the API during normal operation.
// Base URL to use for operations on the refresh context
// (so the reveal operation). If not given,
// the base URL is the same as the one used for this request.
- // Can be used if the base URL for /refreshes/ differs from that
- // for /coins/, i.e. for load balancing. Clients SHOULD
+ // Can be used if the base URL for ``/refreshes/`` differs from that
+ // for ``/coins/``, i.e. for load balancing. Clients SHOULD
// respect the refresh_base_url if provided. Any HTTP server
// belonging to an exchange MUST generate a 307 or 308 redirection
// to the correct base URL should a client uses the wrong base
@@ -1445,7 +1449,7 @@ the API during normal operation.
//
// When melting the same coin twice (technically allowed
// as the response might have been lost on the network),
- // the exchange may return different values for the refresh_base_url.
+ // the exchange may return different values for the ``refresh_base_url``.
refresh_base_url?: string;
}
@@ -1457,19 +1461,19 @@ the API during normal operation.
// Text describing the error.
hint: string;
- // Detailed error code
+ // Detailed error code.
code: Integer;
- // public key of a melted coin that had insufficient funds
+ // Public key of a melted coin that had insufficient funds.
coin_pub: EddsaPublicKey;
- // original total value of the coin
+ // Original total value of the coin.
original_value: Amount;
- // remaining value of the coin
+ // Remaining value of the coin.
residual_value: Amount;
- // amount of the coin's value that was to be melted
+ // Amount of the coin's value that was to be melted.
requested_value: Amount;
// The transaction list of the respective coin that failed to have
sufficient funds left.
@@ -1482,17 +1486,17 @@ the API during normal operation.
.. http:post:: /refreshes/$RCH/reveal
Reveal previously committed values to the exchange, except for the values
- corresponding to the ``noreveal_index`` returned by the /coins/-melt step.
+ corresponding to the ``noreveal_index`` returned by the ``/coins/``-melt
step.
- The $RCH is the hash over the refresh commitment from the /coins/-melt step
+ The $RCH is the hash over the refresh commitment from the ``/coins/``-melt
step
(note that the value is calculated independently by both sides and has never
appeared *explicitly* in the protocol before).
- The base URL for "/refreshes/"-requests may differ from the main base URL of
- the exchange. Clients SHOULD respect the "refresh_base_url" returned for the
+ The base URL for ``/refreshes/``-requests may differ from the main base URL
of
+ the exchange. Clients SHOULD respect the ``refresh_base_url`` returned for
the
coin during melt operations. The exchange MUST return a
307 or 308 redirection to the correct base URL if the client failed to
- respect the "refresh_base_url" or if the allocation has changed.
+ respect the ``refresh_base_url`` or if the allocation has changed.
Errors such as failing to do proper arithmetic when it comes to calculating
the total of the coin values and fees are simply reported as bad requests.
@@ -1504,7 +1508,7 @@ the API during normal operation.
:http:statuscode:`200 OK`:
The transfer private keys matched the commitment and the original request
was well-formed.
- The response body is a `RevealResponse`
+ The response body is a `RevealResponse`.
:http:statuscode:`409 Conflict`:
There is a problem between the original commitment and the revealed private
keys. The returned information is proof of the mismatch, and therefore
@@ -1527,15 +1531,15 @@ the API during normal operation.
// matching the respective entries in ``new_denoms``.
coin_evs: CoinEnvelope[];
- // ``kappa - 1`` transfer private keys (ephemeral ECDHE keys)
+ // ``kappa - 1`` transfer private keys (ephemeral ECDHE keys).
transfer_privs: EddsaPrivateKey[];
- // transfer public key at the ``noreveal_index``.
+ // Transfer public key at the ``noreveal_index``.
transfer_pub: EddsaPublicKey;
// Array of ``n`` signatures made by the wallet using the old coin's
private key,
// used later to verify the /refresh/link response from the exchange.
- // Signs over a `TALER_CoinLinkSignaturePS`
+ // Signs over a `TALER_CoinLinkSignaturePS`.
link_sigs: EddsaSignature[];
}
@@ -1552,10 +1556,10 @@ the API during normal operation.
.. ts:def:: RevealConflictResponse
interface RevealConflictResponse {
- // Text describing the error
+ // Text describing the error.
hint: string;
- // Detailed error code
+ // Detailed error code.
code: Integer;
// Commitment as calculated by the exchange from the revealed data.
@@ -1566,7 +1570,7 @@ the API during normal operation.
.. http:get:: /coins/$COIN_PUB/link
- Link the old public key of a melted coin to the coin(s) that were exchangeed
during the refresh operation.
+ Link the old public key of a melted coin to the coin(s) that were exchanged
during the refresh operation.
**Request:**
@@ -1585,11 +1589,11 @@ the API during normal operation.
.. ts:def:: LinkResponse
interface LinkResponse {
- // transfer ECDHE public key corresponding to the ``coin_pub``, used to
+ // Transfer ECDHE public key corresponding to the ``coin_pub``, used to
// compute the blinding factor and private key of the fresh coins.
transfer_pub: EcdhePublicKey;
- // array with (encrypted/blinded) information for each of the coins
+ // Array with (encrypted/blinded) information for each of the coins
// exchangeed in the refresh operation.
new_coins: NewCoinInfo[];
}
@@ -1607,7 +1611,7 @@ the API during normal operation.
coin_ev : CoinEnvelope;
// Signature made by the old coin over the refresh request.
- // Signs over a `TALER_CoinLinkSignaturePS`
+ // Signs over a `TALER_CoinLinkSignaturePS`.
link_sig: EddsaSignature;
}
@@ -1623,7 +1627,7 @@ either case, the protocol is only used in **abnormal**
situations). In the above cases, the exchange signals to the
wallets that the emergency cash back protocol has been activated
by putting the affected denomination keys into the cash-back
-part of the /keys response. If and only if this has happened,
+part of the ``/keys`` response. If and only if this has happened,
coins that were signed with those denomination keys can be cashed
in using this API.
@@ -1631,7 +1635,7 @@ in using this API.
Demand that a coin be refunded via wire transfer to the original owner.
- The base URL for "/coins/"-requests may differ from the main base URL of the
+ The base URL for ``/coins/``-requests may differ from the main base URL of
the
exchange. The exchange MUST return a 307 or 308 redirection to the correct
base URL if this is the case.
@@ -1678,16 +1682,17 @@ in using this API.
// Signature over the `coin public key <eddsa-coin-pub>` by the
denomination.
denom_sig: RsaSignature;
- // coin's blinding factor
+ // Coin's blinding factor.
coin_blind_key_secret: RsaBlindingKeySecret;
- // Signature of `TALER_RecoupRequestPS` created with the `coin's private
key <coin-priv>`
+ // Signature of `TALER_RecoupRequestPS` created with
+ // the `coin's private key <coin-priv>`.
coin_sig: EddsaSignature;
// Was the coin refreshed (and thus the recoup should go to the old
coin)?
// While this information is technically redundant, it helps the exchange
// to respond faster.
- // *Optional* (for backwards compatibility); if absent, "false" is
assumed
+ // *Optional* (for backwards compatibility); if absent, ``false`` is
assumed.
refreshed?: boolean;
}
@@ -1700,18 +1705,18 @@ in using this API.
.. ts:def:: RecoupWithdrawalConfirmation
interface RecoupWithdrawalConfirmation {
- // Tag to distinguish the RecoupConfirmation response type
+ // Tag to distinguish the `RecoupConfirmation` response type.
refreshed: false;
- // public key of the reserve that will receive the recoup,
+ // Public key of the reserve that will receive the recoup.
reserve_pub: EddsaPublicKey;
}
.. ts:def:: RecoupRefreshConfirmation
interface RecoupRefreshConfirmation {
- // Tag to distinguish the RecoupConfirmation response type
+ // Tag to distinguish the `RecoupConfirmation` response type.
refreshed: true;
- // public key of the old coin that will receive the recoup
+ // Public key of the old coin that will receive the recoup.
old_coin_pub: EddsaPublicKey;
}
@@ -1741,7 +1746,7 @@ may also be performed by the government auditing a
merchant.
However, wire transfer identifiers should have sufficient entropy to
ensure that obtaining a successful reply by brute-force is not practical.
Nevertheless, the merchant should protect the wire transfer identifiers
-from his bank statements against unauthorized access, least his income
+from his bank statements against unauthorized access, lest his income
situation is revealed to an adversary. (This is not a major issue, as
an adversary that has access to the line-items of bank statements can
typically also view the balance.)
@@ -1769,27 +1774,27 @@ typically also view the balance.)
// Actual amount of the wire transfer, excluding the wire fee.
total: Amount;
- // Applicable wire fee that was charged
+ // Applicable wire fee that was charged.
wire_fee: Amount;
- // public key of the merchant (identical for all deposits)
+ // Public key of the merchant (identical for all deposits).
merchant_pub: EddsaPublicKey;
- // hash of the wire details (identical for all deposits)
+ // Hash of the wire details (identical for all deposits).
h_wire: HashCode;
- // Time of the execution of the wire transfer by the exchange
+ // Time of the execution of the wire transfer by the exchange.
execution_time: Timestamp;
- // details about the deposits
+ // Details about the deposits.
deposits: TrackTransferDetail[];
- // signature from the exchange made with purpose
- // `TALER_SIGNATURE_EXCHANGE_CONFIRM_WIRE_DEPOSIT`
+ // Signature from the exchange made with purpose
+ // `TALER_SIGNATURE_EXCHANGE_CONFIRM_WIRE_DEPOSIT`.
exchange_sig: EddsaSignature;
- // public EdDSA key of the exchange that was used to generate the
signature.
- // Should match one of the exchange's signing keys from /keys. Again
given
+ // Public EdDSA key of the exchange that was used to generate the
signature.
+ // Should match one of the exchange's signing keys from ``/keys``.
Again given
// explicitly as the client might otherwise be confused by clock skew as
to
// which signing key was used.
exchange_pub: EddsaSignature;
@@ -1801,13 +1806,13 @@ typically also view the balance.)
// SHA-512 hash of the contact of the merchant with the customer.
h_contract_terms: HashCode;
- // coin's public key, both ECDHE and EdDSA.
+ // Coin's public key, both ECDHE and EdDSA.
coin_pub: CoinPublicKey;
// The total amount the original deposit was worth.
deposit_value: Amount;
- // applicable fees for the deposit
+ // Applicable fees for the deposit.
deposit_fee: Amount;
}
@@ -1821,7 +1826,7 @@ typically also view the balance.)
**Request:**
- :query merchant_sig: EdDSA signature of the merchant made with purpose
``TALER_SIGNATURE_MERCHANT_TRACK_TRANSACTION`` , affirming that it is really
the merchant who requires obtaining the wire transfer identifier.
+ :query merchant_sig: EdDSA signature of the merchant made with purpose
``TALER_SIGNATURE_MERCHANT_TRACK_TRANSACTION``, affirming that it is really the
merchant who requires obtaining the wire transfer identifier.
**Response:**
@@ -1836,30 +1841,30 @@ typically also view the balance.)
:http:statuscode:`401 Unauthorized`:
The signature is invalid.
:http:statuscode:`404 Not found`:
- The deposit operation is unknown to the exchange
+ The deposit operation is unknown to the exchange.
**Details:**
.. ts:def:: TrackTransactionResponse
interface TrackTransactionResponse {
- // raw wire transfer identifier of the deposit.
+ // Raw wire transfer identifier of the deposit.
wtid: Base32;
- // when was the wire transfer given to the bank.
+ // When was the wire transfer given to the bank.
execution_time: Timestamp;
// The contribution of this coin to the total (without fees)
coin_contribution: Amount;
- // Total amount transferred
+ // Total amount transferred.
total_amount: Amount;
- // binary-only Signature_ for purpose
`TALER_SIGNATURE_EXCHANGE_CONFIRM_WIRE`
+ // Binary-only Signature_ for purpose
`TALER_SIGNATURE_EXCHANGE_CONFIRM_WIRE`
// whereby the exchange affirms the successful wire transfer.
exchange_sig: EddsaSignature;
- // public EdDSA key of the exchange that was used to generate the
signature.
+ // Public EdDSA key of the exchange that was used to generate the
signature.
// Should match one of the exchange's signing keys from /keys. Again
given
// explicitly as the client might otherwise be confused by clock skew as
to
// which signing key was used.
@@ -1869,7 +1874,7 @@ typically also view the balance.)
.. ts:def:: TrackTransactionAcceptedResponse
interface TrackTransactionAcceptedResponse {
- // time by which the exchange currently thinks the deposit will be
executed.
+ // Time by which the exchange currently thinks the deposit will be
executed.
execution_time: Timestamp;
}
@@ -1921,7 +1926,7 @@ Refunds
// SHA-512 hash of the contact of the merchant with the customer.
h_contract_terms: HashCode;
- // 64-bit transaction id of the refund transaction between merchant and
customer
+ // 64-bit transaction id of the refund transaction between merchant and
customer.
rtransaction_id: Integer;
// EdDSA public key of the merchant.
@@ -1936,13 +1941,13 @@ Refunds
interface RefundSuccess {
- // the EdDSA :ref:`signature` (binary-only) with purpose
+ // The EdDSA :ref:`signature` (binary-only) with purpose
// `TALER_SIGNATURE_EXCHANGE_CONFIRM_REFUND` using a current signing key
of the
- // exchange affirming the successful refund
+ // exchange affirming the successful refund.
exchange_sig: EddsaSignature;
- // public EdDSA key of the exchange that was used to generate the
signature.
- // Should match one of the exchange's signing keys from /keys. It is
given
+ // Public EdDSA key of the exchange that was used to generate the
signature.
+ // Should match one of the exchange's signing keys from ``/keys``. It
is given
// explicitly as the client might otherwise be confused by clock skew as
to
// which signing key was used.
exchange_pub: EddsaPublicKey;
@@ -1958,7 +1963,7 @@ Refunds
// transaction number re-use (with different amounts).
code: Integer;
- // Human-readable description of the error message
+ // Human-readable description of the error message.
hint: string;
// Information about the conflicting refund request(s).
--
To stop receiving notification emails like this one, please contact
gnunet@gnunet.org.
- [taler-docs] branch master updated (dbd8c24 -> e82c810),
gnunet <=
- [taler-docs] 03/119: change markup of ‘stamp_start’ and ‘/keys’ from " to ``, gnunet, 2021/03/19
- [taler-docs] 01/119: fix typo: s/obtian/obtain/, gnunet, 2021/03/19
- [taler-docs] 02/119: capitalize first word in sentence, gnunet, 2021/03/19
- [taler-docs] 06/119: fix typo: s/a/an/, gnunet, 2021/03/19
- [taler-docs] 07/119: mark up ‘/keys’, gnunet, 2021/03/19
- [taler-docs] 11/119: mark up ‘TALER_SIGNATURE_MASTER_SIGNING_KEY_VALIDITY’, gnunet, 2021/03/19
- [taler-docs] 08/119: add period at end of sentence (five instances), gnunet, 2021/03/19
- [taler-docs] 13/119: capitalize first word in sentence, gnunet, 2021/03/19
- [taler-docs] 04/119: fold long line; change markup of ‘denoms’ and ‘signkeys’ from ' to ``; add period at end of sentence, gnunet, 2021/03/19
- [taler-docs] 15/119: mark up ‘/keys’, gnunet, 2021/03/19