﷽
Minimal and single-header cryptography library (AES, RSA, Base16, Base64, ZLib)
Mine is fast, memory-efficient, single-header minimal cryptography implementation for small-medium projects that cannot afford to link to external libraries.
It all started with ripe that depends on third-party library (initially OpenSSL then Crypto++) linked statically. However after deploying residue with ripe to older distributions of linux, we learnt that portability is an issue for ripe as minimal library (because of it's dependencies). So we started to implement standards forming Mine.
I was very careful with my implementations and have over 50 test cases in-place.
Simply copy mine.h and mine.cc from package/ directory to your project or your local machine.
Alternatively, feel free to link it as shared or static library (you will need to compile yourself)
You can either download binary for your platform via releases page or using NPM
npm install -g mine-linux@latest
sudo ln -s `which mine-linux` /usr/local/bin/mine
npm install -g mine-darwin@latest
sudo ln -s `which mine-darwin` /usr/local/bin/mine
Mine supports following features:
- Base16 Encoding
- Base64 Encoding
- RSA [RFC-3447]
- AES [FIPS Pub. 197]
- ZLib (Depends upon libz)
This is what we are aiming for minimal crypto library.
- It is natively developed on macOS and Linux operating systems
- It is fast with compiler optimization level 1 (or higher)
- You need to implement BigNumber to use RSA, for unit tests we use Integer from Crypto++
- RSA currently does not support signing & verification or reading keys from PEM files
mine::Base16::encode(str);mine::Base16::encode(str.begin(), str.end());mine::Base16::decode(encoding);
mine::Base64::encode(str);mine::Base64::encode(str.begin(), str.end());mine::Base64::decode(encoding);mine::Base64::decode(encoding.begin(), encoding.end());mine::Base64::expectedLength(n);
std::string random256BitKey = mine::AES::generateRandomKey(256);
mine::AES aesManager;
aesManager.encrypt(b16Input, hexKey, mine::MineCommon::Encoding::Base16, mine::MineCommon::Encoding::Base64); // takes base16, encrypts and returns base64
aesManager.setKey(random256BitKey); // now use this key
aesManager.encr(b16Input, mine::MineCommon::Encoding::Base16, mine::MineCommon::Encoding::Base64); // don't need key with requests
aesManager.decr(b64Input, mine::MineCommon::Encoding::Base64, mine::MineCommon::Encoding::Raw); // Returns raw stringmine::ZLib::compressString(str);mine::ZLib::decompressString(str);mine::ZLib::decompressFile(outputFile, inputFile);
You can contribute to the project by testing on various platforms (e.g, Windows, Android etc)
Copyright 2017-present @abumq (Majid Q.)
https://github.com/abumq/mine
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
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.