magma - v0.1.3

@li0ard/magma
Magma cipher implementation in pure TypeScript
docs

Installation

# from NPM
npm i @li0ard/magma

# from JSR
bunx jsr i @li0ard/magma
Copy

Supported modes

• [x] Electronic Codebook (ECB)
• [x] Cipher Block Chaining (CBC)
• [x] Cipher Feedback (CFB)
• [x] Counter (CTR)
• [x] Output Feedback (OFB)
• [x] MAC (CMAC/OMAC/OMAC1)
• [x] Counter with Advance Cryptographic Prolongation of Key Material (CTR-ACPKM)
• [x] MAC with Advance Cryptographic Prolongation of Key Material (OMAC-ACPKM)
• [x] Multilinear Galois Mode (MGM)

Features

• Provides simple and modern API
• Most of the APIs are strictly typed
• Fully complies with GOST R 34.12-2015 (RFC 8891) and GOST R 34.13-2015 (in Russian) standarts
• Supports Bun, Node.js, Deno, Browsers

Examples

ECB mode

import { decryptECB, encryptECB } from "@li0ard/magma";

const key = Buffer.from("ffeeddccbbaa99887766554433221100f0f1f2f3f4f5f6f7f8f9fafbfcfdfeff", "hex")
const plaintext = Buffer.from("fedcba9876543210", "hex")
const encrypted = encryptECB(key, plaintext)
console.log(encrypted) // Uint8Array [ ... ]

const decrypted = decryptECB(key, encrypted)
console.log(decrypted) // Uint8Array [ ... ]
Copy

CTR-ACPKM mode

import { decryptCTR_ACPKM, encryptCTR_ACPKM } from "@li0ard/magma"

const key = Buffer.from("8899AABBCCDDEEFF0011223344556677FEDCBA98765432100123456789ABCDEF", "hex")
const iv = Buffer.from("12345678", "hex")
const plaintext = Buffer.from("1122334455667700FFEEDDCCBBAA998800112233445566778899AABBCCEEFF0A112233445566778899AABBCCEEFF0A002233445566778899", "hex")

const encrypted = encryptCTR_ACPKM(key, plaintext, iv)
console.log(encrypted) // Uint8Array [...]

const decrypted = decryptCTR_ACPKM(key, encrypted, iv)
console.log(decrypted) // Uint8Array [...]
Copy