View Issue Details
| ID | Project | Category | View Status | Date Submitted | Last Update |
|---|---|---|---|---|---|
| 0009406 | Taler | documentation | public | 2024-12-19 13:31 | 2026-02-09 09:44 |
| Reporter | oec | Assigned To | mikolai | Resolution deadline | |
| Implementer | Reviewer | ||||
| Release signed by | Deployed by | ||||
| Verifier | Communicator | ||||
| Data protection authority notification required | No | ||||
| CSIRT notification required | No | ||||
| Estimated effort (hours) | Actual effort (hours) | 0 | |||
| Fast-track | No | ||||
| Work package | none | ||||
| Priority | normal | Severity | text | Reproducibility | always |
| Status | implementing | Resolution | open | ||
| Product Version | git (master) | ||||
| Target Version | post-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 13:31 | oec | New Issue | |
| 2024-12-19 13:31 | oec | Status | new => assigned |
| 2024-12-19 13:31 | oec | Assigned To | => Stefan |
| 2024-12-19 13:35 | oec | Issue cloned: 0009407 | |
| 2024-12-19 13:36 | oec | Relationship added | related to 0009407 |
| 2024-12-19 13:36 | oec | Assigned To | Stefan => oec |
| 2024-12-29 23:04 | Christian Grothoff | Target Version | 1.0 => 1.0 stretch goals |
| 2025-04-17 20:21 | Christian Grothoff | Target Version | 1.0 stretch goals => post-1.0 |
| 2025-05-08 20:44 | Christian Grothoff | Assigned To | oec => |
| 2025-05-08 20:44 | Christian Grothoff | Severity | minor => text |
| 2025-05-08 20:44 | Christian Grothoff | Status | assigned => implementing |
| 2026-02-09 09:44 | Christian Grothoff | Assigned To | => mikolai |
| 2026-02-09 09:44 | Christian Grothoff | Status | implementing => assigned |
| 2026-11-03 07:21 | Status | assigned => implementing |