Skip to content

Commit 7f53717

Browse files
- update readme file; (#78)
1 parent 30caf48 commit 7f53717

File tree

2 files changed

+12
-17
lines changed

2 files changed

+12
-17
lines changed

README.md

Lines changed: 11 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -24,25 +24,20 @@ This repository contains the source code of the EU Digital COVID Certificate App
2424

2525
The app core provides shared functionality for the [verifier](https://github.com/eu-digital-green-certificates/dgca-verifier-app-android) and [wallet](https://github.com/eu-digital-green-certificates/dgca-wallet-app-android) apps.
2626

27-
## Development
27+
Base module that provides functionality for handling DCC certificate type. It decodes the base45-encoded QR code, extracts the COSE signature, and decodes CBOR back to JSON. It then verifies the signature with the keys provided by the verifier/wallet app’s backend. The module uses only open-source libraries.
2828

29-
### Prerequisites
29+
## Documentation
3030

31-
- [ ] TODO: Describe prerequisites
31+
Module features:
32+
- Prefix validation: Drops a country-specific prefix from contents, e.g. "HC1:"
33+
- Base45 Decoding: decodes provided input according to specification: [Base45](https://datatracker.ietf.org/doc/draft-faltstrom-base45/?include_text=1)
34+
- Decompression with ZLIB
35+
- Decodes input according to COSE specification [RFC8152](https://datatracker.ietf.org/doc/html/rfc8152)
36+
- Decodes input as a [CBOR structure](https://datatracker.ietf.org/doc/html/rfc7049)
37+
- Schema validation - verifies CBOR with predefined schema (JsonSchema.kt#JSON_SCHEMA_V1)
38+
- Verifies COSE signature
3239

33-
### Build
34-
35-
Whether you cloned or downloaded the 'zipped' sources you will either find the sources in the chosen checkout-directory or get a zip file with the source code, which you can expand to a folder of your choice.
36-
37-
In either case open a terminal pointing to the directory you put the sources in. The local build process is described afterwards depending on the way you choose.
38-
39-
#### XYZ (Maven, Docker ...) based build
40-
41-
- [ ] TODO: Add instructions for different build types
42-
43-
## Documentation
44-
45-
- [ ] TODO: Link to documentation
40+
For more details check unit tests to see how it works step by step.
4641

4742
## Support and feedback
4843

decoder/src/test/java/dgca/verifier/app/decoder/QrCodeTests.kt

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -67,7 +67,7 @@ class QrCodeTests {
6767
.generateCertificate(inputStream) as X509Certificate
6868
}
6969

70-
fun verifyResult(prefix: String?, PublicKey: String?): VerificationResult {
70+
private fun verifyResult(prefix: String?, PublicKey: String?): VerificationResult {
7171
val result = VerificationResult()
7272
val b45Service: Base45Service = DefaultBase45Service()
7373
val prefService: PrefixValidationService = DefaultPrefixValidationService()

0 commit comments

Comments
 (0)