Miscellaneous Encoding Utilities for Crypto-related Objects in JavaScript

WARNING: At this time this solution should be considered suitable for research and experimentation, further code and security review is needed before utilization in a production application.

Introduction and Overview

This library is being developed to handle cryptographic data objects, e.g., PEM-formatted X.509 certificate, in JavaScript. Note that this library provides no cryptographic functions like encryption, but provides encoders, decoders and formatters of data formats related to cryptographic data objects. In particular, this introduces Base64(Url)-ArrayBuffer en/decoder, HexString-ArrayBuffer en/decoder and PEM-Binary formatter at this point. Moreover, this library is designed to be 'universal', i.e., it works both on most browsers and on Node.js just by importing from npm/source code.

Installation

At your project directory, do either one of the following.

• From npm/yarn:

  1$ npm install --save js-encoding-utils // npm
  2$ yarn add js-encoding-utils // yarn

• From GitHub:

  1$ git clone https://github.com/junkurihara/jseu.git

Then you should import the package as follows.

1import jseu from 'js-encoding-utils'; // for npm
2import jseu from 'jseu/dist/index.js'; // for github

Usage

Base64 <-> Binary

1// msg is an ArrayBuffer or Typed Array
2const encoded = jseu.encoder.encodeBase64(msg);
3// now you get Base64 string
4
5const decoded = jseu.encoder.decodeBase64(encoded);
6// now you get the original message in Uint8Array

Base64Url <-> Binary

1// msg is an ArrayBuffer or Typed Array
2const encoded = jseu.encoder.encodeBase64Url(msg);
3// now you get Base64Url string
4
5const decoded = jseu.encoder.decodeBase64Url(encoded);
6// now you get the original message in Uint8Array

HexString <-> Binary

1// msg is an ArrayBuffer or Typed Array
2const encoded = jseu.encoder.arrayBufferToHexString(msg);
3// now you get the hex-stringified message string
4
5const decoded = jseu.encoder.hexStringToArrayBuffer(encoded);
6// now you get the original message in Uint8Array

PEM <-> Binary (usually DER encoding)

1// X.509 formatted certificate
2const certPEM ='-----BEGIN CERTIFICATE-----...';
3
4const binCert = jseu.formatter.pemToBin(certPEM);
5// now you get the DER encoded certificate in Uint8Array
6
7const pemCert = jseu.formatter.binToPem(binCert, 'certificate');
8// now you get the original certificate.

License

Licensed under the MIT license, see LICENSE file.