0009406: documentation for various hash codes are lacking details - MantisBT

ID	Project	Category	View Status	Date Submitted	Last Update

0009406	Taler	documentation	public	2024-12-19 14:31	2024-12-19 14:36

Reporter	oec	Assigned To	oec
Priority	normal	Severity	minor	Reproducibility	always
Status	assigned	Resolution	open
Product Version	git (master)
Target Version	1.0

Summary	0009406: documentation for various hash codes are lacking details
Description	In the "Cryptographic primitives" section https://docs.taler.net/core/api-common.html#cryptographic-primitives we find the type declarations of various hashes used in the Taler code base, f.e. ``` struct TALER_BlindedCoinHash { struct GNUNET_HashCode hash; }; struct TALER_CoinPubHash { struct GNUNET_HashCode hash; }; struct TALER_OutputCommitmentHash { struct GNUNET_HashCode hash; }; ``` These and others lack information _how_ to compute those hashes, which i quite relevant for their validity. F.e. according to the implementation, the value for `TALER_BlindedCoinHash` is constructed involving the hash of the denomination's public key and the a computed blinded hash value of the coin's planchet. We should be explicit about what data is required and how exactly that data is used to compute all those hash values in the documentation.
Additional Information	The header file `include/taler_crypto_lib.h` is not helpful, neither, f.e. ``` /** * Hash used to represent a commitment to a blinded * coin, i.e. the hash of the envelope. / struct TALER_BlindedCoinHashP { /* * Actual hash value. */ struct GNUNET_HashCode hash; }; ```
Tags	No tags attached.

Date Modified	Username	Field	Change
2024-12-19 14:31	oec	New Issue
2024-12-19 14:31	oec	Status	new => assigned
2024-12-19 14:31	oec	Assigned To	=> Stefan
2024-12-19 14:35	oec	Issue cloned: 0009407
2024-12-19 14:36	oec	Relationship added	related to 0009407
2024-12-19 14:36	oec	Assigned To	Stefan => oec