Digital Covid Ceritifcate Decoder

A node module for decoding DCC certs, validaiong signature and optionally running country specific business rules

For more on DCC see:

• https://github.com/ehn-dcc-development
• https://github.com/eu-digital-green-certificates

Contents

• Getting Started
• Usage
• Methods
• Team
• License

Getting started

To install this module

# with npm
npm install --save dcc-decoder

Usage

This module supports decoding DCC data from the QR data. The module can directly load and utilise the trust list from a url provided or you can pass in the trust list, valuesets and business rules.

The response will contain the raw cert (rawCert), the populated cert (cert) using the valudset provided, an errors array that will contain any errors encountered during decoding such as invalid signatire, cert expired etc

Example

import { decodeOnly, loadDCCConfigData } from 'dcc-decoder';

(async () => {
  const dcc = await loadDCCConfigData('https://url_for_config')
  const result = await decodeOnly({
          source: 'HC1:....',
          dccData: dcc
        })
  if (result.errors) {
    console.log('Decoding error', result.errors)
  }
  console.log(result.cert)
})()

Methods

loadDCCConfigData()

const dccData = await loadDCCConfigData('https://url_for_config')

Used to load the dcc config data needed to decode and validate a DCC. Returns the config.

decodeOnly()

const result = await decodeOnly({source: 'HC1:....', dccData: {dcc...}});

Decodes a DCC qr code. Will accept input as string. Returns a promise which includes the raw cert data, populated cert, cert type and any error.

decodeAndValidateRules()

const result = await decodeAndValidateRules({source: 'HC1:....', dccData: {dcc...}}, ruleCountry: 'IE'});

Decodes a DCC qr code an then runs the provided business rules against the DCC data. Will accept input as string. Returns a promise which includes the raw cert data, populated cert, cert type and any error.

Team

Lead Maintainers

• @colmharte - Colm Harte [email protected]

Core Team

• @colmharte - Colm Harte [email protected]
• @salmanm - Salman Mitha [email protected]

Contributors

• TBD

Past Contributors

• TBD

Hosted By

Linux Foundation Public Health

Acknowledgements

License

Copyright (c) The COVID Green Contributors

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

[http://www.apache.org/licenses/LICENSE-2.0](http://www.apache.org/licenses/LICENSE-2.0)

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.