dcc-wasm

Parse a digital covid certificate

This is a WebAssembly (wasm) package to parse a European Digital Covid Certificate (DCC). The source is written in Rust, compiled to webassembly. Signatures are also being verified.

Installation

Use your favourite package manager to use this package in your javascript projects.

npm install dcc-wasm --save

webpack >= 5

Add the following to webpack.config.js

{
  module: {
    rules: [
      {
        test: /\.wasm$/,
        type: 'webassembly/async',
      }
    ]
  },
  experiments: {
    asyncWebAssembly: true
  }
}

Getting started

Here is an example on how use this package

import { parse } from "dcc-wasm"

const parseResult = parse("HC1:6BFOXN*TS0BI$ZD-PHQ7I9AD66V5B22CH9M9ESI9XBHXK-%69LQOGI.*V76GCV4*XUA2P-FHT-HNTI4L6N$Q%UG/YL WO*Z7ON15 BM0VM.JQ$F4W17PG4.VAS5EG4V*BRL0K-RDY5RWOOH6PO9:TUQJAJG9-*NIRICVELZUZM9EN9-O9:PICIG805CZKHKB-43.E3KD3OAJ6*K6ZCY73JC3KD3ZQTWD3E.KLC8M3LP-89B9K+KB2KK3M*EDZI9$JAQJKKIJX2MM+GWHKSKE MCAOI8%MCU5VTQDPIMQK9*O7%NC.UTWA6QK.-T3-SY$NCU5CIQ 52744E09TBOC.UKMI$8R+1A7CPFRMLNKNM8JI0JPGN:0K7OOBRLY667SYHJL9B7VPO:SWLH1/S4KQQK0$5REQT5RN1FR%SHPLRKWJO8LQ84EBC$-P4A0V1BBR5XWB3OCGEK:$8HHOLQOZUJ*30Q8CD1");

if(!parseResult.successful || !parseResult.signature_valid) {
  console.log(parseResult.error)
}

console.log(parseResult.data)

Would result in:

{
  "1": "DE",
  "4": 1643356073,
  "6": 1622316073,
  "-260": {
    "1": {
      "r": [
        {
          "ci": "URN:UVCI:01DE/5CWLU12RNOB9RXSEOP6FG8#W",
          "is": "Robert Koch-Institut",
          "co": "DE",
          "tg": "840539006",
          "fr": "2021-01-10",
          "df": "2021-05-29",
          "du": "2021-06-15"
        }
      ],
      "dob": "1964-08-12",
      "nam": {
        "fn": "Mustermann",
        "gn": "Erika",
        "fnt": "MUSTERMANN",
        "gnt": "ERIKA"
      },
      "ver": "1.0.0"
    }
  }
}

The specifications of this data can be found here

ParsingResult

Property	Type	Description
successful	bool	Will be true if the data could be parsed successfully
signature_valid	bool	Will be true if the signature could be verifyed
kid	string	Issuer identifier
algorithm	number	The algorithm to sign the data
data	unknown	The data in the health certificate

Building from source

1. Clone repository
2. Install wasm-pack by running curl https://rustwasm.github.io/wasm-pack/installer/init.sh -sSf | sh in your terminal
3. Run wasm-pack build --target nodejs --outdir package/node to build the wasm package for a nodejs environment
4. Run wasm-pack build --outdir package/webpack to build the wasm package a browser package

Running tests

Rust

• wasm-pack test --node
• wasm-pack test --firefox --headless

Javascript

Follow these steps from the root dir to run the javascript tests

• wasm-pack build --target nodejs --outdir package/node to build
• change directory to package cd package
• npm install
• npm run test to run the tests