taler-docs

Documentation for GNU Taler components, APIs and protocols
Log | Files | Refs | README | LICENSE

commit f760071851adeefc78a7405ed13305ac8596284c
parent 81a6e3eb9c7682863183f6f24885508dd042577e
Author: Christian Grothoff <christian@grothoff.org>
Date:   Tue, 26 Sep 2023 14:48:45 +0200

terms

Diffstat:
Mcore/api-donau.rst | 42+++++++++++++++++++++---------------------
Mcore/api-exchange.rst | 8++++----
2 files changed, 25 insertions(+), 25 deletions(-)

diff --git a/core/api-donau.rst b/core/api-donau.rst @@ -137,7 +137,7 @@ should cache. master_public_key: EddsaPublicKey; // Donation Units offered by this donau - donation_units: DonationUnitGroup[]; + donation_units: DonationUnitKeyGroup[]; // The date when the denomination keys were last updated. list_issue_date: Timestamp; @@ -157,44 +157,44 @@ should cache. } - .. ts:def:: DonauDonationUnitGroup + .. ts:def:: DonauDonationUnitKeyGroup - type DonauDonationUnitGroup = - | DonauDonationUnitGroupRsa - | DonauDonationUnitGroupCs; + type DonauDonationUnitKeyGroup = + | DonauDonationUnitKeyGroupRsa + | DonauDonationUnitKeyGroupCs; - .. ts:def:: DonauDonationUnitGroupRsa + .. ts:def:: DonauDonationUnitKeyGroupRsa - interface DonauDonationUnitGroupRsa extends DonauDonationUnitGroupCommon { + interface DonauDonationUnitKeyGroupRsa extends DonauDonationUnitKeyGroupCommon { cipher: "RSA"; denoms: ({ rsa_pub: RsaPublicKey; - } & DonauDonationUnitCommon)[]; + } & DonauDonationUnitKeyCommon)[]; } - .. ts:def:: DonauDonationUnitGroupCs + .. ts:def:: DonauDonationUnitKeyGroupCs - interface DonauDonationUnitGroupCs extends DonauDonationUnitGroupCommon { + interface DonauDonationUnitKeyGroupCs extends DonauDonationUnitKeyGroupCommon { cipher: "CS"; denoms: ({ cs_pub: Cs25519Point; - } & DonauDonationUnitCommon)[]; + } & DonauDonationUnitKeyCommon)[]; } - .. ts:def:: DonauDonationUnitGroupCommon + .. ts:def:: DonauDonationUnitKeyGroupCommon // Common attributes for all denomination groups - interface DonauDonationUnitGroupCommon { + interface DonauDonationUnitKeyGroupCommon { // How much are receipts of this denomination worth? value: Amount; } - .. ts:def:: DonauDonationUnitCommon + .. ts:def:: DonauDonationUnitKeyCommon - interface DonauDonationUnitCommon { + interface DonauDonationUnitKeyCommon { // Signature of `TALER_DonauDonationUnitKeyValidityPS`. master_sig: EddsaSignature; @@ -366,8 +366,8 @@ Management operations authorized by master key // transactions involving this receipt. stamp_expire_legal: Timestamp; - // Public (RSA) key for the denomination. - denom_pub: RsaPublicKey; + // Public key for the denomination. + denom_pub: DonauDontationUnitKey; // Signature by the denomination security module // over `TALER_DonationUnitKeyAnnouncementPS` @@ -403,8 +403,8 @@ Management operations authorized by master key .. http:post:: /management/keys - Provide master signatures for future public keys to be used by the donau. - Only to be used by the donau's offline key management team. Not useful + Provide master signatures for future public keys to be used by the Donau. + Only to be used by the Donau's offline key management team. Not useful for anyone else. **Request:** The request body must be a `MasterSignatures` object. @@ -416,7 +416,7 @@ Management operations authorized by master key :http:statuscode:`403 Forbidden`: A provided signature is invalid. :http:statuscode:`404 Not found`: - One of the keys for which a signature was provided is unknown to the donau. + One of the keys for which a signature was provided is unknown to the Donau. **Details:** @@ -436,7 +436,7 @@ Management operations authorized by master key interface DonationUnitSignature { - // Hash of the public (RSA) key of the denomination. + // Hash of the public key of the donation unit key. h_denom_pub: HashCode; // Signature over `TALER_DonationUnitKeyValidityPS`. diff --git a/core/api-exchange.rst b/core/api-exchange.rst @@ -738,8 +738,8 @@ Management operations authorized by master key // transactions involving this coin. stamp_expire_legal: Timestamp; - // Public (RSA) key for the denomination. - denom_pub: RsaPublicKey; + // Public key for the denomination. + denom_pub: DenominationKey; // Fee charged by the exchange for withdrawing a coin of this denomination. fee_withdraw: Amount; @@ -820,7 +820,7 @@ Management operations authorized by master key interface DenomSignature { - // Hash of the public (RSA) key of the denomination. + // Hash of the public key of the denomination. h_denom_pub: HashCode; // Signature over `TALER_DenominationKeyValidityPS`. @@ -1788,7 +1788,7 @@ Withdraw .. ts:def:: WithdrawRequest interface WithdrawRequest { - // Hash of a denomination public key (RSA), specifying the type of coin the client + // Hash of a denomination public key, specifying the type of coin the client // would like the exchange to create. denom_pub_hash: HashCode;