@enigmaciphy/engine
TypeScript icon, indicating that this package has built-in type declarations

0.0.8 • Public • Published

This is an implementation of the enigma machine encryption algorithm. The cipher heavily relies on substitution.

Rotor

It substitutes an alphabet letter, representing the wiring of the rotor, the offset of the ring may be positioned in a different position of the alphabet. A letter may go through substitution throughout many rotors. Each time a letter is substited the rotor turns to the next letter. Due to it's "turning" nature, a sequence of the same character will produce a different ciphertext for each turn.

Rotor Notch

The point at which the next rotor position should be moved forward.

Rotor processing representation

We will assume the position AAA and rings AAA as well as the following wiring alphabet.

Position          0  1  2  3  4  5  6  7  8  9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25
Alphabet          A  B  C  D  E  F  G  H  I  J  K  L  M  N  O  P  Q  R  S  T  U  V  W  X  Y  Z
Shuffled Alphabet B  D  F  H  J  L  C  P  R  T  X  V  Z  N  Y  E  I  W  G  A  K  M  U  S  Q  O

So we initially have the following mapping A=B, B=D, C=F, D=H, [...].

Rotation

Before processing anything the machine will rotate from 0 to 1.

Wiring shift

The mapping will happen from position 1 (A) outputing D.

                     ⬇️
Position          0  1  2  3  4  5  6  7  8  9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25
Alphabet          A  B  C  D  E  F  G  H  I  J  K  L  M  N  O  P  Q  R  S  T  U  V  W  X  Y  Z
Shuffled Alphabet B  D  F  H  J  L  C  P  R  T  X  V  Z  N  Y  E  I  W  G  A  K  M  U  S  Q  O

Rotor's position reverse shift

The output D from the wiring shift, which is at alphabet position 3 will be subtracted by the rotor's position, 3 - 1 = 2, thus the final output will be the letter C, which is located at position 2.

Reflector

Works like a bi-directional map. The reflector is usually fixed, meaning it does not rotates as oposed to the rotors.

A maps B then
B maps A

Plugboard

Maps a letter to another letter for its substitution, same property seem by the reflector. The major benefit is the possibility of mapping letters as needed, thus adding another layer of complexity to the cipher. The plugboard is applied before anything as well as after everything, meaning it is the first substitution and also the last, happening twice.

A maps B then
B maps A

Usage:

npm install @enigmaciphy/engine
// -- ENCRYPTING
import { Cipher, CipherJSON } from '@enigmaciphy/engine';

const configuration: CipherJSON = {
	alphabet: 'ABCDEFGHIJKLMNOPQRSTUVWXYZ',
	plugboard: { wiring: 'AQRIJFHGDEWLTNSXBCOMZVKPYU' },
	entry: { wiring: 'ABCDEFGHIJKLMNOPQRSTUVWXYZ' },
	rotors: [
		{ wiring: 'EKMFLGDQVZNTOWYHXUSPAIBRCJ', notches: ['Q'] },
		{ wiring: 'AJDKSIRUXBLHWTMCQGZNPYFVOE', notches: ['E'] },
		{ wiring: 'BDFHJLCPRTXVZNYEIWGAKMUSQO', notches: ['V'] },
	],
	reflector: { wiring: 'YRUHQSLDPXNGOKMIEBFZCWVJAT' },
	chargroup: 5,
};
let cipher = Cipher.fromJSON(configuration);

cipher.encrypt('Lorem ipsum dolor sit amet, consectetur adipiscing elit.');
// XPJUP VYBRA QAJNY VAIXO UUWXO VVPDM LKVEK BHQIL DMAKH YL

// -- DECRYPTING

// To decrypt the cipher is instantiated again so the rotors will be on their initial position.
cipher = Cipher.fromJSON(configuration);

cipher.encrypt('XPJUP VYBRA QAJNY VAIXO UUWXO VVPDM LKVEK BHQIL DMAKH YL');
// LOREM IPSUM DOLOR SITAM ETCON SECTE TURAD IPISC INGEL IT

The code output has been tested against the following existing machines:

Note: This application currently does not support ring settings.

Sources:

Debug

VSCode example F1 > Debug: Toggle Auto Attach > Always > inside vscode own terminal > node --inspect ./node_modules/.bin/jest src/Configuration/Rotor/Rotor.spec.ts

Package Sidebar

Install

npm i @enigmaciphy/engine

Weekly Downloads

0

Version

0.0.8

License

MIT

Unpacked Size

69.1 kB

Total Files

52

Last publish

Collaborators

  • marlonbarcarol